飞书文档管理助手

解决的问题

当内容已经生成，但需要落到飞书文档或知识库时，手工复制粘贴、调接口和排查权限会打断工作流。这个技能把飞书文档创建、写入、追加、列出等动作封装成可复用流程，适合同步学习成果、文章、日报/周报，减少重复配置认证、权限与块结构差异带来的返工。

如何工作

技能依赖飞书自建应用凭证，通常配置 FEISHU_APP_ID 与 FEISHU_APP_SECRET，并申请文档、云空间读写权限。它使用 tenant_access_token 访问飞书 Open API，创建文档获得 document_id，再通过 Add Block 接口逐块写入 text、heading1、todo、code、quote 等内容。追加时把 document_id 作为根节点，可在已有文档末尾继续补写。常见参考脚本支持 create、append、list 与去重检查。对于批量归档，建议先检查已有条目，避免同一日期与主题重复写入。

适用边界

它适合结构化沉淀和半自动写入，不适合依赖直接粘贴 Markdown 的场景，因为飞书块接口需要按 block 构建。还需注意 Token 有效期、文档默认可见范围、API 限频以及富文本样式拆分。多文档场景要保留 document_id 映射。若只做只读预览或一次性导出，可能不需要完整写入链路。