前言¶

DeepSeek Harness 採用插件化架構，智能體預設通常包含大量工具。在管理這些工具的聲明與狀態時，區分哪些工具對用戶可見、如何處理靜態禁用與動態控制，容易產生混淆。dsh-agent-manager 插件爲此提供瞭解決方案，它作爲設置插件運行，專門用於管理智能體預設的工具策略。

這是什麼¶

dsh-agent-manager 是由開發者 hrhgit 維護的 DeepSeek Harness 設置插件。它的核心作用是在智能體預設聲明的範圍內，查看並切換工具。它不負責管理模型提供商或模型元數據。

核心功能¶

該插件提供以下具體能力：

1. 工具可見性篩選：僅顯示預設中明確聲明帶 agentTool.label 的工具。未聲明此字段的工具，即使其包提供工具，也不會在界面中出現。
2. 本地預設編輯：允許用戶切換本地預設中靜態的 disabled 狀態。
3. 預設讀寫保護：系統和 shipped 預設爲只讀狀態。若需編輯，需先將其複製到用戶預設。
4. 狀態可視化：顯示工具的具體狀態，包括託管控制、未掛載、可用、不可用或過期。

典型用法¶

插件通過 Host 的 ctx.agentPresets 服務獲取工具列表並執行操作。在預設中聲明工具時，需添加 agentTool.label 字段以使其對管理器可見。

聲明工具示例：

- id: persistent-bash
  name: '@deepseek-ai/dsh-tool-bash-persistent'
  disabled: false
  agentTool:
    label: Persistent Bash

適用場景與注意¶

該插件適合需要對智能體工具策略進行精細化管理的開發者。

• 會話隔離：策略變更僅適用於後續會話，現有會話保持原有配置。
• 條件值限制：條件值（如 disabled: !!js process.platform === 'win32'）不可在瀏覽器中切換，僅標記爲 Host-controlled。
• 安全提示：插件以當前 DSH 進程權限運行。安裝前建議檢查源碼與許可證（MIT）。

結尾¶

dsh-agent-manager 通過提供集中的工具管理界面，幫助開發者更好地掌控智能體的工具策略。更多細節可參考源碼或插件目錄。

• GitHub 倉庫
• 插件目錄