CloudFan-cyf / dsh-plugin-control

dsh-plugin-control

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

功能

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

安装

从 GitHub 仓库安装

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

本地开发安装

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：

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 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 仓库）重新复制：

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 解析并告警忽略。

开发

pnpm install
pnpm build
pnpm test

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