workbuddy 接入 postgresql 的核心目标是让非 sql 用户用自然语言直接查询数据库，实现“问完就出表”的即时响应，无需写 sql 或配置连接池。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy 接入 PostgreSQL 的核心目标是让非 SQL 用户能用自然语言直接查询远程或本地的 PostgreSQL 数据库，无需手动写 SELECT 语句、也不用配置复杂连接池——它要的是“问完就出表”的即时响应。你不需要提前知道表名字段名，更不用担心权限越界或慢查询拖垮生产库。
确认 PostgreSQL 实例可访问
先确保你的 PostgreSQL 服务正在运行且网络可达：本地默认端口 5432，远程需开放防火墙并允许 WorkBuddy 所在机器 IP 访问。若使用 Docker 启动，请确认 -p 5432:5432 已映射且 POSTGRES_PASSWORD 环境变量已设好。
执行 psql -h localhost -U your_user -d your_db 能成功登录，才是后续所有步骤的前提。如果连不上，WorkBuddy 的任何配置都无效。
用预置 SQL 技能包一键接入（推荐零代码）
这是最快路径，适用于标准 PostgreSQL 部署（含云数据库如腾讯云 TBase、阿里云 PolarDB-PG）。
第一步：打开 WorkBuddy 桌面客户端 → 左下角点击「技能中心」→ 切换到「数据库」分类 → 搜索“PostgreSQL 连接器”或“SQL 查询（PG）”。
第二步：安装该技能包，状态变为“已启用”后，点击右侧「配置」按钮。
第三步：填入连接参数——【host、port、database、username、password 这五项必须全部填对，缺一不可】。若用本地默认实例，host 填 localhost，port 填 5432，database 填你目标库名（如 sales），其余按实际账号填写。
第四步：点击「测试连接」，绿灯亮起即表示通路建立成功；此时技能自动完成元数据采集（读取表结构），耗时约 3–8 秒，取决于库中表数量。
这一步操作起来很简单，直接把连接信息填进去就行。但注意：密码字段不支持环境变量或密钥管理器注入，必须明文输入；若数据库启用了 SSL，此技能包默认不启用加密连接，需改用脚本方式。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
用 Python 脚本方式接入（支持 SSL/自定义驱动）
当你需要连接启用了 SSL 的 PostgreSQL（如 AWS RDS、腾讯云 CynosDB-PG），或使用非标准驱动（如 pg8000、asyncpg），就必须走脚本路径。
方法一：准备连接脚本
在 WorkBuddy 已授权目录（如“文档”）新建文件 pg_connect.py，内容如下：
import pandas as pd<br>import psycopg2<br>from psycopg2 import sql<br><br># 替换为你的实际连接参数<br>conn = psycopg2.connect(<br> host="your-rds-endpoint.amazonaws.com",<br> port="5432",<br> database="prod_db",<br> user="admin",<br> password="your_strong_password",<br> sslmode="require"<br>)<br><br>df = pd.read_sql("SELECT * FROM public.orders LIMIT 10;", conn)<br>print(df.to_json(orient='records'))<br>conn.close()
方法二：安装驱动
在终端执行 pip install psycopg2-binary pandas。若报编译错误，改用 pip install psycopg2 并确保系统已装 libpq-dev（Ubuntu）或 Visual Studio Build Tools（Windows）。
方法三：触发执行
在 WorkBuddy 输入框中输入：“运行 D:\文档\pg_connect.py，将结果转成表格”。AI 会调用本地 Python 解释器执行，返回 JSON 格式数据，并自动渲染为可排序/导出的表格。
注意：脚本中 sslmode="require" 是强制开启 SSL 的关键开关，漏掉会导致连接被拒绝；另外，public.orders 中的 schema 名必须显式写出，否则在多数 PG 部署中会查不到表。
