@shundoo-ai/dsh-cosmic 1.0.19 → 1.0.20

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shundoo-ai/dsh-cosmic",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "苍穹助手：金蝶云苍穹ERP的开发与数据分析，涵盖表单元数据建模、插件开发与热部署、数据可视化报告。",
   "keywords": [
     "dsh",

package/skills/cosmic-build/CHANGELOG.md

@@ -1,3 +1,7 @@
+2026-10-13 第三批 bfy11 真实故障验收完成：修复 POST 响应丢失后的自动重放、创建前读取异常的未知误判、批次汇总写入边界、成功回执残留错误及引用错误分类；修订指纹覆盖根 payload schema。现场只影响隔离测试请求，保留原业务对象。
+
+2026-10-12 第三批执行优化：绑定技能来源/修订与 Python 入口；结构化 stdout 与结果文件一致；批量逐对象保存回执、按验证回执续跑、只读核对未知写入、创建前核对冲突；同步中文执行资产。真实环境故障演练尚待验收。
+
 2026-09-03 支持元数据样式属性批量修改，完善规则写入、产物卡片与验证测试
 
 2026-08-27 优化了一些问题

package/skills/cosmic-build/LOCAL-PATCHES.md

@@ -9,10 +9,11 @@
 
 | 项 | 值 |
 |---|---|
-| 本次对齐的上游版本 | **0.0.299**（`builtin-skills/.builtin-version`），文件日期 2026-09-29 |
-| 上一次拷贝的快照 | 2026-08-24（早于 0.0.277） |
-| 可用参照基线（更早） | `~/.lingeebuild/config/builtin-skills/app-build`（**0.0.277**，2026-08-28） |
-| 上游目录布局 | `builtin-skills/app-build/`（英文 canonical）+ `builtin-skills/app-build/.locales/zh/`（中文覆盖层） |
+| 本次对齐的上游版本 | **0.0.326**（`builtin-skills/.builtin-version`），文件日期 2026-10-19（金蝶灵基 app **1.8.0**，build 2610172146，2026-10-17 安装） |
+| 上一次对齐 | **0.0.299**（2026-09-29） |
+| 更早的参照基线 | `~/.lingeebuild/config/builtin-skills/app-build`（**0.0.277**，2026-08-28，已过期） |
+| 上游解压位置（已变） | **`~/.lingeebuild/profiles/v1/<hash>/config/builtin-skills/app-build`** —— 灵基 1.8.0 起 skill 按 profile 隔离解压；旧的全局 `~/.lingeebuild/config/builtin-skills` 不再更新 |
+| 上游目录布局 | `app-build/`（英文 canonical）+ `app-build/.locales/zh/`（中文覆盖层） |
 | 本 preset 布局 | 单树：`skills/cosmic-build/`（= 上游 zh 覆盖层拍平，无 `.locales/`） |
 
 上游会把旧的 R/D/E 管线、`capabilities/`、`cosmic-{requirements,design,executor,testing,code-review}`、
@@ -31,46 +32,50 @@
 | `schemas/*` | ⚠️ **canonical** | `property-contract-fixture.schema.json` 只在 canonical |
 | `contracts/*` | zh 优先；缺则 canonical | `property-input-index.json`、`property-value-encoding.json`、`operation-rule-write-contracts.json` 只在 canonical，且**被 `cmd_properties.py` 运行时读取** |
 
-### 1.1 必须用 canonical 覆盖的 33 个 `.py`
+### 1.1 必须用 canonical 覆盖的 `.py`（**2026-10-19 对 0.0.326 重算：35 个**）
 
-判定方法：剥掉 docstring 与全部字符串常量后比对 AST，仍有差异者为"代码级滞后"。
-其中 **16 个与替换前的 DSH 旧版逐字节相同**（= zh 根本没更新，拷了等于没升级）：
+判定方法：剥掉 docstring 与全部字符串常量后比对 AST，仍有差异者为"代码级滞后"。每次上游更新都**重算**，不要照搬旧名单。
 
 ```
-脚本/测试（16 个 zh==旧DSH）:
-  scripts/discovery_snapshot.py          ← 坏档：仍 import 已删的 _shared.property_names
-  scripts/meta_export.py
-  scripts/test/test_appconfig_load.py
-  scripts/test/test_build_meta_order.py
-  scripts/test/test_http_client.py
-  scripts/test/test_kd_token_cache.py
-  scripts/test/test_run.py
-  scripts/test/test_runtime_tool_opt_in.py
-  skills/cosmic-meta-api/modules/pdm/scripts/pdm_auto.py
-  skills/cosmic-meta-api/scripts/_core/markdown.py
-  skills/cosmic-meta-api/scripts/test/test_field_decorator.py
-  skills/cosmic-meta-api/scripts/test/test_formatters_output_isolation.py
-  skills/cosmic-meta-modeling/scripts/post_build_ui.py
-  skills/openapi-gen/scripts/api/constants.py
-  skills/openapi-gen/scripts/metadata/fetcher.py
-  skills/openapi-gen/scripts/metadata/parser.py
-
-三者各不同（14 个，zh ≠ canonical ≠ 旧DSH）:
-  scripts/run.py                          ← 注意：本补丁 #1 的落点
-  scripts/test/test_kd_auth.py
-  scripts/test/test_register_plugins.py
-  skills/cosmic-meta-api/scripts/_core/{config,cmd_properties,cmd_forms,cmd_metaops,cmd_workspace,formatters}.py
-  skills/cosmic-meta-api/scripts/meta_verifier.py
-  skills/cosmic-meta-api/scripts/test/test_form_extension_flow.py
-  skills/cosmic-meta-modeling/scripts/{artifact_validator,dynamic_form_validator}.py
-  skills/openapi-gen/scripts/api/gen_runner.py
-
-DSH 无、新版新增（3 个）:
-  scripts/test/test_bootstrap_cosmic_context.py
-  skills/cosmic-meta-api/scripts/test/test_add_button_closure.py
-  skills/cosmic-meta-api/scripts/test/test_existing_form_ui.py
+scripts/run.py                              ← 补丁 #1 落点
+scripts/discovery_snapshot.py               ← zh 坏档（仍 import 已删的 _shared.property_names）
+scripts/meta_export.py
+scripts/test/test_appconfig_load.py
+scripts/test/test_build_meta_order.py
+scripts/test/test_guide_skeleton_contract.py
+scripts/test/test_kd_auth.py
+scripts/test/test_kd_token_cache.py
+scripts/test/test_modeling_input_recovery.py
+scripts/test/test_register_plugins.py
+scripts/test/test_report_business_contract.py
+scripts/test/test_report_doc_contract_sync.py
+scripts/test/test_run.py
+scripts/test/test_runtime_tool_opt_in.py
+scripts/test/test_batch5_drift_governance.py
+skills/cosmic-meta-api/modules/pdm/scripts/pdm_auto.py
+skills/cosmic-meta-api/scripts/_core/cmd_forms.py
+skills/cosmic-meta-api/scripts/_core/cmd_plugins.py
+skills/cosmic-meta-api/scripts/_core/cmd_properties.py
+skills/cosmic-meta-api/scripts/_core/cmd_workspace.py
+skills/cosmic-meta-api/scripts/_core/config.py
+skills/cosmic-meta-api/scripts/_core/markdown.py
+skills/cosmic-meta-api/scripts/meta_verifier.py
+skills/cosmic-meta-api/scripts/test/test_add_button_closure.py
+skills/cosmic-meta-api/scripts/test/test_field_decorator.py
+skills/cosmic-meta-api/scripts/test/test_form_extension_flow.py
+skills/cosmic-meta-api/scripts/test/test_formatters_output_isolation.py
+skills/cosmic-meta-api/scripts/test/test_rule_write_closure.py
+skills/cosmic-meta-modeling/scripts/artifact_validator.py
+skills/cosmic-meta-modeling/scripts/dynamic_form_validator.py
+skills/cosmic-meta-modeling/scripts/post_build_ui.py
+skills/openapi-gen/scripts/api/constants.py
+skills/openapi-gen/scripts/api/gen_runner.py
+skills/openapi-gen/scripts/metadata/fetcher.py
+skills/openapi-gen/scripts/metadata/parser.py
 ```
 
+另加 **`skills/cosmic-meta-api/scripts/cosmic_api.py`**（zh 与 canonical 仅字节级 drift，AST 比不出；§1.2 仍要求取 canonical）。
+
 ### 1.2 不要照抄的东西
 
 - `.locales/zh/scripts/discovery_snapshot.py` —— 上游 zh 的坏档，用 canonical 版。
@@ -161,7 +166,7 @@ rsync -a --ignore-existing --exclude '.locales/' "$SRC/." "$DST/"
 # 4) 重贴 §2 的 17 处补丁（先 config.py，再凭据三件套）
 
 # 5) 机械适配
-#    a. {APP_BUILD_ROOT} → {ROOT_DIR}（md 与 py 中花括号 token 形态；
+#    a. {ROOT_DIR} → {ROOT_DIR}（md 与 py 中花括号 token 形态；
 #       注意 py 里还有同名 Python 变量，不要一起改）
 #    b. md 链接标签里的 .locales/zh/ 前缀去掉
 #    c. 确认根 SKILL.md 里 {ROOT_DIR} 与 {python} 的绑定说明仍在
@@ -232,6 +237,37 @@ cd <工作区> && $PY $D/skills/cosmic-meta-api/scripts/cosmic_api.py --stdout q
 `queryForms` 冒烟 `[auth] OK` 且命中 16 条表单、`describeCommand` 返回 15.5KB 契约、
 markdown 断链 60 条（与上游 KD zh 完全一致，无新增）。
 
+**2026-10-19（0.0.326）同步结果**：补丁 11/11 检查点通过、`_API_PATH` 105 项（含 13 项本地补丁）、
+命令 **204** 个（197 上游 + 7 KSQL）、compileall 退出码 0、`queryForms` 冒烟 `[auth] OK`、
+`exportKSQLByTable` 实调成功（返回 `scriptBase64`）、根 `SKILL.md` 断链 0。
+
+---
+
+## 5.1 2026-10-19 同步记录（0.0.299 → 0.0.326）
+
+| 步骤 | 实际执行 |
+|---|---|
+| 备份 | `cp -a` → `/tmp/cosmic-build.bak-2026-10-19`（57M） |
+| 清理 | 删 `skills/cosmic-meta-api/scripts/.dsh/cosmic/.kd/config.json`（**杂散凭据副本，曾入库——见下**）与上游孤儿 `scripts/test/test_bd_bindings.py` |
+| 步骤1 | rsync `zh` 覆盖层 `--delete`，exclude：`erpdb/`、`skills/cosmic-vibe-coding/`、`skills/config.json`、`skills/tenant.json`、entity-download 工具链 3 文件、**`LOCAL-PATCHES.md`（新增）**、**`skills/cosmic-coding-script/references/sdk/manifests/`（新增）** |
+| 步骤2 | rsync canonical `--ignore-existing --exclude .locales/` 补齐 |
+| 步骤3 | canonical 覆盖 **36** 个 `.py`（§1.1 重算 35 + `cosmic_api.py`）；覆盖后 `.py` 与 canonical **AST 差异 0** |
+| 步骤4 | 重贴 17 处补丁。**注意 #14 有两部分**：`_core/config.py` 的 `_API_PATH` + `cosmic_api.py` 的 **7 个 argparse 子命令与 dispatch**（新版 `cosmic_api.py` 取 canonical 后这两块全丢，必须都补） |
+| 步骤5 | a) `{APP_BUILD_ROOT}` → `{ROOT_DIR}`：md **72** 处 + py **6** 处（py 里 88 个同名 **Python 变量不动**）；b) md 里 `.locales/zh/` 前缀清理 6 个文件（`LOCAL-PATCHES.md` 自身保留） |
+
+**上游 0.0.326 的新东西（未拷贝的单列）**：新增兄弟技能 `cosmic-e2e-test` / `expert-team-build` /
+`mcp-apps-builder` / `task-builder` / `yzj-cli` —— **不拷**；`app-build` 仅在
+`scripts/verify_plugin_loading.py` 的 `--runtime-trace` help 里提到 `cosmic-e2e-test`（可选输入，无硬依赖）。
+
+**新增命令（已在 204 个内）**：`renameElementKey`、`ensureConditionalFieldChange`、
+`ensureTimeDifferenceCalculation`、`configureDropdownMenu`。
+
+**待办**：`skills/cosmic-coding-script/references/sdk/manifests/` 是本地生成物（0.0.326 未带产物，
+但带了生成脚本 `scripts/kingscript_sdk_sync.py`）—— 若上游文档改为引用新字段，需重跑该脚本刷新。
+
+> ⚠️ **安全**：`skills/cosmic-meta-api/scripts/.dsh/cosmic/.kd/config.json` 含明文凭据且**曾在 git 历史里**。
+> 已从工作树删除；如果该仓库会外发，建议清理历史并轮换对应密钥。
+
 ---
 
 ## 6. 已知遗留（不影响运行）

package/skills/cosmic-build/SKILL.md

@@ -8,6 +8,18 @@ description: 创建或修改金蝶云苍穹表单、字段、规则、操作、
 通过已发布的 CLI 交付用户要求的苍穹应用修改。选择下方最具体的入口，
 只加载当前问题需要的内容，并保留全部明确业务要求。
 
+表单及其当前设计保存在苍穹服务端。`appRoot` 是本地应用绑定和导出产物的目录，
+不是线上表单清单。修改已有表单时，读取下方对应领域入口，将已提供的 `appRoot`
+和用户使用的表单名称直接传给命令。本地文件或 archive 中没有记录，不证明线上表单不存在。
+
+`{ROOT_DIR}` 是本入口附带的技能包目录（本地补丁：上游 0.0.326 用 `APP_BUILD_ROOT` 这一同名 token，本 preset 统一为 `{ROOT_DIR}`；历史文本中的 `APP_BUILD_ROOT` 与本变量同义）。选定命令的参数尚不明确时，读取其本地契约：
+
+```text
+{python} {ROOT_DIR}/skills/cosmic-meta-api/scripts/cosmic_api.py --stdout describeCommand <已选命令>
+```
+
+返回的 schema 说明命令输入；目标查询由领域命令完成，不通过搜索应用目录完成。
+
 创建入口负责契约支持的初始状态，未覆盖属性或布局交给对应入口。写命令自行解析准确表单目标；
 只有用户要求发现，或没有表单目标时才进入发现入口。
 
@@ -15,48 +27,69 @@ description: 创建或修改金蝶云苍穹表单、字段、规则、操作、
 
 | 当前请求 | 入口 |
 |---|---|
+| 修改下拉菜单项，包括显示名称、说明及顺序 | [skills/cosmic-meta-ui/SKILL.md](skills/cosmic-meta-ui/SKILL.md)：`configureDropdownMenu` 根据菜单项或明确按钮定位菜单，保留绑定的操作定义 |
 | 查找表单或确认所属应用 | [references/form-discovery.md](references/form-discovery.md) |
+| 查询或新建功能分组（BizUnit），包括新建表单明确要求的分组；功能分组不是应用菜单 | [skills/cosmic-meta-modifier/modules/unit/SKILL.md](skills/cosmic-meta-modifier/modules/unit/SKILL.md) |
+| 将表单移动到其他功能分组（不是应用菜单） | [skills/cosmic-meta-modifier/SKILL.md](skills/cosmic-meta-modifier/SKILL.md) |
 | 创建表单、实体、基础资料或应用菜单（不是功能分组） | [skills/cosmic-meta-modeling/SKILL.md](skills/cosmic-meta-modeling/SKILL.md) |
 | 新增/删除字段或分录；继承、复制、扩展或移动已有表单 | [skills/cosmic-meta-modifier/SKILL.md](skills/cosmic-meta-modifier/SKILL.md) |
-| 修改字段属性、必填、默认值、拆分表或页签操作 | [skills/cosmic-meta-modifier/modules/property/SKILL.md](skills/cosmic-meta-modifier/modules/property/SKILL.md) |
+| 修改字段/控件/分录标识或属性、必填、默认值、拆分表或页签操作 | [skills/cosmic-meta-modifier/modules/property/SKILL.md](skills/cosmic-meta-modifier/modules/property/SKILL.md) |
 | 配置计算或条件字段行为 | [skills/cosmic-meta-modifier/modules/rule/SKILL.md](skills/cosmic-meta-modifier/modules/rule/SKILL.md) |
 | 配置保存、提交或其他操作校验 | [skills/cosmic-meta-modifier/modules/operation/SKILL.md](skills/cosmic-meta-modifier/modules/operation/SKILL.md) |
 | 新增可见控件或面板；修改布局、位置或容器外观 | [skills/cosmic-meta-ui/SKILL.md](skills/cosmic-meta-ui/SKILL.md)；明确交互的操作先使用操作入口 |
-| 修改列表列、搜索、过滤或排序 | [skills/cosmic-meta-modifier/references/list-filter-modification.md](skills/cosmic-meta-modifier/references/list-filter-modification.md) |
-| 修改报表、插件、脚本或其他已有元数据 | [skills/cosmic-meta-modifier/SKILL.md](skills/cosmic-meta-modifier/SKILL.md) |
+| 配置列表视图的列、搜索字段、过滤条件或排序 | [skills/cosmic-meta-modifier/references/list-filter-modification.md](skills/cosmic-meta-modifier/references/list-filter-modification.md) |
+| 修改报表元数据、插件注册、元数据脚本或其他已有元数据 | [skills/cosmic-meta-modifier/SKILL.md](skills/cosmic-meta-modifier/SKILL.md) |
 | 查看、比较或还原元数据版本 | [skills/cosmic-meta-api/apis/meta_log.md](skills/cosmic-meta-api/apis/meta_log.md) |
-| 交付元数据无法表达的后端行为 | [references/java-plugin-delivery.md](references/java-plugin-delivery.md) |
+| 编写或修改 Java 插件源码，包括元数据无法表达的后端行为 | [references/java-plugin-delivery.md](references/java-plugin-delivery.md) |
 | 将已有操作发布为 OpenAPI | [skills/openapi-gen/SKILL.md](skills/openapi-gen/SKILL.md) |
+| 注册、查询或管理 MCP 服务（open_mcp_ext） | [skills/mcp-server/SKILL.md](skills/mcp-server/SKILL.md) |
 
 自定义苍穹前端页面使用 kd-frontend-development；非苍穹应用使用对应的
 standalone 或 site 技能。
 
 ## 共享约束
 
-- `{ROOT_DIR}` 是本 `SKILL.md` 所在目录（技能包根）；下文所有脚本、参考与子技能路径都相对
-  它解析。历史文本中的 `APP_BUILD_ROOT` 与本变量同义。
-- `{python}` 在本 preset 中固定为苍穹专用运行时，与工作区 `AGENTS.md` 的
-  「Python 运行时（统一约定）」一致：macOS/Linux `$DSH_HOME/cache/cosmic/venv/bin/python`，
-  Windows `$DSH_HOME/cache/cosmic/venv/Scripts/python.exe`。
-  首次执行 Python CLI 前只绑定一次 `{python}`：候选命令必须通过
+- 首次执行 Python CLI 前只绑定一次 `{python}`：Windows 依次探测 `python`、`py -3`、
+  `python3`，macOS/Linux 依次探测 `python3`、`python`。候选命令必须通过
   `-c "print('APP_BUILD_PYTHON_OK')"`，退出成功且准确输出该标记；本轮持续复用该命令。
   空输出或探测失败属于运行环境故障，不能解释成“应用不存在”等业务结果。
 - 新建表单前，目标应用必须来自用户选择或宿主明确选中的应用。项目目录、本地应用清单和
   archive 不代表用户选择；缺少两者时先询问“要建在哪个应用下？”并等待，再读取应用文件或准备新建输入。
 - 保持用户范围。字段名称不隐含必填、布局、样式、规则或菜单发布。
 - 只有用户明确要求发布到菜单或修改菜单时才配置应用菜单；其他表单修改不隐含菜单新建或发布。
+- 明确要求发布菜单后，交付前按菜单入口核对并启用同一个已验证应用。
 - 使用已验证的应用和表单身份。需要绑定、处理归属冲突或路径语义时，读取
   [references/application-context.md](references/application-context.md)。
 - CLI 回执、写入验证、未知状态、删除和本地运行状态遵循
   [references/execution-contract.md](references/execution-contract.md)。
 - 只有所选元数据入口无法表达剩余行为时才进入 Java。
-- 只有用户明确要求运行态验收，并点名可用工具或集成时才调用外部运行工具。
+- 用户要求运行态验证，或诊断/修复运行报错时调用外部运行工具；优先使用可用的 `agent_browser`。
 - 只询问会实质改变业务结果的决定。
 
+## 保持执行路线连续
+
+先按选定入口实施。prepare 给出的完成输入路径是实施后要创建的文件，开始时不存在是正常状态。`TEST_ENVIRONMENT_HANDOFF` 由写入后的原生收口器生成，不在实施前到其他任务或工作树中寻找。
+
+消费已绑定的需求/前阶段产物一次，按“结构、静态属性、规则、操作校验、无法用元数据表达的行为”整理尚未完成的效果。选择每个效果的最小已发布 writer，输入完整时直接执行；仅加载命中的专题，独立读取可并行。同一表单的规则用已发布批量命令，属性批量保持其原生契约，避免逐项重新发现身份。
+
+复用 writer 返回的准确身份和验证回执；成功写入后不再查询无关候选、不重读同一说明、不为交付重做验证。参数错误按返回的准确形状修复；类型/能力边界错误直接切换该行为所属路线，避免在多个命令间摇摆。回执只证明它实际检查的内容：逐行必填不等于最少行数，设计态规则保存不等于浏览器运行通过。有运行验证请求时使用可用的 `agent_browser`；一次打开表单与检查默认值属于该行为的冒烟验证，不能冒充范围外测试阶段。
+
 ## 完成条件
 
-全部表单修改完成后，按 [references/delivery.md](references/delivery.md) 完成本轮交付。该文档统一
-负责目标分组、单次卡片收口、`deleteForm` 处理、`output_check` 和卡片输出。
+沿需求基线继续实施时，使用当前确认要求、用户约束和范围变更；建议不升级为必测承诺，已取消
+条件不沿用。现有基线交接见[应用上下文](references/application-context.md)，选择 Java 前先核对
+受影响的能力事实与约束冲突。
+
+会话进度和最终答复用用户熟悉的业务名称，先说明完成了什么、实际检查结果及具体未完成项。
+表单编码、字段键、状态字母、布尔标记、回执字段、命令和哈希保留在技术产物中，不逐次播报工具、定位、重试、同步和阶段收口。
+遇到问题说明业务影响和下一步；用户明确要求技术诊断时再补必要的准确细节。
+工具参数、交接文件及渲染卡片的协议字段仍严格按原格式保存和调用。
+
+按用户要求的范围说明已完成的修改、检查结果和未验证项。
+配置回读只能确认配置写入结果，不能证明业务在运行环境中正常工作。
+
+全部要求的实现完成后，按 [references/delivery.md](references/delivery.md) 处理交付。该文档统一
+负责实现完成核对、目标分组、单次卡片收口、`deleteForm` 处理、`output_check`，以及在约定终点输出卡片。
 
 所有明确要求都有验证证据或明确未完成边界，且不存在写后未知状态时任务完成。
 已验证无变化时可以直接说明现状，不重复写入。仍可执行的实现工作不属于“未完成边界”；

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

@@ -0,0 +1,169 @@
+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

@@ -0,0 +1,98 @@
+--- 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/assets/report-algo-benchmark/ReportAlgoBenchmark.java

@@ -0,0 +1,48 @@
+import kd.bos.algo.*;
+import java.util.*;
+import java.util.concurrent.*;
+
+public class ReportAlgoBenchmark {
+    static Map<String, String> read(DataSet data) {
+        Map<String, String> result=new TreeMap<>();
+        while(data.hasNext()) { Row row=data.next();result.put(row.getString("supplier"),row.getDate("first_date").getTime()+":"+row.getDate("last_date").getTime()); }
+        data.close();return result;
+    }
+    static Map<String, String> baseline(DataSet data) {
+        Map<String, String> result=new TreeMap<>();
+        for(DataSet group:data.splitByGroup(new String[]{"supplier"})) {
+            DataSet first=group.copy().topBy(1,new String[]{"bill_date asc"});
+            DataSet last=group.topBy(1,new String[]{"bill_date desc"});
+            if(!first.hasNext() || !last.hasNext()) throw new AssertionError("empty group");
+            Row firstRow=first.next();String key=firstRow.getString("supplier");long start=firstRow.getDate("bill_date").getTime();
+            long end=last.next().getDate("bill_date").getTime();result.put(key,start+":"+end);first.close();last.close();
+        }
+        return result;
+    }
+    static void run(int rows, int groups, int iterations) {
+        List<Object[]> input=new ArrayList<>();Map<String,String> expected=new TreeMap<>();
+        for(int i=0;i<rows;i++) input.add(new Object[]{"S"+(i%groups),new Date(i*1000L)});
+        for(int i=0;i<groups;i++) expected.put("S"+i,(i*1000L)+":"+((i+((rows-1-i)/groups)*groups)*1000L));
+        RowMeta meta=new RowMeta(new Field("supplier",DataType.StringType),new Field("bill_date",DataType.DateType));
+        Algo algo=Algo.create("report-benchmark");
+        List<Long> oldTimes=new ArrayList<>(),newTimes=new ArrayList<>();
+        for(int i=-1;i<iterations;i++) {
+            long start=System.nanoTime();Map<String,String> old=baseline(algo.createDataSet(input,meta));long oldTime=System.nanoTime()-start;
+            start=System.nanoTime();Map<String,String> optimized=read(CosmicReportAggregation.dateBounds(algo.createDataSet(input,meta)));long newTime=System.nanoTime()-start;
+            if(!expected.equals(old) || !expected.equals(optimized)) throw new AssertionError("business result differs");
+            if(i>=0) { oldTimes.add(oldTime);newTimes.add(newTime); }
+        }
+        Collections.sort(oldTimes);Collections.sort(newTimes);
+        int p95=(int)Math.ceil(iterations*.95)-1;
+        System.out.println("{\"rows\":"+rows+",\"groups\":"+groups+",\"iterations\":"+iterations+",\"resultsEqual\":true,\"baselineP50Ms\":"+oldTimes.get(iterations/2)/1e6+",\"baselineP95Ms\":"+oldTimes.get(p95)/1e6+",\"optimizedP50Ms\":"+newTimes.get(iterations/2)/1e6+",\"optimizedP95Ms\":"+newTimes.get(p95)/1e6+",\"databaseQueries\":0}");
+    }
+    public static void main(String[] args) throws Exception {
+        ExecutorService executor=kd.bos.threads.ThreadPools.newExecutorService("report-benchmark",1);
+        java.util.concurrent.atomic.AtomicBoolean completed=new java.util.concurrent.atomic.AtomicBoolean();
+        try {
+            executor.submit(()->{try(AlgoContext context=Algo.newContext()) {run(Integer.parseInt(args[0]),Integer.parseInt(args[1]),Integer.parseInt(args[2]));completed.set(true);}}).get(60,TimeUnit.SECONDS);
+            if(!completed.get()) throw new AssertionError("managed task did not run");
+            executor.shutdownNow();System.exit(0);
+        } catch(Exception error) { error.printStackTrace();System.exit(2); }
+    }
+}

package/skills/cosmic-build/assets/report-algo-benchmark/ReportBenchmarkLogFactory.java

@@ -0,0 +1,7 @@
+/** Isolates application logging/configuration only; computation uses the actual target SDK. */
+public class ReportBenchmarkLogFactory extends kd.bos.logging.LogFactory {
+    protected kd.bos.logging.Log _getLog(String name) {
+        return (kd.bos.logging.Log) java.lang.reflect.Proxy.newProxyInstance(kd.bos.logging.Log.class.getClassLoader(),
+            new Class[]{kd.bos.logging.Log.class}, (proxy, method, args) -> method.getReturnType()==boolean.class ? false : null);
+    }
+}

package/skills/cosmic-build/examples/java-rules/CosmicEntryQuery.java

@@ -0,0 +1,26 @@
+import java.util.Arrays;
+import java.util.stream.Collectors;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.dataentity.entity.DynamicObjectCollection;
+import kd.bos.orm.query.QFilter;
+import kd.bos.servicehelper.BusinessDataServiceHelper;
+import kd.bos.servicehelper.QueryServiceHelper;
+
+/** Compile-checked against the 8.0 SDK. Runtime identities and results need target validation. */
+public final class CosmicEntryQuery {
+    private CosmicEntryQuery() {}
+
+    /** Query the verified form root; the result is flat and must not be saved. */
+    public static DynamicObjectCollection queryHeaderIds(String formNumber, QFilter[] filters) {
+        return QueryServiceHelper.query(formNumber, "id", filters);
+    }
+
+    /** Load a structured object by its queried header ID, then read its collection property. */
+    public static DynamicObjectCollection loadEntries(Object headerId, String formNumber,
+            String collectionProperty, String... entryFields) {
+        String selectFields = "id," + Arrays.stream(entryFields)
+            .map(field -> collectionProperty + "." + field).collect(Collectors.joining(","));
+        DynamicObject header = BusinessDataServiceHelper.loadSingle(headerId, formNumber, selectFields);
+        return header == null ? null : header.getDynamicObjectCollection(collectionProperty);
+    }
+}