桌面工作台 Caxson/dsh-gui

Dsh GUI

一个面向 DeepSeek Harness (DSH) 的 Codex 风格桌面应用——优先支持 macOS（Apple Silicon + Intel，已签名并公证），同时提供 Windows 构建版本。

DSH 引擎是内核；本应用是其上的插件层——不 fork，不修改引擎。官方 @deepseek-ai/dsh 包按原样打包，并以无头方式启动（dsh web，仅回环地址，随机端口）；桌面行为通过 DSH 自身的插件/补丁系统注入。

一个 Codex 风格的 macOS 桌面客户端，内核是官方 DeepSeek Harness (DSH)。
不重新发明引擎——App 只是 DSH 之上的「插件层」。

特性 / Features

- 🖥️ 原生 macOS 窗口，深色 Codex 风格；完整 DSH 能力（多会话、工具调用、工作区、Goal、子代理）
- 📋 Codex 式右侧面板（Cmd+B 呼出，默认隐藏；浏览器式多标签，可新建/关闭/弹出为独立窗口）：
- 终端 — 与 agent 共享同一个 PTY（agent 跑的每条命令实时可见），可再开多个本地终端标签（⌘T）
- 改动 — 改动按文件聚合成卡片，真·逐行 diff（LCS + 上下文折叠）、+N/−N 统计、展开/收起（⌘P）
- 文件树 — 工作区目录树，按需逐层展开，生成目录默认折叠（⌘E）
- 浏览器 — agent 驱动的无头 Chromium 实时画面 + 搜索/抓取活动流（Chromium 不随包分发，首次打开该标签时按提示下载，优先走国内镜像；下载后随用户数据保留，不会被更新覆盖）
- 侧边聊天 — 临时轻量聊天（⌥⌘S），流式回复，关闭应用即消失，不打扰主会话
- 🔌 桌面行为全部以 DSH 插件（profile patch overlay）实现：bridge/（活动采集 + 共享 PTY + terminal_send 工具）、browser/（实时浏览器）
- 🔒 引擎只绑定 127.0.0.1，外部链接自动走系统浏览器
- 🔄 自动更新默认走国内 CDN 镜像（大陆下载更快更稳）；DSH_GUI_UPDATE_URL=github 可切回 GitHub Releases，或填任意自建镜像地址

安装 / Install

macOS 提供 Apple Silicon (arm64) 与 Intel (x64) 两个版本，请按芯片选择； Windows 提供安装版与免安装版（x64）。
macOS 提供 Apple Silicon (arm64) 与 Intel (x64) 版本；Windows 提供安装版与免安装版（x64）。

Windows 版尚未经过真机验证，也未做代码签名——首次运行 SmartScreen 会提示，点「更多信息 → 仍要运行」即可。欢迎反馈问题。
Windows 构建版尚未在真机上验证，且未签名； SmartScreen 会在首次运行时警告——选择「更多信息 → 仍要运行」。

1. 从下载页（自动识别系统与芯片，其他平台的包也在同一处列出）或 Releases 下载对应的 Dsh-GUI--arm64.dmg / Dsh-GUI--x64.dmg； Windows 为 Dsh-GUI-Setup--x64.exe（安装版）或 Dsh-GUI-Portable--x64.exe（免安装版）
2. 双击打开，把 Dsh GUI 拖进「应用程序」
3. 首次打开：Gatekeeper 会弹一次确认框，点「打开」即可（见下方说明）
4. 打开后进入 设置 → 模型 填入 DeepSeek（或任意 OpenAI 兼容）API Key，开聊

数据目录：机器上已有 ~/.dsh（用过 dsh CLI / dsh web）时直接复用它——会话、模型、插件与命令行侧完全同步；没有才使用 ~/Library/Application Support/Dsh GUI/dsh-home。DSH_GUI_HOME 环境变量可覆盖。

首次打开被 Gatekeeper 拦住了？

签名与公证已接入发布流程：仓库配置了 Developer ID 证书与公证凭证时， CI 产出的就是已签名并公证的包，首次打开只会弹一次「来自互联网的 App」确认框，点「打开」即可。

如果你下载到的是未签名的构建（凭证缺失时 CI 会降级产出），macOS 会把它统一报成「已损坏，无法打开」——这不是文件真的损坏，执行一次即可：

xattr -cr "/Applications/Dsh GUI.app"

签名与公证已接入发布流程：当签名凭证存在时，CI 会产出已签名并公证的构建，macOS 只会显示一次性的「应用从互联网下载」提示。如果你拿到的是未签名的构建（凭证缺失时 CI 会降级为未签名）， Gatekeeper 会将其报告为“已损坏”——上面的一次性 xattr -cr 会清除隔离标记。

开发 / Development

npm install # postinstall 会 vendor 面板依赖
npm start # 开发运行
npm run smoke # 端到端冒烟：引擎启动 + 面板 PTY + 布局探针
npm run dist # 构建 dmg + zip（发版产物）
npm run dist:unsigned # 无证书时的本地构建

架构速览：

src/main.js Electron 主进程：引擎拉起、窗口/面板布局、更新 src/panel/ 右侧面板（终端 xterm / 文件 diff / 浏览器） bridge/ DSH 插件：活动采集、共享 PTY、terminal_send 工具 browser/ DSH 插件：agent 可驱动的无头 Chromium + 画面流 plugins/desktop.patch.yml 挂到 web profile 的 loader patch 覆盖层

发版 / Release

package.json 改版本号 → 打 vX.Y.Z tag 推送到 GitHub，Actions 云构建自动发版：依赖闭包 + 文档一致性校验 → macOS dmg + zip（arm64 与 x64 各自在对应架构的 runner 上构建）与 Windows 安装版 + 免安装版 → Apple Developer ID 签名 + 公证（仅 macOS）→ 挂到 GitHub Releases 并同步 OSS 镜像，老用户自动更新；大陆用户可用 DSH_GUI_UPDATE_URL 指向镜像源。
未配置签名 secrets 时（如 fork），构建自动退回未签名版——功能不受影响，只是首次打开需右键 →「打开」。
Releases 在 GitHub Actions 上构建，使用 Developer ID 签名 + 公证；如果没有签名 secrets，工作流会自动回退到未签名产物。

License

MIT © Caxson. DSH engine © DeepSeek — 见官方 deepseek-harness 仓库。