O que 基金投资持仓组合分析 faz?
目标与适用范围
对基金持仓组合进行可复核的金额与结构分析，默认交付中文可检索 PDF。适用于股票型、混合型、指数、债券、货币、商品、黄金等基金；基金外的资产如需纳入，应明确其类型及统计边界。
报告只陈述核实后的数据、计算结果和必要的简短注释。不得默认输出“核心判断”“现在动作”“优先研究”“建议买卖/换仓”“板块增减指令”；资产结构不直接推出交易建议。用户要求交易决策时另行分析，必须有实时估值与基本面、持有期限、实际费率、风险承受度、可投入资金及交易机会成本等证据，否则明确无法可靠判断，不把理论测算当投资推荐。
输入与分类
- 必填：每项基金的代码或名称、当前市值
V、当前持仓累计盈亏P（正数盈利，负数亏损）；币种默认为人民币；账户快照日期应标明。 - 可选：基金名称、基金类型、所属主要投资类别、份额类型、购买和赎回记录、分红、费用、成本明细等。
- 已卖出基金不计入当前持仓；若用户另提供已实现亏损，单独记录，不能自动混入当前持仓的市值与盈亏。
- 持仓分类根据基金合同、定期报告及用户明确给出的基金属性确定。无法核实则标注“待分类”。同一市值只能放入一个主类，禁止重复统计。分类是基金产品层面的统计，不等于底层证券穿透比例。
- 用户只给代码而未给类别时，可以核实公开资料；输入日期不同不得误标为同一天实际持仓。所有报表标清用户账户快照日期与外部资料日期。
C = V-P是按账户持仓盈亏反推的当前持仓成本，不一定是历史所有现金流投入总和；遇到部分赎回、分红、转托管等情况必须说明该局限。
精确计算
使用十进制金额运算（Decimal），仅在展示时四舍五入；最低补仓金额须向上取整到分。
设 V 为当前持仓市值，P 为持仓累计盈亏，C=V-P，r>0 为从当前价开始、未来假设上涨的比例。
| 统计项目 | 算式 |
|---|---|
| 持仓收益率 | P/C |
| 单只亏损基金不补仓回本所需上涨 | -P/V |
假设未来上涨 r 时单只回本所需追加金额 | A=max(0,-P/r-V)，已盈利时为0 |
补仓 A 后回本所需涨幅 | -P/(V+A)（亏损时） |
| 组合总市值、总盈亏、总成本 | ΣV、ΣP、ΣC |
| 组合总收益率、整体不补仓回本涨幅 | ΣP/ΣC、亏损时 -ΣP/ΣV |
| 每只基金分别回本的合计补仓 | Σmax(0,-Pᵢ/r-Vᵢ)（盈利项为0） |
| 整个账户盈亏互抵的理论补仓 | max(0,-ΣP/r-ΣV)，假设全部持仓统一上涨 r |
默认测算 r=10% 与 r=20%，用户可改。对补仓正数验证 (V+A)×(1+r)≥C+A，用精确小数复核合计。默认不输出额外的补仓原理、验算案例或组合回本情景解释页，保证非专业读者可直接看表。
PDF 固定内容（默认仅两页）
统一报告名称及封面标题：基金投资持仓组合分析。不使用“诊断”“核心判断”“执行建议”等其他主标题。
- 账户概览：快照日期、持仓数量、当前市值、推算成本、累计盈亏、整体收益率、整体回本涨幅。只给数字与必要定义；不放投资意见或重复的资产结构图。
- 唯一持仓总表：
基金/代码｜当前市值｜盈亏及收益率｜不补仓回本需涨｜未来涨10%回本需补｜未来涨20%回本需补。总表结尾用一句简短说明：两列合计为各基金分别回本的测算，不是投资建议。亏损数字用红色、盈利用绿色；单项补仓额默认 ≥10,000元用红色加粗并提示高额；用户可修改阈值。金额准确到分。不加入没有充分证据的“当前动作/判断”列。 - 持仓资产分布：只保留一组详细的带文字标签横向条形图，每行直接显示分类、条形、比例和金额。分类互斥且金额之和等于总市值。附每类包含的基金、最大单只持仓占比及分类统计口径。不得再在首页或图表上方绘制重复的彩色横向堆叠图；不得出现只有颜色无文字的图表。
不默认生成换仓分析、择时分析、调整前后对比或推断性的板块增减内容。 这些属于另一个需要证据支撑的交易研究任务，不能从单纯市值、盈亏和分布比例得出。
呈现与质量
- A4竖版、中文、可检索；图表与表格中文字清晰可读，适合手机放大查看；页数以内容完整为准，不刻意铺满或扩写。
- 分类使用稳定配色，但分类文字和数值必须随条形直接显示。高额补仓红色突出；普通金额与标题不滥用颜色。
- 不能用原持仓浮亏或条件补仓额推导“值得补”“需要卖”“应买宽基”等操作意见；不要添加泛化的市场前景判断。
- PDF文件名：
基金投资持仓组合分析_YYYY-MM-DD.pdf。保留报告对应的快照日期，以便跨期比较。 - 生成后渲染检查持仓表和分类条形图，检查中文与数字不遮挡、不缺字；核对
ΣC=ΣV−ΣP与分组金额守恒。
生成方法
通用脚本：
scripts/portfolio_calc.py：十进制精算与金额校验。scripts/build_report_pdf.py：读取 JSON，调用精算脚本并生成中文PDF，支持--html输出 HTML 供复核。
运行：python scripts/build_report_pdf.py input.json output.pdf。输入示例结构：
{
"as_of": "YYYY-MM-DD",
"currency": "CNY",
"scenarios": ["0.10", "0.20"],
"highlight_threshold": "10000",
"positions": [
{"code": "基金代码", "name": "基金简称", "market_value": "当前市值", "pnl": "当前盈亏", "category": "基金主类"}
],
"sold_excluded": []
}
ZIP只包含通用 Skill 和计算、PDF脚本，不包含任何用户持仓、历史讨论或个案交易结论。