dsh-cloud-handoff · 云接力
把本地 DeepSeek Harness 会话手动一键迁到你自己的一台 Linux 服务器上继续跑：合盖、关机、断网都不中断；回到本地点一下，云端成果经审阅后由子智能体合并落盘。
不提供服务器。你只需要一台自己的 Linux 机器（家里的 PVE 虚拟机、VPS、旧笔记本都行）和一条一键配置脚本。
本机 DSH ──打包会话+工作区+记忆──▶ SSH 直连你的服务器 ──▶ 云端 DSH 继续执行
▲ │
└──── 回传包（工作区 diff + 迁移前基线 + 云端会话尾部）◀────────┘
│
▼ 审阅卡 →「交给当前会话落盘」→ 子智能体消费回传包 → 写入本地工作区 → 确认清理
能做什么 / 不做什么
| ✅ 做 | ❌ 不做 |
|---|
| 手动点按钮迁移（当前轮停稳后打包） | 关盖/断电/崩溃等突发事件自动触发 |
| 会话历史 + 工作区 + 记忆文件一起带过去 | 往 GitHub 或任何远程仓库推送 |
| 云端完成后亮角标提示，不自动写本地文件 | 未审阅就静默覆盖你的工作区 |
云端成果以 .cloud-<jobId> 副本保留冲突 | 把云端会话事件拼进你当前会话（避免 seq 撞号） |
| 确认/丢弃后自动清理云端副本 | 常驻你的公网端口（云端只绑 127.0.0.1） |
快速开始（4 步）
1. 在你的服务器上跑一键配置脚本
# 先下载审阅，再执行（推荐）
curl -fsSL https://raw.githubusercontent.com/engty/dsh-cloud-handoff/main/scripts/install-cloud.sh -o install-cloud.sh
sudo bash install-cloud.sh --ssh-pubkey ~/.ssh/id_ed25519.pub
脚本会（幂等，可重复执行）：等待 cloud-init 初始化完成（避免 apt 撞锁）→ 装 Node 22 + dsh → 建 dshcloud 用户与目录 → 生成专属 Token 与随机端口 → 配 systemd 常驻 → 写 SSH 免密与重启授权 → 最后打印对接码。
脚本不会在你的服务器上安装任何代理/额外常驻软件；国内服务器加 --mirror cn 即可用国内源快速装依赖。
常用参数：
| 参数 | 说明 |
|---|
--ssh-pubkey <文件> | 写入你的公钥，插件免密通道必需 |
--ssh-pubkey-url <URL> | 从 URL 取公钥（如 https://github.com/<user>.keys） |
--key-file <文件> | DeepSeek API Key（读取后删除该文件） |
--repo <git地址> | 自动克隆插件 bundle 到服务器 |
--mirror cn | 国内服务器推荐：apt 换清华 TUNA 源 + npm 换 npmmirror（装依赖快且稳） |
--port <n> / --dsh-version <v> | 指定端口 / 锁定 dsh 版本 |
2. 复制脚本最后打印的「对接码」
DSHCP1:eyJob3N0IjoiMTkyLjE2OC4xLjQxIiwic3NoVXNlciI6...
3. 在本机 DSH 安装插件并粘贴对接码
# 二选一：命令行，或在 DSH 的插件管理界面安装/启用 dsh-cloud-handoff
dsh plugin --profile desktop add dsh-cloud-handoff
打开 设置 → 云接力 → 云端接入 → 粘贴对接码 → 「解析并接入」→「测试连通」。看到绿色「已接入」即可。
4. 用起来
在会话输入区点云朵图标 → 填一句任务说明（可选）→「发送」→ 本地当前轮停稳打包，云端继续跑。你随时可以合盖走人。
回来时云朵亮绿点 = 云端有结果待取回 → 点开看变更文件清单 → 「交给当前会话落盘」→ 子智能体读取回传包并把最终产物写进工作区（本地也改过的文件不覆盖，冲突另存 .cloud-<jobId>）→ 完成后点「确认完成·清理云端」。
清理策略
| 时机 | 清理内容 |
|---|
| 点「确认完成」/「丢弃」 | 云端立即删除：工作区副本、进出回传包、云端会话副本、任务记录；本地回传包与解包缓存同步删除 |
| 忘记确认 | 终态任务超 retentionDays（默认 7 天）由云端定时清扫（启动后 30 秒 + 每 12 小时） |
| 本地历史 | jobs.json 只保留最近 20 条任务记录 |
| 上下文 | 云端会话永不并入本地会话；子智能体只读有界摘要（单文件 ≤200KB、会话流默认 60 行），父会话只收最终汇报 |
安全与隐私
- 云端只监听
127.0.0.1，不需要开放任何公网端口；全部流量走你自己的 SSH 通道
- Token 仅存本地
~/.dsh/dsh-cloud-handoff/config.json（0600），不回显、不进日志、不上传
- 无遥测、无第三方服务器；插件永不接触 GitHub 或任何远程仓库
- 打包自动排除凭据与缓存：
.env*、*.pem、*.key、id_rsa*、.credentials.yaml、node_modules、.git、构建产物等
- 脚本可先下载审阅再执行；所有改动都在你的机器与服务器之间
兼容性
| 维度 | 支持范围 | 状态 |
|---|
| DSH | 双端同版本 0.2.0-rc.2（engines.dsh 声明） | 已验证 |
| Node | 本机 ≥22.15（依赖 node:zlib zstd）；服务器 22 LTS | 已验证 |
| 服务器 OS | 仅 Debian 12/13、Ubuntu 22.04/24.04；x86_64 / arm64（其它发行版不支持，脚本会直接提示退出） | Debian 12/13 + Ubuntu 24.04 实测 |
| 本机 OS | macOS / Linux；Windows（OpenSSH + tar） | macOS 已验证，Windows 实验性 |
| 本机依赖 | 只需系统自带 ssh、tar、bash（不需要 rsync/zstd） | 已验证 |
| 工作区 | git 仓库或任意目录（自动遍历 + 排除表），无需 GitHub | 已验证 |
| 网络 | 无需公网端口，云端只绑 127.0.0.1；DeepSeek API 直连 | 已验证 |
常见问题
Q：一定要有 GitHub 仓库吗？
不需要。插件从不推送任何远程仓库；工作区甚至不必是 git 仓库（非 git 目录走遍历模式打包）。
Q：云端会占多少空间？
一次任务 ≈ 工作区快照 + 回传包（通常几十 MB）。确认或丢弃后立即释放；忘记确认有 7 天保留期兜底。
Q：能同时跑多个云端任务吗？
v1 单任务串行。同一会话二次迁移会自动重启云端服务（可能打断该服务器上其他云端任务，见 docs/DESIGN.md 边界说明）。
Q：没有服务器怎么办？
任意一台能装 Linux 的机器都行：家里 PVE/群晖虚拟机、VPS、甚至 WSL。2 核 4G 即可。
Q：脚本会动我的系统吗？
只做四件事：换源（可选，会备份原 sources.list）、装 Node+dsh、建 dshcloud 用户与 /srv/dsh-cloud 目录、注册一个 systemd 服务。不装代理，不改动其他服务，可重复执行。
文档
开发
git clone https://github.com/engty/dsh-cloud-handoff
cd dsh-cloud-handoff
node --test test/ # 单测：会话帧迁移、状态机、工作区扫描
dsh plugin --profile desktop install . # 本地联调
发布说明
版本由 GitHub Actions 通过 npm Trusted Publishing（OIDC）发布，附 provenance 签名——可用 npm audit signatures 验证包确实由本仓库构建；维护者流程见 docs/PUBLISHING.md。
License
MIT © 2026 engty
