启动项按钮 leexiaode4/dsh-launch-buttons

dsh-launch-buttons

DSH 输入框的多启动项按钮。它是 dsh-launch-button 的独立副本 —— 原插件一行未改（中文说明见下方）。

- 左键主按钮 → 启动默认启动项。还没有配置任何启动项时，默认就是当前对话的工作区目录。
- 右键主按钮 → 弹出启动项列表（每一行是一个启动项）。
- 列表里每一行：点行本身启动它绑定的程序或目录，★ 把它设为默认，⚙（或在该行上右键）打开这个启动项自己的设置 —— 名称、路径、删除。
- 列表底部 ＋ New launch item：填写名称与绝对路径，作用域可选只绑定这个对话或绑定整个工作区。

状态存放在宿主的 $DSH_HOME/launch-buttons/store.json，因此刷新页面不会丢，同一个配置档的每个客户端也共享。

安装

dsh plugin --profile desktop add github:leexiaode4/dsh-launch-buttons # from GitHub
dsh plugin --profile desktop add "<path to this checkout>" # from a local copy
dsh plugin --profile desktop add dsh-launch-buttons # from npm, once published

然后彻底重启 DSH —— 接线在宿主侧，刷新页面不够。如果 dsh-launch-button 也装了，在配置档补丁里把它禁用，免得输入框出现两个启动按钮：

- id: dsh-launch-button
disabled: true

兼容性

- 任何支持 dsh.bundle 协议的 DSH（>= 0.1.5-rc.1）；无需构建步骤，除 Node 本身外没有运行时依赖。react 是可选 peer。
- Windows、macOS 和 Linux：文件夹和文档分别用 explorer.exe、open 和 xdg-open 打开；可执行文件直接 spawn。
- 客户端部分在 Web 平台渲染（浏览器和基于 Electron 的桌面客户端）。

测试

node --test test/core.test.mjs test/host.integration.test.mjs test/client.test.mjs

测试套件里每个启动用例都是拒绝路径 —— 测试从不启动真实进程。

BSD-3-Clause。

对话输入框右下角的多启动项按钮。它是 dsh-launch-button 的独立副本，原插件一行未改。

- 左键主按钮 → 启动“默认启动项”。还没有配置任何启动项时，默认就是当前对话的工作区目录。
- 右键主按钮 → 弹出启动项列表（每一行是一个启动项）。
- 列表里每一行：
- 点行本身 → 启动它绑定的程序或目录；
- ★ → 把它设为默认（此后左键主按钮直接启动它）；
- ⚙（或在该行上右键）→ 打开它自己的设置：名称、路径、删除。
- 列表底部 ＋ 新建启动项：填写名称与绝对路径，可选“只绑定这个对话”或“绑定整个工作区”。

数据放在哪

$DSH_HOME/launch-buttons/store.json：

{
"version": 2,
"sessions": { "<会话 id>": { "items": [ { "id": "…", "label": "…", "path": "…", "at": "…" } ], "defaultId": "…" } },
"workspaces": { "<工作区键>": { "items": [ … ], "defaultId": "…" } }
}

- 启动项分两个作用域：这个对话（sessions）与这个工作区（workspaces，该目录下的所有对话共享）。
- 列表顺序：本对话的启动项 → 本工作区的启动项 → 内置的「工作区」行（兜底）。
- 默认值解析：本对话的 defaultId → 本工作区的 defaultId → 内置工作区目录。默认项被删掉时自动回退到第一条。
- defaultId 可以是 "workspace"，表示“默认就是工作区目录本身”。
- 一个作用域最多 24 个启动项。

从旧插件继承：第一次读取时，如果本插件自己的 store.json 还不存在，而旧的 $DSH_HOME/launch-button/bindings.json 存在，就把它导入（旧文件保持原样，不删）。所以换过来之后行为与原来一致，直到你配置了新东西。

安装

与 dsh-launch-button 相同的接法。推荐直接用一条命令（会自动写下面第 1、2 步）：

dsh plugin --profile desktop add "C:\path\to\dsh-launch-buttons"
或直接从 GitHub 装：
dsh plugin --profile desktop add github:leexiaode4/dsh-launch-buttons

手动接线的两步：

1. 在目标 profile 的 node_modules 里建一个指向本目录的链接（Windows：目录 junction；macOS/Linux：ln -s）： <profile>/node_modules/dsh-launch-buttons → <本目录>
2. profile 的 package.json：
- dependencies 加 "dsh-launch-buttons": "link:<本目录>"
- dsh.profile.bundles 数组里加 "dsh-launch-buttons"
3. 想让新的按钮替代原来的按钮时，在 profile 的 cordis.patch.yml 里把原插件关掉：

- id: dsh-launch-button
disabled: true

不关掉的话输入框右侧会同时出现两个启动按钮（一个旧的、一个新的），两个都能用。
4. 完全退出并重开 DSH（改的是 Host 侧接线，刷新页面不够）。

也可以走桌面端的插件管理器界面（可能需要一次批准）：

npx --yes @deepseek-ai/dsh@<你运行中的版本> plugin --profile desktop add "<本目录或包名>"

验证

- 打开 http://127.0.0.1:<DSH 的端口>/dsh-launch-buttons/health：应返回 {"ok":true,"plugin":"dsh-launch-buttons","strategy":"multi-item",…}（带 storePath）。
- 输入框右侧出现 ▶ 按钮：左键应能打开工作区目录；右键应弹出启动项列表。
- 加一个启动项 → 在列表里点它应能启动；点 ★ 后左键主按钮应直接启动它。
- 失败时看桌面端日志里的 web boot: N entry did not activate，把原文发出来即可定位。

回退

删掉 profile package.json 里的 dsh-launch-buttons（dependencies + bundles 各一行）与那个 node_modules 链接、重启即可；$DSH_HOME/launch-buttons/ 可以直接删（旧插件的 $DSH_HOME/launch-button/ 从未被改动）。关掉原插件的 disabled: true 那两行删掉即可恢复旧按钮。

边界

- 只能启动程序或目录（.exe/.com/.scr 直接启动；目录、文档、脚本交给平台 opener 用系统默认程序打开，与双击等价：Windows explorer.exe、macOS open、Linux xdg-open；POSIX 上带可执行位的文件直接启动）。
刻意不走 cmd /c start：cmd 会二次解析参数，路径里带 & | ^ < > % ! 就会执行第二条命令，而从 Node 这边没法给 cmd 传一个安全引号化的路径（libuv 只给含空格或引号的参数加引号）。
- 路径必须是绝对路径且当前存在，添加时会检查。
- Host 启动子进程时刻意不传 windowsHide / detached：本机 windowsHide: true 会变成 CREATE_NO_WINDOW，子进程会在加载器里以 0xC0000142（STATUS_DLL_INIT_FAILED）当场死掉——看起来“启动成功”其实什么都没打开。
- 状态只存在 Host 侧，客户端不做 localStorage；换界面/刷新不会丢。
- 打开文件夹/文档通过系统 opener（Windows explorer.exe），因此以管理员身份运行的 DSH 与以普通身份运行的 DSH 打开的窗口权限不同。

测试

node --test test/core.test.mjs test/host.integration.test.mjs test/client.test.mjs

core.test.mjs 覆盖纯逻辑（路径判定、启动计划、store 归并与迁移、默认值解析、回环判定）； host.integration.test.mjs 用假 ctx + 真 http server 驱动整套 JSON API（所有启动用例都是拒绝路径，不会真的启动进程）； client.test.mjs 校验模块 id、slots 注入、座位与注入的 CSS。

文件

| 文件 | 作用 |
| lib/core.js | 纯逻辑：启动计划、store 形状与迁移、默认项解析、loopback 判定 |
| lib/index.js | Host：/dsh-launch-buttons JSON API、读写 store、启动进程 |
| lib/client.js | 客户端：输入框按钮、启动项列表、单项设置面板 |
| cordis.patch.yml | bundle 补丁，把 dsh-launch-buttons 插进 cordis |