chore: align local-first control plane and editor fixes

- wire SQLite control-plane access/session paths into Rust web local-folder routes

- preserve local Markdown attachment semantics across upload, reload, and secondary-pane resource tabs

- refresh design governance docs, Reasonix task templates, and bug records

- retire root .mcp.json local MCP config
This commit is contained in:
lix-2026
2026-05-23 23:38:42 +08:00
parent 42fb58310c
commit 5f97800489
110 changed files with 5344 additions and 889 deletions
@@ -0,0 +1,136 @@
# [reference] mnote-dev-squad 协作协议 v1
## 目的
把 mnote 开发固定为一个轻量协作组:Hermes 主控,多个 Codex worker 在独立 worktree 实现,Reasonix flash 做真实浏览器 smoke,每个环节都用 Markdown 交接。
本协议不使用 Codex harness;不允许多个写入型 agent 同时改同一个 checkout。
## 角色
### Hermes 主控
- 读取 mnote 当前设计与 AGENTS.md。
- 拆分任务 lane。
- 创建 run 目录与 task/result/smoke/review Markdown。
- 创建或指定 Codex worktree。
- 启动/观察 Codex worker。
- 启动 Reasonix smoke。
- 阅读 RESULT.md、SMOKE.md、git diff 后做合并裁决。
### Codex worker
- 一个 worker 只负责一个 lane。
- 一个 worker 只在自己的 worktree 中写入。
- 默认不提交、不推送、不改允许范围外文件。
- 必须输出 RESULT.md。
### Reasonix smoke tester
- 默认使用 Reasonix flash。
- 负责真实浏览器 smoke、截图、console、final URL、可见文本证据。
- 默认不改代码。
- 必须输出 SMOKE.md。
### Reviewer / 仲裁
- 默认由 Hermes + 主控 Codex完成。
- 有争议时升级到 gpt-5.5 或更强模型。
## 目录约定
每轮协作创建:
```text
/mnt/Data1T/mnote/tmp/agent-runs/<run-id>/
PLAN.md
codex-<lane>/TASK.md
codex-<lane>/RESULT.md
smoke/SMOKE.md
REVIEW.md
```
模板位于:
```text
/mnt/Data1T/mnote/.agent-templates/task.md
/mnt/Data1T/mnote/.agent-templates/result.md
/mnt/Data1T/mnote/.agent-templates/smoke.md
/mnt/Data1T/mnote/.agent-templates/review.md
```
## Worktree 约定
Codex worker 使用独立 worktree,例如:
```text
/mnt/Data1T/mnote-wt-<lane>-<YYYYMMDD-HHMM>
```
推荐 lane
- `rust-kernel`
- `mnote-web`
- `tree-domain`
- `editor-interaction`
- `onlyoffice`
- `ai-runtime`
- `docs-review`
- `qa-smoke`
## Ownership 规则
每个 TASK.md 必须写清:
- 允许修改范围
- 禁止修改范围
- 验收命令
- 交付物路径
若两个 lane 需要改同一个核心文件,必须停下来由 Hermes 重新拆分或指定唯一 owner。
## 交付标准
Codex worker 完成不等于可合并。可合并必须满足:
1. RESULT.md 存在。
2. 修改文件符合 ownership。
3. 验证命令已执行或明确说明阻塞原因。
4. Reasonix smoke 已完成,或明确说明该任务不需要浏览器 smoke。
5. Hermes / reviewer 已读 diff。
## Smoke 标准
涉及 UI、文档页、编辑器、树、拖拽、选择、hover、click、快捷键等,SMOKE.md 必须包含:
- 测试 URL / 环境
- 浏览器动作
- final URL
- screenshot 路径
- console error 数量
- PASS / FAIL
- 问题与复现步骤
块编辑器验收中,hover / click / drag / select 是强制步骤;缺任一步只能算未完成验收。
## 升级规则
升级到 gpt-5.5 / 主控 Codex 深度复核的情况:
- Reasonix smoke 与 Codex 结论冲突。
- smoke evidence 不足。
- 失败原因涉及架构边界。
- 涉及 AGENTS.md 中的长期方向判断。
- 需要合并多个 worktree 的重叠改动。
## 回收规则
旧 worktree、失败 worktree、临时实验目录优先软删除到 recycle,不直接硬删。
推荐:
```text
/mnt/Data1T/recycle/<reason>-<timestamp>/
```
保留 MANIFEST 或 README,说明来源与恢复方法。