README.md

Mermaid 源图资产（单一事实源）

本目录集中管理全项目 Mermaid 源图。Mermaid 是 archify 专业图的唯一源头：先抽取并校准 .mmd，再由 archify 依其绘制交互式成品（见 archify 图资产索引）；文档一律嵌入 archify 成品，禁止内联 mermaid 围栏。

溯源矩阵（唯一权威映射）

Mermaid 源	图类型	源文档（原行区间）	archify 成品	嵌入文档	校准记录	状态
engineering-plan-layers.mmd	flowchart TB · 架构分层	engineering-plan.md L36-84	engineering-plan-layers.html	engineering-plan.md · README（中）	对照 v0.0.18 源码纠偏：Changes TreeView 已移除（v0.0.13 视图迁底部 Panel）、adapter 组件实名、Engine 15 模块、AI 接缝经 CommitService 注入；详见源文档「现状校准」注记	✅ 2026-09-11
ai-agent-seams-pipeline.mmd	flowchart TD · Commit 流水线 hook	05-ai-agent-seams.md L150-177	ai-agent-seams-pipeline.html	05-ai-agent-seams.md	修正源图缺陷：class 行引用不存在的 Hook3 节点，已移除；Hook A–F 责任链与 src/agent/ 五接口（全 Null）、engine/commit/pipeline.ts（COMMIT/CANCEL/DEFER）核实一致	✅ 2026-09-11
agentic-git-preferences-flow.mmd	flowchart LR · 偏好流向	agentic-git-preferences.md L10-31	agentic-git-preferences-flow.html	agentic-git-preferences.md	与 package.json hyperGit.agent.* 四项配置核实一致（baseBranch 默认空、三项 multilineText）	✅ 2026-09-11
claude-code-config-flow.mmd	flowchart LR · 配置流向	claude-code-config.md L17-43	claude-code-config-flow.html	claude-code-config.md	与 adapter/claude-commands.ts（QuickPick / 缺失确认后 mkdir+写{}）、engine/agent/claude-path.ts 纯函数核实一致	✅ 2026-09-11
log-ci-status-dataflow.mmd	flowchart LR · CI 取数	log-ci-status.md L9-31	log-ci-status-dataflow.html	log-ci-status.md	与 engine/ci/ + adapter/ci/ + protocol.ts 核实一致（防抖 200ms、批量 ≤100 oid、pending 30s TTL、openExternal 主机校验）	✅ 2026-09-11
log-commit-detail-panel-layout.mmd	flowchart TB · 面板布局	log-commit-detail-panel.md L17-41	log-commit-detail-panel-layout.html	log-commit-detail-panel.md	与 log-webview.ts 分栏实现（560px stacked 阈值、18%–75% / 15%–85% 钳制）及 package.json view/title 核实一致	✅ 2026-09-11
log-commit-detail-panel-dataflow.mmd	flowchart LR · 取数数据流	同上 L50-65	log-commit-detail-panel-dataflow.html	同上	与 protocol.ts（commitFiles 按 hash、commitDetail 按 forHash 校验）及 selectRow / requestPanelData / deselectRow 漏斗核实一致	✅ 2026-09-11
multi-root-repo-selection-toolbar.mmd	flowchart LR · 切换入口	multi-root-repo-selection.md L7-18	multi-root-repo-selection-toolbar.html	multi-root-repo-selection.md	修正漂移：按钮实为 view/title 原生标题栏项直调命令 hyperGit.selectRepository，原「postMessage log/selectRepo」路径不存在，.mmd 已改	✅ 2026-09-11
multi-root-repo-selection-sequence.mmd	sequenceDiagram · 切换时序	同上 L28-43	multi-root-repo-selection-sequence.html	同上	一致：① onDidChangeRepository 先于 ② onDidChange fire（git-repository-service.ts 实锤）；rebind 三步细节移入交互版结论卡	✅ 2026-09-11
branch-tree-group-by-prefix-effect.mmd	flowchart LR · 前缀树效果	branch-tree-group-by-prefix.md L7-26	branch-tree-group-by-prefix-effect.html	branch-tree-group-by-prefix.md	一致（ref-tree.ts 分组 / compact / 排序）；📁 emoji 改文字、前后分支清单移入交互版结论卡	✅ 2026-09-11
branch-tree-group-by-prefix-dataflow.mmd	flowchart LR · 算树数据流	同上 L34-43	branch-tree-group-by-prefix-dataflow.html	同上	一致：buildRefTree（engine/ref/ref-tree.ts）、isRemoteHead 过滤、toBranchNodes 双形态均实锤	✅ 2026-09-11
file-list-group-by-directory-dataflow.mmd	flowchart LR · 目录树数据流	file-list-group-by-directory.md L9-18	file-list-group-by-directory-dataflow.html	file-list-group-by-directory.md	一致：buildFileTree（engine/tree/file-tree.ts）、FileTreeNode fileIndex 回指、payload 同批下发均实锤	✅ 2026-09-11
engineering-plan-layers-en.mmd	flowchart TB · 架构分层（英译）	README.md L39-48（Architecture 节英文表述）	engineering-plan-layers-en.html	README.md（经 media/diagrams PNG 导出）	与中文版同拓扑仅译标签，对照根 README L41-44 与 v0.0.18 源码核实；PNG 导出（?theme=light/dark · 2x）落 media/diagrams/ 供 Marketplace 兼容嵌入	✅ 2026-09-12
roadmap-milestones.mmd	flowchart LR · 里程碑路线	README（中） L67-74（路线图表，已由图取代）	roadmap-milestones.html	README（中）	与 implementation-status.md §1 交付记录核实（M0-M4 已交付、M5 五接缝 Null）；源表随嵌入替换移除，台账以 implementation-status.md 为准；M5 完成时须重绘本图（含 -en 与 media/diagrams 导出）	✅ 2026-09-12
roadmap-milestones-en.mmd	flowchart LR · 里程碑路线（英译）	README.md L68-75（Roadmap 表，已由图取代）	roadmap-milestones-en.html	README.md（经 media/diagrams PNG 导出）	与中文版同拓扑仅译标签；PNG 导出落 media/diagrams/	✅ 2026-09-12

管理规则

1. 变更顺序：先改本目录 .mmd → 再同步 archify 成品（HTML + 深浅色双 SVG）→ 更新本矩阵状态。
2. .mmd 文件头注释仅存轻量指针（源文档/成品路径）；映射关系以本矩阵为唯一权威，避免双源。
3. 文档嵌入统一模板：<picture> 深浅色自适应 + 交互版 HTML / Mermaid 源图双链接。
4. 每张成品四件套同基名：<基名>.mmd ↔ <基名>.{html, light.svg, dark.svg}。