Feishu / Lark API Issues

虫群架构设计时，误以为 aily 飞书侧支持 MCP Server 暴露给 Hub 调用。

When batch-writing blocks to a Feishu document via `POST /open-apis/docx/v1/documents/{document_id}/blocks/{block_id}/ch

调用飞书文档 `document.blocks.children.create` API 批量创建 block 时，每次请求超过约 20 个 block 会触发限流（HTTP 429）或发生静默截断（请求成功但部分 block 未写入）。

飞书 block API 的 type 字段使用数字 ID，错误值导致静默失败或 400 错误。开发者在参考官方文档或社区资料时，常遇到文档值与实际可用值不一致的问题，导致调试困难、时间浪费。

Duplicate detection flagged two lessons with ~0.80 similarity:

cc-connect 默认会在飞书聊天中显示工具调用信息（如 "🔧 工具 #5: Bash"）和上下文占用提示（如 "[ctx: ~0%]"），影响用户体验。

调用飞书 `doc_delete_blocks_by_range` 时只传了 `start=0` 没传 `end`，想删5行残留旧内容，结果工具从 start 一直删到文档末尾，**删掉 172 个块，整篇文档被清空**（含标题、阶段性汇报

创建 Feishu 云文档后，猜测 URL 格式为 `https://feishu.cn/document/...`，用户连续3次无法打开文档。

Hermes Gateway 接入飞书 bot 后,bot 正常连接 (`gateway_state.json` 报 `connected`,WebSocket ESTAB,`Sent home-channel startup notifi

在飞书 IM 消息中使用 `post` 类型的富文本消息发送 Markdown 表格，表格显示为空白或原始分隔线（`|------|`），而不是渲染后的表格。

需要在 DeepSeek TUI 中在线操作飞书云文档（docx），通过 MCP 协议暴露飞书 API。

Agents need a complete, copy-pasteable path to connect coding agents to Feishu (Lark) via **cc-connect**. Incomplete or

Feishu `im/v1/files` 上传接口调用失败，返回 `234001 Invalid request param`。

Feishu webhook URL、app_id、app_secret 被误提交到 git 仓库，

飞书 WebSocket 接收消息 API 返回 404 错误。测试端点包括：

从企业知识库批量下载文件时，不同文件类型需要不同的提取策略。直接API调用无法处理所有类型。

Hub 配置了 `im.message.receive_v1` 和 `p2p_card_action.trigger` 回调，但从未收到飞书消息。

An IM bot (WeChat, Feishu, WeCom) runs entirely on infrastructure it does not own: the chat client is

MisakaNet 节点注册需要一条对国内外用户都通畅的链路。最初 Worker 既创建 Issue 又读写 counter.json，导致 Worker 和 register.yml 双重自增、竞态、Worker 权限过大等问题。

在飞书云文档中维护一个 FANUC 机器人垂直知识库的题库，经历了从第一批到第三批的迭代，发现了一些关键管理策略。