前言¶
给 DeepSeek Harness 所写的智能体如果要查你自己的资料，一般有两条路：要么把文档塞进上下文，要么接一套外部检索接口。前者受限于上下文长度，后者意味着要自己写适配代码、维护鉴权和抓取逻辑。下面介绍的这个插件属于第三条路：直接复用腾讯 ima 已有的知识库，把它的检索、读文档、问答检索能力暴露成 DSH 原生工具，运行期零额外依赖。
这个插件叫 dsh-ima，由 0131kikimy 维护，分类是联网工具，仓库目前 1 star。它解决的问题很具体：你已经在腾讯 ima 里存了知识库，希望 AI 助手能翻这些知识库、搜文档、把某份文档的正文读出来，过程中不需要你写代码。
这是什么¶
一句话定位：dsh-ima 是一个 DSH bundle，把腾讯 ima 知识库的检索与文档读取能力挂载为 9 个工具，安装后在 DSH 左侧边栏提供设置入口。
它不是官方插件，README 明确说明「腾讯 ima 的开放接口只提供知识库检索与文档读取，没有问答生成接口」，所以插件不会伪造问答结果。插件以当前 dsh 进程的权限运行，能做的事就是这个社会插件能做的事，安装前应检查源码与许可证（MIT，版本 0.4.0，Node 运行环境要求 ^22.19.0 || >=24.0.0）。
仓库地址：GitHub 0131kikimy/dsh-ima，目录页在 skillhub.cn。
核心功能¶
插件暴露 9 个工具，AI 自动调用，你不需要记名字：
| 工具 | 作用 |
|---|---|
ima_health |
检查配置是否正确、两条通道是否通 |
ima_settings |
给出设置页地址 |
ima_kb_list |
列出知识库 |
ima_list_docs |
列出某个知识库里的文档（带 mediaId） |
ima_get_doc |
按 mediaId 下载原件并抽出正文 |
ima_search |
关键词搜索 |
ima_ask |
检索汇总 |
ima_open |
打开 ima 客户端 |
ima_import |
把一个网址存进知识库 |
这里要特别强调 ima_ask。它返回的是检索汇总，不是 AI 生成的答案。腾讯 ima 的开放接口没有问答生成这一层，插件会如实标注这一点，不会假装自己答出来了。所以如果你只想要某份文档的正文，用「读某份文档」这类说法，插件会走「列文档 → 下载 → 抽 PDF 文字」这条链路；遇到扫描版 PDF 抽不出文字时，它会明确告诉你需要 OCR，不会糊弄。
其余几个细节：ima_list_docs 返回的文档带 mediaId，ima_get_doc 按它下载原件；ima_open 只有 Windows 能用；ima_import 只在你明确要求「存进知识库」时才写，插件本身没有上传行为。
安装与启用¶
先做两件准备工作：确保 DeepSeek Harness 已安装并能正常打开；准备一个 ima API Key。打开 https://ima.qq.com/agent-interface，页面会给出两串值：
Client ID，32 位字母数字；API Key，一串较长的字符。
这两串只显示一次，先复制到记事本里存好。
然后执行两步。第一步，在 DSH 里让 AI 执行下面这条命令，把插件装进 DSH：
plugin_manager(action: "install_bundle", target: "github:0131kikimy/dsh-ima")
第二步，重启 DSH（关掉再打开）。重启后左侧边栏会多出一个 ima 图标。注意：Web 版 DSH 才有侧边栏，桌面端不显示这个入口。
接着填 API Key。点左侧边栏的 ima 图标，在页面里填 Client ID 和 API Key，点「保存」即可，立即生效不用重启；点「测试连接」，看到 reachable: true 就是通了。填错了也不影响，再点一次图标就能改。这些值保存在本机的 ~/.dsh/dsh-ima/settings.json。
典型用法¶
装好后不需要记工具名，直接说人话，AI 自己挑工具。README 给出的例子是这样的：
| 你可以说 | 插件会做 |
|---|---|
| 「我 ima 里有哪些知识库？」 | 列出所有知识库和文档数量 |
| 「AI 通识课里都有什么文件？」 | 列出这个知识库的文档清单 |
| 「把《人工智能概念解析》那份课件的内容读出来」 | 下载原件并抽出正文 |
| 「在知识库里搜一下 transformer」 | 关键词搜索，返回命中的文档 |
| 「打开 ima」 | 帮你把 ima 客户端调出来 |
一条比较好用的链路是：先问有哪些知识库，再问某个知识库里有哪些文档，然后指定一份文档让它读正文。三步走完，你手上就有了一份从自己知识库抽出的内容，中间不需要写任何代码。
适用场景与注意¶
适合谁：已经在腾讯 ima 上整理了知识库，希望 DSH 里的智能体能直接读这些资料的开发者，或者不想为检索接口写适配代码的使用者。核心功能（知识库、搜索、读正文）跨平台可用，Win/macOS/Linux 都行，只有「打开 ima 客户端」是 Windows 专属。
几个使用上的注意：
- 插件以当前 dsh 进程的权限运行。安装第三方插件前，应先看一遍源码（仓库里有
lib、cordis.patch.yml、LICENSE）和许可证，确认没有你不想接受的行为。MCP 风格的边界在这里同样适用：它调的是 ima 官方接口，把文档下载到临时目录供抽取文字，没有上传行为，但运行权限完全交给了宿主进程。 ima_ask不是问答接口，别期待它生成结论，它只负责检索汇总。- 扫描版 PDF 抽不出文字，需要 OCR，插件会如实告知。
- 测试连接不可达时，常见原因是 API Key 复制少了字符、
Client ID和API Key贴反了，或者网络到不了ima.qq.com。 - 卸载用
plugin_manager(action: "remove_bundle", target: "dsh-ima")，本地存的 API Key 在~/.dsh/dsh-ima/settings.json，不需要就删掉这个文件夹。
结尾¶
这个插件的价值不在于多复杂的架构，而在于把一个已经有人维护的知识库体系接进 DSH，让你不用为检索接口写代码，也不用把文档塞进上下文。装完、填好两个值、重启，就能用自然语言翻自己的知识库了。
目录页：https://www.skillhub.cn/plugins/0131kikimy/dsh-ima
GitHub：https://github.com/0131kikimy/dsh-ima
