旋律启动器序曲 Miyazawai/DSH-Melody-Launcher-Overture

DSH 旋律启动器：序曲

DSH-Melody-Launcher: Overture —— 面向 DeepSeek Harness 的 Windows 桌面启动器（C 端分支）

下载一个 exe，首次启动自动带入「官方默认整合包」：DSH 本体、Web 全家桶界面、Office 文档技能全部就位，点「启动 DSH」就能对话、做 PPT、写周报 —— 无需预装任何东西。

简体中文 · English

[!NOTE]
关于本仓库：「序曲（Overture）」是 rirko/dsh-melody-launcher 的 C 端分支，对应「暴力整合包模式」产品线。上游仓库是启动器的主线；本分支聚焦个人玩家的整合包体验——开箱即玩、按包隔离、整包搬运。架构与词汇表见上游主线，本分支的增量决策记录在 CONTEXT.md 与 CHANGELOG.md。

这是什么

DSH 旋律启动器：序曲 把 DeepSeek Harness（DSH）的下载、部署、插件管理和启动流程收拢到一个图形界面里。交互方式参考《我的世界》忘却的旋律启动器：在真正启动之前，先在一个地方把版本、插件、技能、预设都安排妥当。

「序曲」的核心概念是整合包（Modpack）：

每个整合包 = 一套真隔离环境（DSH 版本 + 插件 + 技能 + 预设 + 配置 + 会话），互不串扰。你可以同时养着「稳定工作包」和「尝鲜测试包」，随点随切；还能把整包发给朋友，对方导入即可启动。

| 原本要做的事 | 用启动器之后 |
| 装 Node.js → 装 npm → npx @deepseek-ai/dsh | 下载一个 exe，首启全自动部署 |
| 翻 GitHub 找插件、手敲 dsh plugin add | 内置 DSH Market / 技能市场，一键安装 |
| 想让 AI 帮你做 PPT / 周报 / 表格 | 官方默认整合包自带 Office 技能，装好就能用 |
| 多套环境互相污染，删了重装 | 新建一个整合包，天然隔离，互不影响 |
| 把自己的配置折腾半天分享给朋友 | 导出 = 整个环境打包成 zip，对方导入即可启动 |
| 开终端、记命令、盯输出 | 一个按钮启动，进程与日志全程托管 |

v1.0.4 更新亮点

- 外观自定义 —— 设置页新增「外观」分组：主题色（预设 + 自定义取色）、面板透明度、整窗背景图（含背景透明度）、启动器头像。全部存在 settings.json 的可选 appearance 字段里，旧配置照常读写；保存后立即生效，重启保留。
- 背景 / 头像换图立即生效 —— 复制件文件名固定，旧实现换图后 URL 不变，React 和浏览器会继续用旧图；现在 URL 带内容版本参数，同一张图连续替换也不需要先点「清除」。
- 选图限制写在设置里 —— PNG / JPG / JPEG / WEBP，单张不超过 10MB，尺寸不限；格式不支持、超限或文件不存在时，面板内直接显示原因。

v1.0.3 更新亮点

- 装完插件不再把整台电脑拖死 —— 在 DSH Market 装 dsh-web-all 这类大依赖，Windows 会弹「没有响应」：安装输出被逐条送进界面，而插件页那 3400+ 张卡片不分页，每一次刷新都要全量重渲染；主进程那边还在用同步调用查系统代理，把窗口消息泵直接冻住。现在输出合帧、市场分页、代理探测改异步并缓存。
- web 整合包一启动就退出（代码 1）修好了 —— 起因是凭据文件里有把 API 名字填成纯数字或一条 URL 的，DSH 的凭据插件拒绝激活、另外十个插件跟着全在等它。启动器现在在拉起 DSH 之前先把这些名字改成合法写法，密钥值一个字节不动，改之前留原件备份，反复启动也不会重复改名。
- 市场打不开也能装插件 —— 插件页多了「手动添加」：填 GitHub 仓库地址或 npm 包名（可带版本号）直接装，不查精选目录、也不调用 GitHub 的接口。
- 官方桌面端也管 —— DeepSeek 09-29 发了官方桌面端，它和 CLI 共用同一个数据目录。启动器现在能列出它装了哪几个插件、经它自己那条命令装卸、一键让它走国内镜像（只动 registry 一个键，可恢复原样），也能直接打开它。启用与停用做不了——它对外只开放安装与卸载，那条命令没有开关，这件事写在界面上而不是等用户找了才发现。

v1.0.2 更新亮点

- 下载 DSH 版本这回真修好了 —— v1.0.1 说修了但其实没有。原因也不是镜像源，是一条 30 秒的请求超时：0.1.7 依赖里那个 LibreOffice 原生包压缩后 115.9MB，实测 610KB/s 的连接光下它就要 190 秒，换哪个源都过不去。现在超时放到 600 秒，镜像源也改成 pnpm 真正认的那条路。

v1.0.1 更新亮点

- 下载 DSH 版本不再卡在 82% —— 这条修复其实没生效（pnpm 不读当时设的那个环境变量），真正的原因见上面 v1.0.2。
- 认得出你命令行部署过的旧环境 —— 装启动器之前就用 dsh 命令跑过的话，那个包现在带一枚「命令行部署」徽标，说清你的配置和聊天记录仍在原处，只是还没绑 DSH 版本。

v1.0.0 更新亮点

- 聊天记录可以跨包搬 —— 一个包攒了几十条会话，想挪到另一个包不用再重聊一遍。搬之前先看预览（能搬几条、多大、哪些搬不了以及原因），搬完能一键撤销，源包始终不改动。
- 导出可以带走自己的东西 —— 默认导出的包仍然不含任何私人数据；想带走 API 密钥或会话记录时勾一下，弹窗会先说清这东西发出去收不回来，压缩包里也会放一份勿转发提醒。
- 切换版本不改原包 —— 想试另一个 DSH 版本，就复制一个新包去用，原包分毫未动，用不惯回原包继续。数据格式只能往上升，所以列表里只列更新的版本，往回退会当场拦下并说明原因。
- 起不来时会告诉你死在哪一步 —— 端口被占、进程没拉起来、跑一半退出，三种情况各有各的原因和排查方向，末尾附一段能直接复制给 AI 的修复提示词。

v0.1.3 更新亮点

- 官方整合包按版本可选 —— 整合包页顶部多了一个「官方整合包」堆叠入口，展开是所有历史版本（最新版标「推荐」，每行写着它适配哪个 DSH 版本与体积）。想装哪个装哪个，同一个版本重复下载会得到「(2)」副本；发现新版本只挂「有新版本」徽标提醒，不会在后台偷偷下几百 MB。
- 下载全程可见，慢了自己换源 —— 下载时是带速度与来源的进度条（「50% · 3.4 MB/s · 经 gh-proxy.com」），下载完接着显示导入阶段（补装 DSH 运行时、解压一万多个文件），不再有「卡在 100%」的错觉。直连 8 秒无响应、20 秒断流、或速度低于 300KB/s 会自动切到镜像，不必再手动折腾代理。
- 设置页网络更好配 —— 「GitHub 镜像」从裸文本框改成下拉（自动 / gh-proxy.com / ghfast.top / ghproxy.net / 自定义），选「自动」即走上一条的换源逻辑。

v0.1.2 更新亮点

- 「检查更新」修好了 —— 此前插件更新面板恒显示「当前为本地开发模式」并拒绝自动更新：启动器把整合包 Profile 的清单名写成了非官方前缀，被插件误判为本地开发链接。现已统一为 DSH 官方命名，已有整合包会在启动时自动迁移，无需重装。

v0.1.1 更新亮点

- 官方默认整合包 —— 首次启动自动获取导入：DSH 本体 + Web 全家桶界面 + Office 文档技能（Word / Excel / PPT）+ AI 去味写作技能，开箱即用。可以删，删了在「官方整合包」里一点即可重新下载。
- 快照式导出 / 导入 —— 把整合包连插件本体、依赖、技能、配置整个打成 zip；导出前自动剔除 API Key、会话记录等个人数据，绝对路径自动改写。对方导入即可启动，全程不联网重装依赖。
- Office 文档能力 —— 官方包内置 OfficeCLI 技能四件套与引擎本体（随包搬运）：对 AI 说一句「把这季度数据做成汇报 PPT」，就能拿到可继续编辑的 .pptx / .docx / .xlsx。
- 运行态分段按钮 —— 浏览器页面关掉了？首页大按钮左段停止服务、右段一键重开网页。
- 删除更安全 —— 整合包删除改为原子回收站：服务还挂着时删除会整体失败并明确报错，绝不会出现「记录还在、环境没了」的半删状态。

界面速览

| 启动页 —— AI 日报全栏目滚动、一键启动、当前整合包快切 | 运行中 —— 左段停止服务，右段一键重开网页 |
| 启动页 | 运行态 |
| 整合包 —— 顶部「官方整合包」堆叠列出所有历史版本，可删可重下 | 下载进度 —— 速度、来源与阶段全程可见，慢了自己换镜像 |
| 整合包 | 下载进度 |
| 删除二次确认 —— 点删除变红「确定删除」，说清删什么留什么 | 技能管理 —— 官方包自带 Office 四件套与去味写作，可启停可卸载 |
| 删除确认 | 技能管理 |
| 技能市场 —— 1900+ 技能按分类浏览安装 | 插件 —— 核心组合层受保护，启停不删本体 |
| 技能市场 | 插件 |
| DSH Market —— 3400+ 精选插件，搜索 / 分类 / 检查更新 | DSH 版本 —— 已装与可下载版本一目了然，切换只在整合包页 |
| DSH Market | DSH 版本 |

核心特性

官方默认整合包：下载即有

- 首启自动获取、进度全程可见 —— 启动器后台核对版本，自动从 GitHub Release 拉取官方包 zip 并导入，下载有带速度与来源的进度条、导入阶段接着显示，全程零操作
- 内容基线 —— Web 全家桶界面（任务板 / Git 图 / 皮肤中心 / 社区插件…）、Office 文档技能（含 33MB 引擎随包搬运）、去 AI 味中文写作技能
- 可删可恢复、按版本可选 —— 官方包没有特权，删了在整合包页顶部的「官方整合包」里一点即可重下；那个堆叠里列着所有历史版本（最新版标「推荐」），想装哪个装哪个，同一个版本重复下载会得到「(2)」副本。有新版本时只挂个「有新版本」徽标提醒你，不会在后台偷偷下几百 MB

整合包：真隔离环境

- 按包隔离 —— 每个整合包有独立的派生家目录，DSH 版本、插件、技能、预设、配置、会话全套隔离，互不串扰
- 快照搬运 —— 导出 = 家目录整个进 zip（自动剔除 API Key / 会话 / 用量等个人数据，绝对路径相对化，符号链接重建），导入即可启动
- 零包引导态 —— 删光所有整合包不慌：三步引导卡带你从零重建，不会偷偷生成兜底包

零依赖部署

- 自动准备 Node.js / pnpm —— 启动器自带便携运行时（SHA-256 校验、断点续传），不需要系统装 Node
- 自动准备 DSH —— 导入的包缺 DSH 版本时弹窗确认后自动补装
- GitHub 加速 —— DSH 版本列表、插件目录、官方包下载统一走「用户镜像 → 直连 → 公共镜像」候选链；官方包这类百 MB 资产还会按实测速度换源：等首字节超时、中途断流、均速低于 300KB/s 任一命中就切下一个源，大陆网络可用

启动与进程管理

- 一个按钮启动 —— 以 dsh --profile <整合包> --no-open --port N 拉起对应包，服务就绪自动打开网页；网页关了就点首页右段「打开网页」
- 进程生命周期托管 —— 启动、停止、实时日志；退出启动器时同步收尾 DSH 及伴随进程
- 失败原因直达 —— DSH 异常退出时，命令、退出码、stderr 以错误弹窗呈现，还能一键复制「修复引导提示词」交给 AI

统一资源市场

- DSH Market —— 精选插件目录（awesome-dsh-plugin 数据源），搜索、分类、检查更新
- 技能市场 —— 1900+ 技能按分类浏览，严格校验 SKILL.md 结构后安装
- 启停 ≠ 卸载 —— 开关只控制下次启动是否加载；卸载按钮连文件一起删，核心组合层禁止停用

快速开始

1. 下载

前往 Releases 下载 DSH-Launcher--portable.exe，单文件、免安装。

[!IMPORTANT]
便携版目前未使用商业代码签名证书。首次运行时 Windows SmartScreen 可能提示来源未知 —— 请确认文件确实来自本仓库 Release 页面后，选择「更多信息 → 仍要运行」。

2. 等官方包就位

首次启动会自动下载导入「官方默认整合包」（约 120MB，含 DSH 本体与全部资源；整合包页顶部有带速度与来源的进度条，接着显示导入阶段）。完成后首页显示当前整合包为「官方默认整合包」。之后官方包跟随 @linxin666/dsh-web-all 发版自动出新版本，启动器只会提醒、由你决定什么时候下载。

3. 填 Key，启动

「设置」里填入 DeepSeek / 其他模型 API Key（写入当前包私有凭据，不随包分享）→ 回启动页点「启动 DSH」→ 浏览器自动打开 Web 工作台，开聊。

4. 试试 Office 技能

对 AI 说：「用 officecli 创建一个 pptx，标题是季度汇报，再加一页要点」。几秒后拿到可继续编辑的 .pptx。

5. 分享你的整合包

整合包页点「导出」→ 把 zip 发给朋友 → 对方「导入整合包」即可启动，你的插件、技能、配置原样重现（个人数据已自动剔除）。

从源码运行

git clone https://github.com/Miyazawai/DSH-Melody-Launcher-Overture.git
cd DSH-Melody-Launcher-Overture
npm install
npm run dev # 开发模式
npm test # Vitest 全量测试
npm run build # 类型检查 + 产物构建
npm run package:win # 打包 Windows 便携 exe

要求 Node.js ≥ 20。

[!TIP]
发版：推 v 标签即可触发 CI 自动打包，并把便携 exe 挂到 Release：
git tag -a v0.1.1 -m "v0.1.1" && git push origin v0.1.1
同时把 official-pack-v<版本>.zip（整合包页导出后改名）上传到对应 Release，官方包机制按 OFFICIAL_PACK_VERSION 常量核对。

数据与配置

| 内容 | 位置 |
| 启动器数据（packs.json / 设置 / 运行时） | %APPDATA%\dsh-launcher |
| 整合包家目录（含包自带工具 tools/） | %APPDATA%\dsh-launcher\dsh-packs\<包id> |
| DSH 版本缓存 | %APPDATA%\dsh-launcher\dsh-runtime\versions |
| 机器级托管工具（OfficeCLI 兜底下载） | %APPDATA%\dsh-launcher\dsh-tools |
| 默认 DSH 家目录 | ~/.dsh |

导出整合包时，API Key、会话记录、用量统计、任务板等个人数据一律不进包。

与上游的关系

- 上游主线：rirko/dsh-melody-launcher —— 启动器主线开发与插件目录 PR 的目标仓库
- 本仓库：序曲（Overture）独立发布线 —— 便携 exe 与官方默认整合包都发布在这里的 Releases
- 两边共享核心架构（派生家目录咽喉点、packs.json 唯一清单等）；本分支的增量以「首公里上手体验」为准绳：零依赖部署、官方包开箱即玩、整包搬运

联系与反馈

- 问题反馈请开 Issue，附上启动器版本与复现步骤

项目坚持非盈利方向。启动器只是本地工具，所有 DSH 相关资源版权归 DeepSeek 各自权利人所有。