网页版启动器Hyggetxc/dsh-web-launcher

DeepSeek Harness Web 启动器

一个轻量级的 macOS 和 Windows 启动器，用于官方 DeepSeek Harness Web UI。

dsh-web-launcher 启动并管理官方 dsh web 服务，然后在 http://127.0.0.1:3080 打开本地 Web UI。它刻意保持精简：没有 Electron 外壳，没有捆绑的 DeepSeek Harness 运行时，没有修改上游文件，也没有模型/API 密钥管理。

独立社区项目。与 DeepSeek AI 无关联，未获其认可或赞助。

为什么需要它

DeepSeek Harness 正在快速演进。重量级的桌面封装可能会落后于上游变更，因为它们捆绑运行时文件、修改 UI 或在内部管理版本。

此启动器使更新路径贴近官方命令：

npx --yes @deepseek-ai/dsh web

如果你已经安装了全局 dsh 命令，服务将使用：

dsh web

功能特性

- 一键式 macOS 应用，用于打开 DeepSeek Harness Web。
- 一键式 Windows .cmd 启动器，用于启动 DeepSeek Harness Web。
- 用户级 macOS LaunchAgent，用于后台服务管理。
- Windows 后台 PowerShell 运行器，附带停止脚本。
- 启动官方 dsh web 命令，不修改 DeepSeek Harness。
- 服务就绪后打开 http://127.0.0.1:3080。
- 兼容 macOS nvm Node.js 环境。
- 可用时使用 dsh，否则回退到 npx --yes @deepseek-ai/dsh web。
- 将日志保存在可预测的本地文件夹中。
- 提供简便的停止/卸载脚本。

关键词

DeepSeek Harness 启动器、DSH 启动器、dsh web 启动器、DeepSeek Harness 桌面启动器、macOS LaunchAgent、Windows 启动器、PowerShell 启动器、本地 AI 代理、npx @deepseek-ai/dsh web、127.0.0.1:3080、轻量级 DeepSeek Harness 桌面、无 Electron 封装。

系统要求

- macOS 或 Windows
- 带 npx 的 Node.js，或全局 dsh 命令
- 首次运行 npx 时需要互联网访问

安装

下载

使用特定平台的发布包：

- macOS：dsh-web-launcher-macos-v0.2.0.zip
- Windows：dsh-web-launcher-windows-v0.2.0.zip

源代码仓库包含两个平台，但为方便起见，发布下载按操作系统拆分。

macOS

1. 下载或克隆此仓库。
2. 双击：

scripts/install-service.command

3. 等待首次启动。首次 npx 运行可能需要几分钟。
4. 双击：

DeepSeek Harness.app

Windows

1. 下载或克隆此仓库。
2. 双击：

windows\Start DeepSeek Harness Web.cmd

3. 等待首次启动。首次 npx 运行可能需要几分钟。

启动器会打开：

http://127.0.0.1:3080

日常使用

在 macOS 上，双击 DeepSeek Harness.app。

在 Windows 上，双击 windows\Start DeepSeek Harness Web.cmd。

启动器会检查 DeepSeek Harness Web 是否已经可以访问。如果不可访问，它会启动本地服务，并在打开浏览器之前等待 Web UI 就绪。

日志
服务日志写入位置：

macOS：

~/Library/Application Support/DeepSeek Harness Web/logs/dsh-web.log

LaunchAgent 的 stdout/stderr 日志写入位置：

~/Library/Application Support/DeepSeek Harness Web/logs/launchd.out.log
~/Library/Application Support/DeepSeek Harness Web/logs/launchd.err.log

Windows：

%LOCALAPPDATA%\DeepSeek Harness Web\logs\dsh-web.log

卸载

macOS：

双击：

scripts/uninstall-service.command

这会移除 macOS LaunchAgent。它不会删除日志或本地支持文件。

如需手动删除日志，请删除：

~/Library/Application Support/DeepSeek Harness Web

Windows：

双击：

windows\Stop DeepSeek Harness Web.cmd

然后，如果你不再需要该文件夹，请将其删除。

本项目不做什么

- 不打包 DeepSeek Harness。
- 不修改 DeepSeek Harness 源代码。
- 不管理模型提供商、API 密钥、会话、工作区、插件或技能。
- 不将本地服务暴露到局域网。
- 不替代官方 DeepSeek Harness CLI。

工作原理

flowchart LR
A["Launcher app or .cmd"] --> B["Check http://127.0.0.1:3080"]
B -->|ready| C["Open browser"]
B -->|not ready| D["Start local service"]
D --> E["dsh web or npx --yes @deepseek-ai/dsh web"]
E --> F["DeepSeek Harness Web UI"]
F --> C

故障排除

浏览器打开了，但显示连接被拒绝

本地服务尚未就绪。请检查：

macOS：

~/Library/Application Support/DeepSeek Harness Web/logs/dsh-web.log

Windows：

%LOCALAPPDATA%\DeepSeek Harness Web\logs\dsh-web.log

查找类似以下的一行：

dsh web: http://127.0.0.1:3080

首次启动看起来很慢

首次运行 npx --yes @deepseek-ai/dsh web 时，可能会下载并准备官方包。根据网络和 npm 缓存状态，这可能需要几分钟。

Node.js 通过 nvm 安装，但 macOS 服务找不到 npx

服务脚本会加载：

~/.nvm/nvm.sh

它还会扫描：

~/.nvm/versions/node/*/bin

如果仍然失败，请打开日志文件并确认 npx 是否出现在 PATH 中。

中文说明

这是一个轻量级 macOS / Windows 启动器，用来启动官方 DeepSeek Harness Web UI。

它不会打包 DeepSeek Harness，也不会修改官方源码；只是用本机后台脚本运行官方命令：

npx --yes @deepseek-ai/dsh web

如果本机已有全局 dsh 命令，则优先运行：

dsh web

macOS 版使用用户级 LaunchAgent；Windows 版使用可双击的 .cmd 和 PowerShell 后台脚本。适合只想“点一下打开 DeepSeek Harness”，但不想使用完整桌面壳或固定内置版本的用户。

相关链接

- 官方 DeepSeek Harness 仓库：
- 官方启动命令：npx @deepseek-ai/dsh web

许可证

MIT

DeepSeek、DeepSeek Harness 及相关标识归其各自所有者所有。