ningbonb/dsh-installer

dsh-installer

面向不熟悉命令行的用户的 DeepSeek Harness（dsh）一键入口脚本。

每个脚本在 dsh 已安装时直接启动 Web UI；未安装时则先在交互式终端中引导用户完成配置——Node.js、pnpm、dsh 命令行以及可选的插件组合包——首先选择语言（默认中文）。

文件

| 文件 | 平台 | 用途 |
|---|---|---|
| dsh.command | macOS（Linux 下也可用 bash 运行） | 二合一入口——直接启动，缺 dsh 时先安装 |
| dsh.bat | Windows | 二合一入口——直接启动，缺 dsh 时先安装 |

用法

macOS

1. 双击 dsh.command。
- 首次运行可能被 Gatekeeper 拦截：右键 → 打开，或先执行 chmod +x dsh.command。
2. 若缺少或损坏 dsh，脚本会先选择语言（默认中文）并引导安装。
3. 之后自动启动 Web UI（http://127.0.0.1:3080）。

Windows

1. 双击 dsh.bat。
2. 若缺少 dsh，脚本会先选择语言（默认中文）并安装；缺少 Node.js 时通过 winget 安装（可能需要关闭窗口重新运行一次，让新的 PATH 生效）。
3. 之后自动启动 Web UI。

脚本做了什么

1. 快速路径——dsh 在 PATH 上且通过冒烟检测时，直接运行 dsh web。
2. 语言选择——默认中文，可选英文。
3. Node.js 检查——需要 22.19+ 或 24+；缺失或过旧时通过 Homebrew（macOS）/ winget（Windows）自动安装。
4. npm 全局目录——macOS 上全局目录不可写时，提供免密码的用户级前缀（~/.npm-global），而不是直接要求 sudo。
5. pnpm——全局安装（dsh plugin add 会调用 pnpm）。
6. @deepseek-ai/dsh——全局安装，提供 dsh 命令。
7. 可选插件——循环输入包名（npm 包名、tarball 路径或 github: 地址），安装进 web profile；留空结束。

自更新

两个脚本都会检查本安装器的更新并自我升级：

- 绝不阻塞启动。 后台检查（每天最多一次，带短超时）把 GitHub 最新 release 的 tag 写入 ~/.dsh-installer/update_state（Windows 为 %USERPROFILE%\.dsh-installer\update_state），然后自行结束。
- 下次运行再提示。 启动时脚本读取该缓存状态；若有新版本，显示 3–5 秒提示（默认「否」，无人值守时不会被卡住）。
- 安全应用。 选「是」时下载新脚本到 dsh.command.new / dsh.bat.new；下一次运行会先校验再在最开头换入该文件并重新执行。下载失败或文件无效时会清理临时文件，正在运行的旧脚本从不在执行中途被覆盖。
- 不反复打扰。 选「否」会把该版本记为已提示，直到出现更新的版本才再次提醒。

发布

每次发布需保持两处一致，自更新才能比对版本：

1. 同时更新 dsh.command 与 dsh.bat 顶部的 DSH_INSTALLER_VERSION。
2. 打 v 的 tag（如 v0.1.1）并作为 GitHub release 发布——检测读取的是 releases/latest。

示例：

gh release create v0.1.1 --title v0.1.1 --notes "..."

许可证

MIT