remnote-bridge 0.1.13 → 0.1.14

package/skills/remnote-bridge-test/references/verification-guide.md

@@ -0,0 +1,161 @@
+# Chrome 截图验收指南
+
+> **红线：宁可误杀，不可放过。CLI/MCP 返回 ok:true 不代表成功——只有 RemNote 界面中实际状态正确才算 PASS。**
+
+---
+
+## 1. 验收流程
+
+### Step 1: 准备
+
+1. 用 `mcp__claude-in-chrome__tabs_context_mcp` 获取当前浏览器 tab 信息
+2. 找到 RemNote 页面（或用 `mcp__claude-in-chrome__navigate` 打开 RemNote）
+3. 导航到测试页面：通过侧边栏或 URL 直达
+
+### Step 2: 刷新
+
+**必须刷新页面**——确保看到最新数据，而非浏览器缓存。
+
+```
+使用 mcp__claude-in-chrome__javascript_tool 执行: location.reload()
+```
+
+等待页面加载完成（2-3 秒）。
+
+### Step 3: 展开
+
+测试数据可能处于折叠状态。必须展开所有相关节点：
+
+1. 找到测试前缀（如 `[L2-01]`）标记的节点
+2. 点击展开所有层级
+3. 确保所有子节点都可见
+
+### Step 4: 截图
+
+```
+使用 mcp__claude-in-chrome__computer 对 RemNote 页面截图
+```
+
+截图要求：
+- 包含完整的测试数据区域
+- 所有节点展开可见
+- 如果数据较多，可分多次截图
+
+### Step 5: 逐项对比
+
+对照 subagent 报告的"最终状态"，逐一检查以下维度：
+
+---
+
+## 2. 验证维度清单
+
+### 2.1 文本内容 ⬜
+
+| 检查项 | 方法 | 常见陷阱 |
+|:-------|:-----|:---------|
+| 文字完全一致 | 逐字对比截图中的文本与预期文本 | Unicode 全角/半角差异 |
+| 无多余文字 | 确认没有意外的前缀、后缀 | 分隔符残留（:: ;; >> 等不应出现） |
+| 无缺失文字 | 确认完整内容都在 | backText 未显示时需切换视图确认 |
+
+### 2.2 结构层级 ⬜
+
+| 检查项 | 方法 | 常见陷阱 |
+|:-------|:-----|:---------|
+| 父子关系正确 | 确认缩进层级匹配预期 | 节点挂到错误的父级下 |
+| 节点数量正确 | 数一下实际节点数 | 创建部分失败（10 个只出现 8 个） |
+| 顺序正确 | 确认兄弟节点的先后顺序 | 重排操作未生效 |
+
+### 2.3 Rem 类型 ⬜
+
+| 类型 | 界面表现 | 如何确认 |
+|:-----|:---------|:---------|
+| concept | **文字加粗** | 目视确认是否加粗 |
+| descriptor | 正常字重 | 确认未加粗 |
+| default | 正常字重 | 确认未加粗 |
+
+### 2.4 闪卡 ⬜
+
+| 检查项 | 方法 | 常见陷阱 |
+|:-------|:-----|:---------|
+| 方向正确 | 确认分隔符（:: ;; >> 等）或箭头方向 | practiceDirection 设错方向 |
+| backText 存在 | 点击 Rem 查看是否有背面文本 | backText 为空 |
+| 多行答案 | 展开子节点确认有答案行 | isCardItem 未设置 |
+
+### 2.5 格式属性 ⬜
+
+| 属性 | 界面表现 | 如何确认 |
+|:-----|:---------|:---------|
+| H1/H2/H3 | 标题大小不同 | 目视确认字体大小 |
+| highlightColor | 整行背景色 | 确认颜色正确 |
+| isTodo | 前面有复选框 | 确认复选框存在 |
+| todoStatus | 复选框打勾/未打勾 | 确认状态正确 |
+| isCode | 代码块样式 | 确认有代码块背景 |
+
+### 2.6 Portal ⬜
+
+| 检查项 | 方法 | 常见陷阱 |
+|:-------|:-----|:---------|
+| Portal 存在 | 界面中有紫色边框的嵌入区域 | Portal 创建成功但无引用 |
+| 引用正确 | Portal 中显示了正确的 Rem | 引用了错误的 Rem |
+| 实时同步 | 修改源 Rem 后 Portal 中内容更新 | 引用断裂 |
+
+### 2.7 标签 ⬜
+
+| 检查项 | 方法 | 常见陷阱 |
+|:-------|:-----|:---------|
+| 标签存在 | Rem 下方或右侧有标签显示 | tags 操作失败 |
+| 标签内容正确 | 标签名称匹配预期 | 引用了错误的 tag Rem |
+
+---
+
+## 3. 判定规则
+
+### PASS 条件
+
+**所有**验证维度的**所有**检查项都匹配预期。无例外。
+
+### FAIL 条件
+
+**任何一个**检查项不匹配即为 FAIL。包括但不限于：
+
+- 文本有任何差异（哪怕一个字符）
+- 结构层级有偏差
+- 属性未生效
+- 节点数量不对
+- 顺序不对
+
+### 可疑情况处理
+
+如果无法确定某项是否匹配：
+
+1. **截图放大检查**——用更高分辨率或更大范围截图
+2. **通过工具确认**——用 `read_rem` 或 `read_tree` 获取当前实际数据对比
+3. **仍然不确定**——标记为 FAIL 并注明原因
+
+> ⚠️ 绝不能因为"看起来差不多"就标记 PASS。必须是"确认完全正确"。
+
+---
+
+## 4. 结果记录格式
+
+验收结果统一记录在 `remnote-bridge-test-workspace/results.md` 中，使用 SKILL.md §6 定义的 Markdown 表格格式。
+
+各维度标记：✅ PASS / ❌ FAIL / ⬜ 不涉及 / ❓ 无法确认
+
+截图保存路径：`remnote-bridge-test-workspace/{test_id}-{interface}/screenshot-{N}.png`（如 `L2-01-MCP/screenshot-1.png`）
+
+判定规则：所有相关维度都 PASS 才算 PASS，任一维度 FAIL 则整体 FAIL。
+
+---
+
+## 5. 辅助验证方法
+
+当截图无法确认某些属性时（如 practiceDirection、backText 的确切内容），可以**补充使用工具验证**：
+
+```
+1. 用 read_rem 获取目标 Rem 的完整属性
+2. 与预期值逐字段对比
+3. 特别关注：type、practiceDirection、backText、highlightColor、fontSize
+```
+
+⚠️ 工具验证是**补充**手段，不能替代截图验证。截图验证确认的是用户实际看到的界面，工具验证确认的是数据层面的正确性。两者都必须通过。