DeepSeek Harness (dsh) 生态支持插件化扩展。本地数据库管理(DBA)是高频需求。dsh-local-dba 插件提供了一组 db_* 工具,支持对 MySQL / MariaDB 和 PostgreSQL 进行查询、Schema 检查、备份恢复和慢查询分析。
该插件以 Cordis 插件包形式分发,注册了一组面向模型的工具。它不依赖构建工具,纯 JavaScript (ESM) 实现,安装即用。
核心功能¶
- 8 个
db_*工具:涵盖查询、Schema、健康检查、备份、恢复和慢查询分析。 - UI 配置:插件自带设置卡片,支持在 Harness 界面中增删连接并设置默认连接,无需编辑文件,保存后立即生效。
- 主流数据库:支持 MySQL / MariaDB 和 PostgreSQL。
- 安全默认:写操作和备份/恢复开关默认关闭,
db_query严格限制为只读。
安装¶
在本地环境执行以下命令:
git clone https://github.com/kichare/dsh-local-dba.git
dsh plugin --profile web add ./dsh-local-dba
典型用法¶
无需记忆工具名称,直接通过自然语言描述需求即可:
- 健康检查:检查数据库健康状态,列出数据库及其大小。
- Schema:列出指定数据库的所有表,查看表的列和索引结构。
- 查询:展示最新的数据行,按用户分组统计订单数量。
- 变更(需开启写权限):添加唯一索引,更新订单状态。
- 备份/恢复:将数据库导出至备份目录,从备份文件恢复数据库。
- 诊断:查看当前的慢查询列表。
注意事项与依赖¶
- 密码管理:建议使用
passwordEnv环境变量配置密码,避免明文存储。 - 权限控制:写操作(
allowWrite)和备份/恢复(allowBackupRestore)默认关闭。开启allowWrite后,Agent 可执行 DDL/DML,这些操作不可逆。开启allowBackupRestore后,恢复操作会覆盖同名对象,需谨慎使用。 - 只读限制:
db_query工具仅接受SELECT/SHOW/DESCRIBE/EXPLAIN/WITH开头的语句。 - 环境依赖:
- 需要 Node.js 24 和 pnpm。
- 备份/恢复功能需要系统安装
mysqldump/mysql和pg_dump/psql原生客户端。