feishu-doc-skill

# 飞书文档读写 当用户要求你“读取飞书文档”“总结飞书 wiki”“比较两个飞书页面”“抽取页面中的表格、接口定义、需求说明”“把内容写回飞书文档”“把本地截图插入飞书文档”等内容时，使用这个技能。 ## 默认策略 1. 先判断任务类型。 - 读取正文 - 输出 Markdown / JSON - 写回文档 - 插入本地图片 2. 优先走 API。 - 如果已经有 `FEISHU_USER_ACCESS_TOKEN`，优先使用用户身份读取和写入。 - 如果没有用户 token，可以直接运行 `scripts/feishu_oauth_server.js`，再在 `http://127.0.0.1:3333` 页面里填写 `App ID / App Secret` 发起授权。 - 也可以继续沿用环境变量方式启动 `scripts/feishu_oauth_server.js`。 3. 读取正文时： - 默认直接运行 `node scripts/read_feishu_url_md.js <飞书链接>`，不要先手动提取 token，脚本会自己处理链接和 token。 - 如果用户只想调试结构化返回，运行 `node scripts/read_feishu_url.js <飞书链接>`。 - 只有在需要看原始接口结构时，再运行 `node scripts/read_feishu_doc.js <doc_or_wiki_token>`。 - 如果本地已经有 `.feishu-user-token.json`，读取脚本会自动复用，不要求用户重复手填 `FEISHU_USER_ACCESS_TOKEN`。 4. 插入图片时： - 只支持“本地图片路径”，不直接复用聊天里的图片附件。 - 运行 `node scripts/insert_feishu_local_image.js <飞书文档链接或 token> <本地图片绝对路径>`。 - 如果需要说明文字，再加 `--caption '说明文字'`。 ## 输出要求 读取成功后，输出应包含： - 文档标题 - 来源链接 - 简洁总结 - 用户要求的重点信息 写入或插图成功后，输出应包含： - 目标文档 - 实际写入结果 - 如失败，明确说明是权限问题、路径问题还是文档类型问题 ## 常见限制 - 聊天中的图片附件目前不能稳定当作原始文件直接上传到飞书。 - 如果用户要插图，要求对方提供本地图片绝对路径。 - 如果没有读到正文或写入失败，不要假装成功，要明确说明阻塞点。 ## 使用脚本 - 提取 token：`node scripts/extract_feishu_doc_id.js` - 本地 OAuth 回调：`scripts/feishu_oauth_server.js` - 读取正文：`node scripts/read_feishu_doc.js` - 一键读取与摘要：`node scripts/read_feishu_url.js` - 一键读取为 Markdown：`node scripts/read_feishu_url_md.js` - 插入本地图片：`node scripts/insert_feishu_local_image.js` 如果是 `wiki` 链接，先提取链接中的 token。读取和插图脚本都会优先尝试把 `wiki token` 解析成实际文档 `obj_token`，再继续操作 docx 内容。