## 项目概述
- 名称:飞书 AI 纪要与周报助手
- 目标客户:使用飞书的10–200人中小团队(外包/本地SaaS/教研等)
- 核心价值:会议结束1分钟内生成纪要与行动项;周五自动生成周报草稿;一键发布飞书文档并在群内回链;每人每周节省2–5小时
- 差异化:
  - 行动项结构化(负责人/截止日期/优先级/状态/备注)并可@负责人提醒
  - 周报与会议串联:周报可引用本周会议结论和行动项状态
  - 成本可控:支持租户自带通义千问Key;平台Key仅兜底并限额
  - 可审计:调用日志、错误日志、版本记录
- 商业模式:订阅
  - 套餐:¥99(≤10人)/ ¥299(≤30人)/ ¥699(≤100人)
  - 超额:¥3/人/月
  - 试用:7天或50次生成(取先到);平台兜底Key日150次
## 架构与技术选型
- 后端:Node.js + Express
- ORM:Prisma(MySQL Provider)
- 数据库:MySQL 8.x(utf8mb4, 时区+8)
- 调度:node-cron(周五17:30默认),个人偏好可覆盖
- 队列:可选 bullmq(AI生成/发布异步化)
- 日志:morgan(访问)+ winston(应用);请求ID贯穿
- 安全:CORS、限流、输入校验(zod/joi)、.env分环境、密钥加密(AES-256/KMS)
- 运维:pm2守护;ufw只开22/80/443;fail2ban防爆破;Nginx(正式环境)
- 外部:飞书开放平台;通义千问(DashScope)
## 功能分层
- 适配层
  - 飞书事件订阅 /feishu/events
  - 飞书卡片回调 /feishu/card
  - 飞书文档API封装(创建/写入/权限)
- 业务层
  - 会议纪要生成器(从“会后要点卡片”输入生成草稿)
  - 行动项提取与结构化管理(负责人/截止/优先级/状态/备注)
  - 周报生成器(通用/研发/产品/运营四套措辞)
  - 发布流:草稿→确认→发布文档→群回链→可选@负责人
- 支撑层
  - 租户管理(套餐/到期)
  - App连接(飞书凭证、回调Token/EncryptKey)
  - Key管理(租户自带通义Key、平台兜底Key)
  - 调用日志/错误日志/用量统计
  - 定时器(周报推送)、个人偏好(自定义时间)
   ## 卡片与交互(核心四步)
1) 会后要点收集卡片:1.会议题目、2.关键要点、3.参与人员(这三个内容可卡片内在线编辑)(下方添加“确认”按钮)
2) (AI生成)纪要草稿确认卡片:应由AI根据“会后要点收集卡片”内容生成会议概览、关键结论、行动项、风险点、缺失信息、生成时间、文档ID这些内容。
3) 发布结果卡片:文档ID、发布时间、发布人、会议主题、文档链接、内容统计、后续操作提示(仅文本且不可编辑)
4) 周报草稿卡片(定时推送):选择角色模板;四段式(本周完成/量化指标/下周计划/风险与支持);发布/稍后提醒(待进还未开发)
# 飞书AI纪要助手
智能会议纪要生成和管理系统,基于飞书开放平台和AI服务构建。
## 功能特性
- 🤖 **智能纪要生成**: 基于通义千问AI,自动生成结构化会议纪要
- 📋 **行动项管理**: 自动提取和跟踪会议行动项
- 🔗 **飞书深度集成**: 无缝集成飞书生态,支持群聊、卡片交互
- 📄 **文档自动发布**: 自动创建和分享飞书文档
- 🏢 **多租户支持**: 支持多个飞书应用和团队
- 🔒 **安全可靠**: 完善的权限控制和数据加密