@shundoo-ai/dsh-cosmic 1.0.21 → 1.0.22

package/skills/cosmic-dev-best-practices/references/elements/common-field-property-conventions.md

@@ -2,7 +2,7 @@
 
 > 📌 本文件为 **elements/ 元素文档的公共属性规范**（横切规则，适用于所有字段类型）；元素专属最佳实践见各元素文档（索引 [elements/README.md](README.md)）。
 
-> 用途：苍穹开发**字段创建后的常规属性设置规范**——每个字段除了命名（见 [naming-convention.md](../naming-convention.md)）与类型（见 cosmic-meta-knowledge `field-types.md`）外，还需设置哪些**常规属性**（必填/锁定/默认值/ViewDetail/列表列等）。
+> 用途：苍穹开发**字段创建后的常规属性设置规范**——每个字段除了命名（见 [naming-convention.md](../naming-convention.md)）与类型（见 cosmic-meta-knowledge `field-types.md`）外，还需设置哪些**常规属性**（必填/锁定/默认值/ViewDetail/列表列/容量等）。
 > 适用范围：**单据与基础资料通用**（开发任何业务对象）。
 > 依据：2026-08-25 出口合同 `sd_excontract` 全字段属性走查实测 + 过磅单 `sd_weighingbill` 对照 + 既有最佳实践文档。
 > 配套：[naming-convention.md](../naming-convention.md)（命名）、[bill-dev-convention.md](../bill-dev-convention.md)（单据流程）、[basedata-dev-convention.md](../basedata-dev-convention.md)（基础资料流程）、[cosmic-meta-api.md](../cosmic-meta-api.md)（API 写法）。
@@ -23,11 +23,28 @@
 |---|------|---------|---------|
 | A | 必填 MustInput | 业务关键字段 | buildMeta authoring `mustInput` / addField `--required` |
 | B | 锁定 Lock（form 层） | **单据头 / 分录字段**（按类别） | `setProperties --policy`（form 层才生效） |
-| C | ViewDetail（查看详情） | **用户字段**（创建/修改/审核/关闭/作废人等） | `setProperties {"ViewDetail": false}` |
-| D | 默认值 DefValue | 状态/数值/布尔字段 | `setProperties {"DefValue": ...}` |
+| C | ViewDetail（查看详情） | **用户字段**（创建/修改/审核/关闭/作废人等） | `setProperties --policy`（兼容 `--elementKey --input`） |
+| D | 默认值 DefValue | 状态/数值/布尔字段 | `setProperties --policy` 的 `defaultsByField`（兼容 `--elementKey --input`） |
 | E | 列表列 | 列表视图 | `modifyMeta remove listcolumn`（移除审计/状态列） |
+| G | 字段容量 MaxLength | 文本 / 多行 / 大文本字段 | `setProperties --policy`（或 `--elementKey/--input`），见 §G |
 
 > 其余字段属性（样式/显隐/条件过滤/状态列表）见各流程文档：样式→cosmic-meta-api §2.2；状态列表→bill-dev §4.1（无 API 手工配置）；条件必录→bill-dev §六（手工配置）。
+>
+> 📌 **按字段类型的必设属性索引**（值只维护在 `elements/<类型>.md` §一，此处仅索引）：
+>
+> | 字段类型 | `OrgFieldId=MwLyMGIJQa` | `ViewDetail=false` | `QuickAddNew=false` | 其他必设项 |
+> |---|:---:|:---:|:---:|---|
+> | `BasedataField` | ✅ | ✅ | ✅ | — |
+> | `CurrencyField` | ✅ | ✅ | ✅ | 必填 + 缺省=人民币 |
+> | `CustomerField`／`SupplierField`／`MaterielField` | ✅ | ✅ | ✅ | — |
+> | `UnitField` | ✅ | —（未要求） | ✅ | 同实体有物料字段时关联 `MaterielFieldId` |
+> | `OrgField` | 自身即组织 | ✅ | ✅ | 「主业务组织」**无 CLI**，设计器指定；模板未设必填 |
+> | `UserField` | — | ✅ | ✅ | 制单/审计类全锁 `new,edit,submit,audit` |
+> | `AssistantField` | ✅ | ⚠️ **true（可保留）** | ✅ | 建模用 `assistantCategory`，禁 `basedataNumber` |
+> | `FlexField` | — | —（未要求） | ✅ | `flexType` > 0，否则降级 TextField |
+> | `BasedataPropField` | — | —（未要求） | ✅ | `RefBaseFieldId` + `RefDisplayProp`；全锁 |
+>
+> ⚠️ **不要概括成"引用类字段一律 false"**：`AssistantField` 的 ViewDetail 保留 `true`，`UnitField`/`FlexField`/`BasedataPropField` 的 ViewDetail 各文档**未要求**——以本表与元素文档为准；§C 只讲 ViewDetail 的通用判断。
 
 ---
 
@@ -87,7 +104,7 @@
 | 制单字段（创建/修改人+时间） | `new,edit,submit,audit` | 同上 | creator/modifier/createtime/modifytime |
 | 单据状态 billstatus | `new,edit,submit,audit` | 状态流转框架控制 | billstatus |
 | 状态字段 closestatus/cancelstatus | `new,edit,submit,audit` | 状态列表自动写入 | closestatus/cancelstatus |
-| **自动计算字段（金额族/带出字段）** | `submit,audit,new,edit` | 编辑期只读防篡改（金额族；**不含单价 price/priceandtax——单价是用户录入，锁 `submit,audit`，见 F.13**） | totalamount/totaltaxamount/totalallamount、amount/taxamount/amountandtax/curamount/curtaxamount/curamountandtax、materialname/model |
+| **自动计算字段（金额族/带出字段）** | `submit,audit,new,edit` | 编辑期只读防篡改（金额族；**不含单价 price/priceandtax——单价是用户录入，锁 `submit,audit`，见 [PriceField.md](PriceField.md)**） | totalamount/totaltaxamount/totalallamount、amount/taxamount/amountandtax/curamount/curtaxamount/curamountandtax、materialname/model |
 | 普通业务字段 | `submit,audit` | 编辑期可改，提交/审核后锁定 | customer/port_of_loading/qty/price/trade_terms 等 |
 
 **命令**（form 层，单字段与整批同一形状）：
@@ -101,7 +118,20 @@
 > 写入**已生效**，但回执必报 `STATIC_FIELD_LOCK_READBACK_MISMATCH` / `outcome=unknown_after_write` / `actual:{"<字段>":""}`——
 > 原因是平台元数据**省略"等于默认值"的 Lock 属性**，CLI 回读拿不到。**这不是失败**：用 `getFormSchema` 的 `formLayout.lock` 复核（会显示 `submit,audit`），**不要重试**。
 > 其它任意取值（含 `new,edit,submit,audit`）回执均为 `status=true` / `verified=true`。
-> 📌 `setProperties --elementKey/--input` 对 Lock 已不可用（恒报 `PROPERTY_READ_ONLY`，模板字段同样被拒），**只走 `--policy`**。
+> 📌 **字段（`FieldAp`）的 Lock 只走 `--policy`**：`setProperties --elementKey <字段key> --input '{"Lock":…}'` 恒报 `PROPERTY_READ_ONLY`（模板字段同样被拒）。
+> **容器控件相反**——面板/单据体/附件面板仍走 `--elementKey <控件> --input`（见本节开头），**不能**把这两条互相套用。
+
+**Lock 实测矩阵（2026-11-06，`sd_paymentbill3` 实测）**：
+
+| 对象 | 路径 | 值 | 结果 |
+|---|---|---|---|
+| 字段 | `--policy` | `new,edit,submit,audit` | ✅ `verified=true`（批量 40 字段通过） |
+| 字段 | `--policy` | 含 `view` | ❌ `PROPERTY_POLICY_ENUM_VALUE_INVALID`（allowed=`new/edit/submit/audit`） |
+| 字段 | `--policy` | `submit,audit` | ⚠️ 回执 `STATIC_FIELD_LOCK_READBACK_MISMATCH` / `outcome=unknown_after_write`，但**写入真实生效**（`formLayout.lock` 回读已变）→ **不要重试** |
+| 字段 | `--elementKey/--input` | 任意 | ❌ `PROPERTY_READ_ONLY` |
+| 容器 | `--elementKey/--input` | `view,submit,audit` 或 4 值 | ✅ `verified=true`、`lock` 回读一致 |
+
+> ⚠️ **`view` 只属于容器**：字段只认 4 个值。线上既有单据的**字段** `formLayout.lock` 常显示 `new,edit,view,submit,audit`（历史值），**照抄到新字段会被 CLI 拒绝**——这不是"线上能写所以技能写错了"，而是历史数据不可作为取值依据。
 
 > ⭐ **状态字段类型（closestatus/cancelstatus）——最终形态「单据状态」BillStatusField（2026-08-25 用户确认）**：
 > - **标准类型 = BillStatusField（单据状态）**——khxty 现有单据 dym 实测全部如此：`sd_returnapp` 4 个、`sd_conord` 8 个、`sd_executeorder` 5 个、`sd_conpur` 7 个 `<BillStatusField>`（含 StatusItems 状态列表 + `DefValue=A`）；
@@ -117,12 +147,18 @@
 | 制单/审计面板的用户字段（创建/修改/审核/关闭/作废人） | **`ViewDetail=false`**（默认 true，F7 弹窗显示"查看详情"入口，系统审计字段无需） | creator/modifier/auditor/closer/canceler |
 | 业务引用用户字段（如经办人） | 保持 true（可选） | — |
 
-**命令**：
+**命令**（新请求优先用 compact policy；`--elementKey/--input` 为兼容旧写法）：
 ```bash
+# ✅ 首选
+{cosmic_api} setProperties --app-root <appRoot> --form-name <表单> \
+  --policy '{"targets":{"fields":["<用户字段>"],"entities":["header"]},"set":{"ViewDetail":false}}'
+# 兼容旧写法（仍可用）
 {cosmic_api} setProperties --app-root <appRoot> --formNumber <表单> \
   --elementKey <用户字段key> --input '{"ViewDetail": false}'
 ```
 
+> 📌 `QuickAddNew`（快速新增）与 ViewDetail **成对处理**：凡 §〇 索引表标 ✅ 的类型，同一批 policy 一起写（`"set":{"ViewDetail":false,"QuickAddNew":false}`）；`AssistantField` 的 ViewDetail 保留 `true`，只关 `QuickAddNew`。
+
 ---
 
 ## D、默认值（DefValue）
@@ -134,8 +170,12 @@
 | 布尔字段（含税等） | `false` | 框架默认 | ✅（istax） |
 | 下拉字段（贸易术语/付款条件） | 无默认（用户必选） | 或按业务设常用值 | trade_terms/payment_terms |
 
-**命令**：
+**命令**（新请求优先用 compact policy 的 `defaultsByField`；`--elementKey/--input` 为兼容旧写法）：
 ```bash
+# ✅ 首选：静态值 / 设计缺省值（函数）/ 引用记录，一次批量
+{cosmic_api} setProperties --app-root <appRoot> --form-name <表单> \
+  --policy '{"targets":{"fields":["<字段>"],"entities":["header"]},"defaultsByField":{"<字段>":"<静态值>","<日期字段>":{"kind":"design","input":{"FuncType":"getToday","FuncParameter":"#CurrentDate#"}},"<币别字段>":{"kind":"record","value":"人民币"}}}'
+# 兼容旧写法（仍可用；`DefValueDesign` 不得编码静态标量）
 {cosmic_api} setProperties --app-root <appRoot> --formNumber <表单> \
   --elementKey <字段key> --input '{"DefValue": "A"}'
 ```
@@ -159,21 +199,77 @@
 
 ---
 
-## G、走查顺序（字段属性核对清单）
+## G、字段容量（MaxLength）
+
+> ⭐ **取值优先级（总则，与 §〇 一致）**：
+> 1. **设计文档指定了长度 → 按设计文档设置**——大于或小于类型默认都照设；设计若用列宽表达平台约束（如 `body` ≤127），不要擅自放宽成 255；
+> 2. **设计文档未指定 → 用类型默认，不设**（本库约定「不做长度批次」）。
+>
+> 判据：`getFormSchema` **不返回** MaxLength。唯一权威是**导出 DYM 的 `<MaxLength>`**（= 建表列宽）。
+> 下表为 **2026-11-06 建模路径新建表单的实测产出**（`sd_paymentbill3`），**仅在设计未指定时**作为缺省依据：
+
+| 类型 | 建模产出（显式） | 平台内建默认（属性省略时） | 说明 |
+|---|---|---|---|
+| `TextField` | **255** | **50** | 建模路径显式写 255；显式设成 50 时属性被省略，有效值即 50 |
+| `TextAreaField` | **500** | — | 多行文本的默认值 |
+| `LargeTextField` | **2000** | — | 大文本；全文落库里的 **`_tag` 伴随列（NCLOB）**，主列只放摘要（本库 `notifyraw` 即此用法；DYM 里看不到伴随列属正常） |
+
+- **可写（2026-11-06 实测）**：两条路径都生效、`verified=true`，导出 DYM 复核一致——
+  `setProperties --policy '{"targets":{"fields":["<字段>"],"entities":["header"]},"set":{"MaxLength":1000}}'`
+  或 `setProperties --elementKey <字段key> --input '{"MaxLength":1000}'`；
+  `describePropertyInput --propertyNames MaxLength` 报 `editable=true`、范围 **0–2000**。
+  ⚠️ 旧记录「MaxLength 不在属性表 / 必报 `META_SAVE_FAIL` / 只能建表时定」**已过期**，不要再据此跳过长度设置。
+- ⚠️ **DYM 缺 `<MaxLength>` ≠ 没写进去**（2026-11-06 实测）：平台会**省略"等于内建默认"的属性**——`TextField` 显式设 **50** 后，导出 DYM 里该字段不再出现 `<MaxLength>`，但值确实生效（与 §B 里 Lock 写 `submit,audit` 的假阴性同源）。**验证时把"缺失"读成 50**，不要按"未生效"重试。
+- ⚠️ **别拿既有单据反推类型默认**：`qrcodeurl` 在 `sd_paymentbill` 是 **1000**（曾显式设过），新建同名字段却得 **500**——默认值只能取「新建产出」。
+- 📌 **例**：设计写 `body` ≤127 → **就设 127**（即便类型默认 255 装得下）；设计没写 → 保持 255 不动。
+- ⚠️ **列宽 ≠ 值上限**：平台对值的上限（如微信 `attach`/`body` ≤127）通常还应由**代码**校验兜住；列宽不足会**静默截断**（对账标识类字段尤其危险），故设计未指定的平台返回值类字段宁可给足 255。
+
+---
+
+## H、走查顺序（字段属性核对清单）
 
 新建/重建表单后，按此顺序逐字段核对：
 
 1. **必填**：设计文档必填标注 → mustInput（authoring/addField）
 2. **锁定**：按字段类别设 form 层 Lock（见 B 表）——审计/制单/状态全锁，自动计算含 new,edit，业务字段 submit,audit
-3. **ViewDetail**：用户字段关闭（制单/审计面板）
+3. **ViewDetail / QuickAddNew / OrgFieldId**：按 §〇 索引表逐类型处理（`AssistantField` 的 ViewDetail 保留 `true`）
 4. **默认值**：billstatus='A'，数值 0，布尔 false
-5. **列表列**：移除审计/状态族列
-6. **面板归位**：字段移动到对应面板（见 bill-dev §二、basedata-dev §四）
-7. **面板可折叠**：新建 FieldsetPanelAp 设 `Collapsible=true`（通用布局规范，bill-dev §2.1）
-8. **引用/带出**：BasedataField 引用目标、带出字段 SrcField 路径（见 cosmic-meta-api §3.1.1、bill-dev §六）
+5. **容量**：设计指定了长度 → 按设计设置；未指定 → 保持类型默认、不设（见 §G）
+6. **列表列**：移除审计/状态族列
+7. **面板归位**：字段移动到对应面板（见 bill-dev §二、basedata-dev §四）
+8. **面板可折叠**：新建 FieldsetPanelAp 设 `Collapsible=true`（通用布局规范，bill-dev §2.1）
+9. **引用/带出**：BasedataField 引用目标、带出字段 SrcField 路径（见 cosmic-meta-api §3.1.1、bill-dev §六）
 
 ---
 
+## 附录：F 系列编号对照（历史引用可解析）
+
+> 原「F.1–F.19 字段属性细则」已按元素类型迁入 `elements/`，本文档改为 〇/A–E/G 小节；
+> 但本技能内（design-examples、bill-dev 等）与**外部项目设计文档**仍以 `F.x` 引用，按下表解析。
+
+| 原编号 | 现位置 | 内容 |
+|---|---|---|
+| F.1 | [OrgField.md](OrgField.md) | 主业务组织（单据=`org`／基础资料=`createorg`） |
+| F.2 | 本文 §〇·二 | 系统字段类型（`billtype`/`paystatus` 等 agent 不创建） |
+| F.3 | [CustomerField.md](CustomerField.md) | 客户字段 |
+| F.4 | [BasedataField.md](BasedataField.md) | 引用类字段（使用组织／查看详情／快速新增） |
+| F.5 | [DateTimeField.md](DateTimeField.md) | 必录日期缺省=当天（`getToday`/`#CurrentDate#`） |
+| F.6 | [SupplierField.md](SupplierField.md) | 供应商字段 |
+| F.7 | [PriceField.md](PriceField.md) | 金额相关（现存文档无 F.7 引用、无迁移记录；金额族锁定见 §B） |
+| F.8 | [BasedataPropField.md](BasedataPropField.md) | 基础资料属性字段（创建通道限制） |
+| F.9 | [UnitField.md](UnitField.md) | 计量单位 |
+| F.10／F.11 | [QtyField.md](QtyField.md) | 数量字段／基本单位数量 |
+| F.12 | [CurrencyField.md](CurrencyField.md) | 币别（必录 + 缺省人民币） |
+| F.13 | [PriceField.md](PriceField.md) | 单价（用户录入，锁 `submit,audit`，**不含**金额族） |
+| F.14 | [ExchangeRateField.md](ExchangeRateField.md) | 汇率 5 项配套必录 |
+| F.15 | [AssistantField.md](AssistantField.md) | 辅助资料 |
+| F.16 | [DateTimeField.md](DateTimeField.md) | 长日期（`getNow`/`#CurrentDatetime#`） |
+| F.17 | [UserField.md](UserField.md) | 用户字段（ViewDetail 等） |
+| F.18 | [CreaterField.md](CreaterField.md) | 创建／修改人（框架写入 + 全状态锁定） |
+| F.19 | [FlexField.md](FlexField.md) | 弹性域 |
+
+> 📌 **新写的设计文档不要再引用 `F.x`**——改引现行锚点：必填 §A、锁定 §B、ViewDetail §C、默认值 §D、列表列 §E，类型专属规则见 `elements/<类型>.md`。
+
 ## 相关文档
 
 - [naming-convention.md](../naming-convention.md)：字段命名规范（fieldKey/列名/类型）

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

@@ -138,7 +138,7 @@ advconap（商品明细 高级容器）← contentpanel 子容器，带标题
 |---|------|-----|------|
 | 1 | **Lock** | 按字段类别（见 field-property §B）| **form 层才生效**（FieldAp/EntryFieldAp）|
 | 2 | Visible | `init,new,edit,view,submit,audit` | 默认全状态可见 |
-| 3 | **FireUpdEvt 即时触发值更新** | `true`（联动字段）| 汇率/币种等字段更新后联动（见 F.14 汇率规范）|
+| 3 | **FireUpdEvt 即时触发值更新** | `true`（联动字段）| 汇率/币种等字段更新后联动（见 [ExchangeRateField.md](elements/ExchangeRateField.md) 汇率规范）|
 | 4 | ~~Hidden~~ / **Invisible** | 只用 `Invisible` | ⚠️ **`Hidden` 已废弃**：设计器已移除该入口，它属历史内部属性「设计时隐藏」，**禁止写入或自动探测 `Hidden`**（0.0.299 口径，附工单 BT-02386052）。隐藏字段一律用 `invisible` |
 
 **命令**：

package/skills/erp-analysis/references/delivery-contract.md

@@ -64,7 +64,7 @@ present(files=[{path, description}])
 
 ## 四. 版本锚点与复验
 
-- **依据版本**：`@deepseek-ai/dsh-desktop-runtime 0.2.1-rc.3`（2026-10-29 复核）
+- **依据版本**：`@deepseek-ai/dsh-desktop-runtime 0.2.2-rc.1`（2026-11-06 复核）
 - **复验触发**：DSH / preset 升级后
 - **复验方法**：确认 `present` 工具仍在工具清单中、且调用后回复下方出现交付卡片。
   两者任一不成立 → 按实际情况改版本文（判断依据见文末附录）。
@@ -76,6 +76,7 @@ present(files=[{path, description}])
 | 2026-09-25 | 0.1.7-rc.2 | 新建。交付手段定为 `present`；移除了旧版「靠文件操作换取可点入口」的整套描述 |
 | 2026-10-19 | 0.2.1-rc.2 | 复验：`present` 仍在官方 standard 组合中（29 行中的第 27 行）→ **契约内容不变**，仅前移版本锚点 |
 | 2026-10-29 | 0.2.1-rc.3 | 复验：`@deepseek-ai/dsh-tool-present` 包仍在；`dsh-web-app/presets/standard.patch.yml` 仍挂载 `present`，**且 cosmic preset 自身另有一份显式声明**（`agent.cordis.yml` / `cordis.patch.yml`）→ 双保险，DSH 与 preset 任一侧改动都不会单独让它消失；本会话工具清单实测可用 → **契约内容不变**，仅前移版本锚点 |
+| 2026-11-06 | 0.2.2-rc.1 | 复验：`standard.patch.yml` 已扩到 131 行，`- id: present` / `@deepseek-ai/dsh-tool-present` 仍在（L124–125）；cosmic preset 自身仍显式声明（`agent.cordis.yml` L238 / `cordis.patch.yml` L251）；本会话工具清单可用 → **契约内容不变**，仅前移版本锚点。同版还同步了 0.2.2 的组合调整（`applyPatch: false`、移除 `tool-subagent-list-agents`、`modelSelection`/`modelDiscovery` 取代 `modelSelectionSettings`） |
 
 ---
 

package/skills/erp-analysis/templates/AGENTS.template.md

@@ -14,6 +14,8 @@
 - macOS/Linux：`{VENV}/bin/python`
 - Windows：`{VENV}/Scripts/python.exe`
 
+> 📌 技能文本里的 `{python}` 即上述 `{VENV}` 解释器；技能若给出 `python3`／`python` 的探测顺序，不适用。
+
 > 首次使用、或 `$DSH_HOME/cache/cosmic/venv` 被删后，需初始化：
 > macOS/Linux `bash {PRESET}/skills/erp-analysis/scripts/init-python.sh`；
 > Windows `pwsh {PRESET}/skills/erp-analysis/scripts/init-python.ps1`。
@@ -57,7 +59,7 @@
 - 完整契约（降级链、判断依据、版本锚点）：
   `{PRESET}/skills/erp-analysis/references/delivery-contract.md`
 
-> 版本锚点：`@deepseek-ai/dsh-desktop-runtime 0.2.1-rc.3`（2026-10-29 复核）。
+> 版本锚点：`@deepseek-ai/dsh-desktop-runtime 0.2.2-rc.1`（2026-11-06 复核）。
 > DSH / preset 升级后若 `present` 消失或交付卡片不再出现，回到该契约文件复验。
 
 <!-- 后续按需补充：元数据建模等约定 -->

package/skills/cosmic-build/assets/platform-report-filters/TypedReportFilterFields.java

@@ -1,169 +0,0 @@
-package kd.bos.designer.property.setting;
-
-import kd.bos.metadata.entity.commonfield.DecimalField;
-import kd.bos.metadata.entity.commonfield.TextField;
-import kd.bos.metadata.entity.commonfield.Field;
-import kd.bos.metadata.entity.commonfield.DateTimeField;
-import kd.bos.metadata.entity.commonfield.DateRangeField;
-import kd.bos.metadata.entity.commonfield.ComboField;
-import kd.bos.metadata.entity.commonfield.ComboItem;
-import kd.bos.metadata.entity.businessfield.AbstractBasedataField;
-import kd.bos.metadata.entity.EntityMetadata;
-import kd.bos.metadata.form.FormMetadata;
-import kd.bos.metadata.form.ControlAp;
-import kd.bos.metadata.form.control.FieldAp;
-
-import java.util.ArrayList;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-import java.io.ByteArrayInputStream;
-import java.io.ByteArrayOutputStream;
-import java.io.ObjectInputStream;
-import java.io.ObjectOutputStream;
-
-/** Platform extension for ReportFilters.typed; no service writes or identity lookup here. */
-public final class TypedReportFilterFields {
-    private TypedReportFilterFields() { }
-
-    public static Field<?> create(Field<?> source, String compare) {
-        if (source == null) throw new IllegalArgumentException("REPORT_FILTER_SOURCE_FIELD_NOT_FOUND");
-        if (!java.util.Arrays.asList("TextField", "DateField", "DateTimeField", "DateRangeField", "ComboField",
-                "MulComboField", "BasedataField", "MulBasedataField", "DecimalField").contains(source.getClass().getSimpleName()))
-            throw new IllegalArgumentException("REPORT_FILTER_SOURCE_TYPE_UNSUPPORTED: " + source.getClass().getSimpleName());
-        Field<?> result;
-        if ("13".equals(compare) && !(source instanceof DateRangeField)) {
-            if (!(source instanceof DateTimeField)) {
-                throw new IllegalArgumentException("REPORT_FILTER_RANGE_TYPE_UNSUPPORTED: " + source.getClass().getSimpleName());
-            }
-            DateRangeField range = new DateRangeField();
-            range.setRegionType(((DateTimeField) source).getRegionType());
-            range.setTimeZoneTransType(((DateTimeField) source).getTimeZoneTransType());
-            result = range;
-        } else {
-            try {
-                result = source.getClass().getDeclaredConstructor().newInstance();
-            } catch (ReflectiveOperationException error) {
-                throw new IllegalArgumentException("REPORT_FILTER_SOURCE_TYPE_UNSUPPORTED", error);
-            }
-            if (source instanceof AbstractBasedataField) {
-                AbstractBasedataField<?> from = (AbstractBasedataField<?>) source;
-                AbstractBasedataField<?> to = (AbstractBasedataField<?>) result;
-                to.setBaseEntityId(from.getBaseEntityId());
-                to.setDisplayProp(from.getDisplayProp());
-                to.setNumberProp(from.getNumberProp());
-                to.setEditSearchProp(from.getEditSearchProp());
-                to.setLayoutId(from.getLayoutId());
-                to.setDisplayStyle(from.getDisplayStyle());
-                to.setOrgFieldId(from.getOrgFieldId());
-                to.setFilter(copy(from.getFilter()));
-                if (from.getRefProps() != null && !from.getRefProps().isEmpty()) to.getRefProps().addAll(copy(from.getRefProps()));
-                if (from.getConditionalFilterRule() != null && !from.getConditionalFilterRule().isEmpty()) {
-                    throw new IllegalArgumentException("REPORT_FILTER_CONDITIONAL_REFERENCE_UNSUPPORTED");
-                }
-            }
-            if (source instanceof ComboField) ((ComboField) result).setItems(copy(((ComboField) source).getItems()));
-            if (source instanceof DateTimeField) {
-                DateTimeField from = (DateTimeField) source, to = (DateTimeField) result;
-                to.setRegionType(from.getRegionType());
-                to.setTimeZoneTransType(from.getTimeZoneTransType());
-                to.setMinDate(from.getMinDate());
-                to.setMaxDate(from.getMaxDate());
-            }
-            if (source instanceof DateRangeField) {
-                ((DateRangeField) result).setTimeZoneTransType(((DateRangeField) source).getTimeZoneTransType());
-                ((DateRangeField) result).setRegionType(((DateRangeField) source).getRegionType());
-                ((DateRangeField) result).setQuickOptions(((DateRangeField) source).getQuickOptions());
-            }
-            if (source instanceof DecimalField) {
-                ((DecimalField) result).setPrecision(((DecimalField) source).getPrecision());
-                ((DecimalField) result).setScale(((DecimalField) source).getScale());
-            }
-            if (source instanceof TextField) ((TextField) result).setMaxLength(((TextField) source).getMaxLength());
-        }
-        if (result == source || result == null) throw new IllegalArgumentException("REPORT_FILTER_SOURCE_CLONE_FAILED");
-        if (result instanceof AbstractBasedataField) {
-            AbstractBasedataField<?> basedata = (AbstractBasedataField<?>) result;
-            // Source form field IDs are not report field IDs. Keep this dependency explicit.
-            if (basedata.getOrgFieldId() != null && !basedata.getOrgFieldId().isEmpty()) {
-                throw new IllegalArgumentException("REPORT_FILTER_ORG_BINDING_REQUIRED: " + source.getKey());
-            }
-        }
-        result.setInherit(false);
-        result.setExt(false);
-        result.setFeatures(null);
-        result.setMustInputCondition(null);
-        if (result instanceof ComboField) ((ComboField) result).setChangeListeners(null);
-        return result;
-    }
-
-    private static <T> T copy(T value) {
-        if (value == null) return null;
-        try {
-            ByteArrayOutputStream bytes = new ByteArrayOutputStream();
-            try (ObjectOutputStream output = new ObjectOutputStream(bytes)) { output.writeObject(value); }
-            try (ObjectInputStream input = new ObjectInputStream(new ByteArrayInputStream(bytes.toByteArray()))) {
-                return (T) input.readObject();
-            }
-        } catch (Exception error) {
-            throw new IllegalArgumentException("REPORT_FILTER_OPTION_COPY_FAILED", error);
-        }
-    }
-
-    public static Map<String, Object> describe(Field<?> field) {
-        Map<String, Object> result = new LinkedHashMap<>();
-        result.put("fieldPath", field.getKey());
-        result.put("displayName", field.getName() == null ? "" : field.getName().toString());
-        result.put("fieldType", field.getClass().getSimpleName());
-        result.put("mustInput", field.isMustInput());
-        if (field instanceof AbstractBasedataField) {
-            AbstractBasedataField<?> basedata = (AbstractBasedataField<?>) field;
-            result.put("referenceEntityId", basedata.getBaseEntityId());
-            result.put("displayProp", basedata.getDisplayProp());
-            result.put("numberProp", basedata.getNumberProp());
-            result.put("editSearchProp", basedata.getEditSearchProp());
-            result.put("layoutId", basedata.getLayoutId());
-            result.put("displayStyle", basedata.getDisplayStyle());
-        }
-        if (field instanceof ComboField) {
-            List<Map<String, Object>> items = new ArrayList<>();
-            for (ComboItem item : ((ComboField) field).getItems()) {
-                Map<String, Object> option = new LinkedHashMap<>();
-                option.put("value", item.getValue());
-                option.put("caption", item.getCaption() == null ? "" : item.getCaption().toString());
-                items.add(option);
-            }
-            result.put("comboOptions", items);
-        }
-        if (field instanceof DateTimeField) result.put("timeZoneTransType", ((DateTimeField) field).getTimeZoneTransType());
-        if (field instanceof DateRangeField) result.put("timeZoneTransType", ((DateRangeField) field).getTimeZoneTransType());
-        if (field instanceof DecimalField) {
-            result.put("precision", ((DecimalField) field).getPrecision());
-            result.put("scale", ((DecimalField) field).getScale());
-        }
-        if (field instanceof TextField) result.put("maxLength", ((TextField)field).getMaxLength());
-        return result;
-    }
-
-    public static Map<String, Object> read(FormMetadata form, EntityMetadata entity, String panelId) {
-        List<Map<String, Object>> filters = new ArrayList<>();
-        for (ControlAp<?> control : form.getItems()) {
-            if (!(control instanceof FieldAp) || !panelId.equals(control.getParentId())) continue;
-            Field<?> field = entity.getFieldById(((FieldAp) control).getFieldId());
-            if (field == null) throw new IllegalArgumentException("REPORT_FILTER_FIELD_BINDING_MISSING: " + control.getKey());
-            filters.add(describe(field));
-        }
-        Map<String, Object> result = new LinkedHashMap<>();
-        result.put("schemaVersion", "app-build-typed-report-filters/v1");
-        result.put("reportFilters", filters);
-        return result;
-    }
-
-    public static List<Map<String, Object>> fields(EntityMetadata entity) {
-        List<Map<String, Object>> fields = new ArrayList<>();
-        for (kd.bos.metadata.entity.EntityItem<?> item : entity.getItems()) {
-            if (item instanceof Field) fields.add(describe((Field<?>) item));
-        }
-        return fields;
-    }
-}

package/skills/cosmic-build/assets/platform-report-filters/platform.patch

@@ -1,98 +0,0 @@
---- a/src/main/java/kd/bos/designer/property/setting/ReportPropertyService.java
-+++ b/src/main/java/kd/bos/designer/property/setting/ReportPropertyService.java
-@@ -705,6 +705,29 @@
-      */
-     @SuppressWarnings("unchecked")
-     public static PropertyResult setReportFilters(String formNumber, Map<String, Object> data) {
-+        return setReportFilters(formNumber, data, false);
-+    }
-+
-+    public static List<Map<String, Object>> readFieldSchemas(String formNumber) throws Exception {
-+        MetaPropertyService.MetaContext ctx = MetaPropertyService.loadMetaContext(formNumber, null);
-+        if (ctx == null || ctx.entityMetadata == null) throw new IllegalArgumentException("REPORT_FILTER_METADATA_UNAVAILABLE");
-+        return TypedReportFilterFields.fields(ctx.entityMetadata);
-+    }
-+
-+    /** Independent typed configuration read-back from persisted form/entity metadata. */
-+    public static Map<String, Object> readTypedReportFilters(String formNumber) throws Exception {
-+        MetaPropertyService.MetaContext ctx = MetaPropertyService.loadMetaContext(formNumber, null);
-+        if (ctx == null || ctx.entityMetadata == null) throw new IllegalArgumentException("REPORT_FILTER_METADATA_UNAVAILABLE");
-+        String panel = findControlIdByKey(ctx.formMetadata, "reportcommfilterpanelap");
-+        if (StringUtils.isBlank(panel)) throw new IllegalArgumentException("REPORT_FILTER_PANEL_NOT_FOUND");
-+        return TypedReportFilterFields.read(ctx.formMetadata, ctx.entityMetadata, panel);
-+    }
-+
-+    public static PropertyResult setTypedReportFilters(String formNumber, Map<String, Object> data) {
-+        return setReportFilters(formNumber, data, true);
-+    }
-+
-+    private static PropertyResult setReportFilters(String formNumber, Map<String, Object> data, boolean typed) {
-         return withFormMetadata(formNumber, "ReportFilters", (ctx, formMetadata) -> {
-             ReportFilterAp filterAp = findReportFilterAp(formMetadata);
-             if (filterAp == null) {
-@@ -717,6 +740,23 @@
-                         "ReportPropertyService_FLT_1", BOS_DESIGNER_AI);
-             }
-             List<Map<String, Object>> filters = (List<Map<String, Object>>) filtersObj;
-+            // Resolve every source and option before replacing any existing panel state.
-+            Map<String, Field<?>> typedFields = new LinkedHashMap<>();
-+            if (typed) {
-+                if (StringUtils.isBlank(findControlIdByKey(formMetadata, "reportcommfilterpanelap")))
-+                    return "REPORT_FILTER_PANEL_NOT_FOUND";
-+                for (Map<String, Object> filter : filters) {
-+                    if (!(filter.get("source") instanceof Map)) continue;
-+                    Map<String, Object> binding = (Map<String, Object>) filter.get("source");
-+                    MetaPropertyService.MetaContext source = MetaPropertyService.loadMetaContext(toStr(binding.get("formNumber")), null);
-+                    Field<?> field = source == null ? null : findEntityFieldByKey(source.entityMetadata, toStr(binding.get("fieldKey")));
-+                    typedFields.put(toStr(filter.get("fieldPath")), TypedReportFilterFields.create(field, toStr(filter.get("compare"))));
-+                }
-+                for (ControlAp<?> control : formMetadata.getItems()) {
-+                    if (typedFields.containsKey(control.getKey()) && !findControlIdByKey(formMetadata, "reportcommfilterpanelap").equals(control.getParentId()))
-+                        return "REPORT_FILTER_KEY_SHARED_OUTSIDE_PANEL: " + control.getKey();
-+                }
-+            }
-
-             // 面板级：显示字段列表。
-             // 必须序列化为 JSON 数组串（如 ["flt_a","flt_b"]）：运行时
-@@ -853,7 +893,15 @@
-                     // 强建新 Field 会造成实体层 key 重复，代价更大。
-                     Field<?> existing = findEntityFieldByKey(ctx.entityMetadata, fp);
-                     Field<?> field;
--                    if (existing != null) {
-+                    if (typedFields.containsKey(fp)) {
-+                        field = typedFields.get(fp);
-+                        if (existing != null) {
-+                            String existingId = existing.getId();
-+                            ctx.entityMetadata.getItems().remove(existing);
-+                            field.setId(existingId);
-+                        }
-+                        if (rootEntity != null) field.setIsv(rootEntity.getIsv());
-+                    } else if (existing != null) {
-                         field = existing;
-                         if ("13".equals(compare) && !(existing instanceof DateRangeField)) {
-                             warnLog("[setReportFilters] field [{}] compare=13(between) expects DateRangeField "
---- a/src/main/java/kd/bos/designer/property/setting/ComplexPropertyRouter.java
-+++ b/src/main/java/kd/bos/designer/property/setting/ComplexPropertyRouter.java
-@@ -413,6 +413,8 @@
-                     return ReportPropertyService.replaceReportColumns(formNumber, toMap(data));
-                 case "ReportFilters":
-                     return ReportPropertyService.setReportFilters(formNumber, toMap(data));
-+                case "ReportFilters.typed":
-+                    return ReportPropertyService.setTypedReportFilters(formNumber, toMap(data));
-                 case "ReportSorts":
-                     return ReportPropertyService.setReportSorts(formNumber, toMap(data));
-                 case "ReportPlugin":
---- a/src/main/java/kd/bos/designer/ai/webapi/AIMetaBuilder.java
-+++ b/src/main/java/kd/bos/designer/ai/webapi/AIMetaBuilder.java
-@@ -766,9 +766,11 @@
-                 if (formMeta != null && formMeta.getRootAp() != null) {
-                     String formNumber = formMeta.getRootAp().getKey();
-                     result.put("formNumber", formNumber);
-+                    result.put("fieldSchemas", kd.bos.designer.property.setting.ReportPropertyService.readFieldSchemas(formNumber));
-                     String rootType = formMeta.getRootAp().getClass().getSimpleName();
-                     if ("ReportFormAp".equals(rootType)) {
-                         result.put("modelType", "ReportFormModel");
-+                        result.put("reportFilterSchema", kd.bos.designer.property.setting.ReportPropertyService.readTypedReportFilters(formNumber));
-                     }
-                 }
-             } catch (Exception e) {

package/skills/cosmic-build/scripts/apply_report_filter_extension.py

@@ -1,39 +0,0 @@
-#!/usr/bin/env python3
-"""Apply the versioned typed report filter extension to an explicitly selected platform module."""
-import argparse
-import json
-import subprocess
-from pathlib import Path
-
-
-def main():
-    parser = argparse.ArgumentParser(description=__doc__)
-    parser.add_argument("--project-root", required=True)
-    parser.add_argument("--dry-run", action="store_true")
-    args = parser.parse_args()
-    project = Path(args.project_root).resolve()
-    asset = Path(__file__).resolve().parents[1] / "assets" / "platform-report-filters"
-    helper = project / "src" / "main" / "java" / "kd" / "bos" / "designer" / "property" / "setting" / "TypedReportFilterFields.java"
-    if helper.exists() and helper.read_bytes() != (asset / helper.name).read_bytes():
-        print(json.dumps({"status": False, "reason": "existing-helper-differs"})); return 2
-    repo = subprocess.run(["git", "rev-parse", "--show-toplevel"], cwd=project, capture_output=True, text=True, check=True).stdout.strip()
-    directory = project.relative_to(Path(repo).resolve()).as_posix()
-    command = ["git", "apply", "--ignore-whitespace", "--directory=" + directory, str(asset / "platform.patch")]
-    check = subprocess.run([*command[:2], "--check", *command[2:]], cwd=repo, capture_output=True, text=True)
-    if check.returncode:
-        reverse = subprocess.run([*command[:2], "--reverse", "--check", *command[2:]], cwd=repo, capture_output=True, text=True)
-        if reverse.returncode:
-            print(json.dumps({"status": False, "reason": "platform-source-version-mismatch", "diagnostics": check.stderr[-2000:]})); return 2
-        if not helper.exists() and not args.dry_run:
-            helper.write_bytes((asset / helper.name).read_bytes())
-        print(json.dumps({"status": True, "changed": False, "alreadyApplied": True, "dryRun": args.dry_run})); return 0
-    if not args.dry_run:
-        subprocess.run(command, cwd=repo, check=True)
-        helper.parent.mkdir(parents=True, exist_ok=True)
-        helper.write_bytes((asset / helper.name).read_bytes())
-    print(json.dumps({"status": True, "changed": not args.dry_run, "dryRun": args.dry_run, "projectRoot": str(project)}))
-    return 0
-
-
-if __name__ == "__main__":
-    raise SystemExit(main())