dsh-clickhouse
在终端中运行以下命令:
dsh plugin install saichao/dsh-clickhouse
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 中打开「设置 → 插件」,搜索 clickhouse 并安装 dsh-clickhouse,或在终端执行 dsh plugin install saichao/dsh-clickhouse;也可从 https://github.com/saichao/dsh-clickhouse 获取源码后按 README 安装到 profile,启用插件并重启 DSH,再在用户补丁层配置 ClickHouse 连接。
插件介绍
在 DSH / DeepSeek Harness 里做 ClickHouse 问数,常见痛点是模型既需要摸清库表结构,又必须在只读、可控的前提下执行 SQL。本插件把「探结构 + 带护栏查询」收成 agent 可直接调用的七个 clickhouse_* 工具,让对话里就能完成从列库、列表、看字段、抽样到正式查询的完整路径。
核心能力围绕数据问答编排:按真实工作顺序提供 list databases、list tables、describe、sample rows、query,以及按字段名反查表的 search columns;执行层只做单条只读语句,客户端拒绝写关键字与危险片段,并可配合服务端 readonly 与行数、耗时、内存上限。插件仅依赖 Node 内置 fetch,装进 profile 后无需 node_modules,对 ClickHouse 21.12 等老版本也做了兼容与中文别名提示。
适合需要在 Harness 里对接 ClickHouse、用自然语言查数但又不想把写权限交给模型的团队与个人。默认偏向单表透明查询,跨表、外部数据源等需显式放开配置;护栏意在防手滑,生产环境仍应使用权限受限的 ClickHouse 账号。
使用场景
- 对话里先摸清库表结构再回答业务指标问题
- 不确定字段在哪张表时用列名搜索定位
- 在护栏内对大表做抽样与只读聚合查询
适合人员
- 在 DSH 里对接 ClickHouse 做问数的分析师
- 需要 agent 安全查数、避免误写库的数据工程师
- 已有 ClickHouse 实例、希望零额外 npm 依赖的 Harness 用户