前言¶
在 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
