SuperAPI AI 工具集

feishu-docx

办公与效率

查看项目

更新于 10-16 04:45

技能介绍

用途

飞书文档 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

快速使用流程:

  1. 读取 config.default.json 获取凭证。
  2. 检查并转换 Markdown 中的 Callout 标识。
  3. 创建参数文件到 temp/ 目录。
  4. 调用对应脚本执行操作。
  5. 返回结果给用户。

触发映射(用户说 → 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 和时间。