From 49b090d9a662d6ed8b1f517a796deef9ce82fc7c Mon Sep 17 00:00:00 2001 From: zavier <765324639@qq.com> Date: Sat, 1 Aug 2026 21:39:25 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B8=85=E7=90=86=E5=B7=B2=E7=A7=BB?= =?UTF-8?q?=E9=99=A4=E5=8A=9F=E8=83=BD=E7=9A=84=E6=AE=8B=E7=95=99=E6=8F=8F?= =?UTF-8?q?=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 候选 5 移除 mermaid ER 图与死代码清理删除 db-workspace-panel 后， README/CLAUDE 仍有残留： - README：/db relations 命令列表与示例删 er-diagram - CLAUDE：消息渲染表删 db-workspace-panel 行（renderer 已删）、 消息类型列表去 db-er-diagram --- CLAUDE.md | 9 ++++----- README.md | 27 +++++++++++++-------------- 2 files changed, 17 insertions(+), 19 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index d6b70f7..3123124 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -85,12 +85,11 @@ formatting/ ← formatTableResult —— 自动布局：横向 / 转置 / - **TUI**：`pi.appendEntry("db-query-result", data)` + `registerEntryRenderer` → 自适应宽度 Component（横向/转置/纵向，列宽打包用 `layoutColumns`）。`ctrl+o` 展开为完整纵向输出。 - **LLM 上下文**：`pi.sendMessage({ display: false, ... })` → `formatTableCompact`——无填充的 markdown，200 字符单元格上限加 `…[+N]` 标记，包含所有行。 -| customType | 渲染器 | -| -------------------- | ----------------------------------------------------------------- | -| `db-query-result` | Entry 渲染器：表头 + SQL + 自适应表格；关联表提示；展开看完整行。 | -| `db-workspace-panel` | Message 渲染器：原始预格式化文本（面板不是 markdown）。 | +| customType | 渲染器 | +| ----------------- | ----------------------------------------------------------------- | +| `db-query-result` | Entry 渲染器：表头 + SQL + 自适应表格；关联表提示；展开看完整行。 | -其他（`db-tables`、`db-table-schema`、`db-er-diagram`）使用默认自定义消息渲染（紫色框 + markdown）——内容小且适合 markdown。 +其他（`db-tables`、`db-table-schema`）使用默认自定义消息渲染（紫色框 + markdown）——内容小且适合 markdown。 ### 关系图数据流 diff --git a/README.md b/README.md index ba97223..dd601a0 100644 --- a/README.md +++ b/README.md @@ -70,19 +70,19 @@ connections: ### 命令总览 -| 命令 | 说明 | -| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | -| `/db` | 显示工作区面板：连接状态、可用连接和子命令 | -| `/db add` | 交互式添加连接：选环境 → 连接名 → host/port → 用户名/密码 → 默认数据库；写入 `connections.yaml` 后自动 hot-reload | -| `/db switch` | 切换环境 → 连接 → 数据库 | -| `/db tables` | 列出当前数据库中的所有表 | -| `/db schema [表名]` | 查看表结构（列、索引），以 markdown 表格渲染并持久展示；不带参数显示可搜索的表列表 | -| `/db query [表名\|SQL]` | 查询数据：选表模式或直接执行 SQL（只读，自动追加 LIMIT） | -| `/db history [关键词]` | 搜索查询历史；不带关键词显示最近 20 条 | -| `/db favorite [add]` | 管理收藏的 SQL 模板（按数据库分组） | -| `/db relations [add\|remove\|discover\|er-diagram]` | 管理表关联关系 | -| `/db related` | 以悬浮层浏览器查看最近一次关联查询的关联表（←→ 切表 · ↑↓ 滚动 · Esc 关闭） | -| `/db on` / `/db off` | 会话内启用 / 禁用扩展（见[启用与禁用](#启用与禁用)） | +| 命令 | 说明 | +| --------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | +| `/db` | 显示工作区面板：连接状态、可用连接和子命令 | +| `/db add` | 交互式添加连接：选环境 → 连接名 → host/port → 用户名/密码 → 默认数据库；写入 `connections.yaml` 后自动 hot-reload | +| `/db switch` | 切换环境 → 连接 → 数据库 | +| `/db tables` | 列出当前数据库中的所有表 | +| `/db schema [表名]` | 查看表结构（列、索引），以 markdown 表格渲染并持久展示；不带参数显示可搜索的表列表 | +| `/db query [表名\|SQL]` | 查询数据：选表模式或直接执行 SQL（只读，自动追加 LIMIT） | +| `/db history [关键词]` | 搜索查询历史；不带关键词显示最近 20 条 | +| `/db favorite [add]` | 管理收藏的 SQL 模板（按数据库分组） | +| `/db relations [add\|remove\|discover]` | 管理表关联关系 | +| `/db related` | 以悬浮层浏览器查看最近一次关联查询的关联表（←→ 切表 · ↑↓ 滚动 · Esc 关闭） | +| `/db on` / `/db off` | 会话内启用 / 禁用扩展（见[启用与禁用](#启用与禁用)） | `/db query` 的三种调用方式 — 参数命中已知表名走选表模式，以 `SELECT` / `SHOW` / `DESCRIBE` / `EXPLAIN` 开头则直接执行： @@ -106,7 +106,6 @@ connections: /db relations add # 注册关系：选源表 → 源列 → 目标表 → 目标列 → 类型 /db relations remove # 删除已注册的关系 /db relations discover # 从 MySQL 外键约束自动发现并导入（可选 AI 分析补充） -/db relations er-diagram [表名] # 以该表为中心生成 mermaid ER 图 ``` ### LLM 工具