dsh-fleet

Readme

# dsh-fleet · Harness Fleet

> **Punica Studio** 出品
>
> 一台电脑,同时管着好几台 DeepSeek Harness?装这个,不用再开一堆浏览器标签页了。

## 这个插件是做什么的?

一句话:**让一个"本地 dsh",在一个页面里方便地管理和使用多台"远程开发端 dsh"。**

如果你有好几台机器/开发环境都在跑 DeepSeek Harness(办公室一台、家里一台、
服务器一台……),以前要这样:

- 想看哪台忙不忙 → 挨个开标签页;
- 想操作远程那台 → 切到它的网页去打字、去点;
- 想在 A 机续聊 B 机上开过的会话 → 麻烦。

装了 **dsh-fleet** 之后,只要在**本地这一台**上打开页面:

- **右侧常驻一个设备栏**,一眼看到每台远程 dsh 是**空闲 / 运行中 / 刚完成**(忙闲一目了然,Deep Diving 也不会被误判成"完成了");
- **点一下卡片,原地切换**到那台远程 dsh 去继续使用——不用另开标签页、不用来回切浏览器;
- 切换过的远程会"保持在线",再切回去**秒开**,就像浏览器里开着的标签页;
- 还能跨设备**读取别台机器上的历史会话记录**,旧会话原地续聊,不用重新开始;
- 远程卡上一键**刷新 / 重启**那台 dsh,装好证书后连"不安全"提示都不用管。

> 你可以把它理解成:**DeepSeek Harness 的"多机指挥台"**,或者更直白一点——
> 一个不用切浏览器标签页的"远程 dsh 管理器"。

---

## 快速开始(30 秒)

### 1. 安装(在你想当"指挥台"的那台机器上)

```sh
dsh plugin --profile web add github:loveXbanshee/dsh-fleet
```

重启一次 `dsh web`,然后打开:**设置 → Harness Fleet**。

> 也可以去 **dsh-market**(插件市场)里搜 `dsh-fleet` 一键安装。

### 2. 在远程机上做一次"开门"动作

每台**你想管理的远程 dsh**,需要让这台指挥台能连上它:

1. 在那台远程机器上,也装上同一个插件(同上一条命令);
2. 打开它的 **设置 → Harness Fleet**,在「允许其他设备读取本机会话」里设置一个**共享令牌**(随便一个长字符串,两台填一样的即可);
3. 建议顺手在「本机角色」里把它设为 **被控端**(这样它自己不会弹右侧栏,专心当"被管的那台")。

### 3. 回到指挥台,添加远程

本地 Harness Fleet → 「远程 Harness」→ 填远程机的地址
(`http://<那台机的IP>:<端口>` 或 https 域名)+ 同一个令牌 → 添加并探测。

完成。右侧设备栏会出现那台远程,接下来点卡片就能看它忙不忙、切过去操作它。

---

## 界面长什么样、怎么用

| 你想做什么 | 怎么做 |
|---|---|
| 看某台远程忙不忙 | 右侧设备栏卡片:绿点=空闲,转圈=运行中,✓=刚完成 |
| 切到某台远程去操作 | 点它的卡片 → 整个页面变成那台 dsh,直接打字用 |
| 切回本地/别的远程 | 再点对应卡片,秒切,无需重新加载 |
| 远程卡住/重启过,想刷新 | 点卡片上的 **⟳ 刷新**(全屏看远程时右上角也有浮动刷新按钮) |
| 远程 dsh 想重启 | 点卡片上的 **重启**(需要已配置令牌;0.13.8+ 支持跨平台) |
| 读另一台机器上的旧会话 | 设置页远程卡 →「会话」→ 列出/展开/复制 Markdown |
| 远程是自签 https 打不开 | 远程卡 →「证书」→ 按提示下载安装受信任证书即可 |

**角色分工(可选但推荐)**:
- **控制端(指挥台)**:显示右侧设备栏,负责添加/查看/操作所有远程;
- **被控端**:不显示右侧栏,只对外提供会话与重启接口,安安静静当"被管的那台"。
  (在各自设置的「本机角色」里切换)

---

## 已实现能力(给喜欢看清单的人)

- 一个页面管理**本地 + 多台远程** dsh;本机只列**运行中**的实例
- 远程**忙闲实时状态**(`agent/status` 权威判定,Deep Diving 不会误报完成)
- 卡片**即点即切 + 保持在线**,秒开不用重新加载
- 跨设备**读取历史会话**(token 门控,zstd 日志自动解码,可复制 Markdown)
- 远程卡**一键刷新 / 一键重启**(0.13.8+ 跨平台)
- **控制端 / 被控端**角色;被控端无右侧栏
- **证书助手**:抓 TLS 链、给指纹、下载 .crt、分平台安装指引
- **Fleet 网关**:不绑 IP 也能局域网直读会话(可选)
- 完成提示音(音量可调)、dock 宽度可拖(自动记忆)

---

## 安全模型(简短版)

- 令牌只存宿主配置、浏览器不接触;读会话与重启都必须带正确令牌;
- 改设置/重启等"动东西"的接口只接受**本机同源**请求;
- 装证书/给权限这类系统级动作,插件只提供指引,**必须由你本人在系统里确认**。

---

## 发布 / 更新 / 贡献

- 发新版与写 Release Notes:[RELEASING.md](RELEASING.md)
- 安装帮助 / 跨设备设置细节 / API 表 / 配置示例:[README(完整版)](README.full.md)(或见仓库内文档)

> 曾用名 `dsh-harness-workbench` · License: MIT