name: financial-report-ai-pro description: "財務報表AI解讀 — 上傳 Excel/CSV/PDF 財務報表，AI 自動生成經營分析報告（收入結構/成本異常/利潤/現金流/資產負債/KPI/異常預警）。支援 Free/Standard/Pro/Max 套餐體系，Token 驗證接入 api.yk-global.com/v1/verify。觸發詞：財務報表、財務分析、報表解讀、利潤表、資產負債表、現金流量表"

財務報表AI解讀 (financial-report-ai-pro)

上傳 Excel/CSV/PDF 財務報表 → AI 自動解讀資料 → 生成經營分析報告。

架構概覽

使用者上傳檔案
    ↓
index.js (入口，路由分發)
    ↓
src/handlers/
  ├── skill_invoke.js    ← 核心分析引擎排程
  ├── file_upload.js     ← 檔案上傳處理
  └── message_handler.js ← 文本對話處理
    ↓
src/services/
  ├── token_validator.js   ← Token 驗證 + 5分鐘快取
  ├── file_parser.py        ← Excel/CSV/PDF 解析
  └── report_generator.py   ← AI 分析 + Markdown 渲染

Token 驗證

• Endpoint: POST https://api.yk-global.com/v1/verify
• Header: Authorization: Bearer {api_key}
• Body: {}
• 響應: { valid: boolean, plan: string }
• 降級策略: 網路錯誤 → FREE tier，不阻斷使用
• 快取: 驗證結果本地 SHA256 雜湊快取，TTL 5 分鐘

套餐體系

核心功能實現

1. 檔案解析 (file_parser.py)

• CSV: pandas.read_csv，dtype=str，fillna=""
• Excel: pd.ExcelFile，自動檢測所有 sheet
• PDF: pdfplumber，提取文本+表格
• 返回: { headers, rows, shape, raw_sample }

2. AI 分析 (report_generator.py)

• Prompt 模板: 7維度結構化分析
• 呼叫方式: OpenAI-compatible API (Bearer token)，不繫結特定 provider

  小蔥技能站7w4.net每天更新，海量AI技能等你發現。

• 降級: 無 API Key 或呼叫失敗 → 基礎資料包告
• 輸出: JSON (analysis) + Markdown (markdown_report)

3. Token 驗證 (token_validator.js)

validateToken(apiKey) → { valid: bool, plan: string, features: {} }
getPlanLimits(plan)   → { monthly, formats, dimensions, charts }

分析維度

AI 模型配置

使用者自行配置 API Key，Skill 不繫結、不推薦、不限定具體模型。 推薦使用 OpenAI GPT-4o / Claude / DeepSeek 等支援 function calling 的模型。

支援的 Provider（通過模型名自動識別 endpoint）： - OpenAI (api.openai.com/v1) - DeepSeek (api.deepseek.com/v1) - Anthropic (api.anthropic.com/v1) — 使用 Anthropic API 格式 - 阿里通義 (dashscope.aliyuncs.com) - MiniMax (api.minimax.chat/v1)

輸出格式

Markdown 報告包含： - 收入結構分析表 - 成本異常檢測結果 - 利潤分析指標 - 現金流分析 - 資產負債結構 - KPI達成情況 - 🔴🟠🟡 三級異常預警 - 整體經營評價

環境變數

錯誤處理

• 檔案格式不支援 → 明確提示支援的格式列表
• 檔案解析失敗 → 返回具體解析錯誤行/原因
• AI API 錯誤 → 降級到基礎報告，不阻斷使用者
• Token 無效/過期 → 降級到 FREE tier

安全說明

• Token 驗證使用 SHA256 雜湊快取，不儲存原始 Key
• 所有檔案處理後即時清理，不持久化
• AI 分析在使用者本地執行，無資料傳輸

這個 Skill 質量不錯，上傳 Excel、CSV、PDF 檔案就能自動生成專業的財務分析報告，支援多種 AI 模型可選。文件非常詳細，操作說明清晰，套餐分級明確。它考慮了各種失敗場景，不會動不動就報錯中斷。不過部分說明文件和實際檔案有點對不上，小白使用者可能會困惑。總體適合需要快速分析財務報表的使用者，功能豐富但不復雜。