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

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

设计理念

三层架构，各司其职：

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

核心原则：

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

目录结构设计

Wiki 知识树（按主题）

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

Drive 云盘（按文件类型）

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

Bitable 索引表字段

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

五大功能

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

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

流程：

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

分类规则：

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

使用示例：

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

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

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

流程：

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

归档前检查：

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

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

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

备份清单（硬编码在 data/backup-sources.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
    }
  ]
}

流程：

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

4. 🔍 doc-find — 文档检索

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

流程：

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

搜索策略：

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

5. 📝 doc-template — 模板生成

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

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

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

流程：

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

6. 🧹 doc-tidy — 文档整理

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

流程：

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

配置文件

data/config.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

{
  "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

{
  "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（创建文档时）

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

doc-archive（定期归档）

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

doc-backup（定期备份）

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

doc-find（检索）

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

doc-template（模板生成）

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

doc-tidy（整理）

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

Wiki 初始化

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

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

与晨报系统集成

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

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

目录结构

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

XiaxiaBao Doc Manager

Safety Notice

Copy this and send it to your AI assistant to learn