AI项目博客「从零搭建智能体与知识库」系列第 4 篇。目标：20 分钟把本地文档导入 ima，基于资料问答并核对参考来源。环境：Windows 或 macOS、ima 客户端、DeepSeek。
结论：ima 的优点是零部署、本地文件直接导入、答案标注参考来源；代价是资料要上传到云端，复杂表格和扫描件的解析一般。适合个人和小团队，不适合不能出内网的资料。
零、准备清单
- ima 客户端：
https://ima.qq.com/，支持 Windows、macOS、微信小程序、iOS、Android； - 微信账号：客户端用微信扫码登录；
- 测试文档：5–20 页、带文字层的 PDF 或 DOCX，不要用扫描件；
- 可选：在模型选择里切到 DeepSeek R1，复杂分析更稳。
一、下载安装并登录
- 打开
https://ima.qq.com/，按系统选「Windows 客户端」或「Mac 客户端」下载。 - 双击安装，默认路径即可；首次启动用微信扫码登录。
- 进入首页：中间是提问框，左侧是文档库和智能体入口，右上角可以切换模型。
图 1：ima 官网提供 Windows、macOS、小程序、iOS、Android 客户端。
图 2：登录后的首页，中间提问框，左侧文档库与智能体入口。
验收：能进入首页，提问框可输入，左侧能看到文档库入口。
安装包不大，Windows 版默认装在用户目录；如果公司电脑限制安装，先用微信小程序验证流程。
二、新建知识库
- 左侧进入「知识库」，点「新建知识库」。
- 选类型：
- 个人知识库：只有自己可见，适合个人笔记、学习资料；
- 共享知识库：可以分享给其他人，适合团队资料。
- 填名称和描述；共享库还可以设封面和推荐问题，方便别人第一次提问。
- 创建后进入空知识库，内容数为 0。
验收：知识库列表出现新库，点进去能看到「添加」入口。
建议按主题建库，不要把所有资料塞进一个库。库越大，检索越容易召回无关内容，答案也更难核对。
三、导入本地文件
- 进入知识库，点「添加」→「本地文件」。
- 选择文件，可多选。常见办公文档（PDF、DOCX、PPTX、XLSX、TXT、MD 等）都能导入，具体以客户端版本为准。
- 右侧会列出待导入文件，确认后点「继续导入」。
- 主界面显示每个文件的解析进度；解析完成后，内容数增加，点开文件能看到正文。
图 3：选择本地文件后，右侧列出待导入文件，点「继续导入」。
验收：文件状态从「解析中」变成已完成；内容数大于 0；点开文件能看到正文，不是空白。
三个注意点：
- 扫描件、图片型 PDF 没有文字层，解析结果会很差，先用 OCR 转一遍；
- 表格和公式尽量用原生 Word、Excel，或转成 Markdown，截图贴进去识别不了；
- 大文件分批导入，一次几十个文件排队解析容易卡住。
四、基于知识库提问
- 在知识库内点「提问」，或在首页选择这个知识库。
- 模型选 DeepSeek R1（需要更强推理时）；日常问答用默认模型就够。
- 先问一个资料里明确写了的，再问一个资料里没有的，最后问一个跨多份文档的。
- 看答案上方的「找到了 N 篇知识库资料作为参考」，点开核对原文。
图 4：选 DeepSeek R1 时先显示思考过程，答案上方标注参考了几篇知识库资料。
验收：第一类问题答对且有参考来源；第二类明确说资料里没有，而不是编；第三类能引用多篇资料。
注意：ima 的回答是「基于资料生成」，不是逐字摘抄。数字、日期、结论要回到原文核对；如果答案没有参考来源，基本可以判定检索没命中，不要直接采信。
五、四个让答案更稳的设置
| 设置 | 建议 |
|---|---|
| 知识库拆分 | 按主题建多个库，提问时选对库，比一个大库更准 |
| 共享库 | 团队资料放共享库，个人笔记放个人库，避免权限混乱 |
| 模型 | 日常用默认模型；复杂对比、长文档分析切 DeepSeek R1 |
| 提问方式 | 写清「背景 + 对象 + 输出格式」，比一句话更容易得到可核对答案 |
六、常见问题与处置
| 现象 | 原因 | 处置 |
|---|---|---|
| 一直显示解析中 | 文件大、格式复杂、网络慢 | 等几分钟；拆成小文件；扫描件先 OCR |
| 解析成功但答非所问 | 资料和问题不相关，或切片质量差 | 换库；补文档；把问题写具体 |
| 答案没有参考来源 | 没选中知识库，或资料没解析完 | 检查库选择与解析状态 |
| 模型不可用 | 客户端版本旧、额度或网络问题 | 更新客户端；换模型；检查网络 |
| 共享库别人看不到 | 未邀请或权限没开 | 检查共享设置和成员列表 |
| 敏感资料不敢传 | 资料会上传云端 | 不要放敏感文件；企业用私有化方案 |
七、边界
ima 适合个人和小团队快速建库：不用部署、不用配向量库，导入就能问。它不适合三类场景：资料不能出内网、复杂表格和扫描件要求高、需要多租户与审计的企业环境。前者换本地模型，后两者看 Dify 或自建 RAG。
上一篇：Cline 实战：从天气脚本到双城对比 Flask 项目
系列 4 篇到这里：Cherry-Studio、Dify、Cline、ima。选型标准还是那句：流程固定用工作流，路径不定才用 Agent，资料问答先把知识库用好。
