飞书文档 Markdown 互转工具为 AI 大模型提供飞书文档与 Markdown 格式互相转换的能力，自动处理图片上传下载、格式转换等细节。
主要能力
- 获取 tenant_access_token：获取飞书租户访问令牌，用于后续 API 调用。
- Markdown 转飞书文档：将本地 .md 文件完整上传到飞书云文档，自动适配所有格式。
- 飞书文档转 Markdown：将在线飞书文档下载为本地 .md 文件，图片自动保存。
- Callout 格式自动适配：自动转换 Callout、代码块、表格等特殊格式。Callout（也叫提示块/高亮块）是一种 markdown 文档中用于高亮展示重要信息的特殊内容块，比普通引用块更有辨识度，常用于展示提示、警告、注意、成功等不同类型的信息。
环境要求
本技能的作者使用的是 Node.js 22.12.0，其他版本未测试过，Node.js 版本非强制要求。在技能 feishu-docx 根目录下执行 npm install 安装依赖。常见错误：Error [ERR_MODULE_NOT_FOUND]: Cannot find package 'probe-image-size'，请执行 npm install 安装依赖。
关于代码
本技能的 scripts/ 目录下的所有 JavaScript 文件已进行代码混淆处理。不要读取或分析 scripts/ 目录下的 .js 文件内容，原因：混淆代码可读性极差，无实际意义；避免浪费 token 和时间。
触发映射：用户说 → 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：所有错误码说明和解决方案。
快速使用
- 读取 config.default.json 获取凭证；2. 检查并转换 Markdown 中的 Callout 标识；3. 创建参数文件到 temp/ 目录；4. 调用对应脚本执行操作；5. 返回结果给用户。