多端连接管理器 panzeyu2013/dsh-chamber

dsh-chamber（中文说明）

dsh（DeepSeek Harness）的桌面连接管理器：把本机与任意多台服务器的 dsh 实例收进一个原生窗口——本地打开即用，远程经 SSH 隧道或认证 Gateway 一键接入，全部来源共用同一条 dsh 原生侧边栏与官方前端。

macOS 版本采用 Swift/AppKit 原生壳：窗口、菜单、托盘、通知、Dock 角标、深链、文件对话框、隐藏/恢复与 Sparkle 应用内更新都在 Swift 侧实现；业务由随包分发的 Node sidecar 承载；页面 100% 复用 dsh 官方前端，不是浏览器套壳。

用户界面

dsh-chamber用户主界面

用户主界面——单窗口，dsh 原生侧边栏按来源列出（本地 + 远程）session/workspace，主区为活动实例的 dsh shell。

English: README.en-US.md · 开发文档 DEVELOPMENT.md · 设计入口 01-overview.md · 进度 STATUS.md

为什么是 dsh-chamber

- 远程是一等来源 —— 本地实例只是第一个来源：远程服务器经 SSH 隧道接入（应用自动建隧道并管理远端 systemd），公网/团队场景经认证 Gateway 接入；两者与本地实例在同一条 dsh 原生侧边栏里平等列出。
- 官方前端，不做第二套 UI —— 界面是 dsh 官方前端源码复用自建，每个实例保持原生外观与完整能力；壳未覆盖的插件行降级为「特性缺席」，绝不整 boot 崩溃。
- 连接管理是唯一职责 —— 控制面只做托管、反代与静态服务：桌面 loopback-only、公网 Gateway 默认认证；凭据只经 write-only 表单输入，不进入渲染层与日志；本机只以 0600 文件保存连接凭据（Gateway 凭据优先系统密钥链加密、不可用时明文兜底），且从不回填界面。

|能力|dsh-chamber|官方 Desktop|SSH/隧道型社区客户端|
|本机 dsh 自动托管|✅|✅|✅|
|远程实例 SSH 接入（隧道+远端 systemd）|✅|❌|多为同步或运维面板，而非接入远端实例|
|认证 Gateway（服务器端公网形态）|✅|❌|❌|
|多实例同窗（N-ctx）与统一侧边栏|✅|❌|部分|
|官方前端源码复用|✅|✅|部分为 WebUI 打包|

官方 Desktop 覆盖「只在本机用」的场景；需要本机+多台服务器统一管理，或把 dsh 以认证形态放到公网时，才需要连接管理器。

快速开始

1 · 下载安装

macOS 安装包见 GitHub Releases：

- macOS（Apple Silicon）：dsh-chamber-<version>-macos-arm64.dmg

当前为 0.4.x：stable 与 beta 通道独立，逐版本变化见 CHANGELOG.md。

2 · 启动应用

启动后本地 dsh 实例自动托管（web profile 自动启动/守护/健康检查，无需命令行），首屏即其完整 dsh 界面。

3 · 部署服务器端（连接远程之前）

要接入远程服务器上的 dsh，需先在服务器完成部署，桌面端才能连接。两种方式任选：

方式一：一键脚本安装 Gateway（推荐）

Gateway 在服务器上托管 dsh 实例，提供统一认证入口。一条命令启动交互式向导（选项均带说明与校验，q 退出，ESC 或 back 返回上一步）：

curl -fsSL -o install-gateway.sh \
https://raw.githubusercontent.com/panzeyu2013/dsh-chamber/main/scripts/install-gateway.sh
bash install-gateway.sh

脚本自动完成（默认仅本机访问、安装到 ~/.dsh-chamber、gateway 监听 30801、托管 dsh 监听 30800，均可修改）：

1. dsh 就绪 — 探测本机 dsh：受管版本直接复用，非受管版本询问是否接管，没有则自动安装
2. 下载 + 校验 — 从 GitHub Release 拉取安装包并做 sha256 校验
3. 安装 — 默认 local 安装；gateway 自管 dsh 版本，运行期可在 /chamber/runtime 切换
4. 凭据 — 双重输入 + 字符计数，写入 0600 权限的配置文件
5. 服务化 — systemd 单元（root 系统单元；非 root 默认 systemctl --user；无 systemd 自动前台运行）
6. 健康检查 — 轮询 /health 直至就绪

安装完成后：

- 日常管理：install-gateway.sh status|logs|restart|update|uninstall
- 公网接入：用 Nginx/Caddy 将 HTTPS 反代到 127.0.0.1:30801，见 docs/deploy/deploy-gateway.md
- 桌面接入：「设置 → 连接」添加 Gateway 来源（HTTP transport + 反代地址），按需配置共享 token / 登录密码

方式二：远程 dsh 实例 + systemd

不装 gateway 时，可用 systemd（系统或 user 单元，非 root 用户运行）持久化服务器上的 dsh 实例，桌面端经 SSH 隧道接入；完整配置与排障见 docs/deploy/remote-dsh-instance.md。

已有直连实例、想改用 Gateway？旧数据不会自动跟随；安装 Gateway 后按 deploy-gateway.md §3「从直连 dsh 迁移到 Gateway」 迁移一次即可。

4 · 添加远程主机

「设置 → 连接」按目标（dsh / gateway）× 传输（ssh / http）四组合接入：SSH 由应用自动建隧道并管理远端 systemd；HTTP(S) 由主进程直连（默认 HTTPS，显式 HTTP 常驻风险提示）。

功能特性

- macOS Swift 原生壳 — AppKit 窗口 + WKWebView；菜单/托盘/通知/角标/深链/文件对话框/隐藏恢复与应用内更新（Sparkle）均为原生实现；壳内不承载业务，页面 100% 复用官方前端
- 本地 dsh 一键托管 — 本地实例自动启动、就绪检测、守护/回收、健康状态与宿主日志；首屏即完整 dsh 界面
- 运行时版本管理（热重载） — 设置页按实例切换/升级/回滚运行时即时生效，插件更新无需重启桌面应用（本地与 gateway 均可）
- 远程实例 SSH 接入 — 添加主机后自动建立 SSH 隧道并管理远端 systemd 服务；支持密钥或密码认证
- 认证 Gateway 接入 — 部署 gateway 后将其作为 gateway 来源接入，共享 token / 登录密码按需配置，默认 HTTPS
- 统一侧边栏多来源导航 — 本地 + 远程各实例的 session/workspace 在同一 dsh 原生侧边栏按来源分组、平等列出（远程带颜色徽标）；单击打开、双击重命名
- 侧边栏折叠 / 拖拽 / 强调色 — 来源级折叠开关一键收拢该来源 workspace 列表；server 分组可拖拽排序（跨实例持久化）；来源/workspace 带柔和强调色条
- Git Worktree 生命周期 — 侧边栏按实例展示仓库拓扑并闭环创建 worktree → workspace → session；删除采用 Git-first 可重试事务：主工作树/locked/运行中目标硬阻断，dirty 目标须显式勾选「丢弃未提交更改」后才以 force 移除（分支与已提交内容保留），可选删除本地分支
- 多实例并行（N-ctx） — 一个窗口内多个 dsh shell 共存，随时切换活动实例
- open-in 打开注册表 — 会话头部统一打开面：本地来源在 Finder/文件管理器显示目录；本地或 SSH 远程来源可拉起 VS Code（本地 vscode://file/、远程 Remote-SSH）；支持 dsh-chamber:// 深链
- 桌面通知 — 会话完成 / 提问 / 审批时推送桌面通知，点击直达会话；设置「通知」分组可开关
- 桌面端更新 — stable 与 beta 配置和 feed 独立；静默检查，设置页「更新」展示，确认后下载、退出时安装（低打扰、无弹窗）
- 睡眠/后台常驻 — 关窗可隐藏到托盘继续运行（或退出并确认）；登录自启（macOS）；OS 唤醒即时重连；保持唤醒开关
- Chamber 设置页 — 设置壳固定入口：连接 / 通用；chamber 全局设置与各实例配置严格分离
- 后端版本容忍 — 实例后端 dsh 前端版本与 chamber 壳不同步时照常可用：壳未覆盖的额外插件行降级为「特性缺席」（绝不整 boot 崩溃）

常见问题

- pnpm run smoke 为什么打印 SKIP？ — 冒烟测试需要 dsh 安装；找不到时打印 SKIP 并以 0 退出，属正常而非失败。
- 我的凭据会被存到哪里？ — 两处，都在本机：① 实例自身的配置平面（本地 = 本机 dsh home，远程 = 远端 dsh home，由该实例的 dsh 管理）；② 桌面壳在 <userData> 下保存的连接凭据（Gateway 凭据优先系统密钥链加密、不可用时 0600 明文兜底；SSH 密码按用户决策为 0600 明文兜底），用于免重录重连。凭据只经 write-only 表单输入，从不回填界面，也不进入渲染层或日志；Gateway 安装向导写入的配置文件为 0600 权限。
- 它和官方 Desktop 有什么区别？ — 官方 Desktop 覆盖「只在本机用」的场景；dsh-chamber 的差异集中在远程与多机：SSH 接入远端实例、认证 Gateway、本地与远程同为窗口内一等来源。本地场景两者都开箱即用，按是否需要远程来选。
- 远程实例需要什么？ — dsh 目标需要可达的 API profile；gateway 目标需要已部署的 @dsh-chamber/gateway。两者均可经 SSH 隧道或显式 HTTP(S) 直连；远端无需单独装 web 前端，UI 复用本地前端并经同源反代。
- agent preset / profile 在各实例间怎么工作？ — 按实例权威：每个实例的 settings/credentials/llm/agentPreset 配置平面只在该实例一侧（本地 = 本机，远程 = 远端）。编辑远程预设须切到该来源 shell 的「设置 → Agent presets」页。
- 前端从哪来？ — dsh 官方前端源码复用自建；每个实例保持原生 UI。
- macOS 上弹了录屏权限框、设置里却找不到 dsh-chamber（或开关已开仍无法截图）？ — 打开「系统设置 → 隐私与安全性 → 录屏与系统录音」：列表里若有旧条目，先选中并用左下「−」删除，再用「+」把 /Applications/dsh-chamber.app 重新加入并打开开关，最后 ⌘Q 完全退出并重开 dsh-chamber（升级自旧版或换过 bundle id 的机器必须「删除旧条目 → 重新加入」一次；tccutil reset 只能清记录，建记录只能靠这一步）。

文档

|文档|用途|
|docs/DEVELOPMENT.md|开发文档：架构总览/环境搭建/构建打包/CI 发布/仓库结构|
|docs/deploy/deploy-gateway.md|Gateway 服务器端部署指南|
|docs/deploy/remote-dsh-instance.md|远程 dsh 实例的 systemd 持久化说明|
|CONTRIBUTING.md|贡献指南（测试/Commit/PR 契约）|
|AGENTS.md|开发约束（常驻仓库规则）|
|CHANGELOG.md|版本变更记录|
|docs/design/01-overview.md|设计入口：收拢原则、范围、移除映射|
|docs/progress/STATUS.md|完成状态、剩余偏差与验证记录|
|docs/README.en-US.md|English README|

相关项目

- deepseek-harness（dsh） — 被管理的宿主
- OpenChamber — dsh-chamber 的 N-ctx 设计灵感与命名来源，感谢启发！

社区

- DeepSeek Harness 官方 Discussions：dsh-chamber 介绍帖

贡献

见 CONTRIBUTING.md；开发约束见 AGENTS.md，环境与构建见 docs/DEVELOPMENT.md。

License

MIT — 见 LICENSE。