dsh-preset-workshop

dsh plugin --profile web add dsh-preset-workshop

<p align="center">

<img src="./assets/color.png" alt="预设工坊" width="112">

</p>

<h1 align="center">预设工坊 · Preset Workshop</h1>

<p align="center">

<b>让每一个 Agent 的工作方式，随您的任务而变。</b><br>

<a href="https://github.com/deepseek-ai/deepseek-harness">DeepSeek Harness</a>（DSH）插件。为每一类任务准备一套 Agent 工作环境：<br>

选择工具、写下工作方式、发送前预览，存成预设，在新会话里直接选用。<br>

<b>精简，可以由您自由组合。</b>

</p>

<p align="center">

<a href="https://www.npmjs.com/package/dsh-preset-workshop"><img src="https://img.shields.io/npm/v/dsh-preset-workshop?logo=npm&color=cb3837&style=flat-square" alt="npm"></a>

<a href="./LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-4f7cf7?style=flat-square" alt="Apache 2.0"></a>

<img src="https://img.shields.io/badge/DSH-%3E%3Dv0.2.1--rc.5-4f7cf7?style=flat-square" alt="DSH >=v0.2.1-rc.5">

</p>

<p align="center">

<a href="https://github.com/Zai-G/dsh-preset-workshop"><img src="https://img.shields.io/badge/GitHub-Zai--G-181717?logo=github&style=flat-square" alt="GitHub"></a>

<a href="https://github.com/deepseek-ai/deepseek-harness"><img src="https://img.shields.io/badge/powered_by-dsh-4D6BFE?style=flat-square&logo=deepseek&logoColor=white" alt="powered by dsh"></a>

</p>

<p align="center">

<a href="https://dsh.market/"><img src="https://raw.githubusercontent.com/2BingLing/dsh-market/master/assets/readme/badge-listed-zh.svg" height="20" alt="已被 DSH Market 收录"></a>

<a href="https://awesome-dsh-plugin.com"><img src="https://img.shields.io/badge/awesome--dsh--plugin-%E5%B7%B2%E6%94%B6%E5%BD%95-3fb950?style=flat-square" alt="已被 awesome-dsh-plugin 收录"></a>

</p>

<p align="center">

<a href="#演示">演示</a> · <a href="#为什么需要它">为什么需要它</a> · <a href="#五分钟完成第一套预设">五分钟上手</a> · <a href="#可以怎样搭配">可以怎样搭配</a> · <a href="#能做什么">能做什么</a> · <a href="#功能">功能</a> · <a href="#安装">安装</a> · <a href="#生效与边界">生效与边界</a>

</p>

---

演示

<p align="center">

<video controls muted playsinline width="100%" poster="./video/poster.png" src="https://github.com/user-attachments/assets/de045af5-17bb-42a3-aa11-0129778c2fa1"></video>

</p>

若上方播放器未显示，可 <a href="./video/preset-workshop.mp4">下载同一支片子</a>。

也可从 GitHub 或者 B站观看。

---

为什么需要它

您发给 Agent 的一句话，只是模型输入的一部分。

一次 Agent 请求还可能包含系统提示词、工具名称与定义、技能目录、工作区指令、运行环境、会话历史和工具结果。这些内容共同影响模型如何理解任务、选择工具、组织回答和塑造它的工作方式。

以我们的一次观察为例：在没有额外安装技能和插件的 DSH 环境里，用官方标准预设发送一句「你好」，请求中带着 32 个工具定义，约 8.5k token，以及一整套面向编程的系统指令。写代码时这很合适；可如果您只是想查一份资料、改一段文字、讲一道题，大部分工具都用不上，但这些内容却每次都随请求一起发出。

例如，您希望 AI 解释一道题，但当前环境带着大量编程指令、终端操作说明和开发工具。这些能力是否适合这次任务？您希望它先讲概念、举例引导，还是直接动手处理文件？这些选择可以体现在整个工作环境里。

预设工坊把这些选择放到一个可视化界面里：

👁 看清 · 🎛 调整 · 📦 复用

查看提示词、工具、技能目录与环境信息 · 按任务选择能力，编辑工作要求，观察上下文规模 · 保存多套预设，在不同任务中使用，也可以导出分享

您可能正需要它

如果您想… · 预设工坊提供 · 从这里开始

看清 Agent 实际收到了什么 · 发送前预览系统指令、可见工具、技能目录、环境与 AGENTS 指令；生成预览不调用模型 · [请求组成可视化](#请求组成可视化)

按任务选择工具 · 每个工具单独开关，按预设管理 MCP 服务与技能 · [工具按需选择](#工具按需选择细到每一项)

控制每次请求里可控部分的规模 · 调整前后都能看到按字符数估算的 token 数 · [上下文开销](#观察并调整上下文开销)

不再每个会话重复交代同样的要求 · 把回答方式、判断标准写进人设和全局 AGENTS 指令，随预设保存 · [提示词编排](#提示词与工作要求编排)

保存、切换、分享顺手的工作方式 · 多套预设互相独立，通过 DSH 原生预设选择器选用；支持 JSON / YAML 导入导出 · [多预设保存与分享](#多预设保存与分享)

同一个人常常会同时有好几个这样的需求。从任何一个入口开始都可以。

---

五分钟完成第一套预设

下面以「联网调研」为例。安装后进入 设置 → 预设工坊。

1. 新建预设

在「预设方案」中点「新建」，填写显示名称（如 联网调研）和预设 ID（如 web-research）。ID 创建后不可修改；名称和描述以后可以随时改。

2. 只留这项任务要用的工具

新预设默认带 8 个基础工具。切到「工具」分段，在「内置」里关掉调研用不上的终端和文件工具，保留 web_search、web_fetch、ask_user_question。标题会显示「已启动 N 个工具」，「预设方案」下方的预览卡会同步更新估算值。

3. 写下这类任务的做法

在「提示词」分段的人设卡里，把默认的 You are a helpful assistant. 换成您的要求，例如：

你是资料调研助手：信息给全，冗余删净。
先给结论，再列依据和来源。
只搜需要的，抓权威来源。
查完就答，不重试不多搜不反问。
依据标证据等级；查不到不编。

用自然语言写就行，不需要模板语法。「宿主」卡把人设以外、由宿主与插件注入的内容分成 System 与 User 两层，与任务无关的段落可以关闭。

4. 发送前先看一眼

点预览卡右侧的「查看」，切到「最终提示词」：人设是否在最前面，工具是否只剩您选的那几个，工作目录与环境信息是否正确。生成预览不调用模型，可以反复调整、反复查看。

5. 保存并选用

点「保存方案」，状态变为「已保存」。然后新建一个会话，在 DSH 原生预设选择器中选「联网调研」，正常提问即可。

工坊里的预设选择器只用来切换编辑对象。一个会话实际使用哪套预设，由 DSH 原生选择器决定；只有新建或尚未开始的空白会话可以选择预设。

用顺手之后，可以照同样的思路为写作、学习、编程等任务各建一套。

---

可以怎样搭配

以下是可自行搭配的用法示例；工具、技能和外部服务的可用性取决于您的安装环境。

您想做什么 · 可以怎样搭配

轻量聊天 · 关闭不需要的工具和技能，保留称呼、语气、回答长度等对话要求

学习与学科作业 · 以讲解、推导、核查为核心设置人设；按题目需要保留搜索、阅读或计算能力

写作 · 调整创作、叙事规则与全局指令，选择创作需要的工具，保存受众、文风、引用和交付格式要求

资料整理 · 保留搜索、网页抓取及必要的文件工具，绑定资料处理技能

编程协作 · 终端、文件读写与编辑、项目技能；按任务决定是否增加子代理等能力

专项工作流 · 通过 MCP 接入需要的外部能力，只开放任务相关工具，保存固定的处理步骤与检查标准

提示词研究与协作复用 · 保存不同上下文组合，分别试验效果；把选定配置导出给他人复用

这些配置需自行创建，插件未预置这些模板，也未内置效果评测。分享文件只含配置，接收方仍需具备对应工具与可解析的技能来源。

---

能做什么

能力 · 您可以控制的内容

🗂 预设管理 · 新建、改名、修改描述、启停、删除、恢复默认；每套配置独立保存，ID 创建后固定

✍️ System 编排 · 编辑人设；编辑、关闭、排序 DSH 宿主注入的系统段，第三方插件注入的系统段；添加自定义内容，查看变量实际值

📋 AGENT 指令 · 按预设覆盖或关闭全局 AGENTS 指令；新版同时支持 DSH 与共享 agents 目录的全局文件，不改原文件；无文件也可填写，目录指令只读并由宿主加载

🧰 工具选择 · 所有工具按需启用；扫描官方能力与已注册第三方工具；重型能力按包选择

📝 工具如何被理解 · 修改工具和参数的描述文字，保留调用名、参数类型、必填项与结构约束，不改变工具实现

☁️ MCP 服务 · 按预设隔离 MCP；查看官方资源工具与服务器工具，逐项开关；可创建、编辑、删除 stdio 或 streamable-http 服务器

📚 技能绑定 · 可逐项选择、全选或不选；查看来源、描述、原文与加载补充，不改技能文件

👁 请求组成预览 · 查看 System、可见工具、技能目录、AGENT、时间与时区及实际权限策略，按所选会话或目录求值

📦 配置分享 · JSON/YAML 导出当前或全部预设；导入时处理 ID/名称冲突，可确认覆盖或改名

↩️ 会话回退 · 停用或删除前检查引用并迁移到工坊内的回退预设；保留消息历史，失败保留原预设

界面跟随宿主语言与明暗主题，支持窄面板与折叠偏好；插件仅管理自己创建的预设，不改写官方预设或其他插件的业务配置。

---

功能

设置页把配置分成提示词、工具、MCP、技能与兼容五个分段，顶部的分段切换一次只显示一类；「预设方案」与预览卡始终在页面上方。

请求组成可视化

「预设方案」下方的预览卡直接显示当前规模，点「查看」打开预览窗口。窗口内分两个分段：

• 工具与技能：当前启用的工具、MCP 工具和绑定的技能；
• 最终提示词：按以下顺序展示宿主能取到的内容。

System · 系统指令
├─ 人设
└─ 宿主 / 插件系统段、自定义段

User · 会话上下文
├─ 用户消息（占位）
├─ 工作目录
├─ 环境（权限策略）
├─ 技能目录
├─ 时间与时区
├─ AGENTS「全局」
└─ AGENTS「目录」

工具 · 顶层用途（完整定义另行随请求发送）
├─ TOOL
└─ MCP（按服务器分组）

预览窗口把摘要、预览环境与工作目录固定在上方，正文只在窗口内滚动；默认使用当前打开的会话环境，也可以换成其他会话或指定工作目录，没有会话时使用宿主的新会话默认权限。只显示有内容的分组。

预览不等于抓包。 它不包含会话历史，也看不到代理转发层或供应商额外添加的内容（例如 `billion-c

…(truncated)