feishu-doc-manager

📄 Feishu Doc Manager | 飞书文档管理器

Markdown コンテンツを自動で書式設定し、Feishu Docs にシームレスに公開します。

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

🎯 解決する課題 | 解决的痛点

課題	解決策	问题	解决方案
Markdown テーブルがレンダリングされない	テーブルを自動で書式設定されたリストに変換	Markdown 表格无法渲染	自动转换为格式化列表
権限管理が複雑	ワンクリックで共同編集者を管理	权限管理复杂	一键协作者管理
長いコンテンツで 400 エラーが発生する	長いドキュメントを自動で分割	长内容 400 错误	自动分段写入
書式に一貫性がない	write/append が Markdown を自動レンダリング	格式不一致	write/append 自动渲染
ブロック単位の更新で書式が失われる	write と update の違いを明確化	块级更新丢失格式	区分写入 vs 更新

---

✨ 主な機能 | 核心功能

1. 📝 Markdown のスマート公開 | 智能 Markdown 发布

• 自動レンダリング：write/append アクションで Markdown を Feishu の構造化ドキュメントに自動レンダリングします
• テーブルの処理：テーブルを自動で書式設定されたリストに変換します（Feishu の制限への対処）
• 構文のサポート：見出し、リスト、太字、斜体、コード、引用、区切り線

自动渲染：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 内容

⚠️ 重要：Markdown をレンダリングするには write を使用し、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	Feishu の結果	Markdown	飞书效果
# Title	見出し 1	# 标题	标题1
## Title	見出し 2	## 标题	标题2
### Title	見出し 3	### 标题	标题3
- Item	箇条書き	- 项目	无序列表
1. Item	番号付きリスト	1. 项目	有序列表
**bold**	太字	**粗体**	粗体
*italic*	斜体	*斜体*	斜体
`code`	インラインコード	`代码`	行内代码
> quote	引用ブロック	> 引用	引用块
---	区切り線	---	分隔线

⚠️ サポート対象外 | 不支持

• テーブル：リストに変換 | 表格：转换为列表
• 画像：別途アップロード | 图片：单独上传
• 複雑な HTML：Markdown を使用 | 复杂 HTML：使用 Markdown

---

🔧 重要な違い | 重要区分

write/append vs update_block

機能	write/append	update_block
Markdown のレンダリング	✅ はい	❌ いいえ（プレーンテキストのみ）
用途	初期コンテンツ、追記	簡単なテキスト更新
書式	Markdown を全面的にサポート	プレーンテキストのみ
功能	初始内容、追加	快速文本更新
格式支持	完整 Markdown	仅纯文本

ベストプラクティス：Markdown コンテンツには常に write または append を使用してください。 最佳实践：Markdown 内容始终使用 write 或 append。

---

🐛 トラブルシューティング | 故障排除

400 Bad Request | 400 错误

原因：コンテンツが長すぎます | 原因：内容过长 解決策：小さな単位に分割して書き込みます | 解决：分段写入

Markdown がレンダリングされない | Markdown 不渲染

原因：write ではなく update_block を使用しました | 原因：使用了 update_block 而非 write 解決策：Markdown には write または append を使用します | 解决：Markdown 使用 write 或 append

権限エラー | 权限错误

原因：docs:permission.member スコープがありません | 原因：缺少 docs:permission.member 权限 解決策：Feishu アプリのコンソールで権限を追加します | 解决：在飞书应用控制台添加权限

---

📦 必要な権限 | 必需权限

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

---

📝 ライセンス | 许可证

MIT