金蝶二次开发技能#

产品线识别#

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

关键词产品技术栈参考星空、K3 Cloud、K/3 Cloud、BOS IDE、C#插件、K3Cloud金蝶云星空C# / .NET / SQL Server / IISreferences/xingkong-plugin-dev.md苍穹、Cosmic、AI苍穹、低代码、KingScript、Java插件金蝶云苍穹Java / Spring Cloud / PostgreSQLreferences/cangqiong-dev.md

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

需求决策树#

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

1. 识别需求类型#

用户说处理方向推荐文档"界面按钮点击/字段联动/表单加载后控制"星空表单插件references/xingkong-plugin-dev.md §表单插件"列表过滤/行着色/批量操作"星空列表插件references/xingkong-plugin-dev.md §列表插件"保存前校验/提交前校验/审核后处理"星空操作插件references/xingkong-plugin-dev.md §操作插件"下推时改字段/转单逻辑"星空单据转换插件references/xingkong-plugin-dev.md §单据转换插件"自定义报表/账表"星空报表插件references/xingkong-plugin-dev.md §报表插件"自定义接口/定时任务/后台服务"星空服务插件references/xingkong-plugin-dev.md §服务插件"审批人动态设置/审批流扩展/跳过审批"星空审批流插件references/workflow-plugin-dev.md"多组织/数据权限/字段权限"星空多组织与权限references/multi-org-security.md"慢/卡/大数据量/性能优化"星空性能优化references/performance-debugging.md"查表/SQL/上下游关联"星空数据库参考references/database-reference.md"部署/打包/调试/运维"星空部署运维references/deployment-ops.md"第三方系统对接/外部接口"星空WebAPIreferences/xingkong-webapi.md"BOS建模/字段扩展/菜单发布"BOS IDE 操作references/xingkong-bos-ide.md"苍穹表单/操作/列表/报表/Java"苍穹开发references/cangqiong-dev.md

2. 星空开发完整流程#

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

插件选择矩阵（星空）#

需求场景插件类型基类参考单据界面交互（按钮点击、字段变更、数据联动）表单插件AbstractFormPlugin``references/xingkong-plugin-dev.md §表单插件列表界面过滤、工具栏操作、行着色列表插件AbstractListPlugin``references/xingkong-plugin-dev.md §列表插件保存/提交/审核/反审核时校验或干预操作插件AbstractOperationServicePlugIn``references/xingkong-plugin-dev.md §操作插件报表数据查询与展示报表插件AbstractSysReportServicePlugIn``references/xingkong-plugin-dev.md §报表插件下推转单时干预转换逻辑单据转换插件AbstractConvertPlugIn``references/xingkong-plugin-dev.md §单据转换插件自定义WebAPI / 定时任务 / 后台服务服务插件AbstractServiceHandler / IScheduleService``references/xingkong-plugin-dev.md §服务插件审批流节点控制、动态审批人审批流插件AbstractWorkflowPlugin``references/workflow-plugin-dev.md

核心参考文件#

文件内容何时读取references/xingkong-plugin-dev.md星空6大类插件完整开发指南星空插件开发需求references/plugin-templates.md各类插件完整代码模板 + 复杂案例编码阶段直接套用references/workflow-plugin-dev.md审批流插件开发与节点控制审批流扩展需求references/multi-org-security.md多组织、权限、SQL安全多组织/权限相关需求references/performance-debugging.md性能优化、日志分析、死锁排查性能问题/调试排错references/xingkong-bos-ide.mdBOS IDE 操作手册需要BOS建模/配置时references/xingkong-webapi.mdWebAPI 接口开发第三方对接需求references/database-reference.md数据库核心表/SQL/多语言/LK表写SQL/查数据时references/cangqiong-dev.md苍穹二次开发苍穹相关需求references/common-patterns.md常见开发模式 + 社区FAQ遇到典型问题/报错时references/deployment-ops.md打包部署/调试/运维部署阶段

编码规范#

• 命名：插件类名 = {业务对象}{功能}PlugIn，如 SaleOrderValidatePlugIn
• 防御式编程：所有字段取值都做空判断，避免 NullReferenceException
• 多语言：涉及中文名称的字段必须关联 _L 表， FLOCALEID=2052
• 上下游关联：使用 _LK 关联表， FSID → 上游明细 FENTRYID
• SQL安全：所有 SQL 查询使用参数化，禁止字符串拼接用户输入
• 性能：操作插件在 OnPreparePropertys 中只声明必要字段，避免全量加载
• 单据操作：系统自带单据先"扩展"再修改，修改前必须"签出"，改完"保存→签入→发布"
• 异常处理：表单插件使用 try-catch；操作插件异常会阻止单据操作，需谨慎使用
• 日志：关键节点写日志，便于生产排查

版本兼容性#

星空不同版本的 BOS API 可能存在差异。开发时需注意：

• 从对应版本 K3Cloud\WebSite\bin 目录复制引用 DLL
• 升级后重新编译并注册所有自定义插件
• 公有云与私有云的部分 API 行为可能不同

官方资源索引#

资源链接星空知识地图https://vip.kingdee.com/article/392699482837824512星空社区https://vip.kingdee.com/search?productId=1&productLineId=1星空环境下载https://open.kingdee.com/K3Cloud/Open/Products.aspx星空开发入门视频https://vip.kingdee.com/school/learnPath/193463482326019584WebAPI接口说明书https://vip.kingdee.com/knowledge/2569苍穹开发者门户https://dev.kingdee.com/dev苍穹开发文档https://demo.kdcloud.com/devdoc/wf苍穹开发认证https://kone.kingdee.com/certcenter星空开放平台https://open.kingdee.com/k3cloud/open/home