<!-- PAYSKILL_UNIFORM v1 -->

付费说明（Pay Skill · 0.1 元/次）

本技能已接入支付宝 AI 按量付费（Pay Skill），每次成功调用收费 0.1 元，由 SkillHub / SkillPay 按次统一计费，采用支付宝 A2M 协议（HTTP 402 Payment Required）：未付费调用返回 402 与 Payment-Needed 账单，用户完成支付后凭 Payment-Proof 重试，平台完成验付与履约确认后返回结果（Payment-Validation）。订单按 out_trade_no 持久化并保证幂等，避免重复扣费。

拍照生成EXCEL

一、痛点前置摘要

你一定遇到过这些场景：拍了一张表格照片想转成 Excel 慢慢算，却只能手抄；白板讨论完拍了照，
回头要整理成文档却无从下手；发票、报表、名单截图堆在相册里，永远没法直接编辑复用。

拍照生成EXCEL 把「图片」到「可编辑办公文档」的链路压缩到一步：拍照/上传 → 自动识别
→ 生成 Excel 或 Word → 预览下载。不再手抄、不再复制错行、不再为排版头疼。

二、能做什么

• 表格 / 数据类图片 → 生成 Excel：自动建表、表头加粗、冻结首行、数值列保留为可计算数字。
• 文字 / 文档类图片 → 生成 Word：自动区分标题、正文、列表、表格，并加表格边框。
• 混合内容图片 → Excel + Word 双产出：数据进表，说明进文档，完整保留原始排版与数据关系。
• 多场景适配：发票、报表、名单、题库、会议纪要、名片、白板、教材、合同、收据、盘点表……
• 即开即用：支持图片上传、相机拍摄、截图、扫描件；生成后可直接预览与下载。

三、四步出文档工作流

① 提供图片  →  ② AI 视觉识别  →  ③ 结构化 JSON  →  ④ 自动适配生成  →  ⑤ 预览下载
   发图/上传      判断 表格/文字/混合    保留行列与层级       .xlsx / .docx

1. 提供图片：在对话里直接发图，或相机拍摄、上传截图/扫描件。
2. 视觉识别：AI 判断图片主体是表格数据、文字内容、还是二者混合。
3. 结构化整理：把识别结果整理为统一 JSON（见下方「输出字段」），保留原有行列关系与层级。
4. 自动适配输出：
   - 表格/数据 → 仅 .xlsx
   - 文字/文档 → 仅 .docx
   - 混合 → .xlsx + .docx 同时生成
5. 预览与下载：对话内直接预览，并下载到本地二次编辑。

四、能力体系表

五、输出字段 / 格式说明

识别阶段产出的结构化 JSON（由 AI 整理，渲染层消费）：

{
  "title": "文档标题",
  "content_type": "auto | table | text | mixed",
  "tables": [{"name": "Sheet1", "header": true, "rows": [["列1","列2"],[1,2]]}],
  "paragraphs": [
    {"text": "正文段落"},
    {"level": 1, "text": "小节标题"},
    {"items": ["列表项1", "列表项2"]}
  ]
}

• content_type=table → 强制仅 Excel；text → 强制仅 Word；auto/mixed → 按内容自动判定。
• 数值单元格传 int/float（如 1200.5），保证 Excel 内为可计算数字；文本传 str。

六、适合谁用

• 财务 / 仓管 / 采购：把纸质报表、发票、盘点表快速数字化进 Excel。
• 行政 / 文秘：把白板、笔记、会议照片整理成规范 Word 纪要。
• 教师 / 培训：把教材、试卷截图转成可编辑题库或讲义。
• 销售 / 商务：名片、报价单、名单截图一键结构化。
• 任何想把「图片里的信息」变成「能用的文档」的人。

七、⚠️ 注意事项

• 识别质量依赖图片清晰度：光线均匀、正对拍摄、避免重度阴影与透视畸变，识别更准。
• 复杂排版需人工复核：合并单元格、跨页长表、艺术字、印章遮挡等，建议生成后快速核对。
• 手写体识别有限：印刷体效果最佳；工整手写可识别，潦草手写建议人工校正。
• 隐私安全：含敏感信息（证件、合同、财务）的图片请在可信环境处理，勿外传。
• 渲染零依赖、识别有边界：本技能底层生成器纯标准库、可离线运行；图片→结构化这一步
  依赖运行环境的视觉能力，属预期设计（识别与渲染解耦，保证输出稳定）。

八、触发词

拍照转Excel、图片转Excel、照片转文档、图片识别生成表格、OCR转Excel、截图转Word、
把表格照片变成Excel、白板转文档、发票识别、名单整理、题库转Excel、会议纪要生成、
图片结构化、扫描件转表格、拍照录入、无纸化办公、图片转文档。

九、文件清单

• examples/build_office.md — 零依赖 Office 生成器源码（生成 .xlsx / .docx 的确定性内核）
• examples/photo_to_excel.md — 端到端生成器源码（接收识别 JSON，自动适配输出格式）
• examples/usage.md — 完整使用指南与 JSON Schema、CLI 用法
• examples/example_output.md — 门店盘点表等示例的输出结构与内容

版本说明

• v1.0.0（首发）：实现「图片→结构化 JSON→自动适配 .xlsx/.docx」完整链路；
  零依赖 Office 生成器（多 sheet、表头加粗、冻结首行、数值保真、Word 标题/段落/列表/表格边框）；
  支持纯表/纯文字/混合三种自动判定与强制指定；预览下载。

进化记录

• 2026-08-26 v1.0.9（数据驱动自查更新）
• 同类标杆匹配：归入「office-efficiency」分类，基于平台头部技能榜匹配到 5 个同领域头部技能（如 腾讯文档 TENCENT DOCS、Gog、腾讯会议），提取其高共识能力标签做补强。
• 标签已较完整，本次保持。
• 客户评分维度：经实测本批技能均为新建技能，平台评论/评分当前为空，本次以同类标杆特征驱动优化；后续将随真实使用数据持续迭代。