dsh-power-menu-mac 0.0.0-stage → 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Changelog
+
+本项目遵循 [Semantic Versioning](https://semver.org/spec/v2.0.0.html)，格式参考 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/)。
+
+## [0.1.0] - 2026-10-26
+
+首个 macOS 版本。基于 [xichen-62/dsh-power-menu](https://github.com/xichen-62/dsh-power-menu) 0.1.18（MIT）移植。
+
+### Changed
+
+- 宿主侧改成 POSIX：结束进程从 `taskkill /PID x /F` 改为 `SIGTERM`（必要时 `SIGKILL`）；读进程表从 PowerShell `Get-CimInstance Win32_Process` 改为 `ps -A -o pid=,ppid=,comm=`；失败提示从 PowerShell 消息框改为 `osascript display alert`（不需要辅助功能授权）。
+- 去掉 Windows 专属的「中文路径 cmd.exe 拷贝」自检，改成在「中文 + 空格」目录里启动一个中文名脚本。
+- 接口前缀 `/api/dsh-power-menu/*` → `/api/dsh-power-menu-mac/*`；状态目录 `~/.dsh/dsh-power-menu/` → `~/.dsh/dsh-power-menu-mac/`，可与原版同时安装而不打架。
+- 安装脚本从 403 行 PowerShell（`install.ps1` / `enable.ps1`）改为 POSIX shell（`install.sh` / `enable.sh`）。不再需要 MinGit、不改 PATH、不处理 junction；会自动去 `.app` 包里找 `dsh` CLI。
+- 许可证保留原版权声明，并叠加本项目版权。
+
+### Fixed
+
+- **macOS 上的孤儿清理其实没生效**：`ps` 分支原来只读 `pid` 和 `ppid`，不返回进程名，于是「只清理本应用自己的进程」那道按镜像名过滤的判断在 macOS 上等于没有 —— 会把 Electron 主进程的所有子进程都算进来。现在读 `comm` 取 basename，过滤真的生效。
+
+### Added
+
+- **重启验证**：新进程必须注册到 macOS 窗口服务器（`lsappinfo find pid=<pid>`）并活过启动宽限期才算成功。原版在 macOS 上只能检查「进程还活着」，白屏或崩溃循环会被误判为成功。
+- **平台门控**：`package.json` 声明 `os: ["darwin"]`；客户端在非 macOS 上直接不加载，不画一个点了没反应的按钮。
+
+## 上游历史
+
+0.1.18 及之前的所有版本属于 [xichen-62/dsh-power-menu](https://github.com/xichen-62/dsh-power-menu)（Windows 版），其更新日志见该仓库的 `CHANGELOG.md`。本仓库的版本号从 0.1.0 重新开始。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 暮迟
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,278 @@
-# Temporary Holding Version
+# dsh-power-menu-mac
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+给 DeepSeek Harness 桌面版（**macOS**）加一个右上角电源按钮：点开只有 **关闭DSH** 和 **重启DSH** 两项，省得每次改完插件/配置还要去菜单栏里翻「退出」。
+
+> macOS 专用 · 只支持 DSH Desktop · 纯本地 · 无外部依赖 · MIT
+>
+> 这是 [xichen-62/dsh-power-menu](https://github.com/xichen-62/dsh-power-menu)（Windows 版）的 **macOS 移植**，按 MIT 许可独立发布。原版的版权与思路保留在 [LICENSE](LICENSE) 和 [致谢](#致谢) 里。
+
+![电源菜单截图](docs/screenshot.png)
+
+## 为什么做这个
+
+DSH Desktop 关窗口只是收进 Dock，真正退出或重启要走菜单栏；而改插件、改配置之后又经常需要重启一次。这个插件把这两步搬到会话标题栏右上角：一个电源键，两项操作，点完就走。
+
+原版只支持 Windows —— 它靠 `taskkill` 结束进程、靠 PowerShell 读进程表和窗口句柄。macOS 上这些都没有，所以这里把它们换成了 POSIX 的做法，并且**顺手补上了原版在 Mac 上做不到的那件事**（见下面「重启是怎么验证成功的」）。
+
+## 功能
+
+- **右上角电源按钮**：位于会话标题栏图标行最右侧，顺序为「布局 / 侧栏 / 电源」。
+- **空会话也显示**：欢迎页和对话内使用同一个挂载位置，透明无底色，不会破坏主题，也不会出现两个按钮。
+- **两项操作**：白色圆角卡片、悬浮阴影、左侧线性图标 + 右侧文本，不塞多余入口。
+- **关闭DSH**：结束整个 DeepSeek Harness 桌面应用（Electron 主进程 + Host），不重新启动。
+- **重启DSH**：结束整个应用，等旧端口释放后用原可执行文件重新拉起，窗口自动回来。
+- **重启会验证真的回来了**：新进程必须**注册到 macOS 窗口服务器**（`lsappinfo`）并活过启动宽限期，才算成功；只是「进程还在」不算。
+- **键盘可用**：`↑` / `↓` / `Home` / `End` 在两项间移动，`Enter` / 空格执行，`Esc` 关闭，点菜单外部也能关。
+- **执行反馈**：点击后整页盖一层半透明遮罩，显示「正在关闭DSH…」/「正在重启DSH…」。
+- **纯本地**：没有外部依赖、没有遥测；接口只监听本机回环地址，并做同源校验。
+- **非 macOS 不加载**：宿主半只说 POSIX，所以在别的系统上按钮**根本不会画出来**，而不是画出来点了没反应。
+
+## 安装
+
+> **重要**：装完插件后，必须再运行一次 `enable.sh`（或直接用下面的 `install.sh`），把 `dsh-power-menu-mac` 补进 profile 的 `dsh.profile.bundles`，然后重启 DSH。少了这一步，按钮会 404 —— 这是 DSH 插件管理器只写 `dependencies`、不写 bundles 的已知行为，不是插件本身的问题。
+
+### 方式 A：一键脚本（推荐）
+
+```bash
+git clone https://github.com/DDDMUC/dsh-power-menu-mac.git
+cd dsh-power-menu-mac
+./install.sh
+```
+
+脚本会：找到 DSH 自带的 `dsh` CLI → 安装插件（有 `git` 用 `github:` 依赖，没有就下载 Release 里的 `.tgz`）→ 补齐 `dsh.profile.bundles` → 提示重启。
+
+GitHub 直连慢或不通时：
+
+```bash
+./install.sh --mirror
+```
+
+完全离线：
+
+```bash
+./install.sh --tgz ./dsh-power-menu-mac-0.1.0.tgz
+```
+
+> `dsh` 不在 `PATH` 上也没关系 —— 脚本会去 `.app` 包里找：
+> `/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh`。
+
+### 方式 B：通过 DSH 插件管理器
+
+1. 打开 DSH Desktop 的 **插件 / 插件市场**。
+2. 选择 **添加插件**，输入：
+
+   ```text
+   github:DDDMUC/dsh-power-menu-mac
+   ```
+
+3. 安装完成后，补一次 bundles（这一步不能省）：
+
+   ```bash
+   ./enable.sh
+   ```
+
+4. 重启 DSH，并在 **插件市场 → 已安装** 里确认 `dsh-power-menu-mac` 处于「启用中」。
+
+### 方式 C：命令行安装
+
+```bash
+"/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
+  plugin --profile desktop add github:DDDMUC/dsh-power-menu-mac
+./enable.sh
+```
+
+### 方式 D：本地开发安装
+
+```bash
+git clone https://github.com/DDDMUC/dsh-power-menu-mac.git
+ln -s "$PWD/dsh-power-menu-mac" ~/.dsh/profiles/desktop/node_modules/dsh-power-menu-mac
+```
+
+然后在 `~/.dsh/profiles/desktop/package.json` 里：
+
+- `dependencies` 增加 `"dsh-power-menu-mac": "link:<你 clone 下来的目录>"`
+- `dsh.profile.bundles` 增加 `"dsh-power-menu-mac"`
+
+（或者直接跑 `./enable.sh desktop` 帮你改 bundles。）
+
+重启 DSH 生效。这个插件没有构建步骤，改完 `lib/` 里的文件重启即可。
+
+## 使用
+
+1. 在会话标题栏右上角点电源图标。
+2. 选择 **关闭DSH** 或 **重启DSH**。
+3. 等待遮罩出现：关闭会退出应用；重启会在几秒后把窗口拉回来。
+
+| 动作 | 结果 | 需要手动重开？ |
+| --- | --- | --- |
+| 关闭DSH | 结束整个桌面应用，不重新启动 | 是 |
+| 重启DSH | 结束应用 → 等端口释放 → 重新拉起 → 验证窗口 | 否，窗口自动回来 |
+
+> **注意**：点击即执行，没有二次确认。两个动作都会中断正在生成的回答、运行中的工具和后台任务。请在点之前保存手头的事情。
+
+## 工作原理
+
+桌面版的进程树大致是：
+
+```text
+Electron 主进程
+└── Host 子进程（dsh-desktop-host，ELECTRON_RUN_AS_NODE=1）
+    └── 本插件
+```
+
+插件跑在 Host 里，不能直接调用 Electron 的 `app.quit()` / `app.relaunch()`。所以 Host 只负责"交接"，真正的进程切换交给一个分离的 helper：
+
+```mermaid
+flowchart LR
+  UI[电源菜单] -->|POST| Host[Host 插件]
+  Host -->|写 handoff + spawn| Helper[detached helper]
+  Helper -->|SIGTERM → SIGKILL<br/>只对 Electron 主进程| Main[Electron 主进程]
+  Main -.->|IPC 断开| Host
+  Host -->|application.shutdown| Disk[(会话日志落盘)]
+  Helper -->|等端口释放 + 重新拉起| NewMain[新的 Electron 主进程]
+```
+
+具体步骤：
+
+1. Host 把交接信息写到 `~/.dsh/dsh-power-menu-mac/`，用 `process.execPath` + `ELECTRON_RUN_AS_NODE=1` 启动 `lib/helper.cjs`。
+2. helper 等 1.2 秒，让 HTTP 应答先到浏览器。
+3. helper 对 Electron 主进程发 `SIGTERM`（让它有机会收尾），必要时 `SIGKILL`。**只对主进程**，不碰它的子树。
+4. Host 检测到断开后走自己的 `application.shutdown`，尽量把会话日志正常落盘。
+5. 重启模式下，helper 等旧监听端口释放，清掉 `ELECTRON_RUN_AS_NODE` / `DSH_DESKTOP_NODE_EXECUTABLE`，用原可执行文件重新拉起，**并验证新进程真的注册到了窗口服务器**；失败会重试，仍失败就弹窗提示手动打开。
+6. 关闭模式下不拉起，等 Host 自己退出。
+
+### 重启是怎么验证成功的
+
+这是 macOS 版和原版行为差别最大的地方。
+
+原版在 Windows 上用 `Get-Process` 读 `MainWindowHandle` / `MainWindowTitle`，能真的看到窗口，还能认出「应用无法启动」这类崩溃对话框。macOS 上作者没有对应手段，只能退化成**"进程还活着就算成功"** —— 白屏、卡在启动、崩溃循环都会被误判成成功。
+
+这里的做法是查窗口服务器：
+
+```bash
+lsappinfo find pid=<新进程>
+```
+
+- 有输出 → 这个进程**已经作为 GUI 应用注册到窗口服务器**，有界面了。
+- 空输出 → 进程在跑，但从来没连上窗口服务器（崩溃循环、headless 重启）。
+- 之后再要求它活过启动宽限期（单实例锁意味着第二个实例会立刻退出，活下来就说明是它）。
+
+`lsappinfo` 是 macOS 自带、**不需要任何权限**。另一条路（`osascript` + System Events 查窗口）需要辅助功能授权，会在用户面前弹一个同意框 —— 而这个框恰好出现在"应用刚重启失败"的时候，非常糟糕，所以没用。
+
+### 接口
+
+Host 半注册四个仅限本机回环的接口：
+
+```text
+POST /api/dsh-power-menu-mac/shutdown
+POST /api/dsh-power-menu-mac/restart
+GET  /api/dsh-power-menu-mac/health
+GET  /api/dsh-power-menu-mac/plan
+```
+
+## 安全
+
+- 四个接口只接受回环地址（`127.0.0.1` / `::1`），校验 `Host` 必须是本机，拒绝 `sec-fetch-site: cross-site`，带 `Origin` 时必须与本机同源。
+- 没有鉴权令牌的第三方网页无法跨站触发关机/重启。
+- 只支持桌面版；`dsh web` 下接口返回 409，不会去杀别的进程。
+- 关机/重启时只清理**本应用自己的进程**（Electron 主进程的渲染/GPU/工具子进程）。宿主（`dsh` host）在 DSH 终端里被启动的其它子进程——第二个 `dsh web` 实例、dev server、构建任务——**默认不碰**；需要旧行为时设 `DSH_POWER_MENU_KILL_HOST_CHILDREN=1`。
+- 重启会沿用当前实例的启动参数（按 home 读取 `<DSH_HOME>/power-menu-relaunch-args.json`），所以用 `--user-data-dir` 启动的隔离 home 不会在重启后掉回默认 Electron profile。
+- 不收集任何数据，不联网；日志只写在本地 `~/.dsh/dsh-power-menu-mac/`。
+
+## 兼容性
+
+- **系统**：macOS。插件依赖 `ps` / `kill` / `lsappinfo`，Windows 和 Linux 未实现（`package.json` 里 `os: ["darwin"]`，装到别的系统上会直接拒绝）。
+- **DSH**：在 **DSH Desktop 0.2.1-rc.3** 上实测通过（2026-10-26）。
+- **Node**：跟随 DSH 自带的 Node（22+），无需单独安装。
+
+## 开发
+
+```text
+dsh-power-menu-mac/
+├── lib/
+│   ├── index.js        Host 半：四个回环接口 + 交接调度
+│   ├── client.js       浏览器半：window.__ModuleLoader__ bundle
+│   └── helper.cjs      分离的交接 helper
+├── install.sh          一键安装
+├── enable.sh           补 dsh.profile.bundles
+├── cordis.patch.yml    bundle 插入层
+├── package.json
+├── docs/screenshot.png
+└── README.md
+```
+
+- 客户端 bundle 不是普通 ESM，必须用 `window.__ModuleLoader__.load({ id, factory })` 格式；`dsh.client.inject` 声明 `@deepseek-ai/dsh-client-ui-slots`。
+- 没有构建步骤，也没有运行时 npm 依赖。
+- 提交前跑一次静态检查：
+
+  ```bash
+  npm run check
+  ```
+
+- 本地调试日志：`~/.dsh/dsh-power-menu-mac/power-menu.log` 和 `helper-*.log`。
+
+## 常见问题
+
+**按钮没出现？**
+确认插件处于「启用中」，并重启过一次 DSH；按钮只出现在有会话标题栏的页面。如果是在 Windows 上，按钮**本来就不该出现** —— 请用原版 [dsh-power-menu](https://github.com/xichen-62/dsh-power-menu)。
+
+**点了没反应 / 报 409？**
+`dsh web`（浏览器里的 Web 版）不支持，只支持桌面版。看 `~/.dsh/dsh-power-menu-mac/` 下的日志。
+
+**重启后端口变了？**
+正常。DSH Desktop 每次启动用随机端口（`--port 0`），插件只负责拉起新实例，不假设端口不变。
+
+**DSH 装在中文路径 / 用户名含中文能用吗？**
+可以。插件不拼 shell 字符串：启动用 `spawn(exe, [], { cwd })`，路径作为单个 argv 交给 Node 的 Unicode API；交接 JSON 和日志按 UTF-8 读写。helper 自带 `--pathtest`，会在「中文 + 空格」的临时目录里实测 UTF-8 读写和从中文路径启动脚本。
+
+**装完点按钮报 `HTTP 404`？**
+说明宿主半没加载：插件只在 `dependencies` 里，不在 `dsh.profile.bundles` 里。跑 `./enable.sh`，或手动把 `dsh-power-menu-mac` 加进 profile 的 `dsh.profile.bundles`，再重启 DSH。
+
+**为什么按钮不挂真实 slot？**
+DSH 的 `conversation.session.header.corner` 是单占用槽，已经被侧栏开关占用；`conversation.session.header.utilities` 会排在侧栏左侧；`sidebar.footer.action` 在左下角。要在不修改 DSH 的前提下保持右上角，只能把按钮挂进 `headerCorner` 的 DOM。代价是上游改头部结构时可能失效；插件用 `MutationObserver` 跟随，不轮询。
+
+**关闭/重启会跳过 profile 收尾吗？**
+会有一点：插件只结束 Electron 主进程，Host 会走 `application.shutdown`，但主进程的 `before-quit` 可能被跳过，Chromium 的 Cookie / Local Storage 不保证落盘。追求最干净的退出请用菜单栏的「退出」。真正的 `app.quit()` 需要 DSH 提供协作退出 IPC，插件单方面做不到。
+
+## 卸载
+
+- 插件管理器里移除 `dsh-power-menu-mac`，或者从 profile 的 `dependencies` / `dsh.profile.bundles` 里删掉，再删掉 `node_modules` 里的链接。
+- 可选：删除 `~/.dsh/dsh-power-menu-mac/` 下的日志与交接文件。
+- 重启 DSH 生效。
+
+## 更新日志
+
+见 [CHANGELOG.md](CHANGELOG.md)。
+
+## 许可证
+
+[MIT](LICENSE) © 2026 DDDMUC（macOS 移植）· © 2026 xichen-62（原版 dsh-power-menu）
+
+## 致谢
+
+- 原版 [xichen-62/dsh-power-menu](https://github.com/xichen-62/dsh-power-menu)（MIT）：整体结构、客户端界面、菜单交互、安全边界都来自它，本项目只是把宿主侧的进程操作换成了 POSIX 的做法。截图也沿用原版。
+- 分离 helper 做进程交接、只结束主进程让 Host 优雅退出的思路，原版参考了 [dsh-desktop-restart](https://github.com/luoshuizhiwei/dsh-desktop-restart)（MIT）。
+- 菜单样式参考 Windows 电源菜单；图标为内联 SVG，无第三方图标库。
+
+---
+
+## English
+
+A macOS port of [dsh-power-menu](https://github.com/xichen-62/dsh-power-menu) (MIT). Adds a power button to the top-right of the DSH Desktop session header with exactly two actions:
+
+- **关闭DSH** — quit the whole desktop app (no relaunch).
+- **重启DSH** — quit and relaunch the app, so the window comes back automatically.
+
+The Windows build drove `taskkill` and PowerShell; this one drives POSIX `ps` / `kill` / `lsappinfo`. The meaningful difference: a restart is only reported as successful once the new process has **registered with the macOS window server** (`lsappinfo find pid=…`) and survived its startup grace — "the process is still alive" is not accepted as proof, which is all the original could check on macOS.
+
+macOS only (`os: ["darwin"]`), DSH Desktop only. No telemetry, no external dependencies; the four HTTP routes are loopback-only and same-origin fenced.
+
+```bash
+git clone https://github.com/DDDMUC/dsh-power-menu-mac.git
+cd dsh-power-menu-mac
+./install.sh
+```
+
+Or add `github:DDDMUC/dsh-power-menu-mac` in the DSH plugin manager, then run `./enable.sh` and restart DSH.
+
+MIT licensed, retaining the original copyright.

package/cordis.patch.yml

@@ -0,0 +1,8 @@
+# dsh-power-menu-mac：bundle patch 层。
+# 安装到 profile 后，这一行把插件挂进组合配置。
+#
+# 和原版 `dsh-power-menu` 用的是不同的 id，两个包可以同时装在同一个 profile 里
+# 而不会互相覆盖 —— 但它们都会往会话头部挂一个电源按钮，所以实际上只应该启用一个。
+- insert:
+    - id: dsh-power-menu-mac
+      name: dsh-power-menu-mac

package/enable.sh

@@ -0,0 +1,125 @@
+#!/bin/sh
+# dsh-power-menu-mac 一键启用脚本（macOS）
+#
+# 用途：DSH 插件管理器安装后只写 dependencies，不一定会把插件加进
+# `dsh.profile.bundles`；少了这一条，宿主半不加载，点按钮就会 HTTP 404。
+# 这个脚本只做一件事：把 dsh-power-menu-mac 补进指定 profile 的 bundles，
+# 写之前备份 profile 的 package.json。
+#
+# 用法：
+#   ./enable.sh              # 默认 desktop profile
+#   ./enable.sh web          # 指定 profile
+#
+# 然后重启 DSH。
+#
+# 实现说明：原版（PowerShell）用正则往 JSON 文本里插一段字符串，只为了保留
+# 原文件排版。macOS 这边直接用 node 或 python3 解析再写回 —— 同样的 2 空格
+# 缩进，但不会因为格式差异把文件写坏。两个都没有时才退回文本插入。
+
+set -eu
+
+PROFILE="${1:-desktop}"
+PLUGIN="dsh-power-menu-mac"
+PKG="$HOME/.dsh/profiles/$PROFILE/package.json"
+
+if [ ! -f "$PKG" ]; then
+  echo "找不到 DSH profile 的 package.json：$PKG" >&2
+  echo "可用的 profile：" >&2
+  ls -1 "$HOME/.dsh/profiles" 2>/dev/null >&2 || echo "  （~/.dsh/profiles 不存在）" >&2
+  exit 1
+fi
+
+# 退出码 0 = 写好了，2 = 本来就有，1 = 失败。
+with_node() {
+  node - "$PKG" "$PLUGIN" <<'JS'
+const fs = require('node:fs')
+const [pkg, plugin] = process.argv.slice(2)
+const data = JSON.parse(fs.readFileSync(pkg, 'utf8'))
+data.dsh = data.dsh ?? {}
+data.dsh.profile = data.dsh.profile ?? {}
+const bundles = (data.dsh.profile.bundles = data.dsh.profile.bundles ?? [])
+if (bundles.includes(plugin)) process.exit(2)
+bundles.push(plugin)
+fs.copyFileSync(pkg, `${pkg}.bak-${plugin}`)
+fs.writeFileSync(pkg, `${JSON.stringify(data, null, 2)}\n`, 'utf8')
+JS
+}
+
+with_python() {
+  python3 - "$PKG" "$PLUGIN" <<'PY'
+import json, shutil, sys
+pkg, plugin = sys.argv[1], sys.argv[2]
+with open(pkg, encoding='utf-8') as fh:
+    data = json.load(fh)
+profile = data.setdefault('dsh', {}).setdefault('profile', {})
+bundles = profile.setdefault('bundles', [])
+if plugin in bundles:
+    sys.exit(2)
+bundles.append(plugin)
+shutil.copyfile(pkg, pkg + '.bak-' + plugin)
+with open(pkg, 'w', encoding='utf-8') as fh:
+    json.dump(data, fh, ensure_ascii=False, indent=2)
+    fh.write('\n')
+PY
+}
+
+# 兜底：纯文本插入。只在既没有 node 也没有 python3 时用。
+#
+# 必须先判断文件里到底有没有 bundles 这一项，再决定往哪儿插：逐行扫描时
+# `"profile": {` 出现在 `"bundles"` 之前，如果边扫边插就会先插出一个重复的
+# bundles 键 —— JSON 解析取最后一个，于是新加的那条被静默丢掉。
+with_sed() {
+  if grep -q "\"$PLUGIN\"" "$PKG"; then return 2; fi
+  cp "$PKG" "$PKG.bak-$PLUGIN"
+  if grep -q '"bundles"' "$PKG"; then
+    awk -v plugin="$PLUGIN" '
+      BEGIN { done = 0 }
+      {
+        if (!done && match($0, /"bundles"[[:space:]]*:[[:space:]]*\[[[:space:]]*\]/)) {
+          sub(/\[[[:space:]]*\]/, "[\"" plugin "\"]")
+          print; done = 1; next
+        }
+        if (!done && match($0, /"bundles"[[:space:]]*:[[:space:]]*\[/)) {
+          print; print "      \"" plugin "\","; done = 1; next
+        }
+        print
+      }
+    ' "$PKG" > "$PKG.tmp" && mv "$PKG.tmp" "$PKG"
+  else
+    awk -v plugin="$PLUGIN" '
+      BEGIN { done = 0 }
+      {
+        print
+        if (!done && match($0, /"profile"[[:space:]]*:[[:space:]]*\{/)) {
+          print "      \"bundles\": [\"" plugin "\"],"; done = 1
+        }
+      }
+    ' "$PKG" > "$PKG.tmp" && mv "$PKG.tmp" "$PKG"
+  fi
+}
+
+status=1
+if command -v node >/dev/null 2>&1; then
+  set +e; with_node; status=$?; set -e
+elif command -v python3 >/dev/null 2>&1; then
+  set +e; with_python; status=$?; set -e
+else
+  echo "[$PLUGIN] 没找到 node 或 python3，改用文本插入（请检查结果）。"
+  set +e; with_sed; status=$?; set -e
+fi
+
+case "$status" in
+  0)
+    echo "[$PLUGIN] 已加入 dsh.profile.bundles。"
+    echo "原文件备份：$PKG.bak-$PLUGIN"
+    echo "请重启 DSH 让宿主半加载。"
+    ;;
+  2)
+    echo "[$PLUGIN] 已经在 dsh.profile.bundles 里。"
+    echo "如果按钮仍然 404，请确认 dependencies 里有 ${PLUGIN}，并重启 DSH。"
+    ;;
+  *)
+    echo "[$PLUGIN] 写入失败。请手动把 \"$PLUGIN\" 加进 $PKG 的 dsh.profile.bundles。" >&2
+    exit 1
+    ;;
+esac

package/install.sh

@@ -0,0 +1,180 @@
+#!/bin/sh
+# dsh-power-menu-mac 一键安装脚本（macOS）
+#
+# 把 dsh-power-menu-mac 装进 DSH Desktop 的 profile，并补齐
+# `dsh.profile.bundles`，让宿主半在重启后真正加载。
+#
+# 安装方式（默认自动选择）：
+#   - 机器上有 git：用 `github:DDDMUC/dsh-power-menu-mac`（pnpm 的 git 依赖）
+#   - 没有 git，或 --tarball：下载 GitHub Release 里的 .tgz，再用本地文件安装，
+#     全程不调用 git
+#
+# 用法：
+#   ./install.sh
+#   ./install.sh --profile desktop
+#   ./install.sh --tarball                 # 强制走 tgz
+#   ./install.sh --tgz ./dsh-power-menu-mac-0.1.0.tgz   # 完全离线
+#   ./install.sh --sha256 <hash>           # 手动指定安装包 SHA-256
+#   ./install.sh --mirror                  # GitHub 直连不通时改走 gh-proxy
+#   ./install.sh --version 0.1.0           # 指定要下载的 Release 版本
+#
+# 装完请重启 DSH Desktop。
+#
+# 和原版（Windows）的区别：这里不需要 MinGit、不需要改 PATH、不需要处理
+# junction —— macOS 自带 /usr/bin/git（Xcode CLT），link 安装就是普通符号链接。
+# 真正的坑只有一个：dsh 不在 PATH 上，它在 .app 包里。
+
+set -eu
+
+PROFILE=desktop
+VERSION=0.1.0
+REPO=DDDMUC/dsh-power-menu-mac
+PLUGIN=dsh-power-menu-mac
+MODE=auto
+MIRROR=0
+TGZ_PATH=
+SHA256=
+SCRIPT_DIR=$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)
+
+usage() {
+  sed -n '2,28p' "$0" | sed 's/^# \{0,1\}//'
+}
+
+while [ $# -gt 0 ]; do
+  case "$1" in
+    --profile) PROFILE="${2:?--profile 需要参数}"; shift 2 ;;
+    --version) VERSION="${2:?--version 需要参数}"; shift 2 ;;
+    --tgz)     TGZ_PATH="${2:?--tgz 需要参数}"; MODE=tarball; shift 2 ;;
+    --sha256)  SHA256="${2:?--sha256 需要参数}"; shift 2 ;;
+    --git)     MODE=git; shift ;;
+    --tarball) MODE=tarball; shift ;;
+    --mirror)  MIRROR=1; shift ;;
+    -h|--help) usage; exit 0 ;;
+    *) echo "未知参数：$1（--help 看用法）" >&2; exit 1 ;;
+  esac
+done
+
+say() { printf '[%s] %s\n' "$PLUGIN" "$*"; }
+warn() { printf '[%s] %s\n' "$PLUGIN" "$*" >&2; }
+
+# ---------------------------------------------------------------- dsh 命令行
+find_dsh() {
+  if command -v dsh >/dev/null 2>&1; then
+    command -v dsh
+    return 0
+  fi
+  for candidate in \
+    "/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
+    "$HOME/Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh" \
+    "/Applications/DeepSeekHarness.app/Contents/Resources/runtime/cli/bin/dsh"
+  do
+    if [ -x "$candidate" ]; then
+      printf '%s\n' "$candidate"
+      return 0
+    fi
+  done
+  return 1
+}
+
+DSH=$(find_dsh) || {
+  warn "没找到 dsh 命令行。"
+  warn "它通常在 /Applications/DeepSeek Harness.app/Contents/Resources/runtime/cli/bin/dsh"
+  warn "装上 DSH Desktop 后再跑一次，或用下面的命令手动安装："
+  warn "  <dsh> plugin --profile $PROFILE add github:$REPO"
+  exit 1
+}
+say "dsh: $DSH"
+
+# ---------------------------------------------------------------- SHA-256
+sha256_of() {
+  shasum -a 256 "$1" | awk '{print $1}'
+}
+
+verify_sha256() {
+  file=$1
+  expected=$(printf '%s' "$SHA256" | tr '[:upper:]' '[:lower:]' | sed 's/^sha256://')
+  if [ -z "$expected" ]; then
+    # 没有显式给 hash：尝试 Release 里的 SHA256SUMS.txt。取不到只是警告，
+    # 不静默通过 —— 用户能从这条输出里看到"这次没校验"。
+    sums=$(mktemp -t dsh-power-menu-mac-sums)
+    url=$(release_url SHA256SUMS.txt)
+    if curl -fsSL "$url" -o "$sums" 2>/dev/null; then
+      expected=$(awk -v f="dsh-power-menu-mac-$VERSION.tgz" '$2 == f || $2 == "*"f { print $1; exit }' "$sums" | tr '[:upper:]' '[:lower:]')
+    fi
+    rm -f "$sums"
+    if [ -z "$expected" ]; then
+      warn "没有取到 SHA256SUMS.txt，跳过自动校验；可用 --sha256 手动指定。"
+      return 0
+    fi
+  fi
+  actual=$(sha256_of "$file")
+  if [ "$actual" != "$expected" ]; then
+    rm -f "$file"
+    warn "SHA-256 不匹配：期望 ${expected}，实际 ${actual}。安装包已删除。"
+    exit 1
+  fi
+  say "SHA-256 校验通过。"
+}
+
+# ---------------------------------------------------------------- 下载地址
+release_url() {
+  name=$1
+  base="https://github.com/$REPO/releases/download/v$VERSION/$name"
+  if [ "$MIRROR" = "1" ]; then
+    printf 'https://gh-proxy.com/%s\n' "$base"
+  else
+    printf '%s\n' "$base"
+  fi
+}
+
+# ---------------------------------------------------------------- 安装
+install_from_git() {
+  say "用 git 依赖安装：github:$REPO"
+  "$DSH" plugin --profile "$PROFILE" add "github:$REPO"
+}
+
+install_from_tarball() {
+  if [ -n "$TGZ_PATH" ]; then
+    file=$TGZ_PATH
+    [ -f "$file" ] || { warn "找不到安装包：$file"; exit 1; }
+    say "用本地安装包：$file"
+  else
+    file=$(mktemp -t "$PLUGIN-$VERSION")
+    file="$file.tgz"
+    url=$(release_url "dsh-power-menu-mac-$VERSION.tgz")
+    say "下载 $url"
+    curl -fL --retry 2 --connect-timeout 15 "$url" -o "$file" || {
+      warn "下载失败。GitHub 直连不通时可以加 --mirror，或手动下载后用 --tgz 指定。"
+      exit 1
+    }
+  fi
+  verify_sha256 "$file"
+  "$DSH" plugin --profile "$PROFILE" add "$file"
+}
+
+case "$MODE" in
+  git) install_from_git ;;
+  tarball) install_from_tarball ;;
+  auto)
+    if command -v git >/dev/null 2>&1; then
+      install_from_git || {
+        warn "git 方式失败，改用 tgz 重试。"
+        install_from_tarball
+      }
+    else
+      install_from_tarball
+    fi
+    ;;
+esac
+
+# ---------------------------------------------------------------- 补 bundles
+# 插件管理器只写 dependencies，不写 dsh.profile.bundles；少了这一步，宿主半
+# 不加载，点按钮就是 HTTP 404。这一步和 enable.sh 是同一件事。
+if [ -x "$SCRIPT_DIR/enable.sh" ]; then
+  "$SCRIPT_DIR/enable.sh" "$PROFILE"
+else
+  warn "没找到 enable.sh，请手动把 \"$PLUGIN\" 加进 profile 的 dsh.profile.bundles。"
+  warn "profile: $HOME/.dsh/profiles/$PROFILE/package.json"
+fi
+
+say "完成。请重启 DSH Desktop。"