@cloudfan-cyf/dsh-plugin-control

Readme

# dsh-plugin-control

DSH Web GUI 插件控制中心：以卡片列表聚合展示当前 profile 已安装插件，显示名称、版本与简介，并提供在线启用/停用开关。

## 功能

- 设置页新增一级区块「插件控制」。
- 卡片展示每个 Loader 插件条目：名称、版本、简介、启用状态。
- 支持搜索与「仅显示已安装插件」过滤。
- 在线开关直接写入 profile 层 `cordis.patch.yml`，由 DSH 现有 HMR watcher 热生效，无需手动重启。
- 设置感知开关：对通过自身设置项控制界面的插件（如 dsh-pet），停用会写它的设置开关（`pet.enabled`），宠物会真正消失而不是变成不可交互的“僵尸”。
- 核心基础设施条目与本插件自身不可关闭，避免误操作。

## 安装

### 从 GitHub 仓库安装

```sh
dsh plugin --profile web add https://github.com/CloudFan-cyf/dsh-plugin-control
```

### 本地开发安装

```sh
git clone https://github.com/CloudFan-cyf/dsh-plugin-control
cd dsh-plugin-control
pnpm install
pnpm build

# 在仓库父目录执行，link 安装到 web profile
dsh plugin --profile web add link:./dsh-plugin-control
```

> Windows 下如果仓库路径包含空格，`dsh plugin` 的 shell 转发可能把 `link:` 参数拆开。可先创建无空格 junction：
>
> ```sh
> powershell -NoProfile -Command "New-Item -ItemType Junction -Path 'C:\dsh-plugin-control-dev' -Target 'D:\Github projects\dsh-dev\dsh-plugin-control' | Out-Null"
> dsh plugin --profile web add link:C:/dsh-plugin-control-dev
> ```

> 首次安装后需要重启 `dsh web` 才会加载新 bundle；后续开关操作依赖 HMR，不需要重启。

## 使用

1. 重启 `dsh web` 后打开 设置 → 插件控制。
2. 卡片显示插件名称、版本、简介与启用状态。
3. 点击开关即可启用/停用插件；状态写入 `~/.dsh/profiles/web/cordis.patch.yml`（设置感知插件同时写入对应 `settings.yaml` 分节，如 `pet.enabled`）。

## 工作原理

- 列表来自 `ctx.loader.entries()`。
- 版本与简介读取 `<profileDir>/node_modules/<pkg>/package.json` 与 `$DSH_HOME/profiles/node_modules/<pkg>/package.json`。
- 切换写 profile 层 patch，并由现有 `watchUserPatches` 热重载。
- 对「设置感知」插件（见 `src/settings-switches.js`），开关改为写插件的 settings namespace 字段（如 `pet.enabled`），并保持 Loader 挂载以保证设置能生效。

## 安全

- API 仅允许 loopback + 同源请求，路径前缀 `/api/dsh-plugin-control`。
- 首次改写 patch 文件前会备份为 `cordis.patch.yml.dsh-plugin-control.bak`。

## 已知限制

- 只管理 profile 层 `cordis.patch.yml`；若 home 层 `~/.dsh/cordis.patch.yml` 存在同名补丁，需要用户自行处理。
- 改写 patch 文件时可能规范化 YAML 注释（语义保留，注释可能丢失）。

## Superpowers 技能集

本仓库把 [obra/superpowers](https://github.com/obra/superpowers) v6.3.0（MIT）的技能包直接 vendor 进 `.dsh/skills/`，这是 DSH 的项目级技能目录（`<project>/.dsh/skills/<name>/SKILL.md`）。当 DSH 在本项目目录下工作时，会自动加载以下 14 个技能，无需额外安装：

- `using-superpowers`（入口：要求在任何回复前先检查并调用相关技能）
- `brainstorming` / `writing-plans` / `executing-plans` / `subagent-driven-development`
- `test-driven-development` / `systematic-debugging` / `verification-before-completion`
- `dispatching-parallel-agents` / `using-git-worktrees`
- `requesting-code-review` / `receiving-code-review` / `finishing-a-development-branch`
- `writing-skills`

更新方式：从本地 Codex 缓存（或上游 Git 仓库）重新复制：

```sh
SRC=~/.codex/plugins/cache/openai-curated-remote/superpowers/6.3.0
DST=.dsh/skills
mkdir -p "$DST" && cp -r "$SRC/skills/." "$DST/" && cp "$SRC/LICENSE" "$DST/LICENSE"
```

> 注意：`.dsh/skills/` 根目录下不要放置无 frontmatter 的裸 `.md` 文件，DSH 会把它们当作 flat skill 解析并告警忽略。

## 开发

```sh
pnpm install
pnpm build
pnpm test
```

- 源码在 `src/`，构建产物在 `lib/`（提交到 Git）。
- `lib/client.js` 由 `scripts/build.mjs` 生成，必须符合 `window.__ModuleLoader__.load` 格式。