文档系统实施与正式验收¶
本页只解释文档系统的交付证据。平台固件资格仍引用原精确代码索引,MCU HIL
仍为 not_executed。文档渲染、浏览、发布或归档成功不会增加芯片和板卡资格。
58 项源台账是任务、实现和验收值的
唯一权威;可读清单和
逐项原字段由同一源自动生成。
文档交付结果索引定位真实执行及需要正式证据的范围,
不另维护一份任务完成率。
按证据范围解释状态¶
状态或记录 |
能证明的范围 |
不能自动证明 |
|---|---|---|
|
当前页面、图源、CLI、门禁和交付机制已落入源文件 |
原退出条件、实板或公开部署全部完成 |
|
已发生的开发检查、预览、示例、图文审查或工具回归 |
当前未封存 HEAD 的正式发布资格 |
|
已准备执行路径,仍待本次准确来源的实际证据 |
可据此升级为 passed |
clean-source 文档构建 |
本次干净源码、锁定工具、双语 HTML 和 Doxygen 输出 |
固件重新执行或 MCU HIL |
文档 package/verify |
同字节 payload、三类源码身份与许可闭包 |
已公开部署、下载或独立恢复 |
post-deploy 与独立 restore |
真实站点与下载身份、恢复后字节及适用浏览范围 |
全部历史固件 tests、产品安全或长期支持 |
原退出条件完整保留。发布、发布后验证、独立恢复与长期存储、最终独立审查,以及 浏览器/放大/打印/离线验收要取得各自正式证据后逐项关闭。具体待处理编号和 实际状态以源台账及同源可读清单为准,不从一张预览截图推断完成。
当前源码与既有资格分别定位¶
正式文档包的 documentation-manifest.json 分开记录 documentation_source、
code_source 和 qualified_code。前两项由实际干净构建和封存取得,不能预先填入
将来的 commit 或 tree。预览先读 documentation-build.json,修改过的工作树明确
是开发来源。本站引用的固件资格 cc6a065c 及两份原 SoC 索引保持原身份,见
软件验证入口。
验收结果索引中的空值表示该正式身份、locator 或摘要尚未取得。结果应由实际
receipt 回填,并核对同一 source/config/tool/output;不能用占位摘要或自行填写
passed 代替执行。
长期取得证据¶
正式证据预期随独立 GitHub 文档发行版本提供:文档离线包、文档执行证据归档、 外层 receipt 和校验摘要分开交付。索引记录真实 release URL、资产 URL、归档 SHA-256/bytes 和归档中的 member path。取得后先检查归档字节,再核对指定 member 的 bytes/SHA-256,最后读取实际命令、退出码和原始结果。
当前结果框架不提供尚未发生的 release 或资产下载链接。仅有 /workspace 或
/tmp 定位不足以建立长期取得性;短期 CI artifact 也不能替代所需的长期版本。
索引中的 expected_member_paths 只说明待封存目录安排,必须在实际归档生成后
用其 inventory 确认,才可改为已取得成员。
独立恢复须从公开取得的同字节包进入新的根目录,使用实际浏览器核对桌面、窄屏、 放大、打印、离线导航、搜索、本地图和关键读者任务。保存实际观察及失败重试, 不要把 XML/HTML parser 检查或 PNG 源图审查称为这些浏览器验收。
交付和拒绝规则见 文档交付合同。