ima 知识库 ikevss/dsh-ima

dsh-ima

Awesome DSH Plugin
Listed on dsh-plugin.org

把腾讯 ima 的知识库接进 DeepSeek Harness：侧边栏浏览知识库，智能体能自动检索并读取库内文件。

English · 简体中文

它解决什么问题

你在 ima 里攒了很多资料（文档、笔记、网页、录音转写…），但对话里的智能体看不见——每次都要手动复制粘贴。

装上这个插件后：

- 侧边栏多一个「知识库 ima」：左目录、右文件地浏览，点击直接预览
- 智能体自动知道有这个知识库：每轮对话开头会把库清单注入上下文，模型知道「这儿有资料可查」
- 按正文内容搜索：不记得文件叫什么名？问「我的资料里提到过 X 吗」，智能体自己去搜

功能一览

| 能力 | 说明 |
| 绑定 | 一键绑定：自动打开浏览器让你登录 ima，其余全自动，不需要复制粘贴 |
| 浏览 | 全部 / 共享 / 个人 三类筛选，多层文件夹 + 面包屑 |
| 预览 | PDF、Word、Excel、PPT、图片、音视频、Markdown、XMind 等在面板内直接看 |
| 文件图标 | macOS 风格 SVG 图标：访达同款蓝色文件夹 + 各类型渐变色块（PDF 红 / Word 蓝 / Excel 绿 / 播客 粉…）；左侧知识库统一用单色 macOS 文件夹 |
| 左侧分组 | 与 ima 一致的「个人知识库 / 共享知识库」折叠分组，可一键去 ima 新建 |
| 更新时间 | 文件行预留了最后更新时间列；ima 官方接口暂未提供该字段，开放后自动显示 |
| 笔记排版 | ima 的笔记接口只返回一段展平过的纯文本（段落边界在服务端就丢了）；插件按标点、序号、「发言人 + 时间戳」等锚点尽力还原段落，会议记录能恢复成一句一条的发言列表，并保留「原文」按钮随时对照 |
| 网页类 | 网页、微信文章点击直接在新窗口打开原文 |
| 引用到对话 | 文件一键交给智能体读取 |
| 智能体工具 | 5 个工具，含按正文内容搜索 |
| 上下文注入 | 模型每轮自动看到知识库清单，主动去查 |

界面预览

以下截图为演示数据（虚构的库名与文件名），实际界面与之一致。唯一例外：文件行的「更新时间」列目前 ima 接口不返回该字段，实际显示为空，ima 开放后无需更新插件即可自动显示。

文件列表

左侧按 ima 自己的习惯分成「个人知识库 / 共享知识库」两组，可折叠，右上角「+」直达 ima 新建；知识库统一用访达同款的蓝色文件夹，文件按类型显示 macOS 风格的圆角图标（PDF 红 / Word 蓝 / Excel 绿 / 播客 粉…），行尾是操作按钮。网页 / 微信文章直接「打开原文」，文档类一键「引用到对话」：

知识库面板与文件列表

文件预览

PDF / Word / Excel / PPT / 图片 / 音视频都不用跳出面板，点开直接看（Word 类文档按页渲染）；右上角可下载原文件，或一键「引用到对话」把当前文件交给智能体读取：

文档预览

笔记排版还原

ima 的笔记接口返回的是一段展平的纯文本，段落边界在 ima 服务端就丢了。插件按「发言人 + 时间戳」「中文序号」等锚点重建段落——会议记录能还原成一句一条的发言列表，右上角「看原文」可随时切回原始文本对照：

笔记排版还原

绑定 ima 账号

一键绑定：自动弹出浏览器登录 ima，其余全自动：

一键绑定

没有 Chrome/Edge 时的手动兜底（每一步都告诉你去哪拿、怎么拿）：

手动填写兜底

环境与版本适配

| 项目 | 要求 | 说明 |
| DeepSeek Harness | 0.2.0-rc.1 | 开发与测试所用的版本；0.2.x 其他小版本理论兼容，未逐一验证 |
| Node.js | ≥ 18（推荐 ≥ 22） | 宿主半要求；绑定自动化用到 Node 内置 WebSocket，22 起零依赖 |
| 浏览器 | Chrome 或 Edge | 仅「一键绑定」需要；都没有会自动降级为手动填写方式 |
| 操作系统 | Windows / macOS / Linux | 宿主半为纯 Node 实现，无原生模块依赖 |
| ima 账号 | 能登录 ima.qq.com 即可 | 订阅类知识库 ima 不开放读取（产品策略，见「已知边界」） |

DSH 的插件接口在 0.2.x 阶段仍在演进。升级 DSH 后如果插件异常，欢迎提 issue，附上 DSH 版本号即可。

安装

前置条件

- 已安装 DeepSeek Harness（下文以 ~/.dsh 为其 home 目录）
- Node.js ≥ 18

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

把 web 换成你要装的 profile 名即可（桌面端用 desktop）。

从预构建包安装 —— 最快，不需要 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 端也可以只重启服务，然后刷新页面）。

⚠️ 不要写成 github:ikevss/dsh-ima。 npm 会把 github: 这种简写解析成 SSH 地址（ssh://git@github.com/...），没配过 SSH key 的机器会直接报 Permission denied (publickey)，装不上。要让人人都能装，必须用上面的 git+https:// 形式或 tarball 链接。

💡 预构建 tarball 里已经包含编译好的 lib/client.js，所以安装时不会触发构建；从源码装也一样，lib/ 随仓库一起提交。

方式二：手动安装（改 profile 配置）

适合想改代码、或者网络环境装不了包的情况。

1. clone 到插件目录

git clone https://github.com/ikevss/dsh-ima.git ~/.dsh/plugins/dsh-ima

2. ~/.dsh/profiles/web/package.json —— 加依赖和 bundle：

{
"dependencies": {
"dsh-ima": "file:../../plugins/dsh-ima" // ← 新增 },
"dsh": {
"profile": {
"bundles": [
// ...原有内容... "dsh-ima" // ← 新增 ] } } }

3. ~/.dsh/profiles/web/cordis.patch.yml —— 文件末尾加一段：

- insert:
- id: dsh-ima
name: dsh-ima

4. 把插件文件拷进 profile 的 node_modules（不要用 pnpm add，容易搞坏 profile 的依赖解析）：

mkdir -p ~/.dsh/profiles/web/node_modules/dsh-ima
cp ~/.dsh/plugins/dsh-ima/{package.json,cordis.patch.yml} ~/.dsh/profiles/web/node_modules/dsh-ima/
cp ~/.dsh/plugins/dsh-ima/lib/.js ~/.dsh/profiles/web/node_modules/dsh-ima/lib/

5. 重启 DSH。

桌面端（DeepSeek Harness Desktop）

把上面的 web 全部换成 desktop 即可：

一行命令方式
dsh plugin --profile desktop add https://github.com/ikevss/dsh-ima/releases/latest/download/dsh-ima.tgz

手动方式同样三步，只是 profile 目录换成 ~/.dsh/profiles/desktop：

1. 改 ~/.dsh/profiles/desktop/package.json（加 dependencies + bundles，同上）
2. 改 ~/.dsh/profiles/desktop/cordis.patch.yml（加 insert 段，同上）
mkdir -p ~/.dsh/profiles/desktop/node_modules/dsh-ima
cp ~/.dsh/plugins/dsh-ima/{package.json,cordis.patch.yml} ~/.dsh/profiles/desktop/node_modules/dsh-ima/
cp ~/.dsh/plugins/dsh-ima/lib/.js ~/.dsh/profiles/desktop/node_modules/dsh-ima/lib/
3. 重启桌面端

⚠️ desktop profile 由桌面端独占管理，命令行 dsh --profile desktop 会拒绝启动——这是正常的。

它访问什么（权限说明）

装之前你大概想知道它碰了什么。全部如实列出：

| 项 | 说明 |
| 访问的域名 | 只有 https://ima.qq.com（腾讯 ima 官方 OpenAPI）。预览/下载文件时用的是 ima 接口返回的腾讯云 COS 签名直链 |
| 读取的本地文件 | ~/.dsh/storages/dsh-ima/credentials.json（插件自己的凭证）；取不到时回退读 ~/.config/ima/{client_id,api_key}（ima 官方技能的标准位置）。除这两个位置外不读任何本地文件 |
| 写入的本地文件 | 只在 ~/.dsh/storages/dsh-ima/ 下写凭证与绑定用的浏览器 profile；不碰 ~/.config/ima/（那是 ima 自己技能的资产，解绑只用标记文件） |
| 启动的进程 | 仅「一键绑定」时会拉起你本机的 Chrome / Edge，带 --remote-debugging-port=9333（只监听 127.0.0.1），用完即关 |
| 本机 HTTP 路由 | /api/ima/，由 DSH 的 webServer 提供，与 DSH 面板同源。之所以要这层中转，是因为 ima 的接口不返回 CORS 头，浏览器不能直连 |
| 安装期脚本 | 没有。package.json 里没有 postinstall/prepare，装的时候不会执行任何脚本 |
| 遥测 / 上报 | 没有。不收集、不上传任何数据到第三方；除了上面那个域名不连任何服务器 |

想自己核对：grep -rn "https://" lib/index.js lib/ima-client.js，宿主半只有 ima.qq.com 一个外部地址。

绑定 ima 账号

1. 打开侧边栏「知识库 ima」→ 点「一键绑定 ima 账号」
2. 会自动弹出一个浏览器窗口，已打开 ima 授权页
3. 登录（唯一需要你做的事）
4. 自动完成绑定，面板刷出知识库备用方式（没有 Chrome/Edge 时）：点「都试过了还是不行？」，打开 ima 授权页 → 点第 1 步的「一键复制」→ 回到插件，会自动识别。
注意：API Key 不在页面上显示，藏在「一键复制」复制出来的那段文字里。

智能体工具

插件注册 5 个工具，模型按需调用：

| 工具 | 用途 |
| ima_search_files | 按正文内容搜索文件（最常用）——不知道文件叫什么、想找「哪些资料提到过 X」时用 |
| ima_list_knowledge_bases | 列出全部知识库 |
| ima_search_knowledge_bases | 按关键词搜知识库（匹配库名/描述） |
| ima_list_kb_files | 列出某个库里的文件和文件夹 |
| ima_read_file | 读取文件正文（文本直接返回，二进制返回下载直链） |

上下文注入

插件在每轮对话的第一步，会把知识库清单注入模型上下文（10 分钟内不重复注入）：

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

所以模型会主动去查，而不是说「我看不到你的资料」。

架构

dsh-ima/
├── lib/
│ ├── index.js 宿主半：agent 工具 + 上下文注入 + /api/ima/ 路由 │ ├── ima-client.js ima OpenAPI 客户端 │ ├── ima-browser.js 浏览器自动化取凭证（CDP，零依赖） │ └── client.js 浏览器半产物（由 build/ 生成，已随仓库提供） ├── build/ │ ├── client.src.js 界面逻辑源码 │ ├── viewer.src.js 预览引擎配置 │ └── build.mjs 构建脚本（esbuild） └── cordis.patch.yml bundle patch

两半设计：宿主半跑在 Node 里（工具、HTTP 路由），浏览器半跑在 DSH 页面里（侧边栏面板、预览）。两者通过同源的 /api/ima/* 通信。

为什么要有 HTTP 路由？因为 ima 的接口不返回 Access-Control-Allow-Origin，浏览器直连会被 CORS 拦死。只能由宿主半代理。

开发

cd ~/.dsh/plugins/dsh-ima
npm install # 构建依赖（约 400MB，仅开发时需要）
npm run build # 重新生成 lib/client.js
npm test # ima-client 冒烟测试

改 build/client.src.js → npm run build → 把 lib/client.js 拷进各配置档的 node_modules → 刷新页面。
改 lib/index.js 等宿主半 → 拷进配置档 → 重启 DSH。

lib/client.js 是构建产物，已随仓库提供，普通用户不需要构建，clone 下来即可使用。

预览能力

内置 open-file-viewer（MIT）做纯前端渲染：

| 类型 | 预览方式 |
| PDF | 浏览器原生 |
| Word / Excel / PPT | docx-preview / xlsx 纯前端渲染 |
| 图片 | 直接渲染 |
| 音视频 | 内置播放器 |
| Markdown / 文本 / 思维导图 | 内置渲染 |

小技巧：ima 的文件标题常常没有扩展名（例如播客标题就是一段描述）。插件会从文件真实地址里取扩展名补上再交给预览引擎，否则会误报「不支持预览」。

已知边界

| 项 | 说明 |
| 订阅知识库 | ima 产品策略不开放读取（错误码 220030），默认不显示 |
| 文件更新时间 | ima OpenAPI 目前不返回任何时间字段（实测 2026-10-16，已探测多个候选接口），插件已预留显示通道，ima 开放后无需更新插件 |
| 笔记段落结构 | ima 笔记接口 note/v1/get_doc_content 只返回一个已展平的纯文本字段：data 顶层只有 content 一个键，format / with_blocks / rich 等参数全部被忽略（返回字节一致），另探 8 个结构化候选接口全部 404。原始段落结构在 ima 服务端就丢失了，插件无法无损还原，只能按可见锚点尽力重排（右上角「看原文」可对照）；表格类内容展平后无法重建 |
| 知识库列表 | 单页上限 20 个 |
| 浏览器要求 | 一键绑定需要本机有 Chrome 或 Edge；没有会自动降级到手动方式 |
| API Key | 有效期一年，到期需重新绑定 |
| 桌面端 | 插件支持，但 desktop 配置档由桌面端独占管理 |

更新日志

| 版本 | 要点 |
| 1.7.2 | 笔记预览排版还原：ima 展平的纯文本按锚点重建段落（发言人 + 时间戳 / 中文序号 / 序号列表 / 裸链接），新增「看原文」对照开关与链接识别 |
| 1.7.1 | 左侧知识库图标统一为单色 macOS 文件夹（之前按库配色太花） |
| 1.7.0 | macOS 风格类型图标（访达文件夹 + 渐变色块）、左侧改为 ima 同款折叠分组、更新时间通道 |
| 1.6.0 | 按正文内容搜索（ima_search_files）、agent 上下文注入、开源发布 |
| 1.5.0 | 一键绑定产品化：CDP 浏览器自动化 + 四级兜底 + 手动路径自解释 |
| 1.3.0 | 内置 open-file-viewer 纯前端预览（替代在线预览，国内可用） |
| 1.0.0 | 首个可用版本：侧边栏浏览 + 基础 agent 工具 |

致谢

- open-file-viewer —— 提供纯前端文档预览能力
- DeepSeek Harness —— 插件宿主

dsh-ima 把 腾讯 ima 知识库接入 DeepSeek Harness。

- 在侧边栏面板里浏览你的 ima 知识库（分组可折叠、Finder 风格文件夹、macOS 风格类型图标、面板内文件预览）
- 智能体自动知道你的知识库存在 —— 每轮开始时，往模型上下文里注入一段简短摘要
- 全文搜索 —— 问一句「我存的东西里有没有提到 X？」，智能体就会在你的文档里搜索
- 5 个智能体工具：ima_search_files、ima_list_knowledge_bases、ima_search_knowledge_bases、ima_list_kb_files、ima_read_file
- 一键绑定：浏览器打开 ima 登录页，其余全自动

环境要求：DeepSeek Harness 0.2.0-rc.1（已测试；其他 0.2.x 版本大概率兼容）· Node.js ≥ 18（推荐 22+）· 一键绑定需要 Chrome 或 Edge（否则回退到手动设置）。上方截图使用演示数据。

安装步骤见上方中文部分。MIT 协议授权。

License

MIT © 2026 ikevss