feishu-doc

name	feishu-doc
description	创建飞书在线文档（Feishu/Lark Document），将 Markdown 内容输出为可分享的飞书文档链接

飞书文档创建工具

使用时机

当用户明确要求将内容输出为飞书文档时使用，例如：

• "帮我写一篇飞书文档"
• "输出为飞书文档"
• "整理成飞书文档发给我"
• 内容较长（报告、分析、教程等）且用户希望以文档形式保存/分享

普通问答、简短回复不需要创建文档，直接在会话中回复即可。

使用方法

步骤一：准备内容文件

将文档内容（Markdown 格式）写入临时文件：

cat > /tmp/feishu-doc-content.md << 'EOF'
# 文档标题

正文内容...

## 章节一

内容...
EOF

步骤二：运行创建脚本

node .agents/skills/feishu-doc/create-doc.js --title "文档标题" --content-file /tmp/feishu-doc-content.md

脚本成功时仅输出文档 URL（如 https://docs.feishu.cn/docx/Xxxxx），失败时输出错误信息并以非零退出码退出。

参数说明

参数	必填	说明
--title	✅	文档标题
--content-file	二选一	Markdown 内容文件路径
--content	二选一	直接传入 Markdown 字符串
（stdin）	二选一	通过管道传入内容
--image-dir	❌	图片根目录，用于解析 Markdown 中的相对路径图片（默认为 --content-file 所在目录）

完整示例

# 写内容到临时文件
cat > /tmp/my-report.md << 'EOF'
# 周报 2026-W11

## 本周完成

- 完成了 XXX 功能开发
- 修复了 YYY bug

## 下周计划

1. 开始 ZZZ 需求
2. Code review
EOF

# 创建飞书文档，拿到 URL
node .agents/skills/feishu-doc/create-doc.js --title "周报 2026-W11" --content-file /tmp/my-report.md

环境变量要求

与飞书机器人共用同一套凭据，已在 .env 中配置：

FEISHU_APP_ID=cli_xxx
FEISHU_APP_SECRET=xxx

支持的 Markdown 语法

语法	转换为
# ~ ######	飞书标题 1–6
普通段落	文本块
**粗体**	加粗
*斜体*	斜体
`行内代码`	行内代码
``` 代码块	代码块（支持语言高亮）
- item / * item	无序列表
1. item	有序列表
> 引用	引用块
---	分割线
	图片块（本地路径或 HTTP/HTTPS URL）

图片使用说明

Markdown 中的图片语法 ![alt](path) 支持两种来源：

1. 本地文件：![截图](./screenshot.png) — 相对路径相对于 --image-dir 或 --content-file 所在目录解析
2. 网络图片：![图表](https://example.com/chart.png) — 自动下载后上传至飞书（支持 HTTP 重定向）

图片上传失败时，会自动降级为显示 alt 文字的文本段落，并在 stderr 输出警告，不影响其他内容的写入。

所需飞书权限：除 docx:document 外，还需要 drive:drive 或 drive:file 权限以允许上传图片素材。

注意事项

1. 飞书应用需要 docx:document（创建文档）权限
2. 创建的文档归属于应用 Bot，需手动分享给用户才能编辑
3. 脚本需在 omniclaw 项目目录下运行（确保能找到 node_modules）