db-connector

在 DeepSeek Harness（dsh）框架中，agent 直接触碰数据库时往往缺乏安全边界——写入无审批、注入无防护、查询无时限、操作不可追溯。db-connector 正是为此而生：它将 SQLite、PostgreSQL、MySQL 三种引擎封装为五个模型可调用工具，让 agent 在严格策略下访问结构化数据，无需自行搭建连接管理、事务控制或审计管道。

核心设计围绕只读优先、写入需显式审批、全链路审计展开。db_query 仅放行 SELECT 类语句，任何写操作在触及驱动之前即被拒绝；db_exec 要求 allowWrite 确认，在事务中执行、失败自动回滚；db_schema 提供带 TTL 缓存的结构内省（表、列、索引、外键）；db_audit 将每次调用（含被拒与失败）追加为一条 JSONL 记录。参数始终绑定、凭据只按名称引用且绝不写入日志，从源头削减注入与泄露面。

适合在 dsh 中构建需要实时读取或有限写入数据库的 agent 工作流——例如报表生成、数据巡检、运维排障。如果你希望模型在受控边界内与三种主流数据库协作，而无需从零实现驱动管理、事务隔离和安全审计，db-connector 提供了开箱即用的安全默认值与清晰的工具契约。