OtterMind SQLX 数据库工具:列出已保存的数据源、查看或测试连接、执行 SQL、打开本地结果页,缺少 sqlx CLI 时首次调用自动安装。
安装
# npm 包(预构建)
dsh plugin --profile web add @ottermind/sqlx-dsh
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:OtterMind/sqlx#path:/integrations/dsh
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
该插件的 README 只有英文版本。
Native SQLX tools for DeepSeek Harness. The plugin registers six defineTool tools and calls the
sqlx CLI for each one, so encrypted credentials, TLS policy, worker downloads and local result
pages stay CLI responsibilities.
Install
dsh plugin --profile <profile> add @ottermind/sqlx-dsh
cordis.patch.yml is declared as dsh.bundle.patch, so installing the package appends the plugin
row to the profile's bundle stack; no profile file edits are needed. Remove it with
dsh plugin --profile <profile> remove @ottermind/sqlx-dsh.
Requirements
- DeepSeek Harness 0.1.5 or later, including the 0.2.0 release candidates.
@deepseek-ai/dsh-tools(peer dependency) — bundled with dsh, and the profile installer runs pnpm withautoInstallPeers: false, so nothing extra is installed. The peer range covers>=0.1.5-rc.1 <0.2.0,>=0.1.6-alpha.1 <0.2.0-0and>=0.2.0-rc.1 <0.3.0-0; the plugin uses onlydefineToolandctx.tools.register, which are unchanged in 0.2.- The
sqlxCLI 0.1.15 or later. The plugin looks forSQLX_BIN, thensqlxonPATH, then the official user-level installation (~/.local/bin/sqlx,%LOCALAPPDATA%\Programs\SQLX\sqlx.exe, orSQLX_INSTALL_DIR), and when none of them exists it installs the CLI itself withnpx -y @ottermind/sqlx@latest --target dsh. Adding the plugin is therefore the only setup step.
Tools
| Tool | Purpose | May modify data |
|---|---|---|
sqlx_datasource_list |
List saved datasources (no secrets) | no |
sqlx_datasource_show |
Show one datasource by UUID or unique name | no |
sqlx_datasource_test |
Test connectivity; executes no SQL | no |
sqlx_datasource_setup |
Start adding a datasource the user finishes in a browser page; returns that page's URL | adds a connection |
sqlx_datasource_setup_status |
Report the outcome of a browser setup; read-only | no |
sqlx_sql_execute |
Execute statements, return the table-shaped result with a preview (full returns every row) |
yes |
sqlx_results_rows |
Read one page of a stored result; read-only | no |
sqlx_sql_view |
Execute once, return a local result-page URL | yes |
sqlx_prefetch |
Download components ahead of a first query (all fetches every one) |
downloads only |
The two execution tools describe the authorization rule themselves: run them only after the user authorized that exact operation and scope. Results are never replayed automatically.
Unlike the MCP server, these definitions carry no approval metadata: defineTool has no annotation
field, so the rule above is a description the model is asked to follow rather than something dsh
enforces. A deployment that needs an enforced prompt can gate the two execution tools from a
tools/pre-execute handler.
Credentials
Save credentials in the SQLX data directory (sqlx datasource add --connection-stdin, or the local
sqlx ui page). A datasource created with --username-env/--password-env reads environment
variables at execution time, and a harness started from a GUI usually cannot see your shell
environment.
Links
- Repository: https://github.com/OtterMind/sqlx
- Integration guide: https://github.com/OtterMind/sqlx/blob/main/integrations/README.md
链接
同类插件
DayuanJiang/next-ai-draw-io#dsh-plugin★ 36685
dsh 的 draw.io 绘图插件:通过 next-ai-drawio MCP 服务器作图,点回复里的链接在右侧栏打开实时预览,可以手动修改图,AI 的每次修改都是可以恢复的版本。需 Node.js 18+,首次使用由 npx 下载 MCP 服务器。
Tencent/WeKnora#dsh-weknora★ 36302
把 WeKnora 知识库接入 dsh 的四个只读工具:列出知识库、混合检索原文片段、按顺序还原单篇文档,以及直接取用 WeKnora 自己带引用的 RAG 或 ReAct agent 回答(含可续聊的 session id)。
superdesigndev/treg★ 7042
给 Agent 的工具目录:按「要做的事」检索约 2,600 个外部接口(SEO 与 SERP、外链、社交、人物与公司信息补全、广告库、抓取),查看参数与单次调用价格后直接调用,凭据由服务端注入。附带技能,MCP 行在未设置 TREG_TOKEN 前保持禁用。
T-Auto/dsh-ops★ 5074
为 Windows 的 DSH 提供 bash、PowerShell 7 及 Rust 高性能工具,减少 token 消耗。
sixtysevenlf/dsh-blender-plugin★ 1575
让 DSH agent 通过直连 TCP 通道驱动本地 Blender,提供 15 个工具:视口帧、自定义视角渲染、Python 执行、无头与作业卸载、事务回滚,以及 34 个 family / 228 个 op 的规划层。
TencentCloudBase/CloudBase-AI-Toolkit#dsh-plugin★ 1155
把腾讯云 CloudBase 后端接入 DeepSeek Harness——在对话里搭好并部署全栈应用,查询结果渲染为表格卡片(分页、排序、导出 CSV),部署后可预览真实域名,并提供 CloudBase MCP 工具集(`mcp__cloudbase__*`),登录走 device-code 流程。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。