资金 · 现金 / 银行 / 收付

经营看板生成(免费本地版)

【财友云·免费】输入多期财务指标(行=指标、列=期间),本地生成自包含 HTML 分区式财务分析报告:封面(报告要览)+ 执行摘要(自动识别增速/复合增速/利润率变动/勾稽背离)+ 核心指标卡(带迷你走势)+ 按业务域分区(收入结构堆叠 / 成本与费用树图 / 盈利能力 / 现金流与营运 / 税负专区)+ 变动热力表 + 指标明细(占比列 + 合计行 + 表头可排序)+ 封底免责声明,零网络零 CDN 单文件可直接分享、可打印导出 PDF。本包免费、本地、零联网,数据不出本机;要在线可分享看板 + 服务端 PDF + 邮件送达,用在线版 caiyouyun-bi-dashboard-plus。触发词:经营看板 / 财务分析报告 / 财务报表可视化 / 出图 / 管理层看板 / 数据看板 / 驾驶舱 / 税负分析 / 免费看板。

已上线 P2 L0

经营看板生成(免费本地版)

【财友云·免费】输入多期财务指标(行=指标、列=期间),本地生成自包含 HTML 分区式财务分析报告:封面(报告要览)+ 执行摘要(自动识别增速/复合增速/利润率变动/勾稽背离)+ 核心指标卡(带迷你走势)+ 按业务域分区(收入结构堆叠 / 成本与费用树图 / 盈利能力 / 现金流与营运 / 税负专区)+ 变动热力表 + 指标明细(占比列 + 合计行 + 表头可排序)+ 封底免责声明,零网络零 CDN 单文件可直接分享、可打印导出 PDF。本包免费、本地、零联网,数据不出本机;要在线可分享看板 + 服务端 PDF + 邮件送达,用在线版 caiyouyun-bi-dashboard-plus。触发词:经营看板 / 财务分析报告 / 财务报表可视化 / 出图 / 管理层看板 / 数据看板 / 驾驶舱 / 税负分析 / 免费看板。

这个包已上线。正文与用法以下方随包 SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。

标签

[经营看板,数据可视化,财务报表,图表生成,管理层看板]

技能正文(随包 SKILL.md)

<!-- BODY_START -->

# 经营看板生成

把「一堆财务指标」变成「一张能直接发给老板的看板」。财务人做月报/季报/汇报时,最耗时的一步往往不是算数,而是**把表格变成看得懂的图**——本包解决的就是这最后一公里。

> **本地运行,零网络请求、免 API Key、不主动外发数据。**
> 四项诚实承诺:① 不臆造数据点,非数字一律进异常表;② 图表为**内联 SVG**,无 CDN 无外链,断网可看;③ 幂等写盘,绝不改你的源文件;④ 全程留痕可审计。
> 边界说明:本包脚本自身不联网、不外发;若你把看板文件发给他人,那是你的主动行为,不由本包决定。
<!-- WB-CLAIM-BOUNDARY v1 -->

**输出形态**:一个**自包含的 `.html` 单文件**(图表是手写内联 SVG,不引用任何图表库/CDN)+ 标准四件套 CSV。断网可看、微信可发、不携带任何追踪。看板为**六段式商业级版式**:执行摘要 → 关键指标 → 核心趋势 → 结构与变动 → 变动热力 → 指标明细,自带「打印 / 导出 PDF」按钮(浏览器原生打印,仍不联网)。

## 运行方式

<!-- WB-INVOKE-CONTRACT v1 -->

**环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。

```bash
# 预览(默认,不写盘)
python scripts/bi-dashboard.py 指标.csv --title "2025 经营看板"

# 落盘:生成 HTML 看板 + 四件套
python scripts/bi-dashboard.py 指标.csv --title "2025 经营看板" --execute --out-dir _out
```

**输入(宽表,首行表头,首列=指标、其余列=期间)**:

```csv
指标,2023,2024,2025
营业收入,1000,1150,1320
营业成本,700,790,880
毛利率,30.0,31.3,33.3
净利润,100,120,160
经营性现金流,80,150,90
```

期间列数不限(2 个以上就能画趋势);`.xlsx` 与 `.csv` 都支持。

## 何时不触发

- 只想看**单个数的对错**(对账/勾稽)→ 用各专项核算包,不是本包;
- 要**文字解读与经营结论**("这算好还是坏")→ 用 `caiyouyun-boss-view-analysis`;
- 要**预测未来**(滚动预测/现金流沙盘)→ 用 `caiyouyun-cashflow-sandbox`;
- 输入是**明细流水**(逐笔),本包要的是**指标汇总宽表**,先做汇总。

## 工作流(编号阶段)

| 阶段 | 动作 | 闸门 |
|---|---|---|
| 1 | 读表,识别「指标列 + 期间列」 | 至少 2 列,否则算不出 |
| 2 | 逐行解析数值,非数字行进异常表 | 守恒校验:输入 = 主表 + 异常 |
| 3 | 关键指标进 KPI 卡 + 趋势图 | 无可用指标则拒绝出图 |
| 4 | 渲染自包含 HTML + 输出四件套 | `--execute` 才落盘 |

## 判断框架(画什么图 / 算什么数)

| 指标类型 | 图形 | 理由 |
|---|---|---|
| 金额类(收入/成本/利润/现金流/应收/费用…) | **柱状图 / 折线图** | 看绝对量与增减 |
| 率类(毛利率/净利率/资产负债率/周转天数…) | **折线图** | 率是趋势线,用柱会误导 |
| 成本费用类(成本/销售/管理/研发/财务费用) | **环形占比图** | 看构成结构 |
| 全部指标 | **变动热力表** | 一眼看出哪期哪项异动 |

看板自动派生并呈现(不额外要求输入):

- **期间复合增速(CAGR)**:首末期几何平均,用于规模类指标;
- **占比结构**:最新期成本费用构成;
- **变动排行**:按 |相对上期变动率| 降序 Top 10,双向条形分色;
- **勾稽背离提示**:如「利润 ↑ 而经营现金流 ↓」「应收增速快于收入」「成本增速快于收入」。

颜色语义:**红 = 相对上期增加,绿 = 相对上期减少**(中国习惯)。**颜色只表示增减方向,不代表好坏**——成本上涨也是"增",会被涂红,这只是方向不是判断。

## 输入 / 输出

**必填**:一个 `.xlsx`/`.csv`,首行表头、首列是指标名(别名:项目/科目/名称/维度),其余列为期间。

**输出(`--execute`)**:
- `<标题>.html` —— 自包含分区式报告:封面(标题+要览)→ 执行摘要 → 核心指标卡 → 收入 → 成本与费用 → 盈利能力 → 现金流与营运 → 税负专区(检测到税额/税负率指标时)→ 变动热力 → 全部指标明细 → 封底(免责声明)
- `经营看板_主表.csv` / `_异常表.csv` / `_校验表.csv` / `fin-log.jsonl` —— 标准四件套

**可选参数**:`--unit 万元`(金额单位后缀,仅作显示)、`--title`、`--out-dir`、`--operator`。

## 真实输出

```text
$ python scripts/bi-dashboard.py 指标.csv --title "某制造企业经营看板" --unit 万元
--- 经营看板预览(16 指标 × 6 期间,0 项须人工确认)---
  期间:2021 / 2022 / 2023 / 2024 / 2025 / 2026E
  营业收入         最新期 14,600 (+13.6%)
  毛利           最新期 4,380 (+13.5%)
  毛利率          最新期 30 (+0.0%)
  净利润          最新期 1,420 (+20.3%)
  净利率          最新期 9.70 (+5.4%)
  经营性现金流       最新期 1,250 (+81.2%)
  应收账款         最新期 2,400 (+10.1%)
  存货           最新期 1,210 (+5.2%)
--- 执行摘要(5 条)---
  [info] 营业收入(最新 14,600):较上期 +13.6%;期间复合增速 11.2%
  [info] 毛利率 持平:最新 30.0%,较上期 +0.00 个百分点
  [good] 净利率 上升:最新 9.7%,较上期 +0.50 个百分点
  [info] 变动最大指标:经营性现金流:较上期 +81.2%;本期变动前三位:经营性现金流 +81.2%、研发费用 +22.1%、净利润 +20.3%。
  [info] 营业收入 连续 5 期上升:期间值:8,600 → 9,800 → 11,200 → 11,230 → 12,850 → 14,600。
[预览模式] 未生成 HTML 看板与四件套。确认无误后加 --execute 执行。
```

落盘后校验表关键行:`条目守恒 | 输入 16 = 主表 16 + 异常 0`。

## 拒绝权(什么情况下不出图)

- 首行表头读不出 / 只有 1 列 → `refuse`,让你先修表;
- 全表无一个可用指标 → 拒绝,不给空看板;
- 条目对不上账(主表+异常 ≠ 输入)→ 拒绝输出;
- **地理地图不做**:离线地图易造成省界/境界缺漏(涉地图合规红线),本包不内嵌任何地图组件——需要地理分布分析时转交付费版服务端能力或专业 BI。

**算不清就不画**,绝不用插值/补零糊出一个好看的数据点。

## 关键设计(容易踩的坑)

1. **为什么不用 ECharts/CDN**:本包卖点是"数据不出本机"。图表库走 CDN = 打开看板就联网。手写 SVG 换来**完全自包含**,这是硬选择不是省事。
2. **率类与金额类分开画**:把毛利率画成柱状、或把净利润画成折线,都会误导阅读者。
3. **颜色是方向不是好坏**:汇报前务必确认使用者理解这一点,否则"成本涨了显示红"会被误读。
4. **异常行整行剔除**:某指标任一期非数字 → 该指标整行进异常表,不会画一个缺点的图。
5. **版式即产品**:看板按商业汇报标准排版(统一设计变量、卡片层级、悬停态、响应式、打印样式),因为看板的使命是"能直接拿去汇报",版式粗糙等于没交付。
6. **洞察只陈述事实**:执行摘要只写可核验的变动与背离("应收增速快于收入 X 个百分点"),不写"建议加强回款"这类经营结论——那是 `caiyouyun-boss-view-analysis` 的职责,也是合规红线。

## 人工复核(必读)

本看板只负责**把数画出来**。数据口径、指标定义、以及"这算好还是坏"的判断,必须由财务/管理者人工确认。看板不构成经营建议。

## 免费版 / 在线版,怎么选(本包是免费版)

本包(`caiyouyun-bi-dashboard`)是**免费、本地、零联网**版:看板在你自己的电脑上生成,数据一个字节都不出本机,产出单文件 HTML 自己看、自己发。**99% 的月报/季报/汇报场景,本包就够了。**

**什么时候值得升级到在线版(`caiyouyun-bi-dashboard-plus`,¥4.99/次)?** 只有一个判断标准:**你要的不是"一张图",而是"一个能给出去的链接"。**

| 你遇到的场景 | 免费版(本包) | 在线版 Plus |
|---|---|---|
| 自己看数据、本地存档 | ✅ 够用 | 杀鸡用牛刀 |
| 发微信/邮件给老板、同事 | ✅ 文件直接发 | ✅ |
| 老板要看**可点击可排序**的在线看板,随时刷新 | ❌ 只能发文件 | ✅ 服务端托管看板 + 分享链接 |
| 手机点开就要看,不想下载文件 | ❌ | ✅ 链接即开 |
| 要**可打印 PDF**一并交付 | 手动浏览器导出 | ✅ 服务端直出 PDF |
| 要**邮件定时送达**给多人 | ❌ | ✅ |
| 数据**敏感、绝不能上云** | ✅ **本包是唯一选择** | ❌ 不建议 |

**升级路径**:在 SkillHub 搜索 `caiyouyun-bi-dashboard-plus` 或在对话里说"用在线版经营看板"→ Agent 会走微信支付授权(¥4.99/次)→ 服务端生成并回一个 30 天有效的分享链接。

**一句人话**:免费版解决"把数画出来",在线版解决"把看板送到人手里"。先免费用顺手,遇到"要发链接、要手机看、要邮件送"再升级。

## 相邻路线转交

- 要**文字解读**("钱/风险/增长"白话 + 关注点)→ `caiyouyun-boss-view-analysis`
- 要**现金流沙盘/断流预警** → `caiyouyun-cashflow-sandbox`
- 要**在线可交互看板 + 分享链接 + PDF + 邮件交付**(服务端,¥4.99/次)→ 付费版 `caiyouyun-bi-dashboard-plus`

## 输出规范

- **交付形态**:文件落盘,不只在对话里吐文本。
- **落盘路径**:默认当前工作目录 `_out/`;可用 `--out-dir` 指定。
- **命名**:`<标题>.html`(标题由 `--title` 决定,默认"经营看板")。
- **必含**:执行摘要、KPI 卡(带迷你走势)、多期趋势图、结构/变动图、变动热力表、指标明细表、生成时间、规则版本、"数据不出本机"徽标。
- **自检**:以上任一缺失视为未完成交付。

## 反例对照(避开这些写法)

| ❌ 反例 | ✅ 正例 | 判据 |
|---|---|---|
| 用 CDN 图表库,看板一开就联网 | 内联 SVG,断言断网可看 | 断网打开是否还能显示图表 |
| 把毛利率和净利润画在同一个柱状图里 | 率走折线、金额走柱状,分图呈现 | 两类量纲混画会不会误导 |
| 非数字就跳过、悄悄少画一个点 | 整行进异常表并在校验表标出 | 缺的数据能否在异常表里指回来源 |
| 颜色代表"好/坏",替老板下结论 | 颜色只表示增减方向,显式声明 | 遮掉图例后是否会被误读成好坏 |

## 交付前自检(必跑)

```bash
python scripts/selfcheck.py
```

## 退出码(脚本契约)

| 码 | 含义 | 你要做的事 |
|---|---|---|
| 0 | 成功 | 继续 |
| 2 | 算不出(表头/列/守恒问题) | 按提示修输入表,不要绕过 |
| 3 | 自检门禁未通过 | 按 FAIL 项修好再交付 |
| 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口可运行 |
| 8 | 部分通过 | 无 FAIL 但有 WARN,建议先修警告项 |

## 免责声明

本包为**数据呈现工具**,不构成经营、投资或税务建议。颜色仅表示增减方向,非好坏判断。数据口径与结论须由人工复核。版权归律令科技(深圳)有限公司所有,BUSL-1.1 授权。
这个包已在 SkillHub 上线,可一键安装。
在 SkillHub 上查看完整说明、版本记录与安装方式,支持一键装到你的 AI 客户端。

常见问题

按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。

经营看板生成(免费本地版) 这个技能,具体能帮我做什么?

【财友云·免费】输入多期财务指标(行=指标、列=期间),本地生成自包含 HTML 分区式财务分析报告:封面(报告要览)+ 执行摘要(自动识别增速/复合增速/利润率变动/勾稽背离)+ 核心指标卡(带迷你走势)+ 按业务域分区(收入结构堆叠 / 成本与费用树图 / 盈利能力 / 现金流与营运 / 税负专区)+ 变动热力表 + 指标明细(占比列 + 合计行 + 表头可排序)+ 封底免责声明,零网络零 CDN 单文件可直接分享、可打印导出 PDF。本包免费、本地、零联网,数据不出本机;要在线可分享看板 + 服务端 PDF + 邮件送达,用在线版 caiyouyun-bi-dashboard-plus。触发词:经营看板 / 财务分析报告 / 财务报表可视化 / 出图 / 管理层看板 / 数据看板 / 驾驶舱 / 税负分析 / 免费看板。

常见的触发场景有:经营看板、财务分析报告、把报表做成图表。

完整说明、版本记录和安装方式在 SkillHub 上的「经营看板生成(免费本地版)」页面 →。

有没有算不了、它明确拒绝的情况?

有。下面几种情况它会明确拒绝,而不是硬给答案:

·首行表头读不出 / 只有 1 列 → refuse,让你先修表;
·全表无一个可用指标 → 拒绝,不给空看板;

总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。

用之前我得注意什么?容易踩哪些坑?

这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:

为什么不用 ECharts/CDN:本包卖点是"数据不出本机"。图表库走 CDN = 打开看板就联网。手写 SVG 换来完全自包含,这是硬选择不是省事。
率类与金额类分开画:把毛利率画成柱状、或把净利润画成折线,都会误导阅读者。
颜色是方向不是好坏:汇报前务必确认使用者理解这一点,否则"成本涨了显示红"会被误读。
数据会不会传出去?我自己怎么验证?

不会。运行时不发一个网络包。你自己就能验证,三条路任选:

把网断掉再跑一遍,功能照常——它本来就没打算联网。

打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。

直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。

要付费吗?要不要配 API Key?

都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。

装上之后怎么用?

安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。

触发方式:对话里提到「经营看板、财务分析报告、把报表做成图表」等场景,或上传相关表格/凭证,它就会自动响应。

也可以从客户端的「已安装技能」列表里手动唤起。

什么环境能跑?需要装依赖吗?

Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。

运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。

装在哪个客户端上?会不会弄坏我原来的文件?

在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。

相邻技能

规划中 P2 资金

税务筹划方案生成

【财友云】输入筹划场景(分红/薪酬、主体架构、小型微利临界点、研发加计、股权转让、年终奖分立等)+ 主体画像与关键参数,输出 2–3 个可比方案,每个方案含确定性测算、风险评级、执行清单(谁做/何时/何凭证)、合规红线、依据文号与转交建议。以「可落地的执行清单」把概念落成可执行方案。适用于股东分配、架构选择、优惠临界点、资产处置前的方案比选。

规划中 P2 资金

滚动预测现金流沙盘

【财友云】输入期初现金+各期流入/流出,滚动算每期余额、最低点与断流预警;支持"假如流入打折/流出加压"情景模拟,看清哪期先断流。严守"沙盘推演不给决策建议"边界。

规划中 P2 资金

老板视角经营解读

【财友云】把财务口径的经营指标(本期/上期)翻译成老板听得懂、能拍板的大白话:趋势+异常提示+一句结论+关注点;严守"只转译不给投资建议"边界。

规划中 P2 资金

海关法规检索

【财友云】内置海关总署(GACC)英文站 Legislation 三栏目(Laws & Regulations / Customs Announcements / Customs Decrees)的条目离线索引(约 46 条),输入英文关键词即可在本地做大小写不敏感的多词 AND/OR 匹配,返回标题 / 栏目 / 发布日期 / 原文链接。适用于涉外商事、跨境合规、外贸法务在英文场景下快速定位中国海关法规原文入口。只做索引检索与定位,不解读法规、不翻译。数据为离线快照、版本可查,运行时零联网。

规划中 P2 资金

稽查红线信号

【财友云】双模式涉税风险排查:① 关键词特征匹配(私户收款/两套账/虚开等)→ 关注等级+依据+核查方向;② 金税四期量化指标勾稽(税负率/毛利率/工资社保个税三方/进销项勾稽等)→ 偏离度+红线+勾稽信号。只提示「可能触发关注」,不下违法定性结论。适用于税务自查、内控体检、涉税风险排查。

规划中 P2 资金

汇算清缴前自检

【财友云】白条入账、暂估成本余额、成本费用率波动、工资薪金三方比对,输出差异项清单。

规划中 P2 资金

供应商准入财报筛查

【财友云】批量导入候选供应商财务快照,按公开阈值筛出经营不稳定者,输出 pass/watch/reject 分级清单。

规划中 P2 资金

平台收入勾稽自检

【财友云】把各平台后台收入报表与申报收入做口径对齐,差异拆成口径差/期间错配/待核实三类。

规划中 P2 资金

个税计算

【财友云】工资薪金累计预扣预缴、综合所得年度汇算多退少补、年终奖两种计税方式对比,本地纯计算。