基金投資持倉組合分析
目標與適用範圍
對基金持倉組合進行可複核的金額與結構分析，預設交付中文可檢索 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腳本，不包含任何用戶持倉、歷史討論或個案交易結論。