← 返回 Skills 市场
whisperbot

飞书文档智能转换Markdown

作者 Vash · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
25
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-doc-to-markdown
功能描述
智能转换飞书文档为高可用Markdown格式,自动处理私有资源、无效占位符、冗余引用,生成多版本满足不同场景需求
使用说明 (SKILL.md)

Skill: 飞书文档智能转换Markdown

技能描述

自动将飞书文档转换为高可用、高信息密度的Markdown文档,智能处理飞书私有资源、无效占位符、冗余引用,生成不同纯净度的版本满足不同场景需求。

适用场景

  • 飞书文档归档存储
  • 飞书内容导入知识库
  • 提取飞书文档核心信息
  • 批量转换飞书文档为通用格式
  • 飞书内容知识蒸馏

核心能力

多版本输出:支持3种不同处理等级的版本,满足不同需求 ✅ 智能内容提取:自动识别图片、图表、白板、表格等非文本内容的核心信息,转换为结构化文本 ✅ 冗余自动清理:自动移除无效占位符、无法访问的内部引用、重复内容、无意义标签 ✅ 自动分类归档:转换后的文档自动按「日期/项目」分类保存到原始资源库 ✅ 知识自动关联:自动提取核心要点,关联到对应项目/领域标签,纳入知识库

处理流程

  1. 内容获取:通过飞书API获取完整的文档原始内容和元信息
  2. 元信息识别:自动识别文档所属项目、领域、类型,生成分类标签
  3. 多版本处理:按照3种等级分别处理生成对应版本
  4. 自动归档:所有版本自动保存到raw_sources/YYYY-MM-DD/[项目名称]/目录下
  5. 知识入库:在LEARNINGS.md中记录文档摘要、核心要点、关联文件路径,纳入知识体系

版本处理规则

版本1:原始备份版

  • 处理规则:不做任何修改,完整保留所有原始内容和格式
  • 保留内容:所有文本、飞书私有标签(\x3Cimage>、\x3Cwhiteboard>、\x3Cmention-doc>等)、格式标记
  • 用途:作为原始凭证永久留存,确保可追溯,不对外提供

版本2:纯文本增强版

  • 处理规则
    1. 移除所有无效资源占位标签(图片、白板、文件、视频等嵌入标签)
    2. 提取非文本内容的上下文信息、标题、说明文字、数据,转换为结构化文本(要点列表、markdown表格、文字描述等)补充到对应位置
    3. 保留可访问的外部链接,移除无法访问的内部引用链接
  • 保留内容:所有有效文本信息、可访问链接、提取的非文本核心信息
  • 用途:完整保留所有有效信息,适合需要完整上下文的场景、需要二次编辑的场景

版本3:最终优化版(默认输出)

  • 处理规则:在纯文本增强版基础上进一步精炼
    1. 移除所有无法访问的内部引用、无效链接、冗余说明文字
    2. 精简重复内容,优化文档结构,合并相似要点
    3. 移除无意义的符号、占位符、格式标记
  • 保留内容:仅保留最核心的有效信息,信息密度最高
  • 用途:适合直接阅读、快速掌握核心要点、知识提炼入库

调用方式

# 基础调用,默认生成最终优化版
feishu_doc_convert \x3C飞书文档链接>

# 指定输出版本
feishu_doc_convert \x3C飞书文档链接> --version raw|enhanced|optimized

# 指定保存目录
feishu_doc_convert \x3C飞书文档链接> --output \x3C目录路径>

# 自动入库到知识库
feishu_doc_convert \x3C飞书文档链接> --sync-to-knowledgebase

最佳实践

  • 默认对外提供「最终优化版」,同时静默保存另外两个版本归档
  • 特殊需求可根据用户要求调整处理规则(如保留图片、保留所有引用等)
  • 所有转换后的文档必须关联到对应的ProjectDomain标签,方便后续检索
  • 核心价值高的文档自动提炼关键经验到知识库的结构化知识层
安全使用建议
Install only if you are comfortable with Feishu documents being fully read and archived. Check or change auto_archive, archive_path, and auto_sync_to_kb settings, review any raw_sources and LEARNINGS.md changes, and confirm the external Feishu plugin/command is trusted.
功能分析
Type: OpenClaw Skill Name: feishu-doc-to-markdown Version: 1.0.0 The skill is a utility designed to convert Feishu (Lark) documents into Markdown format with varying levels of detail (Raw, Enhanced, and Optimized). The instructions in SKILL.md and README.md describe legitimate document processing, local archival to 'raw_sources/', and knowledge management via 'LEARNINGS.md'. There are no signs of data exfiltration to external domains, malicious command execution, or prompt injection intended to subvert the agent's behavior beyond its stated purpose.
能力评估
Purpose & Capability
The stated purpose is coherent: converting Feishu/Lark documents into Markdown, including cleanup and multiple output versions. The scope also includes archiving and knowledge-base extraction, which is broader than a one-off conversion.
Instruction Scope
The instructions make automatic archival and silent saving of additional versions part of the workflow, without clearly requiring per-document confirmation before retaining private source content.
Install Mechanism
No code or install spec is provided, but the README references a feishu_doc_convert command and an external Feishu plugin. This may be normal for an instruction-only skill, but users should verify the actual runtime component and plugin provenance.
Credentials
Feishu account/document read access is expected for this purpose, but it is sensitive. The registry metadata declares only feishu.enabled and no primary credential, while the README describes Feishu account authorization.
Persistence & Privilege
The skill directs automatic storage of all generated versions under raw_sources and records summaries/key points in LEARNINGS.md, including raw backups described as permanent, with no retention, deletion, or approval controls described.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-doc-to-markdown
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-doc-to-markdown 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release of feishu-doc-to-markdown. - Automatically converts Feishu documents to Markdown with high information density. - Supports 3 output versions: raw backup, enhanced text, and optimized (default). - Intelligently processes private assets, invalid placeholders, redundant references, and automates cleanup. - Extracts and structures non-text content (images, charts, whiteboards, tables). - Automatically categorizes, archives by date/project, and associates core points with project/domain labels for easy knowledge management. - Supports integration with a knowledge base (`LEARNINGS.md`).
元数据
Slug feishu-doc-to-markdown
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

飞书文档智能转换Markdown 是什么?

智能转换飞书文档为高可用Markdown格式,自动处理私有资源、无效占位符、冗余引用,生成多版本满足不同场景需求. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 25 次。

如何安装 飞书文档智能转换Markdown?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-doc-to-markdown」即可一键安装,无需额外配置。

飞书文档智能转换Markdown 是免费的吗?

是的,飞书文档智能转换Markdown 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

飞书文档智能转换Markdown 支持哪些平台?

飞书文档智能转换Markdown 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 飞书文档智能转换Markdown?

由 Vash(@whisperbot)开发并维护,当前版本 v1.0.0。

💬 留言讨论