基于上游 121103qwq/DSH-Launcher v1.0.7(
846c44c1)的本地开发分支。 在保留上游全部功能的前提下,把启动器做成一个可用的实例管理器:多实例 / 多版本、插件与市场治理、 崩溃恢复与安全模式、运行状况与诊断、整合包导入导出。
| 想了解 | 看这里 |
|---|---|
| 每个变更集改了什么 | docs/CHANGESETS.md(159 条) |
| 用起来和上游有什么不同 | docs/BEHAVIOR-CHANGES.md(101 条) |
| 怎么验证、发布前要跑什么 | docs/VERIFICATION.md |
| UI 规范(颜色 / 字号 / 圆角 / 按钮 / 图标) | docs/UI-DESIGN.md |
实例与版本
- 多实例管理:导入(扫描本机 dsh 环境 / 源码目录 / 整合包)、重命名、删除;卡片级启动 / 停止 / 重启
- 更换实例运行版本(升级或降级):预检 Node 引擎、插件核心 peerDeps、会话代际、方向 → 可选快照 → 强制重绑定 → 失败回滚
- 版本控制:准备运行环境(官方 npm 源 / 国内镜像,可设为默认)、新建版本、切换历史与一键回退、DSh 新版本提示
- 会话格式跟随 dsh 版本:v0–v3 读取、导入命名与导出保真;旧版实例拒绝新格式会话并给出明确错误
启动、守护与恢复
- 进程内实例守护(5s 探测循环):识别市场「重启以生效」并接管、孤儿进程检测、空闲自动停止、残留进程清理
- 四层启动健康证据 + 进程提前退出归因;启动失败自动进入安全模式,并在下次正常启动后自动清理
- 崩溃恢复:崩溃策略 / 现场保留 / 冷却期、崩溃原因本地归类、逐插件定位(bisect)
- 诊断:
--diagnose导出脱敏诊断包、日志中心(一键清理)、实例生命周期结构化日志
插件与市场
- 插件市场(GitHub 社区目录 + 可选中文源)、Skill 市场、Agent Preset、MCP 管理
- 插件 × 实例矩阵(只读对比同一插件在不同实例的安装 / 启用状态)、依赖自检(doctor)
- 安装前校验:确认目标是 DSH 插件(
dsh.bundle.patch+ 可加载入口)、核心依赖兼容性预检 - 安装韧性:pnpm 失败翻译成可操作原因;失败自动回档并附完整诊断报告
- 整合包(
.dspack)导入 / 导出:文件清单与体积预览、联网下载需显式同意、强制 sha256 + 大小双校验
界面
- 统一 UI 规范:语义色 / 圆角 / 间距 / 图标全部走令牌与矢量图标注册表;字号阶梯与键盘可达性有门禁
- 托盘常驻(关闭到托盘或整体退出)、窗口位置尺寸记忆、多屏越界自动回中
- 路径一键复制(悬停看全文)、列表虚拟化 + 滚动位置记忆、提示条按文字长度自适应消失
安全与隐私
- 安全体检:凭据、权限档位、审批、遥测、危险配置;诊断物一律脱敏
- 实例环境变量的敏感值落盘用 DPAPI 加密;存储清理只回收可再生缓存(实例数据与会话只统计、不清理)
前置:.NET 8 SDK(本机为全局 C:\Program Files\dotnet 8.0.425,不需要 DOTNET_ROOT)。
运行前置(变更集 169 定稿):发布产物是单个框架依赖 exe(DSH Launcher.exe,约 3.62 MB)⇒ 目标机器需要 .NET 8 Desktop Runtime (x64)。
缺运行时的提醒交给系统:Windows 上由 .NET apphost 弹官方对话框("You must install .NET",含下载链接;本机未实测,需要一台未装 .NET 8 的机器)。
变更集 165–168 的中文提醒 + 三条路找运行时 + 一键下载便携运行时源码仍保留在 src/DshLauncher.Bootstrapper/(可选形态,不是默认),要发带中文提醒的两个文件版本见下方发布命令。
发给用户时怎么选(两种包,同一份源码;work-log/191):
| 包 | 命令 | 体积(实测) | 适用人群 |
|---|---|---|---|
| 小包(框架依赖,默认) | dotnet publish src/DshLauncher/DshLauncher.csproj -c Release -o dist |
3.62 MB | 机器已有 .NET 8 Desktop Runtime (x64) |
| 自包含包(免装 .NET) | 同上再加 -p:SelfContained=true |
64.83 MB(其中约 62 MB 是 .NET 运行时) | 没装 .NET 又不想装的人:双击即用、零安装 |
自包含包已做过单文件压缩(未压缩 157.6 MB)与语言资源裁剪,再小不下去:WPF 不支持裁剪(PublishTrimmed 直接报 NETSDK1175)。
三个已知边界(前两条是未做的可选增强):
- 未声明
RollForward⇒ 只认 .NET 8.x:机器上装的是 .NET 9/10 Desktop Runtime 时同样会被判"缺失";要让它们也能跑,需要<RollForward>LatestMajor</RollForward>(可选引导器的检测也要放宽到 "≥ 8")。 - 运行时必须是
Microsoft.WindowsDesktop.App这一支(WPF 要求桌面运行时);只装控制台运行时(Microsoft.NETCore.App)跑不了。 - 第三条路(可选引导器,变更集 168 已实现):小 exe + 便携运行时——引导器按「便携
<exe>/runtime/dotnet→ 系统 →%USERPROFILE%/.dotnet」三条路找运行时,便携/用户级命中时注入DOTNET_ROOT(+_X64) 再拉起主程序;都缺则对话框可一键下载便携运行时(免管理员,约 67 MB 下载 / 162 MB 占用,官方两份 zip 解压即用)。适合"要共享运行时 / 只发 3.6 MB 分发物 / 不愿装任何东西"的场景(见work-log/192、193)。 - 可选引导器尚未支持用户级免管理员安装(官方
dotnet-install.ps1装到%USERPROFILE%\.dotnet+ 代设DOTNET_ROOT)。
便携版(绿色版)布局(变更集 163 起):把 DSH Launcher.exe、run_time、launcher-data 放在同一文件夹里,整个文件夹可拷走:
- exe 旁存在
launcher-data目录即启用便携数据根(实例、设置、会话、缓存都在这里);注册文件里的旧数据根绝对路径会在加载时按当前数据根重定位(不会因此加载失败,旧数据根可保留作回退); - 便携 Node 会装到
<数据根>\node(NodeRuntimeDetector把便携 node 当第一候选);dsh 运行时固定在 exe 旁的run_time; - 仍依赖系统 WebView2(常青版);打包便携 node 与 WebView2 固定版不做(用户 2026-09-23 口径:不强制放在一起,以轻量 + 功能为准;详见
work-log/186/187)。
cd src\DshLauncher
# 构建(以 0 警告 0 错误为准)
dotnet build -c Release
# 仓库自测:纯逻辑、不联网、不开窗口、不碰真实数据(发布前必跑)
dotnet run --project ..\..\tests\DshLauncher.SelfTest\DshLauncher.SelfTest.csproj -c Release
# 发布(默认:单个框架依赖 exe → dist\DSH Launcher.exe,约 3.62 MB;目标机需装 .NET 8 Desktop Runtime)
dotnet publish DshLauncher.csproj -c Release -o ..\..\dist
# 可选:要“中文提醒 + 三条路找运行时 + 一键下载便携运行时”时,发两个文件(变更集 165/168)
# 入口名让给引导器:主程序发布时加 -p:AssemblyName="DSH Launcher.App"
dotnet publish DshLauncher.csproj -c Release -o ..\..\dist -p:AssemblyName="DSH Launcher.App"
dotnet build ..\DshLauncher.Bootstrapper\DshLauncher.Bootstrapper.csproj -c Release
copy ..\DshLauncher.Bootstrapper\bin\Release\net48\"DSH Launcher.exe" ..\..\dist\
# 需要「免装 .NET 的大包」时(自包含,约 64.8 MB;压缩按 SelfContained 条件自动开启)
dotnet publish DshLauncher.csproj -c Release -o ..\..\dist -p:SelfContained=true
⚠️ 发布前先停掉运行中的 DSH Launcher,否则dist里的 exe 被锁 →MSB4018。⚠️ 改动 csproj 资源清单(<Resource Include>)后必须rm -rf bin/obj全量重建,否则增量构建的 BAML 资源清单不刷新(曾致主窗口 XAML 解析崩溃)。- 开发期不要直接
dotnet "DSH Launcher.dll"(会带 conhost 黑窗口,关掉黑窗口 = 杀进程);正式使用一律dist\DSH Launcher.exe。
dsh-launcher-dev/
├─ src/DshLauncher/ # C# 源码(WPF + WebView2,.NET 8,自包含单文件)
├─ tests/DshLauncher.SelfTest/ # 仓库自测(纯逻辑、临时目录、不联网)
├─ docs/ # 变更集清单 / 行为变化 / 验证 / UI 规范 / 契约清单 …
├─ .github/workflows/ci.yml # CI:构建 + 自测
├─ dist/DSH Launcher.exe # 发布产物(.gitignore 排除,不随仓库提交)
└─ README.md
| 文档 | 内容 |
|---|---|
| docs/CHANGESETS.md | 169 条变更集清单(相对上游 v1.0.7)——改了哪些文件、改了什么 |
| docs/BEHAVIOR-CHANGES.md | 111 条用户可见行为差异 |
| docs/VERIFICATION.md | 三层验证(构建 / 仓库自测 / 端到端 harness)与发布前清单 |
| docs/UI-DESIGN.md | UI 规范:颜色令牌、字号阶梯、圆角、按钮分级、图标注册表 |
| docs/DSH_CONTRACT_INVENTORY.md | 与上游 dsh 的契约清单(会话格式 / 文件名 / CLI / 运行时布局…)及哨兵 |
| docs/ARCHITECTURE_DECISIONS.md | 架构决策记录 |
| docs/BEHAVIOR_MATRIX.md | 行为矩阵 |
| docs/UI-UNIFICATION-TODO.md | UI 统一待办(挂起中) |
| docs/FEATURE-INVENTORY.md | 功能台账:三级分类(12 域 / 85 L2 / 281 L3)+ 界面承载矩阵 + 完整性四口径判定 + 缺口清单 + 界面布局建议 |
| docs/WALLPAPER-PROPOSAL.md | 壁纸模式方案(B2c,未实施):三种形态与取舍、待拍板问题、拆分步骤 |
| docs/UPSTREAM-CAPABILITY-REVIEW.md | 与上游 v1.2.4 的能力对照(评估):双方独有能力、同能力不同实现、三条路线建议 |
| docs/UPSTREAM-INTEGRATION-PLAN.md | 上游集成计划(dsh 0.1.7-rc.2 新增能力 → 启动器):高价值 A–D 的分步计划(含落点/验证/风险)+ 待定 E–J + 兼容性观察项 W1–W6 |
| docs/THIRD-PARTY-NOTICES.md | 第三方组件与许可(Tabler Icons 等) |
本分支相对上游的全部改动(C# 源码、XAML、验证脚本与文档)由 DeepSeek v4 Flash 系列模型完成; 每个改动都按「构建 0 警告 0 错误 → 仓库自测 → 端到端验证(含 UI 冒烟与截图)→ 人工验收」的流程提交。
- 上游仓库:
121103qwq/DSH-Launcher;本分支基线 v1.0.7(846c44c1)。 - 上游发布新版本时,对照上游 diff,用
docs/CHANGESETS.md当移植清单逐项核对。
dist/DSH Launcher.exe 是单文件:启动器与实例守护在同一个进程内。
- 架构:监控循环 = Launcher 内 5s 定时任务(后台 Task),无子进程、无管道、无额外 exe
- 探测:识别市场重启(登记 PID 死 + 端口活 + 身份校验)→ 触发接管重启
- 停止判定:15s 宽限(覆盖 market 重启窗口)+ 5 分钟重生观察窗
- 崩溃兜底:Launcher 异常退出后的残留实例,由下次启动的台账恢复 + 孤儿检测提示
- 日志:
%LocalAppData%\DeepSeek\launcher\watchdog.log(1MB 轮转);台账watchdog-state.json
- 「没装 .NET 又不想装」的用户:目前只能发自包含包(
-p:SelfContained=true,约 64.8 MB,零安装);两项可选增强未做——① 放宽到 .NET 9/10(RollForward=LatestMajor+ 可选引导器检测 ≥ 8)② 用户级免管理员安装(%USERPROFILE%\.dotnet+ 引导器代设DOTNET_ROOT)。详见work-log/191。 MainWindow.OnClosing在窗口关闭期间偶发InvalidOperationException(疑为关闭期间仍有异步回调操作窗口可见性),待复现定位。- 版本下载源切「国内镜像」的真实下载尚未在本机验证(本机已有相关版本,不触发下载)。
- 150% / 200% DPI 未逐屏验收(当前以 125% 为基准)。
- UI 统一待办见 docs/UI-UNIFICATION-TODO.md(主题色自定义、FAB、壁纸模式等)。