Repository navigation
ModelDock lets you open reconstruction models and CAD files directly in an editor or supported desktop host. This release adds bounded large-file previews and a shared model-comparison workflow.
新增功能
- 四个入口默认允许最高 8 GiB 的源文件:VS Code、DeepSeek Harness、兼容的 OpenAI Desktop 文件入口、独立本地查看器。
- 超过 5 GiB 的二进制 PLY/STL 使用有界分段读取:PLY 最多显示 30 万个采样点,STL 最多显示 10 万个采样三角面;保留原始数量、坐标原点及采样说明。
- 多模型工作流:添加模型 → 选择参考/真值 → 按需对齐 → 比较。支持多 PLY 叠加、同步分屏、透明度、局部刚性 ICP、显式平移/旋转/缩放和重置。
- 可导入 STL 网格作为参考真值,计算双向距离统计、RMSE、P95、采样最大值、Chamfer、精确率、召回率和 F-score;支持误差热图、逐个对参考评价,以及 JSON/CSV 导出。
- 自动刷新保留视角、其他模型、参考选择及变换;中英文界面。
安装包
发布工作流会自动附加以下文件:
| 文件 | 用途 |
|---|---|
| modeldock-0.2.0.vsix | VS Code:扩展菜单 → 从 VSIX 安装;也适用于在 VS Code 中使用 Codex 的工作流 |
| dsh-plugin-modeldock-0.2.0.tgz | DeepSeek Harness 原生文件预览插件 |
| modeldock-openai-0.2.0.zip | 支持文件入口及授权资源读取的 OpenAI Desktop 插件 |
| modeldock-0.2.0-source.zip | 完整源码、预构建运行文件、安装包、许可及匹配的 CAD 依赖源码 |
| SHA256SUMS.txt | 四个归档的 SHA-256 校验值 |
使用说明:中文 README · Harness 安装 · OpenAI Desktop 安装。
验证与边界
- 105 项自动测试;共享浏览器 15 组、对比界面 9 组、OpenAI 旧资源路径 7 组、大文件范围路径 6 组,另有真实 stdio 验证。
- 真实安装的 DeepSeek Harness 0.2.2-alpha.2 Web 通过 8 组检查,包括超过 5 GiB 的 PLY/STL;真实 VS Code 1.96.4 已在 GitHub CI 中通过四阶段原生验收,包括这两种大文件。
- 大文件用例使用真实稀疏文件,验证大小、偏移、范围读取和渲染,不代表密集 5 GiB 数据的吞吐性能基准。
- 5 GiB 能力是二进制 PLY/STL 的采样预览;大型 PLY 网格当前仅显示采样顶点,面拓扑会明确标为省略。其他格式保持 128 MiB 普通解析边界;不支持完整 5 GiB STEP/IGES/BREP 转换。
- 比较指标描述加载/采样后的几何,最大值不是精确 Hausdorff 距离;单位必须确认,ICP 不自动修正比例,也不保证全局配准。
- OpenAI 使用真实应用和 MCP 服务、模拟 Desktop 宿主进行验证;尚未完成专有 Desktop 软件的实际安装验收。CLI、Work Web 和移动端不声明原生 3D 文件入口能力。
- 发布前依赖扫描为 0 项已知漏洞;这不等于独立安全审计。
详见 验证记录。原始项目源码和原创样例采用 MIT;CAD 依赖保留自身 LGPL 许可,匹配源码随完整源码包提供。
最终发布提交:2f93e45f0b47ee7f842abd9f86ddcc4e79983c4c。完整 CI 已通过,包含浏览器流程、依赖审计和独立的 VS Code 原生任务。