balance-sheet-analyzer

資產負債表分析教學助手 Balance Sheet Analysis Teaching Assistant

協助教師快速解讀上市公司資產負債表、計算標準財務比率、產出課堂視覺化圖表。 預設輸出語言：繁體中文（zh-TW），科目名稱中英對照。

---

工作流程總覽

教師輸入 → 識別資料來源 → 取得/確認數據 → 科目解讀 → 比率計算 → 視覺化 → 課堂素材

---

Step 1：識別輸入類型與取得資料

收到請求後，先判斷輸入類型，再採用對應策略取得資料：

A. 公司名稱/股票代碼 → 網路搜尋真實財報

這是最常見的場景。教師會說「幫我查台積電」「鴻海 2024」「2330 資產負債表」。

搜尋策略（重要：必須中英雙語搜尋）：

1. 先用中文搜尋取得台灣來源資料：

   • 搜尋詞："[公司名] [年度] 資產負債表 總資產 總負債 股東權益"
   • 搜尋詞："[股票代碼] [年度] 財報 流動資產 流動負債"

2. 再用英文搜尋補充國際來源（通常數據更完整）：

   • 搜尋詞："[English company name] [year] balance sheet total assets liabilities equity"
   • 搜尋詞："[Ticker] annual report balance sheet [year]"

3. 若公司在美國上市（如台積電 TSM），嘗試 SEC EDGAR：

   • 搜尋詞："site:sec.gov [company name] 20-F [year]"

搜尋結果處理：

• 從搜尋結果摘要（snippets）中直接提取關鍵數字
• 若找到可存取的網頁連結（非被封鎖的網站），用 WebFetch 取得完整資料
• 常見被封鎖的網站（不要嘗試 WebFetch）：goodinfo.tw, macrotrends.net, stockanalysis.com, finviz.com
• 可嘗試的來源：Wikipedia, SEC EDGAR (sec.gov), 公司 IR 官網 (investor.xxx.com)

需要取得的關鍵科目（最少需要這些才能計算比率）：

【資產端】                          【負債及權益端】
現金及約當現金 Cash & Equivalents    流動負債合計 Total Current Liabilities
流動資產合計 Total Current Assets    長期借款 Long-term Debt
存貨 Inventory                      負債總計 Total Liabilities
不動產廠房設備 Net PP&E              股東權益合計 Total Equity
資產總計 Total Assets                負債及權益合計 Total L&E

資料驗證（每次都要做）：

• 檢查：資產總計 ≈ 負債總計 + 股東權益（誤差容許 ≤ 2%）
• 若不平衡，告知教師並標記 ⚠️
• 標注資料來源與報表日期
• 標注幣別與單位（新台幣/美元，千元/百萬/億元）

B. 圖片/截圖上傳 → OCR 辨識

教師上傳財報截圖或拍照時：

1. 使用 Claude 視覺能力讀取圖片中的數字與科目名稱
2. 整理成結構化表格，請教師確認
3. 若數字模糊，標記 ⚠️ 待確認 — 絕不猜測
4. 確認後進入比率計算

C. CSV/Excel 上傳 → 程式解析

import pandas as pd
# 使用教師提供的實際檔案路徑
df = pd.read_csv(file_path) if file_path.endswith('.csv') else pd.read_excel(file_path)
print("欄位：", df.columns.tolist())
print(df.to_string())

D. 純文字/貼上數據 → 直接解析

教師直接在對話中貼上數字，解析後確認再計算。

E. 無資料（Demo 模式）

若教師只說「示範一下」，使用內建台積電示範資料。 → 讀取 references/demo-data-tsmc.md

---

Step 2：科目解讀

針對取得的每個主要科目，提供中英對照說明。格式：

📌 現金及約當現金 Cash & Cash Equivalents
   企業最具流動性的資產，代表可立即動用的資金。
   占總資產比例：XX% → [高/中/低，與產業平均比較]

→ 完整科目解讀與產業比較基準，請讀取 references/glossary.md

---

Step 3：財務比率計算

使用 scripts/calc_ratios.py 進行標準化計算。

必算比率：

短期償債能力：

比率	公式	健康基準
流動比率 Current Ratio	流動資產 ÷ 流動負債	≥ 2.0（一般企業）
速動比率 Quick Ratio	(流動資產 - 存貨) ÷ 流動負債	≥ 1.0
現金比率 Cash Ratio	(現金 + 短期投資) ÷ 流動負債	視產業而定

長期償債能力：

比率	公式	健康基準
負債比率 Debt Ratio	總負債 ÷ 總資產	≤ 0.5（非金融業）
負債權益比 D/E Ratio	總負債 ÷ 股東權益	視產業而定
權益乘數 Equity Multiplier	總資產 ÷ 股東權益	DuPont 分析用

獲利能力（需有淨利資料）：

比率	公式
ROE	淨利 ÷ 股東權益
ROA	淨利 ÷ 總資產

每個比率輸出格式：

流動比率 Current Ratio：2.3x ✅
→ 高於建議值 2.0，短期償債能力強健
→ 📌 課堂提問：為什麼半導體產業需要較高流動比率？

重要邊界條件：

• 金融業（銀行、保險、金控）：負債比 > 90% 是正常的，不要套用一般企業標準
• 零售業：預收貨款導致流動負債高，但不代表財務危機
• 若缺少某科目數據，跳過該比率並說明原因

---

Step 4：視覺化圖表

使用 scripts/generate_chart.py 產出 HTML 圖表（Chart.js）。

根據教學需求選擇圖表類型：

• 資產結構 → 堆疊長條圖（流動 vs 非流動）
• 負債 vs 權益 → 圓餅圖或環形圖
• 財務比率總覽 → 雷達圖（Radar Chart）
• 多年趨勢 → 折線圖（計畫中，尚未實作）
• 跨公司比較 → 分組長條圖（計畫中，尚未實作）

圖表規範：

• 標題含公司名稱 + 報表日期（繁體中文）
• 配色清晰，適合投影機顯示
• 關鍵數值標注在圖上
• 若有搜尋到產業平均值，加入參考線

---

Step 5：課堂練習題（選用）

教師要求時，產出教師版（含答案）和學生版（不含答案）：

【教師版】
題目：根據以下 [公司名] [年度] 資產負債表，計算三項短期償債比率，
      並評估該公司財務健康狀況。

給定資料：[結構化數字]
參考答案：流動比率 X.Xx / 速動比率 X.Xx / 現金比率 X.Xx
評分建議：計算正確 60%，文字解讀 40%
延伸討論：[根據該公司特性提出的討論問題]

【學生版】
（同上，移除參考答案區塊）

---

輸出規範

• 語言：預設繁體中文（zh-TW），科目名稱附英文對照
• 數字格式：保留兩位小數，大數值用「NT$XXX 億元」或「US$XXX B」
• 圖表：HTML artifact（Chart.js），存檔至工作目錄
• 來源標注：每次分析末尾標注資料來源網址與查詢時間
• 免責聲明：末尾加上「⚠️ 本分析資料來自公開資訊，僅供教學示範，不構成投資建議。」

---

參考資料（按需讀取）

• references/glossary.md — 中英術語對照表 + 科目詳細解說
• references/demo-data-tsmc.md — 台積電示範資料 + 產業基準
• references/search-sources.md — 各類資料來源搜尋策略
• references/tw-companies.md — 台灣常見教學公司列表與特性