📦 金蝶云星空二次开发（Kingdee Cloud Starry Sky Secondary Development）

金蝶二次开发技能 产品线识别 收到需求后先识别目标产品： 关键词 产品 技术栈 参考 星空、K3 Cloud、K/3 Cloud、BOS IDE、C#插件 金蝶云星空 C# / .NET / SQL Server / IIS references/xingkong-plugin-dev.md 苍穹、Cosmic、AI苍穹、低代码、KingScript 金蝶云苍穹 Java / Spring Cloud / PostgreSQL references/cangqiong-dev.md 无法判断时，问用户。

需求分析流程 拿到一个二开需求，按以下步骤拆解： 明确产品线 → 星空 or 苍穹 需求分类 → 属于哪类开发： 插件开发（重点）：表单交互 / 列表过滤 / 操作校验 / 报表数据 / 单据转换 / 服务扩展 BOS建模：新建或扩展单据、字段、菜单 接口开发：WebAPI 对接第三方系统 报表开发：直接SQL账表 / 简单账表 数据层：SQL查询 / 数据迁移 选择插件类型 → 见下方插件选择矩阵 编码 → 使用 references/plugin-templates.md 中对应模板 测试调试 → 参 references/deployment-ops.md 打包部署 → 参 references/deployment-ops.md

插件选择矩阵（星空） 需求场景 插件类型 基类 参考 单据界面交互（按钮点击、字段变更、数据联动） 表单插件 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 / 定时任务 / 后台服务 服务插件 ISysReportService / IDOService references/xingkong-plugin-dev.md §服务插件

核心参考文件 文件 内容 何时读取 references/xingkong-plugin-dev.md 星空6大类插件完整开发指南（重点） 星空插件开发需求 references/plugin-templates.md 各类插件完整代码模板 编码阶段直接套用 references/xingkong-bos-ide.md BOS IDE 操作手册 需要BOS建模/配置时 references/xingkong-webapi.md WebAPI 接口开发 第三方对接需求 references/database-reference.md 数据库核心表/SQL/多语言/LK表 写SQL/查数据时 references/cangqiong-dev.md 苍穹二次开发 苍穹相关需求 references/common-patterns.md 常见开发模式 + 社区FAQ 遇到典型问题/报错时 references/deployment-ops.md 打包部署/调试/运维 部署阶段

编码规范 命名：插件类名 = {业务对象}{功能}PlugIn，如 SaleOrderValidatePlugIn 多语言：涉及中文名称的字段必须关联 _L 表，FLOCALEID=2052 上下游关联：使用 _LK 关联表，FSID → 上游明细 FENTRYID 单据操作：系统自带单据先"扩展"再修改，修改前必须"签出"，改完"保存→签入" 发布：单据修改后必须"发布到主控台"才能在前台看到

官方资源索引 资源 链接 星空知识地图 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/193463482326019584 WebAPI接口说明书 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