前言¶

在 DeepSeek Harness（DSH）里和 agent 对话时，常见情况是：资料已经沉淀在腾讯 ima 知识库里，但模型默认「看不见」这些库，只能反复手动复制粘贴。DSH 社区按「一切皆插件」扩展能力；ikevss/dsh-ima 属于「联网工具」类插件，由维护者 ikevss 发布，目标是把 ima 的浏览、预览和检索接到 Harness 侧边栏与 agent 工具链上。

下面介绍插件定位、能力边界、安装绑定方式，以及 agent 侧的典型用法。

这是什么¶

dsh-ima 把腾讯 ima 知识库接入 DeepSeek Harness：侧边栏可浏览知识库与文件，agent 可自动检索并读取库内资料。

当前 package 版本为 1.7.2（MIT 许可证）。插件在 GitHub 仓库 ikevss/dsh-ima 维护；社区目录页见 skillhub.cn/plugins/ikevss/dsh-ima（与 DeepSeek / 幻方无官方从属关系，仅为社区收录站点）。

核心功能¶

侧边栏与浏览¶

装上插件后，侧边栏会出现「知识库 ima」入口：

• 左目录、右文件列表浏览；支持全部 / 共享 / 个人三类筛选，多层文件夹与面包屑。
• 分组与 ima 一致：「个人知识库 / 共享知识库」可折叠，右上角「+」可跳转 ima 新建知识库。
• 网页、微信文章可在新窗口打开原文；文档类支持一键「引用到对话」，把当前文件交给 agent 读取。

预览¶

PDF、Word、Excel、PPT、图片、音视频、Markdown、XMind 等可在面板内预览（内置 open-file-viewer 做纯前端渲染）。Word 类按页渲染；右上角可下载原文件或引用到对话。ima 文件标题常无扩展名时，插件会从真实地址补扩展名再交给预览引擎。

笔记排版¶

ima 笔记接口返回的是服务端已展平的纯文本，段落边界会丢失。插件会按标点、序号、「发言人 + 时间戳」等锚点尽力还原段落；会议记录可恢复为一句一条的发言列表，并保留「原文」按钮对照。

Agent 与上下文¶

插件注册 5 个 agent 工具，并在每轮对话开头注入知识库清单（10 分钟内不重复注入），让模型知道「这儿有资料可查」并主动去搜。

注入上下文示例（README 摘录）：

[ima 知识库] 用户已连接 ima 知识库，下面这些库可以直接搜：
· 我的笔记（个人）
· 项目文档（共享）
...
· 找"哪份资料提到过 X" → ima_search_files
· 想浏览某个库里有啥 → ima_list_kb_files
· 读全文 → ima_read_file

绑定账号¶

支持一键绑定：自动打开浏览器登录 ima，其余步骤自动化；无 Chrome/Edge 时可用手动填写兜底（授权页「一键复制」中含 API Key，页面上不单独展示）。

环境与版本适配¶

DSH 插件接口在 0.2.x 阶段仍在演进；升级 DSH 后若异常，可向仓库 Issues 反馈并附上 DSH 版本号。

安装与启用¶

前置条件：已安装 DeepSeek Harness（下文以 ~/.dsh 为 home 目录）、Node.js ≥ 18。桌面端将下文 web 换成 desktop 即可。

不要使用 github:ikevss/dsh-ima 简写安装：npm 可能解析为 SSH 地址，未配置 SSH key 时会报 Permission denied (publickey)。应使用 README 中的 git+https:// 或预构建 tarball。

方式一：一行命令（推荐）¶

从预构建包安装（最快，无需 git、无需本地构建）：

dsh plugin --profile web add https://github.com/ikevss/dsh-ima/releases/latest/download/dsh-ima.tgz

从源码安装：

dsh plugin --profile web add git+https://github.com/ikevss/dsh-ima.git

装完后重启 DSH（Web 端也可只重启服务后刷新页面）。预构建包已含编译好的 lib/client.js，安装期无 postinstall/prepare 脚本。

桌面端示例：

dsh plugin --profile desktop add https://github.com/ikevss/dsh-ima/releases/latest/download/dsh-ima.tgz

desktop profile 由桌面端独占管理，命令行 dsh --profile desktop 拒绝启动属正常现象。

绑定 ima¶

1. 打开侧边栏「知识库 ima」→ 点「一键绑定 ima 账号」。
2. 浏览器弹出 ima 授权页，完成登录。
3. 自动完成绑定，面板显示知识库列表。

典型用法¶

人工浏览：在侧边栏按个人/共享分组进入某库，点开文件预览；需要 agent 参与时点「引用到对话」。

对话检索：直接问「我的资料里提到过 X 吗」或「某库里有哪些相关文档」——模型在上下文里已看到库清单，可调用 ima_search_files、ima_list_kb_files、ima_read_file 等工具，无需你先报文件名。

架构要点（便于排障）：宿主半（Node）提供 agent 工具、上下文注入与 /api/ima/* 路由；浏览器半负责侧边栏与预览。因 ima OpenAPI 不返回 CORS 头，浏览器不能直连，必须由宿主半代理到 https://ima.qq.com。

权限与已知边界¶

安装前建议对照 README「它访问什么」自行核对源码（例如 grep -rn "https://" lib/index.js lib/ima-client.js）。摘要如下：

• 外连域名主要为 https://ima.qq.com；预览/下载使用接口返回的腾讯云 COS 签名直链。
• 本地读写集中在 ~/.dsh/storages/dsh-ima/（凭证与绑定用浏览器 profile）；可取ima 官方技能路径 ~/.config/ima/{client_id,api_key} 作为回退读取，但不写入该目录。
• 一键绑定会短时拉起本机 Chrome/Edge（127.0.0.1 调试端口），用完即关。
• 无安装期脚本、无遥测上报。

结尾¶

若你已在 ima 积累文档、笔记、网页与转写，又希望在 DSH 里让 agent 自动检索和读全文，dsh-ima 把侧边栏浏览、面板预览与 5 个 ima 工具接到同一套 Harness 工作流里，减少复制粘贴。

• 社区目录：https://www.skillhub.cn/plugins/ikevss/dsh-ima
• 源码与文档：https://github.com/ikevss/dsh-ima