飞书文档管理系统 — Feishu Doc Manager#

统一管理飞书知识库、云盘、导航表，实现自动归档、同步、检索和备份。

---

设计理念#

三层架构，各司其职：

层载体作用知识树🌳 Wiki 知识库按主题组织的树状目录，适合浏览和阅读归档层📁 Drive 云盘原始文件、备份数据、不需要阅读的中间产物索引层📋 Bitable 多维表格全局索引，跨层检索，元数据管理

核心原则：

• 创建文档时自动归位（wiki + drive + bitable 三同步）
• 知识库按主题分，不按文件类型分（"晨报"比"docx"更有意义）
• 云盘按文件类型分，方便批量操作和备份
• 导航表是唯一的全局索引，支持检索和统计

---

目录结构设计#

Wiki 知识树（按主题）#

text

📚 虾虾堡知识库
├── 📰 晨报存档
│   ├── 2026年5月
│   │   ├── 晨报 | 2026-05-12
│   │   └── ...
│   └── 2026年3月
├── 🛠️ 系统运维
│   ├── OpenClaw 配置指南
│   ├── 备份与恢复
│   └── Mission Control
├── 🧠 记忆与日志
│   ├── MEMORY 归档
│   └── 运行日志
├── 📊 工作报告
│   └── AI 助手应用工作总结与展望
├── 📖 模板库
│   ├── 周报模板
│   ├── 会议纪要模板
│   └── 项目复盘模板
└── 📎 未分类
    └── （新建但未归类的文档暂存处）

Drive 云盘（按文件类型）#

text

虾虾堡云盘/
├── 📋 虾虾堡的文件导航 (bitable)
├── 📁 文件合集/
│   ├── 01-系统管理/       → 配置文档、指南、推文备份
│   ├── 02-系统备份/       → 完整备份、快照、备份记录
│   ├── 03-记忆备份/       → MEMORY.md 定期快照
│   └── 04-晨报数据/       → 数据池、查重索引、备选池
└── 📁 归档/
    └── 2026-03/           → 按月归档旧文档

Bitable 索引表字段#

字段类型说明文本文本文档显示名一级分类单选📰晨报数据 / 🛠️系统运维 / 🧠记忆日志 / 📊工作报告 / 📖模板 / 📎未分类二级分类单选细分：如晨报→每日晨报/数据池/索引；系统→配置/备份/指南文档类型单选📄文档 / 📊多维表格 / 📰晨报 / 📦备份 / 📝模板 / 🔍索引文档状态单选✅活跃 / 📁归档 / 🗑️已删除文档链接超链接指向文档 URLWiki链接超链接指向 wiki 页面（如有）创建日期日期文档创建时间月份文本格式 YYYY-MM，便于按月筛选标签多选自由标签，如 #AI #配置 #重要备注文本补充说明来源单选手动创建 / 晨报自动 / 备份自动 / 模板生成自动归档复选框是否已自动归位到 wiki + drive

---

五大功能#

1. 📥 doc-sync — 创建文档自动归位#

触发：创建新文档时（晨报、备份、手动创建等）

流程：

1. 创建飞书文档（ feishu_doc create）
2. 根据文档主题判断分类（一级 + 二级 + 文档类型）
3. 在 wiki 对应位置创建节点（ feishu_wiki create）
4. 移动文档到 drive 对应文件夹（ feishu_drive move）
5. 在 bitable 导航表中新增记录
6. 返回文档 URL + wiki URL

分类规则：

关键词匹配一级分类二级分类文档类型晨报/新闻/科技晨报📰 晨报数据每日晨报📰 晨报数据池/备选池/查重📰 晨报数据数据池🔍 索引配置/指南/教程/设置🛠️ 系统运维配置指南📄 文档备份/快照/还原🛠️ 系统运维备份恢复📦 备份Mission Control/运维🛠️ 系统运维运维📊 多维表格MEMORY/记忆/日志🧠 记忆日志记忆归档📦 备份总结/报告/工作📊 工作报告工作总结📄 文档模板/Template📖 模板-📝 模板其他📎 未分类-📄 文档

使用示例：

text

用户：帮我创建一个项目复盘文档
→ 自动创建 → 归入 wiki/📊工作报告 → 移到 drive/01-系统管理 → bitable 新增记录

2. 📦 doc-archive — 按时间自动归档#

触发：cron 定时（每周一次）或手动

流程：

1. 扫描 bitable 中 文档状态=✅活跃 且 创建日期 超过 30 天的记录
2. 判断是否需要归档：
   • 晨报：创建超过 7 天 → 归档
   • 数据池/索引：创建超过 14 天 → 归档
   • 备份：创建超过 30 天 → 归档
   • 配置/指南/模板：不自动归档
3. 归档操作：
   • 在 wiki 中移到对应月份子页面（如"2026年3月"）
   • drive 中移到 归档/YYYY-MM/ 文件夹
   • bitable 中更新 文档状态=📁归档
4. 输出归档报告

归档前检查：

• 不归档标记了 #重要 标签的文档
• 不归档最近 3 天内编辑过的文档
• 不归档模板类文档

3. 💾 doc-backup — 定期备份重要文件#

触发：cron 定时（每天一次）

备份清单（硬编码在 data/backup-sources.json）：

json

{
  "sources": [
    {
      "name": "MEMORY.md",
      "localPath": "/root/.openclaw/workspace/MEMORY.md",
      "driveFolder": "03-记忆备份",
      "naming": "MEMORY.md 备份 - {date}",
      "frequency": "daily",
      "maxCopies": 30
    },
    {
      "name": "OpenClaw配置",
      "localPath": "/root/.openclaw/openclaw.json",
      "driveFolder": "02-系统备份",
      "naming": "OpenClaw 配置备份 - {date}",
      "frequency": "weekly",
      "maxCopies": 12
    }
  ]
}

流程：

1. 读取备份清单
2. 根据频率判断今天是否需要备份
3. 读取本地文件内容
4. 创建飞书文档，写入内容
5. 移到对应 drive 文件夹
6. 在 wiki 对应位置创建/追加节点
7. 更新 bitable
8. 清理超过 maxCopies 的旧备份

4. 🔍 doc-find — 文档检索#

触发：用户说"帮我找xxx"、"xxx文档在哪"

流程：

1. 在 bitable 中搜索（按文本、标签、分类筛选）
2. 如果 bitable 没找到，直接搜索 wiki 和 drive
3. 返回匹配结果：文档名 + 分类 + 状态 + 链接 + 最近编辑时间
4. 如果找到多个，列出供用户选择

搜索策略：

• 先按精确匹配搜索 bitable 文本 字段
• 再模糊匹配 bitable 备注 和 标签
• 最后搜索 wiki 节点标题
• 支持按分类筛选："找晨报类文档"、"找系统相关"

5. 📝 doc-template — 模板生成#

触发：用户说"创建周报"/"创建会议纪要"等

内置模板（存在 data/templates/ 目录）：

模板名文件一级分类周报weekly-report.md📊 工作报告会议纪要meeting-notes.md📊 工作报告项目复盘project-review.md📊 工作报告技术方案tech-proposal.md🛠️ 系统运维

流程：

1. 识别模板类型
2. 填充动态内容（日期、项目名等——从用户消息中提取）
3. 创建飞书文档，写入模板内容
4. 执行 doc-sync 自动归位

6. 🧹 doc-tidy — 文档整理#

触发：手动（"整理一下文档"/"清理文档"）

流程：

1. 扫描 bitable 中所有 文档状态=✅活跃 的记录
2. 检查每条记录的链接是否有效（文档是否还存在）
3. 检查 📎 未分类 的文档，尝试自动分类
4. 检查 drive 中是否有文档不在 bitable 里（孤儿文档）
5. 检查 wiki 中是否有空页面
6. 输出整理建议，经用户确认后执行

---

配置文件#

data/config.json#

json

{
  "meta": { "version": 1 },
  "wiki": {
    "spaceId": "7615898038325775298",
    "rootNodeToken": "YFzKwgaQnitE6Kk8GgecBleXnnb"
  },
  "drive": {
    "rootFolderToken": "DQNefsLxqlxoTNdir4LcqyPFnPd",
    "folders": {
      "fileCollection": "Flrmfo9uhlmX42dRFh8c5FcSn2d",
      "systemMgmt": "B61WfPw7Qloqemd2OxxchG1Hngg",
      "systemBackup": "GZbsfJ8I8lEtmVdVMJGcnHI9nSf",
      "memoryBackup": "EOIjfn2L4lDCjId0lHJcrurMn3b",
      "morningData": "TsAufewZ7lw5w4dMcu1cH0snnWc"
    }
  },
  "bitable": {
    "appToken": "BL5yb83nQalWeqsUpmIcl9fnnif",
    "tableId": "tblNhF2Q5nAbZ8jR"
  },
  "owner": {
    "openId": "ou_dc8bc16a816fb8fb48ea92d28700fa82"
  }
}

data/backup-sources.json#

json

{
  "sources": [
    {
      "name": "MEMORY.md",
      "localPath": "/root/.openclaw/workspace/MEMORY.md",
      "driveFolder": "memoryBackup",
      "wikiParent": "记忆与日志",
      "naming": "MEMORY.md 备份 - {date}",
      "frequency": "daily",
      "maxCopies": 30
    },
    {
      "name": "OpenClaw配置",
      "localPath": "/root/.openclaw/openclaw.json",
      "driveFolder": "systemBackup",
      "wikiParent": "系统运维",
      "naming": "OpenClaw 配置备份 - {date}",
      "frequency": "weekly",
      "maxCopies": 12
    }
  ]
}

data/classification-rules.json#

json

{
  "rules": [
    {
      "keywords": ["晨报", "新闻", "科技晨报", "morning briefing"],
      "category1": "📰 晨报数据",
      "category2": "每日晨报",
      "docType": "📰 晨报",
      "driveFolder": "morningData"
    },
    {
      "keywords": ["数据池", "备选池", "查重", "索引"],
      "category1": "📰 晨报数据",
      "category2": "数据池",
      "docType": "🔍 索引",
      "driveFolder": "morningData"
    },
    {
      "keywords": ["配置", "指南", "教程", "设置", "how to", "guide"],
      "category1": "🛠️ 系统运维",
      "category2": "配置指南",
      "docType": "📄 文档",
      "driveFolder": "systemMgmt"
    },
    {
      "keywords": ["备份", "快照", "还原", "backup"],
      "category1": "🛠️ 系统运维",
      "category2": "备份恢复",
      "docType": "📦 备份",
      "driveFolder": "systemBackup"
    },
    {
      "keywords": ["Mission Control", "运维", "监控"],
      "category1": "🛠️ 系统运维",
      "category2": "运维",
      "docType": "📊 多维表格",
      "driveFolder": "systemMgmt"
    },
    {
      "keywords": ["MEMORY", "记忆", "日志"],
      "category1": "🧠 记忆日志",
      "category2": "记忆归档",
      "docType": "📦 备份",
      "driveFolder": "memoryBackup"
    },
    {
      "keywords": ["总结", "报告", "工作", "复盘", "周报"],
      "category1": "📊 工作报告",
      "category2": "工作总结",
      "docType": "📄 文档",
      "driveFolder": "systemMgmt"
    },
    {
      "keywords": ["模板", "template"],
      "category1": "📖 模板",
      "category2": "",
      "docType": "📝 模板",
      "driveFolder": "systemMgmt"
    }
  ],
  "defaultCategory": {
    "category1": "📎 未分类",
    "category2": "",
    "docType": "📄 文档",
    "driveFolder": "fileCollection"
  }
}

---

执行步骤#

doc-sync（创建文档时）#

1. 判断文档主题 → 查 classification-rules.json 确定分类
2. feishu_doc create 创建文档（传 owner_open_id）
3. 写入文档内容
4. feishu_drive move 移到对应 drive 文件夹
5. feishu_wiki create 在 wiki 对应位置创建节点
6. feishu_wiki move 把文档节点移到正确父节点下
7. 在 bitable 新增一条记录，填充分类、链接、状态等
8. 返回文档 URL + wiki URL

doc-archive（定期归档）#

1. 读取 bitable 全部 ✅活跃 记录
2. 按归档规则筛选需要归档的文档
3. 对每个文档：
   • wiki 中移到月份子页面
   • drive 中移到 归档/YYYY-MM/
   • bitable 中更新状态
4. 输出归档报告

doc-backup（定期备份）#

1. 读取 backup-sources.json
2. 对每个源：
   • 判断是否今天需要备份（频率检查）
   • 读取本地文件
   • 创建飞书文档
   • 移到 drive + 创建 wiki 节点
   • 更新 bitable
   • 清理超出 maxCopies 的旧备份
3. 输出备份报告

doc-find（检索）#

1. 解析用户查询意图
2. 搜索 bitable（精确 → 模糊 → 标签）
3. 搜索 wiki 节点标题
4. 合并去重，返回结果列表

doc-template（模板生成）#

1. 识别模板类型
2. 从 data/templates/ 读取模板
3. 填充动态字段
4. 执行 doc-sync

doc-tidy（整理）#

1. 全面扫描 bitable + drive + wiki
2. 发现：失效链接、未分类文档、孤儿文档、空页面
3. 生成建议清单
4. 等用户确认后执行

---

Wiki 初始化#

首次运行时，自动构建 wiki 知识树：

1. 确认 wiki spaceId 和根节点
2. 创建一级页面：📰晨报存档 / 🛠️系统运维 / 🧠记忆与日志 / 📊工作报告 / 📖模板库 / 📎未分类
3. 为晨报存档创建当前月份子页面（如"2026年5月"）
4. 将现有 drive 中的重要文档同步到 wiki
5. 将现有 bitable 记录补全 wiki 链接

---

与晨报系统集成#

晨报系统 morning-briefing 每天创建文档时，应调用本 skill 的 doc-sync 功能：

1. 晨报创建文档后 → doc-sync 自动归位
2. 晨报追加归档文档 → doc-sync 更新 bitable
3. doc-backup 定期备份 MEMORY.md → 晨报的 config.json 中存了 feishuDocToken，本 skill 可读取

---

目录结构#

text

skills/feishu-doc-manager/
├── SKILL.md                      # 本文件
├── README.md                     # 项目说明
├── data/
│   ├── config.json               # 飞书 ID 配置
│   ├── backup-sources.json       # 备份源清单
│   ├── classification-rules.json # 分类规则
│   └── templates/                # 文档模板
│       ├── weekly-report.md
│       ├── meeting-notes.md
│       ├── project-review.md
│       └── tech-proposal.md