> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> AiOS 中与 Agent、CLI 和自动化接入相关的常见问题与排障建议。

# 常见问题

> 当前仓库尚未交付下列 `aios ...` 排障命令。它们只作为未来 CLI 排障流的方向示意。

## Q1: 为什么集群启动失败？

先执行环境诊断，重点检查端口占用与容器运行时。

```bash theme={null}
aios doctor
aios infra cluster status
```

## Q2: Agent 任务卡住或长时间无输出怎么办？

先检查任务状态与日志，再决定是否重试。

```bash theme={null}
aios agent run list --limit 20
aios agent run get <run-id>
aios agent run logs <run-id>
```

## Q3: 如何在 CLI 和 UI 之间同步排障？

在 CLI 导出日志，在 UI 中定位同一任务时间窗口进行关联分析。

```bash theme={null}
aios infra app logs <app-name> --since 30m > app.log
```

## Q4: 如何新增一个 AI 工具？

通过工具接入命令注册凭证与适配器后进行连通性测试。

```bash theme={null}
aios agent tool add <tool-name> --token <token>
aios agent tool test <tool-name>
```

## Q5: 如何安全管理凭证？

* 使用环境变量或密钥管理系统注入
* 避免将 token 写入仓库
* 定期轮换高权限凭证

## 相关页面

* [Agent 总览](/agent/index)
* [生产环境二次验证与审批](/agent/production-approval)
* [运维与安全总览](/operations/index)