前言¶
金蝶云星空（Kingdee Cloud Galaxy / K3Cloud）里的数据，取出来的路子通常有两条：要么在客户端手工筛选导出，字段名是英文编码，拿到手还得自己映射；要么自己写脚本调 WebAPI，登录、选组织、分页、增量同步这些环节一个都不能少，维护成本高。
下面介绍的这个 Skill，就是把这层取数逻辑固化下来。它来自社区发布者 user_710cd579，坐标 @user_710cd579/chuba，定位是把金蝶云星空的单据、基础资料和账表数据导出为本地 Excel/CSV，并可选生成带图表的报表。全程严格只读，不碰保存、审核、删除、下推或回写。
这是什么¶
一句话定位：一个自包含的金蝶云星空取数与报表生成 Skill，内置只读 SDK 层（scripts/kd_sdk），不依赖任何外部 skill。
它解决的问题是：把”登录星空 WebAPI → 选组织 → 分页取数 → 中文字段映射 → 落盘 → 出图”这条链路交给 Skill 执行，使用者只需要用自然语言说明要什么数据。
基本信息：
- 名称：金蝶云星空数据导出及生成HTML报表分析技能
- 坐标：@user_710cd579/chuba
- 版本：1.0.1
- 来源：community
- 分类：data-analysis
- 发布者：user_710cd579
- 标签：requires_api_key=true
核心功能¶
只写已核实到的能力。
1、只读取数。仅允许三个查询方法：ExecuteBillQuery、View、GetSysReportData。禁止任何保存、审核、删除、下推或回写操作。
2、数据范围。覆盖单据（销售订单、采购订单、出入库单、收付款单等）、基础资料（物料、客户、供应商等）和账表（库存台账等）。
3、登录方式。采用用户名密码登录，调用 AuthService.ValidateUser，失败时降级到 Login。
4、组织选择。登录后引导用户确认单组织还是多组织，列出组织清单供选择，再按组织分别取数。
5、分页与增量。按组织分页取数，支持增量同步，中文字段映射后落盘。
6、报表生成。导出后可选生成 Excel 内嵌图表，按环境可用库逐级降级：openpyxl → plotly → 纯 CSV。也可生成可分享的 HTML 报告和全量明细 Excel。
安装与启用¶
官方页面未给出明确的安装命令，下面只列已核实的配置信息。它是通用 SKILL.md 格式的 community skill，需要你在自己的工具里加载。
坐标与分类：
坐标: @user_710cd579/chuba
来源: community
分类: data-analysis
版本: 1.0.1
标签: requires_api_key=true
需要配置的内容：
金蝶云星空服务器地址
用户名
密码
requires_api_key=true 表示需要凭据，即上面的用户名密码。具体在 Cursor、Codex CLI 还是 Claude Code 中加载，资料里没有分别说明，此处不写。
典型用法¶
官方资料没有给出可复制的命令行示例，下面按 Skill 的工作链路描述，接口名保持原文。
1、登录。Skill 先调用 AuthService.ValidateUser 校验用户名密码，失败时降级到 Login。
2、选组织。登录成功后，Skill 列出可用组织清单，由使用者确认单组织或多组织。
3、取数。按选定组织分页调用查询方法，只走 ExecuteBillQuery、View、GetSysReportData 三个只读接口。
4、落盘。取回的数据做中文字段映射，写入本地 Excel/CSV，支持增量同步。
5、出图。按需生成 Excel 内嵌图表或 HTML 报告，按 openpyxl → plotly → 纯 CSV 逐级降级。
使用者的触发方式是用自然语言提出需求，例如导出销售订单、核对库存台账、备份收付款单，Skill 会按上面链路执行。
适用场景与注意¶
适合：需要把金蝶云星空数据拉到本地做核对、备份、分析的人，尤其是不想自己维护 WebAPI 调用脚本的开发者。
限制与坑：
- 严格只读，只能查，不能写。如果你需要审核单据或下推数据，这个 Skill 不适用。
- 需要可用的星空凭据，且 requires_api_key=true，没有凭据跑不起来。
- 多组织场景要逐个组织取数，数据量大时耗时较长。
- 图表生成依赖环境里可用的库，openpyxl、plotly 都没装时只能退化为纯 CSV，没有图表。
- 评分与下载量在不同抓取结果里不一致（100000/2141 与 99267/2012），此处不引用具体数字，以官方页面实时显示为准。
结尾¶
这个 Skill 的价值在于把金蝶云星空取数这件事变成一次自然语言请求：登录、选组织、分页取数、中文映射落盘、出图，链路完整且严格只读。适合需要本地留底或做报表分析的场景。
官方地址：https://api.skillhub.cn/user_710cd579/chuba
SkillHub 页面：https://www.skillhub.cn/skills/user_710cd579/chuba
