46 lines
1.6 KiB
Markdown
46 lines
1.6 KiB
Markdown
|
# Surface 验收清单（诊断包驱动）
|
|||
|
|
|
|||
|
|
AI 无法坐在 Surface 前时，用本清单 + **设置 → 诊断 → 导出诊断包** 闭环。
|
|||
|
|
|
|||
|
|
## 准备
|
|||
|
|
|
|||
|
|
1. `flutter build windows --release` 或 profile 安装包
|
|||
|
|
2. 打开 BadNote → 设置 → 确认「导出诊断包」可用
|
|||
|
|
3. 准备：Surface Pen、一份 20+ 页 PDF、空白笔记
|
|||
|
|
|
|||
|
|
## MUST #3 — 笔 / 触控仲裁（约 1 分钟）
|
|||
|
|
|
|||
|
|
| 步骤 | 期望 |
|
|||
|
|
|------|------|
|
|||
|
|
| Pen 在 PDF 上书写 | 出墨，压感可见 |
|
|||
|
|
| 单指上下滚 | 滚动页面，不画线 |
|
|||
|
|
| 双指捏缩放 | 缩放，不画线 |
|
|||
|
|
| 手掌搁在屏幕上同时用笔写 | 掌不画线（palm） |
|
|||
|
|
|
|||
|
|
导出诊断包。包内 `pen_events.json` 应出现 `arbiter` 行：`decision=draw`（笔）与 `decision=pan`（指）。
|
|||
|
|
|
|||
|
|
## W3 — 硬件笔按钮
|
|||
|
|
|
|||
|
|
| 步骤 | 期望 |
|
|||
|
|
|------|------|
|
|||
|
|
| 无悬停，直接用笔尾点按 | 擦除而非画线 |
|
|||
|
|
| 按侧键（按你的笔设置） | 触发橡皮擦/平移/撤销 |
|
|||
|
|
| 倾斜笔身书写 | `pen_events` / native summary 中 tilt 非全 0 |
|
|||
|
|
|
|||
|
|
查看 `meta.json` → `penNative`：`orPenFlags` / `orPtrFlags` 在按键时应有非零位；`historyCount` 可 >1。
|
|||
|
|
|
|||
|
|
## MUST #4 / #5 — 流畅（profile）
|
|||
|
|
|
|||
|
|
1. `flutter run --profile`
|
|||
|
|
2. 打开大 PDF，快速 fling + 捏缩放 30 秒
|
|||
|
|
3. 导出诊断包 → `frame_samples.json` 中 `overBudget` 占比主观可接受；体感不掉帧
|
|||
|
|
|
|||
|
|
## 手感主观
|
|||
|
|
|
|||
|
|
- 快速甩笔：笔尖无明显拖尾/点状塌缩
|
|||
|
|
- 缩放后页面不长时间白闪（若仍闪，在包内搜 `zoom` / `rebaseline`）
|
|||
|
|
|
|||
|
|
## 回传
|
|||
|
|
|
|||
|
|
把 `badnote_diag_*.zip` 发回即可；无需录屏（可选）。
|