诊断与问题分流
先按症状选择入口
Section titled “先按症状选择入口”| 你看到的现象 | 先去哪里 | 保留什么 |
|---|---|---|
| 客户端无法安装或第一次打开 | 安装排查 | 系统版本、芯片或架构、完整提示 |
| Agent 显示组件缺失、运行环境不可用 | 本页“安装诊断” | 红色项目、修复结果、客户端版本 |
| 模型提示缺少凭据或请求失败 | 模型设置 | Agent 分页、供应商状态、健康检测原文 |
| MCP 显示“最近一次测试失败” | MCP 连接与验证 | 服务名称、状态码或错误原文，不含凭据 |
| 技能或命令没有出现 | 命令与触发 | 当前 Agent、会话状态、技能是否已安装 |
| 仍无法判断 | 本页开始检测 | 发生时间、操作顺序和预期结果 |
先记录事实，再做可逆检查。不要把重装、删除数据或关闭安全软件作为第一步。
- 在“设置 → 关于”记录客户端版本，并记录 Windows 或 macOS 版本。
- 打开“设置”，在左侧“帮助与支持”区域选择“诊断”。页面标题为“安装诊断”。
- 第一次进入时选择“开始检测”。之后页面会保留上次结果，只有选择“重新检测”才会采集新结果。
- 先查看顶部是“本地资源齐全”还是“检测到缺失/异常”，再展开对应区域。
- Windows 用户遇到 Agent 启动问题时，可以运行“Windows 运行时自检”，并复制已经脱敏的报告。
看懂诊断结果
Section titled “看懂诊断结果”“组件完整性”检查 INA iMate 随包组件和主要 Agent 运行组件。状态包括正常、缺失、版本过低和就绪；缺失或损坏时才使用页面提供的“修复”或“拉取组件”。
“环境检查”展示外部或可选依赖、当前平台兼容性、下载源连通性与环境信息。可选外部 CLI 未安装不一定影响核心功能，不要把所有非绿色项目都当作同一个故障。
安装诊断不会替代各功能自己的验证：
- 模型是否可用，以模型健康检测为准；
- MCP 是否可用，以MCP 连接测试和工具列表为准；
- 技能和 slash 命令是否可见，以当前 Agent、会话和命令发现路径为准。
安全修复顺序
Section titled “安全修复顺序”- 保存当前诊断结果和完整错误原文。
- 重试页面提供的单项检测，确认问题可以重复出现。
- 只对明确标为缺失、损坏或不可读的随包组件使用对应“修复”。
- 修复后选择“重新检测”，确认原项目已经恢复。
- 如果页面提示文件可能被安全软件隔离，联系公司 IT 核对隔离记录；不要关闭整机安全防护。
- 只有安装排查或支持人员明确要求时才考虑重新安装；不要先清理用户数据目录。
选择诊断页的“上报”，或前往反馈与支持。至少准备：
- 问题发生的大致时间；
- 可以重复问题的完整步骤；
- 实际看到的完整提示文字；
- 客户端版本与操作系统；
- 诊断中的异常项目或已脱敏报告；
- 已遮挡账号、手机号、客户名称、路径和凭据的截图。
不要提交密码、验证码、API Key、Token、客户数据或整个用户目录。