feat(ai): 阶段 2 Ask|Agent 共用 aitools Runtime 真查库

- 侧栏 Ask|Agent 分段；Ask 仍走 /api/ai/chat，Agent 走 /api/ai/agent
- RunAgent 多轮 tool call → 进程内 aitools（与 MCP 同源只读/白名单/审计）
- 回复下步骤时间线；openai-chat tools（DeepSeek）；agent-accept 冒烟

server/internal/docs/content/10-ai.md

@@ -11,6 +11,18 @@ AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻
 | 方言 | MySQL ↔ PostgreSQL 等跨方言转换 |
 | 样例 | 按表结构生成示例查询 |
 
+
+## Ask | Agent（阶段 2）
+
+侧栏输入框上方可切换模式：
+
+| 模式 | 行为 |
+| --- | --- |
+| **Ask** | 只生成/解释/优化 SQL，**不执行**数据库工具 |
+| **Agent** | 多轮调用与 MCP 同源的只读工具（列连接/库表、描述表、只读 SQL / Redis 读命令），步骤时间线挂在回复下 |
+
+Agent 需要已配置的 OpenAI 兼容模型（如 DeepSeek）。连接须在 `~/.opsxdb/mcp.json` 白名单内；写操作一律拒绝。
+
 ## 使用方式
 
 1. 连接库后打开右侧 AI 面板；
@@ -19,9 +31,11 @@ AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻
 
 > **提示**：生成的 SQL 依旧走危险语句确认流程 —— AI 产出与手写 SQL 同等对待，不放宽防护。
 
-## 当前状态（v0.1）
+## 配置服务
 
-AI 面板当前为**本地 stub**：六种动作的交互框架与 API 已就位（`POST /api/ai/chat`），模型服务接入版本会明确标注数据流向与开关位置。
+点击桌面右上角的设置按钮，在「AI 助手」中选择服务类型，填写服务地址、模型和 API Key，点击「保存」或「测试」（测试会先保存配置）。也可以从 AI 面板的设置入口配置。
+
+支持离线演示和 OpenAI 兼容服务。已保存的 API Key 不回显，留空保存表示保留原密钥。配置加载失败时可重试。
 
 ## 数据流向承诺
 
@@ -30,3 +44,5 @@ AI 面板当前为**本地 stub**：六种动作的交互框架与 API 已就位
 - 默认只发送你明确提交的内容（不含连接凭据）；
 - 可完全关闭 AI 功能；
 - 使用云端模型时在界面上明确标识。
+
+AI 自动跟随 SQL 编辑器当前连接与数据库（Redis 显示 DB 编号，集群固定 DB0），输入框上方可核对目标。直接点选生成 SQL、解释、优化、修复或样例后发送；Shift+Enter 换行。切换标签不会把晚到的生成结果写入新标签，等待期间修改过的 SQL 也不会被自动覆盖。