workbuddy通过本地ai工作台调用数据库连接组件执行sql查询，需先配置四项权限信息并验证连接。推荐使用预置“sql查询”技能包自动解析自然语言生成并执行sql；特殊场景可手动编写python脚本运行。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 本身不直接运行模型去“连接”数据库，而是通过本地运行的 AI 工作台能力，调用数据库连接组件执行查询——你输入自然语言，它生成 SQL 并安全执行，最终把结果返回给你看。
确认数据库访问权限与连接信息
在 WorkBuddy 输入任何查询前，必须先确保你能从本机访问目标数据库。这一步卡住，后面所有操作都无效。
向 DBA 或系统负责人索要四项关键信息：【主机地址、端口、数据库名、只读账号密码】。特别注意：该账号必须仅授予 SELECT 权限，且不能是生产库的管理员账号。
如果数据库启用了 IP 白名单，需将你当前电脑的公网或内网 IP 加入许可列表；若要求 SSL 连接，后续配置时必须启用加密参数，否则连接会静默失败。
选择连接方式：预置技能包 or 自定义脚本
方法一：使用「SQL 查询」预置技能包（推荐新手）
1. 打开 WorkBuddy 桌面客户端 → 点击左下角「技能中心」→ 切换到「数据库」分类 → 搜索并安装“MySQL 连接器”或“通用 DB 查询”技能。
2. 安装完成后，在输入框中直接写：“连接 MySQL 数据库，主机是 192.168.10.5，端口 3306，库名 sales_db，账号 reader，密码 R3@der#2026，查 products 表里价格大于 100 的商品名称和库存”。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
WorkBuddy 会自动解析语句，填充连接参数，并在沙箱中执行——整个过程无需你手写一行 SQL 或配置 JSON。
方法二：手动配置 Python 脚本（适用于 Oracle、达梦、带 Kerberos 认证等特殊场景）
1. 在已授权目录（如“文档/WorkBuddy/db_scripts”）新建 query_oracle.py，用 Python 的 cx_Oracle 模块写连接逻辑，确保输出为 Pandas DataFrame。
2. 在 WorkBuddy 中输入：“运行 D:\文档\WorkBuddy\db_scripts\query_oracle.py，并把结果转成表格”。AI 将调用本地 Python 解释器执行脚本，读取数据后格式化返回。
验证连接是否成功
第一步：在 WorkBuddy 输入“列出当前数据库中的所有表名”。
第二步：等待约 3～8 秒，观察返回结果。如果看到类似 ['orders', 'products', 'customers'] 的列表，说明元数据已加载成功，连接通了。
第三步：立刻试一句业务查询，例如：“统计 orders 表中 2026 年 6 月的订单总金额”。若返回数值结果，且字段名与你预期一致，即完成验证。
