@shundoo-ai/dsh-cosmic 1.0.18 → 1.0.20

package/cordis.patch.yml

@@ -33,11 +33,13 @@
           # ── identity ────────────────────────────────────────────────────────────────
 
           # The preset's own persona, shadowing the deployment default for this agent.
-          # `{{model}}` and `{{cwd}}` resolve from the agent's own route and workspace.
+          # Only `{{model}}` is a registered prompt variable (dsh 0.2.1 registers exactly
+          # `provider` and `model`); `{{cwd}}` was REMOVED upstream — an unregistered name
+          # fails the whole turn with `unknown prompt variable`, so do not reintroduce it.
+          # The working directory still reaches the model through the runtime context.
           - id: persona
             name: '@deepseek-ai/dsh-persona'
             config:
-              suffix: Your working directory is {{cwd}}.
               prefix: >-
                 You are 苍穹助手 (Cosmic Assistant), the 金蝶云星空 (Kingdee Cloud Cosmic) 开发与数据分析 agent, powered by the {{model}} model. Two capabilities: (1) 苍穹开发 — build and modify 苍穹 apps, menus, forms, entities, fields, plugins, APIs, workflows, and scheduling; follow the cosmic-dev-best-practices and app-build skills for that work. (2) 数据分析 — answer business-data questions through the 苍穹 OpenAPI, analyze with Python (pandas/plotly), and deliver markdown tables in chat plus interactive HTML reports; load the erp-analysis skill before any data query (its SKILL.md is the authority for the workflow and report format). Match the user's intent to the right capability and load the appropriate skill.
 
@@ -46,6 +48,10 @@
             config:
               maxBytes: 65536
 
+          # Current time context (official standard row): lets the model see the clock.
+          - id: time-context
+            name: '@deepseek-ai/dsh-time-context'
+
           # ── shell ───────────────────────────────────────────────────────────────────
 
           # `shell-env` stays in the HOST composition: `apps/cli/src/web.ts` injects it to
@@ -87,6 +93,10 @@
           - id: tool-jobs
             name: '@deepseek-ai/dsh-tool-jobs'
 
+          # Scheduling (official standard row): the model-facing schedule tool.
+          - id: tool-schedule
+            name: '@deepseek-ai/dsh-tool-schedule'
+
           # ── skills ──────────────────────────────────────────────────────────────────
 
           # The skill REGISTRY lives in the host composition and is layered per scope:
@@ -128,7 +138,7 @@
                 name: '@deepseek-ai/dsh-plan-mode'
                 config:
                   section: |
-                        You are in plan mode. Stay in plan mode until exit_plan_mode succeeds or the user switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
+                        You are in plan mode. Stay in plan mode until the user approves your plan through exit_plan_mode or switches the session mode. Imperative language to implement changes means plan the implementation, not execute it. A user's conversational agreement — including an answer confirming something you asked — approves nothing and does not end plan mode; fold the confirmed decision into the plan and submit it through exit_plan_mode.
 
                         Explore first. Use non-mutating reads, searches, static analysis, and checks to ground the plan in the actual repository. Do not edit or write files, change configuration, run formatters or code generation that rewrites tracked files, commit, or otherwise carry out the plan. Prefer existing functions and patterns over new machinery.
 
@@ -200,40 +210,16 @@
                   provider: spawn
                   toolName: subagent
                   modelSelectionSettings: true
-                  backgroundMode: continuable
 
               # Fork omits model selection so provider/model stay equal to the parent and
-              # the inherited history remains eligible for KV Cache reuse. This preset
-              # keeps fork continuable; parent and child inherit the same messaging tool,
-              # while the parent id and return guidance follow the inherited history.
+              # the inherited history remains eligible for KV Cache reuse. Parent and child
+              # inherit the same messaging tool, while the parent id and return guidance
+              # follow the inherited history.
               - id: tool-subagent-fork
                 name: '@deepseek-ai/dsh-tool-subagent'
                 config:
                   provider: fork
                   toolName: subagent_fork
-                  backgroundMode: continuable
-
-              # Production dsh does not install these optional providers. Install the
-              # matching Bundle in this Profile and restart the Host, then copy this
-              # preset and remove `disabled` from the matching tool row. Host availability
-              # alone grants no tool.
-              - id: tool-subagent-codex
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: codex
-                  toolName: subagent_codex
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
-
-              - id: tool-subagent-claude-code
-                name: '@deepseek-ai/dsh-tool-subagent'
-                disabled: true
-                config:
-                  provider: claude-code
-                  toolName: subagent_claude_code
-                  backgroundMode: one-shot
-                  maxDepth: provider-managed
 
               - id: workflow-ptc
                 name: '@deepseek-ai/dsh-workflow-ptc'
@@ -243,19 +229,6 @@
               - id: tool-workflow
                 name: '@deepseek-ai/dsh-tool-workflow'
 
-              # Off by default with the base row it mirrors: the tool description
-              # restricts `ralph` to runs the human explicitly asked for, and completion
-              # is a worker self-report, not an independent evaluation. Preset files take
-              # no patches, so a session that wants it duplicates this preset under a new
-              # id and drops `disabled`; the shipped root shadows a copy that reuses this
-              # id.
-              - id: tool-ralph
-                name: '@deepseek-ai/dsh-tool-ralph'
-                disabled: true
-                config:
-                  subagentProvider: spawn
-                  maxRounds: 64
-
           # ── remaining model-facing rows ─────────────────────────────────────────────
 
           - id: tool-ask-user
@@ -280,3 +253,8 @@
           - id: tool-plugin-manager
             name: '@deepseek-ai/dsh-plugin-manager/tools'
             disabled: true
+
+          # Plugin market (official standard row). Off by default, like the row above.
+          - id: tool-plugin-market
+            name: '@deepseek-ai/dsh-plugin-market/tools'
+            disabled: true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shundoo-ai/dsh-cosmic",
-  "version": "1.0.18",
+  "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;
+    }
+}