前言¶

在 DeepSeek Harness（DSH）中開發智能體時，將外部知識庫連接到代理是一個常見需求。Knowz 提供了一種通過 MCP 協議連接託管 vaults 的解決方案。

這是什麼¶

Knowz 是一個爲 DSH 提供託管 MCP 連接器及輕量級 vault 技能的插件。它由 knowz-io 維護，專注於知識檢索與管理。

核心功能¶

• MCP 連接：通過 MCP 協議連接代理到託管的 Knowz vaults。
• 知識訪問：提供 vault 訪問權限。
• 知識 Only：此插件專注於知識庫功能，不包含代碼執行或測試相關能力。

安裝與啓用¶

安裝插件需要執行以下步驟：

1. 安裝插件：

    dsh plugin --profile web add github:knowz-io/deepseek-knowz-plugin

2. 配置 API 密鑰：
   • 在 app.knowz.io/settings/api-keys 創建一個以 ukz_ 開頭的 key。
   • 在環境變量或 $DSH_HOME/.credentials.yaml 中設置 KNOWZ_API_KEY。

        export KNOWZ_API_KEY=ukz_…

*   設置密鑰後，重啓 `dsh web`。

3. 映射 vaults：
   設置好密鑰後，向智能體發起指令，運行 knowz-setup 技能以映射 vaults。

技能列表¶

插件提供以下技能：
* knowz-ask
* knowz-save
* knowz-search
* knowz-browse
* knowz-amend
* knowz-setup
* knowz-status
* knowz-flush
* knowz-auto

注意事項¶

• 安全：不要將 API 密鑰粘貼到聊天中。
• 註冊陷阱：不要在現有 Knowz 賬號上運行 /knowz register，該命令會創建一個新賬號，並非現有用戶的登錄路徑。
• 認證方式：此切片中無 OAuth。
• 依賴：需要 @deepseek-ai/dsh-mcp-client。
• 包內安全：此包中不包含 secrets、CLIENT_ID、字面量 bearer token 或 x-api-key，所有認證由環境變量注入。

短結尾¶

Knowz 插件爲 DSH 提供了連接託管知識庫的能力。通過配置環境變量並運行 knowz-setup，即可將外部 vault 映射到智能體中。更多細節請參考項目主頁或 GitHub 倉庫。