前言¶
做金蝶云星空（K3 Cloud）二次开发、实施配置或报表取数时，表名和字段往往分散在文档、实施笔记或数据库工具里。查一个业务对象要翻多张表、确认外键和索引，对话式编码时模型也缺少稳定的结构上下文，容易写出字段名错误或关联路径不对 SQL。
下面介绍 SkillHub 上的社区 Skill「金蝶全模块数据结构」，把全模块库表结构整理成 Agent 可引用的数据字典，在 IDE 里用自然语言查字段、索引、约束和表间关系。
这是什么¶
「金蝶全模块数据结构」是面向 金蝶云星空（K3 Cloud） 的数据库表结构查询 Skill。坐标为 @user_2de6ec79/kingdee-schemadb，版本 1.0.0，来源为 community（SkillHub 分类 data-analysis），页面标注作者为「金蝶-程龙」。标签 requires_api_key=false，安装后无需单独配置 API Key。
它解决的核心问题是：在供应链、财务会计、生产制造、PLM、成本管理、税务管理、基础模块等范围内，统一查询核心表的字段定义、索引、约束和关联关系，供 ERP 开发、实施与数据分析对照使用。
核心功能¶
依据 SkillHub 简介，当前 Skill 覆盖的能力包括：
- 全模块表结构查询：面向 K3 Cloud 各业务域的核心数据表，而非单一子系统。
- 字段定义：表级字段名称与类型等定义信息，便于写接口、插件或 SQL。
- 索引与约束：辅助判断查询性能、唯一性与数据完整性相关设计。
- 关联关系：表与表之间的关联，减少手写 JOIN 时猜外键。
SkillHub 页面显示评分 100000，下载 3211 次（统计以页面为准）。
安装与启用¶
安装流程遵循 SkillHub 官方说明文档。可先检查本机是否已有 skillhub CLI：
command -v skillhub && skillhub --version
未安装时，可按官方安装脚本安装（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，Agent 可能无法识别。官方给出的坐标安装方式为：
skillhub install user_2de6ec79/kingdee-schemadb --dir <skills 目录>
在 Cursor、Claude Code 等环境中，常见 skills 目录如下（摘自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
若通过对话让 AI 代为安装，SkillHub 页面提供的提示词为：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_2de6ec79/kingdee-schemadb`。
安装完成后，按你所用客户端的要求重启或刷新 Agent，使 Skill 被加载。
典型用法¶
官方页面未给出单独的命令行子工具示例；用法符合通用 SKILL.md 模式：Skill 安装到 Agent 的 skills 目录后，在编码或分析对话中直接提问。
可复现的安装入口即上述提示词或 skillhub install 命令。启用之后，典型提问方向包括：
- 某业务模块或单据对应的主表、分录表名称；
- 指定表的字段列表及含义对照；
- 两表之间的关联字段或约束说明。
具体回答内容由 Skill 内嵌的数据字典与 Agent 检索逻辑决定，实施前仍建议与当前账套、补丁版本下的实际库结构交叉验证。
适用场景与注意¶
适合谁
- 金蝶 K3 Cloud 插件、报表、集成接口开发人员；
- 实施顾问在做字段映射、单据关联、取数方案时；
- 数据分析或 BI 人员需要弄清底层表关系时。
限制与注意
- 社区来源：
source: community，内容维护节奏与官方产品文档可能不一致，上线 SQL 或接口前请在测试环境核对。 - 版本与补丁：云星空不同版本、行业包可能导致表结构差异，Skill 描述的是「全模块」通用字典视角，不能替代目标环境的
INFORMATION_SCHEMA或官方发布说明。 - 无 API Key 要求：
requires_api_key=false降低配置成本，但不改变你对生产数据权限与合规访问的责任。 - 安装统计：页面显示安装次数为 0，与下载量分开统计；以你本机
skills目录是否出现该 Skill 为准判断是否安装成功。
结尾¶
「金蝶全模块数据结构」把 K3 Cloud 多模块库表结构收敛成 Agent 侧可查询的数据字典，适合在开发和对照字段时减少反复翻文档。官方 Skill 页与 API 入口：
- https://www.skillhub.cn/skills/user_2de6ec79/kingdee-schemadb
- https://api.skillhub.cn/user_2de6ec79/kingdee-schemadb
