DSH 採用插件化架構。對於需要接入騰訊 IMA Copilot 知識庫的場景，直接調用外部服務或常駐進程會增加運維複雜度。dsh-ima-copilot 是一個原生插件，它將 IMA 的知識庫問答能力封裝爲 ima_ask 工具，允許 Agent 直接通過語義檢索獲取答案。
插件定位¶
這是一個由 onclaw-dev 維護的社區插件，屬於聯網工具分類。它屬於 DeepSeek Harness 生態，與騰訊 IMA 或 DeepSeek 官方均無隸屬或背書關係。
核心功能¶
- 原生工具集成：使用原生
ima_ask工具查詢一個或多個 IMA 知識庫。 - 引用信息返回：返回回答正文以及資料 ID、標題和知識庫名稱等引用信息。
- Web 配置管理：通過 Web 設置頁維護認證信息和知識庫 ID，更新後無需重啓 DSH。
- 請求控制：提供超時、併發限制、瞬時失敗重試和請求取消處理。
- 安全憑證處理：憑證僅通過 DSH Credentials API 讀寫，不在 Web 頁面回顯。
安裝與啓用¶
在終端運行以下命令安裝插件並啓動 Web profile：
dsh plugin --profile web add dsh-ima-copilot
dsh web
安裝完成後，重啓 Web profile。可以通過以下命令確認插件已加載：
dsh --profile web --dump-config
典型用法¶
安裝並配置完成後，Agent 可以直接調用 ima_ask 工具。
參數說明¶
| 參數 | 必填 | 說明 |
|---|---|---|
question |
是 | 要向 IMA 知識庫提出的非空問題 |
knowledgeBaseId |
否 | 目標知識庫 ID。配置單個知識庫時插件會自動選擇；配置多個知識庫時必須傳入對應的 ID |
返回結果¶
返回結果包含回答正文和引用資料列表：
{
"answer": "回答正文",
"references": [
{
"id": "資料 ID",
"title": "資料標題",
"knowledgeBase": "知識庫名稱"
}
]
}
注意事項¶
- API 穩定性：IMA Web API 並非公開穩定 API，上游字段、鑑權或響應格式變化時，插件可能需要同步更新。
- 憑證驗證：真實憑證在線驗證未執行。
- 無對話歷史：每次調用都會讀取最新憑證、創建一次性 IMA 會話並在結束後釋放資源，因此不保留跨調用的對話歷史。
- 默認策略：默認請求超時爲 300 秒，瞬時失敗最多重試 3 次，併發上限爲 1。
- 合規性：使用者應自行確保賬號、知識庫內容和認證信息的使用符合相關服務條款。
總結¶
通過 dsh-ima-copilot，可以在不引入額外依賴或運行子進程的情況下，讓 DSH 代理直接利用 IMA 的知識庫能力。項目託管在 GitHub，可查看版本兼容矩陣與源碼。
