KDocs 菜谱截图与通知生成

从金山文档云表格读取菜谱 → 生成截图 → 发送图片 → 附带通知文案。

前置依赖

本技能依赖 kdocs-skill（提供 kdocs-cli 工具）。使用前必须检查：

kdocs-cli version

• 已安装：继续执行后续流程。
• 未安装：提示用户先安装 kdocs-skill 并完成认证配置，再继续。

安装方式：

skillhub install kdocs-skill
# 或从 SkillHub 商店下载

安装后需完成认证：

kdocs-cli auth set-token <token>

工作流程

1. 认证检查

kdocs-cli auth status

若未认证，引导用户提供 Token 并执行 kdocs-cli auth set-token 。

2. 获取文件标识

从用户提供的链接提取 link_id（URL 末尾部分），或从 get-share-info 获取 file_id 和 sheetId：

kdocs-cli drive get-share-info '{"link_id":"<link_id>"}' --silent

3. 读取表格数据

kdocs-cli sheet get-range-data '{"file_id":"<file_id>","sheetId":<sheet_id>,"range":{"rowFrom":0,"rowTo":20,"colFrom":0,"colTo":7}}' --silent > /tmp/menu_data.json

4. 生成截图

python3 scripts/render_menu.py /tmp/menu_data.json /home/gem/workspace/agent/media/menu_screenshot.png

脚本路径相对于本 skill 目录。输出到 media/ 目录以便发送。

5. 发送图片

使用 message 工具发送 /home/gem/workspace/agent/media/menu_screenshot.png。

6. 生成通知文案

从表格数据中提取本周特色菜品（通常是中餐第一行的菜品），写一段约20字的通知：

• 包含 emoji 表情
• 突出本周特色菜品
• 简洁活泼

示例：

> 🍽️ 本周菜谱已更新！😋 特色推荐：糖醋排骨、红烧手工狮子头、徐州把子肉，周三轻餐日别错过～

默认配置

渲染脚本

scripts/render_menu.py — 将 API 返回的 JSON 数据渲染为纯白底黑字 PNG 图片，自动处理合并单元格。