dsh-agent-studio

简体中文 · English · 在线文档

一个 DeepSeek Harness 图形化插件：可视化地精确配置 Agent 的提示词（prompt）、工具（tools）、可见技能（skills）、子代理、备用模型，轻松创建团队，根据不同任务分配不同模型。

模型每一轮看到的东西就三份：系统提示词、工具目录、技能目录。随着插件、工具、MCP 越装越多，这三份只会越来越大，拖累模型表现。另外 DSH 目前给子代理的配置极其简陋，没法轻松配置它的提示词、工具、技能、模型和思考强度。

本插件的配置存在自己的数据里，不改动宿主既有的预设定义，卸载即恢复原状。

它把 Agent 拆成可随意拼装的积木：提示词、工具、技能、模型拼成一个完整 Agent，子代理也一样能高度定制；预设可以随手新建；兼容官方 PTC 模式；支持设备备用模型。

可以搭配 dsh-context 一起用，查看模型这一轮实际收到的提示词、工具和 skill 到底长什么样。

它解决什么

你可能遇到过的问题	平台的默认行为	装上之后
系统提示词越堆越长，关不掉也用不上	预设里注册了哪些段就投递哪些段	按 agent 编一份白名单，名单外的段不进上下文
工具越装越多，同类工具一大堆，模型挑不准	工具面按已装的插件全量下发	挑出这个 agent 要用的，其余收起来
技能多了不好管	所有 modelInvocable 的 skill 都进目录	勾哪些就给哪些，不勾的模型看不见
每个 step 都塞一段运行时快照	官方按 step 动态注入，没有开关	代理级开关，关掉就不用再收
子代理只能整套继承主代理，占用大量上下文	官方 subagent 既没有条目标识，也没法按角色裁剪	每个子代理独立配：模型 / 提示词 / 工具 / 技能 / 后台模式
PTC 模式下创建的子代理也是 PTC	官方默认继承主代理的模式	子代理走原生还是 PTC，你说了算
干不同的活想用不同的提示词、工具、Skill，切来切去很麻烦	预设只管提示词组合，工具和 skill 是全局一套，换个预设照旧全量下发	给预设挂的 Agent 一切换即可
本地部署模型上下文紧张，根本对话不了几轮	做不到提示词全清，只能创造模式自己建一个	创建一个什么都不挂的Agent，给预设绑上就行，真 · 0提示词
主模型限流了 / 挂了，整轮直接失败	只在一个 provider 里重试到上限，然后放弃	配一条备用候选链（可跨供应商），失败按顺序顶上

安装

按你手头的条件挑一条：有网络就用 npm，内网或离线用 GitHub Release 的安装包，想改代码就走源码。

从 npm

dsh plugin --profile web add dsh-agent-studio

从 GitHub Release 下载

到 Releases 下载 dsh-agent-studio-<版本>.tgz，它就是 npm 上那份包，lib/ 与 client/ 的构建产物都在里面，不用自己构建：

dsh plugin --profile web add "./dsh-agent-studio-0.1.4.tgz"

包放在哪个目录都行，把路径写对即可（./ 开头或绝对路径），文件名里的版本号换成你实际下载的那个。离线、内网环境走这条。

从源码

git clone https://github.com/thissensen/dsh-agent-studio.git dsh-agent-studio
cd dsh-agent-studio

pnpm install                      # 只装 devDependencies；peer 是宿主包，不走 registry
node scripts/link-deps.mjs web    # 把宿主的 @deepseek-ai/* 链进本项目的 node_modules
dsh plugin --profile web add "link:<本目录的绝对路径>"

也可以把 Release 页的源码压缩包（Source code (zip)）解压出来代替 git clone，后续步骤一样。

三条路装完都重启一次 DSH，在 设置 → Agent 中心 看到面板就成了。

• link: 装法下改 lib/ 立即生效；改面板（client/parts/panel.js）刷新页面就行，不用重启。
• 改 package.json 的入口类字段（main / exports / dsh.*）后必须重启。
• --profile 填 web（纯 Web 版）或 desktop（桌面版）。桌面版就是 Web 版加一层 Electron 壳，host 半边一行不用改。

卸载

dsh plugin --profile web remove dsh-agent-studio

卸载后宿主配置里不留任何痕迹。预设从没被改过，其余配置都在插件自己的数据里。

面板预览

界面有浅色、深色两套：

…