前言¶
在 DeepSeek Harness（DSH）里做基于知识库的问答，常见做法是手抄知识库 ID、每次调用都带上 ID，或者只拿到二次摘要而不是原文。腾讯 IMA 账号里本来就有可访问或已订阅的知识库，若能直接在 DSH 里勾选、让模型走原生工具检索原文，会省掉大量重复配置。
下面介绍维护者 RayJitan 开源的 dsh-ima-ragplugin（分类：记忆；GitHub 星标 7）。插件把 IMA 侧你有权访问的知识库列出来，在界面里勾选后作为会话默认检索范围，并向 DSH 注册 ima_kb_list、ima_kb_search、ima_kb_ask 三个原生工具；另支持检索条数设置与 IMA「每日登录福利」自动签到。许可证 MIT，当前包版本 1.0.0。
这是什么¶
dsh-ima-ragplugin 是 DSH 插件：读取 IMA 账号可访问/已订阅的知识库，在侧边栏或设置页勾选要接入的库，让模型通过原生工具检索这些库的原文片段（默认路径为 ima_kb_search）。
它主要解决三件事：
- 不用手填知识库 ID——插件自行列出有权访问的库；
- 不用每次调用都传 ID——选中的库成为会话默认检索范围；
- 检索走原文而不是二手摘要——
ima_kb_ask仅作有损兜底。
插件为只读：不提供上传、删除、建库等写操作。依赖 IMA 内部 Web API，上游变更可能需要跟进。
核心功能¶
三个原生工具¶
| 工具 | 参数 | 说明 |
|---|---|---|
ima_kb_list |
无 | 列出所有可访问知识库，以及当前已选中的库 |
ima_kb_search |
query；knowledgeBaseId?、limit? |
默认检索路径：返回原文片段（media_id / 标题 / 高亮）。不传 limit 时使用设置里的「检索条数」 |
ima_kb_ask |
question；knowledgeBaseId? |
有损兜底：IMA 侧模型先总结再返回。适合用户明确要结论或检索无结果时 |
检索策略上，插件通过工具描述、结果渲染提示和可选的 systemPrompt 段，把默认路径固定在 ima_kb_search；ima_kb_ask 会损失原文措辞与逐条出处。
界面入口¶
- 侧边栏 IMA 图标：凭据授权 + 知识库勾选（主入口）
- 输入框「+」菜单 →
ima：打开知识库多选，快速切换本会话接入的库 - 已选知识库 chip 栏：输入框上方显示已接入的库，点
×移除 - 插件设置页：插件管理 → 本插件详情，与侧边栏功能一致
检索条数¶
侧边栏 IMA 面板 →「检索设置」，配置 ima_kb_search 未显式传 limit 时的返回条数：默认 10，范围 1–100，持久化在 credential store 的 IMA_KNOWLEDGE_SEARCH_LIMIT。上游可能恒返回较多条，插件按生效条数截断后再交给模型。
自动签到¶
侧边栏 →「自动签到」：默认启用，每天 09:00（本机时区）领取 IMA「每日登录福利」（活动说明为每日 50 算力等）。DSH 启动时若当天未签且已过设定时间会补跑；配置与最近记录落在 ~/.dsh/ima-knowledge/checkin.json。只领取、不消耗算力；活动结束则功能自然失效。
安装与启用¶
桌面端¶
打开 DSH → 插件，任选其一：
① 添加插件并粘贴仓库地址
https://github.com/RayJitan/dsh-ima-ragplugin
确认来源后安装。
② 从「发现」市场安装
- 插件页 → 发现 → 添加索引源
- 填入：
https://rayjitan.github.io/dsh-ima-ragplugin/index.json
- 搜索
dsh-ima-ragplugin→ 安装。
安装完成后重启 DSH 桌面应用，左侧边栏会出现 IMA 图标。
命令行（非 desktop profile）¶
dsh plugin --profile <profile-name> add dsh-ima-ragplugin
--profile desktop 由桌面应用独占管理，CLI 会拒绝；桌面端请用插件页安装。
从旧版 dsh-ima-knowledge 迁移¶
两插件不能同时启用。先卸载 dsh-ima-knowledge，再按上文安装本插件并重启。凭据与 ~/.dsh/ima-knowledge/ 下配置可沿用。
凭据与配置¶
插件不保存密码，凭据走 DSH credential store，与 dsh-ima-copilot 的下列项兼容：
| ref | 说明 |
|---|---|
IMA_X_IMA_COOKIE |
完整的 x-ima-cookie |
IMA_X_IMA_BKN |
x-ima-bkn，可留空由 token 自动推导 |
IMA_KNOWLEDGE_BASE_IDS |
已勾选知识库 ID，逗号分隔（插件写入） |
IMA_KNOWLEDGE_SEARCH_LIMIT |
检索条数 1–100 的字符串，缺省即 10（插件写入） |
推荐：侧边栏 IMA 面板 →「从 IMA 桌面客户端同步」，读取本机已登录 IMA 客户端凭据（Windows 下解密 %LOCALAPPDATA%\ima.copilot\User Data）。也可在面板「手动填写」粘贴 cookie。token 过期时插件会尝试用 refresh token 刷新一次。
典型用法¶
- 安装并重启 DSH，打开侧边栏 IMA 面板完成凭据（同步或手动）。
- 勾选要接入本会话的知识库；需要时在输入框「+」→
ima快速改选。 - 在对话中让模型查资料时，优先会走
ima_kb_search；可先调用ima_kb_list确认当前选中范围。 - 在「检索设置」调整默认条数；需要每日算力时在「自动签到」查看开关、时间与本周进度。
宿主提供 systemPrompt 时，插件会注入检索策略段 ima-knowledge:retrieval-policy；未提供时前两层策略仍生效。
适用场景与注意¶
适合：已在 IMA 有知识库订阅或访问权限、希望在 DSH 里用原生工具做原文检索的开发者；需要少维护 ID、少碰摘要链路的 RAG 场景。
环境与权限：
- DSH
>=0.2.0 <0.3.0（含预发布，已在0.2.1-rc.2/0.2.1-rc.5验证）；范围外会静默跳过插件。 - Node.js
^22.19.0 || >=24.0.0。 - 插件以当前 DSH 进程权限运行；安装前请查看源码与 MIT 许可证，自行评估对 IMA 非公开 API 的依赖。
已知约束：列库依赖 IMA search_knowledge_base；code 110031 表示会话彻底过期，需重新登录 IMA 客户端；code 51 为参数错误（鉴权已通过）。
链接¶
- 社区目录：dsh-ima-ragplugin @ SkillHub
- 源码与完整说明：RayJitan/dsh-ima-ragplugin
