前言¶
DeepSeek Harness 采用插件化架构,智能体预设通常包含大量工具。在管理这些工具的声明与状态时,区分哪些工具对用户可见、如何处理静态禁用与动态控制,容易产生混淆。dsh-agent-manager 插件为此提供了解决方案,它作为设置插件运行,专门用于管理智能体预设的工具策略。
这是什么¶
dsh-agent-manager 是由开发者 hrhgit 维护的 DeepSeek Harness 设置插件。它的核心作用是在智能体预设声明的范围内,查看并切换工具。它不负责管理模型提供商或模型元数据。
核心功能¶
该插件提供以下具体能力:
- 工具可见性筛选:仅显示预设中明确声明带
agentTool.label的工具。未声明此字段的工具,即使其包提供工具,也不会在界面中出现。 - 本地预设编辑:允许用户切换本地预设中静态的
disabled状态。 - 预设读写保护:系统和 shipped 预设为只读状态。若需编辑,需先将其复制到用户预设。
- 状态可视化:显示工具的具体状态,包括托管控制、未挂载、可用、不可用或过期。
典型用法¶
插件通过 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 通过提供集中的工具管理界面,帮助开发者更好地掌控智能体的工具策略。更多细节可参考源码或插件目录。