{"_id":"@aaajiancai/feishu-export","_rev":"3-c8ef34a4ea4168cd751709e6dd44a41b","name":"@aaajiancai/feishu-export","dist-tags":{"latest":"1.0.2"},"versions":{"1.0.0":{"name":"@aaajiancai/feishu-export","version":"1.0.0","keywords":["feishu","lark","wiki","export","docx","markdown","飞书","文档导出"],"license":"MIT","_id":"@aaajiancai/feishu-export@1.0.0","maintainers":[{"name":"aaajiancai","email":"3118657467@qq.com"}],"bin":{"feishu-export":"index.mjs"},"dist":{"shasum":"43992074316444ef5e8102624ff67f79cbc4f209","tarball":"https://registry.npmjs.org/@aaajiancai/feishu-export/-/feishu-export-1.0.0.tgz","fileCount":9,"integrity":"sha512-YlB3BF+A/IK9JbPM3HVPNw2UBQ998SpgGIjRPSzoNW4ykDdluQCt5eQ/ki5ACctbB/SZeba31ie+xkRleo1kow==","signatures":[{"sig":"MEYCIQCtjnsMpJVLYSMsMjgtoDPIN02H6O2kZFSU9qrIH3xyHAIhAIBg1INGjEvVc4BeWzZAcSFjXMKL7fWkR07fj1Xn0nTr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36584},"type":"module","engines":{"node":">=18.0.0"},"_npmUser":{"name":"aaajiancai","email":"3118657467@qq.com"},"repository":{"url":"","type":"git"},"_npmVersion":"10.9.3","description":"飞书文档一键本地化：URL 进去，.md + .docx + 图片 + manifest.json 出来","directories":{},"_nodeVersion":"22.20.0","dependencies":{"adm-zip":"^0.6.0","feishu-wiki-export":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/feishu-export_1.0.0_1785401228277_0.6736270881414999","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@aaajiancai/feishu-export","version":"1.0.1","keywords":["feishu","lark","wiki","export","docx","markdown","飞书","文档导出"],"license":"MIT","_id":"@aaajiancai/feishu-export@1.0.1","maintainers":[{"name":"aaajiancai","email":"3118657467@qq.com"}],"bin":{"feishu-export":"index.mjs"},"dist":{"shasum":"33f5b19adcac866dfba1810e793010e4b983d1c6","tarball":"https://registry.npmjs.org/@aaajiancai/feishu-export/-/feishu-export-1.0.1.tgz","fileCount":9,"integrity":"sha512-qFpqzzktBOjaharEm+SXV4EtXV4h2d/iCbXhUuALdrT3y53z2/B6xMYA43cylQ2pdFnEJCg8aI52mS74iCRKDQ==","signatures":[{"sig":"MEYCIQDW67rnF0ZqWZx3a4xRm3NbAwzkeRawuVJRqQOaWVoUFwIhAPmIYBZbrmlzQ9dS8LuVckXfUX/QsW15L/1CiFj7Dlue","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":36795},"type":"module","engines":{"node":">=18.0.0"},"_npmUser":{"name":"aaajiancai","email":"3118657467@qq.com"},"repository":{"url":"","type":"git"},"_npmVersion":"10.9.3","description":"飞书文档一键本地化：URL 进去，.md + .docx + 图片 + manifest.json 出来","directories":{},"_nodeVersion":"22.20.0","dependencies":{"adm-zip":"^0.6.0","feishu-wiki-export":"^0.1.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/feishu-export_1.0.1_1785402623713_0.5291283791838568","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@aaajiancai/feishu-export","version":"1.0.2","description":"飞书文档一键本地化：URL 进去，.md + .docx + 图片 + manifest.json 出来","type":"module","bin":{"feishu-export":"index.mjs"},"dependencies":{"adm-zip":"^0.6.0","feishu-wiki-export":"^0.1.0"},"engines":{"node":">=18.0.0"},"keywords":["feishu","lark","wiki","export","docx","markdown","飞书","文档导出"],"license":"MIT","repository":{"type":"git","url":""},"_id":"@aaajiancai/feishu-export@1.0.2","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-LWlK1n0pMDwq9jgvX56KtXOP02yenqgpphe5INi5775ZYVvmD48E5dcwSUrEeqP4dZ+BlUgQUtuaRdtPb0vh2g==","shasum":"36a56c615f77d06765cdbb4b1193d107e4813eae","tarball":"https://registry.npmjs.org/@aaajiancai/feishu-export/-/feishu-export-1.0.2.tgz","fileCount":9,"unpackedSize":37135,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIGHwSBiBtxvjOcq0aQXwXeQdSpnWd2jtKqJZkhU10iWrAiA1B5yNUzMAoOGvjXvsu2tjAEJ9MM9osvod3ZjPj+1b1g=="}]},"_npmUser":{"name":"aaajiancai","email":"3118657467@qq.com"},"directories":{},"maintainers":[{"name":"aaajiancai","email":"3118657467@qq.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/feishu-export_1.0.2_1785402945001_0.6697558963281602"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-30T08:47:08.132Z","modified":"2026-07-30T09:15:45.319Z","1.0.0":"2026-07-30T08:47:08.432Z","1.0.1":"2026-07-30T09:10:23.958Z","1.0.2":"2026-07-30T09:15:45.177Z"},"license":"MIT","keywords":["feishu","lark","wiki","export","docx","markdown","飞书","文档导出"],"repository":{"type":"git","url":""},"description":"飞书文档一键本地化：URL 进去，.md + .docx + 图片 + manifest.json 出来","maintainers":[{"name":"aaajiancai","email":"3118657467@qq.com"}],"readme":"# @aaajiancai/feishu-export\r\n\r\n> 飞书文档一键本地化：URL 进去，文件出来。\r\n\r\n```\r\n飞书 Wiki URL  ──→  .md  +  .docx  +  图片  +  manifest.json\r\n```\r\n\r\n跨平台兼容 Windows / macOS / Linux。\r\n\r\n---\r\n\r\n## 快速上手\r\n\r\n### 第 1 步：设置凭证\r\n\r\n**方式一：环境变量（推荐）**\r\n\r\n```bash\r\n# Windows PowerShell\r\n$env:FEISHU_APP_ID=\"cli_xxxxxxxxxxxxxxxxxxxx\"\r\n$env:FEISHU_APP_SECRET=\"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\r\n\r\n# macOS / Linux\r\nexport FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxxxxxx\r\nexport FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\r\n```\r\n\r\n**方式二：.env 文件**\r\n\r\n在运行命令的目录下创建 `.env`：\r\n\r\n```\r\nFEISHU_APP_ID=cli_xxxxxxxxxxxxxxxxxxxx\r\nFEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx\r\n```\r\n\r\n> 凭证获取：飞书开放平台 → 创建应用 → 凭证与基础信息。\r\n\r\n### 第 2 步：运行\r\n\r\n```bash\r\nnpx @aaajiancai/feishu-export \"https://xxx.feishu.cn/wiki/AbCdEfGh\"\r\n```\r\n\r\n看产物：\r\n\r\n```\r\ndocs/prd/<标题>-PRD.md               ← 正文 + 图片附录\r\ndocs/prd/assets/<标题>-PRD-media/     ← 解压图片 + manifest.json\r\noutput/feishu-prd/<标题>.docx         ← 图文 Word\r\n```\r\n\r\n### 第 3 步（可选）：搭配 Skill 让 Agent 调用\r\n\r\n配合 `feishu-doc-reader` skill，可让 AI Agent 在对话中自动调用本工具：粘贴飞书\r\nWiki 链接后，Agent 自动执行 `npx @aaajiancai/feishu-export \"<URL>\"` 将文档下载到本地（Markdown +\r\n图片），再读取内容用于回答问题、分析需求或编码。\r\n\r\n典型触发语：`读一下这个飞书文档` / `根据这个 PRD 开发` / `分析这个需求`。\r\n\r\n---\r\n\r\n## 命令选项\r\n\r\n| 选项            | 说明                 | 示例                          |\r\n| --------------- | -------------------- | ----------------------------- |\r\n| `--base, -b`    | 指定输出基名         | `--base \"需求文档\"`           |\r\n| `--text-only`   | 仅导出纯文本         | `--text-only`                 |\r\n| `--no-docx`     | 不导出 Word          | `--no-docx`                   |\r\n| `--no-media`    | 不解压图片           | `--no-media`                  |\r\n| `--no-manifest` | 不生成 manifest      | `--no-manifest`               |\r\n| `--prd-dir`     | 自定义 md 输出目录   | `--prd-dir docs/requirements` |\r\n| `--assets-dir`  | 自定义图片输出目录   | `--assets-dir docs/assets`    |\r\n| `--docx-dir`    | 自定义 Word 输出目录 | `--docx-dir output/docs`      |\r\n\r\n---\r\n\r\n## 配置\r\n\r\n### 凭证（必填）\r\n\r\n优先级：**环境变量 > .env 文件**\r\n\r\n```bash\r\n# 环境变量（推荐）\r\nFEISHU_APP_ID=cli_xxx\r\nFEISHU_APP_SECRET=xxx\r\n```\r\n\r\n或在运行目录创建 `.env`：\r\n\r\n```\r\nFEISHU_APP_ID=cli_xxx\r\nFEISHU_APP_SECRET=xxx\r\n```\r\n\r\n### 输出路径（可选）\r\n\r\n`.feishu-export.config.json` 中覆盖默认路径：\r\n\r\n```json\r\n{\r\n  \"prdDir\": \"docs/requirements\",\r\n  \"assetsDir\": \"docs/assets\",\r\n  \"docxDir\": \"output/docs\"\r\n}\r\n```\r\n\r\n优先级：`CLI 参数 > .feishu-export.config.json > 默认值`。\r\n\r\n---\r\n\r\n## 本地开发\r\n\r\n如需本地调试或贡献代码：\r\n\r\n```bash\r\ngit clone <repo-url>\r\ncd feishu-export\r\nnpm install\r\nnode index.mjs \"https://xxx.feishu.cn/wiki/AbCdEfGh\"\r\n```\r\n\r\n---\r\n\r\n## 技术细节\r\n\r\n- 图片解压用 `adm-zip`（纯 JS），不依赖系统 `unzip`\r\n- 通过 `feishu-wiki-export` 与飞书 API 通信\r\n- 图片排序按 `word/document.xml` 中 `r:embed` 引用顺序，与正文阅读顺序一致\r\n- `manifest.json` 记录每张图的正文锚点，供下游工具引用\r\n- 重复导出同一文档时自动清理旧图片，不会累积\r\n","readmeFilename":"README.md"}