kingdee-dev

分类：技能市场（第三方作品）｜ 文件数：18 ｜ 仓库目录：kingdee-dev__skillhub

📌 简介

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

🎯 适用场景

适用于该技能的能力范围，详见下方「📖 使用说明」。

📂 目录结构

  - .gitignore
  - LICENSE
  - README.md
  - SKILL.md
  - _meta.json
  - _skillhub_meta.json
  - **references/**
    - cangqiong-dev.md
    - common-patterns.md
    - database-reference.md
    - deployment-ops.md
    - multi-org-security.md
    - performance-debugging.md
    - plugin-templates.md
    - workflow-plugin-dev.md
    - xingkong-bos-ide.md
    - xingkong-plugin-dev.md
    - xingkong-webapi.md
  - skill-card.md

🚀 安装方法

将本文件夹整体复制到 WorkBuddy 的技能目录即可启用：

# 用户级（推荐）
cp -r . ~/.workbuddy/skills/kingdee-dev__skillhub

# 或项目级
cp -r . <你的项目>/.workbuddy/skills/kingdee-dev__skillhub

复制完成后，重启或刷新 WorkBuddy，即可在对话中用自然语言触发该技能。

⚙️ 配置说明

本技能开箱即用，无需额外配置。若涉及外部 API 调用，请在使用时按需提供您自己的密钥（不要提交到公开仓库）。

📖 使用说明（完整规范）

以下为该技能的完整说明，涵盖核心能力、工作流程与关键规则，帮助您全面了解其运作方式。

产品线识别

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

关键词	产品	技术栈	参考
星空、K3 Cloud、K/3 Cloud、BOS IDE、C#插件、K3Cloud	金蝶云星空	C# / .NET / SQL Server / IIS	`references/xingkong-plugin-dev.md`
苍穹、Cosmic、AI苍穹、低代码、KingScript、Java插件	金蝶云苍穹	Java / Spring Cloud / PostgreSQL	`references/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`
"第三方系统对接/外部接口"	星空WebAPI	`references/xingkong-webapi.md`
"BOS建模/字段扩展/菜单发布"	BOS IDE 操作	`references/xingkong-bos-ide.md`
"苍穹表单/操作/列表/报表/Java"	苍穹开发	`references/cangqiong-dev.md`

2. 星空开发完整流程

明确产品线：星空 / 苍穹
确定需求类型：插件 / BOS建模 / 接口 / 报表 / 数据迁移
选择插件类型：见下方插件选择矩阵
编码实现：使用 references/plugin-templates.md 对应模板
处理边界：空值判断、异常处理、事务安全、权限控制
本地测试：BOS IDE 注册插件，IIS 回收，浏览器验证
部署上线：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.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
防御式编程：所有字段取值都做空判断，避免 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/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

⚠️ 注意事项

本技能从本地 WorkBuddy 环境导出，所有真实密钥 / 凭据 / 个人数据均已脱敏为占位符，重新使用前请配置您自己的 Key。
本技能来自技能市场（文件夹名含 __skillhub），版权归原作者所有，使用时请遵守其许可证与署名要求。
技能提供的是自动化辅助能力，不替代专业判断；涉及交易、法律、医疗等高风险场景请谨慎并自担风险。

📄 许可证

MIT License —— 详见仓库内 LICENSE 文件。

Navigation Menu

Repository files navigation

kingdee-dev

📌 简介

🎯 适用场景

📂 目录结构

🚀 安装方法

⚙️ 配置说明

📖 使用说明（完整规范）

产品线识别

需求决策树

1. 识别需求类型

2. 星空开发完整流程

插件选择矩阵（星空）

核心参考文件

编码规范

版本兼容性

官方资源索引

⚠️ 注意事项

📄 许可证

About

Releases

Packages

Contributors

Name		Name	Last commit message	Last commit date
references		references
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SKILL.md		SKILL.md
_meta.json		_meta.json
_skillhub_meta.json		_skillhub_meta.json
skill-card.md		skill-card.md

Latest commit

History

Folders and files

Repository files navigation

kingdee-dev

📌 简介

🎯 适用场景

📂 目录结构

🚀 安装方法

⚙️ 配置说明

📖 使用说明（完整规范）

产品线识别

需求决策树

1. 识别需求类型

2. 星空开发完整流程

插件选择矩阵（星空）

核心参考文件

编码规范

版本兼容性

官方资源索引

⚠️ 注意事项

📄 许可证

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors