dsh-ima-ragplugin

dsh-ima-ragplugin

DeepSeek Harness（DSH）插件：把 IMA 账号里可访问 / 已订阅的知识库读出来，在侧边栏里勾选要接入的库，

再让模型通过原生工具直接检索这些知识库的原文。

它解决三件事：

• 不用手填知识库 ID —— 插件自己列出你有权访问的库；
• 不用每次调用都传 ID —— 选中的库会成为会话默认检索范围；
• 检索走原文而不是二手摘要 —— 默认路径是 ima_kb_search，ima_kb_ask 只作有损兜底。

能力

插件向 DSH 注册 3 个原生工具：

| 工具 | 参数 | 说明 |

|---|---|---|

| ima_kb_list | 无 | 列出所有可访问知识库，以及当前已选中的库 |

| ima_kb_search | query；knowledgeBaseId?、limit? | 默认检索路径：返回原文片段（media_id / 标题 / 高亮）。不传 limit 时使用设置里的「检索条数」 |

| ima_kb_ask | question；knowledgeBaseId? | 有损兜底：让 IMA 侧模型先总结再返回。只在用户明确要求「给个结论」或检索确实无结果时使用 |

界面入口

| 入口 | 位置 | 用途 |

|---|---|---|

| 侧边栏 IMA 图标 | 左侧边栏面板列表 | 凭据授权 + 知识库勾选（主入口） |

| 输入框「+」菜单 → ima | 会话输入框左下角 / 命令菜单 | 打开知识库多选弹窗，快速切换本会话接入的库 |

| 已选知识库 chip 栏 | 输入框卡片内部、文字区上方 | 显示本会话已接入的库，点 × 移除 |

| 插件设置页卡片 | 插件管理 → 本插件详情 | 兼容保留的旧入口，功能与侧边栏一致 |

安装

桌面端：在 DSH 插件页里安装

打开 DSH → 插件，两种方式任选其一：

① 「添加插件」直接粘贴仓库地址（最快）

在插件页点「添加插件」，粘贴：

https://github.com/RayJitan/dsh-ima-ragplugin

确认框会显示来源（Git 仓库 + commit），确认后安装。

② 从「发现」市场安装

「发现」标签页默认没有任何索引源，需要先添加一次：

1. 插件页 → 发现 → 添加索引源

2. 填入市场索引地址：

   https://rayjitan.github.io/dsh-ima-ragplugin/index.json

3. 搜索 dsh-ima-ragplugin → 安装。

安装完成后重启 DSH 桌面应用，左侧边栏会出现 IMA 图标。

命令行：安装到非 desktop 的 profile

dsh plugin --profile  add dsh-ima-ragplugin

> --profile desktop 由 DSH 桌面应用独占管理，独立 CLI 会直接拒绝（profile "desktop" is managed exclusively by the Electron application）。

> 桌面端请用上面的插件页路径；命令行只适用于自建 profile（如 dsh --profile demo）。

从旧版 dsh-ima-knowledge 迁移

旧包与本包注册同一批工具和同一组 /api/ima-knowledge/* 路由，不能同时启用。切换顺序：

1. 插件页 → 已安装 → dsh-ima-knowledge → 卸载

2. 按上面的方式安装 dsh-ima-ragplugin

3. 重启 DSH

凭据（IMA_X_IMA_COOKIE / IMA_X_IMA_BKN）、已选知识库、签到配置都在 credential store 与 ~/.dsh/ima-knowledge/ 里，迁移后自动沿用，无需重新配置。

> 本插件没有第三方运行时依赖（纯 ESM），也没有 prepare/build 脚本，从 Git 安装不需要 pnpm 的构建授权。

凭据配置

插件不保存密码，也不把 cookie 落到自己的目录，全部走 DSH 的 credential store。

方式一：从 IMA 桌面客户端同步（推荐）

侧边栏 → IMA 面板 → 「从 IMA 桌面客户端同步」。

插件会读取本机已登录的 IMA 客户端凭据（Windows 下走 DPAPI 解密 %LOCALAPPDATA%\ima.copilot\User Data），

无需手动复制 cookie。前提是本机 IMA 客户端处于已登录状态。

方式二：手动填写 cookie

在 IMA 面板展开「手动填写」，粘贴 x-ima-cookie；bkn 可以留空，插件会按 token 自动推导。

用到的凭据项

| ref | 说明 |