前言¶
在 DeepSeek Harness (DSH) 的开发中,代理经常面临一种姿态不适配的问题:要么在单行回答的任务上过度规划,要么在需要严谨计划的重构任务中即兴发挥。常驻系统提示词的“教条”会随着对话轮次增加而稀释,变成模型不再阅读的“壁纸”。
DSH 插件 dsh-mode 提供了一种机制:通过 switch_mode 工具在切换瞬间注入阶段对应的方法论,引导接下来的工作,而不是将其作为永久规则写入系统提示词。
这是什么¶
dsh-mode 是由 xiyiyiru 维护的 DSH 插件,属于工作流分类。
它提供了一套无状态的工作模式切换工具。插件的核心价值在于:在需要改变工作姿态的节点,通过工具调用交付特定的方法论,而不是在系统提示词层面做全局修改。自 0.1.0-rc.6 起,该工具不再修改系统提示词,也不写入会话事件。
核心功能¶
该插件主要包含以下能力:
- 模式切换工具:提供
switch_mode工具,支持在五种预设模式间切换。 - API 导出:提供
MODES、CORE_BEHAVIOR等导出 API,供开发者获取模式定义和核心行为原则。 - 无状态设计:工具本身是无状态的,不修改系统提示词,不重新注入,也不携带快照。
- 核心行为原则:在系统提示词中贡献一个静态部分
mycel:core-behavior(顺序 10),定义一套模式无关的底层工作原则(如根因优先于行动、诚实对待不确定性等)。 - 幂等性:切换到同一模式会重新读取对应的方法论,作为恢复路径。
安装与启用¶
通过 DSH 的插件管理器安装,依赖项会自动解析。
dsh plugin --profile <name> add @xiyiyiru/dsh-mode
典型用法¶
switch_mode 工具的返回值包含当前模式的方法论文本,模型在收到结果后依据该文本调整后续行为。常见的切换场景包括:
- planner 模式:当目标需要决策完整的计划时切换。接收计划的执行者将不再做进一步决策。
- analyst 模式:当需要判断、根因分析或影响评估时切换。该模式侧重于事实裁判、收集证据和陈述影响,不直接修复问题。
- explorer 模式:在处理不熟悉的代码或进行只读侦察时切换。侧重于产出结构、职责和关键路径,不触碰代码。
- executor 模式:当计划被批准,只剩下执行步骤时切换。严格按计划执行,并暴露计划中的漏洞而非默默改进。
- base 模式:默认姿态,用于直接回答,不经过复杂仪式。
适用场景与注意¶
该插件适合需要在对话流程中动态调整代理思维模式的场景。
注意事项:
- 无状态与日志:自 0.1.0-rc.6 起,切换操作不会写入会话事件,依赖日志系统跟踪。
- 系统提示词:插件不会修改系统提示词,也不会在退回或后续轮次重新注入模式内容。
- 解耦:自 2026-09-03 起,该插件已与状态插件的任务栈解耦。
- 依赖:依赖 peerDependencies 自动解析,安装前需确保环境满足版本要求。
- 许可证:MIT 许可证。
结尾¶
dsh-mode 通过在切换点注入方法论,解决了常驻提示词稀释和姿态错配的问题。它将模式切换变为一次显式的工具调用,保持系统提示词的纯净,同时为代理在不同阶段提供针对性的思维引导。
插件目录与源码:
https://www.skillhub.cn/plugins/xiyiyiru/dsh-mode
https://github.com/xiyiyiru/dsh-mode