返回目录

dsh-melody-launcher

维护状态: 活跃

rirko/dsh-melody-launcher

dsh-旋律启动器:DeepSeek Harness 桌面启动器与插件管理器

前往 GitHub
$ dsh plugin add dsh-melody-launcher

48

星标

31

Fork

TypeScript

语言

2026-08-14

创建于

2026-11-07

最近推送

面向 DeepSeek Harness 的 Windows 桌面启动器:零依赖首次部署、GitHub 资源市场、按官方 Profile 管理插件顺序、一键 `dsh web`。当前发行 v0.5.4,仓库尚未声明开源许可证。

DSH 适配

生态相关

作者声明

安全审计

未审计

最后核验

2026-11-20

许可证

作者未说明

01它能帮你完成什么?

  • 在 Windows 上免手工装 Node 与 CLI,完成 DSH 部署并启动

    可用的本地 DSH 运行时、默认 `web` Profile、凭据文件,以及一键启动、日志面板和可选自动打开网页

    不想在终端里敲 `npx @deepseek-ai/dsh`、希望用图形界面完成上手的 Windows 用户

  • 从 GitHub 搜索并安装 DSH 插件、Skill 及相关资源到当前 Profile

    经结构检测后按类型安装到正确路径,可调整加载顺序并查看分阶段进度

    更习惯按 Topic 发现资源、用界面安装,而不是手写 `dsh plugin add` 的 DSH 用户

  • 在每次启动 DSH 前集中配置 API Key 与运行参数

    通过界面更新 `$DSH_HOME/.credentials.yaml`,并可改 `DSH_HOME`、Profile 名、工作目录与启动命令

    希望在真正启动前就把密钥、插件顺序和端口等运行前配置理顺的用户

02如何接入 DeepSeek Harness?

前置条件

  • 便携版面向 Windows x64 或 arm64(README 写明 npm 运行方式目前仅支持 Windows)
  • 需要网络以下载 DSH、便携 Node、插件与 GitHub 搜索
  • 在启动器内填写 DeepSeek API Key(写入官方凭据文件)

安装步骤

  1. 01

    在仓库 Releases 页面下载最新的 `DSH-Launcher-*-portable.exe`。

  2. 02

    运行便携程序;若未检测到本地 DSH,在首页点击 **「下载安装 DSH」**。

  3. 03

    在启动页填写 DeepSeek API Key,由启动器写入 `$DSH_HOME/.credentials.yaml`。

  4. 04

    可选:打开 **「资源市场」** 检测并安装 Plugin 或 Skill,再在 **「插件顺序」** 中调整顺序。

  5. 05

    在启动页点击 **「启动 DSH」**;服务就绪后打开 Harness 网页(可在设置中关闭自动打开)。

验证接入成功

  • DSH 安装完成后,首页按钮由 **「下载安装 DSH」** 变为 **「启动 DSH」**。
  • 运行中可在日志面板查看状态;若开启自动打开,浏览器会进入 Harness 页面。

回滚

  • 在 **「插件顺序」** 中,**停用** 只从有序加载列表移除 Bundle,本地文件仍保留;**卸载** 会从当前 Profile 配置中移除(核心组合层无卸载入口)。

03DSH 适配与能力边界

DSH 适配生态相关

Windows 图形启动器:安装 `@deepseek-ai/dsh`、读写官方 Profile 与凭据、管理插件,并以 `dsh web` 启动并查看日志。

  • DSH 检测与本地安装

    启动器运行目录、`PATH`、`%APPDATA%\npm` 或系统 Node 目录中的已有安装→复用有效的 `@deepseek-ai/dsh`,或在 `%APPDATA%\dsh-launcher\dsh-runtime\` 部署最新版

    首次部署时在启动器管理的运行目录执行 `npm install @deepseek-ai/dsh@latest`系统无 Node 时从 nodejs.org 下载便携运行时到 `%APPDATA%\dsh-launcher\node-runtime\`
  • 统一资源市场

    检索 GitHub Topic `dsh-plugin`、`dsh-skill` 与 `dsh-app` 的仓库→结构检测后按 Plugin、Skill、应用加载项或混合仓库分别安装

    调用 GitHub API 搜索与下载(匿名接口有速率限制;可选登录后使用加密的 `github-auth.bin`)
  • Profile 插件顺序与启停

    当前 DSH Profile 的 `package.json` Bundle 列表→更新启用状态与加载顺序;下次启动 DSH 时生效

    读写 `$DSH_HOME\profiles\` 下当前 Profile 的 `package.json`主进程禁止停用 `@deepseek-ai/dsh-base`、`dsh-web-app`、`dsh-headless` 三个核心组合层
  • DSH 进程控制与日志

    配置的启动命令(默认 `npx --yes @deepseek-ai/dsh web` 或本地 `dsh web`)→运行中的 DSH、PID、服务地址识别,以及 runtime / plugin 分通道日志

    拉起并停止 DSH 子进程;退出启动器时同步结束相关伴随进程
  • 凭据与 API 配置

    界面中的 DeepSeek API Key 及可选兼容服务条目→写入 `$DSH_HOME` 下 `.credentials.yaml`,文件权限 `0600`、目录 `0700`

    在磁盘上原子写入或替换 `$DSH_HOME\.credentials.yaml`

04适合谁?何时不该用?

适合

  • 不想在终端里敲 `npx @deepseek-ai/dsh`、希望用图形界面完成上手的 Windows 用户
  • 更习惯按 Topic 发现资源、用界面安装,而不是手写 `dsh plugin add` 的 DSH 用户
  • 希望在真正启动前就把密钥、插件顺序和端口等运行前配置理顺的用户

不适合

  • 发布的便携版面向 Windows x64 / arm64;README 称 macOS / Linux 无便携发行,跨平台仅能跑源码开发,且便携 Node 逻辑仅 Windows 实现。
  • 仓库尚未添加 LICENSE;README 说明在补充许可证前版权默认保留所有权利。
  • 首次部署与插件安装需要出站 HTTPS(DSH、Node 发行包、GitHub、Releases);下载中断后可再次点击继续。
  • 启动器保存 API Key 与可选 GitHub 凭据(Electron safeStorage)、管理子进程,并写入 `%APPDATA%\dsh-launcher\` 与 `$DSH_HOME`。

05兼容性、维护与安全提示

  • 发布的便携版面向 Windows x64 / arm64;README 称 macOS / Linux 无便携发行,跨平台仅能跑源码开发,且便携 Node 逻辑仅 Windows 实现。
  • 仓库尚未添加 LICENSE;README 说明在补充许可证前版权默认保留所有权利。
  • 首次部署与插件安装需要出站 HTTPS(DSH、Node 发行包、GitHub、Releases);下载中断后可再次点击继续。
  • 启动器保存 API Key 与可选 GitHub 凭据(Electron safeStorage)、管理子进程,并写入 `%APPDATA%\dsh-launcher\` 与 `$DSH_HOME`。
  • 便携版未做商业代码签名,首次运行可能触发 Windows SmartScreen;需确认文件来自本仓库 Releases 后再选择仍要运行。
2026-08-142026-11-07v0.5.4

未声明许可证 · 最近推送 2026-11-07 · 发行版 v0.5.4

06常见问题

Windows 提示应用不受信任,正常吗?

便携版未使用商业代码签名,SmartScreen 可能拦截未知发布者。确认文件来自本仓库 Releases 后,点「更多信息 → 仍要运行」即可。

我已经手工装过 DSH,启动器会再装一份吗?

不会。启动时会依次检查运行目录、启动配置、PATH、`%APPDATA%\npm` 与系统 Node 目录;须同时有 `@deepseek-ai/dsh` 包清单和 `dsh` 可执行文件才算有效安装。

能在 macOS 或 Linux 用便携版吗?

README 只提供 Windows 便携 exe。其他平台可跑源码做开发,但自动下载便携 Node.js 的逻辑仅实现 Windows 分支。

停用插件后硬盘上还有文件,是不是没卸干净?

这是预期行为:停用只从 Profile 有序加载列表移除,本地依赖保留以便重新启用;只有「卸载」才会从当前配置中移除插件。

资源市场提示 GitHub 请求额度用尽怎么办?

搜索走 GitHub 匿名 API,有每小时限额。README 说明额度用尽时界面会提示,稍等重试即可;也可登录 GitHub(OAuth 或 Fine-grained Token)带认证请求。

08数据与来源

  • 作者声明github.coma499e4ec5e0b…

    一个下载即用的启动器:管理 DSH 本体、插件、API Key 与运行配置,无需预装 Node.js。

  • 作者声明github.coma499e4ec5e0b…

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

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。