--- title: "数据与分析参考：DbRheo CLI - 数据与分析 | 思行致远" canonical: "https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-dbrheo-cli/" dateModified: "2026-06-30" datePublished: "2026-06-30" --- 打开 AI·外脑目录 AI·外脑 [返回专栏首页](https://siyuanailab.com/knowledge/) × 站内搜索 ⌕ 主要栏目 - [AI 核心概念](https://siyuanailab.com/knowledge/ai-core/) - [工作流](https://siyuanailab.com/knowledge/workflows/) - [工具配置与选型](https://siyuanailab.com/knowledge/toolkits/) - [信源与标准](https://siyuanailab.com/knowledge/sources/) - [场景案例 待开发](https://siyuanailab.com/knowledge/scenarios/) - [职业与能力](https://siyuanailab.com/knowledge/career/) 专题 - [从这里开始](https://siyuanailab.com/knowledge/start/) - [获取与安装](https://siyuanailab.com/knowledge/install/) - [建设日志](https://siyuanailab.com/knowledge/ops/) [工作流子目录](https://siyuanailab.com/knowledge/workflows/) 基础设施层 - [浏览器自动化 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/browser-automation/) - [MCP 工具 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/mcp-tools/) - [文件系统与本地执行 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/filesystem-local/) - [API 网关与工具路由 **5**](https://siyuanailab.com/knowledge/workflows/infrastructure/api-tool-routing/) Skill 生产线 - [目标明确 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/goal-definition/) - [Skill 设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/skill-design/) - [代码实现 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/implementation/) - [测试评估 **5**](https://siyuanailab.com/knowledge/workflows/skill-forge/testing-evaluation/) Skill 参考库 - [写作与内容 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/writing-content/) - [研究与知识 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/research-knowledge/) - [沟通与协作 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/communication-collaboration/) - [产品与项目 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/product-project/) - [数据与分析 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/) - [WF-061 数据与分析参考：claude data analysis](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-claude-data-analysis/) - [WF-062 数据与分析参考：DbRheo CLI](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-dbrheo-cli/) - [WF-063 数据与分析参考：langgraph text to sql agent](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-langgraph-text-to-sql-agent/) - [WF-064 数据与分析参考：ReFoRCE](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-reforce/) - [WF-065 数据与分析参考：text to sql agent](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-text-to-sql-agent/) - [创意与设计 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/creative-design/) - [商业与营销 **5**](https://siyuanailab.com/knowledge/workflows/skill-library/business-marketing/) Agent Building 只收录有多步工作流、工作标准、Loop、Harness、工具链或通信机制的真 Agent；不收纯 persona、profile、curated list 或只有 system prompt 的仓库。 - [多 Agent 框架 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/multi-agent-frameworks/) - [工作流编排 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/workflow-orchestration/) - [Sub-agent 模式 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/sub-agent-patterns/) - [Harness 与评估 **5**](https://siyuanailab.com/knowledge/workflows/agent-building/harness-evaluation/) Skill 参考库 · 数据与分析 · Skill 解读 · WF-062 # 数据与分析参考：DbRheo CLI 思行致远 · 2026/6/30 · 置信度：中 数据分析Text-to-SQL报表可视化 一个数据库/数据分析 CLI Agent，用自然语言探索 schema、生成安全 SQL、执行查询，并可运行 Python 分析和导出数据。 # DbRheo CLI > 一个数据库/数据分析 CLI Agent，用自然语言探索 schema、生成安全 SQL、执行查询，并可运行 Python 分析和导出数据。 ## 这个能力解决什么问题 它解决的是非数据库专家需要用自然语言查询 PostgreSQL、MySQL 或 SQLite，并进一步做数据分析的问题。输入是用户的自然语言数据库问题、数据库连接配置和可选数据文件；输出是 SQL、查询结果、风险提示、Python 分析结果、图表文件或 CSV/JSON/Excel 导出。 ## 核心逻辑 DbRheo 先通过 adapter 自动连接数据库并探索 schema，再根据用户问题生成 SQL。执行前有风险评估，识别危险操作并提示；查询后可以把结果交给 Python 代码执行模块做统计、可视化或自动化脚本。CLI 支持异步处理、多行粘贴、流式输出和操作日志。 ## 技术结构 - 关键模块：`packages/core` 提供数据库适配、SQL 生成、风险评估和执行；`packages/cli/cli.py` 提供交互入口；`packages/web` 是可选 Web UI；`testdata/` 提供 Adult Census 数据集。 - 调用链路：自然语言 -> schema discovery -> SQL generation -> risk assessment -> database execution -> optional Python analysis/export。 - 输入输出：输入是 DB 连接、问题、样本数据；输出是 SQL、表格结果、图表或导出文件。 - 核心依赖：FastAPI、SQLAlchemy async、asyncpg、aiomysql、aiosqlite、Google Generative AI/OpenAI、Pydantic、Rich、OpenTelemetry。 ## 为什么值得参考 它把 Text-to-SQL 扩展成“数据库操作台”：schema 探索、风险评估、查询、Python 分析和导出都在一个 CLI loop 里。对数据分析 Skill 来说，风险评估和多数据库 adapter 是比单纯生成 SQL 更值得借鉴的部分。 ## 为什么不建议直接套用 自然语言 SQL 直接连真实数据库风险很高。即使有 risk assessment，也不能保证不会生成高成本查询、读取敏感字段或误操作。README 提到 Claude 模型因 prompt caching 未应用暂不推荐，说明模型适配还在变化。企业环境需要只读账号、查询白名单、审计日志和限流。 ## 如何改造成自己的版本 先做只读 SQL Agent，只开放 `SELECT` 和 schema introspection。把风险评估结果变成强制确认，不允许 LLM 自动执行写操作。Python 分析模块单独沙箱运行，并限制文件写入位置。给每条查询记录保存自然语言问题、生成 SQL、执行耗时、行数和人工确认状态。 ## 适用场景 - 内部数据探索和临时报表。 - 多数据库 schema 快速理解。 - 数据分析 CLI 原型。 ## 不适用场景 - 生产库写操作或无审计查询。 - 涉及敏感字段、客户隐私或财务数据的裸连。 - 用户不懂 SQL 且没有人工复核机制。 ## 参考信息 - 原项目：[DbRheo-CLI](https://github.com/Din829/DbRheo-CLI) - 作者：Din829 - 相关概念：[[Text-to-SQL]]、[[数据库权限边界]] - 相关卡片：保守留空 ## 参考对象信息 **名称：**DbRheo-CLI **作者：**Din829 **链接：**[https://github.com/Din829/DbRheo-CLI](https://github.com/Din829/DbRheo-CLI) ## 适用场景与行动 **场景：**Skill 参考库 / 数据与分析 **适合谁：**关注 AI 工作流、Skill 生产和 Agent Building 的读者 **下一步：**先阅读边界说明，再判断它是否适合改造成自己的数据与分析流程。 当前内容按公开来源和已审核草稿整理，只作为工作流理解与方法论参考。 涉及客户数据、外部平台、会议记录和业务系统的场景，必须保留人工确认与授权边界。 [上一张：数据与分析参考：claude data analysis](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-claude-data-analysis/) [下一张：数据与分析参考：langgraph text to sql agent](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/skill-library-data-analysis-langgraph-text-to-sql-agent/) [返回当前分类](https://siyuanailab.com/knowledge/workflows/skill-library/data-analysis/) [返回工作流专栏](https://siyuanailab.com/knowledge/workflows/)