kcode-pi 0.1.0

package/vendor/kingdee-skills/ok-cosmic/rules/decision-matrix.md

@@ -0,0 +1,222 @@
+# 完整统一决策矩阵
+
+从 [SKILL.md](../SKILL.md) 的精简索引命中场景后，只读对应 **1 个主场景卡片** 和 **0-1 个能力卡片**；不要整文通读。
+
+如果用户原话还是业务描述、还没翻译成“操作插件 / 表单插件 / 基础资料能力”等技术场景，先读 [intent-routing.md](intent-routing.md) 做语义翻译。
+
+> **提示**：`入口类` 主要用于缩小 `cosmic-api-knowledge.py` 的搜索范围，不代表必须直接依赖原生 API；`封装文档` 和 `原生文档` 都应先读 `TL;DR`，确实需要时再展开全文。
+
+---
+
+## 插件类
+
+### 表单插件 {#form-plugin}
+- **关键词**: 表单 UI / 字段联动 / 控件交互
+- **入口类**: `AbstractFormPluginExt` · `kd.bos.form.plugin.*` · `kd.bos.form` / `kd.bos.form.control`
+- **先读**: [plugin-base.md](../references/adv/plugin-base.md) · [form-utils.md](../references/adv/form-utils.md)
+- **兜底**: [plugin-form.md](../references/base/plugin/plugin-form.md)
+- **模板**: [FormPluginTemplate.java](../assets/FormPluginTemplate.java)
+- **片段**: [ViewControlOpsSample](../assets/snippets/form/ViewControlOpsSample.java) · [F7FilterSample](../assets/snippets/form/F7FilterSample.java)
+
+### 单据插件 {#bill-plugin}
+- **关键词**: 单据 UI / 审核提交按钮
+- **入口类**: `AbstractBillPlugInExt` · `kd.bos.form.plugin.*`
+- **先读**: [plugin-base.md](../references/adv/plugin-base.md) · [form-utils.md](../references/adv/form-utils.md)
+- **兜底**: [plugin-bill.md](../references/base/plugin/plugin-bill.md)
+- **模板**: [BillPlugInTemplate.java](../assets/BillPlugInTemplate.java)
+- **片段**: [OpenBillModalSample](../assets/snippets/form/OpenBillModalSample.java)
+
+### 列表插件 {#list-plugin}
+- **关键词**: 列表 / 多选操作 / 批量
+- **入口类**: `AbstractListPluginExt` · `AbstractListPlugin` · `kd.bos.list`
+- **先读**: [plugin-base.md](../references/adv/plugin-base.md)
+- **兜底**: [plugin-list.md](../references/base/plugin/plugin-list.md)
+- **模板**: [ListPluginTemplate.java](../assets/ListPluginTemplate.java)
+- **片段**: [ListPluginBasicSample](../assets/snippets/list/ListPluginBasicSample.java)
+
+### 树列表插件 {#tree-plugins}
+- **关键词**: 左树右表（单据 / 基础资料）
+- **入口类**: `AbstractTreeListPlugin` · `kd.bos.list`
+- **先读**: [plugin-base.md](../references/adv/plugin-base.md)
+- **兜底**: [plugin-tree-list.md](../references/base/plugin/plugin-tree-list.md)
+- **模板（单据）**: [TreeListPluginTemplate.java](../assets/TreeListPluginTemplate.java)
+- **模板（基础资料）**: [StandardTreeListPluginTemplate.java](../assets/StandardTreeListPluginTemplate.java)
+- **片段**: [TreeControlSample](../assets/snippets/form/TreeControlSample.java)
+
+### 操作插件 {#op-plugin}
+- **关键词**: 审核 / 保存 / 状态流转 / 校验 / 回滚
+- **入口类**: `OpUtils` · `OperateChain` · `OperationServiceHelper`（MQ/后台任务） · `AbstractOperationServicePlugIn` · `kd.bos.entity.plugin.*`
+- **先读**: [operate-chain.md](../references/adv/operate-chain.md)
+- **兜底**: [plugin-operation.md](../references/base/plugin/plugin-operation.md) · [sdk-dynamic-model-svc.md](../references/base/sdk/sdk-dynamic-model-svc.md)
+- **模板**: [OpPluginTemplate.java](../assets/OpPluginTemplate.java)
+- **片段**: [OpAddValidatorsSample](../assets/snippets/operation/OpAddValidatorsSample.java) · [OperationOptionBridgeSample](../assets/snippets/operation/OperationOptionBridgeSample.java)
+
+### 转换插件 {#convert-plugin}
+- **关键词**: 下推 / 选单 / 来源追踪 / 转换
+- **入口类**: `BotpUtils` · `kd.bos.entity.botp.runtime.*` · `AbstractConvertPlugIn`
+- **先读**: [botp-convert.md](../references/adv/botp-convert.md)
+- **兜底**: [plugin-botp.md](../references/base/plugin/plugin-botp.md)
+- **模板**: [ConvertPlugInTemplate.java](../assets/ConvertPlugInTemplate.java)
+- **片段**: [BotpTracePushSample](../assets/snippets/botp/BotpTracePushSample.java)
+
+### 反写插件 {#writeback-plugin}
+- **关键词**: 明确指定反写插件 / BOTP 回写阶段
+- **入口类**: `AbstractWriteBackPlugIn` · `ConvertServiceHelper`
+- **先读**: [botp-convert.md](../references/adv/botp-convert.md)
+- **兜底**: [plugin-writeback.md](../references/base/plugin/plugin-writeback.md)
+- **模板**: [WriteBackPlugInTemplate.java](../assets/WriteBackPlugInTemplate.java)
+- **片段**: [BatchQuerySample](../assets/snippets/query/BatchQuerySample.java)
+
+### 报表插件 {#report-form-plugin}
+- **关键词**: 报表 / 数据分析 / 过滤容器
+- **入口类**: `AbstractReportFormPlugin`
+- **兜底**: [plugin-report-form.md](../references/base/plugin/plugin-report-form.md)
+- **模板**: [ReportFormPluginTemplate.java](../assets/ReportFormPluginTemplate.java)
+- **片段**: [SampleReportFormPlugin](../assets/snippets/report/SampleReportFormPlugin.java)
+
+### 报表取数插件 {#report-data-plugin}
+- **关键词**: 报表取数 / 动态列 / 自定义数据源
+- **入口类**: `AbstractReportListDataPlugin` · `DataSet`
+- **先读**: [query-dataset.md](../references/adv/query-dataset.md)
+- **兜底**: [plugin-report-data.md](../references/base/plugin/plugin-report-data.md) · [sdk-algo.md](../references/base/sdk/sdk-algo.md)
+- **模板**: [ReportListDataPluginTemplate.java](../assets/ReportListDataPluginTemplate.java)
+- **片段**: [SampleReportListDataPlugin](../assets/snippets/report/SampleReportListDataPlugin.java) · [DataSetQueryStatSample](../assets/snippets/query/DataSetQueryStatSample.java)
+
+### 打印插件 {#print-plugin}
+- **关键词**: 打印 / 套打
+- **入口类**: `AbstractPrintPlugin`
+- **兜底**: [plugin-print.md](../references/base/plugin/plugin-print.md)
+- **模板**: [PrintPluginTemplate.java](../assets/PrintPluginTemplate.java)
+
+### OpenAPI 控制器 {#openapi-plugin}
+- **关键词**: OpenAPI / 外部集成
+- **入口类**: `@ApiController` · `@ApiMapping` · `kd.bos.openapi.common.custom.annotation`
+- **兜底**: [plugin-openapi.md](../references/base/plugin/plugin-openapi.md)
+- **模板**: [OpenApiControllerTemplate.java](../assets/OpenApiControllerTemplate.java)
+
+### 后台任务 {#task-plugin}
+- **关键词**: 后台任务 / 定时 / 调度作业
+- **入口类**: `AbstractTask`
+- **兜底**: [plugin-task.md](../references/base/plugin/plugin-task.md)
+- **模板**: [TaskTemplate.java](../assets/TaskTemplate.java)
+- **片段**: [ScheduleTaskSample](../assets/snippets/task/ScheduleTaskSample.java)
+
+### 工作流插件 {#workflow-plugin}
+- **关键词**: 工作流 / 审批流
+- **入口类**: `IWorkflowPlugin`
+- **兜底**: [plugin-workflow.md](../references/base/plugin/plugin-workflow.md)
+- **模板**: [IWorkflowPluginTemplate.java](../assets/IWorkflowPluginTemplate.java)
+- **片段**: [SampleWorkflowPlugin](../assets/snippets/workflow/SampleWorkflowPlugin.java)
+
+### 导入插件 {#import-plugin}
+- **关键词**: 导入 / 批量导入
+- **入口类**: `BatchImportPlugin`
+- **兜底**: [plugin-import.md](../references/base/plugin/plugin-import.md)
+- **模板**: [BatchImportPluginTemplate.java](../assets/BatchImportPluginTemplate.java)
+
+---
+
+## 能力类
+
+### 视图打开与跳转 {#view-handler}
+- **关键词**: 后台打开表单 / 列表 / 新页签跳转
+- **入口类**: `ViewHandler` · `AutoCloseViewHandler` · `FormShowParameter`
+- **先读**: [view-handler.md](../references/adv/view-handler.md)
+
+### 界面工具 {#form-utils}
+- **关键词**: 表单控件 / UI 消息 / 元数据读取
+- **入口类**: `FormUtils` · `this.getView()` / `this.getModel()` · `kd.bos.form.control`
+- **先读**: [form-utils.md](../references/adv/form-utils.md)
+- **兜底**: [plugin-form.md](../references/base/plugin/plugin-form.md) · [plugin-bill.md](../references/base/plugin/plugin-bill.md) · [plugin-list.md](../references/base/plugin/plugin-list.md)
+- **片段**: [ViewControlOpsSample](../assets/snippets/form/ViewControlOpsSample.java) · [ConfirmDialogSample](../assets/snippets/form/ConfirmDialogSample.java) · [F7FilterSample](../assets/snippets/form/F7FilterSample.java)
+
+### 查询与存取 {#query}
+- **关键词**: 数据加载 / 保存 / 查询 / ORM / DataSet
+- **入口类**: `AlgoUtils` · `BusinessDataServiceHelper` · `QueryServiceHelper` · `QFilter`
+- **先读**: [query-dataset.md](../references/adv/query-dataset.md)
+- **兜底**: [sdk-dynamic-model-svc.md](../references/base/sdk/sdk-dynamic-model-svc.md) · [sdk-orm-access.md](../references/base/sdk/sdk-orm-access.md) · [sdk-algo.md](../references/base/sdk/sdk-algo.md)
+- **片段**: [BatchQuerySample](../assets/snippets/query/BatchQuerySample.java) · [DataSetQueryStatSample](../assets/snippets/query/DataSetQueryStatSample.java) · [DynamicObjectCrudSample](../assets/snippets/data/DynamicObjectCrudSample.java)
+
+### 基础资料 {#basedata}
+- **关键词**: 基础资料 / 管控策略 / 分配 / 个性化 / 客户 / 物料 / 供应商
+- **入口类**: `BaseDataServiceHelper` · `kd.bd.master.*`
+- **先读**: 先用 `cosmic-form-metadata.py` / `cosmic-basedata-query.py` 确认 `refType` / `entityId`
+- **兜底**: [sdk-dynamic-model-svc.md](../references/base/sdk/sdk-dynamic-model-svc.md)
+- **片段**: [BaseDataQuerySample](../assets/snippets/query/BaseDataQuerySample.java)
+
+### 数据包操作 {#dynamic-object}
+- **关键词**: DynamicObject / 安全取值 / 序列化
+- **入口类**: `DynamicObjectUtils` · `DynamicObject` · `DynamicObjectCollection`
+- **先读**: [dynamic-object.md](../references/adv/dynamic-object.md)
+- **兜底**: [sdk-dynamic-object.md](../references/base/sdk/sdk-dynamic-object.md)
+- **片段**: [DynamicObjectOpsSample](../assets/snippets/data/DynamicObjectOpsSample.java) · [DynamicObjectCrudSample](../assets/snippets/data/DynamicObjectCrudSample.java)
+
+### 元数据与结构 {#entity-metadata}
+- **关键词**: 实体元数据 / 字段路径 / DBRoute
+- **入口类**: `EntityUtils` · `EntityType` · `MainEntityType` · `IDataEntityProperty` · `DBRoute`
+- **先读**: [entity-metadata.md](../references/adv/entity-metadata.md)
+- **兜底**: [sdk-entity-model.md](../references/base/sdk/sdk-entity-model.md) · [sdk-orm-access.md](../references/base/sdk/sdk-orm-access.md)
+
+### 弹性域 {#flex-prop}
+- **关键词**: 弹性域字段 / 值解析
+- **入口类**: `FlexPropUtils` · `FlexType`
+- **先读**: [flex-prop.md](../references/adv/flex-prop.md)
+
+### 消息通知 {#message}
+- **关键词**: 消息 / 邮件 / 短信 / 企业微信
+- **入口类**: `MessageServiceHelper` · `EmailInfo` · `kd.bos.message.api.*`
+- **片段**: [MessageNotifySample](../assets/snippets/message/MessageNotifySample.java)
+
+### 附件与文件 {#attachment}
+- **关键词**: 附件上传 / 下载 / 复制 / 面板绑定
+- **入口类**: `AttachmentUtils` · `AttachmentServiceHelper`
+- **先读**: [attachment-api.md](../references/adv/attachment-api.md)
+- **兜底**: [sdk-file.md](../references/base/sdk/sdk-file.md)
+- **片段**: [AttachmentUploadBindSample](../assets/snippets/attachment/AttachmentUploadBindSample.java)
+
+### 上下文判定 {#request-context}
+- **关键词**: 组织 / 权限 / 上下文
+- **入口类**: `RequestContext`
+- **先读**: [request-context.md](../references/adv/request-context.md)
+- **兜底**: [sdk-request-context.md](../references/base/sdk/sdk-request-context.md)
+
+### 并发上下文恢复 {#thread-context}
+- **关键词**: 跨线程身份 / 上下文恢复 / 线程池批量处理
+- **入口类**: `RequestContextUtils` · `ThreadPools` · `ExecutorServiceUtils`
+- **先读**: [request-context.md](../references/adv/request-context.md)
+- **兜底**: [sdk-threadpool.md](../references/base/sdk/sdk-threadpool.md) · [sdk-request-context.md](../references/base/sdk/sdk-request-context.md)
+- **片段**: [SampleThreadPoolBatch](../assets/snippets/concurrent/SampleThreadPoolBatch.java)
+
+### 消息队列 {#mq-consumer}
+- **关键词**: MQ / 消息队列 / 异步消费 / MessageConsumer
+- **入口类**: `MessageConsumer` · `MessageAcker` · `MQFactory` · `DLock`
+- **片段**: [SampleMQConsumer](../assets/snippets/mq/SampleMQConsumer.java)
+
+### 缓存 {#cache}
+- **关键词**: 缓存 / AppCache / 分布式缓存 / loadFromCache
+- **入口类**: `AppCache` · `DistributeSessionlessCache` · `CacheFactory` · `BusinessDataServiceHelper.loadFromCache`
+- **片段**: [SampleCacheUsage](../assets/snippets/cache/SampleCacheUsage.java)
+
+### 业务拓展点查询 {#business-extpoints}
+- **关键词**: 业务拓展点 / 业务扩展点 / SDK 扩展接口 / 扩展场景 / 扩展插件 / 二开接口 / Java 示例 / route extpoint
+- **入口脚本**: `scripts/cosmic-extpoints-query.py`
+- **先查**: `python3 <SKILL_ROOT>/scripts/cosmic-extpoints-query.py --config ok-cosmic.json get --keyword <业务关键词>`
+- **示例查询**: 默认不用 `--full`；只有当需要生成实现代码或查看返回中的 Java/代码示例时，才追加 `--full`
+- **后续验证**: 若 `--full` 返回中已有清晰 Java 示例代码（能识别 `implements` 接口、`@Override` 方法、参数与返回值），可先按示例生成，不强制立即调用 `cosmic-api-knowledge.py detail`；若示例缺失/不完整/签名仍不确定，再用 `detail <full.class.Name>` 确认
+- **约束**: 仅用于定位标准产品预留的业务拓展点候选；不要误判为 OpenAPI 控制器、表单插件或操作插件；示例代码可作为优先参考，但示例不清晰时不得猜方法签名
+
+---
+
+## 未命中兜底 {#fallback}
+
+如果需求不属于上述任一场景：
+
+1. **需求可拆分**：将需求拆解为多个子任务，分别匹配卡片。常见组合：
+   - "保存前校验 + 审核后下推 + 下推后在 BOTP 回写阶段更新来源" → 操作插件 + 转换插件 + 反写插件
+   - "列表批量选中 + 弹窗编辑 + 保存" → 列表插件 + 表单插件 + 操作插件
+2. **纯后端逻辑（无 UI、无操作链）**：优先命中"查询与存取""基础资料""消息通知""并发上下文恢复"等能力卡片；仍不匹配时，再回到 `references/base/sdk/` 原生 SDK 文档。
+3. **用户想找标准产品预留扩展点**：优先命中 [`#business-extpoints`](#business-extpoints)，用业务关键词查候选接口，再用 `cosmic-api-knowledge.py detail` 校验签名。
+4. **仍无法匹配**：先用 `cosmic-api-knowledge.py search <关键词>` 搜索相关类，再向用户确认具体实现方向后动手。
+5. **扩展代码库探索**（需 `ok-cosmic.json` 配置 `extensionRepos`）：
+   用当前需求关键词在扩展代码库中搜索相关 Java 实现，
+   作为实现参考但仍需遵守 ok-cosmic 规范。

package/vendor/kingdee-skills/ok-cosmic/rules/intent-routing.md

@@ -0,0 +1,94 @@
+# 自然语言意图到场景路由
+
+当用户不是直接说“操作插件 / 表单插件 / 基础资料能力”，而是用业务话术描述需求时，先把需求翻译为：
+
+1. **时机**：事情发生在什么时候
+2. **载体**：发生在哪个界面 / 后台 / 接口
+3. **能力**：还需要补哪种公共能力
+
+完成翻译后，再去 [decision-matrix.md](decision-matrix.md) 命中 **1 行主场景** 和 **0-1 行能力行**。
+
+## 路由三问
+
+### 1. 先看“时机词”
+
+| 用户常说的话                                   | 优先翻译为 | 对应矩阵 |
+|------------------------------------------|---|---|
+| 保存前 / 提交时 / 审核时 / 反审核时 / 操作时 / 校验不通过不让继续 | 操作链上的校验、补值、拦截 | [`#op-plugin`](decision-matrix.md#op-plugin) |
+| 下推时 / 选单时 / 来源单据带出 / 转换规则                | 单据转换阶段处理 | [`#convert-plugin`](decision-matrix.md#convert-plugin) |
+| 用户口头说“反写” / 回写上游 / 更新来源状态                | 默认先按“更新关联实体”理解，不直接等于反写插件 | 继续结合主动作判断是操作插件、转换插件，还是明确的反写插件 |
+| 明确指定“反写插件” / 明确要求挂在 BOTP 回写阶段            | 反写阶段处理 | [`#writeback-plugin`](decision-matrix.md#writeback-plugin) |
+| 打开页面时 / 页面初始化时 / 字段值改变 / 点击按钮时 / F7 过滤时  | 前端交互阶段处理 | 继续看“载体词”决定是表单、单据还是列表插件 |
+| 定时执行 / 每天跑一次 / 后台批处理 / 异步任务              | 后台任务 | [`#task-plugin`](decision-matrix.md#task-plugin) |
+| 外部系统调用 / 提供接口 / 回调地址                     | OpenAPI 控制器 | [`#openapi-plugin`](decision-matrix.md#openapi-plugin) |
+| 打印时 / 套打时                                | 打印插件 | [`#print-plugin`](decision-matrix.md#print-plugin) |
+| 导入时 / 批量导入时                              | 导入插件 | [`#import-plugin`](decision-matrix.md#import-plugin) |
+| 审批流节点 / 工作流动作                            | 工作流插件 | [`#workflow-plugin`](decision-matrix.md#workflow-plugin) |
+
+### 2. 再看“载体词”
+
+当前一步落到“前端交互阶段处理”时，再用载体词确定主场景：
+
+| 用户常说的话 | 优先翻译为 | 对应矩阵 |
+|---|---|---|
+| 表单上 / 页面上 / 打开窗口 / 字段联动 / 控件显示隐藏 | 表单插件 | [`#form-plugin`](decision-matrix.md#form-plugin) |
+| 单据界面 / 单据头体 / 审核提交按钮 / 单据字段联动 / 分录操作（增行、删行、遍历分录） | 单据插件 | [`#bill-plugin`](decision-matrix.md#bill-plugin) |
+| 列表上 / 列表按钮 / 多选批量 / 批量处理 | 列表插件 | [`#list-plugin`](decision-matrix.md#list-plugin) |
+| 左边树右边表 / 树节点切换右侧数据 | 树列表插件 | [`#tree-plugins`](decision-matrix.md#tree-plugins) |
+| 报表过滤条件界面 / 报表表单 | 报表插件 | [`#report-form-plugin`](decision-matrix.md#report-form-plugin) |
+| 报表取数 / 动态列 / 自定义数据源 | 报表取数插件 | [`#report-data-plugin`](decision-matrix.md#report-data-plugin) |
+
+### 3. 最后补“能力词”
+
+主场景命中后，再按需补 0-1 行能力行：
+
+| 用户常说的话 | 追加能力 | 对应矩阵 |
+|---|---|---|
+| 打开页面 / 弹窗 / 新页签 / 跳详情页 | 视图打开与跳转 | [`#view-handler`](decision-matrix.md#view-handler) |
+| 查数据 / 聚合 / 统计 / ORM / DataSet | 查询与存取 | [`#query`](decision-matrix.md#query) |
+| 基础资料编码名称 / 引用类型 / 管控策略 / 分配 | 基础资料 | [`#basedata`](decision-matrix.md#basedata) |
+| DynamicObject / 安全取值 / 序列化 | 数据包操作 | [`#dynamic-object`](decision-matrix.md#dynamic-object) |
+| 实体元数据 / 字段路径 / DBRoute | 元数据与结构 | [`#entity-metadata`](decision-matrix.md#entity-metadata) |
+| 分录行数据 / 增删分录行 / 遍历分录 / createNewEntryRow / getEntryRowEntity | 数据包操作 | [`#dynamic-object`](decision-matrix.md#dynamic-object) |
+| 弹性域 / Flex | 弹性域 | [`#flex-prop`](decision-matrix.md#flex-prop) |
+| 附件上传下载复制 | 附件与文件 | [`#attachment`](decision-matrix.md#attachment) |
+| 邮件 / 消息 / 企业微信 / 短信 | 消息通知 | [`#message`](decision-matrix.md#message) |
+| 组织权限 / 登录组织 / 上下文判定 | 上下文判定 | [`#request-context`](decision-matrix.md#request-context) |
+| 异步线程 / 跨线程身份恢复 | 并发上下文恢复 | [`#thread-context`](decision-matrix.md#thread-context) |
+| 业务拓展点 / 业务扩展点 / SDK 扩展接口 / 扩展场景编码 / Java 示例 | 业务拓展点查询 | [`#business-extpoints`](decision-matrix.md#business-extpoints) |
+
+## 常见例句翻译
+
+| 用户原话 | 推荐翻译 | 命中方式 |
+|---|---|---|
+| 我想在审核的时候校验金额不能超过 100 万 | 时机=`审核时`，载体=`单据操作`，能力=`校验` | 主场景命中 [`#op-plugin`](decision-matrix.md#op-plugin) |
+| 页面上选了供应商以后自动过滤物料 | 时机=`字段值改变`，载体=`单据/表单界面`，能力=`基础资料 + 界面工具` | 主场景命中 [`#bill-plugin`](decision-matrix.md#bill-plugin) 或 [`#form-plugin`](decision-matrix.md#form-plugin)，补 [`#basedata`](decision-matrix.md#basedata) |
+| 列表里加个批量审核按钮 | 时机=`点击按钮时`，载体=`列表`，能力=`操作链` | 主场景命中 [`#list-plugin`](decision-matrix.md#list-plugin)，必要时补 [`#op-plugin`](decision-matrix.md#op-plugin) |
+| 下推后把来源单据状态改成已处理 | 时机=`下推后`，意图=`更新来源实体` | 先按转换链路中的实体更新理解；只有明确指定反写插件 / BOTP 回写点时才命中 [`#writeback-plugin`](decision-matrix.md#writeback-plugin) |
+| 每天凌晨同步一次基础资料 | 时机=`定时执行`，载体=`后台`，能力=`基础资料` | 主场景命中 [`#task-plugin`](decision-matrix.md#task-plugin)，补 [`#basedata`](decision-matrix.md#basedata) |
+| 提供一个接口给 WMS 回传结果 | 时机=`外部系统调用`，载体=`接口` | 主场景命中 [`#openapi-plugin`](decision-matrix.md#openapi-plugin) |
+| 查一下应付相关的业务拓展点，并给一个 Java 示例 | 意图=`查询型`，能力=`业务拓展点查询` | 直接命中 [`#business-extpoints`](decision-matrix.md#business-extpoints)，先查候选，再按 `interfaceName` 查签名 |
+
+## 查询型意图补充
+
+如果用户不是要立刻写插件，而是在问“有没有 / 查一下 / 找一下 / 列出 / 给我示例”某类标准产品预留能力，可直接命中能力卡片。
+
+| 用户常说的话 | 优先翻译为 | 对应矩阵 |
+|---|---|---|
+| 查业务拓展点 / 找业务扩展点 / 有没有标准扩展点 / SDK 扩展接口 / 扩展场景编码 / 业务扩展插件 / 给我拓展点 Java 示例 | 查询标准产品预留的业务拓展点候选 | [`#business-extpoints`](decision-matrix.md#business-extpoints) |
+| 查类 / 查方法 / 看签名 / 这个接口有哪些方法 | SDK API 事实查询 | 先走 `cosmic-api-knowledge.py`；已命中具体实现需求时再回到矩阵 |
+
+## 常见误判修正
+
+- 用户说“审核页面上”但真正诉求是“审核动作发生时拦截”，优先按 [`#op-plugin`](decision-matrix.md#op-plugin) 处理，不要因为提到“页面”就误判成表单/单据插件。
+- 用户说“页面上实时提示”“字段改了马上联动”，优先按表单 / 单据插件处理，不要误判成操作插件。
+- “反写”相关（见上方路由三问）：口头“反写”/“下推后更新来源”默认理解为业务语义的“更新关联实体”；只有用户明确说“反写插件”“WriteBackPlugIn”“BOTP 回写阶段”时才命中 [`#writeback-plugin`](decision-matrix.md#writeback-plugin)。
+- 用户说“后台自动跑”“定时同步”，优先按 [`#task-plugin`](decision-matrix.md#task-plugin)，不要误判成列表按钮或操作插件。
+- 用户只说“查一批数据统计结果”，如果没有插件时机词，优先从 [`#query`](decision-matrix.md#query) 开始，而不是先猜某种插件。
+- 用户说“业务拓展点 / 业务扩展点 / SDK 扩展接口 / 扩展场景编码”时，优先按 [`#business-extpoints`](decision-matrix.md#business-extpoints) 查询候选；不要误判成“OpenAPI 控制器”或直接套用 BOS 表单/操作插件模板。
+
+## 仍然模糊时
+
+- 先用本文件把用户原话翻成“时机 + 载体 + 能力”。
+- 再去 [decision-matrix.md](decision-matrix.md) 读对应 1-3 行。
+- 还是模糊时，按 [decision-matrix.md#fallback](decision-matrix.md#fallback) 的兜底流程继续。

package/vendor/kingdee-skills/ok-cosmic/rules/platform-baseline.md

@@ -0,0 +1,69 @@
+# 苍穹平台总规范摘要
+
+> 本文件为**平台级基线参考**（guidance-only），不直接对应 lint 脚本。
+
+本文件提炼自《苍穹定制化开发规范》，用于补齐 `ok-cosmic` 现有规则中较少覆盖的"平台级基线"。遇到命名、设计器/PDM、数据库、多语言、微服务、日志异常等问题时，优先回看本文件。
+
+## 1. 命名基线
+
+- 扩展项目推荐命名：`<isv>-<cloud>-<system>[-<type>]-ext`
+- 扩展包强制命名：`<isv>.<cloud>[.<app>][.<feature>][.<suffix>]`
+- 类名使用 `UpperCamelCase`，方法和变量使用 `lowerCamelCase`
+- 不要使用难以理解的随意缩写；抽象类以 `Abstract` 开头，异常类以 `Exception` 结尾，枚举类以 `Enum` 结尾
+- Service/DAO 命名遵守语义前缀：单条 `get`，列表 `list`，统计 `count`，新增 `save/insert`，删除 `remove/delete`，修改 `update`
+- 插件类推荐后缀：
+    - 表单插件：`{Name}FormPlugin`
+    - 单据插件：`{Name}BillPlugin`
+    - 列表插件：`{Name}ListPlugin`
+    - 操作插件：`{Name}OpPlugin`
+    - 报表插件：`{Name}RptPlugin`
+    - 统一使用 `Plugin` 后缀写法
+
+## 2. 数据模型与数据库基线
+
+- 业务对象表结构以 PDM 和设计器定义为准；表、字段、缺省值、可空性、实体关系必须一致
+- 二开表名使用 `tk_<isv>_...` 前缀，二开字段使用 `fk_<isv>_...` 前缀
+- 业务对象禁止使用数据库视图；设计器主键属性必须与表定义主键一致
+- 表、字段、键、约束、缺省值名称长度不超过 24；字段 Key 推荐 4-24 位，由字母、数字、下划线组成
+- 不要设计数据库外键；关系通过平台模型和应用逻辑维护
+- 表结构总字节长度不得超过 8K（LOB / Image / nText 不计入）
+- 新建表必须定义主键，新建数据库对象必须具备聚集索引
+- 金额、数量字段必须使用精确数值类型 `Decimal`，明确精度，`not null` 且默认值为 `0`
+- 字段长度按实际场景定义，禁止无依据地统一使用 `255`
+- 同一业务含义的字段，在不同表中的类型定义要保持一致
+
+## 3. 开发与插件基线
+
+- 禁止在 `beforeBindData`、`afterBindData` 中修改数据对象
+- 禁止在 `initialize()` 中注册控件事件、设置控件可见性或编写界面逻辑
+- 事件注册放 `registerListener`；界面控制放 `afterBindData`
+- 禁止继承标准产品插件；禁止禁用原厂插件
+- 创建引用对象或给引用属性赋值时，必须保证对象类型与属性复杂类型一致
+- 从缓存拿到的实体元数据是单例，修改前必须先 `clone`
+- 判断"记录是否存在"优先使用 `QueryServiceHelper.exists(...)`
+
+## 4. 性能与数据访问基线
+
+- 所有脚本优先使用 KSQL，避免数据库方言
+- SQL/KSQL 传参优先使用参数化形式，避免字符串拼接
+- 不推荐在循环中访问数据库、Redis、`view.updateView()`
+- 查询按需取字段；除加载完整单据/基础资料场景外，不要默认查询所有字段
+
+## 5. 异常、日志与多语言基线
+
+- 统一使用 `KDException` 体系；业务异常必须使用 `KDBizException`，不要用 `RuntimeException` 代替
+- 包装异常时必须保留原始 `cause`
+- 程序日志统一使用 `kd.bos.logging.Log`；业务操作日志统一使用 `BizLog.log`
+- 输出日志前先判断日志级别；禁止在大循环中打日志；记录异常时用 `logger.error("描述", e)`
+- 多语言字段必须使用多语言文本控件，并落库为 `NVARCHAR`
+- 非多语言字段但会存中文等非英文字符时，也应优先定义为 `NVARCHAR`
+- 多语言表推荐单独建表，命名 `{表名}_L`，主键字段名固定为 `FPKID`
+- 提示语不要通过多个中文片段拼接；应以完整句模板配合 `ResManager.loadKDString(...)` 和 `String.format(...)`
+- 运行时会按登录语言切换的提示语，不要固化成静态常量，改为方法内实时获取
+
+## 6. 微服务与报表基线
+
+- 二开微服务必须通过服务工厂注册；服务工厂类推荐：`<isv>.<cloud>.<app>.ServiceFactory`
+- 微服务接口放在对应业务包下，命名保持“业务域 + Service”风格
+- 报表场景避免在循环中做 SQL；大子单据体关联时优先拆分查询，减少 `left join`
+- 充分利用 `algo` 做分组、去重、计数；避免把大数据量聚合放到 Java 循环里

package/vendor/kingdee-skills/ok-cosmic/rules/post-check.md

@@ -0,0 +1,109 @@
+# 生成后自动校验规则 (Post-Check)
+
+`cosmic-post-check.py` 是代码生成后的**统一检查入口**，自动选择最佳检查策略：
+
+- **Gradle 项目** → 先执行 `./gradlew :module:compileJava` 真实编译，编译成功后继续执行 `cosmic-post-lint.py` 场景/风格校验
+- **非 Gradle 项目** → 直接回退到 `cosmic-post-lint.py` 静态校验（A/B/C 三层规则）
+
+## 触发条件
+
+**每次 AI 生成或修改 `.java` 文件后，自动触发**，无需用户手动请求。
+
+## 默认执行命令
+
+```bash
+python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <生成的文件或目录> --fix-hint
+```
+
+脚本自动判断：
+1. 从目标文件路径**向上查找** `build.gradle` + `settings.gradle` 共存的目录
+2. 找到 → Gradle 编译（解析 `settings.gradle` 确定模块，执行 `./gradlew :module:compileJava`）
+3. 未找到 → 回退到 `cosmic-post-lint.py --fix-hint` 静态校验
+
+## 严格模式（仅 post-lint 回退时生效）
+
+当用户明确要求"严格校验""模板升级治理""补事实来源留痕"时，再追加严格模式：
+
+```bash
+python3 <SKILL_ROOT>/scripts/cosmic-post-check.py <生成的文件或目录> --fix-hint --strict
+```
+
+说明：
+
+- `--strict` 仅在非 Gradle 回退到 post-lint 时生效，额外检查 **C 层** 验证来源注释。
+- Gradle 编译本身不区分严格/宽松——编译器检查的就是全部约束。
+
+## 校验流程
+
+```mermaid
+graph TB
+    A[生成代码] --> B[执行 cosmic-post-check.py]
+    B --> C{Gradle 项目?}
+    C -->|否| D[post-lint 静态校验]
+    C -->|是| E{JAVA_HOME 兼容?}
+    E -->|否| F[post-lint + JDK 设置提示]
+    E -->|是| G[Gradle 编译]
+    G -->|失败| H[修复代码 → 重新编译]
+    G -->|成功| I[继续 post-lint 场景/风格校验]
+    I --> J[综合结果]
+    D --> J
+    F --> J
+    J -->|有 ERROR| K[必须修复 → 重新校验]
+    J -->|仅 WARNING| L[新代码优先修复]
+    J -->|全部通过| M[完成]
+```
+
+> **注意**：Gradle 编译成功后仍会串联执行 post-lint 的场景/风格校验（SCENE/STYLE/RESOURCE 等规则），编译器不检测这些业务约束。最终以两者综合结果为准。
+
+## 问题级别处理策略
+
+| 级别 | 对应层级 | 处理方式 | 是否阻断 |
+|------|----------|----------|----------|
+| ❌ ERROR | A 层硬约束 | 必须修复，根据 fix-hint 立即调整代码 | **是** |
+| ⚠️ WARNING | B 层推荐项 | 新代码优先修复；历史代码可结合上下文评估是否本次顺手收敛 | 否 |
+| 💡 INFO | C 层治理项 | 记录为治理建议，适合模板升级或批量重构 | 否 |
+
+## 规则 ID 与层级映射
+
+| ID 前缀 | 默认层级 | 类别 | 来源文件 |
+|----------|----------|------|----------|
+| `SCENE-*` | A / B | 场景错配 | anti-patterns.md |
+| `STYLE-*` | A / B | 编码风格 | coding-preferences.md |
+| `RESOURCE-*` | A / B | 资源管理 | coding-preferences.md |
+| `VERIFY-*` | C | 验证来源留痕 | coding-preferences.md |
+
+补充说明：
+
+- SDK 类名、方法签名和 `@Override` 正确性改为**事前**通过 `cosmic-api-knowledge.py detail/search`、模板、cheat-sheet 或编译验证，不再由 post-lint 的 `API-*` 规则兜底。
+- `SCENE-*` 与 `RESOURCE-*` 中既有明显硬错误，也可能包含偏治理的 warning；解释结果时要结合上下文，不要机械套标签。
+- 需要按 A 层（ERROR）处理的 SCENE/STYLE/RESOURCE 规则 ID，统一定义在 [a-layer-rules.json](a-layer-rules.json)（单一可信源），`cosmic-post-lint.py` 在运行时自动加载。如需新增/移除 A 层规则，直接编辑该 JSON 文件即可，无需改脚本代码。
+- `VERIFY-*` 默认不作为当前交付阻断项；只有在 `--strict` 或用户明确要求治理时，才应提高关注度。
+
+## 修复示例
+
+当收到如下 lint 报告时：
+
+```text
+❌ L 31 [SCENE-001] 操作插件中调用 this.getView()
+   > this.getView().showMessage("处理完成");
+   💊 修复: 操作插件无 UI 上下文，改为 addErrorMessage / 日志 / 返回操作结果
+```
+
+AI 应：
+
+1. 将 UI 交互逻辑移出操作插件，或改为操作结果/日志方式表达。
+2. 重新执行 lint，确认该 `ERROR` 消失
+3. 检查修复是否引入新的场景错配或资源问题
+
+## 对历史项目的解释口径
+
+- 出现 `WARNING` 时，不要直接说"代码错误"；优先判断它是：
+  - 新代码应该采用的默认写法
+  - 历史项目当前可接受的兼容写法
+  - 适合本次顺手治理的低风险改动
+- 出现 `INFO` 时，默认按"后续治理建议"表述，不要阻断当前任务。
+
+## 重试上限
+
+- 单个文件最多执行 **3 轮** "修复 → 复检" 循环
+- 3 轮后仍有 `ERROR` 未消除，停止自动修复，向用户报告剩余问题清单并请求人工介入