kingdee-data-exporter

你需要做什么（最少步骤）

python -m pip install -r requirements.txt

准备配置（避免把真实账号提交到 GitHub）：

复制 config.example.py 为 config.py
在 config.py 里填写 KINGDEE_CONFIG
WECHAT_CONFIG.webhook 可留空（或运行时加 --no-wechat）

运行导出：

python data_exporter.py

说明：默认会导出 data_exporter.py 里 bill_configs + report_configs 的全部配置项，生成一个多 Sheet 的 Excel。

常用命令

查看当前脚本支持导出的“单据/报表清单”

python data_exporter.py --show-config

你会看到两类条目：

[BILL] form_id | bill_name
[RPT ] form_id | report_name

后续 --only 参数就填这些 form_id 或者中文名称（支持逗号分隔）。

先导出全部组织列表（降低配置难度）

python data_exporter.py --list-orgs --no-wechat

会生成 组织列表_YYYYmmdd_HHMMSS.xlsx，里面至少包含：

number: 组织编码（后续 --org 要用）
name: 组织名称

某期间 + 某组织 + 全部单据/报表

例如导出 2026-02-01 到 2026-02-28，组织编码 101 的所有配置项：

python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org 101 --no-wechat

组织也可以填多个（逗号分隔）：

python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org 101,102,104 --no-wechat

某期间 + 某组织 + 某单据类型明细（只导出 1 个表单/报表）

先用 --show-config 找到你要的 form_id，比如“销售出库单”对应 SAL_OUTSTOCK
再用 --only 只导出它：

python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org 101 --only SAL_OUTSTOCK --no-wechat

也可以用中文名：

python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org 101 --only 销售出库单 --no-wechat

全组织导出（先“全量”再二次筛选）

如果你想先导出全组织，再在 Excel 中二次筛选：

python data_exporter.py --start 2026-02-01 --end 2026-02-28 --org all --no-wechat

注意：全组织数据量可能很大，建议优先使用 --only 缩小范围。

二次筛选：从导出 Excel 里筛某组织/某单据类型

当你已经用 --org all 导出了一份总表（或导出多个组织），可以用下面脚本把各 Sheet 按组织/单据类型再筛一遍，输出一个“过滤后的新 Excel”。

脚本位置：skills/kingdee-data-exporter/scripts/filter_export_excel.py

示例（按组织编码 101 过滤，并且只保留“单据类型=手工标准应收单”的明细行；会自动对每个 Sheet 尝试匹配常见组织列/单据类型列）：

python scripts/filter_export_excel.py --input "金蝶经营数据_2026年02月_20260401_120000.xlsx" --org 101 --bill-type "手工标准应收单"

如果你只想处理某一个 Sheet：

python scripts/filter_export_excel.py --input "金蝶经营数据_2026年02月_20260401_120000.xlsx" --sheet "应付单" --org 101

输出文件默认会生成在同目录，文件名会带 _filtered 后缀；也可指定 --output。

打包发布（可选）

如果你要把该 Skill 打包成 .skill 文件发布，有两种方式：

python ../skill-creator/scripts/package_skill.py .

如果你的仓库里没有 skill-creator，也可以直接把本目录打成 zip 并改后缀为 .skill（本质是 zip）。