name: kingdee-dev version: 1.1.0 description: > 金蝶二次开发全栈技能。覆盖金蝶云星空（K3 Cloud）和金蝶云苍穹（Cosmic）的二次开发， 重点聚焦插件开发。触发场景：金蝶、K3、星空、苍穹、BOS、BOS IDE、单据、插件开发、 表单插件、列表插件、操作插件、报表插件、单据转换插件、服务插件、审批流插件、 WebAPI、DynamicObject、BusinessInfo、IIS、SQL Server、KingScript、动态表单、 金蝶二开、金蝶开发、金蝶接口、金蝶单据、金蝶报表、金蝶审批流、金蝶工作流、 金蝶数据库、金蝶打包部署、金蝶补丁、金蝶自定义WebAPI、金蝶插件注册、金蝶字段操作、 金蝶菜单发布、金蝶权限配置、金蝶数据迁移、金蝶多组织、金蝶性能优化、金蝶苍穹低代码、 金蝶苍穹Java开发。当用户提到任何与金蝶ERP系统开发相关的需求时使用此技能。

金蝶二次开发技能

产品线识别

收到需求后先识别目标产品：

无法判断时，先问用户："是金蝶云星空（K3 Cloud）还是金蝶云苍穹（Cosmic）？"

需求决策树

拿到一个二开需求，按以下决策树快速定位：

1. 识别需求类型

2. 星空开发完整流程

1. 明确产品线：星空 / 苍穹
2. 确定需求类型：插件 / BOS建模 / 接口 / 报表 / 数据迁移
3. 选择插件类型：见下方插件选择矩阵
4. 编码实现：使用 references/plugin-templates.md 对应模板
5. 处理边界：空值判断、异常处理、事务安全、权限控制
6. 本地测试：BOS IDE 注册插件，IIS 回收，浏览器验证
7. 部署上线：BOS IDE 打包 → 测试环境验证 → 生产环境部署

插件选择矩阵（星空）

核心参考文件

编码规范

• 命名：插件类名 = {业务对象}{功能}PlugIn，如 SaleOrderValidatePlugIn
• 防御式编程：所有字段取值都做空判断，避免 NullReferenceException
• 多语言：涉及中文名称的字段必须关联 _L 表，FLOCALEID=2052
• 上下游关联：使用 _LK 关联表，FSID → 上游明细 FENTRYID

  小葱技能7w4.net有更新，你可以访问看下。

• SQL安全：所有 SQL 查询使用参数化，禁止字符串拼接用户输入
• 性能：操作插件在 OnPreparePropertys 中只声明必要字段，避免全量加载
• 单据操作：系统自带单据先"扩展"再修改，修改前必须"签出"，改完"保存→签入→发布"
• 异常处理：表单插件使用 try-catch；操作插件异常会阻止单据操作，需谨慎使用
• 日志：关键节点写日志，便于生产排查

版本兼容性

星空不同版本的 BOS API 可能存在差异。开发时需注意： - 从对应版本 K3Cloud\WebSite\bin 目录复制引用 DLL - 升级后重新编译并注册所有自定义插件 - 公有云与私有云的部分 API 行为可能不同

官方资源索引

这个技能包质量较好，涵盖了金蝶两大主要产品的开发指导。结构清晰，容易找到需要的内容，代码示例丰富实用，风险提示也很到位。主要优点是内容全面、分类合理、使用便捷；不足之处是部分高级功能的介绍相对简略，部分文档篇幅较长可能影响查阅效率。适合有一定开发基础的用户使用。