root/goodbuddy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: record attachment UI behavior and OCR validation

Browse Source 
Document the compact import cancellation control and progress-card layout. Record the prior full-suite results, focused attachment and Electron checks, and production probe review with their validation boundaries.

Release note: 附件查看结果、更多操作、移除和导入取消采用紧凑图标按钮，并提供悬停提示和键盘焦点说明，减少窄窗口中的布局拥挤。
This commit is contained in:
mesalogo
2026-09-19 17:26:46 +08:00
parent b1eb5d00d5
commit 6f06fce039
2 changed files with 14 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/document-processing/progress.md
+12 -3
View File
@@ -154,6 +154,7 @@ restructure 可核对 1 次，另最多 1 次状态不明。未将 2026-09-18
对应 FR-H12。检查实际工作区后保留已有 OCR、存储、预览与队列实现，修正草稿、历史消息 对应 FR-H12。检查实际工作区后保留已有 OCR、存储、预览与队列实现，修正草稿、历史消息
及队列预览的操作布局。查看结果与更多操作改为同排 32px 图标按钮，草稿移除使用同尺寸 及队列预览的操作布局。查看结果与更多操作改为同排 32px 图标按钮，草稿移除使用同尺寸
叉号；保留含附件名的可访问名称、悬停提示和键盘聚焦说明。文件名省略，状态与大小可换行。 叉号；保留含附件名的可访问名称、悬停提示和键盘聚焦说明。文件名省略，状态与大小可换行。
导入中的取消按钮也改为图标，进度卡使用三列，避免取消文字挤入固定宽度按钮。
文件名核对覆盖 `ContextManager` 导入、显式 OCR、重解析、`ConversationAttachmentStorage` 文件名核对覆盖 `ContextManager` 导入、显式 OCR、重解析、`ConversationAttachmentStorage`
和结果清单。源码将 UUID 用于资源标识，显示名来自导入文件名；已有存储测试验证原名称在 和结果清单。源码将 UUID 用于资源标识，显示名来自导入文件名；已有存储测试验证原名称在
@@ -167,16 +168,24 @@ restructure 可核对 1 次，另最多 1 次状态不明。未将 2026-09-18
新增 Electron 用例初次受系统缩放的亚像素取整影响，测得根容器宽 360.57px；驱动固定 新增 Electron 用例初次受系统缩放的亚像素取整影响，测得根容器宽 360.57px；驱动固定
device scale factor 后复验。驱动 Enter 未产生按钮激活，改用原生 Space 后菜单流程通过。 device scale factor 后复验。驱动 Enter 未产生按钮激活，改用原生 Space 后菜单流程通过。
这两次失败未记作产品通过，也未通过修改页面溢出样式绕过测量。 这些驱动失败未记作产品通过，也未通过修改页面溢出样式绕过测量。
定向 10 文件、116 项测试通过，覆盖 HTTP 客户端及 loopback、解析服务、设置、会话文件 定向 10 文件、116 项测试通过，覆盖 HTTP 客户端及 loopback、解析服务、设置、会话文件
存储、ContextManager、预览、附件操作及共享 UI。新增 Electron 用例单独通过；最终 存储、ContextManager、预览、附件操作及共享 UI。App 附件筛选的 3 项测试通过，包含导入
`npm run typecheck`、`npm run lint` 通过。全仓测试结果完成后补记。 进度中的图标取消入口；新增 Electron 用例单独通过。最终
`npm run typecheck`、`npm run lint` 通过。`npm test` 完整运行 885.06 秒：400 个文件
通过、9 个跳过；4,782 项通过、67 项跳过。该运行启动时尚未创建新增 Electron 用例，
因此其通过结果单独记录；导入取消入口的最终改动由随后 App 定向测试覆盖。
日志仍有既有 jsdom Canvas 提示和测试临时仓库的换行提示，没有测试失败。
本轮未修改 Main、Preload、Agent 或 Runtime 请求链路，未发起真实 OCR、文本或视觉模型 本轮未修改 Main、Preload、Agent 或 Runtime 请求链路，未发起真实 OCR、文本或视觉模型
请求。前轮实际调用与未测验收项仍以上节记录为准，不能由本次界面回归推断全部高级选项、 请求。前轮实际调用与未测验收项仍以上节记录为准，不能由本次界面回归推断全部高级选项、
Runtime 组合和跨平台验收已完成。没有提交或推送。 Runtime 组合和跨平台验收已完成。没有提交或推送。
复核前轮 `document-app-GXKuZv/report.json`、`document-app-fuFTEY/restart-report.json`
及 `document-app-iZSxV8/report.json`：设置和显式图片 OCR、重启后无 OCR 读取、远端图片
消费记录均为 passed。文档扫描无阻断项；复核候选为字段清单和验证边界，保留其事实限定。
## 复现 ## 复现
脚本为 [`scripts/paddleocr-vl-probe.mjs`](../../../scripts/paddleocr-vl-probe.mjs)， 脚本为 [`scripts/paddleocr-vl-probe.mjs`](../../../scripts/paddleocr-vl-probe.mjs)，
docs/features/document-processing/ui-design.md
+2 -1
View File
@@ -53,7 +53,8 @@
草稿、历史消息和队列预览中的“查看解析结果”“更多附件操作”使用共享 `icon-button` 草稿、历史消息和队列预览中的“查看解析结果”“更多附件操作”使用共享 `icon-button`
视觉，图标分别为文档查阅和省略号，点击区域为 `32px × 32px`，在独立操作行内排列。 视觉，图标分别为文档查阅和省略号，点击区域为 `32px × 32px`，在独立操作行内排列。
按钮提供含文件名的可访问名称、悬停提示及键盘焦点提示；草稿移除按钮使用同尺寸叉号。 按钮提供含文件名的可访问名称、悬停提示及键盘焦点提示；草稿移除和导入取消使用同尺寸
叉号。导入卡按进度图标、文件信息、取消按钮排列，进度条独占下一行。
文件名保持单行省略，悬停可读完整名称；解析状态、发送方式和大小在元数据行按空间换行， 文件名保持单行省略，悬停可读完整名称；解析状态、发送方式和大小在元数据行按空间换行，
不将次操作拉伸成整行文字按钮。布局以卡片所在容器宽度为准，沿用主题令牌和共享焦点环。 不将次操作拉伸成整行文字按钮。布局以卡片所在容器宽度为准，沿用主题令牌和共享焦点环。