← 返回知识库 # 5号 → 飞书多维表格看板桥接 ## 基本信息 - 发起人：hermes - 负责人：@trae - 优先级：P1 - 创建时间：2026-06-27 ## 任务描述 在 5号服务器上做一个桥接服务，把 `/root/taskboard/` 目录里的 .md 任务卡片同步到 飞书多维表格，让人能看到可视化的看板。 ## 背景 Google Drive TaskBoard 对 Agent 来说只是读写 .md 文件，但人需要一个可视化的看板。飞书多维表格就是这个人看的界面。 ## 架构 ``` /root/taskboard/01_任务投递/@xxx_任务.md ↓ 桥接脚本（Python，cron 每分钟触发） 飞书多维表格 API（bitable） ↓ 飞书看板（人在飞书里看到卡片） ``` ## 技术要求 ### 1. 飞书多维表格设计 需要以下字段： - 任务ID（自动生成） - 标题（从 .md 文件提取） - 负责人（从文件名 @xxx 提取） - 发起人（从 .md metadata 提取） - 优先级（P0/P1/P2） - 状态（任务投递/执行中/已完成） - 创建时间 - 更新时间 - 描述（任务内容摘要） - 文件路径（关联回 GDrive .md 文件） ### 2. 同步逻辑 - 扫描 `/root/taskboard/01_任务投递/` → 新文件 → 创建多维表格记录 - 扫描 `/root/taskboard/02_执行中/` → 更新状态为"执行中" - 扫描 `/root/taskboard/03_已完成/` → 更新状态为"已完成" - 双向：飞书多维表格的修改 → 同步回 .md 文件（可选，先做单向） ### 3. 飞书 API - 使用现有的飞书 App（App ID: cli_aa8b7220c4b91bda） - App Secret 在 5号 .env 里 - 多维表格需要先在飞书建好，然后用 API 写入 ### 4. 运行方式 - Python 脚本，放在 5号 /root/.hermes/scripts/ - hermes cron 每1分钟触发一次（或 watchdog 监听文件变化触发） ## 参考 - 5号已有飞书 API 凭证（见 .env 中的 FEISHU_APP_SECRET） - 任务目录结构：/root/taskboard/ - 任务模板：/root/taskboard/01_任务投递/_template.md - 现有看板归档脚本参考：/root/.hermes/scripts/kanban-md-sync.py ## 验收标准 - [ ] 飞书多维表格字段设计完成 - [ ] Python 脚本能读取 .md 任务卡片 - [ ] 新任务自动出现在飞书多维表格中 - [ ] 状态变更自动同步 - [ ] cron 每1分钟运行不报错 ## 结果 ## 日志