前言¶
在 DeepSeek Harness（DSH）里做 Agent，常见做法是手写配置、绑工具、改提示词，再在正式会话里试错。工具来自多个插件时，还要自己理清「谁提供哪几个工具」；试跑阶段若工具返回不理想，往往只能重跑整条链路。若要把一套 Agent 搬到另一台机器，还要单独整理模型、插件与预设。
dsh-workbench-agent-studio（社区目录名：lucky01222/dsh-workbench-agent-studio）是面向 DSH Web 的可视化 Agent 工作台插件，由维护者 lucky01222 发布，分类为工作流。它把「选模型与指令、按插件绑定工具、试跑时可改工具结果、会话能力快照、导出独立预设」收进侧边栏 Agent Studio，并附带引导式 Agent 创建助手 预设，用于在对话中起草新 Agent。
这是什么¶
一句话：在 DSH Web 里可视化创建、试跑、修订 Agent，并按插件绑定工具；支持会话能力快照与导出可在其他环境运行的独立预设。
- 仓库：lucky01222/dsh-workbench-agent-studio
- 社区目录：SkillHub 插件页
- 许可证：MIT（见仓库
LICENSE）
核心功能¶
配置、试跑与修订¶
- 在侧边栏打开 Agent Studio，新建 Agent 或复制内置预设。
- 选择对话模型、指令（instructions）、插件工具与 Skills；可从某插件选用全部当前工具，或显式勾选只读子集。
- 发送试跑消息；工具可手动或自动执行，试跑过程中可编辑工具返回结果，再继续或重跑；历史试跑记录保留。
- 用保存好的 Agent 开始正常对话，或导出预设供其他安装使用。
工具归属以宿主实际注册为准。会话开始时，Studio 会记录有效工具集与插件身份；已有会话与历史重试保留当时记录的范围；插件被移除或归属变化时会提示，不会静默替换工具。
引导式 Agent Creator¶
在开始对话前选择 Agent 创建助手 / Agent Creator。该预设会收集需求、选择可用能力、起草指令、检查草稿、提供试跑，并在确认后才保存。Creator 专用工具仅作用于该预设，不会进入标准模式或其他 Agent。Creator 试跑中只读工具会执行，其他调用仅记录不执行。未保存的草稿不会出现在 Studio Agent 列表中。
对宿主工具层的影响¶
Studio 会禁用官方 tools 配置行，并安装记录插件归属的 ToolRuntime 子类；工具执行、schema 校验、权限与范围仍由官方超类处理，并继承原配置行的设置。同时挂载能力快照服务，并将已保存的 Agent 注册为预设。
注意： 其他会替换工具提供方或改写同一工具层的插件可能冲突，合并使用前请检查配置。安装、卸载或修改工具提供方配置后需重启对应 profile。
数据与卸载¶
数据存放在宿主配置的存储后端（默认 $DSH_HOME/storages）下的官方域：
| 域 | 内容 |
|---|---|
workbench_agent_studio |
Agent、修订、试跑、评估、工具回执与提示草稿 |
workbench_agent_studio_capabilities |
会话能力快照 |
workbench_agent_studio_library_migrations |
显式兼容迁移回执（Library 为可选） |
默认工作目录为 $DSH_HOME/workbench-agent-studio/workspace。模型、凭据与工具提供方来自宿主；试跑内容会发给所选模型，所选工具以宿主权限执行。
卸载插件 UI/API 后，已保存数据仍保留，重装后可再次使用；卸载不会删除用户文件或会话。导出的预设若要在别处运行，仍需安装下文 portable runtime。
在其他环境运行导出的预设¶
在目标宿主安装 portable runtime、导出 Agent 实际依赖的工具插件，并配置模型：
dsh plugin --profile web add https://github.com/lucky01222/dsh-workbench-agent-studio/releases/download/v1.13.3/dsh-workbench-agent-studio-runtime-1.10.5.tgz
dsh web --patch /path/to/exported-agent.yml
导出内容包含宿主级工具注册表与快照服务以及预设声明；不要在每个 Agent 内再挂载另一套快照服务。目标环境不需要 Studio 的 Service 与 UI。移除导出预设的 patch 后再卸载对应 runtime。
安装与启用¶
环境要求：Node.js 24+，以及 DSH Web 0.1.7-rc.2 或 0.2.0-rc.2。官方声明仅与上述两个 DSH 版本兼容；0.2.1-alpha.5 移除 both 工具模式并改变 PTC 行为，当前发行版不支持。安装与启动请使用同一 DSH_HOME。
先停止目标 Web profile，再执行：
dsh plugin --profile web add https://github.com/lucky01222/dsh-workbench-agent-studio/releases/download/v1.13.3/dsh-workbench-agent-studio-1.13.3.tgz
dsh web
上述命令安装 GitHub Release 预构建包。该版本若已上架 npm，也可按包名安装 dsh-workbench-agent-studio@1.13.3。应用包内含 service、UI 与 runtime 组件；导航、主题与 Library 为可选，Studio 安装包不包含 Library。
也可从 GitHub Releases 下载 .tgz，将本地路径传给 dsh plugin --profile web add。直接安装 GitHub 源码检出不等价于 Release：编译产物 dist/ intentionally 未提交仓库。
版本对应： Studio 1.13.3，portable runtime 1.10.5。macOS Apple Silicon 桌面版 0.2.0-rc.2 已通过额外桌面检查（见仓库 docs/compatibility.md）；其他桌面构建未验证。桌面安装使用捆绑 CLI 与 --profile desktop，而非 Web profile。
卸载：
dsh plugin --profile web remove dsh-workbench-agent-studio
卸载后需重启 profile。移除 Studio 包会恢复官方工具提供方（除非另有用户 patch 禁用）。
典型用法流程¶
下面步骤与 README「Configure, try, revise」一致，可在本地复现：
- 打开 Agent Studio → 创建或复制预设。
- 配置模型、指令、插件工具与 Skills（全量或子集）。
- 试跑一条消息，按需手动/自动跑工具，编辑结果后继续。
- 满意后用于正式对话，或导出
exported-agent.yml并在目标机配合 runtime 启动。
需要从零起草时，先选 Agent Creator 预设，按引导完成草稿与试跑后再保存。
适用场景与注意¶
适合： 需要在 DSH Web 里反复调 Agent 提示词与工具组合、希望在试跑阶段改工具输出再继续、或要把 Agent 打成可迁移预设的开发者。
权限与安全： 插件在当前 dsh 进程权限下运行；试跑与正式对话都会调用你配置的模型与已选工具。安装前请阅读仓库源码与 MIT 许可证，并确认与现有工具类插件无冲突。
生态说明： DSH 采用「一切皆插件」架构；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-workbench-agent-studio 把 Agent 的配置、按插件绑工具、可编辑试跑与会话快照集中到 Web 工作台，并支持导出预设与 portable runtime，便于在另一套 DSH 宿主上复用同一 Agent 定义。
