核心用法
Feishu Doc Skill 是一款面向飞书（Lark）生态的文档操作工具，提供完整的文档读写能力。核心功能包括：
- 读取模式：获取 Docs、Sheets、Bitable 及 Wiki 内容
- 创建模式：新建空白文档并返回 doc_token
- 写入模式：用 Markdown 覆盖文档内容
- 追加模式：向文档末尾追加 Markdown 内容（支持无限长度）
- 块级操作：列表、获取、更新、删除特定内容块
长文档处理策略：针对 LLM 输出限制（约 2000-4000 tokens），采用分块追加策略——先创建文档获取 token，再将内容逻辑分块（如按章节），循环调用 feishu_doc_append 完成写入，避免单次写入超限。
显著优点
1. 生态深度整合：原生支持飞书 Wiki、Docs、Sheets、Bitable 全系列文档类型
2. 无限长度写入：通过追加循环模式突破 LLM 单次输出限制，实现真正的长文档生成
3. Markdown 友好：全链路支持 Markdown 格式，降低内容转换成本
4. 块级精细化操作：支持对文档特定段落进行增删改查，满足复杂编辑需求
5. URL 自动解析：自动将 Wiki 链接解析为实际文档实体，简化操作流程
潜在缺点与局限性
1. 前置依赖强：必须预先安装并配置 feishu-common 模块，无法独立运行
2. 认证门槛高：需飞书开放平台的企业自建应用权限（app_id + app_secret），个人用户难以获取
3. 仅支持企业生态：完全绑定飞书平台，无法跨平台使用
4. 权限风险：块级删除等操作不可逆，误操作可能导致数据丢失
5. 无版本控制：覆盖写入（write）直接替换内容，无历史版本回滚机制
适合人群
- 企业内部自动化文档处理团队
- 需要将 LLM 输出批量沉淀至飞书知识库的内容运营者
- 构建飞书 Wiki 智能写作工作流的开发者
- 已有飞书开放平台应用权限的 IT 管理员
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 凭据泄露 | app_secret 泄露可能导致企业数据被爬取 | 使用环境变量注入，禁止硬编码 |
| 误覆盖风险 | write 操作直接覆盖全文，无二次确认 | 生产环境优先使用 append 模式 |
| API 限流 | 高频追加可能触发飞书速率限制 | 实现指数退避重试机制 |
| 权限越界 | 应用权限过大可能访问非授权文档 | 遵循最小权限原则配置应用可见范围 |