72 lines
5.6 KiB
Markdown
72 lines
5.6 KiB
Markdown
# 工作区目录适配验收
|
||
|
||
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](路径调整.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/` 下；该目录不是项目依赖，不应被后续构建引用。未绕过拒绝执行其他删除方式。
|