用途：评估公司向股东返还现金的水平是否恰当，围绕三个问题展开——实际返还了多少现金、本可返还多少、以及是否信任管理层处理差额。脚本只负责前两个问题的算术并给出信任证据评分，第三个问题仍需人为判断。
主要能力：以子命令形式提供多类分析，全部读取 JSON（stdin 或 --in FILE）并输出 JSON。fcfe-history 用 1–10 年报表和债务比率计算三种口径的 FCFE，与已返还现金对比，给出盈余或缺口、派现率，并标记 accumulator 或 overpayer；trust 依据净利润、账面权益、股票与市场收益、贝塔计算年度 ROE、要求回报、Jensen alpha 及项目质量判定；matrix 按 FCFE、已返还现金、ROE、股权成本给出矩阵象限与建议；sustainability 做五年 FCFE 预测、预期股利与回购能力、可持续股利增长上限；peers 做同业收益率、派现与现金返还统计及位次；market-norms 依据 2014 年 1 月美国横截面回归预测派现与收益率；bank-fcfe 用监管资本口径计算银行或保险公司的 FCFE。
使用方式：脚本为纯标准库、无需安装。python3 resources/payout.py <subcommand> --example 查看输入结构，--in payload.json 读取文件，selftest 验证引擎。分析顺序建议：先量实际返还（分红加回购），再算五年三种 FCFE 变体，评分信任证据，读矩阵象限，做前瞻可持续性检验，最后与同业和市场交叉核对。
适用场景：上市公司派现与回购政策评估、管理层资本配置判断、同业派现对照、银行保险的股东现金回报测算。
限制：内置数据为 Damodaran 案例，数据版本标注 2020-01 与 2014-01，材料提示回购强度自 2020 年以来已变化，需检查版本并按需刷新；当前债务比率若无则暂未提供获取方式之外的替代；脚本只对信任证据评分，最终判断依赖人与治理。具体收费、订阅价格、运行环境要求等资料中暂未提供。