dsh-shell

# dsh-shell **一个动作，把已经装好的 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) 装进桌面窗口** *零新环境 · 零核心改动 · 会话与设置原样继承* [](https://raw.githubusercontent.com/TaoSmile/dsh-shell/main/LICENSE) [](https://raw.githubusercontent.com/TaoSmile/dsh-shell/main/) [](https://raw.githubusercontent.com/TaoSmile/dsh-shell/main/) [](https://github.com/deepseek-ai/deepseek-harness) [](https://raw.githubusercontent.com/TaoSmile/dsh-shell/main/CONTRIBUTING.md) [English](https://github.com/TaoSmile/dsh-shell/blob/main/README.en.md) · [为什么需要它](#为什么需要它) · [快速开始](#快速开始) · [工作原理](#工作原理) · [常见问题](#常见问题)

为什么需要它

官方姿势是在终端里跑 dsh web 再开浏览器。对已经装好 harness 的你来说，只是想少两步：

它不是什么：不是仿制 UI、不是发行版、不打包运行时。窗口里 100% 是官方 Web GUI——壳的全部工作都在窗口之外。

快速开始

零安装版（推荐先试）：双击 启动Harness桌面.vbs（无黑窗，失败弹提示），完。

启动Harness桌面.vbs ──▶ 自动探测/拉起 harness ──▶ 独立桌面窗口（Edge app-mode）

• 习惯看控制台输出的可以双击 启动Harness桌面.cmd（行为相同，保留可见窗口）。
• 桌面快捷方式（带白鲸图标）：powershell -File launcher\start-shell-edge.ps1 -CreateDesktopShortcut，执行一次即可。
• 开机自启（可选，默认关闭）：双击 开机自启开关.vbs 一键切换——弹窗显示当前状态，确认后生效。命令行等价：-ToggleAutostart。
• Edge 版体验特性：原生启动动画（双击后立即弹出小窗：白鲸图标 + 流动进度条，harness 就绪后自动打开 GUI 窗口）、单实例复用（不会重复拉起）、首次启动屏幕居中显示（小屏自动收缩）+ 之后记住窗口位置、关闭窗口自动停掉由它拉起的 harness（附着模式绝不干预已有实例）。

完整版（托盘 / 状态窗 / 日志 / 重试）：

cd dsh-shell
npm install   # 已内置 npmmirror 镜像，解决 Electron 二进制下载失败
npm start     # 或双击 start-electron.cmd

工作原理

flowchart LR
    A[双击 启动Harness桌面.cmd] --> B{探测 http://127.0.0.1:3080<br/>响应含 __DSH_BOOT__ 才算就绪}
    B -->|已在运行| C[开窗附着<br/>不拥有生命周期，退出不影响]
    B -->|未运行| D[复用现有环境拉起<br/>node lib/bin.js web --port 0]
    D --> E[解析官方就绪行<br/>dsh web: http://127.0.0.1:port]
    E --> C
    C --> F[官方 Web GUI 原样呈现<br/>会话/设置共享 ~/.dsh]

两条铁律：

1. 就绪判定只认 harness 官方就绪行 dsh web: http://…，绝不把"HTTP 200"当就绪（防止白屏）。
2. 零注入：主窗口加载官方页面原样，壳的 preload 只注入自己的状态小窗。

两种模式对比

和其他桌面端有什么不同

社区已有一体化打包（如 anywhere-labs、xiincs 等）：它们内置 Node/依赖，给没装过 harness 的新用户开箱即用。dsh-shell 走另一条路：

预览

主窗口（官方 Web GUI 原样呈现）

配置

首次运行自动生成 %APPDATA%\dsh-shell\dsh-shell.json（Electron 版；默认值见 src/config.js）：

Roadmap

• [x] A0 附着 / A1 拉起 / Edge 零安装版 / Electron 壳 + 托盘
• [x] T1 体验：白鲸图标、原生启动动画、桌面快捷方式、无黑窗、单实例复用、窗口居中与记忆、关窗即停、开机自启可选开关
• [ ] electron-builder 打包：NSIS 安装包 + 便携版 + 图标
• [ ] 托盘显示运行中的 job / goal 状态
• [ ] dsh:// 深链
• [ ] 桌面通知（走 harness 官方插件体系，不进核心）
• [ ] macOS / Linux 适配

常见问题

• 会和我终端里跑的 dsh web 冲突吗？ 不会。壳先探测，命中就附着同一个实例，不会起第二份、不会抢写同一份配置。
• 数据在哪？ 沿用 ~/.dsh（或你设置的 DSH_HOME），与命令行共享同一份会话。
• 怎么停止壳拉起的实例？ Edge 版关闭窗口即自动停止（仅限它自己拉起的）；也可手动 .\launcher\start-shell-edge.ps1 -Stop。Electron 版退出即停。附着模式（A0）两者都不干预。
• 壳会联网下载东西吗？ 不会。唯一例外是首次 npm install electron（已内置 npmmirror 镜像）。

目录结构

dsh-shell/
├─ 启动Harness桌面.vbs          零安装双击启动（无黑窗，推荐）
├─ 启动Harness桌面.cmd         零安装双击启动（可见控制台输出）
├─ 开机自启开关.vbs             开机自启开关（可选，默认关闭）
├─ start-electron.cmd          Electron 版双击启动
├─ src/                        Electron 主进程
│  ├─ main.js                  窗口 / 托盘 / 菜单 / 生命周期
│  ├─ host-manager.js          壳↔harness 唯一桥：attach / spawn / 就绪解析 / 日志
│  ├─ config.js                配置读写
│  └─ preload.js               仅注入壳自己的状态小窗
├─ ui/
│  └─ status.html              Electron 版启动状态 / 错误 / 日志
├─ launcher/start-shell-edge.ps1   Edge 版核心逻辑（含原生启动动画）
├─ scripts/make-icon.ps1       图标生成器（白鲸图形，可改样式重新生成）
└─ assets/                     icon.png / icon.ico / tray.png

参与贡献

任何形式的 issue / PR 都欢迎，见 CONTRIBUTING.md。边界只有一条：不改 harness 核心（对上游的改动请直接提给 deepseek-ai/deepseek-harness）。

Star 历史

许可

MIT，与上游 deepseek-ai/deepseek-harness（MIT）保持一致。