DSH效率插件与本地技能库

项目背景

这是针对高强度开发场景整理的 DSH 效率插件部署记录。目标是让 AI 在运维、网页验证、终端操作、消息接入和成本监控上少走弯路。

已启用的能力包括：本地技能库，内含 7 个运维 runbook，放在 /root/.dsh/skills/，任务匹配时自动加载，无需重启；Playwright 浏览器自动化 MCP，AI 可直接导航、截图、读取控制台；第二波启用的 archify-dsh、dsh-im、dsh-tty；第三波安装的 7 个高星插件，覆盖余额挂件、全局搜索、Docker 面板、Context 仪表盘、费用账本和本地记忆。

它主要解决几类问题：避免用 curl 猜 DOM、减少重复踩运维坑、打通终端与 IM、让成本和上下文更透明。现状是插件均 applied、warnings=[]，配置 dump 通过；微信绑定和部分面板仍需用户刷新或扫码确认。不兼容的插件已记录跳过，没有强行安装。

功能

• 本地技能库：7 个运维 runbook 自动加载，新增技能即时生效
• Playwright MCP：无头 Chromium 导航、快照、截图、读取控制台
• 终端与架构图：dsh-tty 提供 tty_* 工具，archify 输出可交互架构图
• IM 接入：dsh-im 支持微信、企业微信等 13 个渠道
• 效率面板：全局搜索、Docker 容器、Context 仪表盘、费用账本、余额挂件
• 可回滚：bundle 级启停与文件清理，便于逐项撤销

技术栈

使用 / 部署教程

部署与使用教程

1. 环境检查

确认 DSH 版本为 0.2.1-alpha.1。Playwright 要求 Node ≥20，资料中 /usr/bin/node 是 18.19.1，需改用 /opt/node24/bin/node。预留约 700MB 磁盘和 130MB 内存。

2. 安装本地技能库

在 /root/.dsh/skills/<name>/SKILL.md 写入 runbook 内容。写入后 skill catalog 即时出现，无需重启；不要在技能文件里写密钥。

3. 启用 Playwright MCP

bundle 位于 /root/dsh-plugins/dsh-playwright-mcp，Playwright 在 /opt/mcp/playwright，Chromium 在 /root/.cache/ms-playwright。把 patch 里的 command 改成 /opt/node24/bin/node，再用 plugin_manager action=set_bundle target=@local/dsh-playwright-mcp enabled=true 启用。验证可运行 /opt/mcp/playwright/test.mjs 打开站点、截图，并用 listTools 检查 mcp__playwright__browser_*。

4. 安装第二、三波插件

用 install_bundle 安装，遇到原生构建被 pnpm 拦截时带 approvedBuilds 批准；若出现 pnpm 超时，再执行一次 install_bundle 复用缓存。dsh-ssh 因 peer 版本不兼容，改用 dsh-tty。所有 bundle 级插件用 set_bundle 启停，不要用 set_plugin。

5. 微信绑定

进入 DSH Web 的「设置 → IM机器人」，选择微信并扫码绑定。将机器人默认工作区设为 /nas/dsh-migration/workspaces/C-Windows，把私聊绑定到指定 DSH 会话。微信里发 /status 查看状态，不生效时发 /session <session-id> 手动重绑。

6. 验证与回滚

执行 dsh --profile web --dump-config 检查配置，确认日志无 error。回滚单插件用 plugin_manager action=set_bundle target=<包名> enabled=false；彻底清理可删除对应 bundle、MCP 和 Chromium 目录；停用技能删除对应技能目录即可。

常见问题