前言¶
做金蝶云星空二次开发的人,大概率遇到过这几件事:想知道销售订单上到底有哪些字段,去翻安装包里的元数据文件;想知道 FBillNo 落在哪个物理表,去查数据库或找老同事;想知道某个数据状态字段有哪些枚举值,打开枚举维护界面一条条抄。这些信息本身不难获取,难在打断工作流——打开另一个窗口、翻目录、读二进制或 XML 元数据,再回到代码里继续写。
下面介绍的 Skill 把这类查询做成一次对话:把业务对象的元数据整理成可直接检索的字典,模型在对话里回答「某表单有哪些字段」「某字段在哪个表」「某枚举有哪些取值」。
这是什么¶
金蝶云星空二次开发辅助 skill,是一个面向金蝶云星空(Kingdee Cloud Galaxy)开发者的元数据查询 Skill。它内置金蝶云星空企业版 9.1 的完整数据字典,覆盖表单、实体、字段、枚举四类对象。
出品方为社区发布者 user_133a75db,在 SkillHub 上坐标为 @user_133a75db/kingdee-cloud-dictionary,当前版本 1.0.0,分类 dev-programming,来源标记为 community。它解决的是二次开发过程中「业务对象结构查不到、查不快」的问题,不需要访问金蝶云星空服务器,也不需要连数据库。
核心能力¶
官方简介列出的可查询能力有四类:
- 业务对象表单结构:某个单据或基础资料包含哪些表单、表单上有哪些字段。
- 实体与物理表关系:业务对象对应的实体标识,以及实体落到数据库中的物理表。
- 字段元数据:字段标识(如
FBillNo)、数据库列名、字段类型。 - 枚举取值:枚举类型包含哪些枚举项、枚举项的编码和名称。
需要说明的是,这是一份静态内置的字典快照,而不是运行时接口。它回答「这个对象在 9.1 企业版里长什么样」,不负责实时探测客户环境里的实际配置。客户做了字段增删、改了枚举项之后,本地字典不会跟着变。
数据规模¶
按官方页面给出的数据,字典包含:
- 表单 3,621 个
- 实体 7,076 个
- 字段 117,443 个
- 枚举类型 3,540 个
数据版本固定在金蝶云星空企业版 9.1。规模本身是这个 Skill 的主要卖点:字段量在十万级别,人工翻元数据文件和用通用检索都不划算,需要靠结构化的字典加模型推理来缩小范围。
典型用法¶
官方简介给出的查询示例如下,这里原样保留,便于对照能力边界:
- 「销售订单有哪些字段」——返回该单据的字段清单。
- 「FBillNo 在哪个表」——返回字段标识对应的物理表。
- 「数据状态字段有哪些枚举值」——返回该字段所属枚举的取值列表。
前两类问的是结构,第三类问的是取值。实际使用中还有一类常见问法是「某个实体和哪个物理表对应」,属于上面第 2 项能力。
安装与启用¶
官方页面没有给出命令级的安装脚本或配置文件字段,因此这里不编造安装步骤。可用的入口是官方地址:
https://api.skillhub.cn/user_133a75db/kingdee-cloud-dictionary
对应的 SkillHub 页面为:
https://www.skillhub.cn/skills/user_133a75db/kingdee-cloud-dictionary
按 SkillHub 的标签,该 Skill 声明 requires_api_key=false,即不需要额外配置 API Key。它遵循通用 SKILL.md 格式,接入方式取决于你使用的宿主(Cursor、Codex CLI、Claude Code 等)对 Skill 的支持方式。正式接入前建议先打开上面两个地址,确认页面上列出的安装方式与当前版本是否一致。
适用场景与注意¶
适合的场景:金蝶云星空企业版 9.1 的插件开发、单据插件与校验脚本编写、报表或数据同步任务里需要确认字段标识和物理表、以及需要批量核对枚举取值的场合。在这些场景里,它省的是查元数据的时间,不改变业务逻辑。
需要注意的地方:
- 版本固定在 9.1 企业版。使用其他版本(标准版、私有云定制版本、更高版本)时,字段集合和枚举取值可能不一致,涉及具体字段前应自行核对实际环境。
- 字典是静态快照,客户现场的二次开发改动不会被反映出来。
- 字段量超过十一万,查询结果的精确度取决于问法。字段名缩写、同名字段跨多个单据的情况,可能需要多次追问才能定位到具体实体。
- 来源为社区发布,不是金蝶官方出品。需要确认数据字典的准确性时,应与安装包内的元数据文件交叉验证。
结尾¶
这个 Skill 的价值在于把「翻元数据」这一步变成对话里的一次提问,覆盖表单、实体、字段、枚举四类对象,数据量足以支撑日常二次开发的查表需求。它的准确性取决于内置字典与实际环境的一致性,版本固定在企业版 9.1,使用前需要自己核对现场版本。
官方地址:https://api.skillhub.cn/user_133a75db/kingdee-cloud-dictionary
SkillHub 页面:https://www.skillhub.cn/skills/user_133a75db/kingdee-cloud-dictionary