工作区目录适配验收

2026-09-08，本次只适配工作区整理后的目录引用和定位逻辑。以下是一次性验证记录，稳定要求见 DEPLOY-WORKSPACE-LAYOUT 与 TEST-WORKSPACE-LAYOUT。

完成内容

更新协作指南、需求、测试说明、源码与发布 README、ADC 示例命令和资料校验命令。
修复本机测试入口的工作区根定位；更新部署、手工更新、frpc 安装、OTA 构建、发布、晋升和修复工具的工作区路径。
发布记录只改 artifact_path，逐条比较确认其他字段不变；当前 VERSION 为 1.1.1，FEATURE_UPDATED_AT 为 2026-09-08T10:19+08:00，均保持原值。本次不是可部署业务功能新增或优化。
保留镜像内部 project/离线依赖/ 协议及设备路径；既有发布二进制未修改。归档只修正当前导航，历史代码块和清理记录保持原文。
编辑器的相对层级仍正确，无需修改定位代码。接线 DOCX 未发现本次搬迁涉及的旧路径，无需重新生成；官方 PDF 未修改。
所有当前维护文档的 Markdown 本地链接校验通过；两篇已不存在的屏幕控制说明/连接简表引用，改指现有 HUB75 接线与首次上电检查文档。

验证结果

验证	结果
原工作区测试入口	Python 418 passed、9 skipped；前端 70 passed；静态 JavaScript 与文案目录检查通过
最终隔离副本完整测试	Python 421 passed、9 skipped；前端 70 passed；静态检查通过
新增路径回归	不同当前目录下定位中文空格路径；清理保留环境与人工数据；越界清理在删除前拒绝，3 项通过
镜像编辑器	原工作区与隔离副本各 14 项通过，包含主工程配置编码交叉校验与无窗口 GUI 测试
mock 服务	隔离副本从测试环境启动，页面与 `/api/status` 均 HTTP 200，正常关闭并清屏
清理	隔离副本执行 `clean` 后配置、人工标记、venv 和依赖指纹保留，work/runtime 已删除
ADC 标准库示例	新位置 `--self-test` 通过，未访问硬件
Shell 脚本	修改的三个安装/更新脚本语法检查通过，未执行部署
发布工具	完整 Python 套件覆盖新目录下的临时 OTA 产物与发布记录、失败回退、同版修复和镜像候选；未导出正式产物

隔离副本包含独立源码、测试入口、需求、完整其他依赖、编辑器源码和复制的测试环境，位于含中文及空格的目录；测试命令从副本外调用，未引用原工作区源码或历史导出产物。9 项跳过为现有工具/平台条件（媒体编码工具及特定环境用例），并非路径失败。未运行板端、真实 systemd、真实 OTA、TF 卡或实屏验收。

历史材料状态（用户已确认，无待办）

发布更新相关/OTA数据包/1.0.1/matrix-screen-controller-1.0.1.ota
发布更新相关/导出包/1.0.2/matrix-screen-controller-1.0.2.img

以上为本次检查时的历史状态。用户随后明确：历史导出 IMG 缺失默认视为主动清理空间，属于正常情况，不影响开发；OTA 今后保留，但 1.0.1 不再追补、提醒或要求验收，不影响使用。两项均不属于待修复问题，原发布记录保留。其余六个登记产物在当时检查的新路径存在（只检查存在性，未读取大型 IMG）。

修改清单

可复核的文本差异见路径调整.patch。本次修改以下 28 个已有或新增工作文件，另新增本验收目录：

AGENTS.md
发布更新相关/README.md
发布更新相关/镜像编辑器/编辑器源代码/README.md
发布记录.json
各种归档/20260819_离线镜像1.0.2真实TF卡验收/README.md
各种归档/20260825_离线镜像1.0.3启动分区空间修复/README.md
各种归档/20260907_OTA1.1.0软件安装节点验证/README.md
各种归档/20260908_OTA1.1.0运行目录修复验收/README.md
整体开发需求/01_网页配置端需求.md
整体开发需求/02_屏幕底层控制接口需求.md
核桃派软件源代码/README.md
核桃派软件源代码/kernel/README.md
核桃派软件源代码/scripts/build_ota_package.py
核桃派软件源代码/scripts/deploy_walnutpi.sh
核桃派软件源代码/scripts/export_release.py
核桃派软件源代码/scripts/install_frpc_system.sh
核桃派软件源代码/scripts/promote_image_release.py
核桃派软件源代码/scripts/repair_ota_release.py
核桃派软件源代码/scripts/update_walnutpi.sh
核桃派软件源代码/tests/test_kernel_artifact_dependency.py
核桃派软件源代码/tests/test_ota_checkpoints.py
核桃派软件源代码/tests/test_release_image.py
测试相关资料/如何测试/本机测试环境/README.md
测试相关资料/如何测试/本机测试环境/local_test.py
测试相关资料/如何测试/核桃派点阵屏控制服务测试流程.md
硬件相关资料和硬件的连接/M5Stack Unit ADC v1.1相关内容/02_ADS1110使用与开发约定_给Codex.md
硬件相关资料和硬件的连接/M5Stack Unit ADC v1.1相关内容/官方资料/来源索引.md
核桃派软件源代码/tests/test_workspace_layout.py

临时副本清理状态

隔离工作区内部的 clean 验收通过，但随后删除整个本次隔离副本的 PowerShell 操作被自动审批拒绝，仅返回 blocked by policy，没有更具体原因。副本及验证日志仍保留在 Codex 专用临时目录的 workspace-path-adaptation-20260908/ 下；该目录不是项目依赖，不应被后续构建引用。未绕过拒绝执行其他删除方式。

5.6 KiB Raw Permalink Blame History Unescape Escape