fufengyuan/dsh-stool-plugin

DSH 运维工具箱插件。将 stool 运维 CLI 的全部能力注册为 DSH 模型可调用的工具,无需手动操作即可让 Agent 自动执行服务器管理、日志搜索、数据库查询、CI/CD 部署等操作。

Project Overview项目介绍

dsh-stool-plugin is a DSH operations toolbox plugin that registers all stool CLI capabilities as model-callable tools, covering 9 operation areas: server, database, logs, CI/CD, MFA, Git, notes, and todos, enabling the Agent to automatically perform ops tasks without manual intervention. Use it when you want DSH to directly handle routine operations and release workflows. Note: the host must have the stool CLI pre-installed and accessible to the DSH web process.

dsh-stool-plugin 是 DSH 的运维工具箱插件,把 stool CLI 的全部能力注册为模型可调用的工具,覆盖服务器、数据库、日志、CI/CD、MFA、Git、笔记、待办等 9 类操作,让 Agent 无需手动介入即可自动执行运维任务。适用于需要让 DSH 直接处理日常运维与发布流程的场景。前提是宿主机需预先安装 stool CLI,并保证 DSH web 进程能定位到该可执行文件。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:fufengyuan/dsh-stool-plugin

fufengyuan/dsh-stool-plugin 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

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

提供的工具

工具 操作 说明
stool_server list / exec / health / diagnose / read / ls / java-ps 服务器管理
stool_db list / query / redis 数据库管理
stool_log list / search / tail 日志搜索与查看
stool_cicd list / deploy / history CI/CD 部署管理
stool_mfa list / code 双因子认证码
stool_git status / log / branches / pull / push Git 仓库操作
stool_note list / add / search 笔记管理
stool_todo list / add / complete / stats 待办任务
stool_misc accounting / weekly / audit / project / nginx 其他工具

设置页

设置 → 插件 → 🧰 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 端:9 个工具注册 + 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)
  • stool CLI(需在宿主机上安装;除 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

上一个 Prev EmotionPet 下一个 Next dsh-notify-win