You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
具体目录与导航结构在首批开工前说明调整理由、方案及影响;随文档批次逐步拆出对应 API 的实现模块;box 样板及后续两类 API 沿此方案执行,不新增包。迁移已有参考内容时,同批更新来源、入链和锚点,保留仍有阅读价值的概念说明,不留下两份相互漂移的 API 正文。对已有可访问 URL 的必要变更明确处理跳转和 canonical。
源码核对方案(已确认)
随文档逐步拆出 API 实现,box 的构造、几何与检查器归入独立文件,API 汇总入口单独组织以避免循环依赖;通用模型机制仍共享。
每日小批次是持续维护和质量控制的节奏,不把每日更新次数作为排名保证。Google 明确说明,仅为了让站点显得“更新鲜”而增删内容并不能提升整体排名;优先提供对读者完整、有帮助且准确的内容。参考 Google 的内容质量指南。
每页使用准确且有区分度的 title、H1、description,自然说明 API 名称、Code3D 与实际建模用途;通过分类入口、README、概念页及相关 API 建立可抓取的内部链接。HTML 与 Markdown 共用内容来源,延续现有 canonical 机制,避免近似重复的关键词页面。参考 Google Search Essentials。
发布时核验实际页面、canonical、sitemap 与可抓取性。若提供 lastmod/lastUpdated,只反映真实内容更新,不因构建或发布日期统一刷新;站点地图中的 lastmod 应对应实质变更。参考 Google sitemap 指南。
搜索效果在发布后通过 Search Console 的索引、展示和点击趋势观察;源码完成、线上发布、搜索收录分别记录,不把构建成功或站内搜索命中当成 Google 已收录。
为
@code3d/core的每个面向使用者的 API 补齐可独立查阅的文档,先确定用途分类,再分批逐步实现。采用每天少量推进的节奏,兼顾内容质量、审阅成本和搜索可发现性。全部清单已实现并通过验收,原有 16 个 section、16 笔独立提交完整保留;本次合并时同步当前主分支的独立 frame、group options、metadata / withMetadata 及 tooling 契约,现有 95 个细页。兼容整合提交为
b4fe7de02f59acbd2614a592a4b8ce0586243b22,最终本地主分支合并提交为36ba351b363c85f8de3c12e69733a86f5d6bb805(core: merge complete api reference documentation,含Closes #232)。根入口 52 个值 / 83 个类型、tooling 83 个值 / 73 个类型,以及公开成员、Replicad / Three.js 互操作入口均已覆盖。95 页独立来源基准有效,297 条来源均能解析到真实提交。当前状态为 CLOSED:已验收、合并并推送到远端 main。2026-09-23 正常推送后,GitHub 远端 main 与 commit API 均确认
36ba351b363c85f8de3c12e69733a86f5d6bb805,Closes #232已自动关闭 issue,工作状态标签已清理。主分支和任务工作区均 clean,保留code3d-issue-232-core-api-docs-p61-0922和本地 5185/5186 服务。本次未推送版本 tag 或发包。此次远端 网站构建 已成功:95 页源码核对、326 个 HTML/Markdown 页面的链接/锚点/资源检查和
code3d-wwwartifact 上传通过。部署 job 按既有条件跳过,本次没有线上发布。CI 的 4 个浏览器示例分片、全 workspace 类型/测试、npm 包安装与示例验证、App 构建均通过,网站图片生成仍在运行,最终结果待更新。验收入口:完整导出索引、按用途浏览、Tooling 总览、App 示例。这些地址仅为本地预览,不代表线上发布或搜索引擎收录。
以下分节保留各批次交付历史;其中“下一节”“尚未完成”描述反映当时状态,最终进度以上述总览及已完成清单为准。
本地主分支集成(2026-09-23)
4510ccf3db597382d48dff779f1a56e9dc98ec81,其中已包含独立坐标架、模型 metadata 和统一空间追踪的新 API;先在任务工作区完成语义兼容,再无冲突集成到 main。frame细页和frame.ts作者入口,使该页继续使用独立实现来源;FrameObject、参考求解和生命周期仍在 runtime。group.ts同步{name, frame}、显式坐标选择和选项检查器,frame 不作为几何成员。model-data原 URL 改为 readonlymetadata/withMetadata的唯一现行说明,覆盖 symbol 键、浅层值快照、主输入继承与进程内边界。删除旧 get/setModelData 说明;补齐 Frame、GroupOptions、ModelMetadata、isFrame、modelOperationObject、Frame annotation owner 及追踪联合分支。36ba351b363c85f8de3c12e69733a86f5d6bb805的双亲为4510ccf与b4fe7de;本地集成已完成;现已按用户授权推送,并核实 issue 自动关闭及标签清理。点、曲线与轮廓(2026-09-22,已本地提交)
用户已验收本节,并授权继续补齐所有分类、每节单独提交。此节提交为
69d231fb775befdb3cd098291b4097ccd52d8966(core: document points curves and profiles,refs #232);继续沿用原工作区code3d-issue-232-core-api-docs-p61-0922、分支及 ownerw1:p61。curve-model.ts共享曲线装配与点列校验,planar-face-model.ts共享平面法向归一和资源释放。通用模型、面创建和拓扑参考继续由 runtime 拥有;有限坐标校验归 validation,坐标表示转换归 spatial。同步 root/authoringApi 导出,无旧模块转发入口,不新增包,不改变公开签名与模型值语义。/docs/packages/core/api/regular-polygon/。1baef99,新增/修改且未提交的源码不伪造提交哈希。1baef99中,但因尚未推送,远端暂未生效。成形操作(2026-09-22,已本地提交)
按最新授权每 section 一次本地提交,本节为
2e2cf49d64dba98b613224b6ae39aa632d6d2eb0(core: document shape construction operations,refs #232);未合并、推送或发布,后续继续完成全部清单。*-geometry.ts,四份算法内容逐字不变。模型方法、求解、身份和资源管理仍归 runtime;同步 root/authoringApi 与内部算法测试导入,无公开 API 或行为变化。operations/shape-construction.ts真实 App 示例及六个检查视图/配图,默认封面为shape-construction.png。网站分类 sidebar、README、旧章节锚点及细页链接、内部架构说明均已同步,原技术正文归入各 API 页。布尔运算与实体修饰(2026-09-22,已本地提交)
本节提交为
bb707e248ef98fe97db48020a396fd20bf3265ec(core: document booleans and solid modifications,refs #232)。仅本地提交,其他分类继续按每 section 一笔推进。boolean-model.ts共享操作数校验;cut 实例方法直接调用 runtime 原有组合机制。finishing 方法和原生拓扑算法继续共享,不改变公开签名、模型值语义或成形算法。operations/solid-operations.ts示例、六个检查视图和六张模型配图,默认封面solid-operations.png。更新分类导航、README、总览、shell 指南及内部架构说明;确认 runtime 的拆分影响后显式复核成形六页基准。原点与局部变换(2026-09-22,已本地提交)
本节提交为
ba87040b2557ca591196b75843c879b6a318d01c(core: document origins and local transforms,refs #232)。仅本地提交,其他分类继续按每 section 一笔推进。origin-center.ts,使用既有 isModelObject 校验保持行为;模型变换、组装配、拓扑、约束与参考身份继续归 runtime。公开 API 不变。operations/local-transforms.ts示例、六个检查视图与六张配图;README、sidebar、旧总览锚点、原点指南和内部架构同步。runtime 纯拆分后显式复核成形与布尔 12 页基准,累计 35 页。组合与相对摆放(2026-09-22,已本地提交)
本节提交为
757c8003e4ef2c3e4b4e85561e186a82a1dd1c39(core: document groups and relative placement,refs #232)。仅本地提交,其他分类继续按每 section 一笔推进。group.ts,originCenter 更新对应依赖和核对来源。runtime 提供内部参考解析和旋转表达式机制,关系上下文经既有 currentRelationSelf 获取,公开调用和求解行为保持一致。constraints/placement-api.ts示例、13 个检查视图与 13 张模型图;分类导航、README、relations 指南、总览旧锚点/细页链接及内部架构同步。逐项确认 runtime 纯拆分后显式复核旧 18 页,累计 48 页源码基准。拓扑与参考元素(2026-09-22,已本地提交)
本节提交为
e158009a3475b9419808e4abf3b12f4dce687866(core: document topology and references,refs #232)。仅本地提交,其他分类继续按每 section 一笔推进。operations/topology-api.ts示例、四个检查视图及四张模型图;README、分类导航、拓扑指南、总览旧锚点及细页入口同步。本节没有 Core 运行时代码变化。/docs/packages/*.md→:splat/。非标准映射和其它独立规则保留,Markdown-only agent 文档不添加 HTML canonical;Web README 同步。150 页、站点 base path、特殊 index 映射及非标准映射共四项验证通过。几何测量(2026-09-22,已本地提交)
本节提交为
420a6c5dac163eaa4cbff6939344fa4f8e51a75f(core: document geometry measurements,refs #232)。仅本地提交,其他分类继续按每 section 一笔推进。distance.ts,runtime 仅新增内部 DistanceInspectData 导出;实际有限几何测量、静态查询与求解代码不变。root/authoringApi 与内部架构说明同步,全部 runtime 相关页面复核后显式更新基准,累计 60 页。草图(2026-09-22,已本地提交)
按每 section 一次本地提交的授权,本节为
9f66bcbf99cc0b76a09d8965071140b6ce953da7(core: document sketch entities constraints and regions,refs #232)。sketches/sketch-api.ts、六个 source contexts 和六张真实截图;分别展示基本圆盘、弧线与孔/别名、约束矩形、派生圆环、多个区域、贴面开孔,并用数值断言验证几何结果。为清楚呈现贴面孔,将该示例相机方向设为[1, 2, 1]后重渲染并逐张查看。文字与字体(2026-09-22,已本地提交)
本节提交为
3d2db0c82c1ae0e6723ecd77fa6f571b326d1681(core: document text and font resources,refs #232)。材质与外观(2026-09-22,已本地提交)
本节提交为
be0d9a67434b9294bd3288b801fb48b93c42df9d(core: document materials and appearance,refs #232)。参数、时间与缓存(2026-09-22,已本地提交)
本节提交为
e13113755850e48f94d06f4234c480502999d847(core: document inputs time and caching,refs #232)。模型与类型总览(2026-09-22,已本地提交)
本节提交为
5b7b6fe43a934bf63d85a3aac1dbda0280b7da88(core: document model types and capabilities,refs #232)。扩展开发入口(2026-09-22,已本地提交)
本节提交为
c600453b38ab9b497e23f0a14cf0b927c401cee7(core: document extension development APIs,refs #232)。工具集成入口(2026-09-22,已本地提交)
本节提交为
6fa3cb8911b45c79242a1779d27a5df570bd4c93(core: document tooling integration APIs,refs #232)。最终覆盖与导航收口(2026-09-22,已本地提交)
第 16 节提交
2a246d203a79baca10374ef9b4aabdaaa89b4642(core: complete API documentation coverage,Closes #232)完成全部已列内容的本地交付。38e2d27,api.md 和 runtime.md 的原有标题/锚点全部保留。Three.js / Replicad 透传范围按集成限制及上游参考组织,内部导出不冒充公共构造器。范围与组织
@internal导出在覆盖核对中标明内部用途,不作为正常建模入口推荐。extrude(face, distance)与face.extrude(distance)。同名但不同语义的入口分清,例如模型.rotate()与关系中的rotate(),并互相链接。LoftOptions、RevolveConfig;共用的模型、参考和能力类型另设总览,明确不同模型支持的成员。packages/core/README.md和packages/core/docs/为唯一内容来源,由现有网站管线生成 HTML 与纯 Markdown。沿用现有英文文档语言与风格。概念和教程解释整体机制,API 参考解释具体调用,避免重复维护完整技术正文。建模 API 分类
box、cylinder、sphere、ellipsoid、frustum、regularPrism、tube、coilpoint、line、arc、bezier、spline;circle、ellipse、rectangle、regularPolygonsketch、实体与约束、.point()、.derive()、.face()、.faces();草图摆放与参考text、font、googleFontextrude、revolve、sweep、loft、wrap、thicken,包含对应模型方法union、cut、intersect;.fillet()、.chamfer()、.shell().originPoint()、.originVertex()、.originOffset()、originCenter、.rotate()、.scaled()group、.expose()、.relate()、on、align、offset、rotate、pivot/pivotVertex/pivotPoint、axisEdge/axisLine、旋转链的偏移成员、coupleRotationframe、origin、center、axis、plane、六向边界、曲线端点;id/kind、.flip()、.reverse()distance、.length、.area、.volume、.bounds()、.position().material()、颜色写法、@code3d/core/three入口及材质集成限制input、timeOffset、cache另外两个入口:
definePrimitive、replicad、getModelData/setModelData、自定义检查器、captureInspectData、inspectGroupMembers、dimension、boundsAnnotation、anchorAnnotation及关联类型。@code3d/core/tooling,按运行环境与资源初始化、模型求值及生命周期、快照与源码检查、关系和操作跟踪、草图工具、空间与拓扑工具、材质处理、内核缓存等用途组织。完整导出与成员清单已在本 issue 下方按文档归属记录;首批核对根入口、子路径、公开接口继承成员及类型。后续新增 API 同步维护。
分批实施清单
以下为建议推进顺序;一个分类可以跨多天完成。根据真实使用需求调整顺序时同步更新本 issue。
box作为首个参考页面。(已本地提交,尚未推送)box为样板拆出源码职责,建立每页独立版本、文件哈希及提交来源核对机制。(本地验证完成)69d231f,尚未推送)2e2cf49,尚未推送)bb707e2,尚未推送)ba87040,尚未推送)757c800,尚未推送)e158009,尚未推送)420a6c5,尚未推送)9f66bcb,已本地提交)。3d2db0c,已本地提交)。be0d9a6,已本地提交)。e131137,已本地提交)。5b7b6fe,已本地提交)。c600453,已本地提交)。6fa3cb8,已本地提交)。2a246d2,已本地提交)。已按用户最新授权补齐全部清单,每个 section 单独提交;复杂 section 分步实现与验证后形成一笔完整提交。以完整、可验证的内容为发布单位,不上线空白占位页,也不为凑每日数量拆出只有签名的薄页。首批的全量核对与导航工作可跨多天,不能为了完成计划而仓促铺开全部页面。
具体目录与导航结构在首批开工前说明调整理由、方案及影响;随文档批次逐步拆出对应 API 的实现模块;box 样板及后续两类 API 沿此方案执行,不新增包。迁移已有参考内容时,同批更新来源、入链和锚点,保留仍有阅读价值的概念说明,不留下两份相互漂移的 API 正文。对已有可访问 URL 的必要变更明确处理跳转和 canonical。
源码核对方案(已确认)
每页内容与每批验收
SEO 与发布节奏
每日小批次是持续维护和质量控制的节奏,不把每日更新次数作为排名保证。Google 明确说明,仅为了让站点显得“更新鲜”而增删内容并不能提升整体排名;优先提供对读者完整、有帮助且准确的内容。参考 Google 的内容质量指南。
每页使用准确且有区分度的 title、H1、description,自然说明 API 名称、Code3D 与实际建模用途;通过分类入口、README、概念页及相关 API 建立可抓取的内部链接。HTML 与 Markdown 共用内容来源,延续现有 canonical 机制,避免近似重复的关键词页面。参考 Google Search Essentials。
发布时核验实际页面、canonical、sitemap 与可抓取性。若提供 lastmod/lastUpdated,只反映真实内容更新,不因构建或发布日期统一刷新;站点地图中的 lastmod 应对应实质变更。参考 Google sitemap 指南。
搜索效果在发布后通过 Search Console 的索引、展示和点击趋势观察;源码完成、线上发布、搜索收录分别记录,不把构建成功或站内搜索命中当成 Google 已收录。
现有基础
Solid Primitives 扩展批次(2026-09-22,已本地提交)
1baef99a1318fc694825ec0a48d4d39635a3a130;提交后复验八页全部基准通过,16 条来源均能按内容匹配解析到该提交,不需要自动改写基准。/docs/packages/core/api/regular-prism/,标题仍使用准确 API 名。1baef99a1318fc694825ec0a48d4d39635a3a130(core: document solid primitives with source review baselines),使用refs #232。提交前再次核对 50 个文件、源码基准、Prettier 与 diff,通过后提交;工作区 clean。未合并、推送或线上发布,总 issue 保持打开,其他 API 分类继续按清单推进。第一批交付状态(2026-09-22,已随 Solid Primitives 批次提交)
code3d-issue-232-core-api-docs-p61-0922;分支同名去掉code3d-前缀;ownerw1:p61。包含文档、导航、源码职责拆分与源码核对工具;公开 API、模型行为与状态语义保持一致。packages/core/docs/api/box.md:用途、真实 App 示例与既有图片、签名、参数、局部坐标、参考元素、测量、校验和编辑默认值。API reference → Solid primitives → box。未完成的其他 API 继续链接到现有章节,不创建占位页。docs/api/,详细页使用固定/docs/packages/core/api/<api-name>/地址;分类由 sidebar 组织,避免以后调整分类时改动 URL。现有总览和旧锚点保留,后续逐项把技术正文归入对应详细页。Web README 已说明这套维护方式。box.ts统一箱体构造、参数标注、几何创建和尺寸检查器;validation.ts共享正数校验;authoring-api.ts汇总作者入口,避免运行时反向依赖 box。同步 root/tooling 导出、资源生命周期测试和编辑器源码跳转夹具,无旧入口转发层。box.md的sourceReview独立保存核对时包版本、两个源码路径和 SHA-256。HTML 与 Markdown 共用该记录,折叠区展示源码与匹配提交;首次建立基准时两个源文件尚未提交,因此不伪造提交哈希;现已随本批提交,构建可按内容匹配并生成链接。npm run docs:sources:check --workspace @code3d/web只读检查;npm run docs:sources:review --workspace @code3d/web -- packages/core/docs/api/box.md在复核后显式刷新该页。Web 构建先检查基准,缺失或过期时失败;不因发包、构建或无关文件变动自动刷新。w1:p6G;App 开发服务位于http://127.0.0.1:5186/,panew1:p6H;本机地址仅供本地验收。1baef99a1318fc694825ec0a48d4d39635a3a130;尚未合并、推送或线上发布,根 issue 保持打开,其余分类继续按总清单推进。API 覆盖核对清单(最终复核)
基于最终合并提交
36ba351的真实导出、构建后公开声明和继承成员核对:根入口 52 个公开值 + 83 个类型;tooling 83 个值 + 73 个类型;Replicad 集成新增 2 个值 + 1 个类型。入口计数包含重复重导出的类型,不代表独立 API 数。Node 根入口仅增加自动初始化后重导出相同 API。状态统一说明:下列全部分类、公开成员及类型均已实现细粒度参考并完成本地验收。 当前主说明映射见完整导出索引。下表保留最初分类和既有章节链接供追溯;新页面均已推送到远端 main。所有配置字段、重载、联合分支和返回结构归对应函数或类型页,不单独发布薄页。
根入口:公开函数和值、类型
box、cylinder、sphere、ellipsoid、frustum、regularPrism、tube、coilpoint、line、arc、bezier、spline、circle、ellipse、rectangle、regularPolygonsketchSketch、SketchEntry、SketchConstraint、SketchOptions、SketchPoint、SketchPosition、SketchArcDirectiontext、font、googleFontFont、GoogleFontOptions、TextOptionsextrude、revolve、sweep、loft、wrap、thickenLoftOptions、RevolveConfig、WrapOptionsunion、cut、intersectSolidModificationCapabilitiesoriginCentergroup、frame、offset、rotate、on、align、pivot、pivotVertex、pivotPoint、axisEdge、axisLine、coupleRotationConstraint、Transformation、Relation、PivotChain、PivotRotation、AxisChain、AxisRotation、RotationCouplingConfig、Frame、GroupOptions、ElementSources、ExposedValue、ExposedElements、MergedElements、NamedElementsAnchor、PointAnchor、LineAnchor、FaceAnchor、FrameAnchor、Bound、DirectionalBounds、Vertex、Edge、Surface、Solid、VertexTopologyCapabilities、EdgeTopologyCapabilities、SurfaceTopologyCapabilities、EdgeId、SurfaceId、VertexId、TopologyId、TopologyKind、CanonicalElements、PlanarElements、CurveElements、ElementKinddistanceDistanceAxis、ModelBoundsinput、timeOffset、cacheInputOptions、CacheOptions.metadata/.withMetadata()、inspectGroupMembers、captureInspectData、dimension、boundsAnnotation、anchorAnnotationModelMetadata、Dimension、DimensionSegment、BoundsAnnotation、AnchorAnnotation、PreviewValue、InspectResult、InspectCall、InspectClosureExecution、InspectContextFactory、InspectClosure、InspectContext、InspectorModel、SolidModel、FaceModel、EdgeModel、VertexModel、GroupModel、ModelCapabilities、GeometryCapabilities、GeometryQueryCapabilities、ModelForKind、ModelKind、ModelGeometryKind、ModelElementKind、Vec3材质与外观没有根入口自由函数:
.material()见下面模型成员,Three.js 子路径见互操作入口。box的主页面为packages/core/docs/api/box.md;后续 API 页沿用packages/core/docs/api/<api-name>.md的固定 URL,分类只影响导航。模型、参考、草图与旋转链成员
下表列出公开能力中去重后的成员;相同名字按所属值解释。具体模型支持范围沿公开能力接口核对,用户自定义的具名成员由
expose()说明。metadata、withMetadata()→ 模型 metadata;origin、frame→ 拓扑与参考;bounds()、position()→ 测量;relate()、expose()→ 组合与摆放;originOffset()、originPoint()、rotate()→ 原点与局部变换;material()→ 材质;up、down、left、right、front、back→ 方向边界center→ 参考;originCenter()、originVertex()、scaled()→ 原点与局部变换vertex()、vertices()→ 拓扑选择edge()、edges(),并继承顶点选择 → 拓扑选择surface()、surfaces(),并继承边和顶点选择 → 拓扑选择cut()→ cut;fillet()、chamfer()、shell()→ 实体修饰;area、volume→ 测量;默认CanonicalElements.center/axis→ 参考extrude()、revolve()、sweep()、thicken()→ 等价函数页;area→ 测量;flip()→ 参考朝向;默认PlanarElements.center/plane→ 参考length→ 测量;reverse()→ 参考方向;默认CurveElements.start/midpoint/end→ 曲线参考.origin、.relate()→ frame;不提供几何、bounds 或模型成员能力FrameAnchor.origin、LineAnchor.reverse()、FaceAnchor.flip()、Bound.flip()→ 参考元素;PointAnchor 无普通可读字段kind、id、center、六向边界及各自拓扑选择;Edge 另有start/midpoint/end/length/reverse(),Surface 另有area/flip()→ 拓扑、测量与参考kind、center、六向边界、面/边/顶点选择、area、volume→ expose 得到的引用与测量plane、relate()、point()、derive()、face()、faces()→ 草图;SketchPoint 的sketch/id→ 点引用PivotChain.pivotOffset()、PivotRotation.rotate()(含继承);AxisChain.axisOffset()、AxisRotation.rotate()(含继承)→ 相应旋转选择器;完成的 Transformation 不提供后续变换链family、style→ 字体资源ModelBounds.minimum/maximum/size→ bounds;其余字段由所属配置或结果类型页完整说明草图实体联合分支:
point、line、circle、arc。约束联合分支:fixed、horizontal、vertical、parallel、perpendicular、angle(直线方向/两线夹角两种形式)、coincident、midpoint、length、radius、sweep、x、y。均归草图文档,并保留点编号与上游 SketchPoint 引用的区别。Tooling 入口
以下各行分别归工具集成的对应专题。类型重导出复用主说明;方法和结果字段跟随所属类型,不在建模 API 主导航中重复展示。所有项目已在 12 篇工具集成专题中完成,见Tooling 总入口。
beginModelInputs、beginTimeOffset、identifyCachedFunction、ModelInputValues、ModelInputDefinitioninstallFontEngine、installModelResourceLoader、ModelResource、ModelResourceLoader、googleFontSources、googleFontUrl、installOpenCascade、describeOpenCascadeExceptionclearKernelOperationCache、kernelOperationCacheStats、setKernelCacheBudget、setKernelCachePersistenceThreshold、setKernelArtifactStore、setKernelExternalBytes、KernelArtifactStoreSketchConstraintError、installSketchSolver、assertSketchDragConnections、isSketch、sketchDefinition、sketchDragRequiresSolver、sketchEntityParameters、sketchFrame、sketchPointResolver、sketchSource、snapshotSketch、solveSketchSnapshot、withSketchEntityParameters、Sketch、SketchArcDirection、SketchArcSnapshot、SketchCircleSnapshot、SketchConstraint、SketchEntitySnapshot、SketchEntry、SketchLineSnapshot、SketchOptions、SketchPointAddress、SketchPointSnapshot、SketchPosition、SketchSnapshot、sketchCurveIntersections、SketchCurveIntersection、sketchArcGeometry、sketchCurveBounds、sketchCurveClosestParameter、sketchCurveGeometry、sketchCurvePosition、sketchCurveTolerance、sketchPositiveAngle、SketchCurve、sketchRegions、SketchRegionauthoringApi、beginModelEvaluation、beginModelInspection、disposeModelObjects、isModelObject、isFrame、isSolidModel、modelObjectRuntimeInfo、relatedModelObjects、retainModelGeometry、ModelObject、ModelObjectRuntimeInfo、ModelGeometrySnapshot、ModelKind、ModelGeometryKind、RelationObjectrelationPreview、currentRelationSelf、relationSelectionPreview、relationTraceReference、instrumentRelation、isConstraint、isRelationExpression、Constraint、ConstraintAnchorSnapshot、RelationExpression、RelationPreview、ConstraintSnapshot、TransformationSnapshot、RelationStageSnapshot、RelationSpatialReference、ConstraintTraceReference、RelationTraceReference、RotationReferenceSnapshotcreateModelSnapshotter、executeSnapshotQueryBatch、instrumentModelOperation、modelOperationObject、modelElementReference、previewAnchorReference、modelTopologyIds、modelTopologyReference、planModelSnapshotQueries、ElementKind、ElementSnapshot、ModelElementReference、ModelOperationInputRole、ModelOperationInstrumentation、ModelOperationKind、ModelOperationSelectionSnapshot、ModelOperationSnapshot、ModelParameterDimension、ModelSnapshotObject、ModelSpatialOperation、ModelTopologyReference、ParameterKind、ParameterTarget、ParameterUsage、RenderMesh、SnapshotQuery、SnapshotQueryBatch、SnapshotQueryResult、SourceRef、TransformcomposeTransforms、identityRigidTransform、invertTransform、quaternionAxisAngle、relativeTransform、rotateVector、rotationAround、transformsAreEquivalent、xyzRotation、Quaternion、RigidTransform、Vec3TopologyGeometry、TopologyInspection、TopologyInspectionItem、TopologyInspectionOptions、EdgeId、SurfaceId、TopologyId、TopologyKind、VertexId、TopologyIdSet、compareTopologyIds、formatTopologyId、isTopologyId、sameTopologyId、topologyIdKeycaptureModelMaterial、modelMaterialColor、ModelMaterialSnapshot、parseModelColor、ModelColorrecordInspectionCalls、inspectionIdentity需要随所属 tooling API 一起说明的对象成员:
TopologyIdSet的构造参数、迭代、size/has/add/delete/clear;KernelArtifactStore的pendingWriteBytes/get/getMany/set/touch/touchMany/delete/flush;ModelResourceLoader.load/bundle/decoded;ModelGeometrySnapshot.shapes/inspect/dispose;SnapshotQueryBatch的查询数据和encode/accept;SketchConstraintError.constraints;beginModelInputs()返回的definitions/finish()等作用域退出入口。ModelObject/RelationObject的正常建模成员链接上述主说明,工具专用nodeId/sourceRefs/parameters/solvePose/previewElement归运行时类型。所有快照联合分支和字段均随类型正文核对。内部品牌、私有字段、受保护成员不作为用户 API。互操作入口与内部导出
@code3d/core/replicad:definePrimitive、replicad、Replicad→ 自定义图元与互操作;上游类型透传,以及replicad所暴露的上游功能 → 说明 Code3D 运行时绑定和资源所有权后链接上游。Node 子入口先初始化相同运行时。已在 definePrimitive and Replicad 页面完成。@code3d/core/three:原样转出 Three.js → 材质与外观/Three.js 集成入口,说明共享依赖实例、支持的材质与纹理限制,链接上游完整参考。已在 Three.js integration 页面完成。@internal、构建声明已剔除的 6 个值:relate、expose、inspectTopologyReference、inspectLength、inspectArea、inspectVolume。用于执行与检查,不作为普通建模自由函数补页;模型.relate()/.expose()仍是公开 API。核对依据包括公开声明的继承成员和源文件中的联合分支。此清单记录文档归属与进度,不替代实际类型签名;API 变动时同步调整同一 issue 的清单。