dsh-pi-kit

中文 | English

DSH 轻量优化插件合集：目前包含 自动审核 + 提示音 两个小插件；日常使用零感知，危险操作和等待事件不再错过。

插件清单

插件	解决什么问题
自动审核	工具执行前自动拦截危险命令、放行安全操作、拿不准的交你确认（轻量模型审核，复用 DSH 凭据）
提示音	审批、询问、后台任务完成时用不同声音提醒，后台作业完成调用系统通知

安装

一键安装（推荐）：

dsh plugin --profile web add dsh-pi-kit

dsh 自动完成依赖安装与挂载（读取本包的 dsh.bundle.patch，无需手写任何 patch），重启 DSH 生效。

web 是内置 Web GUI profile 名；使用其他 profile 时换成对应名字（~/.dsh/profiles/ 下的目录名）。

dsh plugin 内部调用 pnpm 完成安装；若提示 pnpm not found，先 npm install -g pnpm 再重试。

手动安装（等价的 profile package.json 写法）：

{
  "dependencies": { "dsh-pi-kit": "^0.1.0" },
  "dsh": { "profile": { "bundles": ["dsh-pi-kit"] } }
}

单装：dsh plugin --profile web add dsh-auto-reviewer（或另两个包）；未装设置壳时，设置自动以独立卡片形态出现。

单插件控制：聚合安装后在 patch 层追加 - id: <插件 id> disabled: true 即可停用某个成员。

严格布局注意：profile 使用 pnpm 隔离（isolated）布局时，成员包会被收进嵌套目录，dsh web 启动可能报 Cannot find package 'dsh-auto-reviewer'。在 profile 的 pnpm-workspace.yaml 加 nodeLinker: hoisted 后重新安装即可。

验证与卸载

# 验证插件行已挂载
dsh --profile web --dump-config

# 卸载（重启 dsh web 生效）
dsh plugin --profile web remove dsh-pi-kit

从 GitHub 仓库安装（改代码调试）

git clone https://github.com/Pidreamleaves/dsh-pi-kit.git
cd dsh-pi-kit
pnpm install
pnpm -r build

# 把三个成员包分别链接进 web profile（各自声明 dsh.bundle，自动挂载）
dsh plugin --profile web add link:<绝对路径>/dsh-pi-kit/packages/auto-review
dsh plugin --profile web add link:<绝对路径>/dsh-pi-kit/packages/approval-chime
dsh plugin --profile web add link:<绝对路径>/dsh-pi-kit/packages/pi-kit-settings

重启 dsh web 生效；改代码后 pnpm -r build 并重启即可。

使用

• 设置：「设置 → 插件 → 插件配置 → dsh-pi-kit」，持久化存储
• 自动审核：默认启用（审核模型 deepseek-v4-flash）；策略文件 ~/.dsh/auto-review.yml 首次启动自动生成带注释模板，按示例改即可；审核结果在对话 turn 末尾以彩色徽章汇总（放行绿 / 拦截红 / 提权蓝，点「明细」看每条理由）
• 提示音：默认启用；完成音默认只提醒后台会话，可在设置中改为所有会话；三种音色均可试听

详见各插件页：packages/auto-review · packages/approval-chime · packages/pi-kit-settings

仓库结构

dsh-pi-kit/
  cordis.patch.yml      # bundle patch：一次挂载全部成员
  package.json          # bundle 根：依赖全部成员
  packages/
    auto-review/        # 自动审核门卫（Host）
    approval-chime/     # 提示音/通知（Client，Host 半边持 settings 域）
    pi-kit-settings/    # 聚合设置卡壳（Client）

License

MIT