feat(ui,docs): Agent 流式侧栏 + 结果区/MCP 点/确认条 + 官网文案

- 侧栏消费 Agent SSE：时间线边 append、正文 ▌、停止按钮
- 「在结果区打开」不抢编辑器 focus；MCP 活跃点；写操作确认条
- 文档/落地页补充 Ask|Agent 与 npx @rlwj-lab/opsxdb-mcp（不宣传默认可写）

server/internal/docs/content/01-intro.md

@@ -13,7 +13,7 @@ OpsxDB 是一款**本地优先**的桌面数据库工作台，面向运维与开
 | 结果处理 | 一键复制 / CSV / 生成 INSERT；双击单元格复制；截断有提示 |
 | Redis 工作台 | 编辑器执行 PING / GET / SET / DEL / KEYS，键空间浏览 |
 | 安全通道 | 每连接独立配置 SSL/TLS 与 SSH 隧道；密码本机混淆存储 |
-| AI 面板 | 生成 / 解释 / 优化 / 修复 / 方言转换 / 样例 SQL |
+| AI 面板 | Ask 生成/解释/优化；Agent 真查库（与 MCP 同源只读工具） |
 | 危险操作防护 | DROP / TRUNCATE / 无 WHERE 的 UPDATE·DELETE 执行前确认 |
 | 桌面唯一形态 | 桌面 GUI（Tauri 2），本地后端随应用自动拉起 |
 

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

@@ -12,16 +12,30 @@ AI 面板的目标：让「写不出的 SQL」和「看不懂的 SQL」不再阻
 | 样例 | 按表结构生成示例查询 |
 
 
-## Ask | Agent（阶段 2）
+## Ask | Agent
 
 侧栏输入框上方可切换模式：
 
 | 模式 | 行为 |
 | --- | --- |
 | **Ask** | 只生成/解释/优化 SQL，**不执行**数据库工具 |
-| **Agent** | 多轮调用与 MCP 同源的只读工具（列连接/库表、描述表、只读 SQL / Redis 读命令），步骤时间线挂在回复下 |
+| **Agent** | 多轮调用与 MCP 同源工具；步骤时间线边跑边推（SSE）；可「插入编辑器」「在结果区打开」 |
 
-Agent 需要已配置的 OpenAI 兼容模型（如 DeepSeek）。连接须在 `~/.opsxdb/mcp.json` 白名单内；写操作一律拒绝。
+Agent 支持 openai-chat（DeepSeek 等）、Anthropic messages、OpenAI responses。连接须在 `~/.opsxdb/mcp.json` 白名单内。
+
+默认 **只读**。若将 `mode` 设为 `read_write`，写操作仍须在气泡确认条点「执行」（一次一刀），模型不能自行带确认令牌。
+
+## MCP
+
+把同一套工具暴露给 Cursor / Claude / Codex：
+
+```bash
+npx @rlwj-lab/opsxdb-mcp
+```
+
+配置示例见仓库 `docs/mcp-cursor.example.json`。白名单写在 `~/.opsxdb/mcp.json` 的 `allowed_connection_ids`；空白名单拒绝全部连接。审计：`~/.opsxdb/logs/mcp-audit.jsonl`。
+
+侧栏标题旁仅在外部 MCP **近期有调用**时显示绿色「MCP」点；悬停/点击可看最近摘要。
 
 ## 使用方式
 

server/internal/docs/content/11-faq.md

@@ -38,3 +38,14 @@
 
 **Q：快捷键有哪些？**
 核心就一个：⌘/Ctrl + Enter 执行当前语句或选区；双击结果单元格复制。完整列表见《SQL 工作台》。
+
+
+## 如何把 OpsxDB 接到 Cursor？
+
+安装并配置 MCP：
+
+```bash
+npx @rlwj-lab/opsxdb-mcp
+```
+
+在 Cursor 的 `mcp.json` 中指向该命令（或本机构建的 `bin/opsxdb-mcp`），并在 `~/.opsxdb/mcp.json` 填写允许的连接 id。默认只读；详见《AI 助手》。

server/internal/site/template.html

@@ -60,7 +60,7 @@
         <a class="btn btn-ghost btn-lg" href="/docs/quickstart" target="_blank" rel="noopener">30 秒连上第一个库 →</a>
       </div>
       <div class="hero-pills">
-        <span>本地优先</span><span>SSH 隧道</span><span>SSL 加密</span><span>国产库兼容</span><span>AI 写 SQL</span>
+        <span>本地优先</span><span>SSH 隧道</span><span>SSL 加密</span><span>国产库兼容</span><span>AI / MCP</span>
       </div>
     </div>
 
@@ -133,8 +133,8 @@
       </div>
       <div class="card">
         <div class="card-icon"><svg class="i-lg"><use href="#i-sparkles"/></svg></div>
-        <h3>AI 把 SQL 写快</h3>
-        <p>自然语言生成、解释、优化、修复、方言转换，写不出的那句 SQL 交给 AI 起草。</p>
+        <h3>AI 写 SQL，也能查库</h3>
+        <p>Ask 生成/解释/优化；Agent 用与 MCP 同源的只读工具真查库。Cursor 可 <code>npx @rlwj-lab/opsxdb-mcp</code> 接入。</p>
       </div>
     </div>
   </div>
@@ -151,7 +151,7 @@
       <div class="card row"><div class="card-icon"><svg class="i-lg"><use href="#i-table"/></svg></div><div><h3>结果随手取</h3><p>结果集一键复制 / 导出 CSV / 生成 INSERT；双击单元格即复制，截断行数有提示。</p></div></div>
       <div class="card row"><div class="card-icon"><svg class="i-lg"><use href="#i-tree"/></svg></div><div><h3>对象树与表数据</h3><p>懒加载库 / 表 / 列；点表名直接看前 100 行，展开表即看列结构。</p></div></div>
       <div class="card row"><div class="card-icon"><svg class="i-lg"><use href="#i-database"/></svg></div><div><h3>Redis 工作台</h3><p>编辑器直接执行 <code>PING</code> / <code>GET</code> / <code>SET</code> / <code>KEYS</code>，键空间浏览、TTL 管理。</p></div></div>
-      <div class="card row"><div class="card-icon"><svg class="i-lg"><use href="#i-sparkles"/></svg></div><div><h3>AI 面板</h3><p>生成 / 解释 / 优化 / 修复 / 方言转换 / 样例 SQL，六种动作贴着查询上下文。</p></div></div>
+      <div class="card row"><div class="card-icon"><svg class="i-lg"><use href="#i-sparkles"/></svg></div><div><h3>AI / MCP</h3><p>Ask 写 SQL；Agent 真查白名单库。可用 <code>npx @rlwj-lab/opsxdb-mcp</code> 接到 Cursor（默认只读）。</p></div></div>
     </div>
   </div>
 </section>
@@ -249,7 +249,7 @@
       <details><summary>能在浏览器里操作数据库吗？</summary><p>不能。客户端唯一形态是桌面应用（Tauri 2）；浏览器只承载官网与文档，由后端 :8788 内置提供。开发时的 :5174 只是桌面 devUrl 的资产服务。</p></details>
       <details><summary>和 DBeaver / Navicat 有什么差别？</summary><p>OpsxDB 面向运维与开发的日常高频操作（连库、点表、写 SQL、取结果），界面密度和快捷键为「快」设计；本地优先、后端随桌面应用拉起、内置中文文档。重度管理功能（ER 图、数据比对等）在路线图中。</p></details>
       <details><summary>Oracle 支持好了吗？</summary><p>驱动代码已就绪（纯 Go 的 go-ora，无需 JVM），但本机 docker 验收在 Apple Silicon 上受镜像限制未通过，需 x86 环境或真库完成验收，详见文档《驱动支持》。</p></details>
-      <details><summary>AI 功能需要联网吗？</summary><p>当前版本 AI 面板为本地 stub（生成 / 解释 / 优化等动作的框架已就位），接入模型服务的版本会明确标注数据流向。</p></details>
+      <details><summary>AI 功能需要联网吗？</summary><p>配置云端模型（如 DeepSeek）时，提问与结构上下文会发往该服务；可改用本地兼容端点。MCP / Agent 查库始终在本机执行，默认只读。</p></details>
       <details><summary>支持达梦 / MongoDB 吗？</summary><p>已列入路线：常用库 native 内置，长尾库（达梦、MongoDB、ZooKeeper、ES、InfluxDB）规划 agent 按需接入，驱动分发走独立仓库并校验 sha256。</p></details>
     </div>
   </div>