feishu-doc-manager

📄 飞书文档管理器 | 飞书文档管理器

无缝将 Markdown 内容发布到飞书文档，并自动渲染格式。

将 Markdown 内容无缝发布到飞书文档，自动渲染格式。

🎯 解决的痛点 | 解决的痛点

问题	解决方案	问题	解决方案
Markdown 表格无法渲染	自动将表格转换为格式化列表	Markdown 表格无法渲染	自动转换为格式化列表
权限管理复杂	一键管理协作者	权限管理复杂	一键协作者管理
长内容出现 400 错误	自动拆分长文档	长内容 400 错误	自动分段写入
格式不一致	write/append 自动渲染 Markdown	格式不一致	write/append 自动渲染
块级更新会丢失格式	明确区分写入与更新	块级更新丢失格式	区分写入 vs 更新

---

✨ 核心功能 | 核心功能

1. 📝 智能 Markdown 发布 | 智能 Markdown 发布

• 自动渲染：write/append 操作会自动将 Markdown 渲染为飞书结构化文档
• 表格处理：自动将表格转换为格式化列表（解决飞书限制）
• 语法支持：标题、列表、粗体、斜体、代码、引用、分隔线

自动渲染：write/append 操作自动将 Markdown 渲染为飞书结构化文档 表格处理：表格自动转换为格式化列表（飞书限制解决方案） 语法支持：标题、列表、粗体、斜体、代码、引用、分隔线

2. 🔐 权限管理 | 权限管理

• 添加/移除协作者
• 更新权限级别（view/edit/full_access）
• 列出现有权限
• 转移文档所有权

添加/删除协作者、更新权限级别、列出现有权限、转移文档所有权

3. 📄 文档操作 | 文档操作

• 创建新文档
• 使用 Markdown 写入完整内容
• 追加内容到现有文档
• 更新指定块（仅支持纯文本）
• 删除块
• 列出文档结构

创建新文档、写入完整 Markdown 内容、追加内容、更新指定块、删除块、列出文档结构

---

🚀 快速开始 | 快速开始

安装 | 安装

cd ~/.openclaw/workspace/skills
git clone https://github.com/Shuai-DaiDai/feishu-doc-manager.git

使用示例 | 使用示例

创建文档 | 创建文档

{
  "action": "create",
  "title": "Project Report | 项目报告",
  "folder_token": "optional_folder_token"
}

写入 Markdown 内容 | 写入 Markdown 内容

⚠️ 重要：使用 write 渲染 Markdown，不要使用 update_block ⚠️ 关键：使用 write 进行 Markdown 渲染，不要用 update_block

{
  "action": "write",
  "doc_token": "UWpxdSnmXo6mPdxwOyCcWTPUndD",
  "content": "# Project Overview | 项目概览\n\n## Key Metrics | 关键指标\n\n- **Revenue | 收入**: $100K\n- **Users | 用户**: 10K\n- **Growth | 增长**: 25%\n\n> Important note | 重要提示\n> This is a blockquote | 这是引用块"
}

添加协作者 | 添加协作者

curl -X POST "https://open.feishu.cn/open-apis/drive/v1/permissions/{doc_token}/members?type=docx" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "member_type": "openid",
    "member_id": "ou_xxx",
    "perm": "edit"
  }'

---

📋 支持的 Markdown | 支持的 Markdown

Markdown	飞书效果	Markdown	飞书效果
# Title	一级标题	# 标题	标题1
## Title	二级标题	## 标题	标题2
### Title	三级标题	### 标题	标题3
- Item	无序列表	- 项目	无序列表
1. Item	有序列表	1. 项目	有序列表
**bold**	粗体	**粗体**	粗体
*italic*	斜体	*斜体*	斜体
`code`	行内代码	`代码`	行内代码
> quote	引用块	> 引用	引用块
---	分隔线	---	分隔线

⚠️ 不支持 | 不支持

• 表格：转换为列表 | 表格：转换为列表
• 图片：单独上传 | 图片：单独上传
• 复杂 HTML：使用 Markdown | 复杂 HTML：使用 Markdown

---

🔧 重要区分 | 重要区分

write/append 与 update_block

功能	write/append	update_block
Markdown 渲染	✅ 是	❌ 否（仅支持纯文本）
适用场景	初始内容、追加内容	快速更新文本
格式	完整支持 Markdown	仅支持纯文本
功能	初始内容、追加	快速文本更新
格式支持	完整 Markdown	仅纯文本

最佳实践：Markdown 内容始终使用 write 或 append。 最佳实践：Markdown 内容始终使用 write 或 append。

---

🐛 故障排除 | 故障排除

400 请求错误 | 400 错误

原因：内容过长 | 原因：内容过长 解决方案：拆分为较小的片段 | 解决：分段写入

Markdown 无法渲染 | Markdown 不渲染

原因：使用了 update_block 而非 write | 原因：使用了 update_block 而非 write 解决方案：使用 write 或 append 处理 Markdown | 解决：Markdown 使用 write 或 append

权限被拒 | 权限错误

原因：缺少 docs:permission.member 权限范围 | 原因：缺少 docs:permission.member 权限 解决方案：在飞书应用控制台添加权限 | 解决：在飞书应用控制台添加权限

---

📦 必需权限 | 必需权限

{
  "scopes": {
    "tenant": [
      "docx:document",
      "docx:document:create",
      "docx:document:write_only",
      "docs:permission.member",
      "contact:user.base:readonly"
    ]
  }
}

---

📝 许可证 | 许可证

MIT