dsh-remote-dsh
DeepSeek Harness 插件：一个侧边栏标签页，可接管整个页面，显示另一个 DSH 实例的 Web GUI，并在侧边栏行上显示远程会话状态徽章。在侧边栏顶部添加一个「远程」标签，整页切换到另一台主机上的 DSH。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:hutao562/dsh-remote-dsh#1891eb56dfa84a0527fd5e64fdd114be87ad3284Remote Dsh 以 dsh-remote-dsh 发布，当前版本为 0.1.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
正在加载相关插件…
A DeepSeek Harness (DSH) plugin. It adds a 「远程」 row at the top of the sidebar; clicking it turns the whole page into another host's DSH Web GUI. The row also carries a session-state dot for that remote — blue while it is running something, green when activity arrived since you last looked.
┌────────────┬──────────────────────────────────┐
│ DSH │ │
│ 🌐 远程 ●1 │ │
│ ＋ 新会话 │ 另一台主机上的 DSH │
│ 会话列表… │ (整个页面都是它) │
└────────────┴──────────────────────────────────┘
dsh plugin --profile web add dsh-remote-dsh
然后重启一次 DSH。 想跟 main 分支的话,换成 github:hutao562/dsh-remote-dsh 也一样。
dsh web(它会打印带 ?token= 的 URL)。ssh -L 3081:127.0.0.1:3080 you@remote-host
http://127.0.0.1:3081。dsh web 打印的 token 粘进去 →「配对」。之后只要 cookie 没过期(默认 30 天)就直接进。cookie 能扛远程重启;但 token 是每进程生成的,重新配对要用当前这次的。
远程 DSH 的会话 cookie 是 HttpOnly; SameSite=Strict,跨 site 的 iframe 连它的 index.html 都取不到,直接 401:
| 远程在浏览器里的地址 | 结果 |
|---|---|
http://127.0.0.1:<端口>(ssh -L,或 frpc stcp / xtcp + visitor) | ✅ 可用 |
https://remote.example.com(frps http/tcp 公网域名) | ❌ 401 |
http://100.x.y.z:3080(Tailscale IP 直连) | ❌ 403 + 401 |
即使用 FRP,也要用 stcp/xtcp + frpc visitor 模式映射成本地回环端口。 这样被控端一行配置都不用改。
原因、推论,以及确实需要公网域名时的做法 → docs/why-loopback.md
| 颜色 | 含义 | 何时消失 |
|---|---|---|
| 琥珀 | 远端有会话卡在等你回答(批准 / 提问 / 计划评审) | 在那边答完 |
| 蓝 | 远端正跑着东西(含子代理) | 跑完 |
| 绿 | 自你上次打开远程视图之后,有会话跑完了一轮 | 打开远程即清零 |
| 红 | 读不到(该远端没装 peer) | 恢复后 |
配色和形状都取自远端侧边栏自己那套状态点 —— 蓝色就是会话列表里那个 8 格追逐动画,不是另画一个圆点。
展开时,状态是行最右端的计数胶囊(点 + 数字),和会话行的时间戳在同一条竖线上;侧边栏收起成 rail 时没有文字的位置,点就挂在图标右上角,计数留给 tooltip。
琥珀是唯一一个"看一眼不会消失"的状态 —— 它是阻塞,不是通知。点进远程视图就能看到那边弹出的批准框或提问,答完即灭。
绿点按会话计数:一个会话即便既被提示过、又刚跑完,也只算一个。
要让状态点工作,被控端也要装本插件并以 peer 角色运行。它只发布匿名计数(没有会话 id、标题或内容),而且不需要任何凭据 —— 这是它相比"本地保存 token"的关键优势。
角色配置、为什么不比时钟、以及唯一一处围栏放宽的范围 → docs/peer-status-badge.md
被远程访问的机器很容易被 DSH 判定成"本机工作站",于是几处面向它自己桌面的功能会打开:文件夹对话框弹在它的屏幕上、Open In 在它那边启动程序、每次启动在它桌面弹一个浏览器……这些都得在被控端关掉,否则你只会对着白屏和 401 猜。
一份可直接抄的清单(五组配置,附原因和验证方法)→ docs/remote-host-setup.md
lib/index.js | Node 半面:主机注册表、/api/remote-dsh 路由、回环围栏、存活探测 |
lib/client.js | 浏览器半面:手写 __ModuleLoader__ bundle,注册三个官方 slot |
cordis.patch.yml | bundle 层插入行(走 dsh plugin add 时生效) |
docs/ | 上面链接的深度说明 |
.verify/host-pending.mjs | Node 半面自检:pending 的记账与归因 |
.verify/client-smoke.mjs | 浏览器半面冒烟测试 |
没有构建步骤 —— lib/ 就是源码,改完即生效。
npm install
npm test # 112 项断言
npm run test:host # 只跑 Node 半面:waterfall 记账、resolve / reject / 同步抛出、子代理归因
npm run test:client # 只跑浏览器半面:module loader 契约 + 真 React 渲染 + jsdom 真实点击
想在源码目录里改并让本机 DSH 立刻加载(首次插入即热加载,不需要重启)→ docs/implementation.md
pending,不会因此变红,但也不会有琥珀。lib/index.js 需要重启 DSH;lib/client.js 的改动刷新页面即可。其余取舍与实现细节 → docs/implementation.md