dsh-melody-launcher

界面与配置

• 双尺寸窗口 —— 无边框设计，启动模式（900×560）与管理模式（1380×860）自由切换
• GitHub 账号登录 —— 支持 OAuth Device Flow 与 Fine-grained Token，凭据使用 Electron 安全存储加密；市场搜索、仓库检测、下载与更新检查统一携带认证
• API 管理 —— 在软件内配置 DeepSeek API Key，也可添加 OpenAI Completions、OpenAI Responses 或 Anthropic Messages 兼容的自定义服务
• 启动器自更新 —— 启动时检查 GitHub Release，可在界面下载并应用新版便携程序
• 完整运行配置 —— DSH_HOME、Profile 名称、工作目录、启动命令与参数，均可在界面调整
• 便携版 —— 启动器自身无需安装，单文件 exe

---

3. 配置 API Key

在启动页填入 DeepSeek API Key。启动器会写入 DSH 官方凭据文件 $DSH_HOME/.credentials.yaml。

使用指南

启动器有三个主要视图：

插件顺序

展示当前 Profile 中的全部 Bundle。每个插件可以：

• 启用 / 停用 —— 切换开关即从有序加载列表中加入或移出，插件文件保留在本机
• 调整顺序 —— 加载顺序影响插件之间的覆盖关系，靠后的插件后加载
• 卸载 —— 真正从当前配置中移除插件。仅对 Profile 依赖开放；DSH 内置的核心组合层没有卸载入口

变更在下次启动 DSH 时生效。

资源市场

从 GitHub 合并检索带 dsh-plugin 或 dsh-skill Topic 的仓库，显示 Star 数、主语言、更新时间和描述。点击检测后，启动器会同时验证 Plugin 与 Skill 结构，并按识别标签调用对应安装器。

同一仓库可以同时提供 Plugin 和 Skill。此时列表显示 Plugin + Skill，安装按钮会打开组件选择窗口，由用户分别安装或更新。

搜索使用 GitHub 匿名 API，有速率限制；额度用尽时启动器会明确提示，稍后重试即可。

运行与日志

查看 DSH 运行状态、PID、启动时间和服务地址，以及实时日志流。日志分 runtime（DSH 本体）和 plugin（插件操作）两个通道，分 info / error / success 三个级别。

---

数据与配置

启动器直接使用 DSH 官方 Profile 结构，不引入任何不兼容的私有插件配置格式。

文件位置

内容	路径
启动器设置	%APPDATA%\dsh-launcher\settings.json
本地 DSH 运行目录	%APPDATA%\dsh-launcher\dsh-runtime\
Node.js 便携运行时	%APPDATA%\dsh-launcher\node-runtime\
GitHub 登录会话（加密）	%APPDATA%\dsh-launcher\github-auth.bin
DSH 凭据	$DSH_HOME\.credentials.yaml
DSH Profile 清单	`$DSH_HOME\profiles\
\package.json`

%APPDATA%\dsh-launcher\ 对应 Electron 的 app.getPath('userData')，目录名取自 package.json 的 name 字段。

默认配置

项	默认值
DSH_HOME	环境变量 DSH_HOME，否则 %USERPROFILE%\.dsh
Profile 名称	web
工作目录	系统「文档」目录
启动命令	npx --yes @deepseek-ai/dsh web（检测到本地安装后自动切换为 dsh web）
启动后自动打开网页	开启

---

默认配置

项	默认值
DSH_HOME	环境变量 DSH_HOME，否则 %USERPROFILE%\.dsh
Profile 名称	web
工作目录	系统「文档」目录
启动命令	npx --yes @deepseek-ai/dsh web（检测到本地安装后自动切换为 dsh web）
启动后自动打开网页	开启

---