【财友云】输入期初现金+各期流入/流出,滚动算每期余额、最低点与断流预警;支持"假如流入打折/流出加压"情景模拟,看清哪期先断流。严守"沙盘推演不给决策建议"边界。
【财友云】输入期初现金+各期流入/流出,滚动算每期余额、最低点与断流预警;支持"假如流入打折/流出加压"情景模拟,看清哪期先断流。严守"沙盘推演不给决策建议"边界。
SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。[现金流,滚动预测,断流预警,资金沙盘,情景模拟]
> **本地运行,零网络请求、免 API Key、不主动外发数据。** > 本包**只做数学滚动与情景模拟**——把你的预测数字滚成每期余额、标出断流点、跑「假如」情景。**不构成融资/经营决策建议**,实际资金状况以业务为准,重大资金安排须人工确认。 <!-- WB-CLAIM-BOUNDARY v1 --> # 滚动预测现金流沙盘 现金流是企业的命门。一个常见误区是「利润表好看就安全」——但工资要发、货款要付,账上没现金一样会断流。 本包把你的**期初现金 + 各期流入/流出预测**滚成一张沙盘: - 每期期末余额 - 全程最低点在哪期 - **哪一期开始余额转负(断流预警)** - 「假如回款只到 8 折」「假如付款多 10%」——情景模拟,看断流会不会提前 > ⚠️ 本包是**沙盘推演工具**,输入的是你的预测假设,输出的是数学结果。**不构成融资/借款/经营决策建议**。真实资金安排须以实际业务和人工判断为准。 ## 运行方式 <!-- WB-INVOKE-CONTRACT v1 --> **环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。 **作用**:滚动计算每期余额 + 断流预警 + 情景模拟。 **命令**(在技能目录下执行): ```bash # 清单含 期次/流入/流出;期初在清单里写一行「期初」 python scripts/cashflow-sandbox.py <现金流预测.csv> # 显式给期初现金 python scripts/cashflow-sandbox.py <现金流预测.csv> --opening 100000 # 情景模拟:回款打 8 折、付款加压 10% python scripts/cashflow-sandbox.py <现金流预测.csv> --in-factor 0.8 --out-factor 1.1 # 确认无误后正式执行 python scripts/cashflow-sandbox.py <现金流预测.csv> --execute ``` **参数**: | 参数 | 说明 | |---|---| | `<file>` | 现金流预测(.xlsx / .csv),首行表头,含 期次/流入/流出;期初用「期初」行或 --opening | | `--opening N` | 期初现金(默认 0;或清单里写一行 期次=期初) | | `--in-factor F` | 情景:流入乘数(0.8=回款打8折) | | `--out-factor F` | 情景:流出乘数(1.1=付款加压10%) | | `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) | | `--operator OPERATOR` | 操作人(写入留痕) | | `--execute` | 真正写盘 | **退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。 **输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。 ## 何时不触发 1. 要的是**真实银行流水分析**(对账单核对) → 转 `caiyouyun-bank-recon` / `caiyouyun-bank-statement-parse`。 2. 要的是**融资/借款决策建议**(该不该贷、贷多少) → 明确拒绝,转持牌金融顾问。 3. 要的是**经营策略制定**(怎么提升回款) → 本包只做数学推演,策略须业务端定。 ## 工作流(编号阶段) | 阶段 | 做什么 | 产物 | 闸门 | |---|---|---|---| | 一 | 读取:期初 + 各期 流入/流出 | 现金流清单 | 行内无期次/非数字 → 异常表 | | 二 | 滚动:期末 = 上期末 + 净流量 | 每期余额 | 数字算不清 → 异常表 | | 三 | 预警:最低点 + 断流期次;情景模拟 | 沙盘主表 + 预警 | — | ## 判断框架(断流判定) | 情形 | 判定 | 动作 | |---|---|---| | 任一期 期末余额 < 0 | 断流 | 标 ⚠,列出断流期次 | | 全程余额 ≥ 0 | 安全 | 报告最低点所在期 | | 情景模拟后新增断流 | 抗风险弱 | 提示「回款/付款敏感度」 | > 期初未给且清单无「期初」行 → 本包拒绝运行(不能拿 0 当期初硬算)。 ## 输入 / 输出 输入:1 张现金流预测(`.xlsx` / `.csv`),首行表头。 | 列 | 必需 | 别名 | |---|---|---| | 期次 | 必需 | 期次 / 期间 / 月份 / 季度 / 期 | | 流入 | 必需 | 流入 / 现金流入 / 收款 / 回款 | | 流出 | 必需 | 流出 / 现金流出 / 付款 / 付现 | | (期初行) | 可选 | 期次写「期初」,流入写期初金额 | 输出(进 `--out-dir`,源文件一个字节都不动): | 文件 | 内容 | |---|---| | `现金流沙盘_主表.csv` | 期次 / 流入 / 流出 / 净流量 / 期末余额(断流行标负) | | `现金流沙盘_异常表.csv` | 无期次 / 非数字 的记录 | | `现金流沙盘_校验表.csv` | 情景 / 期初 / 期末 / 最低点 / 断流预警 / 版本 / 重要声明 / **条目守恒校验** | | `fin-log.jsonl` | 处理日志(追加,含输入 sha256) | ## 真实输出 基准 + 情景(回款 8 折、付款 +10%): ``` --- 现金流沙盘(情景(流入×0.8, 流出×1.1),共 3 期,0 条须人工确认)--- 1月 | 入8000 出10000 净-2000 余8000 2月 | 入6400 出11000 净-4600 余3400 3月 | 入4800 出12100 净-7300 余-3900 ⚠断流 期末 3400→-3900 | 最低 -3900(3月) | 断流:3月 ``` ## 拒绝权(什么情况下不给沙盘) | 情况 | 处理 | |---|---| | 缺「期次 / 流入 / 流出」列 | **拒绝(RC=2)**,列出可用别名 | | 未给期初且无「期初」行 | **拒绝(RC=2)**,先补期初现金 | | 流入/流出非数字 | 该行进异常表(中),不猜 | | 索要「该不该借款/贷多少」建议 | 明确拒绝,转持牌金融顾问 | ## 关键设计(容易踩的坑) 1. **沙盘不是预言**。输出全来自你的输入假设,Garbage In Garbage Out。 2. **算不清不编**。非数字 / 期次缺失 → 异常表,绝不输出看似合理的错余额。 3. **期初必须显式**。不能默认 0 当期初硬滚,那会误导断流判断。 4. **条目守恒**:期数 = 主表期数 + 异常期数。对不上账,本包**拒绝输出**。 ## 人工复核(必读) - 本包是**数学滚动与情景模拟**,不是资金诊断,不能作为融资/借款决策依据; - 断流预警出来后,须回到业务核实回款节奏、付款刚性、可动用授信; - 重大资金安排须由管理者结合银行余额与合同人工确认。 ## 相邻路线转交 | 用户要做的事 | 转交给 | |---|---| | 真实银行流水核对 | `caiyouyun-bank-recon` / `caiyouyun-bank-statement-parse` | | 融资/借款决策建议 | 持牌金融顾问(本包不替代) | | 老板视角经营解读 | `caiyouyun-boss-view-analysis` | | 税务筹划 | `caiyouyun-tax-plan-advisor` | ## 可直接复制的说法 ```text 把这份现金流预测跑一遍滚动沙盘,期初用清单里的「期初」行。 先出基准,再跑一个回款8折、付款+10%的情景,看哪期先断流。 只做推演不给决策建议;先跑预览,我确认了再加 --execute。 ``` ## 做完怎么算完成 - [ ] 每期都给了**流入/流出/净流量/期末余额** - [ ] 标出了**最低点**与**断流期次** - [ ] 跑过至少一种**压力情景**并对比基准 - [ ] 异常表里的「须人工确认」项已逐条处理或有明确去向 - [ ] 校验表「条目守恒」对得上 - [ ] 明白本包是**沙盘推演**,资金决策仍由人定 ## 参考资料(渐进式披露) | 文件 | 内容 | 何时读 | |---|---|---| | `references/01-legal-basis.md` | 现金流预测常用口径与假设说明 | 需要核对口径时 | | `references/02-decision-table.md` | 断流判定口径、情景参数含义、边界情形 | 需要确认判定逻辑时 | | `references/03-verification-checklist.md` | 使用前置清单 + 高风险情形 | 自查前准备、事后复核 | ## 输出规范 - **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。 - **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。 - **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。 - **自检**:失败项未列原因,或无可回滚路径,视为未完成。 ## 免责声明 本技能输出的是**现金流沙盘推演结果**,不构成任何融资、借款或经营决策建议。 实际资金状况以业务与银行余额为准。因使用本提示产生的任何后果,由使用者自行承担。 --- 版本:v0.1.0 · 出品:【财友云】 · 规则版本:2026.10 ## 反例对照(避开这些写法) | ❌ 反例 | ✅ 正例 | 判据 | |---|---|---| | 「赶紧去借 50 万,否则断流」 | 只报断流期次与最低点,决策交由人 | 有没有越界给融资建议 | | 没给期初就默认 0 硬算 | 拒绝运行,先补期初现金 | 期初是否显式 | | 非数字硬编个余额 | 进异常表标「非数字」 | 用户能否看出这条没把握 | <!-- WB-SELFCHECK v1 --> ## 交付前自检(必跑) 本包自带可执行自检脚本。**在交付 / 打包 / 发布之前,必须运行并通过**: ```bash python scripts/selfcheck.py ``` 退出码语义(与本节末尾「退出码(脚本契约)」一致): | 码 | 含义 | 你要做的事 | |---|---|---| | 0 | 全部通过 | 可以交付 | | 2 | 用法错误 | 检查运行路径,用包根目录下 `scripts/selfcheck.py` | | 3 | **门禁未通过** | 按 FAIL 项逐条修好再交付,**不要带病交付** | | 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口脚本是否可运行 | | 8 | 部分通过 | 无 FAIL,但有 WARN;建议先修警告项再交付 | 自检覆盖:SKILL.md 与 frontmatter / 合规声明 / 必备章节 / 打包卫生 / 脚本可编译 / 入口脚本 `--help` 可运行。 ## 退出码(脚本契约) | 码 | 含义 | 你要对用户说的话 | |---|---|---| | 0 | 成功 | 直接给结果,不解释过程 | | 2 | 输入错误 | 「你给的 <X> 不对,需要 <Y>」 | | 3 | 鉴权/授权失败 | 「需要你先提供 <凭据>」 | | 4 | 服务/环境失败 | 「这一步依赖 <X> 不可用」 | | 8 | 部分成功 | 「N 项成功、M 项失败」,逐条列出失败项 | 脚本退出非 0 时:**不要静默重试**。先把该码对应的话告诉用户,再决定补齐输入重试或换路径。 ## 状态与断点 - 多阶段流程在执行目录写 `outputs/.state.json`,记录「当前阶段 + 已完成产物路径 + 时间」。 - **每个阶段结束后写一次**;中途中断后重启,先读该文件,从断点阶段继续。 - 状态文件只记阶段与产物路径,不记对话内容、不记敏感数据。
按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。
【财友云】输入期初现金+各期流入/流出,滚动算每期余额、最低点与断流预警;支持"假如流入打折/流出加压"情景模拟,看清哪期先断流。严守"沙盘推演不给决策建议"边界。
常见的触发场景有:现金流预测、资金沙盘、断流预警。
完整说明、版本记录和安装方式在 SkillHub 上的「现金流沙盘」页面 →。
输出会落在 _out/ 目录,主要包括:
现金流沙盘_主表.csv期次 / 流入 / 流出 / 净流量 / 期末余额(断流行标负)现金流沙盘_异常表.csv无期次 / 非数字 的记录现金流沙盘_校验表.csv情景 / 期初 / 期末 / 最低点 / 断流预警 / 版本 / 重要声明 / 条目有。下面几种情况它会明确拒绝,而不是硬给答案:
总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。
这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:
不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:
不会。运行时不发一个网络包。你自己就能验证,三条路任选:
把网断掉再跑一遍,功能照常——它本来就没打算联网。
打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。
直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。
都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。
安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。
触发方式:对话里提到「现金流预测、资金沙盘、断流预警」等场景,或上传相关表格/凭证,它就会自动响应。
典型用法:把原始文件发给 AI,说『帮我跑 现金流沙盘』或『处理一下这个』,结果会输出到当前目录的 _out/现金流沙盘_主表.csv。
也可以从客户端的「已安装技能」列表里手动唤起。
Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。
运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。
在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。
【财友云·免费】输入多期财务指标(行=指标、列=期间),本地生成自包含 HTML 分区式财务分析报告:封面(报告要览)+ 执行摘要(自动识别增速/复合增速/利润率变动/勾稽背离)+ 核心指标卡(带迷你走势)+ 按业务域分区(收入结构堆叠 / 成本与费用树图 / 盈利能力 / 现金流与营运 / 税负专区)+ 变动热力表 + 指标明细(占比列 + 合计行 + 表头可排序)+ 封底免责声明,零网络零 CDN 单文件可直接分享、可打印导出 PDF。本包免费、本地、零联网,数据不出本机;要在线可分享看板 + 服务端 PDF + 邮件送达,用在线版 caiyouyun-bi-dashboard-plus。触发词:经营看板 / 财务分析报告 / 财务报表可视化 / 出图 / 管理层看板 / 数据看板 / 驾驶舱 / 税负分析 / 免费看板。
【财友云】输入筹划场景(分红/薪酬、主体架构、小型微利临界点、研发加计、股权转让、年终奖分立等)+ 主体画像与关键参数,输出 2–3 个可比方案,每个方案含确定性测算、风险评级、执行清单(谁做/何时/何凭证)、合规红线、依据文号与转交建议。以「可落地的执行清单」把概念落成可执行方案。适用于股东分配、架构选择、优惠临界点、资产处置前的方案比选。
【财友云】把财务口径的经营指标(本期/上期)翻译成老板听得懂、能拍板的大白话:趋势+异常提示+一句结论+关注点;严守"只转译不给投资建议"边界。
【财友云】内置海关总署(GACC)英文站 Legislation 三栏目(Laws & Regulations / Customs Announcements / Customs Decrees)的条目离线索引(约 46 条),输入英文关键词即可在本地做大小写不敏感的多词 AND/OR 匹配,返回标题 / 栏目 / 发布日期 / 原文链接。适用于涉外商事、跨境合规、外贸法务在英文场景下快速定位中国海关法规原文入口。只做索引检索与定位,不解读法规、不翻译。数据为离线快照、版本可查,运行时零联网。
【财友云】双模式涉税风险排查:① 关键词特征匹配(私户收款/两套账/虚开等)→ 关注等级+依据+核查方向;② 金税四期量化指标勾稽(税负率/毛利率/工资社保个税三方/进销项勾稽等)→ 偏离度+红线+勾稽信号。只提示「可能触发关注」,不下违法定性结论。适用于税务自查、内控体检、涉税风险排查。
【财友云】白条入账、暂估成本余额、成本费用率波动、工资薪金三方比对,输出差异项清单。
【财友云】批量导入候选供应商财务快照,按公开阈值筛出经营不稳定者,输出 pass/watch/reject 分级清单。
【财友云】把各平台后台收入报表与申报收入做口径对齐,差异拆成口径差/期间错配/待核实三类。
【财友云】工资薪金累计预扣预缴、综合所得年度汇算多退少补、年终奖两种计税方式对比,本地纯计算。