20260513 mindmap优化01

AGENTS.md

@@ -66,6 +66,17 @@
 - `design/old/` 下的历史废弃稿也统一按 `process/` 与 `done/` 分层，但标题继续标记 `[recycle]`。
 - `design/90-reference/` 只放参考资料，不参与 `process/done` 状态迁移。
 
+## Bugs 目录规则
+
+- `bugs/` 默认镜像 `design/` 的主线分类方式，按对应大类放置缺陷。
+- 每个大类继续按 `process/` 与 `done/` 分层：
+  - `process/`：缺陷已确认存在，仍在修复或验证中
+  - `done/`：缺陷已修复，且已有真实代码与验证证据
+- 新确认的缺陷先放 `process/`；修复完成后必须移动到同类目的 `done/`，不要在两个目录同时保留同一条缺陷。
+- 缺陷归类以真正 owner 和长期主线为准，不以表面症状命名：
+  - `sidebar/topbar/breadcrumb/文档页壳/Wolai 体验对齐` 优先归到 `05-editor-mainline/`
+  - `projection/row model/selection/focus/keyboard/DnD/tree command` 优先归到 `04-tree-domain/`
+
 ## 协作边界
 
 - 仅修改与当前任务直接相关的文件。
@@ -95,6 +106,22 @@
 - 影响主页入口、Sidebar、tree shell、文档页首屏时，优先补或复用 `scripts/task*-smoke.js` 这类 smoke 脚本。
 - 排查高 CPU / 高内存 / 卡顿时，先看是否存在首屏误走实验性 tree shell、compat fallback、重复请求、轮询或回链面板持续刷新，再看数据底座。
 
+## mnote-tester 调用
+
+- 当前固定网页测试员 profile 为 `mnote-tester`，Hermes profile 路径：`/home/lix/.hermes/profiles/mnote-tester`。
+- 默认优先通过别名调用：`/home/lix/.local/bin/mnote-tester`；等价命令是 `hermes -p mnote-tester`。
+- 需要让后续 agent 调它做真实浏览器测试时，优先使用 one-shot：
+  - `mnote-tester --yolo -z "<测试任务>"`
+  - 或 `hermes -p mnote-tester --yolo -z "<测试任务>"`
+- 交给 `mnote-tester` 的任务描述必须明确写出：
+  - 测试目标页面或 URL
+  - 是否要求真实登录
+  - 是否要求新建 / 修改 / 删除页面或块
+  - 测试数据前缀，例如 `TEST-HERMES-<timestamp>`
+  - 是否要求发现 bug 后直接写入 `bugs/<category>/process/`
+- `mnote-tester` 允许在 `3000` 主页面做最小写入型测试，包括新建、重命名、编辑、移动、归档、恢复、删除页面，以及新建、修改、删除块/模块；但默认只能操作“本轮新建的测试数据”或用户明确指定的测试区域，不能动既有用户内容。
+- `mnote-tester` 的默认证据目录是 `/mnt/Data1T/mnote/tmp/hermes-tester/<run-id>/`；若发现 bug，应按 `/mnt/Data1T/mnote/bugs/README.md` 与本文件规则归类，并把缺陷记录写到对应 `bugs/<category>/process/`。
+- 若 `/auth`、快速登录、首屏路由或上游服务本身已阻塞，`mnote-tester` 应立即停止后续写入动作，先输出阻塞证据并按规则记录 blocker bug，不要伪造“新建/修改/删除已验证通过”。
 
 ## Wolai-aline 对标流程