dsh-stool-plugin
DSH 运维工具箱插件。将 stool 运维 CLI 的全部能力注册为 DSH 模型可调用的工具，无需手动操作即可让 Agent 自动执行服务器管理、日志搜索、数据库查询、CI/CD 部署等操作。
安装
dsh plugin --profile web add github:fufengyuan/dsh-stool-plugin
然后重启 dsh web：
```bash
launchctl kickstart -k gui/501/com.duormi.dsh-web
提供的工具
12 个工具覆盖 stool CLI v7.x 的全部命令面（stool <模块> --help 为准）：
| 工具 | action | 说明 |
|---|---|---|
stool_server |
list / test / exec / exec-batch / health / diagnose / read / ls / download / upload / mkdir / rm / java-ps / java-restart | 服务器管理。exec-batch 按行批量执行脚本；upload 需同时给 path(本地) 与 remotePath(远程目标)；java-restart 只停不拉起 |
stool_db |
list / query / databases / tables / structure / data / redis | 数据库与 Redis。query 走 -d ，写操作在审批连接上被拦；redis 用 redisCommand 指定子命令（keys/get/set/type/ttl/h-/l-/s-* 共 13 个） |
stool_log |
list / search / tail / context / add / delete | 日志查询。翻历史必须给 date 或 days（互斥）；context 按行号看上下文 |
stool_cicd |
list / status / deploy / history / step-logs / rollback / cancel / modules / logs / tools | CI/CD。deploy 支持 stream/watch/branch；tools 检测构建工具与 SDK 版本 |
stool_mfa |
list / code / codes / add / delete / parse-uri | 双因子认证码。codes 批量取全部验证码 |
stool_git |
list / status / log / branches / pull / push / commit / checkout | Git 仓库操作 |
stool_todo |
list / add / complete / uncomplete / delete / show / edit / search / stats / clear | 待办任务。截止日期是 due，标签是 tag（单数） |
stool_note |
list / add / update / delete / groups / add-group / update-group / delete-group | 笔记管理。没有独立 search 子命令，用 list + keyword；分组用 groupId |
stool_project |
list / add / show / update / delete / stats / todos | 项目管理 |
stool_subtask |
list / add / complete / delete | 待办子任务 |
stool_nginx |
list / add / update / delete / fetch / test / deploy / versions | Nginx 配置预设与部署 |
stool_misc |
accounting / trend / weekly / weeklyShow / weeklySave / audit | 记账统计、周报、操作审计 |
参数名与 CLI 的对应关系
工具层做了参数归一（serverId/command/script…），落到 CLI 时按各子命令的真实 flag 拼装。几个容易踩的点：
stool_todo：add 用-d/--due+-t/--tag；但 edit 里-t是--text，标签必须用-g/--tag。stool_log：search/tail 的行数 flag 是-l，没有--context这个参数（上下文要用 context 动作按行号查）。stool_db redis：不接受--json，且子命令必须白名单化（早期版本直接把整串命令按空格拆开传，会撞 clap 报 exit 2）。stool_server upload：需要三个位置参数。
设置页
设置 → 插件 → 🧰 Stool 运维工具箱 卡片会自动检测本机是否已安装 stool：
- 已安装：显示可执行文件路径与
stool version版本号，不再展示下载引导； - 未安装：显示 SuperTool 仓库链接与下载说明；
- 取不到结果（接口不可用等）：标记为「状态未知」并保守保留下载引导。
检测由 Host 侧完成（浏览器不能起进程），卡片通过只读接口 GET /stool/status 获取结果：仅应答同源回环请求，返回 { installed, path, version, checkedAt }，结果缓存 30 秒，?refresh=1 强制重新探测。卡片折叠时头部也有状态角标，收起再展开即触发一次重新检测。
目录结构
dsh-stool-plugin/
├── package.json # 包配置
├── cordis.patch.yml # Cordis 插件注册行
├── .gitignore
├── README.md
├── lib/
│ ├── index.js # Host 端：12 个工具注册 + stool 探测接口 /stool/status
│ └── client.js # Client 端：设置页面卡片（自动检测 stool）
└── node_modules/
└── @deepseek-ai/
└── dsh-tools # peerDependency 符号链接
依赖
@deepseek-ai/cordis^4.0.1（peer）@deepseek-ai/dsh-tools^0.1.0-rc.6（peer）stoolCLI（需在宿主机上安装；除 PATH 外还会扫/usr/local/bin、/opt/homebrew/bin、~/.local/bin等常见目录，因为 launchd 拉起的 dsh web 进程 PATH 往往不全）
从源码构建
cd ~/.dsh/plugin-src/dsh-stool-plugin
npm install # 安装 peerDependencies
# 或
ln -sf /path/to/dsh-tools node_modules/@deepseek-ai/dsh-tools
License
MIT
