alanzhao0128/dsh-desktop

README 摘要

dsh-desktop — DeepSeek Harness 桌面壳 一个极薄的 Electron 壳：打开后自动执行 npx @deepseek-ai/dsh web ，然后用窗口内嵌的 Chromium 内核加载 http://127.0.0.1:3080 。 完全不修改 dsh 本身的任何东西 ——dsh 仍然以原生命令 npx @deepseek-ai/dsh web 运行，只是多了一个原生窗口。 特性 - 每次启动都从 npx 拉取最新版本 ：内部执行 npx --yes --prefer-online @deepseek-ai/dsh web （ --yes 避免交互卡住， --prefer-online 强制每次联网校验 registry，取最新发布版；核心命令就是 npx @deepseek-ai/dsh web 不变）。 - 智能复用 ：如果 3080 端口已经有 dsh web 在跑（比如浏览器里已经开着一个），壳直接复用，不会重复启动；只有端口空闲时才自己拉起一个。 - macOS 惯例的窗口行为 ：点窗口的 ✕ 只关窗口，app 进程和 dsh web 服务都继续运行（Dock 里还在，点图标重新开窗会直接复用仍在跑的服务）； Cmd+Q （或菜单退出）才真正退出 app，并只杀掉 自己拉起 的 dsh 进程树；复用的外部实例保持不动。Windows/Linux 上保持"关窗口即退出"的惯例。 - 启动过程可见 ：npx 首次下载可能较慢，窗口内显示进度；失败时显示原因和日志路径，可一键重试。 - 日志 ：写到 /Library/Application Support/dsh-desktop/logs/ （shell.log + dsh.log），帮助菜单可直接打开日志目录。 - 外链走系统浏览器 ：窗口内只允许访问本机 dsh 服务，其他链接交给默认浏览器。 运行（开发模式） 打包为 macOS App 未签名的本地构建首次打开若被 Gatekeeper 拦截，执行： 配置 环境变量 作用 默认 DSH DESKTOP PORT 壳探测/加载/启动 dsh 用的端口 3080 DSH NPM CACHE 透传给 npx 的 npm 缓存目录（一般不需要） 无（用 npm 默认缓存） 例： DSH DESKTOP PORT=3090 npm start 会用 --port 3090 启动 dsh 并加载该端口。 项目结构 测试 smoke 会真实执行一次「npx 拉最新包 → 启动 dsh web → 探活就绪 → 关闭并确认端口释放」的完整链路（使用独立端口 3090 和独立的 DSH HOME ，不影响你的真实环境），并检查默认端口 3080 上已有实例的复用检测。 平台支持 当前面向 macOS 。结构上已为 Windows 预…

分类