# MCPGit 技术架构 SVG：依据与发布记录

状态：已合入 main 并远端同步；正式站点交互未验收。2026-10-06。
正式入口：research_domains/lrigit/architecture.html。
本页是冻结的服务契约级架构快照，不是新建的可变研究数据库。

## 发布回执

内容合入 revision：d9255f0bf73c9229ec78d4140f1d7572799adbf5。
MCP workspace/worktree_publish 返回 fast_forward，published=true；配置的默认验证 validate_topic_workflow.py 通过。
随后 replication/repo_push 现场 fetch origin/main，local_revision 与 remote_revision 均为 d9255f0bf73c9229ec78d4140f1d7572799adbf5，ahead/behind=0/0。此文件的最终回执提交会另行同步。

入口已包含：共享中英文左栏“MCPGit 技术架构 / MCPGit architecture”、自身洞察首页按钮，以及独立架构页面的正文、宣传册、场景飞轮与PPTX返回链接。

## 依据

- 实读 LRIGIT service_metadata：MCPGit，instance lritpc，application contract v7；capabilities 包含 mcp_skill_kernel v3、stable_worktree v2、table_transaction v5、hosted_http v2、binary_websocket v1 等。
- 实读 skill_list：registry mcpgit.skills-kernel.v7，Skill contracts 2.3.0；操作划分 read/write/publish，分离 identity、repo/content、table、workspace、replication、safe、binary、hosted、build 与 router 生命周期。
- 实读 repo.read/repo.author/workspace 操作契约：expected_revision、Person/Topic、validation、snapshot 与 publish 边界。
- 实读 Works AGENTS.md 及 insight-repo-onboarding、insight-cdp-ui-debug-loop：RootSkills 管通用维护方法，Works 管洞察实例的业务方法、交付与专项规则。
- 本轮通过 AWMCP 定位 m4mac/ma 后尝试读取 home/code/mcpgit，调用被平台安全检查拦截，未改道重试。因此不宣称源码级审计、不标实现文件或源码行号，不以未读取源码支撑性能结论。

## 关键边界

1. 通用 Agent 贡献推理和编程；MCPGit 不被描述为自研通用模型或 Agent。
2. MCPGit Core 是平台，不与 LRIGIT/YXSGIT 实例并列成第三个业务实例。
3. 表/对象/工作区是职责与视图划分，不宣称每个框都有独立物理数据库。
4. Project checkpoint 关联跨仓版本，不保证跨仓原子事务；远端同步与合入、路由激活分别验收。
5. 远端、AgentWeb、浏览器和工具宿主属于按配置集成，不是 MCPGit 内建的浏览器或工作流引擎。
6. Build/router 等能力存在合同不代表实例已全部激活；动画只解释逻辑顺序，不代表性能、无人值守能力或安全保证。

## 产物与行为

build-architecture.py 为单一冻结文案与布局源，生成桌面/手机、中/英四份纯SVG。architecture.js 同源读取并直接挂载SVG，不使用 object/iframe；不改动安全响应头。提供总览和四个局部视图、暂停、重播、系统 reduced-motion 和后台暂停；共享 Shell 负责语言切换与三栏导航。

图的文字、矩形、线条与流动标记均为原生SVG，没有嵌入PNG、截图、Canvas或字体文件。只在构建源内维护冻结文案，两种语言和布局均为可再生交付物。

## 已执行的检查

- 本地 Chromium 对四份 SVG 检查352个文本节点：无超出画布文本；桌面和手机采用独立重排。已查看中文桌面全景渲染图。这是本地生成物检查，不是 Hosted 线上验证。
- node --check research_domains/lrigit/architecture.js：PASS。
- validate_lrigit_brochure.py：PASS，35条。
- validate-flywheel.mjs：PASS，1280条断言、288个渲染状态。它验证既有飞轮未回归，不代表新增架构页有1280条专项断言。
- validate_topic_workflow.py：PASS；正式发布操作再次执行并通过。
- worktree_diff：11个相关文件，无 staged/unstaged/untracked 变更；未覆盖宣传册、飞轮或PPTX内容。

## 未通过和未执行项

全站 validate_lri_shell.py 仍报1123项旧页面Shell版本/metadata问题；失败摘要 SHA256 526b9078c042e004f5e81d85d16aebfe9d3b20f7c98930b58533cf8f526a9522。
全站 validate-insight.sh 仍在共享CSS/内联样式阶段报告30行FAIL；摘要 SHA256 444545d64f63a933be6196842ba80d4ffca25ae5104712fe60b65f8edbb65979。
本轮尝试重跑主线基线作精确差分时被平台安全检查拦截，不能宣称本轮完成了全量基线比较；未更改或放宽原校验器。
新增 validate-architecture.py 的写入被平台安全检查拦截，该文件未入库，未改通道重试。
AWMCP m4mac rb01 已确认CDP在线并取得独占lease，但正式站点 Playwright 检查被平台安全检查拦截，未执行页面打开、交互和资产HTTP检查。没有换工具补做同一受阻操作；lease已释放，未新建测试tab。故在线SVG加载、暂停/重播、真实手机/Safari与共享Shell语言切换仍未验收。

## 维护与接续

仅修改本专题及相关导航/Direct View登记。下一次调整先核对服务与Skill合同；需要画源码分层时先取得真实源码快照，再新增源码级证据，不把本页合同结构替代源码结构。后续重点是按允许的正常浏览器流程补完正式页面验收，而不是重复创建页面或绕过安全边界。