opslog 工单报表助手
把「腾讯文档智能表里的工单流水」变成「可直接汇报的 HTML 报表 + AI 提炼结论」的标准化流程。每天省下 10–15 分钟日报整理时间。
数据链路
腾讯文档智能表（工单流水）
│ Python 脚本拉取（file_id / sheet_id 由用户输入）
▼
数据清洗（类别归一化：打印故障 / 其他 / 应用软件 / 硬件 / 网络…）
▼
HTML 报表生成（年度总览 + 日度明细，图表可视化）
▼
AI 提炼（带 ✅⚠️❌ 状态的精简表格结论）
▼
交付（企业微信 / 邮件 / 群内汇报）
关键参数（不内置，每次由用户提供）
file_id：腾讯文档智能表文件 ID（如<YOUR_FILE_ID>）sheet_id：工作表 ID（如<YOUR_SHEET_ID>）- 统计周期：年度 / 月度 / 日度
- 维度：按类别、按处理人、按状态
⚠️ 严禁把 file_id/sheet_id 写死在技能里——用户换表格就失效。
实现要点（踩坑记录）
- 腾讯文档智能表 add_records 写格式：字段值格式有严格要求，批量写入前先读一次表结构，按字段类型（文本/多选/日期）构造数据。
- update_fields 的 22030 平台 bug：更新字段可能报
22030平台错误，属腾讯文档已知缺陷，处理方式为「先查询记录 ID → 逐条更新 → 失败重试一次 → 仍失败则记录待办」。 - Windows 命令行长度限制：命令拼接超长（>8191 字符）会直接失败，长 SQL/大 JSON 请写入临时文件再调用，避免内联传参。
- 中文编码：Windows 下脚本文件用 UTF-8 保存并显式指定
encoding="utf-8"读写，避免工单内容乱码。 - 日期字段：智能表日期列建议统一为
YYYY-MM-DD，排序与聚合才不会错。
报表规范
HTML 报表结构
- 顶部：统计周期、总工单数、各状态占比（✅处理中 ⚠️待跟进 ❌已阻塞/异常）
- 中部：类别分布图（柱状/饼图，中文环境用红涨绿跌无关，按语义配色）
- 底部：明细表（日期 | 类别 | 描述 | 处理人 | 状态）
AI 提炼格式（最终汇报用）
| 维度 | 数据 | 状态 |
|---|---|---|
| 今日总工单 | 12 条 | ✅ |
| 打印故障 | 5 条（占 42%） | ⚠️ 偏高 |
| 待跟进 | 3 条超 24h | ⚠️ |
| 阻塞项 | 1 条（等待配件） | ❌ |
规则：每条结论必须带 ✅/⚠️/❌ 之一；异常项必须给出「原因 + 建议动作」。
执行入口
用户说「生成今天的工单日报」「做一下月度工作量报表」「上周工单情况怎么样」即触发：先要 file_id/sheet_id（或询问是否沿用上次），再走完整链路。
参考脚本
scripts/fetch_tickets.py：拉取智能表数据的参考实现（占位，由用户提供凭据后运行）。
反馈与评分
如果这个技能帮到了你，欢迎去 SkillHub 给它打星并留言：https://skillhub.cn
你的评分和反馈是我持续迭代（补报表模板、修平台坑、加分析维度）的直接动力。
