feat(usable): integrate current dbtool implementation snapshot
Some checks failed
release-smoke / macos-13 / x86_64-apple-darwin (push) Has been cancelled
release-smoke / ubuntu-latest / x86_64-unknown-linux-gnu (push) Has been cancelled
release-smoke / windows-latest / x86_64-pc-windows-msvc (push) Has been cancelled

Co-Authored-By: Paperclip <noreply@paperclip.ing>
This commit is contained in:
Paperclip CTO
2026-04-02 08:26:18 +00:00
parent a28dab4cd9
commit d5f69462b0
73 changed files with 5895 additions and 322 deletions

View File

@@ -34,12 +34,13 @@
## 原型包含内容
- 连接管理、schema browser、query editor、results、export、inspector 的稳定工作台分区
- 明确的 `connect -> inspect -> query -> export` 引导式评审轨道
- 按连接切换不同的 schema catalog、SQL 草稿标签、结果列和默认导出路径
- `Running` / `Success` / `Empty` / `Error` / `Exported` 五种可预览执行态
- Light / Dark 主题切换
- schema 搜索过滤、连接切换、结果 / 历史 / 导出 / 问题面板切换
- 当前界面状态到共享结构化契约的映射预览,其中 `running` 明确标记为前端暂态
- 键盘快捷路径:`1` / `2` / `3` / `4` / `5``R``T``/``⌘/Ctrl+K`
- 键盘快捷路径:`C` / `I` / `Q` / `E``1` / `2` / `3` / `4` / `5``R``T``/``⌘/Ctrl+K`
## 查看方式
@@ -65,6 +66,16 @@ http://127.0.0.1:4173
当前 `/` 会落到 `gui/index.html`,再从入口页进入工作台原型。
## 建议评审路径
推荐按以下顺序评审:
1.`C` 或顶部 workflow strip 查看 `Connect`,确认目标卡片、健康态和工作区摘要
2.`I` 查看 `Inspect`,确认 schema tree、selection 和 inspector 同步
3.`Q` 查看 `Query`,确认 SQL 草稿、执行 banner 和结果区处于同一上下文
4.`R``1``5``⌘/Ctrl+K` 预览不同执行态
5.`E` 查看 `Export`确认默认路径、empty guidance 与 blocked export 行为
## 界面验收
验收人应重点确认:
@@ -76,6 +87,7 @@ http://127.0.0.1:4173
5. 切换连接后,顶部摘要、中部工作区和右侧 inspector 是否同步更新
6. 切换连接后schema tree、query tab 标签、结果列与默认导出路径是否也同步切换到对应驱动上下文
7. Light / Dark 两种主题下信息密度、对比度和可读性是否仍然稳定
8. `⌘/Ctrl+K` 快捷操作面板是否能帮助 QA 快速预览状态与连接切换
9. 文档中的后端契约需求是否仍可映射到 CLI 已定义产品概念
10. `Contract` 面板是否能帮助 QA 与 Backend 快速核对 `query` / `export` envelope以及 `running` 暂态边界
8. 顶部 workflow strip 和 `C` / `I` / `Q` / `E` 是否能帮助 QA 明确当前正在评审哪一步主流程
9. `⌘/Ctrl+K` 快捷操作面板是否能帮助 QA 快速预览状态与连接切换
10. 文档中的后端契约需求是否仍可映射到 CLI 已定义产品概念
11. `Contract` 面板是否能帮助 QA 与 Backend 快速核对 `query` / `export` envelope以及 `running` 暂态边界