M47E1/DSH-windows-launcher

大烧货一键启动器

英文项目名：DSH-windows-launcher

面向 Windows 的非官方 DeepSeek Harness 源码版一键启动器。安装后双击桌面快捷方式即可复用或启动 DSH Web，并在服务健康后打开默认浏览器。

功能

- Windows PowerShell 5.1 可用，不要求 PowerShell 7。
- 使用 Windows 原生 Unicode Shell Link 接口创建并校验中文快捷方式。
- DSH 已健康运行时复用原实例。
- 命名 Mutex 防止连续双击并发启动。
- 识别配置端口的占用进程，不结束身份不明的进程。
- 安装前检查全部快捷方式目标；安装中途失败时回滚程序文件与快捷方式。
- HTTP 健康检查关闭系统代理，验证 DSH 页面特征。
- 强制绑定 127.0.0.1，并回读真实监听地址。
- 隐藏启动窗口，分别记录 stdout、stderr 和启动器日志。
- 状态文件采用同卷原子替换。
- 不修改 PATH、注册表、防火墙、服务、计划任务或全局执行策略。
- 不执行 Git 更新、依赖安装或项目构建。

支持范围

0.1.0 仅支持已经准备好的 DeepSeek Harness 源码仓库。源码仓库必须已经完成依赖安装与构建，并能从仓库目录运行：

pnpm dsh web --host 127.0.0.1 --port 3080 --no-open

本启动器不会代替用户安装 Node.js、pnpm、DSH 依赖或构建产物。

安装

在 DSH-windows-launcher 项目目录中运行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1 -Repository "C:\path\to\deepseek-harness"

默认安装位置：

%LOCALAPPDATA%\DSH-Launcher

默认桌面快捷方式：

大烧货一键启动器.lnk

如果还要在其他已有目录放置快捷方式：

powershell -NoProfile -ExecutionPolicy Bypass -File .\Install.ps1 -Repository "C:\path\to\deepseek-harness" -AdditionalShortcutDirectory "C:\path\to\my-scripts"

从没有 install.json 的旧版目录迁移时，需要显式加入 Force 参数。即便使用 Force，安装器也拒绝覆盖含未知文件的目录或同名但不属于本项目的快捷方式。

日常使用

双击“大烧货一键启动器”：

1. 读取安装目录中的 config.json。
2. 获取与端口对应的命名 Mutex。
3. 检查监听地址、进程身份和 HTTP 页面。
4. 已有健康 DSH 时直接复用。
5. 端口空闲时隐藏启动 pnpm dsh web。
6. 健康检查完成后打开配置的本地 Web 地址。

关闭浏览器不会停止 DSH。本项目不提供强制停止快捷方式。

日志与状态

默认位置：

%LOCALAPPDATA%\DSH-Launcher\logs
%LOCALAPPDATA%\DSH-Launcher\state.json

启动产生的 stdout 和 stderr 分开保存，只保留最近十组；启动器活动日志保留最近二十份。启动器自己的诊断会遮盖常见凭据形式，但无法识别任意格式的秘密。stdout 与 stderr 文件保留 DSH 进程的原始输出，可能含敏感内容，分享前必须自行检查。

无界面验证

powershell -NoProfile -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\DSH-Launcher\Start-DSH-Web.ps1" -SkipBrowser -NoPopup

卸载

卸载不会停止已经运行的 DSH：

powershell -NoProfile -ExecutionPolicy Bypass -File .\Uninstall.ps1 -NonInteractive

保留日志和状态：

powershell -NoProfile -ExecutionPolicy Bypass -File .\Uninstall.ps1 -KeepData -NonInteractive

卸载器只删除 install.json 能确认属于本项目的安装目录和快捷方式。

测试

powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\Test-Static.ps1

测试不连接网络，也不会启动 DSH。

名称与品牌

DSH-windows-launcher 是非官方社区项目，与 DeepSeek 不存在隶属、合作、授权或背书关系。“DeepSeek Harness”仅用于准确说明兼容对象。

许可证与图标

源代码与文档采用 MIT License。

assets/dashaohuo.ico 按项目所有者要求保留当前“大烧货”图标，并按其指示随项目分发。图标的原始来源与许可证未经独立核验，因此不属于 MIT 授权范围；本项目不对该图标主张独立著作权，也不在此授予图标权利。参见 NOTICE.md。