@shundoo-ai/dsh-cosmic 1.0.21 → 1.0.22

package/skills/cosmic-build/skills/cosmic-meta-modifier/references/list-filter-modification.md

@@ -12,14 +12,15 @@
 用户的表单名称和字段名称就是合法选择器。`fieldKey` 接受业务名称，不要求内部编码。
 命令内部负责解析并校验真实应用、表单、字段和实体。
 
-用户同时给出准确表单编码和显示名称时，第一次调用就把该编码原样传给 `--form-name`。
-用户点名表头或准确分录位置时，第一次调用就把该位置传入 `entity`，即使字段名看起来唯一；
-不得等待歧义错误，也不得用显示名称替换用户给出的准确编码。
+用户给出准确表单编码时，第一次调用原样传给 `--form-name`。
+字段业务描述也原样传入，包括“表头备注”。脚本优先匹配准确字段名，找不到时再按明确的
+表头前缀定位主实体；模型不必在“完整字段名”与“表头位置”两种写法间选择。
+用户另行提供的 `entity` 独立位置参数仍保留；无需预读清单。
 
-修改列标题时，下一次调用直接为：
+独立的列表修改使用下列脚本：内部调用原生 `configureList`，保留全部独立回读断言，并在同一次调用中完成成功修改的原生卡片收口：
 
 ```text
-{python} {ROOT_DIR}/skills/cosmic-meta-api/scripts/cosmic_api.py --stdout configureList --app-root "<可信 appRoot>" --form-name "<已给准确编码时用编码，否则用准确名称>" --input '{"entity":"<用户点名的位置，如 header；未点名时才省略>","columns":[{"fieldKey":"<字段当前名称>","displayName":"<要求的列表标题>"}]}'
+{python} {ROOT_DIR}/scripts/configure_list.py --app-root "<可信 appRoot>" --form-name "<已给准确编码时用编码，否则用准确名称>" --input '{"entity":"<用户点名的位置，如 header；未点名时才省略>","columns":[{"fieldKey":"<字段当前名称>","displayName":"<要求的列表标题>"}]}'
 ```
 
 从用户原话填写这个请求即可，不先调用 queryForms、getFormSchema、describe 或 bootstrap。
@@ -40,20 +41,46 @@
 
 列接受 `fieldKey`，以及可选的 `entity`、`displayName`、`order`、`hyperlink`。
 排序接受 `ASC`、`DESC`、`NotOrder`，可写在列上或 `sort` 中，不能提供冲突排序。
-其他嵌套列参数会被拒绝。
+`properties` 接受非空的列表展示属性字典，键使用实时属性名或准确显示名：
 
-字段同名时，只为受影响的选择器补实体限定。`header`/`表头` 选择主实体，准确分录名称选择
+```json
+{"columns":[{"fieldKey":"数量","properties":{"Summary":"合计","ZeroShow":true,"ColumnOrderAndFilter":"支持排序和过滤"}},{"fieldKey":"日期","properties":{"DisplayFormatString":"yyyy-MM-dd"}}]}
+```
+
+入口按实际列类型读取 Schema，转换枚举显示名并逐项独立回读。数值列（含整数）支持
+`Summary`（汇总）、`ZeroShow`、数值格式及进度显示；日期列支持格式和掩码；枚举列支持
+显示风格、打钩样式；通用属性包括宽度、可见性、对齐和换行。仅接受该列实际声明可编辑的属性。
+`Summary` 是列表汇总，与分录汇总到表头的 `SummaryToField` 不同。
+列表的缺省/F7可见性可用实际已观测的标志，例如 `Visible:"default,lookup"`。
+复杂属性继续使用已有专用属性入口，不把对象压成字符串。字段绑定、标识和类型由
+`fieldKey` / `entity` 决定，不能通过 `properties` 改写。
+新列创建后会继续设置所需属性并回读；若创建后的属性验证失败，明确报告保留的结构，不能重放创建。
+
+用户独立提供的位置参数可限定受影响的选择器；明确表头前缀无需模型手工拆分。`header`/`表头` 选择主实体，准确分录名称选择
 该分录；顶层 `entity` 为默认范围，选择器自己的 `entity` 可以覆盖它：
 
 ```json
 {"entity":"header","columns":[{"fieldKey":"单据编号"},{"fieldKey":"明细字段","entity":"明细"}],"quickSearch":["单据编号"],"commonFilters":[{"fieldKey":"明细字段","entity":"明细"}],"schemeFilters":[{"fieldKey":"明细字段","entity":"明细"}],"sort":[{"fieldKey":"创建时间","order":"DESC"}]}
 ```
 
-读取结果的 `verification.columns` / `verification.filters` 和 `data.completion`。
-`verified`、`verified_noop` 表示这些列表需求已完成，请求值和实际值已经独立比较。
-只继续其他明确需求；否则直接用 `data.appRoot`、`data.formNumber` 生成最终卡片。
-不要再查 schema 或列表验证同一结果。失败时只纠正回执指出的输入，或说明未解决边界，
-不要重放可能已经完成的写入。
+列宽保留明确单位：使用 `"Width":"150px"` 或 `"Width":{"value":150,"unit":"px"}`，不能丢成裸数字 `150`。
+
+脚本复用原生回执中的 `data.appRoot`、`data.formNumber`，只消费一次结果：
+- 修改并验证成功：结果已含原生卡片块和源码同步队列请求。保留准确卡片块，
+  仅将返回的 command 交给可追踪 Bash 后台任务（`run_in_background=true`、`preview=false`），随后答复。
+  原生卡片 stdout 已触发现有宿主输出校验；不再调用 `output_check`、重渲染或另读收口指南。
+- `verified_noop`：直接说明本次现状；不发新卡或旧卡，不同步源码，不调用 `output_check`。
+- `failed_preflight`：没有写入。按 `completion.nextAction` 报告不支持的属性，或只按准确列的
+  定向恢复修正回执指出的输入；不探索整表结构、全局帮助、其他 API 或 Java 插件。不发卡、不收口。
+- 写入状态未知、部分写入或卡片生成失败：按返回的恢复信息继续，不能重放已验证字段。
+
+业务属性可直接填，例如 `{"fieldKey":"表头备注","properties":{"Width":"240px","自动换行":true,"对齐":"左对齐"}}`。
+准确字段/表头定位及常用属性映射均由脚本负责，模型无需再选择等价英文名称。
+失败时会返回全部所报错误、合法候选及准确列查询，不需要做全局发现。
+不能由 `ZeroShow` 回读推断汇总行显示等未验证的运行行为。只报告修改项和实际证据；
+无变更或拒绝用简短结果收尾，不重复交付说明。
+专家团委托实施且负责人仍有其他交付工作时，继续使用原生 `cosmic_api.py --stdout configureList`，
+由负责人沿原有约定终点交付。
 
 用户明确要求删除过滤列时，使用 `removeFilterColumn`：`parentScope` 为
 `fastsearchgridview`（快捷搜索）、`filtergridview`（常用过滤）或 `schemefilterview`

package/skills/cosmic-build/skills/mcp-server/SKILL.md

@@ -13,8 +13,8 @@
 
 苍穹 OpenAPI 平台提供 **MCP 服务列表**（元数据 `open_mcp_ext`），每条记录把一个
 已发布 API 注册为 AI 可调用的 MCP 工具。本技能通过平台 `devportal/ai-meta/mcpserver`
-接口族（即 `OpenApiMcpServerFormPlugin` / `OpenApiMcpServerListPlugin` 界面背后的
-同一套服务端逻辑）以对话方式驱动该完整生命周期。
+接口族以对话方式驱动该完整生命周期。它与平台界面管理同一批 `open_mcp_ext`
+记录，但界面操作不一定经过这个 API Controller。
 
 适用场景：把 API 注册为 MCP 工具、查询/检索既有 MCP 服务、从 OpenAPI YAML 批量
 导入工具、重新注册失败的服务、下架（unshelve）服务、导出服务用于环境间迁移。
@@ -54,7 +54,7 @@
 | 前置条件/后置效果/错误恢复 | `beforeCondition` / `afterCondition` / `errRecovery` | 长文本（`x-ai-preconditions` / `x-ai-postconditions` / `x-ai-error-recovery`）；AI 工具语义字段，每个正式工具都建议填写。 |
 | 是否敏感操作 | — | 由目标 API 派生（delete/unaudit 等），不接受调用方传入。保存敏感 API 的工具时，先向用户明示再确认。 |
 | 自定义参数扩展配置 | `cusParamExtCfg` | 必须是单个 JSON **对象**字符串，如 `{"key": "value"}`（否则 `CUS_PARAM_INVALID`）。 |
-| 服务来源 | `sourceType` | 调用方只读。`custom` = 租户自建；非白名单环境不可修改标品预置服务（`MCP_DEV_DISABLED`）。 |
+| 服务来源 | `sourceType` | 调用方只读。`custom` = 租户自建，`global` = 标品预置。修改/删除要求记录来源与当前环境的 ISV 分类匹配；另由 `enable_mcp_dev` 开关控制 `MCP_DEV_DISABLED`。 |
 
 ## 注册状态生命周期
 
@@ -69,13 +69,12 @@
 - `unshelves`（→ `UNSHELVES`）只接受 **SUCCESS 或 PENDING_UPDATE** 的记录。
   下架同样是异步的：记录先经 `UNSHELVES`（下架中）再到 `UNSHELVESED`
   （已下架）——用 `get` 轮询确认。
-- `delete` 仅对 **UNSHELVESED**（已下架）的记录成功：删除已发布或下架中的
-  记录会报 `DELETE_FAIL`（成功0条）——先下架、等状态到已下架再删。
-  `UNSHELVESED` **不是稳定终态**：实测平台后台会把已下架记录重新发布回
-  `SUCCESS`，因此「下架 → 轮询 → 删除」必须作为连续序列在同一执行轮内
-  一气呵成。
-- 锁定态（下架中的 `UNSHELVES`，以及受限环境中的标品预置记录）拒绝编辑，
-  报 `STATUS_LOCKED` / `MCP_DEV_DISABLED`。
+- `delete` 接受 **FAILED 或 UNSHELVESED** 的记录，不是仅接受已下架记录。
+  状态只是必要条件：`source_type` 还须与当前环境匹配，随后标准 `open_mcp_ext`
+  删除操作也必须成功。`unshelves` 不检查来源匹配，因此能下架不代表能删除。
+  单凭 `DELETE_FAIL` 无法区分这些原因；应回读实际状态，不要假定后台自动重发布。
+- 下架中的 `UNSHELVES` 拒绝编辑并报 `STATUS_LOCKED`；来源/环境不匹配与
+  未开放 MCP 开发属于不同的限制。
 
 ## CLI 参考
 
@@ -104,6 +103,11 @@ HTTP 方法由平台控制器固定：`listByForm` 与 `get` 为 GET（payload
 参数传递），其余 7 个命令为 POST + JSON body。对 GET 端点发 POST 会返回 HTTP
 405 `HttpMethod POST is not allowed`——真实路由不匹配（带 TraceId），不是部署缺失。
 
+失败响应保留平台 `data`，包括可用的数量与 `data.items[].message`。
+`delete` / `resetStatus` / `unshelves` / `importYaml` 的业务对象若含
+`success: false` 或 `failCount > 0`，即使平台外层 `status` 为 true，CLI 也返回失败
+（退出码 1）。已受理的成功项不会回滚：须检查保留的明细并逐条验证受影响记录。
+
 ## 对话流程
 
 ### 查找 MCP 服务
@@ -137,17 +141,27 @@ HTTP 方法由平台控制器固定：`listByForm` 与 `get` 为 GET（payload
    v2/v3 明细，逐条列出失败路径与原因。
 
 ### 重新注册 / 下架 / 删除
-1. `resetStatus` 仅用于 FAILED/UNSHELVESED 记录；`unshelves` 仅用于
-   SUCCESS/PENDING_UPDATE 记录。CLI 返回 `RESET_STATUS_INVALID` /
-   `UNSHELVES_INVALID` 时，重新 `list` 并解释记录的实际状态。
-2. 已发布工具的完整删除序列——三步在**同一执行轮**内连续完成、中间不暂停：
-   `unshelves --confirm` → 每 2–5 秒用 `get` 轮询直到 `UNSHELVESED`（实测
-   15 秒到 1 分钟以上不等）→ 立即 `delete --confirm`。提前删除报
-   `DELETE_FAIL`；步骤间暂停会让平台把记录重新发布回 `SUCCESS`，届时整个
-   序列须从头再来。删除后用 `get` 验证：返回 `bos.orm.read.dataNotExist`
-   即删除成功的证据。
-3. 三者都有 `--confirm` 门禁——缺省时 CLI 直接拒绝。向用户确认记录清单
-   （工具名，不只是 id）后再传。
+1. 用 `list` / `listByForm` 定位用户选定的工具，再用 `get` 回读。
+   `--ids` 是 `items[]` 中的 MCP 记录 id，绝不是 `apis[]` 中的目标 API id。
+   传 `--confirm` 前确认工具名与删除范围；删除 MCP 记录不授权删除其 API 或其他工具。
+2. 按最新状态选择动作：**FAILED/UNSHELVESED → 直接删除**；
+   **SUCCESS/PENDING_UPDATE → 下架 → get 轮询 → 删除**；**UNSHELVES → 轮询**。
+   每 2–5 秒轮询，最多 3 分钟，超时报告最后观察到的状态。
+   其他状态尚不允许删除；不要为强行删除而重置或重新注册。
+   `resetStatus` 仅在用户要求重新注册时用于 FAILED/UNSHELVESED，不是删除前置步骤。
+3. 已确认下架受理后，`get` 到 UNSHELVESED 即执行一次删除。
+   部分失败时逐条检查结果，不要重放原始整批请求。
+   对受影响的 id 用 `get` 验证：`bos.orm.read.dataNotExist` 证明记录不存在；
+   其他查询错误既不能证明删除成功，也不能证明记录仍然存在。
+4. 删除失败时，先读 `data.items[].message`，再看顶层 message，
+   回读同一记录的状态与 `sourceType`。来源/环境拒绝时停止该序列；
+   标准操作错误需平台侧排查。只有证据表明阻断条件改变后才能重试。
+   记录已是 FAILED/UNSHELVESED 时不要重复下架。
+5. 部分平台 Controller 失败时只返回 `DELETE_FAIL` 与数量摘要、`data: null`，
+   已把服务内部的逐项原因丢弃。应明确报告**根因尚未确定**，保留记录 id、
+   返回的 message/TraceId，请求 Controller 封装前的 `McpBatchResult.items`
+   或删除操作的 `OperationResult`；原始 HTTP 响应也无法恢复 Controller 已丢失的明细。
+   不要仅凭该错误归因为缺少 AI 网关或状态竞争；不要直写实体或删库绕过校验。
 
 ### 导出 / 环境间迁移
 1. `export --ids … --format dts` 产出平台 DTS 包格式（已实测通过）。
@@ -167,12 +181,13 @@ HTTP 方法由平台控制器固定：`listByForm` 与 `get` 为 GET（payload
 | `API_DUPLICATE` | 已有 MCP 记录绑定了该 API。 |
 | `TOOL_NAME_INVALID` | 显式工具名被拒（格式/长度）。 |
 | `STATUS_LOCKED` | 记录下架中（`UNSHELVES`）——等待完成后再编辑。 |
-| `SOURCE_MISMATCH` | 租户环境修改标品预置记录（或反向）被拒。 |
+| `SOURCE_MISMATCH` | 记录来源与当前环境不匹配；删除时可能作为逐项原因折叠进 `DELETE_FAIL`。不要修改来源来绕过检查。 |
 | `MCP_COUNT_LIMIT` | 租户 MCP 数量达到 `openapi_mcp_maxCount` 上限。 |
 | `MCP_DEV_DISABLED` | 当前环境未开放 MCP 开发。 |
 | `DESCRIPTION_TOO_LONG` / `CUS_PARAM_INVALID` / `OPERATE_TYPE_INVALID` | 字段级校验——修正输入值。 |
 | `RESET_STATUS_INVALID` / `UNSHELVES_INVALID` | 状态前置条件不满足——用 `list` 复核。 |
-| `DELETE_FAIL` | 删除被拒——通常是记录尚未到 `UNSHELVESED`；先下架再重试。 |
+| `DELETE_FAIL` | 通用删除失败：记录存在性、FAILED/UNSHELVESED 状态、来源匹配或标准实体操作均可能失败。须读逐项原因，仅有数量摘要无法判断根因。 |
+| `PARTIAL_SUCCESS` | 部分项失败。检查保留的数量/明细，验证已受理的成功项，不要重放整批请求。 |
 | `bos.orm.read.dataNotExist` | `get` 查询已删除记录——这是删除成功的验证证据，不是故障。 |
 
 ## 环境兼容性
@@ -193,7 +208,7 @@ HTTP 方法由平台控制器固定：`listByForm` 与 `get` 为 GET（payload
 即可，无需重新部署。
 
 绝不要在接口族缺失时改用零码实体 API 直写 `open_mcp_ext` 表来绕过：注册状态机、
-AI 网关注册、数量管控、敏感操作检查全部在服务端控制器里——直写表会让记录进入
+AI 网关注册、数量管控、敏感操作检查由平台服务/操作负责——直写表会让记录进入
 不一致状态。
 
 ## 边界说明

package/skills/cosmic-build/skills/mcp-server/scripts/mcp_cli.py

@@ -80,6 +80,7 @@ EXPORT_FORMATS = ("dts", "yaml")
 IMPORT_MODES = ("override", "ignore")
 
 DESTRUCTIVE_COMMANDS = frozenset({"delete", "resetStatus", "unshelves"})
+BATCH_COMMANDS = DESTRUCTIVE_COMMANDS | {"importYaml"}
 
 
 def _load_config():
@@ -103,8 +104,8 @@ def _ok(data):
     return {"status": True, "errorCode": None, "message": None, "data": data}
 
 
-def _fail(error_code, message):
-    return {"status": False, "errorCode": error_code, "message": message, "data": None}
+def _fail(error_code, message, data=None):
+    return {"status": False, "errorCode": error_code, "message": message, "data": data}
 
 
 # 灵基与苍穹发版解耦：目标环境可能未部署 ai-meta/mcpserver 接口族。两类特征归并
@@ -158,8 +159,8 @@ def _call(command, payload, cfg):
     """按 GET_ENDPOINTS 路由到 kd_api.get/post 并把 CustomApiResult 折叠为 CLI 结果。
 
     listByForm/get 走 GET（payload 作为 query 参数），其余命令走 POST + JSON body。
-    平台成功时 data 为业务对象；失败时 status=false 且 message 携带原因，
-    继续透传平台 errorCode（如 STATUS_LOCKED / API_NOT_FOUND）。HTTP 层异常
+    成功与失败均保留平台 data（含批量数量和逐项原因）；批量业务失败不能因
+    外层 status=true 被当成全成功。继续透传平台 errorCode。HTTP 层异常
     折叠为受控错误码（不让 traceback 泄漏到机器输出流）：MCP_API_NOT_DEPLOYED
     表示环境未部署接口族，其余为 PLATFORM_ERROR。
     """
@@ -174,14 +175,27 @@ def _call(command, payload, cfg):
         return _fail(*_classify_transport_failure(command, detail))
     except Exception as exc:  # noqa: BLE001 — transport/token/gateway failures all fold
         return _fail(*_classify_transport_failure(command, str(exc)))
+    data = result.get("data")
     if result.get("status"):
-        return _ok(result.get("data"))
+        # 下架等接口可能外层成功但批量部分失败；整体操作失败也不能被成功数量掩盖。
+        if command in BATCH_COMMANDS and isinstance(data, dict) and (
+            data.get("success") is False or data.get("failCount", 0) > 0
+        ):
+            return _fail(
+                data.get("errorCode") or (
+                    "PARTIAL_SUCCESS" if data.get("successCount", 0) > 0 else "PLATFORM_ERROR"
+                ),
+                _sanitize_message(data.get("message") or result.get("message")) or "batch operation failed",
+                data,
+            )
+        return _ok(data)
     if str(result.get("errorCode") or "") == "404":
         # body 级 404（HTTP 200 + "Cannot found OpenAPI"）：该环境未登记本接口族
         return _fail("MCP_API_NOT_DEPLOYED", _NOT_DEPLOYED_MESSAGE)
     return _fail(
         result.get("errorCode") or "PLATFORM_ERROR",
         _sanitize_message(result.get("message")) or "platform call failed",
+        data,
     )
 
 
@@ -382,7 +396,7 @@ def build_parser():
     p_save.add_argument("--source-yaml", help="source YAML text")
 
     for name, help_text in (
-        ("delete", "Delete MCP services by ids"),
+        ("delete", "Delete MCP services (FAILED/UNSHELVESED; source and operation checks apply)"),
         ("resetStatus", "Reset register status to UNPUBLISH (FAILED/UNSHELVESED only)"),
         ("unshelves", "Unpublish MCP services (SUCCESS/PENDING_UPDATE only)"),
     ):

package/skills/cosmic-dev-best-practices/SKILL.md

@@ -32,7 +32,7 @@ whenToUse: 苍穹开发任务（设计/建模/布局/插件/字段属性/操作
 | 开发单据 | references/bill-dev-convention.md |
 | 开发基础资料 | references/basedata-dev-convention.md |
 | 开发动态表单/弹窗 | references/dynamic-form-dev-convention.md |
-| 字段属性（必填/锁定/默认值/列表列） | references/elements/common-field-property-conventions.md |
+| 字段属性（必填/锁定/默认值/列表列/容量） | references/elements/common-field-property-conventions.md |
 | 字段类型 / 控件（元素） | references/elements/README.md（元素索引） |
 | 写 Java 插件（赋值/操作日志/事件流程） | references/java-plugin.md |
 | 调用 cosmic_api / 导出打包发布 | references/cosmic-meta-api.md / datamodel-publish.md |

package/skills/cosmic-dev-best-practices/references/README.md

@@ -13,7 +13,7 @@
 | `bill-dev-convention.md` | **单据开发规范**（模板/布局/单据字段/审核/关闭/作废/编码规则，参考过磅单） | 开发单据时 |
 | `datamodel-publish.md` | datamodel **导出/打包/发布**最佳实践（目录规范/装配/预置/导出 API/权限） | 应用发布/打包/补丁包时 |
 | `naming-convention.md` | **统一命名规范**（对象标识/单据体/字段三要素/常见字段对齐 ERP 标准）——单据与基础资料通用 | 设计任何开发对象（基础资料/单据）时 |
-| `elements/common-field-property-conventions.md` | **字段属性设置规范**（必填/锁定/ViewDetail/默认值/列表列——按字段类别统一标准）——单据与基础资料通用 | 字段建完后设置属性时 |
+| `elements/common-field-property-conventions.md` | **字段属性设置规范**（必填/锁定/ViewDetail/默认值/列表列/容量——按字段类别统一标准）——单据与基础资料通用 | 字段建完后设置属性时 |
 | `layout-control-convention.md` | **页面布局控件规范**（面板/分录/附件/字段控件/工具栏——结构/key/可折叠/锁定/样式）——单据与基础资料通用 | 设计页面布局时 |
 | `design-document-convention.md` | **业务对象设计文档规范**（设计文档标准结构/内容要求/引用规则——写设计文档时） | 编写/审查设计文档时 |
 | `artifact-layout-convention.md` | **开发中日常产物路径规范**（工具链自动产物只记录 + agent 自主产物定稿/临时划分） | 产出/归档文档、图、脚本、报告时 |
@@ -44,7 +44,7 @@
 
 ## ⭐ 权威层级（字段属性/布局控件/设计文档唯一权威）
 
-> **字段属性设置（必填/锁定/ViewDetail/默认值/列表列/引用/带出）唯一权威 = [elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)**（横切通用规则；字段类型专属最佳实践见 elements/）。
+> **字段属性设置（必填/锁定/ViewDetail/默认值/列表列/容量/引用/带出）唯一权威 = [elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)**（横切通用规则；字段类型专属最佳实践见 elements/）。
 > **页面布局控件（面板/分录/附件/样式）唯一权威 = [layout-control-convention.md](layout-control-convention.md)**。
 > **设计文档写法唯一权威 = [design-document-convention.md](design-document-convention.md)**（设计文档结构/内容要求/引用规则）。
 > `bill-dev-...` / `basedata-dev-...` 中涉及字段属性/布局控件的细节均**引用上述文档**（保留业务清单与流程上下文），**不双源维护**——两处冲突时以上述权威文档为准。

package/skills/cosmic-dev-best-practices/references/basedata-dev-convention.md

@@ -85,7 +85,7 @@
 
 ### 共性 G：主业务组织 = createorg（表单属性，组织管控生效基础）
 
-带组织基础资料（`bos_baseorgtpl`）**必须设置表单级属性「主业务组织」（MainOrg）= `createorg`**——组织管控/数据隔离生效的基础（参考表单过磅单流转类型同款；field-property F.1 的「主业务组织字段」指单据场景 = `org`，基础资料场景 = `createorg`）。
+带组织基础资料（`bos_baseorgtpl`）**必须设置表单级属性「主业务组织」（MainOrg）= `createorg`**——组织管控/数据隔离生效的基础（参考表单过磅单流转类型同款；field-property §附录 F.1 的「主业务组织字段」指单据场景 = `org`，基础资料场景 = `createorg`）。
 
 **命令**（2026-08-26 实测，CLI 可设，非仅设计器）：
 ```bash
@@ -391,7 +391,7 @@ python cosmic_api.py addMenu --bizAppId <应用ID> --name 港口 --formId sd_har
 ## 相关文档
 
 - [naming-convention.md](naming-convention.md)：统一命名规范（单据与基础资料通用）
-- [elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)：字段属性设置规范（必填/锁定/ViewDetail/默认值/列表列，单据与基础资料通用）
+- [elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)：字段属性设置规范（必填/锁定/ViewDetail/默认值/列表列/容量，单据与基础资料通用）
 - [layout-control-convention.md](layout-control-convention.md)：页面布局控件规范（面板/分录/附件/字段控件/工具栏，单据与基础资料通用）
 - [datamodel-publish.md](datamodel-publish.md)：打包导出细节（同目录）
 - [mermaid-guide.md](mermaid-guide.md)：Mermaid 图表规范（同目录）

package/skills/cosmic-dev-best-practices/references/bill-dev-convention.md

@@ -3,7 +3,7 @@
 > 用途：苍穹开发**单据（BillFormModel）**的开发规范——模板、页面布局、单据字段、审计/关闭/作废字段、编码规则。
 > 适用范围：**苍穹ERP 开发环境（通用）**，与基础资料规范同一套（命名见 [naming-convention.md](naming-convention.md)）。
 > 参考：过磅单 `sd_weighingbill`（AI大宗交易云实测）+ ERP 标准单据。
-> 配套：[naming-convention.md](naming-convention.md)（命名规范）、[elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)（字段属性规范：必填/锁定/ViewDetail/默认值/列表列）、[layout-control-convention.md](layout-control-convention.md)（布局控件规范：面板/分录/附件/样式）、[basedata-dev-convention.md](basedata-dev-convention.md)（开发流程共性）。
+> 配套：[naming-convention.md](naming-convention.md)（命名规范）、[elements/common-field-property-conventions.md](elements/common-field-property-conventions.md)（字段属性规范：必填/锁定/ViewDetail/默认值/列表列/容量）、[layout-control-convention.md](layout-control-convention.md)（布局控件规范：面板/分录/附件/样式）、[basedata-dev-convention.md](basedata-dev-convention.md)（开发流程共性）。
 
 ---
 
@@ -216,7 +216,7 @@
 - `canAddField --fieldType BillTypeField` → `allowed=false`，reason：`'BillTypeField' 是系统字段类型，禁止手动创建`；
 - 直接 modifyMeta `remove 旧 TextField + add BillTypeField` → 报 `字段添加校验失败: 'BillTypeField' 是系统字段类型，禁止手动创建`（**非假阳性**，预校验与实测一致）；
 - 参考：过磅单 `sd_weighingbill` 的 `billtype` 实测类型 = `BillTypeField [引用=bos_billtype] [必填]`——标准做法如此，但该字段由**设计器**创建；
-- 结论：开发单据的 `billtype` 需标准单据类型字段（F7 选单据类型）——**agent 不创建，只能开发者设计器手工创建 BillTypeField**（field-property §〇·二/F.2）。
+- 结论：开发单据的 `billtype` 需标准单据类型字段（F7 选单据类型）——**agent 不创建，只能开发者设计器手工创建 BillTypeField**（field-property §〇·二，原 F.2）。
 - 🔧 **探针手法已变更（app-build 0.0.299 起）**：上面的 `canAddField --fieldType …` **已不可用** —— **`canAddField` 已不在 CLI 命令表**（200 条命令里只剩 `canAddFilterColumn` / `canAddToolbarItem`）。
   现行验证方式 = **「authoring + emitter」**（零平台写入），详见 [cosmic-meta-api.md](cosmic-meta-api.md) **§9.9**；注册表快查 `field_type_registry.is_manual_forbidden_field_type('<X>')`。
   **结论本身不变**：`BillTypeField` / `BillStatusField` 等 **13 个类型仍禁建**（2026-09-29 以新手法复验 `BillStatusField` → 被 `FIELD_TYPE_MANUAL_FORBIDDEN` 拒绝，且零写入）。
@@ -280,9 +280,9 @@
 | 批次 | 内容 | 说明 |
 |---|---|---|
 | **0 补字段** | 设计文档 §四 配套字段（`closer`/`closedate`/`canceler`/`canceldate` 等）buildMeta **不自动建** | 增量用 `decorate_ops(standard=True)` + `do_modify_meta` **脚本直调**（CLI 走 workspace standard 会拼前缀） |
-| **1 字段属性** | F 批次：org 职能+必录、客户/港口使用组织、币种默认 CNY、**汇率 5 项关联（传 UUID）**、单位关联物料、金额关联币种、必录日期缺省当天、金额族/状态族锁定、ViewDetail=false | `setProperties`（批量与锁定用 `--policy`；`--elementKey/--input` 对 Lock 报 `PROPERTY_READ_ONLY`）/ `setRefProps` / `setDefValueDesign` |
+| **1 字段属性** | 字段属性批次：org 职能+必录、客户/港口使用组织、币种默认 CNY、**汇率 5 项关联（传 UUID）**、单位关联物料、金额关联币种、必录日期缺省当天、金额族/状态族锁定、ViewDetail=false | `setProperties`（批量与锁定用 `--policy`；**字段**的 `--elementKey/--input` 写 Lock 报 `PROPERTY_READ_ONLY`，**容器控件**仍走 `--elementKey/--input`，见 field-property §B 实测矩阵）/ `setRefProps` / `setDefValueDesign` |
 | **2 面板布局** | 业务面板（`fs_financeinfo`/`fs_clause`/`fs_creator`）**不自动建**——所有字段初始堆在 `fs_baseinfo`（`runBatch` 的 `uiComposition` 步骤被前序阶段失败中止时尤其如此，见 cosmic-meta-api §9.2） | **优先 `applyFormComposition`**（0.0.299 定型命令：**一次创建多分区并归位字段**，字段用**显示名**，输入 `{sections:[{key,caption,rows:[{fields:[...]}]}]}`；2026-09-29 实测 43 ops 一次成功并独立验证）；面板顺序用 `applyPanelOrder --input '{"order":[...]}'`（`advconap` 也要进 `order`，见 §二）。⚠️ 旧法 `modifyMeta` 手写 add/move op 属**已弃的低层路径**，仅在前者不覆盖时使用（move op：`target.value=字段key` + `extra.destination=面板key`；面板排序 `destination=contentpanel`+`index`） |
-| **3 状态族锁定** | `billstatus`/`auditor`/`auditdate`/`closer`/`closedate`/`canceler`/`canceldate` form 层全状态锁 | `setProperties --policy` 的 `{"set":{"Lock":"…"}}`（只走 `--policy`）。⚠️ 写 `submit,audit`（平台默认）时回执必报 `STATIC_FIELD_LOCK_READBACK_MISMATCH`（属确定性假阴性，写入已生效）——以 `formLayout.lock` 为准，不要重试；其它值均 `verified=true` |
+| **3 状态族锁定** | `billstatus`/`auditor`/`auditdate`/`closer`/`closedate`/`canceler`/`canceldate` form 层全状态锁 | `setProperties --policy` 的 `{"set":{"Lock":"…"}}`（**字段**只走 `--policy`；容器控件见 field-property §B）。⚠️ 写 `submit,audit`（平台默认）时回执必报 `STATIC_FIELD_LOCK_READBACK_MISMATCH`（属确定性假阴性，写入已生效）——以 `formLayout.lock` 为准，不要重试；其它值均 `verified=true` |
 | **4 汇率/汇总** | `exchangerate` FireUpdEvt=true（含绑定 5 字段共 6 处）；SummaryToField 金额三件套（input 写文件裸 JSON 字符串） | `setProperties` / `setSummaryToField` |
 | **5 列表列** | buildMeta 后平台**按全部字段**建列；authoring 的 `listConfiguration` 只补列/设排序，**不裁剪、不排顺序**（实测声明 11 列得 37 列，且仍报 `verified`） | 要"只有这几列"：`modifyMeta remove listcolumn` 删多余列 → `configureList` 按序补列（它只增不删，`order` 是排序不是列序）；列序只能"全删后重建" |
 

package/skills/cosmic-dev-best-practices/references/design-document-convention.md

@@ -18,7 +18,7 @@
 |---------|------|
 | 业务定义/字段设计/状态流转/业务约束 | **设计文档本地** |
 | 命名规则（sd_ 前缀/f{key}/枚举语义化）| **必须**引用 naming-convention，禁止重复正文 |
-| 字段属性（必填/锁定/ViewDetail/默认值/引用/带出）| **必须**引用 field-property（横切通用规则），禁止重复 |
+| 字段属性（必填/锁定/ViewDetail/默认值/容量/引用/带出）| **必须**引用 field-property（横切通用规则），禁止重复 |
 | 布局控件（面板/分录高级容器/附件/样式）| **必须**引用 layout-control |
 | API 写法/踩坑 | **必须**引用 cosmic-meta-api |
 | 模板字段核实方法 | **必须**引用 field-property §〇·一 |
@@ -70,7 +70,7 @@
 - **必须**表格式：字段 | fieldKey | 类型 | 必填 | 说明；
 - **必须**用权威专用类型名（CustomerField/CurrencyField/MaterielField 等）——**禁止用 BasedataField 代替专用类型**（违反视为违规）；
 - ⭐ **字段标识 ≤ 18 字符（强约束 2026-08-27）**——设计阶段就要短（`packing_req` 而非 `packing_requirement`），列名 `f{标识}` 后仍 ≤18；
-- 默认值/锁定/引用/带出等**属性一律不展开**——**必须**标注「字段属性规范 F.x」引用（按 F 系列套用）；
+- 默认值/锁定/引用/带出等**属性一律不展开**——**必须**引用现行锚点：「字段属性规范」§A 必填／§B 锁定／§C ViewDetail／§D 默认值／§E 列表列；类型专属规则引 `elements/<类型>.md`。**`F.x` 编号已作废**（旧文档里的 F.x 对照见该规范 §附录）；
 - 枚举 value **必须**语义化单词。
 
 > 📌 **字段类型一律用 Field 型（2026-08-27 统一，与 authoring/CLI/服务端一致）**：设计文档字段表**必须**写 `xxxField`（`DateField`/`AmountField`/`CustomerField`…），**不出现 Prop 后缀**。布尔特殊：**无 `BooleanField`，布尔用 `CheckBoxField`**；状态字段用 `BillStatusField`（单据状态）。

package/skills/cosmic-dev-best-practices/references/design-examples/basedata-design-example.md

@@ -63,13 +63,13 @@
 | 禁用人 | `disabler` | UserField [引用 `bos_user`] | 否 | 禁用后记录（框架自动写入） |
 | 禁用时间 | `disabledate` | DateTimeField | 否 | 禁用后记录（框架自动写入） |
 
-> 🔒 **锁定约束**：上述 4 个字段 + 制单信息面板的创建/修改字段（`creator`/`createtime`/`modifier`/`modifytime`）共 8 个，在**页面（form 层）锁定为 `new,edit,submit,audit`（全状态不可编辑）**——由框架自动写入，用户不可手改（属性按字段属性规范 **F.17** 用户字段 / **F.16** 长日期 / **F.18** 创建修改人套用；参考 `sd_agent` 同名字段配置）。
+> 🔒 **锁定约束**：上述 4 个字段 + 制单信息面板的创建/修改字段（`creator`/`createtime`/`modifier`/`modifytime`）共 8 个，在**页面（form 层）锁定为 `new,edit,submit,audit`（全状态不可编辑）**——由框架自动写入，用户不可手改（属性按字段属性规范 **§附录 F.17** 用户字段 / **§附录 F.16** 长日期 / **§附录 F.18** 创建修改人套用；参考 `sd_agent` 同名字段配置）。
 
 ---
 
 ## 三、业务字段设计
 
-> 列名 = `f{字段标识}`（七、命名规范）。字段属性（必填/锁定/引用/带出）**一律不展开**——按 [common-field-property-conventions.md](../elements/common-field-property-conventions.md) 套用：**引用类字段（BasedataField）→ F.4**（使用组织=org 实体 UUID / 查看详情 / 快速新增 缺省）；文本/下拉字段 → 锁定按规范 **§B**（普通业务字段 `submit,audit`）；枚举 value **必须**语义化单词。
+> 列名 = `f{字段标识}`（七、命名规范）。字段属性（必填/锁定/引用/带出）**一律不展开**——按 [common-field-property-conventions.md](../elements/common-field-property-conventions.md) 套用：**引用类字段（BasedataField）→ §附录 F.4**（使用组织=org 实体 UUID / 查看详情 / 快速新增 缺省）；文本/下拉字段 → 锁定按规范 **§B**（普通业务字段 `submit,audit`）；枚举 value **必须**语义化单词。
 
 ### 3.1 主业务字段
 
@@ -77,7 +77,7 @@
 |------|----------|----------|------|:--------:|:----:|------|
 | 港口英文名 | `name_en` | `fname_en` | 文本（String） | 255 | 否 | 提单 / 单证等英文单据展示用 |
 | 国际口岸代码 | `unlocode` | `funlocode` | 文本（String） | 20 | **是** | **UN/LOCODE 标准码**（如 `CNSHA`=上海港、`CNXMN`=厦门港）；报关、舱单、提单必备 |
-| 国家 | `country` | `fcountry` | 引用（Basedata → `bd_country`） | — | **是** | 引用 ERP 内置基础资料「国家和地区」（**字段属性 F.4**）；报关计税、贸易国别统计依赖 |
+| 国家 | `country` | `fcountry` | 引用（Basedata → `bd_country`） | — | **是** | 引用 ERP 内置基础资料「国家和地区」（**字段属性 §附录 F.4**）；报关计税、贸易国别统计依赖 |
 | 备注 | `remark` | `fremark` | 文本（String） | 255 | 否 | 通用备注 |
 
 ### 3.2 可选业务字段（按需启用）
@@ -88,7 +88,7 @@
 |------|----------|----------|------|:--------:|------|------|
 | 港口属性 | `port_kind` | `fport_kind` | 下拉枚举（ComboField） | — | 海港→`sea`，河港→`river`，空港→`air`，陆港→`land` | 影响运输方式判断（海河空陆，UN/LOCODE 同款分类） |
 | 港口级别 | `port_level` | `fport_level` | 下拉枚举（ComboField） | — | 干线港→`mainline`，支线港→`feeder` | 用于订舱决策（航运行业标准术语：干线船/支线船） |
-| 时区 | `timezone` | `ftimezone` | 引用（Basedata → `inte_timezone`） | — | —（非枚举，直接引用基础资料） | 引用 ERP 内置基础资料「时区」（**字段属性 F.4**）；取港口**所在地**时区（非国家时区，国家可能跨多时区）；船期 ETD/ETA 当地时 → 内部标准时区换算、到港预警用 |
+| 时区 | `timezone` | `ftimezone` | 引用（Basedata → `inte_timezone`） | — | —（非枚举，直接引用基础资料） | 引用 ERP 内置基础资料「时区」（**字段属性 §附录 F.4**）；取港口**所在地**时区（非国家时区，国家可能跨多时区）；船期 ETD/ETA 当地时 → 内部标准时区换算、到港预警用 |
 
 ---
 

package/skills/cosmic-dev-best-practices/references/design-examples/bill-design-example.md

@@ -75,13 +75,13 @@
 | 字段 | fieldKey | 类型 | 必填 | 说明 |
 |------|----------|------|:----:|------|
 | 单据类型 | `billtype` | **BillTypeField（单据类型）——agent 不创建，开发者设计器手工添加** | **是** | 区分业务场景（模板不含，开发补充；BillTypeField 属系统字段类型禁止 API 创建）；**预置单据类型：「标准出口合同」**（随包发布，sys 分库） |
-| 合同日期 | `biztime` | **DateField** | **是** | 业务日期（业务发生日期/签订日期，统一 `biztime`）；**必录日期缺省值=当天**（getToday/#CurrentDate#，字段属性规范 F.5） |
-| 客户 | `customer` | **CustomerField** [引用 `bd_customer` 客户] | **是** | 出口客户（ERP 内置，不新建；**专用客户类型，非 BasedataField**，见字段属性规范 §F.3） |
+| 合同日期 | `biztime` | **DateField** | **是** | 业务日期（业务发生日期/签订日期，统一 `biztime`）；**必录日期缺省值=当天**（getToday/#CurrentDate#，字段属性规范 §附录 F.5） |
+| 客户 | `customer` | **CustomerField** [引用 `bd_customer` 客户] | **是** | 出口客户（ERP 内置，不新建；**专用客户类型，非 BasedataField**，见字段属性规范 §附录 F.3） |
 | 贸易术语 | `trade_terms` | ComboField | **是** | 枚举：FOB→`fob`、CFR→`cfr`、CIF→`cif` |
 | 起运港 | `port_of_loading` | BasedataField [引用 `sd_harbor` 港口] | **是** | 出口起运港（共用 L0 港口资料） |
 | 目的港 | `port_of_discharge` | BasedataField [引用 `sd_harbor` 港口] | **是** | 出口目的港 |
-| 交货期 | `delivery_date` | DateField | **是** | 约定交货日期；**必录日期缺省值=当天**（F.5） |
-| 最迟装运日 | `latest_shipdate` | DateField | **是** | 最迟装船日期；**必录日期缺省值=当天**（F.5） |
+| 交货期 | `delivery_date` | DateField | **是** | 约定交货日期；**必录日期缺省值=当天**（字段属性规范 §附录 F.5） |
+| 最迟装运日 | `latest_shipdate` | DateField | **是** | 最迟装船日期；**必录日期缺省值=当天**（字段属性规范 §附录 F.5） |
 | ~~合同总数量~~ | ~~`total_quantity`~~ | ~~QtyField~~ | — | **已删除（2026-08-24）**：原设计「= Σ 明细行数量」供列表统计；用户确认 QtyField 无需配对单位、单据头不设数量汇总，数量全部在分录行维护（需要时可在列表用聚合统计替代） |
 | 包装要求 | `packing_req` | TextField | 否 | 包装/唛头要求 |
 | 质量要求 | `quality_req` | TextField | 否 | 柠檬酸质量指标要求（含量/色度等） |
@@ -94,12 +94,12 @@
 
 | 字段 | fieldKey | 类型 | 必填 | 说明 |
 |------|----------|------|:----:|------|
-| 结算币种 | `settlecurrency` | **CurrencyField** [引用 `bd_currency`] | **是** | 合同计价币种（对齐 `conm_salcontract.settlecurrency`；规划文档示例 USD）；**必录 + 缺省值=人民币**（getBasedata/RMB，字段属性规范 F.12）；**锁定**（submit,audit，汇率原币） |
-| 本位币 | `currency` | **CurrencyField** [引用 `bd_currency`] | **是** | 本位币（对齐 `conm_salcontract.currency`）；**必录 + 缺省值=人民币**（getBasedata/RMB，字段属性规范 F.12） |
-| 汇率表 | `exratetable` | **BasedataField** [引用 `bd_exratetable`] | **是** | 汇率表（对齐 `conm_salcontract.exratetable`）；**汇率配套字段必录**（字段属性规范 F.14 强约束） |
-| 汇率日期 | `exratedate` | **DateField** | **是** | 汇率日期（对齐 `conm_salcontract.exratedate`）；**汇率配套字段必录**（F.14） |
-| 换算方式 | `exchangetype` | **ComboField** | **是** | 0=直接汇率, 1=间接汇率（对齐 `conm_salcontract.exchangetype`）；**汇率配套字段必录**（F.14）；**锁定**（submit,audit + new,edit 新增/修改锁定） |
-| 汇率 | `exchangerate` | **ExchangeRateField** | **是** | 结算币与本位币折算（对齐 `conm_salcontract.exchangerate`）；**关联原币=settlecurrency/目标币=currency/汇率表/汇率日期/换算方式 5 项**（F.14 强约束） |
+| 结算币种 | `settlecurrency` | **CurrencyField** [引用 `bd_currency`] | **是** | 合同计价币种（对齐 `conm_salcontract.settlecurrency`；规划文档示例 USD）；**必录 + 缺省值=人民币**（getBasedata/RMB，字段属性规范 §附录 F.12）；**锁定**（submit,audit，汇率原币） |
+| 本位币 | `currency` | **CurrencyField** [引用 `bd_currency`] | **是** | 本位币（对齐 `conm_salcontract.currency`）；**必录 + 缺省值=人民币**（getBasedata/RMB，字段属性规范 §附录 F.12） |
+| 汇率表 | `exratetable` | **BasedataField** [引用 `bd_exratetable`] | **是** | 汇率表（对齐 `conm_salcontract.exratetable`）；**汇率配套字段必录**（字段属性规范 §附录 F.14 强约束） |
+| 汇率日期 | `exratedate` | **DateField** | **是** | 汇率日期（对齐 `conm_salcontract.exratedate`）；**汇率配套字段必录**（§附录 F.14） |
+| 换算方式 | `exchangetype` | **ComboField** | **是** | 0=直接汇率, 1=间接汇率（对齐 `conm_salcontract.exchangetype`）；**汇率配套字段必录**（§附录 F.14）；**锁定**（submit,audit + new,edit 新增/修改锁定） |
+| 汇率 | `exchangerate` | **ExchangeRateField** | **是** | 结算币与本位币折算（对齐 `conm_salcontract.exchangerate`）；**关联原币=settlecurrency/目标币=currency/汇率表/汇率日期/换算方式 5 项**（§附录 F.14 强约束） |
 | 结算方式 | `settletype` | **BasedataField** [引用 `bd_settlementtype`] | 否 | 结算方式（对齐 `conm_salcontract.settletype`） |
 | 付款条件 | `payment_terms` | ComboField | **是** | 枚举：T/T→`tt`、L/C→`lc`、D/P→`dp`（出口业务特有） |
 | 含税 | `istax` | **CheckBoxField** | 否 | 是否含税（对齐 `conm_salcontract.istax`） |
@@ -122,8 +122,8 @@
 | 字段 | fieldKey | 类型 | 必填 | 说明 |
 |------|----------|------|:----:|------|
 | 物料编码 | `material` | **MaterielField** [引用 `bd_materialinventoryinfo`] | **是** | 出口产品（**参考过磅单 `entryentity.material` 属性**：MaterielField → `bd_materialinventoryinfo`，显示名「物料编码」） |
-| 物料名称 | `materialname` | **基础资料属性（BasedataField）**，从属 `material` | — | 配置**显示物料的引用属性**：**跟随字段=物料编码 `material`**（选了物料即显示其资料）、显示属性=`masterid.name`（key 与过磅单一致；平台自动展示，**无需配置实体规则**）；**⚠️ 创建通道：modifyMeta 增量不可行（平台限制），须 buildMeta 建模时创建或设计器手工添加**（字段属性规范 F.8） |
-| 规格型号 | `model` | **基础资料属性（BasedataField）**，从属 `material` | — | 配置**显示物料的引用属性**：**跟随字段=物料编码 `material`**、显示属性=`masterid.modelnum`（key 与过磅单一致；平台自动展示，**无需配置实体规则**）；**创建通道同 materialname**（F.8） |
+| 物料名称 | `materialname` | **基础资料属性（BasedataField）**，从属 `material` | — | 配置**显示物料的引用属性**：**跟随字段=物料编码 `material`**（选了物料即显示其资料）、显示属性=`masterid.name`（key 与过磅单一致；平台自动展示，**无需配置实体规则**）；**⚠️ 创建通道：modifyMeta 增量不可行（平台限制），须 buildMeta 建模时创建或设计器手工添加**（字段属性规范 §附录 F.8） |
+| 规格型号 | `model` | **基础资料属性（BasedataField）**，从属 `material` | — | 配置**显示物料的引用属性**：**跟随字段=物料编码 `material`**、显示属性=`masterid.modelnum`（key 与过磅单一致；平台自动展示，**无需配置实体规则**）；**创建通道同 materialname**（§附录 F.8） |
 | 数量 | `qty` | **QtyField** | **是** | 合同数量（数量 `qty`） |
 | 单位 | `unit` | **UnitField** [引用 `bd_measureunits`] | **是** | 计量单位（单位 `unit` → `bd_measureunits`，如 MT 吨） |
 | 基本单位 | `baseunit` | **UnitField** [引用 `bd_measureunits`] | **是** | 基本计量单位（参考过磅单 `entryentity.baseunit`：UnitField → `bd_measureunits`，必填） |
@@ -272,7 +272,7 @@ sd_excontract 出口合同（BillFormAp）
   > ✅ 面板布局：fs_baseinfo（11 含 org/billstatus）/ fs_financeinfo（16）/ fs_clause（3）/ 商品明细（**高级容器 advconap** → advconchildcanelap → entryentity，buildMeta 自动生成）/ attachmentpanel / fs_creator（10 审计状态族）+ 三面板可折叠 + 状态族列表列移除（10 列）+ 面板顺序规范（基本信息→财务→条款→商品明细→附件→制单→隐藏）
   > ✅ 锁定：审计/状态/制单全锁、金额族含 new,edit、换算方式新增+修改锁定（**不改下拉项**）——getFormSchema 回读 formLayout 验证
   > ✅ 汇率即时触发：exchangerate + 绑定 5 字段 FireUpdEvt=true（币种/汇率日期更新后汇率自动联动）
-  > ⚠️ 汇总：SummaryToField 金额三件套**已写入**（分录 amount→主表 totalamount、taxamount→totaltaxamount、amountandtax→totalallamount；`setSummaryToField` 的 input 是**表头字段 key 的裸 JSON 字符串，必须写文件**）——**该能力已降级 + 回读 fieldId 存的是字段 key 而非 UUID，运行时是否生效待开发者设计器/运行态验证**（详见 field-property §F.13）
+  > ⚠️ 汇总：SummaryToField 金额三件套**已写入**（分录 amount→主表 totalamount、taxamount→totaltaxamount、amountandtax→totalallamount；`setSummaryToField` 的 input 是**表头字段 key 的裸 JSON 字符串，必须写文件**）——**该能力已降级 + 回读 fieldId 存的是字段 key 而非 UUID，运行时是否生效待开发者设计器/运行态验证**（详见 field-property §附录 F.13）
   > ⚠️ 物料名称/规格型号（**手工待办，agent 未执行**）：BasedataFieldField 平台限制增量不可行，开发者设计器手工添加（sd_materialname→masterid.name、sd_modelnum→masterid.modelnum）
   > ✅ 元数据回读验证通过（getFormSchema：面板顺序/字段归位/锁定/引用属性/汇率关联/汇总全部一致）
 

package/skills/cosmic-dev-best-practices/references/elements/CustomerField.md

@@ -77,4 +77,4 @@
 - [BasedataField.md](BasedataField.md)：通用基础资料字段（赋值/引用指定）
 - [common-field-property-conventions.md](common-field-property-conventions.md)：通用字段属性规范（本字段经验原驻留 F.3，已迁出）
 - [java-plugin.md](../java-plugin.md)：字段赋值套路 §四
-- 同类专用元素：`SupplierField`（供应商）、`UnitField`（单位）、`CurrencyField`（币别）、`OrgField`（组织）、`UserField`（用户）——字段类型/属性同理，见 field-property F 系列
+- 同类专用元素：`SupplierField`（供应商）、`UnitField`（单位）、`CurrencyField`（币别）、`OrgField`（组织）、`UserField`（用户）——字段类型/属性同理，见 field-property §附录（原 F 系列）

package/skills/cosmic-dev-best-practices/references/elements/README.md

@@ -33,7 +33,7 @@
 | 字段元素 | MuliLangTextProp（多语言文本） | [MuliLangTextProp.md](MuliLangTextProp.md) | LocaleString 赋值/整单加载/save | ✅ 已建（2026-08-26 实测） |
 
 > ℹ️ `botp_selectfield`（字段选择器）是 **ERP 内置表单**（标准资产），不是 UI 元素——不纳入本目录；其复用经验在 [dynamic-form-dev-convention.md](../dynamic-form-dev-convention.md) §五（字段选择器复用）。
-> 📌 **公共属性规范**（必填/锁定/ViewDetail/默认值/列表列/系统字段禁建/走查——适用于所有字段类型）见 [common-field-property-conventions.md](common-field-property-conventions.md)；元素文档只写本元素专属内容，横切规则一律引它、不重复。
+> 📌 **公共属性规范**（必填/锁定/ViewDetail/默认值/列表列/容量/系统字段禁建/走查——适用于所有字段类型）见 [common-field-property-conventions.md](common-field-property-conventions.md)；元素文档只写本元素专属内容，横切规则一律引它、不重复。
 
 ---
 

package/skills/cosmic-dev-best-practices/references/elements/SupplierField.md

@@ -20,7 +20,7 @@
 | 6 | **QuickAddNew 快速新增** | `false`（须显式置 false） | 不允许 F7 快速新增供应商 |
 | 7 | form 层 Lock | `submit,audit`（缺省） | 提交后锁定 |
 
-### 1.2 命令（同客户 F.3 已验证写法）
+### 1.2 命令（同客户 [CustomerField.md](CustomerField.md) 已验证写法）
 
 ```bash
 # ① 添加（authoring: dataType SupplierField，无 reference）