用途：为折现估值构建资本成本（折现率），并估算最优融资结构。所有算术已脚本化，使用者负责选择并论证输入（可比公司、溢价估计方法、总债务或净债务等）。
主要能力：resources/costofcapital.py 提供 rating（合成评级与债务成本）、beta（自下而上/总贝塔）、mv-debt（债务市值）、wacc、debt-schedule（各负债率下的资本成本与最优点）、implied-erp（隐含股权风险溢价）、apv、stress（压力测试）、convert-rate（跨币种利率换算）等子命令；resources/reference_data.py 提供 lookup、erp-for-operations、vintage 等参考数据查询。
使用方式：两个脚本均为纯标准库，无需安装。子命令从 stdin 接收 JSON，或用 --in FILE 指定文件，输出 JSON；可用 --example 查看输入结构，用 selftest 验证引擎。示例：python3 resources/costofcapital.py selftest；python3 resources/reference_data.py lookup --in payload.json。
适用场景：企业估值、WACC 构建、最优资本结构分析、APV 交叉验证、国家风险溢价与跨币种折现率处理。
限制：银行等金融服务企业不适用最优负债率计算，其融资结构由监管资本决定；贝塔、破产成本比例、违约概率等为判断性输入，结果应视为区间；参考数据表带 as_of 日期，需注意时效；脚本不提供数据自动更新，需自行核对输入与币种一致性。