docs/skill: scadpkg-format says a part definition holds one solid (no solid_cache.bodies, no profile 3)

DECISION: the package-format reference states the part definition as it is again: profile
simplecad-part-definition-2, one solid, at most one appearance row.

WHY - THE DISCUSSION (owner and assistant, 2026-11-10; full account in design-docs/part-holds-one-solid.md)
The multi-body Part existed so the editor could keep several solids side by side with no assembly constraint
(pattern a tool, then cut); the owner judged it a wrong decision that makes assembly hard, and the agreed
analysis was that those solids are notebook intermediates, not product items, so a Part is one solid. The commit
"artifacts: a part definition holds one solid (drop BodyRef, `solid_cache.bodies` and profile 3)" removed the
durable format that described several bodies. This page is what a reader of a package follows, so it must not
tell them to expect `solid_cache.bodies` or a "multi-body part names its bodies" rule.

- docs/skill/references/scadpkg-format.md ("Definitions"): names the profile, the one-row appearance block
  (colour and opacity, name), and says explicitly that `solid_cache.bodies` and profile 3 do not exist (they
  only appeared in the withdrawn 2.2.8 release), so a reader who met them there knows they are gone.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
Ni Jingzhe
2026-11-10 04:07:54 +08:00
parent fb50a97b07
commit 01852ed1b9
+8 -6
View File
@@ -75,12 +75,14 @@ by its own sha256 through the map above works uniformly.
Part definitions carry: `units` (`"mm"`), `generator`
(`{ocp_version}`), `solid_cache` (body reference — the BREP payload for
in-process rebuild), `topology_snapshot_ref` (the tag channel, below),
`connectors`, `material_ref`, `metadata`, `profile`, `revision`, and,
only when a body has a display appearance, `appearance`
(`{"bodies": [{"body_id", "color", "opacity", "name"?}]}`: colour as
linear RGB in [0, 1] overriding the material colour for display; `name`
only on a one-body part, a multi-body part names its bodies in
`solid_cache.bodies`).
`connectors`, `material_ref`, `metadata`, `profile`
(`simplecad-part-definition-2`), `revision`, and, only when the body has
a display appearance, `appearance`
(`{"bodies": [{"body_id", "color", "opacity", "name"?}]}`, one row at
most: colour as linear RGB in [0, 1] overriding the material colour for
display). A part definition holds exactly one solid: `solid_cache` has
`evaluator_profile` and `body_ref` only (there is no `solid_cache.bodies`
and no profile 3; that existed only in the withdrawn 2.2.8 release).
Assembly definitions carry `definition_refs`, `instances`,
`relations`, `public_connectors`, `solved_snapshot`,
`grounded_instance_ids`, `feature_graph_ref`. Identity is