How do I install feishu-cli-export?

Run `npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-export` in your terminal. You need to have run `npx skills init` once in your project first.

Which agent frameworks does feishu-cli-export support?

feishu-cli-export works with any agent framework supported by the Skills registry, including Claude Code, Cursor, GitHub Copilot, Cline, Codex, and Gemini CLI.

Is feishu-cli-export free to use?

Yes. feishu-cli-export is free to install and use. It is available from the open explainx.ai skill registry published by riba2534.

Where can I read ratings and reviews for feishu-cli-export?

Community ratings and review text appear on this explainx.ai skill page below the description. Reviews use a 1–5 scale and may include short written feedback from signed-in members.

Productivity

feishu-cli-export

将飞书云文档或知识库文档导出为本地 Markdown 文件，或导出为 PDF/Word 等格式。支持 docx（新版文档）和 sheet（电子表格）两种知识库文档类型。

riba2534/feishu-cli|Updated Apr 8, 2026

Works with

Claude CodeCursorClineWindsurfCodexGoose

Documentation

Installation Guide

Select your AI agent

How to use feishu-cli-export on Cursor

AI-first code editor with Composer

Prerequisites

Before installing skills in Cursor, ensure your development environment meets these requirements:

›Cursor installed and configured on your machine
›Node.js 16+ with npm — verify with node --version
›Active project directory where you want to add feishu-cli-export

Run the install command

Execute the skills CLI command in your project's root directory to begin installation:

$npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-export

Fetches feishu-cli-export from riba2534/feishu-cli and configures it for Cursor.

Select Cursor when prompted

The CLI shows a list of agents. Use arrow keys and space to select Cursor:

◆ Which agents do you want to install to?

│

│ ── Universal (.agents/skills) ────────────────

│ · Cline · Codex · Goose · Windsurf

│ ●Cursor(selected)

│ · Cursor · Aider · Continue

Verify installation

Confirm successful installation by checking the skill directory location:

.cursor/skills/feishu-cli-export

Restart Cursor to activate feishu-cli-export. Access via /feishu-cli-export in your agent's command palette.

⚠

Security Notice

We perform automated surface-level scans (Gen AI Scanner, Socket, Snyk) during installation. These checks detect common vulnerabilities but do not guarantee complete security. Always review skill source code and verify the publisher's reputation before production use.

Skills execute code in your environment. Always review source, verify the publisher, and test in isolation before production.

›View source on GitHub ›Skills CLI docs ›About Cursor ›What are agent skills?

List & Monetize Your Skill

Submit your Claude Code skill and start earning

Get started →

Use Cases

User Story & Requirements Generation

Create detailed user stories, acceptance criteria, and feature specs

Example

Generate user stories for 'password reset feature' with acceptance criteria, edge cases, and test scenarios

✓

Reduce spec writing time by 50%, ensure comprehensive coverage

Competitive Analysis

Research competitors, compare features, identify gaps

Example

Analyze 5 competitor products, create feature comparison matrix, suggest differentiation opportunities

✓

Complete competitive research in 2 hours instead of 2 days

Roadmap Prioritization

Evaluate features using frameworks (RICE, ICE, Kano) and create prioritized backlogs

Example

Score 20 feature ideas using RICE framework, generate prioritized roadmap with rationale

参数	说明	默认值
document_id/node_token	文档 ID 或知识库节点 Token	必需
output_path	输出文件路径	`/tmp/<id>.md`
--download-images	下载文档中的图片和画板到本地（图片在飞书服务器以 token 形式存储，不下载则无法本地查看；画板自动导出为 PNG）	否
--assets-dir	图片和画板的保存目录	`./assets`
--front-matter	添加 YAML front matter（标题和文档 ID）	否
--highlight	保留文本颜色和背景色（输出为 HTML `<span>` 标签）	否
--expand-mentions	展开 @用户为友好格式（需要 contact:user.base:readonly 权限）	是（默认开启）
--user-access-token	User Access Token（用于访问无 App 权限的文档，未指定时自动从 `auth login` 读取）	自动读取

URL 格式	类型	命令
`https://xxx.feishu.cn/docx/<id>`	普通文档	`doc export`
`https://xxx.feishu.cn/wiki/<token>`	知识库（docx/sheet）	`wiki export`
`https://xxx.larkoffice.com/docx/<id>`	普通文档	`doc export`
`https://xxx.larkoffice.com/wiki/<token>`	知识库（docx/sheet）	`wiki export`

错误	原因	解决
`code=1770032, msg=forBidden`	App Token 无权限访问该文档	通过 `auth login --scopes "docx:document:readonly offline_access"` 授权 User Token，`doc export` 会自动读取
`code=99991679, msg=Unauthorized`	User Token 缺少 `docx:document:readonly` scope	重新执行 `feishu-cli auth login --scopes "docx:document:readonly offline_access"`
`code=131002, param err`	参数错误	检查 token 格式
`code=131001, node not found`	节点不存在	检查 token 是否正确
`code=131003, no permission`	无权限访问	确认应用有 docx:document 或 wiki:wiki:readonly 权限
`code=99991672, open api request rate limit`	API 限流	等待几秒后重试
`write /tmp/xxx.md: permission denied`	文件权限问题	检查输出目录权限，更换输出路径

问题	说明
表格导出	文档内嵌表格（block_type 31）的单元格内容可能显示为 `<!-- Unknown block type: 32 -->`，这是块类型 32（表格单元格）的已知转换问题
目录节点	知识库目录节点导出内容为 `[Wiki 目录...]`，需单独获取子节点

导入（Markdown → 飞书）	导出（飞书 → Markdown）
Mermaid/PlantUML 代码块 → 飞书画板	飞书画板 → 画板链接/PNG 图片
大表格 → 自动拆分为多个表格	多个表格 → 分开的表格
缩进列表 → 嵌套父子块	嵌套列表 → 缩进 Markdown
`> [!NOTE]` → Callout 高亮块	Callout 高亮块 → `> [!NOTE]`
$formula$ → 行内公式	行内/块级公式 → $formula$
`<u>下划线</u>` → 下划线样式	下划线样式 → `<u>下划线</u>`

参数	说明	默认值
`<doc_token>`	文档 Token	必填
`--type`	导出格式	必填
`-o, --output`	输出文件路径	必填
`--user-access-token`	User Access Token（用于导出无 App 权限的文档）	自动读取

参数	说明	默认值
`<local_path>`	本地文件路径	必填
`--type`	文件类型	必填
`--name`	飞书文档名称	文件名
`--folder`	目标文件夹 Token（必须提供，飞书 API 要求指定文档挂载点，不传会报 `field validation failed`）	—

参数	说明	默认值
`<token>`	素材 Token 或画板 Token	必填
`--type`	素材类型 `media`/`whiteboard`	`media`
`-o, --output`	输出文件路径	—

维度	普通素材（media）	画板缩略图（whiteboard）
Token 来源	文档导出解析的 `file_token`	画板块的 `whiteboard_token`
下载内容	原始图片/文件	画板渲染的 PNG 缩略图
适用场景	下载文档中的图片和附件	获取画板预览图

问题	原因	解决方法
`code=131003, no permission`	应用未授权访问该文档	确认应用有 `docx:document` 或 `wiki:wiki:readonly` 权限，且文档对应用可见
`code=99991672, rate limit`	API 请求频率超限	等待几秒后重试
`field validation failed`（import-file）	未传 `--folder` 参数	始终指定 `--folder fldcnXXX`
导出的 Markdown 中图片显示为 token 而非内容	未使用 `--download-images`	添加 `--download-images --assets-dir <dir>` 参数
表格单元格内容显示为 `<!-- Unknown block type: 32 -->`	块类型 32（TableCell）的已知转换问题	暂无修复，手动补充内容
`--expand-mentions` 报权限错误	缺少 `contact:user.base:readonly` 权限	在飞书开放平台为应用申请该权限，或使用 `--expand-mentions=false` 关闭

飞书块类型	导出结果	说明
标题 (Heading 1-6)	`# ~ ######`
标题 (Heading 7-9)	`######` 或粗体段落	超出 H6 时降级
段落 (Text)	普通文本
无序列表 (Bullet)	`- item`	支持无限深度嵌套
有序列表 (Ordered)	`1. item`	保留原始编号序列
任务列表 (Todo)	`- [x]` / - [ ]✓ Make data-driven prioritization decisions faster Stakeholder Communication Draft PRDs, status updates, and stakeholder presentations Example Create executive summary of Q3 roadmap, monthly progress report, feature launch announcement ✓Save 3-5 hours/week on communication overhead Implementation Guide Prerequisites ›Claude Desktop or compatible AI client ›Access to product documentation and roadmap tools (Jira, Notion, etc.) ›Understanding of product management frameworks (RICE, Jobs-to-be-Done, etc.) ›Stakeholder contact information and communication channels Time Estimate 30-60 minutes to see productivity improvements Steps 1Install product management skill 2Start with user story generation for known feature 3Progress to competitive analysis: research 2-3 competitors 4Use for roadmap prioritization: apply RICE/ICE scoring 5Draft stakeholder communications and refine based on feedback 6Build template library for recurring PM tasks 7Share effective prompts with product team Common Pitfalls ⚠Not validating competitive research—verify facts before sharing ⚠Accepting user stories without involving engineering team ⚠Over-relying on frameworks without qualitative judgment ⚠Not customizing outputs to company culture and communication style ⚠Skipping stakeholder validation of generated requirements Best Practices ✓ Do +Validate research and competitive analysis with real data +Collaborate with engineering when generating technical requirements +Customize frameworks and templates to your company context +Use skill for first drafts, refine with stakeholder input +Document successful prompt patterns for PM tasks +Combine AI efficiency with human judgment and intuition ✗ Don't −Don't publish competitive analysis without fact-checking −Don't finalize user stories without engineering review −Don't make prioritization decisions solely on AI scoring −Don't skip customer validation of generated requirements −Don't ignore company-specific context and culture 💡 Pro Tips ★Provide context: company goals, constraints, customer feedback ★Ask for alternatives: 'Show 3 ways to prioritize this roadmap' ★Request stakeholder-specific formatting: 'Executive summary vs. engineering spec' ★Use skill for 70% generation + 30% customization to company needs When to Use This ✓ Use when Use for user story writing, competitive research, roadmap prioritization, stakeholder communication, and PRD drafting. Best for reducing repetitive documentation and research work. ✗ Avoid when Avoid for strategic product vision (requires deep customer empathy), pricing decisions (needs market and financial expertise), or when face-to-face customer discovery is more valuable than speed. Learning Path 1Basic: user stories, feature specs, status updates 2Intermediate: competitive analysis, prioritization frameworks, PRDs 3Advanced: product strategy, go-to-market planning, OKR setting 4Expert: product vision, market positioning, business model innovation Related Skills grill-me 646 mattpocock/skills Productivitysame categorypremortem 213 parcadei/continuous-claude-v3 Productivitysame categorydeslop 159 cursor/plugins Productivitysame categorytravel-planner 136 ailabs-393/ai-labs-claude-skills Productivitysame categoryframer-motion 131 pproenca/dot-skills Productivitysame categorywrite-a-prd 128 mattpocock/skills Productivitysame category Reviews 4.6★★★★★54 reviews Z Zara Harris★★★★★Dec 28, 2024 We added feishu-cli-export from the explainx registry; install was straightforward and the SKILL.md answered most questions upfront. G Ganesh Mohane★★★★★Dec 24, 2024 Keeps context tight: feishu-cli-export is the kind of skill you can hand to a new teammate without a long onboarding doc. E Evelyn Choi★★★★★Dec 24, 2024 Keeps context tight: feishu-cli-export is the kind of skill you can hand to a new teammate without a long onboarding doc. M Maya Wang★★★★★Dec 24, 2024 Useful defaults in feishu-cli-export — fewer surprises than typical one-off scripts, and it plays nicely with `npx skills` flows. A Amina Sharma★★★★★Dec 12, 2024 Registry listing for feishu-cli-export matched our evaluation — installs cleanly and behaves as described in the markdown. Y Yusuf Bansal★★★★★Nov 23, 2024 I recommend feishu-cli-export for anyone iterating fast on agent tooling; clear intent and a small, reviewable surface area. E Evelyn Park★★★★★Nov 19, 2024 feishu-cli-export reduced setup friction for our internal harness; good balance of opinion and flexibility. S Sakshi Patil★★★★★Nov 15, 2024 feishu-cli-export has been reliable in day-to-day use. Documentation quality is above average for community skills. Y Yuki Sethi★★★★★Nov 15, 2024 feishu-cli-export has been reliable in day-to-day use. Documentation quality is above average for community skills. M Maya Liu★★★★★Nov 3, 2024 feishu-cli-export fits our agent workflows well — practical, well scoped, and easy to wire into existing repos. showing 1-10 of 54 1 / 6 Discussion Comments — not star reviews No comments yet — start the thread.

--type	格式	说明
`pdf`	PDF	保留排版
`docx`	Word	可编辑

feishu-cli-export

Documentation

Installation Guide

How to use feishu-cli-export on Cursor

Prerequisites

Run the install command

Select Cursor when prompted

Verify installation

Security Notice

List & Monetize Your Skill

Use Cases

User Story & Requirements Generation

Competitive Analysis

Roadmap Prioritization

Install Skill

飞书文档导出技能

前置条件

核心概念

使用方法

执行流程

参数说明

支持的 URL 格式

输出格式

示例

Front Matter 输出格式

高亮颜色输出格式

图片处理（重要）

导出并下载图片

查看和理解图片

完整流程

错误处理与边界情况

1. 常见错误

2. 边界情况处理

3. 重试机制

已知问题

已验证功能

双向转换说明

异步导出为 PDF/Word/Excel（doc export-file）

执行流程

支持的导出格式

参数

示例

从本地文件导入为飞书云文档（doc import-file）

执行流程

支持的导入格式

参数

示例

下载文档素材（doc media-download）

普通素材下载

画板缩略图下载

参数说明

两种下载模式的区别

常见问题

附录：Block 类型映射参考

Stakeholder Communication

Implementation Guide

Best Practices

When to Use This

Learning Path

Related Skills

grill-me

premortem

deslop

travel-planner

framer-motion

write-a-prd

Reviews

Discussion