中间件查询

技能标识：middleware-query

Natural-language read-only querying for MySQL, Redis, and MongoDB with explicit connection configuration (host, port, username, password), guarded query planning, and deterministic script executors. Use when users ask to query local databases/middleware in natural language, inspect Redis keys/values, run Mongo filters/aggregations, or retrieve SQL data safely.

作者：admin | 来源记录：ClawHub

中间件查询技能

实现具有严格安全控制的自然语言查询工作流。

1) 收集必需输入

对每个数据源明确要求所有连接参数：

- host
port
username
password
可选：database（MySQL/Mongo）、db（Redis逻辑数据库）

在执行前，将连接配置文件存储在 scripts/connections.json 中（或提供环境变量）。

使用 scripts/connections.example.json 作为模板，并将真实的 connections.json 仅保留在本地（已加入gitignore）。

优先使用包含环境/别名条目的中间件列表配置，例如 {redis:[{env:local,alias:main,...}]}，并使用类似 redis.local 或 redis.main 的配置文件。

2) 强制只读安全

始终保持操作只读：

- SQL：仅限 SELECT、WITH、EXPLAIN SELECT
Redis：GET、MGET、HGET、HGETALL、SMEMBERS、ZRANGE、SCAN、TTL、TYPE
Mongo：find、count_documents、仅包含只读阶段的 aggregate

拒绝写入/危险操作。

3) 优先使用确定性执行器

使用 scripts/ 下的脚本：

- nlquery.py（单命令入口：自然语言 -> 计划 -> 防护 -> 执行）
plannerllm.py（大语言模型自然语言 -> 带重试修复的JSON计划）
planschema.py + references/plan-schema.json（JSON Schema验证）
routernl.py（基于规则的备用方案）
plannerguard.py（语义防护）
executeplan.py（已验证的计划执行）
querysql.py
queryredis.py
query_mongo.py

传递已验证的参数；绝不执行自由形式的shell命令进行数据库访问。

4) 输出格式

1. 使用的数据源 + 配置文件
执行的查询/操作（已清理）
行数/文档数/键数
表格/JSON预览（截断）
简短的中文解释

5) 配置来源

优先级顺序：

1. 显式CLI参数
环境变量（参见 references/config.md）
scripts/connections.json

如果缺少任何必需字段，则报错并给出清晰的错误信息。

6) 参考文档

需要时阅读：

- references/config.md：连接和环境约定
references/safety-policy.md：护栏和黑名单
references/examples.md：常用命令示例

中间件查询