---

为什么做

Agent 可以执行命令、读写文件、调用网络，决定它行为的上下文却往往藏在界面之外。工具列表里有什么、系统提示词拼接了什么、哪些技能会被加载，这些内容关系到任务质量、权限与消耗，应当可以看清，也可以调整。

预设工坊是 DeepSeek Harness 的透明预设工作台。 每个预设独立保存人设、描述、系统段、工具与技能选择，不限制预设数量，也不接管其他插件创建的预设。

问答、编程、资料整理或专门工作流，各自保留需要的能力。减少无关工具与指令，让模型少一些选择负担，也让您更容易理解请求的组成。实际 token 与费用仍以模型供应商记录为准。

如果预设工坊对您有帮助，欢迎给仓库点一颗 Star ⭐，让更多人发现它。

功能

	您可以做什么
🗂 预设方案	新建、重命名、编辑描述、启停、删除与恢复默认；名称和描述同步到 DSH 原生预设
✍️ 系统提示词	编辑人设，查看实际变量，编辑、开关与排序宿主暴露的系统段；添加自定义内容
🔧 工具使用指令	整组排序与开关，逐段编辑；随着启用工具动态增减，与工具 JSON 描述独立
🧰 工具	默认八项按需开关；动态发现官方与第三方工具；重型能力按包选择
📝 工具描述	JSON 弹窗编辑描述，保护调用名、参数类型、必填项与约束；错误明确提示
📚 技能	逐项绑定、全开或全不开；查看来源路径、诊断、描述、正文和加载后的补充
🔎 扫描	启动完整扫描一次，跟随来源晚注册更新；支持手动扫描与可选定时扫描
👁 预览	查看工具与技能、简化提示词、实际权限策略；选择会话或指定目录求值
📦 导入导出	JSON / YAML，导出当前或全部；名称或 ID 重复时确认覆盖或修改后导入
↩️ 会话预设回退	停用、删除前检查引用并迁移；消息历史保留，失败保留原预设

界面跟随宿主语言与明暗主题，采用纵向卡片布局。

安装

npm 包名 dsh-preset-workshop，以下三种安装方式任选一种。

从 npm 安装（推荐）：在 DSH 对话中，请 Agent 使用宿主 plugin_manager（Creator 模式）安装该包：

{
  "action": "install_bundle",
  "target": "dsh-preset-workshop"
}

命令行等价：dsh plugin --profile <profile> add dsh-preset-workshop。

从本地目录安装：下载或克隆本仓库，保留完整插件目录：

{
  "action": "install_bundle",
  "target": "<插件目录的绝对路径>"
}

从 GitHub 安装：仓库地址 https://github.com/Zai-G/dsh-preset-workshop。本插件是原生 ESM、没有构建步骤，仓库里的源码就是运行代码，因此不需要 TypeScript 插件那样的 prepare 脚本，也不需要 allowBuilds 构建授权。

{
  "action": "install_bundle",
  "target": "github:Zai-G/dsh-preset-workshop"
}

命令行等价：dsh plugin --profile <profile> add github:Zai-G/dsh-preset-workshop。可在末尾用 #<commit> 锁定到具体提交，避免仓库后续推送悄悄改变实际运行的代码，例如 github:Zai-G/dsh-preset-workshop#<commit>。DSH 会在安装前用 git ls-remote 确认仓库可达。

检查安装结果：application: applied 表示已应用；restart-required 表示需要重启。随后打开 设置 → 预设工坊。

安装与更新由宿主管理，请勿手写 profile 配置。

使用

1. 新建方案：填写名称和 ID。ID 创建后不可改，名称与描述可以随时调整。
2. 编写人设：初始为 You are a helpful assistant.。可写入宿主注册的 {{cwd}}、{{model}}、{{provider}} 等变量，在变量区查看实际值。$ENV 文本不会自动替换。
3. 组合能力：选择工具、系统段与技能，按任务需要精简。绑定技能时会联动开启可用的 skill 工具，您仍可手动关闭。
4. 检查预览：查看启用能力与最终提示词。默认读取当前打开的会话环境；没有会话时采用宿主的新会话默认权限。
5. 保存并使用：「保存方案」保存全部草稿；提示词区「保存」只保存提示词；工具描述弹窗只保存该项。然后在 DSH 原生选择器中选用预设。

工坊的方案选择器切换编辑对象，不会擅自切换当前会话的预设。

默认八项为 shell、read、edit、write、web_search、web_fetch、ask_user_question、todo_write。macOS / Linux 使用 Bash，Windows 使用 PowerShell；具体可用性以宿主安装与扫描结果为准。升级保留已有预设的明确选择。

看清请求的组成

# SYSTEM
You are a helpful assistant.

（官方系统段、工具使用指令、自定义内容与实际插件系统段）

## TOOL
read：Read a UTF-8 text file and return line-numbered content.

write：Create or fully replace a UTF-8 text file.

# USER
［用户第一句话 · 仅作占位显示，预设工坊不修改会话消息。］

## 环境策略
（宿主渲染的实际权限与审批策略）

## SKILL
（官方技能目录：名称、摘要与加载规则）

## AGENT［全局］
（当前预设的全局指令）

## AGENT［目录］
（宿主自动载入的工作区指令；没有内容时不显示）

这是便于阅读的分组视图。工具仅展示顶层描述，完整 schema 仍进入实际请求。AGENT、环境策略和技能目录属于 User 上下文；标题不改变消息角色，也不复刻已有会话的完整历史。token 按字符数估算，不是计费账单。

生效范围

修改	已开始会话中的生效时机
人设、系统段、工具使用指令及其顺序	下一次模型请求
已挂载工具的开关与描述	下一次请求；宿主其他限制继续有效
技能绑定	下一次目录发布与技能加载
全局 AGENT 覆盖或关闭	下一次请求追加替代旧全局指令的说明，目录指令保留
新增重型工具或更换工具来源／参数结构	释放并恢复会话后挂载；界面提示待恢复能力
停用或删除预设	空白会话立即重绑；已开始会话下次恢复时使用回退预设

已发出的请求与已执行的操作不会被回写或撤销。

提示词、技能与扫描的边界

• 系统段：编辑宿主实际暴露的 section；数量与来源不限。工具使用指令按原生段编辑，随着工具选择变化；工具 JSON 只修改 schema 描述。
• AGENT：全局项覆盖官方 <DSH_HOME>/AGENTS.md，只作用于当前预设，不写原文件。不存在全局文件时仍可为该预设填写内容；目录指令由宿主自动载入，独立保留并只读展示。官方 <system-reminder> 包装沿用宿主渲染器。
• 技能：借用真实 provider，不复制或改写源文件。同名来源按宿主规则解析；列表、详情与调用保持一致。目录只发布摘要，正文与 provider 补充在调用 skill 后加载。
• 权限：读取宿主实际策略，不替代权限设置。所选会话策略变化或默认策略变化后，预览会自动更新；扫描也重新求值。
• 第三方能力：只能列出宿主已注册的工具。来源插件关闭、未注册的工具需先在那里启用。
• 代理层：（如billion-context） 在代理转发层追加的压缩指令没有暴露 DSH 读取／覆盖接口，工坊会提示该边界，不能预览、编辑或排序这一层。扫描不等于完整供应商 HTTP 抓包。

兼容性

目标宿主为官方 DeepSeek Harness 0.2.0-rc.2。插件复用宿主的文件系统、shell、权限、技能和 Web 设置服务，无额外前端构建步骤。

工具和技能随各平台实际安装的官方包及第三方来源变化。使用 dsh web 或官方桌面端打开工作台。官方 headless／SDK／ACP 默认未挂载本插件依赖的预设服务，不属于本插件的适用入口。

数据与卸载

业务数据与插件仓库分离：

<DSH_HOME>/preset-workshop/
├── config.json                设置与预设索引
├── catalog.json               工具发现快照
└── presets/<id>/
    ├── preset.json            名称、描述、状态、技能
    ├── prompt.json            人设与系统段覆盖
    └── tools.json             工具选择与描述覆盖

路径跟随宿主 DSH_HOME，支持 home 缩写；未设置时使用 ~/.dsh。保存使用文件锁、原子替换和 journal 恢复，revision 冲突会阻止覆盖。分享导出文件前，请检查其中的人设、指令、路径与技能名称。

卸载前，请先把引用本插件预设的会话迁移到仍可解析的宿主预设，再使用 plugin_manager 的 remove_bundle。直接卸载可能导致这些历史会话无法恢复；卸载保留业务数据，需要清理时请先备份。

使用提醒与免责声明

[!WARNING] 修改提示词、工具描述或技能会影响 Agent 的判断与操作。请在理解内容和权限后使用，并保留重要资料备份。保存、取消和恢复默认无法撤销已经发生的操作。由修改系统提示词与工具描述造成的后果，包括误删或覆盖文件、隐私泄露和额外费用等，由您自行承担。

权限与审批由 DSH 和来源插件执行。预设工坊不能保证模型行为或第三方插件安全，也不能替代您的判断、备份和账单核对。本插件按 MIT 许可 的“现状”提供；作者不对使用造成的损失承担责任，请确保您了解LLM与提示词机制后在使用本插件创建一个属于您专属AI预设，否则建议您仅使用官方预设。

版本与更新

当前公开版本为 v0.1.0，已发布到 npm。GitHub Releases 和 更新日志 记录每版功能、兼容性及升级注意事项。

近期优先处理 0.1.x 的稳定性、真实桌面端与 Windows / Linux 验收；后续再推进宿主版本适配及导入诊断。具体维护优先级见 更新路线，计划能力与已实现功能分别标明。

源码

src/                 Host 服务、请求策略、存储与原生客户端
assets/              黑白导航图标与彩色品牌图标
cordis.patch.yml     Bundle 入口

---