安装
$ dsh plugin --profile <profile> add github:<owner>/dsh-clickhouse插件能力与用途
基于公开仓库快照由 AI 辅助整理,内容必须有源码依据;它不等同于兼容性验证或安全验证。
dsh-clickhouse 是为 DeepSeek Harness (DSH) 打造的 ClickHouse 数据问答插件包,提供 7 个 clickhouse_* 工具。支持智能体按序完成库表列表浏览、表结构描述、字段跨表反查、数据抽样以及只读 SQL 执行,采用 Node 内置 fetch 实现零额外依赖,并结合客户端 SQL 语法护栏与服务端资源上限保证执行安全。
核心能力
- 库表结构与元数据探查,包含表引擎、排序键、行数与磁盘占用查看
- 字段名跨表关键词搜索,快速定位数据所在位置
- 真实数据行抽样展示与指定字段筛选
- 带严格客户端护栏的单条只读 SQL 执行与 Markdown 表格渲染
- 查询执行计划 EXPLAIN 分析(支持 plan、estimate、syntax、ast、pipeline)
- 客户端只读防护,拒绝写操作关键字、INTO OUTFILE、外部表函数与格式覆盖
- 注入服务端执行限制(最大结果行数、超时时间、内存限制)
- 零运行时依赖,直接使用 Node 内置 fetch 驱动
适用场景
- 在 DeepSeek Harness 对话中进行 ClickHouse 自然语言问数与指标聚合
- 无需外部数据库客户端即可探查数据库表结构与字段定义
- 防手滑的只读查询与数据快速抽样验证
- 辅助开发人员快速检查 SQL 执行计划与数据分布
适合谁
- 使用 DeepSeek Harness 进行 ClickHouse 数据分析的用户
- 需要快速探查数据库结构与抽样数据的后端或数据开发人员
- 寻求安全受控数据库工具集的智能体开发者
文档中可确认的限制
- 客户端 SQL 护栏旨在防手滑误操作,不可替代 ClickHouse 账号自身的只读权限控制
- 单次返回行数默认限制为 200 行,硬上限为 10000 行,不适合全量明细拉取
- 以 JSONCompact 格式拉取后在内存中格式化渲染,不适宜超大体量结果集
- 默认禁止外部数据源表函数(如 file、url、s3)及 SQL 内置 SETTINGS
- 旧版本 ClickHouse 中非 ASCII 别名必须使用反引号包裹
DSH 兼容性
DSH Plugin 针对具体版本记录的运行验证证据。没有结果只代表我们尚未测试,不代表不兼容。
尚未测试目前还没有发布运行兼容性测试结果。
安全信号
来自包元数据和源码检查的客观信号。这些信息用于辅助判断,不代表绝对安全保证。
依赖数量
package.json 声明了 0 个运行依赖、3 个开发依赖、0 个 Peer 依赖和 0 个可选依赖。
已声明 DSH Bundle
package.json 中声明了 DSH Bundle 元数据。
已声明许可证
GitHub 报告该仓库许可证为 MIT。
已获取 package.json
已获取仓库根目录 package.json,可用于 Registry 元数据检查。
源码可用
本次 Registry 快照已获取公开 GitHub 源码元数据。
来源与 Registry 记录
展示此条目的公开来源、Registry 分类与最近一次源码检查信息,并与运行验证结果明确分开。
- 源码仓库
- saichao/dsh-clickhouse
- Registry 来源
- GitHub · dsh-plugin topic
- Registry 分类
- Plugin Bundle
- 源码检查
- 4f1d236 · 2026-10-27
本页面基于公开源码信息独立收录。DSH Plugin 与 DeepSeek 及插件作者均无隶属关系;安装前请始终以作者仓库中的最新说明为准。
仓库活跃度
- GitHub Stars
- 0GitHub stars
- Fork 数
- 0
- 未关闭 Issue
- 0
- 最近提交
- 2026-10-27
- 最近发布
- 未发现 Release
相关 DSH 插件
综合核心能力、适用场景、插件类型、分类和 DSH Profile 进行相关性排序。