VitePress完整构建按阶段短进程执行

决策证据

生命周期诊断已证两阶段major GC释放大量JS对象，但每次RSS只降约32MB，仍超1536MiB。不是指标采集失败，也不据此认定某个系统分配器bug。停止同进程回收/堆参数路线；新方案利用进程退出解除阶段资源重叠，原资源上限不变。main8a0cab79为文档基线，当前候选仍未验收；28/66、磁盘未开始。

定稿实现与等价边界

保持VitePress1.6.4原客户端bundle、原服务端bundle、原页面render/sitemap/buildEnd三个步骤及先后次序，每步使用新的短进程；前一步exit0并写出可核SHA的checkpoint后才执行下一步。控制进程仅Node内置fs/crypto/child_process，不加载VitePress或保留Rollup图。三个阶段不得并行。

因为锁定版无公开分阶段API，使用明确维护且严格固定源SHA的构建适配：读取现有chunk-D3CUZ4fa.js（SHA256 07d45c356e7c850c2454904949f4b0b95c1d4a2d92119cbdaf4d419ae20dde98），只在独占cache目录生成副本，不写node_modules/依赖锁。固定文本锚点各只出现一次才允许：bundle入口接render checkpoint、client/server分支选择、输出checkpoint、server临时产物延迟清理；import.meta.url固定到原模块URL，唯一相对chunk导入指向原文件，保证原客户端/主题/require路径不变。复制前核所有bare依赖从新旧位置resolve一致，漂移立即失败，不自动修补依赖。

client checkpoint保存原完整RollupOutput与pageToHashMap；server checkpoint保存原完整server结果；render读取二者交给原函数。二进制资产用明确tag无损还原，checkpoint≤64MiB/份、≤128MiB总，必须文件SHA与stage/source pins核同；源不漂移、每阶段只执行一次，失败首停，不把checkpoint存在当成功。最终仍写标准.vitepress/dist，不另造发布目录或跳过页面/死链。只支持现用SPA模式；MPA等未经等价核对的模式明确拒绝。

重用已审查的Mermaid浏览器分发/索引JSON资产与生成器释放，不复用Git预取，不盲合并旧分支。移除server前GC；索引后单次GC暂保留，真实收益另列。开发server不改。正式入口仍npm run build，内部串行worker；Node24.19.0/old-space1024MiB，父npm/控制器/worker/esbuild/Git均计入1536MiB聚合与32进程/180秒门。

资源与效率

复杂度仍O(全部页面及依赖图)，多一次配置加载，client/server重新渲染Markdown不能再共享进程缓存，预计增加2–5秒；阶段checkpoint约20–60MB临时I/O，受128MiB上界约束。工作量不缩小，最多1个worker，结束释放原生堆/编译器；预计全规模15–45秒，最坏180秒首停。正常输出保留一个dist；每次cache独占命名，失败checkpoint保留审计，成功后由已证闲置规则归档/清理，不创建常驻进程。

验证顺序

1. 窄控制验证源SHA/锚点漂移拒绝、stage/二进制checkpoint无损、篡改/过量/缺阶段/失败首停；生成副本可解析，不改原文件。
2. 同一个私有小站先原VitePress、再分阶段运行，完整静态文件逐件SHA对比（仅忽略确证的非语义不稳定项，并逐项解释）；包含全文搜索、公式/代码、锚点链接和404。此对照只证明适配边界，不替代产品规模资源资格。
3. 一次新独占实际全站npm run build，在原预算下完整0错误/0死链、源/锁核同，记录各阶段wall/CPU/RSS与总峰、checkpoint I/O、页/索引/产物数量。不以单阶段通过或小站通过当整站成功，失败保存并停止本路线。
4. 成功后浏览器核当前知识/结果/历史搜索与本地图渲染，完成文档/归档/门禁联动、窄提交双推及生产同SHA构建发布。Cloudflare/Webhook配置仍缺，缺时如实partial；不进入磁盘。后续依赖升级必须重新审查该适配，禁止按漂移代码继续运行。

Implementation / Parity Update · 2026-10-19

新增固定源SHA/锚点生成器、无损checkpoint、串行控制器和worker；原SDK/锁不动。两窄控制通过（78.9ms），后加入256KiB复用缓冲的流式SHA核对以避免控制器反复读取全索引对象，仍两控制通过（81.9ms）。worker有自己的阶段收据，CPU/峰RSS仅该worker自身，完整聚合以外层守卫为准。整体180秒首停/12秒后单次强停，不能将单进程收据代替聚合门。

同一四Markdown小站：原版完整构建1.179秒/CPU2.683秒/聚合525,451,264B，分阶段2.398秒/CPU4.474秒/聚合662,863,872B，34文件各1,030,868B。小规模因重复加载较慢、峰值较高，如实保留，不能拿它证明资源优化。最初逐件SHA不全相同；查明MiniSearch异步插入数字ID/词项顺序不同，导致索引模块与依赖该模块的内容hash变化。按8个实际URI、25词项/各字段频次与metadata归一核同，再仅归一这些确证的依赖文件hash引用，34文件无未解释差异、忽略文件0。两份原始dist、原始false对照和归一复核分别保留，不覆盖原始差异。验证脚本初次Array.map透传索引造成路径类型错误，修正显式参数后才完成核对，未放宽对照。

此对照证明锁定版当前SPA小站的分阶段功能等价边界；没有证明真实大站资源或发布。下一一次原预算真实全站资格a16，保留a12/a13全部失败和部分产物。

Full-Scale Qualification Update · 2026-10-19

a16真实全站client已完整输出，但还未进入server，7.509秒时聚合1,669,742,592B超门，一次SIGTERM无强杀；源1207文件/21,156,502B稳定、2004文件部分输出保留。峰值npm70,762,496B、控制器96,829,440B、worker1,399,357,440B、esbuild102,793,216B；峰8进程。此时完整RollupOutput正在checkpoint字符串化，复制了已在dist存在的代码/资产，造成新的重叠。根wait4只记到0.436秒已回收CPU、97,288,192B退出峰，尚未回收worker不能算完整CPU或全树峰，聚合实测仍为失败依据。未完成server/render，不能称整站通过。

Checkpoint Refinement Plan · 2026-10-19

停止复制完整RollupOutput，按锁定原renderPage/resolvePageImports/build源码的实际消费合同，仅序列化render所需元数据：output的type/fileName/name/isEntry/isDynamicEntry/facadeModuleId/imports/dynamicImports/moduleIds，以及完整pageToHashMap。SPA路径不消费chunk.code或asset.source；真实JS/CSS/字体/JSON资产已由原bundle落完整磁盘，server页面仍从实际SSR模块import，不用checkpoint代替内容。MPA继续拒绝，源码SHA漂移仍失败；不删任何站点输出/搜索项/页面。

此修订缩小的是内部阶段通信数据，原站点工作量与功能不缩小。新增投影O(chunk数+保留元数据)，目标checkpoint合计≤4MiB/实际目标≤1MiB，硬上限原64/128MiB不放宽；预计减少约数十MB序列化暂存，实际以测量为准。控制加入必需字段/二进制输出不被修改的核对；重做同小站产物等价（原始baseline不重建、原差异仍保留），再一次新全规模资格a18。a16及部分checkpoint完整保全，禁止重跑该attempt。不调整Node/堆/1536MiB总门或进程计数范围。

Qualification / Separate Review Update · 2026-10-19

a17同四Markdown小站元数据版：2.058秒、CPU4.084秒、聚合593,870,848B，34文件/1,030,868B；按前述实际URI/词频/metadata及确证依赖hash归一后无未解释差异，忽略文件0。相对原版1.179秒/525,451,264B仍较慢、峰较高，不用小站证明优化收益。

a18首次实际全站常规npm run build完整exit0：15.003秒、CPU40.671秒、聚合RSS1,507,000,320B、峰8进程（Node3/esbuild1/Git4），无超时/终止/强杀，1207源文件/21,160,016B前后SHA稳定。Node24.19.0、old-space1024MiB、180秒/1536MiB/32进程原门未放宽。输出2575文件/109,918,291B，client/server/render和知识门完整通过、0构建错误/0死链错误；仍有既有43条知识风险提醒与大chunk提示，不声称0警告。I/O瞬时峰未知。

阶段	wall ms	自身user/system CPU μs	worker自身峰RSS B
client	7087.421	8949421 / 1235288	1249542144
server	6141.685	8169052 / 1076436	1154449408
render	1078.974	1542844 / 341523	464535552

worker收据不包括全部后代，与上述全树门分别记。client/server checkpoint为698,599/349,577B，合计1,048,176B（比1MiB少400B）；SHA分别c80da835e6e86bdcfaa5a8561d3f268e370ee50892164400644ddbee49beb0de、231d4aebcf4361ae5d2903ddae9c2fe251006ba0fb4678d74645f831065ddf26。只传元数据，原JS/CSS/字体/索引输出完整，未调整页面或分词。

锁定SDK实际resolveConfig枚举568个Markdown及默认404，569页全部输出，无缺页。hashmap568项不含默认404；此前550页统计排除了19个既有public/archive下Markdown衍生页，两种口径不能相减推断丢页。搜索索引11,759,266B、7716节/167653词项，当前知识/五轮结果与旧知识均包含。随后新增文档使最终提交构建数量变化，a18数字不回改。

浏览器实际搜索“正式五轮与分离审核”“新a02完整五轮”“Warmup”，分别命中并打开中断知识页、新五轮结果及既有术语页；同源JSON请求200/304。中文长拼接查询无结果的一次如实保留，改为已有标题短语后命中，未改分词。独立私有harness复用组件原initialize配置，实际flowchart/sequence均生成SVG（2/2），全部依赖同源；不冒充完整组件挂载/卸载覆盖。当前首页为既有ImmersiveHome营销布局，HomeExtras进度文案未挂载，浏览器不能据此证明首页展示28/66；当前数以知识总览/状态页和结果为准。页面错误日志为空；测试harness请求缺省favicon.ico返回404，与站点链接/功能资源分列。

分离源码复核核固定SDK/导入位置、SPA消费字段、首失败停止、源pin与checkpoint校验。发现Mermaid既有目录缺manifest的ENOENT会被误当目标不存在，改为仅lstat缺目标可继续；现有未知目录/缺manifest拒绝，防止覆盖无归属文件。6搜索/生命周期/阶段控制通过（102.8ms），209资产/104模块/923相对引用逐件核同，93部署门控制通过；产品/依赖锁/node_modules无修改。未实测触发180秒controller超时，不将源码审核写成故障注入通过。

本批结论：完整本地E2资源/输出及代表性浏览器功能通过；交付仍partial。Cloudflare认证和Webhook配置尚缺，网站上传及线上新内容核对未做。后续最终提交源另一次受同门约束构建并保留私有收据，不覆盖a18。28/66、中断限定E4边界及旧失败不变；网站闭环前不进入磁盘，不重跑手机/历史指标。

Owner Decision / Delivery Update · 2026-10-19 · 本批记录配置缺口

Owner回复“本批先记录配置缺口”。本批据此以partial记录Cloudflare发布认证与交付Webhook未配置：网站未上传、通知未发送，后续恢复配置后再补发并独立核对线上内容；本次不继续催配、轮询凭据或重试发布。该决定不把缺口写成成功，也不增加已验收指标数。

已完成实现提交为1b305d7ac9a39b97ac2fa32b6953ad07f7287634，GitHub主线独立核同；GitLab本批唯一一次推送在SSH握手超时，不重试。该提交完整构建a19在原Node24/1024MiB堆、180秒/聚合1536MiB/32进程门内通过：15.338656秒、CPU40.528574秒、聚合RSS1,455,226,880B、峰8进程，源稳定，无超门或强停。输出2577文件/109,974,051B，569预期页全部存在；完整索引11,778,292B、7719节/167832词项，最终记录与原结果均包含。完整本地E2与中断限定E4分别成立。

随后一次只读线上核对确认知识页为旧内容，新五轮结果、分阶段构建记录及该批归档均HTTP404，不能用旧线上页冒充本批发布。Python本地证书链检查失败原样保留，系统curl在默认TLS验证开启下核得上述结果，未绕过TLS。

整体仍28/66、剩余38，磁盘读取率未开始。本次Owner决定处理的是本批配置缺口；原“发布并核对网站再进入下一项”的顺序尚未被明确修改。后续范围依据Owner对下一项推进的指示，历史指标/旧attempt不重测、不补轮或拼接。公证继续暂缓，ARM190仅本机内部开发签名授权不变。

Owner Decision Update · 2026-10-19 · 带交付欠项继续下一指标

Owner最新决定 · 2026-10-19：“允许继续下一指标，保留交付欠项”。当前唯一指标转为进程磁盘读取率 ios.process.disk.read_rate，方案已落盘，正式0/5；整体28/66、剩38。网站发布/Webhook/GitLab欠项保持partial，不再阻止当前指标推进。此前等待顺序答复的段落为历史。当前执行磁盘读取率方案，不回改上述历史结果。

New Recovery Decision · 2026-10-19 · 轻量调度器

文档类型 devlog 增量。当前Lab18最终同提交网站构建8.453秒时，聚合RSS1,640,742,912B超过既定1,610,612,736B，client尚未完整结束。峰值记录包含npm约69.80MB、Node控制器98.52MB、构建worker1,340.52MB、esbuild131.91MB。此前中断a18/a19完整通过只证明历史源，不替代本批；本增量不回改旧数字。整体30/66，当前发送正式0/5、Gate R未关。RVI需要Owner在本机Terminal完成一次提权资格，目前尚无结果；等待期间可独立修复交付构建路径。

定稿修复：正式入口仍 npm run build，生命周期prebuild、原固定Node24.19.0/SDK SHA、完整client/server/render三阶段及checkpoint合同保持。以Python标准库控制串行步骤，Node仅做短时prepare/verify或一个重型worker；控制器不再在重型worker执行期间保留Node地址空间。系统Python已是prebuild依赖，不引入新运行环境/依赖。原Node控制器的输入树SHA、SDK/生成runtime漂移、阶段收据、checkpoint和首失败停止检查提取成短时命令；prepare结束前输出独占目录，所有阶段前后仍重新核输入与SDK/runtime。重型worker代码和VitePress生成适配语义保持。未知/额外参数拒绝，Node版本或manifest不符拒绝，最终成功仅在三阶段全部校验后打印。

时间复杂度仍O(全站输入bytes + 页面及依赖图)，输入重复核验次数同原合同；Node检查进程额外启动最多7次，预计增加0.3–1秒，构建目标仍15–45秒、最坏180秒；仅单一子任务，不并发重型worker。Python调度器预计常驻10–25MiB，实际按全进程树测量；预期回收原98MB控制器大部分驻留，不预先承诺整站通过。继续原1536MiB/32进程/180秒与1024MiB堆，不抬预算、不删除页面/搜索项/归档、不改依赖锁/node_modules。I/O峰若无测量写unknown。

每个子命令创建本次专用进程组；Python总deadline从prepare前开始，任何非零/超时/外部SIGINT或SIGTERM均首停并终止本次子组，12秒无响应再强停，不能留下执行中的下一阶段。外层监督继续计入npm/Python/检查器或worker及全部后代，不以单worker峰代替。增加有意义的故障控制：首个非零不进入下一步、全局deadline耗尽不启动子任务、真实超时回收子组、外部中断回收子组；源码/SHA/缺收据/checkpoint篡改控制沿用并补调度准入覆盖。

验证先保存当前失败产物与源码pins，取得本修复前同源规模基线（只一次，原门失败即停，失败完整保留）；新四页独占小站依次运行旧控制器与新调度器，逐件输出SHA/搜索语义对照，仅允许已有确证的MiniSearch编号/词项顺序及依赖hash引用归一，不忽略任一文件。然后一次新全站 npm run build，检查三阶段完整、0错误/0死链、所有Markdown及默认404全覆盖，完整搜索项与当前页链接/内容；报告前后耗时/首个阶段响应/CPU/聚合RSS/输出量。失败不盲重跑，不用小站成功代替全站资格。通过后独立源码复核、文档/归档/时间线/机读同步、窄提交和双推，最终同提交构建保留收据；发布与Webhook原配置欠项仍partial，不重复索取。新构建方案与工具成功不改变30/66或发送0/5；未获Gate R证据不进入产品193/正式/接收。

Lightweight Controller Validation Update · 2026-10-19

本次原控制器同源规模基线8.356秒/聚合1,613,430,784B超门；Python轻量调度器完整候选17.224秒/CPU45.946秒/聚合1,511,391,232B、峰8进程，全部阶段与577页输出、716本地目标/520渲染锚点通过E2。7故障控制与4Node控制、小站34产物语义对照成立；小站2.196→2.691秒/602,931,200→516,177,920B，明确时间换空间，未称全站提速。源1232件前后稳定，SDK/worker/依赖锁不变；所有旧失败与两项控制失败保留。完整实现、偏差、限制及剩余门见本批结果。最终同提交构建与双推以私有收据为准；网站发布/通知仍partial。整体30/66、发送正式0/5、Gate R未关，不新增指标计数。