前言¶
Agent 在 DSH 中会调用工具并加载技能，决定其行为的上下文往往不在对话界面里。人设是什么、系统提示词拼接了哪些段落、启用了哪些工具、哪些技能会被加载，这些内容会影响任务结果、权限和消耗。
预设工坊 · Preset Workshop 用于为 DeepSeek Harness 管理人设、系统提示词、工具与技能，并预览请求组成。它适合需要按任务维护不同 Agent 配置的 DSH 使用者。
预设工坊由 Zai-G 维护，仓库标识为 Zai-G/dsh-preset-workshop。当前公开版本为 v0.1.0，目标宿主为 DeepSeek Harness 0.2.0-rc.2。
下面介绍安装、典型用法与使用边界。
这是什么¶
预设工坊是一个 DSH 预设工作台。它将常见配置集中管理：预设方案、人设、系统段、工具使用指令、工具、工具描述、技能、预览、导入导出与预设回退。
它会把名称和描述同步到 DSH 原生预设，并在 DSH 原生选择器中使用。
它依赖宿主挂载的预设服务。使用 dsh web 或官方桌面端打开工作台；官方 headless／SDK／ACP 默认未挂载本插件依赖的预设服务，不属于适用入口。
核心功能¶
预设方案¶
可新建、重命名、编辑描述、启停、删除与恢复默认预设。名称和描述同步到 DSH 原生预设。
人设与系统提示词¶
可编辑人设，查看实际变量。可编辑、开关与排序宿主暴露的系统段，并添加自定义内容。
工具使用指令¶
可对工具使用指令进行整组排序与开关，并逐段编辑。
工具¶
支持默认八项工具按需开关，动态发现官方与第三方工具，重型能力按包选择。
工具描述¶
可在 JSON 弹窗中编辑工具描述，保护调用名、参数类型、必填项与约束，并明确提示错误。
技能¶
可逐项绑定、全开或全不开技能，并查看来源路径、诊断、描述、正文和加载后的补充。
扫描¶
启动时完整扫描一次，跟随来源晚注册更新；支持手动扫描与可选定时扫描。
预览¶
可预览工具与技能、简化提示词、实际权限策略；支持选择会话或指定目录求值。
导入导出¶
支持导入导出 JSON / YAML，可导出当前或全部；处理名称或 ID 重复时的覆盖或修改。
会话预设回退¶
停用或删除预设前检查引用并迁移，保留消息历史；失败保留原预设。
安装与启用¶
安装与更新由宿主管理，请勿手写 profile 配置。
在 DSH 对话中，请 Agent 使用宿主 plugin_manager（Creator 模式）执行安装：
{
"action": "install_bundle",
"target": "dsh-preset-workshop"
}
命令行等价命令如下：
dsh plugin --profile <profile> add dsh-preset-workshop
安装后检查 application: applied 或 restart-required。显示已应用时，打开“设置 → 预设工坊”；显示需要重启时，先按宿主提示重启，再进入设置。
典型用法¶
下面以新建一个预设方案为例。
1、新建方案：填写名称和 ID。ID 创建后不可改；名称与描述可随时调整。
2、编写人设：可写入宿主注册的 {{cwd}}、{{model}}、{{provider}} 等变量，并在变量区查看实际值。$ENV 文本不会自动替换。
3、组合能力：选择工具、系统段与技能以精简能力。绑定技能时会联动开启可用的 skill 工具，仍可手动关闭。
4、检查预览：查看启用能力与最终提示词。默认读取当前打开的会话环境；没有会话时采用宿主的新会话默认权限。
5、保存并使用：点击“保存方案”保存全部草稿；提示词区“保存”只保存提示词；工具描述弹窗只保存该项。再在 DSH 原生选择器中选用预设。
适用场景与注意¶
适合需要查看请求组成、精简工具与技能、维护多个预设方案的 DSH 使用者。
使用注意：
- 权限与审批由 DSH 和来源插件执行；预设工坊不能保证模型行为或第三方插件安全，也不能替代判断、备份和账单核对。
- 修改提示词、工具描述或技能会影响 Agent 的判断与操作；保存、取消和恢复默认无法撤销已经发生的操作。
- 工具仅展示顶层描述，完整
schema仍进入实际请求；token按字符数估算，不是计费账单。 - 代理层追加的压缩指令没有暴露 DSH 读取／覆盖接口，不能预览、编辑或排序该层。
- 卸载前应先迁移引用本插件预设的会话，再使用
plugin_manager的remove_bundle；直接卸载可能导致这些历史会话无法恢复。 - 安装前请检查
MIT许可；如需要评估源码，可查看 GitHub 仓库。 - 本插件按
MIT许可的“现状”提供，作者不对使用造成的损失承担责任。
链接¶
- GitHub：https://github.com/Zai-G/dsh-preset-workshop
