前言¶
DeepSeek Harness (DSH) 的插件生态强调模块化与增量扩展。在开发 Live Agent 场景时，”回合边界实时切换预设” 是一个特定的功能点。Agent 在运行时需要知道如何选择合适的预设，以及切换行为的触发机制。dsh-live-preset-switch 是一个为此场景设计的标准 DSH Bundle，它不直接实现引擎逻辑，而是提供指导内容。
定位与作用¶
这是一个由 HaoyanZhang123 维护的标准 DSH Bundle，属于工作流类别。
它通过一个 Host 适配器向 Profile 添加一个条目，并注册一个名为 live-preset-switch 的内置 Skill。该 Skill 包含关于 Agent 预设选择的指导，以及针对支持该功能的构建版本中，”回合边界预设切换” 的行为说明。
核心特性¶
该 Bundle 的设计目标是作为纯增量组件存在：
- 纯增量安装：通过
cordis.patch.yml仅插入一个条目dsh-live-preset-switch-skill-provider。它不会禁用、替换、重排或遮蔽任何官方@deepseek-ai/*组件。 - 自包含：无运行时依赖，无生命周期脚本（如 preinstall、install 等），无原生制品或符号链接。
- 运行时只读：适配器在运行时不进行任何文件、网络、子进程或凭据访问，Skill 正文为静态字符串。
- 提供指导：明确解释了如何选择 Agent 预设以及切换行为的具体表现。
安装与启用¶
安装该插件需指定 Profile 和仓库的固定 Commit 版本。
dsh plugin --profile <name> add --ignore-scripts 'git+https://github.com/HaoyanZhang123/dsh-live-preset-switch.git#<commit>'
安装完成后，可以通过以下命令验证配置是否生效：
dsh --profile <name> --dump-config
预期输出中应包含新增的条目 dsh-live-preset-switch-skill-provider，且在技能目录中可检索到 live-preset-switch 技能。
兼容性与注意事项¶
兼容性声明¶
兼容性声明位于 package.json 的 dsh.compatibility 字段：
- DSH 版本：
>=0.1.0-rc.8 <0.2.0 - Node 版本：
>=22.19.0 - Release 版本：对
0.1.5-alpha.2、0.1.5-rc.1、0.1.5-rc.2以及0.1.2-alpha.4、0.1.2-alpha.5、0.1.2-rc.1、0.1.3-alpha.2、0.1.5-alpha.1均声明为compatible。
注意：以上属于来源声明，不等于运行时的实际验收。目前尚未完成各版本的隔离 Profile 安装、启动、卸载及回滚的证据收集。
重要区别¶
该 Bundle 不是 Live 预设切换的引擎本身。
真正的切换引擎会修改 DSH 核心包（包括会话历史推导、agentPreset.select 回合边界守卫、Composer 芯片等），因此无法以纯增量的插件形式发布；该引擎逻辑保留在 fork 分支中等待上游评审。本 Bundle 仅提供指导内容。
许可证¶
本项目采用 MIT 许可证。
总结¶
dsh-live-preset-switch 是一个专注于提供指导信息的轻量级插件。如果你需要在 Profile 中集成关于 Agent 预设切换的行为说明，可以使用此 Bundle。它通过纯增量的方式扩展功能，不干扰 DSH 核心组件，且运行时无副作用。
