文档可视化

文档可视化 Skill

将任意格式文档（飞书文档/Word/PDF/Excel/Txt）一键生成深色指挥中心风格HTML可视化看板 + PDF/长图。

触发方式

用户在飞书发送以下任意形式即可自动触发：

飞书文档链接（如 https://my.feishu.cn/docx/xxx）

附件文件（Word/Excel/PDF/Txt）

任何包含数据的内容文本

使用流程

用户发送文档
    ↓
[Step 1] 解析文档（自动识别格式）
    ↓
[Step 2] 数据分析 + 生成可视化配置
    ↓
[Step 3] 生成5种主题HTML供用户选择
    ↓
[Step 4] 用户确认主题
    ↓
[Step 5] Playwright导出PDF + 长图
    ↓
[Step 6] 发送文件路径给用户

5种主题（发送时指定）

| 主题 | 参数 | 风格 | |------|------|------| | 科技蓝 | --theme THEME_BLUE | 顾家原版深蓝 | | 商务红 | --theme THEME_RED | 红黑商务 | | 自然绿 | --theme THEME_GREEN | 绿色清新 | | 皇家紫 | --theme THEME_PURPLE | 紫金高端 | | 活力橙 | --theme THEME_ORANGE | 橙暖活力 |

示例指令： "帮我把这个飞书文档做成可视化看板，用皇家紫主题"

支持格式

| 格式 | 解析方案 | |------|---------| | 飞书文档链接 | feishu_fetch_doc → markdown解析 | | Word (.docx) | python-docx | | Excel (.xlsx) | openpyxl（多Sheet） | | PDF (.pdf) | pdfplumber | | Txt / CSV | 直接字符串读取 |

可视化组件（自动匹配）

根据文档内容自动选择最合适的可视化方式：

📊 财务卡片网格 - 自动提取数字指标

📰 时间轴 - 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