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原生客戶端。