lix-2026
1882db7681
- 归档 OnlyOffice live bridge、Page AI、mindmap、design governance 与相关 bug 条目 - 补齐 MinerU OCR 后端 runtime 合同与 smoke/test 基线 - 收口 ChatOnly/Doubao、ObjectIdentity、Page Aggregate compat 与 runtime owner 文档口径 验证： - cargo test --manifest-path rust/Cargo.toml -p mnote-web local_ocr -- --test-threads=1 - cargo test --manifest-path rust/Cargo.toml -p mnote-web onlyoffice_bridge -- --test-threads=1 - git diff --check - git diff --cached --check - codegraph index . --force && codegraph status . - codegraph sync . && codegraph status .
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 10-19 AGENTS.md 架构参考路径断裂
|
||
|
||
## 状态
|
||
|
||
- 状态：done
|
||
- Owner：10-review / AGENTS 协作规则
|
||
- 发现时间：2026-05-31
|
||
|
||
## 现象
|
||
|
||
发现时，`AGENTS.md` 的“需要架构判断时，优先参考”列表中有两个路径已经断裂。因为 `AGENTS.md` 是 agent 的顶层协作规则，这类失效引用会直接误导后续任务启动时的架构判断。
|
||
|
||
## 证据
|
||
|
||
- 发现时，`AGENTS.md` 仍引用 `/mnt/Data1T/mnote/design/01-05-current-priority-overview.md`，但该文件实际位于 `design/old/01-05-current-priority-overview.md`，根路径不存在。
|
||
- 发现时，`AGENTS.md` 仍引用 `/mnt/Data1T/mnote/design/01-tree-first-graph-kernel/process/1-tree-first-graph-kernel-v1.md`，但实际文件位于 `design/01-tree-first-graph-kernel/reference/1-tree-first-graph-kernel-v1.md`。
|
||
- 本轮已更新 `design/README.md`、`1-8` 与 `AGENTS.md` 的 active 入口。
|
||
|
||
## 影响
|
||
|
||
- 后续 agent 按 `AGENTS.md` 查架构依据时会遇到文件不存在。
|
||
- worker 可能因此退回旧记忆或自己猜测口径。
|
||
- `01-05` 已迁入 `old/` 但仍被当作当前入口，削弱 `design/README.md` 和 `1-8` 的入口权威。
|
||
|
||
## 修复建议
|
||
|
||
修复方式：
|
||
|
||
- 将 `01-05-current-priority-overview.md` 替换为 `CURRENT_ARCHITECTURE.md` 与 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`。
|
||
- 将 `process/1-tree-first-graph-kernel-v1.md` 改为 `reference/1-tree-first-graph-kernel-v1.md`，或删除该历史参考入口。
|
||
|
||
## 本轮进展
|
||
|
||
- 2026-05-31：用户设置的 P0 goal 已明确包含 `AGENTS/design 断裂引用`，本轮已更新 `AGENTS.md`：
|
||
- 新增 `CURRENT_ARCHITECTURE.md`。
|
||
- 新增 `design/01-tree-first-graph-kernel/process/1-8-mvp-post-process-execution-order-v1.md`。
|
||
- 将 `1-tree-first-graph-kernel-v1.md` 指向 `reference/`。
|
||
- 移除已不存在的 root `design/01-05-current-priority-overview.md` 引用。
|
||
|
||
## 验收
|
||
|
||
- `test -f` 验证 `AGENTS.md` 中列出的每个绝对路径都存在。
|
||
- `rg -n "design/01-05-current-priority-overview.md|process/1-tree-first-graph-kernel-v1.md" AGENTS.md` 不再命中 active 断裂引用。
|