kcode-pi 0.1.0

package/vendor/kingdee-skills/kingdee-cosmic-reviewer/scripts/review-score-calculator.py

@@ -0,0 +1,121 @@
+#!/usr/bin/env python3
+"""
+金蝶代码审查评分计算器
+根据发现的问题数量和严重程度计算综合评分
+"""
+
+from typing import List, Dict
+
+# 问题扣分权重
+WEIGHTS = {
+    'P0': 25,  # 阻断问题 - 严重扣分
+    'P1': 10,  # 高危问题 - 中等扣分
+    'P2': 3,   # 规范问题 - 轻微扣分
+}
+
+# 评分等级描述
+GRADE_DESCRIPTIONS = {
+    (90, 100): '🟢 优秀 - 代码质量高，可上线',
+    (70, 89):  '🟡 良好 - 存在改进空间',
+    (50, 69):  '🟠 一般 - 需要修复部分问题',
+    (0, 49):   '🔴 差 - 必须修复后才能上线',
+}
+
+def calculate_score(issues: List[Dict]) -> int:
+    """
+    计算代码评分
+    
+    Args:
+        issues: 问题列表，每个问题包含 level 字段
+        
+    Returns:
+        评分 (0-100)
+    """
+    score = 100
+    for issue in issues:
+        level = issue.get('level', 'P2')
+        score -= WEIGHTS.get(level, 0)
+    return max(0, score)
+
+def get_grade(score: int) -> str:
+    """
+    获取评分等级描述
+    
+    Args:
+        score: 评分 (0-100)
+        
+    Returns:
+        等级描述
+    """
+    for (low, high), desc in GRADE_DESCRIPTIONS.items():
+        if low <= score <= high:
+            return desc
+    return '🔴 差 - 必须修复后才能上线'
+
+def get_statistics(issues: List[Dict]) -> Dict:
+    """
+    获取问题统计
+    
+    Args:
+        issues: 问题列表
+        
+    Returns:
+        统计信息字典
+    """
+    stats = {
+        'total': len(issues),
+        'P0': 0,
+        'P1': 0,
+        'P2': 0,
+    }
+    for issue in issues:
+        level = issue.get('level', 'P2')
+        stats[level] = stats.get(level, 0) + 1
+    return stats
+
+def generate_report(issues: List[Dict], filename: str = '') -> str:
+    """
+    生成审查报告摘要
+    
+    Args:
+        issues: 问题列表
+        filename: 文件名
+        
+    Returns:
+        报告摘要字符串
+    """
+    stats = get_statistics(issues)
+    score = calculate_score(issues)
+    grade = get_grade(score)
+    
+    report = f"""
+# 🛡️ 代码审查摘要
+
+## 📊 综述
+- **审查文件**: {filename or '未指定'}
+- **发现问题总数**: {stats['total']} (🔴 P0: {stats['P0']} | 🟠 P1: {stats['P1']} | 🟡 P2: {stats['P2']})
+- **综合评分**: {score} 分
+- **评级**: {grade}
+
+## 📋 改进建议
+"""
+    
+    if stats['P0'] > 0:
+        report += f"- ⚠️ 发现 {stats['P0']} 个 P0 级阻断问题，必须修复后才能上线\n"
+    if stats['P1'] > 0:
+        report += f"- ⚡ 发现 {stats['P1']} 个 P1 级高危问题，强烈建议修复\n"
+    if stats['P2'] > 0:
+        report += f"- 📝 发现 {stats['P2']} 个 P2 级规范问题，建议优化\n"
+    
+    return report
+
+# 示例用法
+if __name__ == '__main__':
+    # 测试数据
+    test_issues = [
+        {'level': 'P0', 'description': 'Initialize 注册监听'},
+        {'level': 'P1', 'description': '循环内调用 updateView'},
+        {'level': 'P2', 'description': '硬编码中文字符串'},
+    ]
+    
+    print(generate_report(test_issues, 'TestPlugin.java'))

package/vendor/kingdee-skills/ok-cosmic/CHANGELOG.md

@@ -0,0 +1,295 @@
+# Changelog
+
+## [1.3.0] - 2026-05-06
+
+### Added
+- `cosmic-extpoints-query.py`: 新增业务拓展点查询脚本，支持按插件类型 / 关键词查询拓展点接口与实现类。
+- `references/extpoints/业务拓展场景.md`: 新增业务拓展场景参考文档。
+- `extensionRepos`: 新增扩展代码库兜底机制——当 Skill 内置资产与当前项目均无法满足时，回落到用户配置的扩展代码库搜索 Java 实现作为参考。`config_loader.py` 校验路径，SKILL.md 决策矩阵新增 fallback 步骤，`ok-cosmic-intro.html` 新增可视化页。
+- snippets: 新增工作流插件 snippet（`workflow/SampleWorkflowPlugin.java`，IWorkflowPlugin 全场景 Cookbook）。
+- snippets: 新增线程池 snippet（`concurrent/SampleThreadPoolBatch.java`）、MQ snippet（`mq/SampleMQConsumer.java` + `sample_mq.xml`）、缓存 snippet（`cache/SampleCacheUsage.java`）。
+- snippets: 新增报表插件 snippet——`report/SampleReportFormPlugin.java`（界面插件）、`report/SampleReportListDataPlugin.java`（取数插件 + DataSet Cookbook）。
+- `manifest.json`: 注册 `cosmic_extpoints_query` 工具。
+- lint: 新增 STYLE-025 规则（`BusinessDataServiceHelper.load` 全量加载检测）。
+- lint: 新增 STYLE-027 规则（BigDecimal 原生运算检测，推荐 BigDecimalUtils）。
+- `cosmic-form-metadata.py`: 新增 dbName 输出与跨库场景处理规则。
+- `BasedataPropField`: 元数据输出增加取值路径警告，snippets 补充引用关系路径用法。
+
+### Changed
+- `cosmic-api-knowledge.py` / `cosmic-form-metadata.py`: 统一在线查询为 route 路由。
+- `cosmic-extpoints-query.py`: 新增业务拓展点查询 API，脚本优化。
+- snippets: 日志占位符统一为 SLF4J `{}` 格式（16 处）、BigDecimal 运算统一为 BigDecimalUtils。
+- snippets: 死变量清理、接口类型声明统一、冗余代码精简（5 个文件）。
+- snippets: 示例代码多处优化，提升准确性与实现细节；QueryUtils 仅作为工具包类 API 使用。
+- 部分 API 加入 fallback 机制。
+- `cosmic-form-metadata.py`: 强化字段元数据强制验证规则。
+
+### Fixed
+- 统一脚本异常兜底输出。
+- `cosmic-post-check.py` / `cosmic-post-lint.py` / 其余脚本：多处脚本细节优化。
+
+## [1.2.2] - 2026-04-10
+
+### Added
+- `cosmic-form-metadata.py`: 新增 `--type` 参数，支持按字段类型模糊筛选（如 `--type BaseData`、`--type "combo|check"`），可与 `--fuzzy` 交集组合。
+- `cosmic-form-metadata.py`: 新增 `--op` 参数，支持操作按钮专项查询与关键词筛选（如 `--op 审核 提交`）。
+- `cosmic-api-knowledge.py`: `search` / `search-method` 子命令支持逗号分隔批量搜索，脚本内部 `ThreadPoolExecutor` 并发请求。
+- `cosmic-api-knowledge.py`: `detail` 子命令支持逗号分隔批量查类详情（并发请求）。
+- `cosmic-form-metadata.py`: 批量查询支持 formId 与中文单据名混合传入，脚本自动识别并通过 `ThreadPoolExecutor` 并发请求（最多 4 线程）。
+- `cosmic-post-lint.py`: 目录下多文件并发 lint（`ThreadPoolExecutor`，最多 4 线程）。
+
+### Changed
+- `cosmic-form-metadata.py`: 统一 `--form-id` 和 `--bill-name` 为位置参数 `formIdOrName`，简化调用方式。
+- `SKILL.md`: 开发决策路径引入 Search Agent 并行探索模式（🔍 标记），步骤 2 拆分为 Agent A（事件参考）与 Agent B（项目探索）并行执行。
+- `SKILL.md`: 脚本路由表格备注更新，标注 `detail` 与 `get` 的批量查询与并发能力。
+- `SKILL.md`: 脚本调用示例大幅扩充，补充批量查询、混合查询、类型筛选、操作按钮查询等用法。
+- `SKILL.md`: 跨脚本硬约束新增「元数据批量查询」规则，跨单据场景优先使用逗号分隔一次调用。
+
+### Removed
+- `cosmic-post-check.py`: 移除 JDK 版本预判逻辑（Gradle 版本检测、JDK 兼容性矩阵），简化为仅解析 `JAVA_HOME` 路径。
+- `cosmic-post-lint.py`: 移除 `hal_check`（幻觉检查）和 `api_check`（API 校验）两个 lint 模块注册。
+- `cosmic-config-check.py`: 移除 Java / JAVA_HOME 可用性检查步骤，简化 Step 0 预检流程。
+
+## [1.2.1] - 2026-04-10
+
+### Changed
+- `SKILL.md`: 开发决策路径新增「并行优先原则」——标注 **‖** 的步骤（参考文档+模板加载、字段查询+API 签名验证）应在同一轮并行发起，减少 2-3 轮串行等待。
+- `SKILL.md`: 跨脚本硬约束新增并行调用规则，明确 `cosmic-form-metadata.py` 与 `cosmic-api-knowledge.py` 可并行、`cosmic-basedata-query.py` 必须串行等待 `entityId` 确认。
+
+## [1.2.0] - 2026-04-10
+
+### Added
+- `ok-cosmic-intro.html`: 16 页 HTML 技能介绍演示文稿，纯前端实现（键盘/触摸翻页、进度条），覆盖架构、规则体系、工具链、决策流程等完整内容。
+- `assets/snippets/concurrent/ThreadContextSample.java`: 并发上下文恢复代码片段，演示 `RequestContext` 跨线程传递最佳实践。
+- `requirements.txt`: Python 依赖声明文件，`cosmic-config-check.py` 健康检查时自动安装。
+- `rules/a-layer-rules.json`: 新增 STYLE-022 ~ STYLE-024 等 10 个 A 层规则 ID。
+
+### Changed
+- **SKILL.md 重构为线性执行流**：Step 0（配置预检）→ 意图路由 → 决策矩阵 → 最小确认卡 → 脚本路由 → 代码生成 → Post-Check，全文 233 行精简可读。
+- `rules/decision-matrix.md`: 扩展为完整统一决策矩阵（14 种插件类型 + 11 种能力类型 + 兜底路径），合并原 `plugin-dev-flow.md` 中的流程内容。
+- `rules/intent-routing.md`: 新增自然语言意图路由三问（时机 → 载体 → 能力），降低弱模型路由错误率。
+- `rules/constraints.md`: A 层硬约束重编为 A1-A5 分节，补充 SCENE-ID 交叉引用。
+- `rules/anti-patterns.md`: 场景错配表 6 个 A 层行全部补全 SCENE-ID 标签（SCENE-001/002/006/008），实现 anti-patterns → a-layer-rules.json → scene_check.py 完整追溯链。
+- `rules/coding-preferences.md`: B/C 层规则扩展，新增 STYLE-022 ~ STYLE-024 规则说明及 RESOURCE-004 例外条件。
+- `rules/post-check.md`: 修正 Gradle 校验行为描述——编译成功后仍串联 post-lint 静态校验，以综合结果为准。
+- `rules/cheat-sheet.md`: 高频 API 速查表扩充。
+- `rules/platform-baseline.md`: 平台基线微调。
+- `manifest.json`: 清理 ignore 列表（移除已删除的 WORKFLOW.html），工具描述对齐。
+- `README.md`: Q2 排查示例脚本路径补全为 `skills/ok-cosmic/scripts/` 完整相对路径。
+- `assets/FormPluginTemplate.java`: 补充 40 行生命周期方法（`afterCreateNewData`、`beforeDoOperation` 等）。
+- `assets/OpPluginTemplate.java`: 移除不存在的 `@snippets assets/snippets/silent-audit.java` 引用。
+- `assets/BillPlugInTemplate.java`: 基类引用修正。
+- `assets/IWorkflowPluginTemplate.java`: 冗余代码清理。
+- 12 个 snippet 文件统一补充 `@scenario` / `@tags` 元数据标签，提升 AI 检索命中率。
+- `assets/snippets/snippets-guide.md`: 片段索引同步更新。
+- `scripts/cosmic-config-check.py`: 大幅增强（+193 行），支持自动安装 Python 依赖（读取 `requirements.txt`）、完善健康检查分级输出。
+- `scripts/lint/scene_check.py`: SCENE-006/007/008/012 检测增强（+262 行），覆盖更多场景错配模式。
+- `scripts/lint/base.py`: Java AST 解析基础设施升级（+186 行），增强类继承链解析与注释状态机。
+- `scripts/lint/resource_check.py`: RESOURCE-004 DataSet close 检测增强，新增 try-with-resources 例外规则。
+- `scripts/lint/api_check.py`: API 校验增强——链式调用识别、return_type 解析、多重载匹配。
+- `scripts/lint/style_check.py`: 新增 STYLE-022（魔法数字）、STYLE-023（过长方法）、STYLE-024（深层嵌套）规则。
+- `scripts/lint/hal_check.py`: 幻觉检测微调。
+- `scripts/lint/verify_check.py`: 验证检查微调。
+- `scripts/cosmic-post-check.py`: Gradle 编译成功后串联 post-lint 静态校验逻辑修正。
+- `scripts/cosmic-post-lint.py`: 检查器注册表同步更新。
+- `scripts/cosmic-api-knowledge.py` / `cosmic-form-metadata.py` / `cosmic-basedata-query.py`: epilog 精简。
+- `agents/openai.yaml`: prompt 同步更新。
+
+### Fixed
+- `SKILL.md` L42: `cheat-sheet.md` 路径补全为 `rules/cheat-sheet.md`。
+- `anti-patterns.md`: 4 个 A 层行缺失 SCENE-ID 标签，导致规则追溯链断裂（已补全）。
+- `OpPluginTemplate.java`: `@snippets` 引用指向不存在的文件 `silent-audit.java`（已移除）。
+- `README.md`: 排查脚本路径缺 `skills/ok-cosmic/scripts/` 前缀（已补全）。
+- `SKILL.md` L193: Gradle 校验行为描述不准确——原文"以编译结果为准"未反映编译后串联 post-lint 的实际行为（已修正）。
+
+### Removed
+- `WORKFLOW.html`: 旧版工作流可视化图（已废弃，功能由 `ok-cosmic-intro.html` 替代）。
+- `rules/plugin-dev-flow.md`: 插件开发流程内容已合并至 `SKILL.md` 线性执行流和 `decision-matrix.md`。
+- `rules/workflow.md`: 工作流规则内容已合并至 `decision-matrix.md` 和 `intent-routing.md`。
+
+## [1.1.5] - 2026-04-03
+
+### Added
+- `references/adv/event-lifecycle.md`: 插件事件生命周期图，涵盖表单/单据/列表/操作 4 类插件的事件时序与适用场景，辅助 AI 判断"逻辑应放在哪个生命周期"。
+- `rules/decision-matrix.md`: 决策矩阵从 SKILL.md 下沉为独立规则文件，保持主文档精简。
+- `rules/intent-routing.md`: 语义映射层路由——将用户自然语言意图映射到决策矩阵行，降低弱模型的路由错误率。
+- `scripts/cosmic-config-check.py`: Step 0 配置预检脚本，自动检测 `ok-cosmic.json`、API 连通性、知识库路径等环境依赖，输出 ERROR/WARNING 分级结果。
+
+### Changed
+- `SKILL.md`: 大幅精简主文档（230 行变更），决策矩阵与未命中兜底逻辑下沉到 `rules/decision-matrix.md`；Step 0 改为直接执行 `cosmic-config-check.py`；开发决策路径新增事件生命周期引导和 entityId 来源校验要求；最小确认卡新增 entityId 来源字段。
+- `scripts/cosmic-form-metadata.py`: `--fuzzy` 参数智能拆分（引号包裹自动按空格拆、正则模式保持原样）；新增三级降级机制（规范化 → 原始输入 → `re.escape` 纯文本）；fuzzy 关键词 ≥3 个时自动升级详情模式。
+- `scripts/config_loader.py`: 大幅扩展配置加载能力，支持更丰富的配置校验与路径解析。
+- `scripts/cosmic-api-knowledge.py`: 增强 cheat-sheet 和 API 搜索的 AI 可用性，优化元数据 API 查询优先级。
+- `scripts/cosmic-basedata-query.py`: 强化 entityId 来源校验，查询前必须确认标识来源为"用户明确给出"或"元数据脚本确认"。
+- `rules/cheat-sheet.md`: 增强 AI 可用性，优化高频 API 速查表结构。
+- `rules/coding-preferences.md`: 微调推荐项描述。
+- `setup/cuslib/kd-cd-cosmic-commons.jar`、`kd-cd-cosmic-features.jar`: 封装库更新。
+
+### Removed
+- `rules/script-failure-recovery.md`: 脚本失败恢复协议内容已合并至 `cosmic-config-check.py` 的输出与 `workflow.md` 中。
+
+## [1.1.4] - 2026-04-02
+
+### Added
+- `scripts/cosmic-post-check.py`: 代码生成后**统一检查入口**——Gradle 项目优先编译检查，非 Gradle 回退 `cosmic-post-lint.py` 静态校验；支持 `--fix-hint`、`--strict`、`--verbose` 诊断模式。
+- `scripts/lint/api_check.py`: 知识库驱动的 API 校验模块（`API-001` 方法不存在 / `API-002` 参数不匹配 / `API-003` 类无记录 / `API-004` @Override 覆写不存在），支持静态调用、实例调用、链式调用和方法覆写四种检测模式。
+- `rules/a-layer-rules.json`: A 层规则 ID 单一可信源，`cosmic-post-lint.py` 运行时动态加载，文档统一引用。
+- `rules/post-check.md`: 生成后校验规则文档（从 `post-lint.md` 演化），新增 Gradle 编译策略、A/B/C 层级映射表和历史项目解释口径。
+- `rules/script-failure-recovery.md`: 脚本失败恢复协议，覆盖配置异常、知识库损坏、网络超时、语法报错、API 查询无结果 5 种场景的降级策略。
+- `scripts/cosmic-basedata-query.py`: 基础资料单条查询脚本，支持编码/名称查询、本地 SQLite 10 分钟缓存和 `--full` / `--json` 输出。
+- `manifest.json`: 注册 `cosmic_post_check`（统一检查入口）和 `query_basedata_one`（基础资料查询）两个新工具。
+- `assets/snippets/form/HyperlinkJumpSample.java`: 超链接跳转代码片段（分录 + 列表场景）。
+
+### Changed
+- **规则体系重构为三层模型**：`SKILL.md` / `rules/constraints.md` / `rules/coding-preferences.md` / `rules/post-check.md` / `rules/workflow.md` 统一采用 `A 层硬约束 / B 层推荐项 / C 层治理项` 分层，明确区分新代码默认要求与历史代码治理方向。
+- `SKILL.md`: 统一决策矩阵（合并原快速决策矩阵与能力封装路由为 30 行单表）、新增路径解析协议（`<SKILL_ROOT>` / `<PROJECT_ROOT>`）、新增 Step 0 配置预检、新增写码前最小确认卡、"最短决策路径"重命名为"开发决策路径"、子文件引用去重。
+- `references/*.md`: 全部 41 篇参考文档新增 `TL;DR` 摘要头（适用场景、先抓重点、跳转指引、何时展开全文），降低 AI 认知负荷。
+- `rules/anti-patterns.md`: 每条规则标注 `[A层]` / `[B层]` 层级，可扫描坏味道表新增"层级"列并关联具体 lint rule ID，引用 `a-layer-rules.json` 保持一致。
+- `scripts/cosmic-post-lint.py`: A 层规则 ID 改为从 `rules/a-layer-rules.json` 动态加载（移除硬编码），lint 报告新增 `A/B/C` 层级标签。
+- `scripts/lint/base.py`: 新增 `classify_lines()` 状态机，正确处理跨行 `/* */` 块注释、行内块注释 + 尾部代码、javadoc 续行和空行。
+- `scripts/lint/api_check.py`: 知识库路径改为通过 `config_loader.py` 从 `ok-cosmic.json` 的 `graph.dbPath` 读取，移除硬编码路径。
+- `agents/openai.yaml`: `default_prompt` 更新为完整 6 步决策流程（含 `cosmic-post-check.py` 校验步骤）。
+- `README.md`: 新增"规则分层与校验"章节，补充默认 `post-check` 流程与 `--strict` 治理模式说明。
+- `scripts/cosmic-form-metadata.py`: 新增 `--sql` 模式（提供底层表名与列名映射）。
+- `scripts/lint/verify_check.py`: 来源说明改为 C 层治理项，避免与 A 层硬约束混淆。
+- `assets/snippets/README.md` → `assets/snippets/snippets-guide.md`: 重命名以区分项目 README。
+- 多个模板文件（`BillPlugInTemplate`、`FormPluginTemplate`、`ListPluginTemplate`、`ReportFormPluginTemplate` 等）代码规范性优化。
+
+### Fixed
+- `scripts/lint/scene_check.py` / `scripts/lint/base.py`: 修复混合文件中按整文件识别插件类型导致的 `SCENE-001/002` 误报，改为按类分析插件上下文。
+- `scripts/lint/style_check.py`: 修复 `STYLE-006` 因字符串字面量被预处理而无法命中的问题。
+- `scripts/lint/resource_check.py`: 修复多资源 `try-with-resources` 场景下 `RESOURCE-004` 的误报。
+- `assets/snippets/query/DataSetQueryStatSample.java`: 修复真实的 `DataSet` 生命周期问题，使 `assets/` 在 `ERROR` 级别校验下通过。
+
+### Removed
+- `rules/post-lint.md`: 已演化为 `rules/post-check.md`，旧文件删除。
+
+## [1.1.3] - 2026-04-01
+
+### Changed
+- `scripts/config_loader.py` 及 `ok-cosmic.json`: 彻底废弃内部目录探测和环境变量兜底配置，强制限定必须明确指定 `ok-cosmic.json` (若不传 `--config` 则仅具备兜底读取当前执行目录的唯一退路)，配置参数 `dbPath` 现严格要求配置囊括文件名的全路径。
+- `SKILL.md` / `workflow.md`: 同步修正文档使用约束，声明 `--config` 配置为强制/显式必备参数。
+- `scripts/cosmic-form-metadata.py`: 重构了元数据字段下推的过滤策略。彻底移除对 `org`, `creator` 等基础审计及系统字段的代码级强杀过滤，实现全量、无死角满血展示，避免部分普通业务字段被误杀。
+- `rules/coding-preferences.md`: 修正大模型系统开发级元数据约束指南，明确宣告所有表单字段均为自动无条件展示状态。
+- `scripts/cosmic-form-metadata.py`: 引入全新的多条件过滤匹配打分（Match Scoring）引擎。在模糊检索模式下（`--fuzzy`），会以匹配权重（精确 > 前缀 > 子串 > 类型）自动为开发者将相关度最高的目标悬浮至输出表格最顶部。
+- `scripts/cosmic-form-metadata.py`: 优化重排元数据终端命令行表格的阅读视野。精准移除了重复冗余的"绑定路径"列，新引入具备智能溯源特性的"所属实体"树层级回显列（形如：`子表体 (表体key -> 子表体key)`），并为其引入实用的"附加信息(Ext)"列以展开枚举与基础资料项。
+- `scripts/cosmic-form-metadata.py`: 全面兼容部分基础元数据响应无 `formName` 造成的读取崩溃异常（`单据: None`），新增名称读取的健壮性容错保护。
+## [1.1.2] - 2026-04-01
+
+### Added
+- `rules/platform-baseline.md`: 新增苍穹平台总规范摘要（命名 / 设计器与 PDM / 数据库 / 多语言 / 微服务 / 日志异常 6 大基线）
+- `assets/snippets/README.md`: 新增 snippets 分层说明文档，明确"推荐写法 / 原生兜底"两层选择规则
+- `assets/snippets/data/DynamicObjectCrudSample.java`: 新增后端建单 / 保存 / 查询 / 复制代码片段
+- `assets/snippets/form/ViewControlOpsSample.java`: 新增页面状态 / 锁定 / 可见 / 刷新 / 关闭 / pageCache 代码片段
+- `assets/snippets/operation/OperationOptionBridgeSample.java`: 新增操作参数传递 / OperateOption / 操作提示代码片段
+- `assets/snippets/query/BatchQuerySample.java`: 新增批量查询 / 分组映射 / 批量反写 / 最近值恢复代码片段
+- `rules/workflow.md`: 新增"开发前规范预检"与"事件与阶段自检"两个检查清单
+- `style_check.py`: 新增 STYLE-010 ~ STYLE-017 共 8 条校验规则（allFields 滥用、SQL 拼接、方言 SQL、中文拼接、循环 updateView、循环查库 N+1、循环 Redis、query 结果误当实体更新）
+
+### Changed
+- snippets 体系拆分为"第一层：推荐写法"和"第二层：原生兜底"两层，SKILL.md 映射表同步调整
+- 大量 snippet 样例优化增强（GetAndSetValue / EntryRowCalculate / ConfirmDialog / BeforeOperationConfirm / F7Filter / OpenBillModal / ReturnParentData / TreeControl / ListPluginBasic / OpAddValidators / ScheduleTask 等）
+- `SKILL.md`: 规则清单新增 `platform-baseline.md` 链接，snippets 映射表改为双层结构
+- `rules/anti-patterns.md`: 补充 BigDecimal 精度相关反模式规则
+- `rules/coding-preferences.md`: 新增 BigDecimalUtils 相关编码偏好
+- `rules/constraints.md`: 补充更多强制约束条目
+- `scripts/lint/base.py`: 增强基础 lint 框架（循环上下文检测、查询结果变量追踪）
+- `scripts/lint/scene_check.py`: 增强场景错配检测逻辑
+- `scripts/lint/resource_check.py`: 优化资源管理检查规则
+- `setup/cuslib/kd-cd-cosmic-commons.jar`: 更新到最新版本（含 BigDecimalUtils）
+- `setup/cuslib/kd-cd-cosmic-features.jar`: 更新到最新版本
+
+### Fixed
+- 混淆导致的 API 注册问题：`kd-cd-cosmic-commons.jar` 和 `kd-cd-cosmic-features.jar` 修正混淆配置，确保服务注册不被混淆干扰
+- `BigDecimalUtils` 示例优化：修正示例代码中的精度与用法
+- `anti-patterns.md`: 修复文件末尾缺少换行符问题
+- `SKILL.md`: 修复文件末尾缺少换行符问题
+
+## [1.1.1] - 2026-03-30
+
+### Added
+- `manifest.json`: 注册 `cosmic_search_methods` 工具，支持全局方法检索
+- `README.md`: 增加更清晰的发布页结构，包括概览、核心能力、最短路径与安装说明
+
+### Changed
+- `README.md`: 将安装向导内容重组为正式 README，并补充多 Agent 安装方式
+- `README.md`: 修正文档结构、步骤编号与知识库验证说明，提升可读性
+- `skills/ok-cosmic/setup/ok-cosmic-docs.db`: 更新为最新构建产物
+- `build-doc-db.sh`: 构建完成后切换为 `journal_mode=DELETE` 并执行 `VACUUM`
+
+### Fixed
+- Windows 兼容性：`setup-windows.bat` 使用 UTF-8 BOM，降低中文乱码概率
+- 包体积：docs 库重新压实并同步到发布包，发布包重新打包为当前版本
+- 目录一致性：发布文档、模板命名与安装说明进一步对齐
+
+## [1.1.0] - 2026-03-28
+
+### Added
+- `scripts/config_loader.py`: 统一配置加载模块，两个脚本共用
+- SKILL.md: 新增场景化 snippets 映射表（18 个 snippet 全覆盖）
+- SKILL.md: 决策矩阵拆分左树右表为单据/基础资料两种模板
+- manifest.json: 补充 `assets/snippets/` 声明
+- CHANGELOG.md: 新增版本变更记录
+- references/adv/*.md: 每篇文档新增"适用边界"段落
+- `README.md`: 新增概览、核心能力、快速开始与安装、安装 Skill 章节
+- `README.md`: 新增多 Agent 软链接/目录联接安装示例（macOS/Linux/Windows）
+- `scripts/cosmic-api-knowledge.py`: 新增 `detail --compact` 模式
+- `scripts/cosmic-api-knowledge.py`: 增强详情输出，支持参数说明、返回说明结构化展示
+- `scripts/cosmic-form-metadata.py` / `scripts/cosmic-api-knowledge.py`: 新增脚本头部用途/边界说明
+- `ok-cosmic-knowledge`: 增强参数名回填、`@param` 保留、父类/接口方法注释下沉
+- `skills/ok-cosmic/setup/ok-cosmic-docs.db`: 更新为最新文档库构建产物
+- `scripts/cosmic-post-lint.py`: 代码生成后自动校验入口（17→32 规则）
+- `scripts/lint/hal_check.py`: 幻觉方法名（10 条 ERROR）+ 幻觉类名（5 条 ERROR）检查
+- `scripts/lint/scene_check.py`: 场景错配检查（5 条 WARNING）
+- `scripts/lint/style_check.py`: 编码偏好检查（7 条 WARNING/INFO）
+- `scripts/lint/resource_check.py`: 资源管理检查（2 条 WARNING）
+- `scripts/lint/verify_check.py`: 验证注释检查（1 条 INFO，仅 --strict）
+- `rules/post-lint.md`: 校验流程、级别策略、修复示例、重试上限
+- `manifest.json`: 注册 `cosmic_post_lint` 工具
+- `.gitignore`: 排除 `.DS_Store` 和 `__pycache__`
+
+### Changed
+- `cosmic-api-knowledge.py`: 改用 `config_loader.load_project_config`，移除内联实现
+- `cosmic-form-metadata.py`: 改用 `config_loader.load_project_config`，移除内联实现
+- `cosmic-form-metadata.py`: `FormMetadata.__init__` 使用 `__config_dir__` 解析相对路径
+- `cosmic-form-metadata.py`: 裸 `except` 修复为 `except Exception`，SSL 可通过配置关闭
+- `cosmic-api-knowledge.py`: `ApiGraph._get_conn()` 新增连接缓存，避免重复创建
+- `README.md`: 调整章节结构、修复知识库构建代码块、统一项目配置与安装路径说明
+- `SKILL.md`: 快速决策矩阵中的模板文件改为直链，并同步新增 `--compact` 用法说明
+- `assets/`: 模板文件名移除 `Abstract` 前缀，模板类名与文件名统一
+- `setup-windows.bat`: 转为 UTF-8 BOM，降低 Windows `cmd` 中文乱码概率
+- `build-doc-db.sh`: 构建完成后切换 `journal_mode=DELETE` 并执行 `VACUUM`
+- `ok-cosmic-knowledge/pom.xml`: shade 打包时仅保留 mac Intel/mac Apple Silicon/Windows x64/Windows Arm64 的 sqlite-jdbc native 库
+- `setup-mac.sh`: 新增 Java 命令前置检查
+- `cheat-sheet.md`: 各 section 添加 `[表单]` `[操作]` 等场景标签
+- `workflow.md`: `--config` 从"强制"改为"推荐"，匹配自动搜索能力
+- `coding-preferences.md`: 修正元数据截断行数 50→120
+- `plugin-dev-flow.md`: 移除不存在的外部路径引用
+- `agents/openai.yaml`: 丰富 default_prompt 为完整决策流程
+- `references/base/plugin/*.md`: 14 篇文档全部新增"适用边界"块
+- `SKILL.md`: 最短决策路径新增第 6 步（post-lint 校验）
+- `SKILL.md`: 底部新增「代码生成后自动校验」完整说明
+- `rules/plugin-dev-flow.md`: 新增第 8 步（自动校验）
+- `agents/openai.yaml`: prompt 补充 post-lint 第 6 步
+
+### Fixed
+- 两个脚本的 `load_project_config` 搜索策略不一致（已统一）
+- `FormMetadata` 相对路径解析与 `ApiGraph` 行为不一致（已对齐）
+- `cosmic-api-knowledge.py`: `search-method` 排序和输出降噪，优先展示强相关方法
+- `cosmic-api-knowledge.py`: `detail` 输出去除重复字段，降低 token 噪音
+- `ok-cosmic-docs.db`: 保留 `@param/@return` 说明，修复部分方法注释截断问题
+- `ok-cosmic-knowledge.db`: 修复部分 `arg0/arg1` 参数名未从 docs 回填的问题
+- `setup-mac.sh`: 修正不存在的 `build.sh` 引用
+- `README.md`: 移除已废弃的 `-docthreads` 参数
+- `README.md`: 第 5 步验证命令改用项目根目录 `ok-cosmic.json`
+- `Main.java`: 移除未使用的 `docThreads` 变量及 CLI 解析
+- `cosmic-form-metadata.py`: 修复最后一处裸 `except`
+- 清理 4 个 `.DS_Store` 文件
+
+## [1.0.0] - 初始版本
+
+- 完整的插件模板体系（15 个模板）
+- 离线 API 知识图谱查询
+- 表单元数据在线查询与本地缓存
+- 规则约束与反模式清单
+- 场景化代码片段