Logan.Li
bf377f3b55
- 官网源码归拢到 homepage/（index/pricing/license + docs.html + content/ + assets/ + docs-assets/），
删除程序内 go:embed 的 server/internal/{site,docs}，后端只静态托管 homepage/dist 做本地预览
（dist 缺失时打 warn 日志，不再内置兜底；/home 别名保留供 GUI openExternal 使用）
- 文档 manifest 按现网口径重建：MCP 页标记 hidden（不再进侧栏与搜索）、补 快捷键 页、校正 updated 日期
- 新增独立静态页 /license：交付与激活四步（邮件交付授权码）、LIC- 在线 与 LICOFF- 离线 对比、
授权服务器 licence.rlwj.cn 通信范围说明、授权类型与价格、10 条授权 FAQ
- tools/homepage-build 支持 hidden 页与可选单页，产出 <name>.html 与 <name>/index.html
- 导航/页脚接入 /license，跨页锚点补 / 前缀，页脚底栏文案同步为静态站口径
- 产物零漂移：12 页文档与现网逐字节一致（仅 mcp 隐藏页自身侧栏/上下页行为随之收敛）
40 lines
1.9 KiB
Markdown
40 lines
1.9 KiB
Markdown
AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻塞你。
|
||
|
||
侧栏支持 **Ask | Agent**：Ask 只生成 SQL；Agent 调用与 MCP 同源的只读工具真查库。外部编辑器可用 `npx @rlwj-lab/opsxdb-mcp` 接入（见应用内《AI 助手》文档）。
|
||
|
||
## 六种动作
|
||
|
||
| 动作 | 用途 |
|
||
| --- | --- |
|
||
| 生成 | 自然语言 → SQL（「查最近 7 天下单但未支付的用户」） |
|
||
| 解释 | 把一段复杂 SQL 翻译成中文说明 |
|
||
| 优化 | 分析慢查询，给出索引 / 改写建议 |
|
||
| 修复 | 报错信息 + SQL → 修正版本 |
|
||
| 方言 | MySQL ↔ PostgreSQL 等跨方言转换 |
|
||
| 样例 | 按表结构生成示例查询 |
|
||
|
||
## 使用方式
|
||
|
||
1. 连接库后打开右侧 AI 面板；
|
||
2. 选择动作，输入需求或粘贴 SQL（可附上对象树上下文）；
|
||
3. 生成结果一键放回编辑器，⌘/Ctrl + Enter 执行。
|
||
|
||
> **提示**：生成的 SQL 依旧走危险语句确认流程 —— AI 产出与手写 SQL 同等对待，不放宽防护。
|
||
|
||
## 接入真实模型
|
||
|
||
AI 面板支持任何 **OpenAI 兼容协议**的服务（OpenAI / DeepSeek / 通义 / 本地 vLLM 等），回复以 **SSE 流式**逐字输出，等待模型时不再面对空白。
|
||
|
||
配置入口（二选一）：
|
||
|
||
1. AI 面板右上角「**配置**」：填 Base URL、API Key、模型名，保存后可一键测试；
|
||
2. 配置文件 `~/.opsxdb/ai.json`（权限 0600），或环境变量 `OPSXDB_AI_PROVIDER / OPSXDB_AI_BASE_URL / OPSXDB_AI_API_KEY / OPSXDB_AI_MODEL`。
|
||
|
||
> **说明**：未配置 API Key 时回落本地 stub（离线占位，内容为模板演示）；AI Key 保存后服务端只回显掩码（`sk-***`）。
|
||
|
||
## 数据流向承诺
|
||
|
||
- 默认只发送你明确提交的内容（附当前库表结构上下文，不含连接凭据）；
|
||
- 可完全关闭 AI 功能（顶栏隐藏面板即可，无后台请求）；
|
||
- 使用云端模型时在界面上明确标识，生成 SQL 依旧走危险语句确认流程。
|