预设工作台 matamt-dbg/dsh-studio

DSH Studio

看得见、调得动、发得出 —— 给 DeepSeek Harness 做智能体预设，不用手写 YAML。

DSH Studio 是 DeepSeek Harness 的插件，把搭建预设变成 Web GUI 里的可视化工作流。

为什么做这个

DeepSeek Harness 可配置的东西很多：智能体拿到哪些工具、每个工具怎么向模型描述、系统提示词的各个段落、插件设置，以及工作怎么委派给子代理。但这些配置只有写进 智能体预设 才生效，而手工搭预设就得编辑组合文件，看不到模型最终会收到什么。

Studio 把这一环补上：

- 让配置看得见。 在同一屏里挑工具、改指令和工具描述、覆盖插件设置。
- 跑之前先检查。 预览预设产出的系统提示词和工具 schema 原文，不用启动智能体。
- 一键应用。 把预设注册到 DSH，新建会话时直接选它。

方向：少些噪音，把 DSH 用得更顺

Studio 还附带 Optimized，一个起步预设，思路很简单：智能体看到的工具越少越清楚，干活越顺，而且它知道 DSH 期望这些工具怎么用。

跟默认配置相比，Optimized 做了这些：

- 固定起步工具集：27 个工具，再装别的插件也不会让预设的选择变多。这不是运行时封锁：DSH 或其他插件加进运行中会话的工具照样能用。它去掉了目标/待办跟踪、插件管理，以及环境/媒体类工具——这些对编码任务基本没帮助（如果你的配置档提供了它们，仍可在 Studio Master 里选）；
- 把委派收进一个工具 subagent_role，取代好几个通用子代理工具，并附带 Worker 角色：继承同一套指令，但不能委派、不能提问，也不能用编排工具（judge、pixie_loop）；
- 加了工作指令，也调了工具描述：让模型一次读完整个文件、批量读取（read_batch）、批量改同一个文件（edit_batch），长命令转成后台任务继续跑再统一收集，汇报前做的检查也保持适度。

在我们早期的内部基准测试里，这个预设的表现明显好于 DSH 默认的 standard 预设。
未编辑时，Optimized 跟随已安装的 Studio 版本和 DSH 的 standard 预设：启动时 Studio 会重新对齐它，并保留 compaction、AGENTS.md 指令等全部 standard 功能。你可以直接编辑，随时点 Restore defaults 恢复默认；编辑过的 Optimized 和你复制的副本，Studio 永远不会改动。

Optimized 针对 coding-agent 工作 调优。它是起点，不是固定配方：编辑或复制它，按自己的任务调整工具、指令、工具描述和插件配置。参见 Adapt Optimized to your work。

DSH Studio 是社区项目，与 DeepSeek 无隶属关系，未获其背书，也不由其提供支持。

安装

需要 DSH 0.2.0-rc.2、0.2.1-alpha.2、0.2.1-rc.1、0.2.1-rc.2 或 0.2.1-rc.3。

dsh plugin --profile web add @matamt-dbg/dsh-studio # dsh web
dsh plugin --profile desktop add @matamt-dbg/dsh-studio # desktop app: quit the app first

重启 Web 界面或应用，然后从侧边栏打开 DSH Studio。每个配置档各自保留自己的预设和工具集。

兼容性

以下检查在 macOS 上完成，使用未修改 DSH 运行时的隔离配置档。较早的运行版本行描述的是此前版本，0.6.6 未重新运行。这些检查都不构成完整的兼容性保证：

| DSH | 检查内容 |
| 0.2.1-rc.3 | 0.6.6：安装、Web 启动、四项 HTTP 检查；用本地测试模型验证 Fresh/Fork 角色指令、Tool Filter 和历史记录；480 px 下的 Studio/Pixie 与 Subagents 溢出菜单 |
| 0.2.1-rc.2 | 安装、Web 启动和四项 HTTP 检查（Master、Optimized 副本、会话角色、角色保存/重新应用/恢复）；桌面应用中 Studio 加载 |
| 0.2.1-rc.1 | 同样的 HTTP 检查；用本地测试模型验证 Fresh 和 Fork 角色子代理保留指令与 Tool Filter，重启后同样成立 |
| 0.2.0-rc.2、0.2.1-alpha.2 | 同样的 HTTP 检查 |

未检查：这些检查中的外部模型调用、从 0.5.0 升级数据，以及其他操作系统。升级前请备份配置档。参见 0.6.1 release notes。

功能

Preset list

- 预设 — 只读的 Studio Master，跟随 DSH standard 加上 Studio 自带插件；内置 Optimized 预设（27 个工具和一个 Worker 角色），可编辑、可恢复默认；还有你自己的预设。可编辑、复制、删除、应用到 DSH，或取消应用。
- 提示词与工具 — 编辑 persona 和附加指令，挑选工具（或整个内置工具集），重写模型看到的每个工具和参数描述。
- 提示词预览 — 不启动智能体，直接查看预设生成的系统提示词、工具 schema、运行时上下文和每轮消息。
- 执行设置 — 默认包含全部插件；把插件移出预设，就能只针对某个预设覆盖插件配置。执行默认值显示预设为 bash 和 job_output 填入的等待时间，关掉其中一项，DSH 的 shell 设置会重新生效。
- 插件 — 查看配置档里已安装的插件，以及它们在哪里运行：把智能体功能连同初始设置一起加进 Studio Master，或者一键注册配置档级插件（比如网页搜索服务商）。配置档设置按工作流类别归组共享的 Host 设置 — 网页搜索与抓取（带服务商选择器和手动输入）、委派服务商、循环防护、目标续跑、上下文、MCP 服务器、模型重试 — 支持搜索、密钥打码，改动应用到每个会话。
- Exa 网页搜索与抓取 — 在配置档设置里，为 web_search 选 Exa，为 web_fetch 选单独的插件 @matamt-dbg/dsh-web-fetch-exa（exa-contents）。请从 DSH 插件页面或 dsh plugin add 安装插件，不要用 npm i；见 Exa 网页搜索与抓取。
- 子代理 — DSH 的通用子代理工具合并成一个 subagent_role 工具。定义角色时，可以指定各自的模型、推理强度、全新启动还是 fork 启动，以及人设；不定义角色时，subagent_role 启动的子代理继承父级设置。
- 按会话的子代理角色 — 每个会话里的 Subagents 标签页可以改角色的模型、推理强度和指令，或者新增角色，只对该会话生效。
- 韩语版 DSH — 在 DSH 的语言设置里选한국어，DSH 自己的界面也会跟着翻译。
- Studio 快捷键 — SettingsX 补上了 DSH 缺少的键盘命令：上一个/下一个会话、跳到会话 1–9、复制工作文件夹、全屏。
- Pixie 与 Pixie Gate — 右侧边栏里的旁路模型（/pixie），从不进入对话；还有按预设检查提示词、工具调用和已完成回答的 gate。钩子脚本可以用决策引擎（LLM 或 TypeSafe Jev）判断，不经过 Pixie 也能下结论，还能在回答下方留备注，比如韩语翻译。智能体拿到同一个引擎，作为 judge 工具，外加一个 studio-pixie-hook-guide 技能来写 gate。见 Pixie Gate 指南。
- Pixie Loop — pixie_loop 工具在智能体上下文之外，让大量独立条目依次走完 工作 → 精确检查 → 决策引擎判断 → Pixie 反馈 → 重试，只返回计数、结果文件和仍然失败的条目。输出可以按打印内容运行并判断（act），可以逐步处理，也可以从列出的选项里挑。保存的 recipe 还能在 Pixie Gate 和钩子脚本里判断或修复内容（pixie loop）。运行记录显示在 Pixie 标签页 › Loops；studio-pixie-loop-guide 技能负责写规格。见 Pixie Loop 指南。
| 提示词与工具 | 提示词预览 | 子代理角色 |
| Tools | Preview | Roles |

新内容：English · 한국어 · 介绍：English · 한국어 · 用户指南：English · 한국어 · 更新日志

快速开始

1. 打开 DSH Studio，在 Optimized 上选择 Edit 或 Create copy。
2. 调整指令、工具、执行设置和子代理角色，然后 Save preset。
3. 在 Preset list 中选择 Apply to DSH。
4. 新建会话，在 DSH 的预设选择器里选中你的预设。

预设按配置档存放在 studio-data/ 下。应用预设会注册一个 Studio 自有的 DSH 智能体预设；它不会改动其他预设，也不会改动配置档里的包。

预设选中的工具就是会话的起始工具集。如果配置档没有提供其中某个工具（例如桌面应用之外的 load_workspace_dependencies），应用预设会直接失败，而不是悄悄丢掉这个工具。DSH 或其他插件在运行中的会话里添加的工具（比如 schedules）仍可正常使用。参见依赖配置档的工具。

开发

pnpm install
pnpm test # typecheck, build, tests
node pack.mjs # writes dist/matamt-dbg-dsh-studio-<version>.tgz

请在 Issues 中反馈 bug 和需求。

许可证

MIT