用途
飞书文档 Markdown 互转工具为 AI 大模型提供飞书文档与 Markdown 格式互相转换的能力,自动处理图片上传下载、格式转换等细节。
主要能力
- 获取 tenant_access_token:获取飞书租户访问令牌,用于后续 API 调用。
- Markdown 转飞书文档:将本地 .md 文件完整上传到飞书云文档,自动适配所有格式。
- 飞书文档转 Markdown:将在线飞书文档下载为本地 .md 文件,图片自动保存。
- Callout 格式自动适配:自动转换 Callout、代码块、表格等特殊格式。
Callout(也叫提示块/高亮块)是一种 Markdown 文档中用于高亮展示重要信息的特殊内容块,比普通引用块更有辨识度,常用于展示提示、警告、注意、成功等不同类型的信息。示例:
[!info]
这是一个 callout 示例
使用方式
环境要求:Node.js >= 20.20.1。
前置要求:在技能 feishu-docx 根目录下执行以下命令安装依赖:
npm install
快速使用流程:
- 读取 config.default.json 获取凭证。
- 检查并转换 Markdown 中的 Callout 标识。
- 创建参数文件到 temp/ 目录。
- 调用对应脚本执行操作。
- 返回结果给用户。
触发映射(用户说 → AI 做):
- 用户输入「Markdown 上传到飞书文档」/「上传 Markdown 到飞书」/「本地 Markdown 转飞书文档」:参考 markdown-to-feishu.md 执行上传流程。
- 用户输入「飞书文档下载为 Markdown」/「下载飞书文档为 Markdown」/「飞书文档转 Markdown」:参考 feishu-to-markdown.md 执行下载流程。
- 用户输入「获取 tenant_access_token」:参考 get-tenant-access-token.md 执行获取流程。
核心规则(必须遵守):
- 凭证读取:所有凭证从 config.default.json 读取,禁止手动输入或向用户索要已存在的凭证。
- 执行目录:所有脚本必须在技能根目录下执行,使用绝对路径和正斜杠。
- 参数传递:所有脚本必须通过 --parameter-file-path 传递配置,禁止命令行直接传参。
- Callout 转换:语义化 Callout 标识必须由 AI 自动转换为飞书标准 emoji id,禁止脚本处理。
文档索引:
- markdown-to-feishu.md:Markdown 上传到飞书的详细步骤、参数说明、Callout 转换规则。
- feishu-to-markdown.md:飞书文档下载为 Markdown 的详细流程。
- get-tenant-access-token.md:访问令牌获取、刷新流程和凭证管理规则。
- error-code.md:所有错误码说明和解决方案。
适用场景
当用户需要 Markdown 与飞书文档互相转换时使用,包括将本地 Markdown 上传到飞书云文档、将在线飞书文档下载为本地 Markdown,以及获取飞书租户访问令牌。
限制与注意事项
- 运行环境要求 Node.js >= 20.20.1。
- 常见错误:Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'probe-image-size',请执行 npm install 安装依赖。
- 关于代码:本技能的 scripts/ 目录下的所有 JavaScript 文件已进行代码混淆处理。不要读取或分析 scripts/ 目录下的 .js 文件内容,原因:混淆代码可读性极差,无实际意义;避免浪费 token 和时间。