diff --git a/docs/continuation-status.zh-CN.md b/docs/continuation-status.zh-CN.md new file mode 100644 index 0000000..cb209d5 --- /dev/null +++ b/docs/continuation-status.zh-CN.md @@ -0,0 +1,81 @@ +# Web FreeCAD 接续执行状态 + +更新时间:2026-08-02 + +## 1. 当前目标 + +按 FreeCAD `1.1.1` 全功能对标方案持续推进 F0-F9 阶段门,完成实现、测试、兼容矩阵、发布门禁并同步云仓库。当前仍是 experimental 核心 Facade/OCCT 阶段,不能宣称已达到 FreeCAD 全功能兼容。 + +## 2. 仓库状态 + +- 分支:`main` +- 云仓库:`http://154.8.160.151:3000/wangdequan/Web_FreeCAD_Bitbybit.git` +- 最新提交:`293cff6 feat: add structured placement properties` +- 最新完整门禁:`./npmw run verify` 通过 +- Facade 测试:55/55 通过 +- 生产构建:通过 +- 本地开发地址:`http://127.0.0.1:5173/` +- 兼容真值表:`config/compatibility-matrix.json` +- 总体方案:`docs/freecad-full-parity-plan.zh-CN.md` + +## 3. 本轮已完成并推送 + +1. 重计算根因诊断、修复分支重算与诊断树。 +2. Linear Pattern、Polar Pattern 和基础 Hole 的 experimental OCCT 执行链路。 +3. 稳定拓扑签名、版本化 TopoRef、迁移、PropertyLinkSub 与保守拓扑历史回退。 +4. Sketcher 版本化 solver provider 协议、能力探测、取消/过期 generation 隔离和回放合同。 +5. 椭圆/B-spline 领域模型;基础 TypeScript solver 对未支持曲线返回明确诊断。 +6. 外部草图几何、稳定 TopoRef、持久化与 `topo-ref` DAG 依赖边。 +7. Vector、Placement、LinkList/StringList 结构化属性合同;Placement 深拷贝、校验、撤销、持久化和 UI 编辑器。 + +相关提交按新到旧: + +- `293cff6` structured placement properties +- `a8f902c` stable sketch external geometry +- `6786261` advanced sketch curves +- `e0b4817` versioned sketch solver protocol +- `4d94109` conservative topology history fallback +- `d3d88b2` LinkSub topology references +- `9def470` topology reference migration +- `1ed3527` basic hole +- `ce3b81c` polar pattern +- `8995b90` linear pattern +- `aeafc6c` recompute diagnostic repair tree + +## 4. 已确认限制 + +- 仓库没有 FreeCAD C++ 源码、Emscripten 工程或 planegcs WASM 产物;`SK-03` 不能标记完成。现有 `typescript-basic` solver 仅用于协议与基础模型验证。 +- Pattern 当前复制整个 Shape,不是 FreeCAD 局部特征历史。 +- Hole 固定原点/法向,尚无面定位、沉孔、锪孔、螺纹和完整孔标准。 +- 拓扑历史来自签名保守回退,不是 OCCT/FreeCAD 原生 Generated/Modified/Deleted 历史。 +- Placement 已进入文档属性,但尚未完整映射到所有特征执行器的 FreeCAD 局部坐标语义。 +- FCStd 仍以安全预检、metadata/proxy 和只读报告为主,尚未双向原生往返。 + +## 5. 下一步执行顺序 + +1. 完成 P2 持久化门禁:1000 次事务压力、迁移失败回滚、资源配额/垃圾回收、崩溃恢复点。 +2. 将对象 Placement 可靠接入 Part 基本体与可兼容特征的 OCCT 重算,补包围盒/撤销/保存黄金测试。 +3. 继续 TSN:把拓扑快照和历史结果接入实际重算 generation,迁移外部几何与 LinkSub,暴露 ambiguous/deleted 修复流程。 +4. 在获得 FreeCAD `1.1.1` 源码/构建输入后完成 `SK-03` planegcs WASM POC;此前继续补充回放夹具、约束分类和 Sketch 编辑事务。 +5. 扩展 PartDesign:Mirrored、MultiTransform、Loft/Pipe/Groove、Thickness/Draft,以及 Pattern/Hole 完整语义。 +6. 完成 FCStd 原生对象/属性/Shape 双向映射和 STEP/IGES/STL/Web CAD 包导入导出。 +7. 按核心优先级完成 TechDraw、Spreadsheet、Draft、Assembly、BIM、Mesh、Surface、FEM、CAM 等工作台。 +8. 最后通过跨浏览器、性能、内存、安全、可访问性、离线/PWA、升级回滚和发布差异报告门禁。 + +## 6. 接续操作 + +```bash +cd /home/mes123456/working_Web_FreeCAD_Bitbybit +git status --short +git log -5 --oneline +./npmw run verify +``` + +每个独立里程碑必须: + +1. 更新实现与聚焦测试。 +2. 更新 `config/compatibility-matrix.json` 和两份实施方案中的真实状态。 +3. 运行 `./npmw run verify`、`git diff --check` 和 JSON 校验。 +4. 单独提交并推送 `main`,不得把凭据写入仓库。 + +暂停点:从“P2 持久化压力与迁移回滚门禁”开始继续。