kcode-pi 0.1.0

package/knowledge/cangqiong/product-notes.md

@@ -0,0 +1,15 @@
+# Cangqiong Product Notes
+
+Cangqiong is a Cosmic-family product. Load Cosmic platform knowledge first, then apply Cangqiong-specific project or version details.
+
+## Default Stack
+
+- Platform: Cosmic.
+- Language: Java.
+- Main concerns: plugin lifecycle, metadata verification, SDK signature verification, KSQL safety, post-check loop.
+
+## Harness Rules
+
+- Do not use enterprise C# namespaces or lifecycle assumptions.
+- Treat form, bill, list, operation, conversion, report, workflow, task, and OpenAPI scenes through the Cosmic plugin decision matrix.
+- Verify fields and enum values through metadata before generating code.

package/knowledge/common/business-flows.md

@@ -0,0 +1,115 @@
+# 金蝶业务流程指南
+
+## 采购管理流程
+
+### 采购订单流程
+
+采购订单是采购管理的核心单据，贯穿从请购到付款的全流程。
+
+**标准流程：**
+1. 采购申请 → 2. 采购订单 → 3. 收料通知 → 4. 采购入库 → 5. 采购发票 → 6. 付款单
+
+**关键字段：**
+- FBILLNO：单据编号（自动生成）
+- FDATE：单据日期
+- FDOCUMENTSTATUS：单据状态（A=暂存, B=已提交, C=已审核）
+- FCANCELSTATUS：作废状态（A=正常, B=作废）
+- FSUPPLIERID：供应商ID
+- FCURRENCYID：币种
+- FEXCHANGERATE：汇率
+
+**常用表：**
+- T_PUR_POORDER：采购订单主表
+- T_PUR_POORDERENTRY：采购订单明细表
+- T_PUR_MRB：收料通知主表
+- T_PUR_MRBBILL：收料通知明细
+- T_PUR_ICSTOCKIN：采购入库主表
+
+### 采购退货流程
+
+**标准流程：**
+1. 采购退货申请 → 2. 采购退料通知 → 3. 采购退料出库
+
+**关键业务规则：**
+- 退货必须关联原入库单
+- 退货数量不能超过入库数量
+- 退货需要审核流程
+
+---
+
+## 销售管理流程
+
+### 销售订单流程
+
+**标准流程：**
+1. 销售报价 → 2. 销售订单 → 3. 发货通知 → 4. 销售出库 → 5. 销售发票 → 6. 收款单
+
+**关键字段：**
+- FBILLNO：单据编号
+- FDATE：单据日期
+- FCUSTID：客户ID
+- FSALEORGID：销售组织
+- FSETTLECURRID：结算币种
+
+**常用表：**
+- T_SAL_ORDER：销售订单主表
+- T_SAL_ORDERENTRY：销售订单明细表
+- T_SAL_DELIVERYNOTICE：发货通知主表
+- T_SAL_OUTBOUND：销售出库主表
+
+### 销售退货流程
+
+**标准流程：**
+1. 销售退货申请 → 2. 销售退料通知 → 3. 销售退料入库
+
+---
+
+## 库存管理流程
+
+### 库存盘点流程
+
+**标准流程：**
+1. 新建盘点方案 → 2. 生成盘点表 → 3. 录入盘点结果 → 4. 盘点差异处理 → 5. 盘点报告
+
+**关键表：**
+- T_STK_INVENTORY：库存余额表
+- T_STK_STOCK：仓库表
+- T_STK_CHECKBILL：盘点表主表
+- T_STK_CHECKBILLENTRY：盘点表明细
+
+### 库存调拨流程
+
+**标准流程：**
+1. 调拨申请 → 2. 调拨单 → 3. 调拨出库 → 4. 调拨入库
+
+---
+
+## 生产管理流程
+
+### 生产订单流程
+
+**标准流程：**
+1. 生产计划 → 2. 生产订单 → 3. 领料单 → 4. 完工报告 → 5. 产品入库
+
+**关键表：**
+- T_PRD_MO：生产订单主表
+- T_PRD_MOENTRY：生产订单明细表
+- T_PRD_PPBOM：生产领料主表
+
+---
+
+## 财务管理流程
+
+### 应收应付流程
+
+**应收流程：**
+销售发票 → 应收单 → 收款单 → 核销
+
+**应付流程：**
+采购发票 → 应付单 → 付款单 → 核销
+
+**关键表：**
+- T_AR_RECEIVABLE：应收单
+- T_AP_PAYABLE：应付单
+- T_AR_RECEIPT：收款单
+- T_AP_PAYMENT：付款单

package/knowledge/common/config-guides.md

@@ -0,0 +1,110 @@
+# 金蝶通用配置指南
+
+## 组织架构配置
+
+### 组织类型
+
+金蝶云星空支持多种组织类型：
+- **法人公司**：独立法人实体
+- **核算组织**：财务核算主体
+- **库存组织**：仓库管理单位
+- **销售组织**：销售业务单位
+- **采购组织**：采购业务单位
+
+### 组织配置要点
+
+1. **组织层级**：支持多层级组织架构
+2. **组织权限**：每个用户可访问多个组织
+3. **数据隔离**：不同组织数据默认隔离
+
+---
+
+## 编码规则配置
+
+### 编码规则类型
+
+- **自动编号**：系统自动生成（推荐）
+- **手动编号**：用户手动输入
+- **外部编号**：从外部系统导入
+
+### 配置步骤
+
+1. 进入【系统管理】→【编码规则】
+2. 选择单据类型
+3. 设置编码前缀、位数、流水号
+4. 设置是否允许修改
+
+---
+
+## 工作流配置
+
+### 审批流程配置
+
+**基本流程：**
+1. 创建审批流 → 2. 设置审批节点 → 3. 配置审批人 → 4. 设置条件分支
+
+**审批类型：**
+- **会签**：所有审批人都需审批
+- **或签**：任一审批人审批即可
+- **依次审批**：按顺序逐级审批
+
+### 消息通知配置
+
+- 站内消息
+- 邮件通知
+- 短信通知（需配置短信网关）
+
+---
+
+## 打印配置
+
+### 打印模板
+
+- **表头**：公司名称、单据标题
+- **表体**：明细数据表格
+- **表脚**：签名栏、备注
+
+### 配置步骤
+
+1. 进入【系统管理】→【打印管理】
+2. 选择单据类型
+3. 设计打印模板
+4. 设置默认打印机
+
+---
+
+## 权限配置
+
+### 权限体系
+
+- **功能权限**：控制菜单访问
+- **数据权限**：控制数据范围
+- **字段权限**：控制字段可见性
+- **操作权限**：控制按钮可用性
+
+### 角色配置
+
+1. 创建角色
+2. 分配功能权限
+3. 设置数据权限
+4. 分配用户到角色
+
+---
+
+## 基础资料配置
+
+### 必配基础资料
+
+- **币种**：人民币、美元等
+- **计量单位**：个、箱、吨等
+- **仓库**：实体仓库、虚拟仓库
+- **客户/供应商**：业务伙伴信息
+- **物料**：产品/原材料信息
+
+### 物料配置要点
+
+- **物料编码**：唯一标识
+- **物料名称**：显示名称
+- **计量单位**：基本单位、辅助单位
+- **物料分组**：分类管理
+- **计价方法**：先进先出、加权平均等

package/knowledge/common/error-patterns.md

@@ -0,0 +1,170 @@
+# 金蝶常见错误与解决方案
+
+## 数据库相关错误
+
+### SQL 执行超时
+
+**错误信息：**
+```
+Timeout expired. The timeout period elapsed prior to completion of the operation
+```
+
+**可能原因：**
+1. SQL 查询数据量过大
+2. 缺少索引
+3. 数据库服务器负载过高
+
+**解决方案：**
+1. 添加 WHERE 条件限制数据量
+2. 检查并优化索引
+3. 使用 TOP 限制返回行数
+4. 避免 SELECT *，只查询需要的字段
+
+### 死锁错误
+
+**错误信息：**
+```
+Transaction (Process ID XX) was deadlocked on lock resources with another process
+```
+
+**解决方案：**
+1. 减少事务持有时间
+2. 按固定顺序访问表
+3. 使用较低的事务隔离级别
+4. 避免在事务中进行用户交互
+
+---
+
+## 插件相关错误
+
+### 插件加载失败
+
+**错误信息：**
+```
+未能加载文件或程序集 'XXX.dll' 或它的某一个依赖项
+```
+
+**可能原因：**
+1. DLL 文件不存在
+2. 版本不匹配
+3. 依赖项缺失
+
+**解决方案：**
+1. 检查 DLL 文件是否在正确目录
+2. 确认引用版本与运行时版本一致
+3. 使用 Fusion Log Viewer 查看绑定失败详情
+
+### 插件执行异常
+
+**错误信息：**
+```
+Object reference not set to an instance of an object
+```
+
+**常见原因：**
+1. 未检查 null 值
+2. 数据实体字段不存在
+3. 上下文对象未初始化
+
+**代码示例（正确做法）：**
+```csharp
+// 企业版 C#
+var value = dataEntity["FQty"];
+if (value != null)
+{
+    var qty = Convert.ToDecimal(value);
+}
+```
+
+```java
+// 旗舰版 Java
+Object value = dataEntity.get("qty");
+if (value != null) {
+    BigDecimal qty = new BigDecimal(value.toString());
+}
+```
+
+---
+
+## 配置相关错误
+
+### 登录失败
+
+**错误信息：**
+```
+登录失败，用户名或密码错误
+```
+
+**解决方案：**
+1. 检查用户名密码是否正确
+2. 确认用户未被禁用
+3. 检查数据库连接配置
+
+### 许可证过期
+
+**错误信息：**
+```
+系统许可证已过期，请联系管理员
+```
+
+**解决方案：**
+1. 联系金蝶客服续期
+2. 导入新的许可证文件
+
+---
+
+## 业务逻辑错误
+
+### 单据状态不允许操作
+
+**错误信息：**
+```
+当前单据状态不允许此操作
+```
+
+**常见场景：**
+- 已审核单据不能修改
+- 已关闭单据不能删除
+- 暂存单据不能提交
+
+**解决方案：**
+1. 检查单据当前状态
+2. 确认操作是否符合业务流程
+3. 必要时先反审核再操作
+
+### 库存不足
+
+**错误信息：**
+```
+库存不足，当前可用库存为 X
+```
+
+**解决方案：**
+1. 检查库存数据是否准确
+2. 确认是否允许负库存
+3. 调整出库数量
+
+---
+
+## 性能相关问题
+
+### 页面加载缓慢
+
+**可能原因：**
+1. 基础数据量过大
+2. 网络延迟
+3. 服务器资源不足
+
+**优化建议：**
+1. 使用分页加载
+2. 启用缓存
+3. 优化数据库查询
+4. 增加服务器资源
+
+### 报表生成超时
+
+**优化建议：**
+1. 减少数据范围
+2. 使用预计算
+3. 异步生成报表
+4. 优化 SQL 查询

package/knowledge/common/implementation.md

@@ -0,0 +1,144 @@
+# 金蝶实施方法论
+
+## 实施阶段划分
+
+### 第一阶段：项目准备
+
+**关键活动：**
+1. 项目启动会
+2. 组建项目团队
+3. 制定项目计划
+4. 确认项目范围
+
+**交付物：**
+- 项目章程
+- 项目计划
+- 需求调研问卷
+
+### 第二阶段：蓝图设计
+
+**关键活动：**
+1. 现状调研
+2. 需求分析
+3. 业务流程设计
+4. 解决方案设计
+
+**交付物：**
+- 业务蓝图文档
+- 解决方案文档
+- 数据迁移方案
+
+### 第三阶段：系统实现
+
+**关键活动：**
+1. 系统配置
+2. 二次开发
+3. 数据迁移
+4. 用户培训
+
+**交付物：**
+- 配置文档
+- 开发文档
+- 培训材料
+
+### 第四阶段：上线切换
+
+**关键活动：**
+1. 用户验收测试
+2. 数据初始化
+3. 系统切换
+4. 上线支持
+
+**交付物：**
+- 测试报告
+- 上线方案
+- 运维手册
+
+### 第五阶段：持续支持
+
+**关键活动：**
+1. 问题跟踪
+2. 优化建议
+3. 版本升级
+
+---
+
+## 需求分析方法
+
+### 需求收集技巧
+
+1. **访谈法**：与关键用户一对一访谈
+2. **问卷法**：大范围收集需求
+3. **观察法**：现场观察业务操作
+4. **研讨会**：集体讨论业务流程
+
+### 需求分类
+
+- **功能需求**：系统需要实现的功能
+- **非功能需求**：性能、安全、可用性
+- **约束条件**：技术限制、时间限制
+
+### 需求优先级
+
+- **P0（必须）**：核心业务流程
+- **P1（重要）**：重要但非核心
+- **P2（期望）**：锦上添花的功能
+
+---
+
+## 数据迁移策略
+
+### 迁移范围
+
+1. **基础数据**：客户、供应商、物料
+2. **期初数据**：库存余额、应收应付
+3. **历史数据**：历史单据（可选）
+
+### 迁移步骤
+
+1. 数据清洗
+2. 数据映射
+3. 试迁移
+4. 数据验证
+5. 正式迁移
+
+### 数据验证要点
+
+- 数据完整性检查
+- 数据一致性检查
+- 业务规则验证
+
+---
+
+## 用户培训计划
+
+### 培训对象
+
+- **关键用户**：深度培训，能处理日常问题
+- **最终用户**：操作培训，能完成日常业务
+- **系统管理员**：技术培训，能处理系统问题
+
+### 培训方式
+
+- 集中培训
+- 一对一辅导
+- 操作手册
+- 视频教程
+
+---
+
+## 风险管理
+
+### 常见风险
+
+1. **需求变更频繁**：建立变更控制流程
+2. **数据质量差**：提前进行数据清洗
+3. **用户抵触**：加强沟通和培训
+4. **技术难题**：预留技术攻关时间
+
+### 风险应对
+
+- **规避**：调整计划避免风险
+- **转移**：外包或购买保险
+- **缓解**：降低风险影响
+- **接受**：准备应急方案

package/knowledge/cosmic/hard-constraints.md

@@ -0,0 +1,38 @@
+# Cosmic Hard Constraints
+
+These are blocking constraints for Cosmic-family Java products: Cangqiong, Xinghan, and Xingkong Flagship.
+
+## No Hallucinated Facts
+
+- Do not invent API signatures, event methods, field keys, enum values, or entity IDs.
+- Do not use guessed methods such as `setReadOnly`, `afterCreateControl`, `IDataModel.setReadOnly`, `this.getView().refresh`, `model.getEntryCount`, `model.deleteRow`, `model.addRow`, or `QueryServiceHelper.queryAll`.
+- Do not invent generic helper classes such as `BillHelper`, `FormHelper`, `ListHelper`, `PluginHelper`, or `Cosmic*Helper` unless verified in the project or official API knowledge.
+
+## Lifecycle Boundaries
+
+- Do not register listeners or perform UI work in `initialize`.
+- Do not mutate data in `beforeBindData` or `afterBindData`.
+- Use view APIs for UI state and model APIs for data.
+- Operation plugins should operate on data packets and operation arguments, not UI view/model objects.
+
+## Metadata and Fields
+
+- Verify fields before code generation whenever a target form or bill is known.
+- Verify combo/drop-down option values from metadata; never guess status values.
+- Clone cached metadata before modification.
+- Do not access platform metadata tables directly from business code.
+
+## Data, Transaction, and Performance
+
+- Parameterize SQL/KSQL; do not concatenate untrusted conditions.
+- Close `DataSet` resources with try-with-resources.
+- Do not use a `DataSet` outside the transaction or resource scope that created it.
+- Mark rollback when catching exceptions inside explicit transaction blocks.
+- Avoid cross-database writes in one transaction.
+- Do not call DB, Redis, `ORM.create`, dispatch service, save, or `updateView` inside loops.
+
+## Logging and Exceptions
+
+- Use platform logging instead of `System.out` or `printStackTrace`.
+- Do not leave empty catch blocks.
+- Preserve original causes when wrapping exceptions.

package/knowledge/cosmic/ksql-datafix.md

@@ -0,0 +1,34 @@
+# Cosmic KSQL Data Fix
+
+Use for KSQL/SQL data repair in Cosmic-family products. This is not Java plugin generation.
+
+## Preconditions
+
+- Confirm product, environment, target bill/form/entity, operation type, target fields, conditions, and risk boundary.
+- Use Cosmic metadata capability to confirm table names, database names, DB keys, field names, field types, enum values, and base-data storage fields.
+- If metadata is unavailable and the user has not supplied verified metadata, stop and list pending confirmations.
+
+## Cross-Database Rules
+
+- Check whether all participating tables are in the same database.
+- Do not generate ordinary update SQL for cross-database scenarios.
+- For cross-database fixes, require explicit handling strategy such as temporary table, export/import, dblink, or postgres_fdw.
+
+## SQL Script Structure
+
+- Impact query.
+- Full table backup using a `bak_` table with timestamp.
+- Pre-update confirmation query.
+- Formal update statement.
+- Post-update verification query.
+- Rollback statement.
+- Field mapping section from verified metadata.
+
+## Safety Rules
+
+- Every update and delete must have a `WHERE` clause.
+- Write the matching query before the update.
+- Query and verification statements should not use `SELECT *`; full backup is the exception.
+- Default dialect is PostgreSQL unless the user specifies otherwise.
+- Prefer readable `IN` membership conditions unless `EXISTS` is required for semantics.
+- Run the official KSQL lint script when available and fix errors before delivery.

package/knowledge/cosmic/platform-baseline.md

@@ -0,0 +1,32 @@
+# Cosmic Platform Baseline
+
+Cosmic is the shared platform base for Cangqiong, Xinghan, and Xingkong Flagship. Treat these as Cosmic-family Java products unless a product-specific rule overrides the platform baseline.
+
+## Product Routing
+
+- Cangqiong, Xinghan, and Xingkong Flagship use the Cosmic Java plugin and SDK model.
+- Enterprise is not Cosmic-family; it uses a separate C# stack and must not receive Java plugin assumptions.
+- `cosmic` by itself means the platform/base layer, not a final business product selection.
+- Before coding, identify the concrete product, version, form/bill/entity, plugin type, lifecycle event, and target fields.
+
+## Development Flow
+
+- Run Cosmic configuration precheck before relying on official query scripts.
+- Use "wrapper first, native fallback": prefer project or official encapsulations when available; use native SDK only after checking references or query scripts.
+- Translate natural language into timing, carrier, and capability before choosing implementation type.
+- Generate code only after plugin type, event method, field metadata, enum values, and API signatures are verified.
+- After changing Cosmic Java code, run the official post-check flow when the official skill/scripts are available.
+
+## Required Verification
+
+- Field keys, Chinese field names, enum values, `refType`, and entity IDs must be verified through metadata before code generation.
+- API class names and method signatures must be verified unless covered by an approved cheat sheet.
+- Base data queries require a verified `entityId`; do not infer it from display names.
+- Query scripts can fail or run in cache-only mode; do not continue if the missing result is a prerequisite for the code.
+
+## Useful Official Skill Sources
+
+- `E:\projects\kingdee\skills\ok-cosmic-v4.0.0.zip`
+- `E:\projects\kingdee\skills\kingdee-cosmic-reviewer-v2.0.0.zip`
+- `E:\projects\kingdee\skills\cosmic-unittest-v2.0.0.zip`
+- `E:\projects\kingdee\skills\ok-ksql-v1.0.0.zip`

package/knowledge/cosmic/plugin-decision-matrix.md

@@ -0,0 +1,40 @@
+# Cosmic Plugin Decision Matrix
+
+Use this matrix for Cangqiong, Xinghan, and Xingkong Flagship.
+
+## UI and Form Plugins
+
+- Form UI, field linkage, control interaction: form plugin.
+- Bill UI, submit/audit button behavior, bill page logic: bill plugin.
+- List selection, batch operation entry points, list filters: list plugin.
+- Left-tree-right-table scenes: tree list plugin.
+- UI control state belongs to the view layer. Data read/write belongs to the model layer.
+- Register listeners in listener registration lifecycle, not in initialization.
+
+## Operation and Data Plugins
+
+- Save, audit, submit, status transition, validation, rollback: operation plugin or validator.
+- Operation plugins do not have UI context; do not call `getView()` from operation service plugins.
+- Declare required fields in operation preparation hooks before reading them in validators or operation plugins.
+- Modify the transaction data packet directly inside operation transaction hooks; do not call independent save APIs inside the same hook unless explicitly required and reviewed.
+
+## Conversion and Writeback
+
+- Push/downstream conversion/source tracing: convert plugin.
+- BOTP writeback stage: writeback plugin.
+- Verify source and target entity metadata before field mapping.
+
+## Backend and Integration
+
+- Scheduled jobs and background tasks: task plugin.
+- Workflow/approval flow hooks: workflow plugin.
+- External integration: OpenAPI controller or service layer, depending on entry point.
+- Reports and data analysis: report form plugin or report data plugin.
+
+## Data Access
+
+- Existence check: query an ID rather than loading a full data package.
+- Small field reads: use query APIs.
+- Full hierarchical package: load business data package.
+- Large data streams: use DataSet and close resources.
+- Batch load outside loops; avoid per-row service calls.