dsh-db-tool
DSH 社区插件：通过聊天操作的多数据库管理工具，支持侧边栏管理、项目范围授权、ro/rw 模式和危险操作确认
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-db-tool@0.1.7Db Tool 以 dsh-db-tool 发布，当前版本为 0.1.7。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 社区插件：在聊天中安全操作数据库，配套侧边栏管理台与 db-admin skill。架构与交互模式对齐 dsh-ssh-tunnel。
list_connections / query / execute / schema / preview / run_scriptgrants.json：projectPathKey → 连接 → 模式）；未授权项目一律拒绝NEEDS_CONFIRMATION，对话内（模型经 ask）或 SQL 控制台（弹窗）确认后携一次性 challengeId（绑定语句 SHA256、5 分钟过期）重试audit.jsonl（语句、危险级、是否确认、结果）$DSH_HOME/db-tool/（0700）：
| 文件 | 内容 |
|---|---|
connections.json | 连接定义（urlSafe 中密码脱敏为 ***） |
secrets.json | 0600，密码/URL 凭据，永不返回给模型 |
grants.json | 项目授权（归一化路径 → connId → ro/rw） |
audit.jsonl | 追加式审计日志 |
# npm（推荐）
dsh plugin --profile web add dsh-db-tool
# GitHub 源码
dsh plugin --profile web add "dsh-db-tool@github:mengqi1436/dsh-db-tool"
# 本地开发
dsh plugin --profile web add "link:E:\path\to\dsh-db-tool"
GaussDB 官方驱动未发布 npm，需先构建 vendor：npm run build:gaussdb（PowerShell）或 bash scripts/build-gaussdb.sh；oracledb 安装脚本需 npm approve-scripts oracledb。详见 docs/install.md。
ctx.webServer prefix /dsh-db-tool/api）+ loopback/Origin trust 校验（等价 ssh-tunnel http-trust），body 限 2MBSET SESSION CHARACTERISTICS AS TRANSACTION READ ONLY（pg/gaussdb）、readonly 打开（SQLite）[A-Za-z0-9_$]+ + 引用包裹）；MySQL multipleStatements:false；Redis 元数据走 SCAN（禁 KEYS）；Mongo 递归拒 $whererun_script：node:vm 独立 context、60s 超时、无 require/process/网络/文件系统，仅注入受限 db.{query,execute} 句柄症状：DSH 启动后插件加载报 failed to import，伴随 TypeError: Cannot read properties of null (reading 'Symbol(Symbol.iterator)')，栈指向 dsh-app-boot 的 routeScoped。
根因：上游 @deepseek-ai/dsh-app-boot 对 createRequire(parent).resolve.paths(name) 直接做 for..of，而 Node 对 core-module 同名包（punycode 等）返回 null，hoisted profile 下凡依赖树含此类 npm 包的插件都会炸。
一键修复（幂等，应用前自动备份为 index.js.bak-hotfix；--revert 可还原）：
npm run patch:dsh # Windows（PowerShell）
npm run patch:dsh:sh # macOS / Linux
脚本自动探测 DSH 安装根（--dsh-root 可显式指定）；补丁文件见 patches/dsh-app-boot-route-scoped-hotfix.patch，仅对 0.1.7-rc.2 声明兼容，其他版本会警告（--force 覆盖）。上游 issue：https://github.com/mengqi1436/dsh-db-tool/issues（占位，待上游仓库开放后替换）。
npm test # 离线 mock 全量（含 e2e-mock 全链路与对抗用例）
npx tsc --noEmit
npx stryker run # 变异测试（范围 lib/guard + lib/manager + lib/store，报告 reports/mutation/）
真机冒烟（设了才跑）：DBT_TEST_MYSQL_URL / DBT_TEST_PG_URL / DBT_TEST_REDIS_URL / DBT_TEST_DM_CONNECT / DBT_TEST_MONGO_URL / DBT_TEST_ORACLE_CONNECT。GaussDB 与 Oracle/Mongo 官方要求均按官方文档实现，未真机验证处以代码内标注为准。
lib/ host 插件（store / adapters×8 / guard / manager / http / index）
client/ 侧边栏单文件产物（client.js，即源码）
skills/ db-admin skill
scripts/ GaussDB vendor 构建、DSH dsh-app-boot 热修复（patch:dsh）
docs/ 安装、HTTP 契约（api-contract.md）、skill 说明
tests/ vitest（离线 mock + DBT_TEST_* 门控真机）
vendor/ gaussdb-pg 构建产物（gitignore，不入库）