附录 D · 故障排查手册
问题起点用途：卡住了翻这里。按现象找对应排错路径，不用从第一章重新读。
安装与登录
| 现象 |
先做什么 |
还不行呢 |
| 安装包打不开 / 提示损坏 |
从 ima.qq.com 重新下载；核对系统和芯片版本 |
macOS: 系统设置→隐私与安全性→"仍要打开"；Windows: 检查 SmartScreen 发布者是否为"腾讯" |
| 登录后没反应 |
检查默认浏览器是否拦截、网络代理、系统时间 |
退出重试，保留日志截图反馈官方 |
| 换设备后资料不见了 |
两端是否用同一个微信登录？ |
登录同一微信后自动同步 |
| 公司电脑装不了 |
不要绕过安全策略 |
联系 IT 管理员加白名单或走企业部署 |
知识库创建与管理
| 现象 |
先做什么 |
| 个人库不能建多级子库 |
用「私密共享库」变通（只有你一个人的共享库，里面能建文件夹） |
| 库名/描述改不了 |
以当前客户端实际功能为准；部分端可能不支持修改 |
| 库太多问答变"钝" |
按角色/场景拆成 2–3 个库，每个 ≤200 份；用哪个就 @ 哪个 |
资料上传与解析
| 现象 |
先做什么 |
原因 |
| 显示成功但问不到 |
打开原文确认处理完成、正文存在 |
可能还在处理队列中 |
| PDF 只有部分内容 |
检查扫描质量、页数、复杂排版 |
OCR 对扫描件有误差 |
| 网页只导入摘要 |
检查登录限制和抓取范围 |
某些网页需要登录才能看全文 |
| Excel >10MB 上传失败 |
拆成几个小表再传 |
单文件限制 |
| 数字识别错误 |
回到原文件人工核对 |
OCR/解析对数字和否定词容易出错 |
| 新旧资料互相冲突 |
保留两种说法标明日期和状态，不让 AI 自行合并 |
同名不同版本的文件 |
| 在对话框发文件后问不到 |
对话框发文件=临时；进知识库内部上传才沉淀 |
你发在了错误的位置 |
问答与引用
| 现象 |
先做什么 |
| 回答很泛 |
问题太大或资料空泛→缩小任务范围、补事实资料 |
| 生成了库里没有的承诺 |
明确"没有依据就写未提供"→回到资料标状态 |
找不到 [1] 角标/引用按钮 |
不同版本叫法不同→回到知识库列表手动搜关键句；完全找不到标"待人工核对" |
| 新旧资料被合并成一个答案 |
给资料标"当前/历史"状态，再问一次 |
| @ 库后还是通用回答 |
确认你真的 @ 了正确的库名（不是空着问）；确认库里有相关资料 |
| 搜索不到某份资料 |
打开原文确认处理完成；检查是否进了正确的库；搜索文件名关键词而非全文 |
共享与权限
| 现象 |
先做什么 |
| 访客只能问 3 轮 |
这是官方限制（访客=非成员）；让他们成为"普通成员"可无限问答 |
| 管理员最多 5 人 |
这是官方上限 |
| 顺手发了广场=公域 |
广场是公开的！团队内部协作用"邀请协作"不发广场 |
| 小程序不能建共享库 |
先在电脑端创建，小程序端只做日常查阅 |
copilot
| 现象 |
先做什么 |
| 算力不够任务中断 |
先缩范围分批跑；日常登录攒算力；大批量直接付费买 |
| copilot 分类不准 |
它是"实习生"，分类完一定要抽查 |
| 悬浮窗看不到别的内容 |
copilot 只能感知 IMA 内部内容（你正在看的网页/文件/库） |
IMA × WorkBuddy 联动
| 现象 |
先做什么 |
| @资料库 还是通用回答 |
确认左侧已连上 ima（微信扫码授权）；没连上退化成通用回答 |
| 巨型库整库接入后检索钝 |
拆成 2–3 库、每库 ≤200 份，@ 具体库而非全部 |
| 首次连不上 |
切 WiFi/开热点重扫；多半是网络问题，别重装 |
通用排错原则：①先确认你做的是对的（进了正确库、@ 了库名、资料真的在里面）②打开原文确认处理完成③检查版本和端差异④还搞不定就保留截图和版本号反馈官方。不要因为某个功能看不到就认为 IMA 不能做——不同端、不同版本差异很大，以你当前客户端为准。