ANVIWA/dsh-launcher

DSH 启动器

用于本地 DeepSeek Harness（DSH）安装的非官方 Windows 启动器。本项目与 DeepSeek 无关联，也未获得其认可。

DSH 启动器是一个小型 Windows 11 桌面应用程序，用于配置并启动本地 DSH Web 服务。它将启动设置集中在一处，在就绪后打开本地 Web 界面，并可移交给单独安装的 Endfield 工作台可执行文件。

功能特性

- Windows 11 Avalonia 桌面界面。
- 配置 DeepSeek API 密钥、基础 URL、HTTP(S) 代理和本地 Web 端口。
- 使用 Windows DPAPI 为当前 Windows 用户加密 API 密钥。
- 启动 dsh web --no-open --port ，并可在健康检查轮询后打开浏览器。
- 复用已被占用的已配置端口，而不是启动第二个 Web 服务。
- 支持 Web 模式以及可选的 Endfield 桌面工作台移交。
- 将 DSH 的 stdout/stderr 流式输出到 UI 日志中，并在启动器退出时停止子进程。

系统要求

- Windows 11（或兼容的现代 Windows 安装）。
- .NET 10 SDK，用于从源代码构建。
- 可正常工作的本地 DeepSeek Harness 安装，包含 node_modules/.bin/dsh.cmd。
- 用于 Harness 请求的 DeepSeek 兼容 API 端点和 API 密钥。

本启动器不会为你安装 DSH、Node.js、pnpm、插件或模型。

快速开始

克隆此仓库并构建：

git clone https://github.com/ANVIWA/dsh-launcher.git
cd dsh-launcher
dotnet restore
dotnet run

在启动应用之前，使用以下任一环境变量将其指向你的本地 DSH 安装：

首选：精确的 dsh 命令路径
$env:DSH_BIN = 'D:\Project\DeepSeek_Harness\node_modules\.bin\dsh.cmd'

备选：DSH 仓库根目录；启动器会解析 node_modules/.bin/dsh.cmd
$env:DSH_WORKSPACE = 'D:\Project\DeepSeek_Harness'

dotnet run

这些变量仅影响当前 PowerShell 窗口。若要使其中任一变量永久生效，请在 Windows 环境变量中创建它，然后重启启动器。

使用启动器

1. 输入你的 API 密钥、基础 URL、可选代理和端口。
2. 选择 网页端（浏览器） 以启动 DSH Web，或选择 终末地桌面端 以移交给兼容的本地工作台可执行文件。
3. 点击 保存设置，然后点击 启动。
4. 在 Web 模式下，启动器会等待 http://127.0.0.1:，并在启用时于默认浏览器中打开它。

如果另一个服务已在使用所配置的端口，启动器会假定 Web 服务已在运行，并打开该地址，而不是启动重复的进程。

Endfield 桌面模式

桌面模式是可选的。当前的兼容路径期望此可执行文件位于某个共同父目录下的相对位置：

_endfield2/desktop-app/release/DSH Endfield Workbench-win32-x64/DSH Endfield Workbench.exe
它会将配置好的 API、基础 URL、DSH 主目录和代理值注入到该子进程中。此集成有意与 dsh-endfield-ui-win 仓库分离，并且可能会随着该项目的演进发生变化。

配置与隐私

设置本地存储在：

%APPDATA%\DeepSeekHarnessLauncher\settings.json

API 密钥针对当前 Windows 用户使用 DPAPI 加密。基础 URL、代理、端口和所选模式作为普通本地设置存储。请勿提交或分享此文件。密钥通过环境变量提供给 DSH 子进程；它不会被发送到此 GitHub 仓库。

构建与发布

dotnet restore
dotnet build -c Release

Optional self-contained Windows build
dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true

构建输出应放在 bin/ 或发布产物中，而不是 Git 中。对于公开发布，请提供 SHA-256 校验和，并在分发前对可执行文件进行签名。

开发说明

- 此应用程序有意仅支持 Windows，因为它使用 Windows DPAPI 来保护 API 密钥。
- 应用程序会依次搜索 DSH_BIN、DSH_WORKSPACE，然后搜索可执行文件/当前目录的父目录，以查找 node_modules/.bin/dsh.cmd。
- 启动器期望 DSH 版本与其 web --no-open --port 命令兼容。
- 在贡献或报告漏洞之前，请参阅 CONTRIBUTING.md 和 SECURITY.md。

许可证

MIT