前言¶
給 DeepSeek Harness 所寫的智能體如果要查你自己的資料，一般有兩條路：要麼把文檔塞進上下文，要麼接一套外部檢索接口。前者受限於上下文長度，後者意味着要自己寫適配代碼、維護鑑權和抓取邏輯。下面介紹的這個插件屬於第三條路：直接複用騰訊 ima 已有的知識庫，把它的檢索、讀文檔、問答檢索能力暴露成 DSH 原生工具，運行期零額外依賴。
這個插件叫 dsh-ima，由 0131kikimy 維護，分類是聯網工具，倉庫目前 1 star。它解決的問題很具體：你已經在騰訊 ima 裏存了知識庫，希望 AI 助手能翻這些知識庫、搜文檔、把某份文檔的正文讀出來，過程中不需要你寫代碼。
這是什麼¶
一句話定位：dsh-ima 是一個 DSH bundle，把騰訊 ima 知識庫的檢索與文檔讀取能力掛載爲 9 個工具，安裝後在 DSH 左側邊欄提供設置入口。
它不是官方插件，README 明確說明「騰訊 ima 的開放接口只提供知識庫檢索與文檔讀取，沒有問答生成接口」，所以插件不會僞造問答結果。插件以當前 dsh 進程的權限運行，能做的事就是這個社會插件能做的事，安裝前應檢查源碼與許可證（MIT，版本 0.4.0，Node 運行環境要求 ^22.19.0 || >=24.0.0）。
倉庫地址：GitHub 0131kikimy/dsh-ima，目錄頁在 skillhub.cn。
核心功能¶
插件暴露 9 個工具，AI 自動調用，你不需要記名字：
| 工具 | 作用 |
|---|---|
ima_health |
檢查配置是否正確、兩條通道是否通 |
ima_settings |
給出設置頁地址 |
ima_kb_list |
列出知識庫 |
ima_list_docs |
列出某個知識庫裏的文檔（帶 mediaId） |
ima_get_doc |
按 mediaId 下載原件並抽出正文 |
ima_search |
關鍵詞搜索 |
ima_ask |
檢索彙總 |
ima_open |
打開 ima 客戶端 |
ima_import |
把一個網址存進知識庫 |
這裏要特別強調 ima_ask。它返回的是檢索彙總，不是 AI 生成的答案。騰訊 ima 的開放接口沒有問答生成這一層，插件會如實標註這一點，不會假裝自己答出來了。所以如果你只想要某份文檔的正文，用「讀某份文檔」這類說法，插件會走「列文檔 → 下載 → 抽 PDF 文字」這條鏈路；遇到掃描版 PDF 抽不出文字時，它會明確告訴你需要 OCR，不會糊弄。
其餘幾個細節：ima_list_docs 返回的文檔帶 mediaId，ima_get_doc 按它下載原件；ima_open 只有 Windows 能用；ima_import 只在你明確要求「存進知識庫」時才寫，插件本身沒有上傳行爲。
安裝與啓用¶
先做兩件準備工作：確保 DeepSeek Harness 已安裝並能正常打開；準備一個 ima API Key。打開 https://ima.qq.com/agent-interface，頁面會給出兩串值：
Client ID，32 位字母數字；API Key，一串較長的字符。
這兩串只顯示一次，先複製到記事本里存好。
然後執行兩步。第一步，在 DSH 裏讓 AI 執行下面這條命令，把插件裝進 DSH：
plugin_manager(action: "install_bundle", target: "github:0131kikimy/dsh-ima")
第二步，重啓 DSH（關掉再打開）。重啓後左側邊欄會多出一個 ima 圖標。注意：Web 版 DSH 纔有側邊欄，桌面端不顯示這個入口。
接着填 API Key。點左側邊欄的 ima 圖標，在頁面裏填 Client ID 和 API Key，點「保存」即可，立即生效不用重啓；點「測試連接」，看到 reachable: true 就是通了。填錯了也不影響，再點一次圖標就能改。這些值保存在本機的 ~/.dsh/dsh-ima/settings.json。
典型用法¶
裝好後不需要記工具名，直接說人話，AI 自己挑工具。README 給出的例子是這樣的：
| 你可以說 | 插件會做 |
|---|---|
| 「我 ima 裏有哪些知識庫？」 | 列出所有知識庫和文檔數量 |
| 「AI 通識課裏都有什麼文件？」 | 列出這個知識庫的文檔清單 |
| 「把《人工智能概念解析》那份課件的內容讀出來」 | 下載原件並抽出正文 |
| 「在知識庫裏搜一下 transformer」 | 關鍵詞搜索，返回命中的文檔 |
| 「打開 ima」 | 幫你把 ima 客戶端調出來 |
一條比較好用的鏈路是：先問有哪些知識庫，再問某個知識庫裏有哪些文檔，然後指定一份文檔讓它讀正文。三步走完，你手上就有了一份從自己知識庫抽出的內容，中間不需要寫任何代碼。
適用場景與注意¶
適合誰：已經在騰訊 ima 上整理了知識庫，希望 DSH 裏的智能體能直接讀這些資料的開發者，或者不想爲檢索接口寫適配代碼的使用者。核心功能（知識庫、搜索、讀正文）跨平臺可用，Win/macOS/Linux 都行，只有「打開 ima 客戶端」是 Windows 專屬。
幾個使用上的注意：
- 插件以當前 dsh 進程的權限運行。安裝第三方插件前，應先看一遍源碼（倉庫裏有
lib、cordis.patch.yml、LICENSE）和許可證，確認沒有你不想接受的行爲。MCP 風格的邊界在這裏同樣適用：它調的是 ima 官方接口，把文檔下載到臨時目錄供抽取文字，沒有上傳行爲，但運行權限完全交給了宿主進程。 ima_ask不是問答接口，別期待它生成結論，它只負責檢索彙總。- 掃描版 PDF 抽不出文字，需要 OCR，插件會如實告知。
- 測試連接不可達時，常見原因是 API Key 複製少了字符、
Client ID和API Key貼反了，或者網絡到不了ima.qq.com。 - 卸載用
plugin_manager(action: "remove_bundle", target: "dsh-ima")，本地存的 API Key 在~/.dsh/dsh-ima/settings.json，不需要就刪掉這個文件夾。
結尾¶
這個插件的價值不在於多複雜的架構，而在於把一個已經有人維護的知識庫體系接進 DSH，讓你不用爲檢索接口寫代碼，也不用把文檔塞進上下文。裝完、填好兩個值、重啓，就能用自然語言翻自己的知識庫了。
目錄頁：https://www.skillhub.cn/plugins/0131kikimy/dsh-ima
GitHub：https://github.com/0131kikimy/dsh-ima
