进度口径与目录地图

进度唯一真源是 tasks/registry.json（改完跑 pnpm tasks:sync 重建 tasks/BACKLOG.md，永远不要手改 BACKLOG）。 本页只解释"怎么看进度"，不复制进度数字。

看进度的正确姿势

想看…	命令 / 位置
现在到哪了、下一步做什么	tasks/BACKLOG.md（自动生成视图）
改状态 / 加任务	tasks/registry.json → pnpm tasks:sync
状态一致性校验	python3 tasks/check.py
真实实现边界与证据	docs/AI-SAAS-BRIDGE.md、当前回归报告；docs/VERIFICATION-V1-V2.md 为早期验证记录
接手顺序	docs/CONTINUE-DEVELOPMENT.md
风险与报价口径	docs/ROADMAP.md（旧报价/周期已过时，不能覆盖最新验证报告）
当前能跑的东西	sh tools/start-demo.sh → http://127.0.0.1:8123

三个常见误读

1. "66 项 / 173 人日"是完整项目的计划数据，不是已完成量，也不构成当前报价或工期承诺。
2. V-01 / V-02 两项验证通过 ≠ P1/P2 阶段完成。已完成的是一次修复复验（30 项 Vitest、23 项浏览器断言、10 项 Python 测试， 数字为当时历史记录，当前应以实际执行 pnpm verify:ci 为准；开发替代链已移除）。
3. 状态 done 必须带 verification（真实跑过的命令/证据），否则 pnpm tasks 直接 FAIL； owner: external|client 的任务不占产能但会卡商业化节点。

目录地图（依赖方向强制单向：apps/* → packages/*，workers/* → packages/*）

目录	里面有什么	状态
packages/design-json/	真源 schema（zod）+ 版本快照/回滚（VersionHistory：kind + AI 溯源 + 确认指针 + 崩溃恢复）+ 条码守卫	已实现并验收（P0-04、P1-10），公共入口导出真实 schema
packages/dieline/	mm 几何、线语义、UV 图集与不变量、折叠求解 packages/dieline/src/fold3d.ts（FoldedModel.flapClosure 是摇盖闭合唯一口径）	已实现五个二维结构族：四摇盖、反插式、自锁底、套筒、邮寄盒；.mjs 是唯一几何真源；3D 历史验证仍限摇盖族且当前暂缓
packages/editor-core/	正式 2D 内核：packages/editor-core/src/geom.ts、style.ts、stage.ts、scene.ts、layers.ts（纯 TS、DOM-free、mm 单位）	已实现并验收（P1-03 done，提交 5618668）：Stage 是 mm⇄px 唯一换算口，buildStageScene 产 DOM-free mm 图元，LayerList 提供 z 序/命中测试；命令系统与图层树 UI 属 P2-01/P2-02
docs/demo/	当前用户工作台：创意、素材、2D 编辑、团队项目、品牌、模板、导出	正式启动为空设计；历史测试素材仅在独立测试模式开放
workers/ai/	Python 图片处理服务、Seedream 生成、原图回放、候选区域、分割与导出桥	已接企业作业服务鉴权；正式模式缺共享凭证时拒绝匿名付费调用
tools/	runtime 生成、Design JSON 校验、Chromium 校稿渲染、PDF 页面修正、独立文件复验	已实现
apps/api/	Node HTTP SaaS 服务：账户/团队、项目版本、资产、品牌、模板、协作锁、平台额度、持久 AI 作业与导出队列	已与当前用户工作台贯通；当前数据实现是 SQLite，本机/单实例验收不能当作分布式高可用验收
apps/web/	可复用编辑器、协作与历史 3D 模块	用户工作台入口在 docs/demo/；3D 按用户决定暂缓，不在当前主流程展示
infra/	容器与本地依赖（postgres/redis/minio）	docker compose 可用；生产部署属 P3-11
docs-site/	使用指南、维护资料与 check.mjs	独立锁定依赖已安装并构建，.vitepress/dist 随发布包提供 /help/；不修改根 workspace 依赖

docs/demo/assets/runtime/rectangular.mjs 与 workers/ai/runtime/design-schema.mjs 是生成物 （node tools/build-runtime.mjs），改源码后重新生成，不要手改生成副本。

环境事实（实测，别重复探测）

Mac Studio M5 Max / 128 GB；Node v22.23.2；pnpm 11.19.0；系统 Python 3.9.6（无 pyyaml 等第三方包， 别在跟踪脚本里引入需安装的依赖）；docker/ffmpeg 可用；无 Blender；ComfyUI 当前未启动； Apple Silicon 无 CUDA。仓库根路径含空格 → 命令里的路径必须加引号。

跑 pnpm 脚本时建议带 --config.verify-deps-before-run=false（本机已有依赖环境，避免 pnpm 触发重装）， 这不是跳过测试。

给 worker 派单纪律（本站点相关）

• 只派 delegable_to_qwen: true 且状态 ready 的任务，派单时写清"只可编辑这些文件"。
• 不要并行拆有依赖的链（几何 → UV → 贴图 → 3D 同步必须单线）。
• worker 不得自己标 done；改到渲染输出必须附黄金图对比。
• 改 packages/design-json 或 packages/dieline 的 PR 必须同时更新本站对应页面， 并把 node docs-site/check.mjs 的输出贴进 PR 描述（口径漂移是这类项目最贵的 bug）。