dsh-mysql
DeepSeek Harness 的 MySQL 连接插件。在 DSH 设置页配置多套 MySQL 连接,在输入栏一键切换当前会话的连接,并把 MySQL 工具全局提供给所有 Agent 预设——无需修改任何预设。
功能
- 设置页(
设置 → MySQL 数据库):增 / 删 / 改 / 测试连接——主机、端口、账号、密码、默认库,每连接可配可读表白名单与写权限(默认关闭)。 - 输入栏按钮(🐬,输入框左侧):为当前会话选择连接,随时切换;选中的连接与其可读表会注入每轮的运行时上下文快照(追加在对话末尾,切换连接或编辑配置不会改写用于上下文缓存的稳定系统提示词前缀),模型天然知道当前该查哪个库。
- 全局工具(所有 Agent 预设下都可用):
| 工具 | 用途 |
|---|---|
mysql_query | 对选中连接执行只读单语句 SELECT/SHOW/DESCRIBE/EXPLAIN。强制表白名单、拒绝多语句、SELECT 自动注入 MAX_EXECUTION_TIME 提示、最多返回 2000 行并带 truncated 标记。 |
mysql_tables | 通过 information_schema 查看可读表结构(列、类型、键、注释)。 |
mysql_execute | 仅 INSERT/UPDATE/DELETE,且仅当连接开启允许写操作时可用(默认关)。DDL(DROP/TRUNCATE/ALTER 等)与多语句一律拒绝。 |
- 会话级选择通过工具执行上下文(
exec.agent)解析,模型永远查询用户在输入栏选中的那个库。 - 连接信息保存在本机
$DSH_HOME/storages/dsh-mysql/connections.json;密码只落本地文件,绝不回传给浏览器(界面只看到hasPassword)。
安装
# 从 GitHub 安装(发布后推荐)
dsh plugin --profile web add github:1321928757/dsh-mysql#v0.1.4
# 或本地 tgz 安装
pnpm pack
dsh plugin --profile web add C:\path\to\dsh-mysql-0.1.4.tgz然后重启 dsh web(确认旧进程真的退出)。重启后打开 设置 → MySQL 数据库,添加连接并点「测试连接」。
快速上手
1. 打开 设置 → MySQL 数据库 → + 添加连接,填写主机 / 端口 / 账号 / 密码 / 默认库,可选填可读表白名单(逗号分隔),决定是否开启写权限;点「测试连接」通过后「保存」。 2. 在任意会话中,点击输入框左侧的 🐬 按钮,选择一个连接(仅当前会话生效)。 3. 直接向 Agent 提问数据库相关的问题——它会先用 mysql_tables 看结构、再用 mysql_query 查数据;连接开启写权限后,mysql_execute 可执行 INSERT/UPDATE/DELETE。
安全模型
- 工具层拦截,纵深防御。生产环境建议同时为 Agent 创建权限最小化的专用 MySQL 账号(理想情况只有
SELECT)。 mysql_query只接受单条SELECT/SHOW/DESCRIBE/EXPLAIN;mysql_execute只接受单条INSERT/UPDATE/DELETE且要求连接显式开启allowWrite。- 表白名单:连接配置了表列表后,所有语句都会校验,引用白名单外的表即拒绝(留空 = 不限制,可读全部表)。
SELECT自动注入MAX_EXECUTION_TIME(15000)优化器提示;结果集封顶 2000 行。- 密码明文保存在本机
$DSH_HOME/storages/dsh-mysql/connections.json,请用文件权限 / 专用系统账号保护。
从「预设内嵌 mysql 工具」迁移
如果你的预设此前内嵌了 mysql_query/mysql_execute(例如一行加载本地 mysql-tool.mjs):
1. 把本插件装进 profile; 2. 从预设的 agent.cordis.yml 中删除 mysql 工具行与连接配置(保留业务 persona 文案); 3. 重启 dsh web,再到 设置 → MySQL 数据库 重建连接。工具名完全一致,预设提示词里提到 mysql_query 的内容无需改动。
开发
node --check lib\index.js lib\shared.js lib\typert.host.js lib\client.js
node test\shared.test.mjs
pnpm pack
dsh plugin --profile web add .\dsh-mysql-0.1.4.tgz
# 重启 dsh web,浏览器验收License
MIT