安装

环境要求

• DSH（DeepSeek Harness）：纯 Web 版（dsh --profile web）跑得最好；桌面版是 Web 版加一层 Electron 壳，host 半边同一套代码，但桌面版当前自带的平台版本达不到本插件的要求（见下一条）。
• 版本：需要 DSH 0.2.1-alpha.2 及以上（engines.dsh 与 peerDependencies 里的平台包同串写 >=0.2.1-alpha.2）。这个下界写的是全功能最低版本：派活（studio_list_subagents / studio_delegate）走平台的 subagents.startActivation()，而这个入口 0.2.1-alpha.2 才有（同一步删掉了旧的 start / startContinuable）。早先 0.1.7-rc.1 那条下界来自预设改成「插件声明的列表」时新增的 @deepseek-ai/dsh-agent-preset-registry，现在被派活这条线顶掉了。
• 装在达不到下界的平台上会怎样：启动门禁整份跳过这个 bundle（日志里是 skipping profile bundle "dsh-agent-studio"），插件市场也会拦住这次更新——没有「装了半残」的中间态。社区桌面版自带 0.2.0-rc.2，正好在门外：想在它上面用，就装旧版 dsh-agent-studio@0.1.5（走旧 API，面板与派活都正常）。
• 本插件不挑操作系统，Windows / macOS / Linux 都能用。

三条安装路线

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

从 npm 安装

按你用的 profile 选一条：

Web 版

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

桌面版

# 桌面版自带平台 0.2.0-rc.2，装不了 0.1.7 及以后的新版 —— 装旧版：
dsh plugin --profile desktop add dsh-agent-studio@0.1.5

从 GitHub Release 安装

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

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

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

从源码安装

适合想改代码的人。先取源码：

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

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

再装依赖并挂载：

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

• link: 装法下改 lib/ 立即生效；改面板（client/parts/panel.js）刷新页面就行，不用重启。
• 改 package.json 的入口类字段（main / exports / dsh.*）后必须重启。

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

更新

• npm 装法：重新执行一次安装命令（dsh plugin --profile <profile> add dsh-agent-studio），或在你的 profile 里用惯用的更新方式。
• Release 装法：下载新版本的 .tgz，再 add 一次即可覆盖。
• 源码装法：git pull 后重新 pnpm build。

卸载

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

卸载即恢复原状。所有配置存在插件自己的数据里，宿主既有的预设定义一个都不改；移除后平台预设的装配回到从没装过的样子。