引言
最近我一直在思考，如何让知识体系更高效地与 AI 交互。特别是当 Agent 成为主流交互方式时，传统文档工具像 Word 或本地 Markdown 文件，往往像个'死档案馆'——存进去的东西容易被遗忘，更新麻烦，复用性差。
在 AI Agent 日益普及的当下，我们需要一个能扮演长期记忆和认知外化角色的知识管理工具。今天分享我的实战经验，以及开源的一个小工具
feishu-docx，它能将飞书文档无缝转为 Markdown，支持 Docx、Sheet、Bitable 和 Wiki 格式。这能让 AI Agent 直接查询和操作飞书内容，为 AI 构建可理解、可检索、可对齐的知识表示层。
从'存'到'乱'：我的文档混沌时代
回想五年前，工作笔记散落在 Word、NAS、Notion 甚至手机备忘录里。找东西像大海捞针。跨团队项目方案写了十几版，每次问'最新版在哪'，都得花半天翻箱倒柜。更糟的是，这些文档是静态的——写完就扔那儿，不会自动更新，无法轻松复用。知识像被冻结的冰块，融化不了，流动不起来。
试过 Evernote、OneNote、Notion，直到切换到飞书。飞书云文档不是为了'存'设计的，核心价值在于'可被持续管理、演进、复用'。它让我能像运营活的知识库一样管理知识体系。
飞书内置实时协作和历史版本。想象一下，产品规划 Docx，团队成员同时编辑、评论、@人提醒。改动实时同步，版本历史像 Git 一样 traceable：回溯时间点，看谁改了什么，为什么改。核心文档可以审视、清理冗余、优化结构，确保知识库保持'健康状态'。
AI Agent 时代：云文档作为长期记忆
现在，AI Agent 已渗透工作流，不再是聊天机器人，而是执行复杂任务的伙伴。但痛点是什么？缺少'记忆'——短期上下文有限，长期知识依赖外部存储。
飞书云文档完美契合。它承担 Agent 的长期记忆角色：知识体系外化成结构化文档，Agent 随时查询、演绎。比如问 Agent'分析最新项目风险'，它不光靠内置知识，还能拉取飞书 Docx，结合 Sheet 数据，给出个性化洞见。比静态数据库强，因为云文档是活的——更新文档，Agent 的'认知'就同步演进。
认知外化就是把脑子里的想法'外包'给工具。飞书让抽象思考变成可操作文档：思维导图外化创意，表格外化数据，Wiki 外化体系。Agent 接入后，成了'扩展大脑'——知识可检索、可对齐（align with your thinking），不再是黑箱。
但问题来了：怎么让 Agent 直接读飞书文档？飞书 API 强大，但集成门槛高，尤其是转成 AI 友好的格式。
feishu-docx：让飞书文档 AI 化
为了解决这个痛点，我开源了 feishu-docx，一个简单的飞书/Lark 云文档到 Markdown 的读取工具。支持 Docx、Sheet、Bitable 和 Wiki 全类型，兼容 Claude/GPT Skills。核心 idea：为 AI 构建可理解、可检索、可对齐的知识表示层。
为什么需要它？
飞书文档丰富，但 AI Agent 更喜欢 Markdown 或纯文本。直接 API 调用太复杂，新手容易卡壳。feishu-docx 桥接了这个 gap：一键导出文档为 Markdown，保留结构（标题、表格、链接），让 Agent 轻松解析。在 Claude Projects 或 GPT Custom Instructions 中，上传这些 Markdown 作为 Agent 的知识基底。Agent 查询时，就能直接搜索、引用。
如何使用？
它是 Python 库，开源在 GitHub（搜索 feishu-docx）。
# 安装
pip install feishu-docx
# 配置凭证（只需一次）
feishu-docx config set --app-id YOUR_APP_ID --app-secret YOUR_APP_SECRET
# 授权
feishu-docx auth
# 导出！
feishu-docx export "https://my.feishu.cn/wiki/KUIJwaBuGiwaSIkkKJ6cfVY8nSg"
注意：App ID 和 Secret 需从飞书开放平台获取。
集成 AI Skills
让 Claude 直接访问你的飞书知识库！本项目已包含 Claude Skills 配置，位于 .skills/feishu-docx/SKILL.md。将此 Skill 复制到你的 Agent 项目中，Claude 就能：
