如何生成准确清晰的投资组合业绩报告（含基准对比…

当需要向客户或机构汇报投资组合业绩、进行基准比较、风险展示或目标进度跟踪时，用标准化周期、归因分析和可视化生成清晰准确的报告。

适用场景

解决思路

1. 报告标准时间段：MTD、QTD、YTD、1Y、3Y、5Y、10Y 及成立以来（since inception），并始终注明确切的成立日期。
2. 仅对超过 1 年的期间做年化；不足 1 年只报累计（总）收益，避免把 3 个月收益年化造成误导。年化公式：`(1 + cumulative_return)^(1/years) - 1`。
3. 多年期同时给出累计和年化两个数字，让读者既看到总财富增长也看到复利速率。
4. 明确标注收益是费前还是费后（管理费、顾问费、交易成本）；以费后收益作为主要展示，若展示费前收益则同时展示费用拖累。
5. 机构报告遵循 GIPS 要求：composite 构建、充分披露、经核验的计算和标准化呈现；非 GIPS 报告也遵循公平呈现与充分披露原则。
6. 区分时间加权收益（TWR，剔除现金流影响，用于评价管理人能力）与资金加权收益（MWR/IRR，反映投资者实际体验，用于评价投资者结果）。
7. 用 `scripts/performance_reporting.py` 中的 `ModifiedDietz` 近似 TWR：R = (V_end - V_start - sum(CF)) / (V_start + sum(w_i * CF_i))，其中 w_i = (D - d_i)/D；在无每日估值时是 GIPS 可接受的近似。
8. 用 `TimeWeightedReturn` 做真实 TWR：链式连接子期收益 prod(1 + r_t) - 1，并使用拒绝不足 1 年年化的辅助函数。
9. 用 `MoneyWeightedReturn` 计算 IRR/MWR：在包围区间上用 Brent 求根法（`scipy.optimize.brentq`）数值求解 NPV(rate) = 0，返回年化资金加权收益。
10. 用 `CompositeReturn` 计算 GIPS composite：以期初价值为权重的资产加权收益、等权收益，以及 6 个以上组合时 GIPS 要求的资产加权内部离散度。
11. 用 `PeriodReturns` 从日收益序列生成 MTD/QTD/YTD 式滚动窗口（1M 到 10Y）及成立以来收益，仅对 1 年及以上期间年化。
12. 选择与组合投资风格、地域、市值和资产类别匹配的基准；多资产组合用混合基准（如 60% S&P 500 / 40% Bloomberg Aggregate）。
13. 基准应可投资（投资者本可持有作为被动替代），记录选择理由并长期保持一致，避免事后挑选。
14. 计算主动收益（alpha）= 组合收益 - 基准收益；报告中同时展示跟踪误差和信息比率，让读者判断超额收益的持续性。
15. 风险仪表盘当前快照指标：年化波动率、最大回撤与当前回撤、95% 和 99% 置信水平的 VaR、相对基准的 Beta。
16. 风险仪表盘滚动指标：12 个月滚动 Sharpe、12 个月滚动波动率、36 个月滚动 Beta、滚动回撤图。
17. 风险暴露分解：行业集中度与相对基准权重、因子暴露（价值、成长、动量、质量、规模）、地域配置、固定收益的久期与信用质量。
18. 用 Brinson 归因（配置、选择、交互）和因子分解解释超额/落后原因；报告中每个效应用一句通俗语言总结（如“行业权重贡献 0.2%，选股贡献 0.4%”）。
19. 列出贡献最大和最小的 5-10 只持仓，同时展示该持仓收益及其对组合总收益的贡献（权重 x 收益），并对每个主要贡献者简要评论原因。
20. 对目标型投资者做进度跟踪：判断组合相对财务计划是领先、落后还是达标。
21. 用 Monte Carlo 模拟估计达成目标的概率（基于当前资产、储蓄率、时间跨度和预期收益/风险假设），以百分比表达（如“65 岁退休资金到位概率 82%”）。
22. 比较达成目标所需收益与当前组合预期收益；若所需收益超出合理范围，标记为规划缺口。
23. 用“已融资百分比”表达进度，例如“退休目标：$2,000,000。当前组合：$850,000。已融资 42.5%，剩余 15 年”。
24. 可视化选择：用“$10,000 增长图”展示组合与基准的累计财富增长，长时间段用对数刻度避免复利造成的视觉失真。
25. 用滚动收益图展示过去 12 或 36 个月收益，揭示一致性和市场状态变化，比单一多年化数字更有信息量。
26. 用回撤图展示峰谷下跌，比波动率数字更直观地传达风险。
27. 用资产配置饼图/柱状图展示当前配置与目标/基准对比，用分组柱状图并排展示。
28. 用风险-收益散点图把组合和基准（及可能的同业组）放在年化收益 vs 年化波动率平面上，左上方（高收益低风险）为理想位置。
29. 按频率组织报告：月度简报 1 页（头条收益、基准对比、主要归因驱动、重大事件）；季度详细报告 3-5 页（完整收益表、归因、风险仪表盘、目标进度、市场评论与展望）；年度综合报告 8-15 页（季度内容加年度回顾、税务报告摘要、规划更新和 IPS 审查）。
30. 用通俗语言沟通：不要只说“组合 YTD 收益 8.1%”，要补充背景“组合 YTD 收益 8.1%，超越基准 0.6 个百分点，主要来自科技板块的强劲选股”。
31. 说明业绩相对预期和计划是好是坏，使用受众能理解的类比和比较，首次使用技术术语时定义或附术语表，先给结论再给支持细节。
32. 运行脚本：`uv run scripts/performance_reporting.py`（PEP 723 头自动解析 numpy/scipy），或 `pip install numpy scipy` 后用 `python3 scripts/performance_reporting.py`；裸运行打印五个演示（Modified Dietz、链式 TWR、Brent 法 IRR、GIPS composite 摘要、标准周期收益表），`--verify` 断言演示输出匹配预期值（PASS 时退出码 0），`--help` 查看类概览；该文件主要作为模块导入（如 `from performance_reporting import ModifiedDietz, MoneyWeightedReturn`）。

适用边界 · 注意事项

• 不要挑选有利时间段展示业绩以美化表现，应始终展示标准周期和成立以来收益。
• 不要只展示收益而不展示风险，也不要用不合适的基准来抬高业绩（如在成长风格占优时把成长股基金与价值指数比较）。
• 不要对不足 1 年的短期收益做年化（如把一个月 5% 说成“年化 60%”），也不要在有大额或时机不佳现金流时只展示 TWR 而不展示 MWR。