文件視覺化 Skill

將任意格式文件（飛書文件/Word/PDF/Excel/Txt）一鍵生成深色指揮中心風格HTML視覺化看板 + PDF/長圖。

觸發方式

使用者在飛書傳送以下任意形式即可自動觸發： - 飛書文件連結（如 https://my.feishu.cn/docx/xxx） - 附件檔案（Word/Excel/PDF/Txt） - 任何包含資料的內容文本

小蔥技能7w4.net有完整的技能分類。

使用流程

使用者傳送文件
    ↓
[Step 1] 解析文件（自動識別格式）
    ↓
[Step 2] 資料分析 + 生成視覺化配置
    ↓
[Step 3] 生成5種主題HTML供使用者選擇
    ↓
[Step 4] 使用者確認主題
    ↓
[Step 5] Playwright匯出PDF + 長圖
    ↓
[Step 6] 傳送檔案路徑給使用者

5種主題（傳送時指定）

示例指令： "幫我把這個飛書文件做成視覺化看板，用皇家紫主題"

支援格式

視覺化元件（自動匹配）

根據文件內容自動選擇最合適的視覺化方式：

• 📊 財務卡片網格 - 自動提取數字指標
• 📰 時間軸 - 2024/2025/2026年份事件
• ⚔️ 對比表 - 多列資料對比
• 💼 SWOT四象限 - 優勢/劣勢/機會/威脅
• 🚀 四維戰略分析 - 進攻/防守/機會/威脅
• 📋 通用資料表格 - 結構化資料
• 📚 來源分佈統計 - emoji統計圖
• 🎯 訪談切入點 - 場景+話題建議

技術棧

• 解析：python-docx / openpyxl / pdfplumber
• HTML生成：自定義模板（CSS變數主題系統，無外部依賴）
• 匯出：Playwright page.pdf() + screenshot(full_page=True)
• 檔案輸出：~/.openclaw/workspace/visual_exports/{timestamp}/

檔案結構

skills/doc-visualizer/
├── SKILL.md               ← 本檔案
├── doc_visualizer.py      ← 主入口（CLI + 模組）
├── generator/
│   └── html_generator.py  ← HTML生成器（5種主題CSS內嵌）
└── exporter/
    └── exporter.py         ← PDF/長圖匯出（Playwright）

CLI用法

python doc_visualizer.py <檔案路徑> [--theme THEME_XXX]

# 示例
python doc_visualizer.py /path/to/report.xlsx --theme THEME_PURPLE
python doc_visualizer.py https://my.feishu.cn/docx/xxx --theme THEME_GREEN

Python模組呼叫

from doc_visualizer import run, parse_input, analyze_data

# 方式1：完整流程
result = run("/path/to/file.xlsx", theme="THEME_BLUE")
# 返回: {"html": path, "pdf": path, "png": path, "output_dir": path}

# 方式2：分步呼叫
info = parse_input("/path/to/file.xlsx")
parsed = parse_document(info)
viz_config = analyze_data(parsed)

依賴安裝

pip install python-docx openpyxl pdfplumber pandas playwright
playwright install chromium