前言¶
DeepSeek Harness（DSH）的 Agent 预设原本只能在 Cordis 组合里声明。想调整 Persona、复制内置预设或试用别人分享的配置，都要改 DSH 的配置文件再重启。这个插件换了一条路径：在 DSH 运行时直接通过 ctx.agentPresets.register() 动态注册预设，所有配置读写都发生在插件自己的数据目录里，不修改任何 DSH 配置文件。
是什么¶
Agent 预设管理器是 rvaim 维护的 DSH 插件，包名 @rvaim/dsh-preset-manager，当前版本 0.5.0，许可证 MIT。它通过 AgentPresetRegistry 服务在运行时注册与管理 Agent 预设，提供 Web 界面的预设列表、查看、复制、编辑、派生、导入、导出、启用/停用功能，并自带三个只读预设。插件默认安装后会在「设置 → 预设管理」出现一个设置页。
已实现能力¶
- 不修改 DSH 配置文件：所有预设注册与数据读写都在插件自己的目录里，
cordis.patch.yml哈希前后一致。 - 运行时注册与注销：插件启用时逐个注册预设，停用时逐个注销；重启 DSH 后自动恢复。
- 插件自带预设：启用后提供三个只读预设，可在设置页查看、复制或派生为可编辑的自定义预设：
standard-efficient：标准增强，基于 DSH Standard 的自适应高效编码 Agent。codex-original：Codex 原版，使用 OpenAI 官方公开基础提示词原文的实验预设。redteam-mode：红队模式，意图归一化 + 25 条域规则路由 + 确定性输出槽 + 破甲自检。- 预设操作：支持查看、复制、编辑、派生、导入、导出、启用/停用、删除；停用只撤销运行时注册，配置和历史仍保留。
- 预设列表与启停：列表以卡片形式展示，内置、自定义和第三方预设分类显示；启停状态保存在插件数据目录，重启或重新启用插件后仍生效。
- 导入导出：通过文本往返实现预设分享与迁移。
- 冲突检测：已有同名用户预设或第三方预设会保留，并报告冲突。
- 停用不删数据：停用后
presets/、history/、metadata.json全部保留。 - 版本控制：编辑或恢复已停用的预设不会自动启用；新建、派生和导入的预设默认启用。
- 修订号冲突检测：用过期 revision 保存会被拒绝。
- 诊断与提示：Standard 缺失、异常或其 Persona 结构无法安全识别时，会显示诊断，不回退到猜测的配置。
安装与启用¶
在 DSH 环境中通过官方安装命令启用：
dsh plugin add github:rvaim/dsh-preset-manager
安装后进入「设置 → 预设管理」即可看到预设管理页。插件会在 DSH 启动时读取自己的预设文件并注册，停用时逐个注销。
典型用法¶
- 查看自带预设：在「设置 → 预设管理」中可以看到三个内置预设，点击「复制并编辑」可生成可编辑的自定义预设副本。
- 编辑与保存：点击「编辑」打开编辑弹窗，可以修改元数据、前置/后置模板、插件组合树等，保存后会在运行时注册更新。
- 启用/停用预设：在列表中点击启停开关，或通过
preset_manager_set_enabled命令程序化控制。 - 导入导出：点击「导出」将当前预设配置复制到剪贴板，分享给他人；他人点击「导入」粘贴即可恢复。
- 删除与恢复：删除后注册会被撤销，但数据仍保留，可恢复。
适用场景与注意¶
- 适合需要在 DSH 运行时动态管理预设、不希望修改配置文件的开发者与使用者。
- 适合需要频繁试用不同 Agent 组合、进行 A/B 测试或红队演练的场景。
- 插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（本插件自身为 MIT，Codex 原文为 Apache-2.0）。
- 若把自定义预设设为默认后又删除，DSH 仍指向该 ID，插件会在删除前提示用户在 DSH 设置里改回内置预设。
- 卸载后插件数据目录会保留，不会自动清理，需手动删除
$DSH_HOME/dsh-preset-manager/。 - 历史会话的预设引用受 DSH 原生规则限制，插件不修改会话日志。
结尾¶
Agent 预设管理器在 DSH 运行时提供了完整的预设生命周期管理能力，在不触碰配置文件的前提下支持查看、编辑、启用/停用、导入导出。适合需要频繁切换或实验 Agent 组合的场景。
- 目录页：https://www.skillhub.cn/plugins/rvaim/dsh-preset-manager
- GitHub：https://github.com/rvaim/dsh-preset-manager
