feishu-meeting-kblisted

# feishu-meeting-kb 会议开完 → 机器人主动提醒你 → 你把文字记录链接发给它(拖文件也行)→ 自动合并进一篇越写 越厚的知识库文档。 ## 引导新用户安装(Claude 被邀请执行这个 skill 时应该做的事) **核心原则:这是一场对话,不是一份甩给用户抄的操作手册。** 除了"去飞书网页后台建应用"这一步 必须用户自己在浏览器里点(没法代劳),其余所有事——写 `.env`、跑 `oauth.py login`、验证、装 常驻服务——都由你(Claude)直接用 Write/Bash 工具替用户做完,不要让用户自己开终端敲命令、 自己手改文件。用户只需要:回答你的几个问题、把两个值粘贴给你、在浏览器���窗里点"同意"。 ### 第 0 步:先跑演示,建立信心 `python3 demo.py`——不用任何飞书凭证就能看到"提醒长什么样"+"全量合并逻辑是否靠谱"+"范围模式 (只整理指定内容)效果如何"(合并这两步真实调用本机 `claude -p`)。等用户觉得效果满意, 再问要不要接真实飞书。 ### 第 1 步:问清楚偏好,再动手(参照 follow-builders 的对话式安装体验) 装真实飞书之前,先用聊天问用户这几个问题(不是为了凑仪式感,答案会直接决定你接下来怎么改 文件): 1. **"提醒消息你想要中文还是英文?"** —— 答案决定你要不要去改 `reminder.py` 里 `_msg()` 函数的文案模板(现在默认是中文)。 2. **"你想让知识库按什么方式组织?"**(按项目/按主题/按时间,或者"先空着,以后再说")—— 答案决定你要不要现在就去改 `kb_content.md` 的初始标题结构,而不是留着通用空模板。 3. **"多久检查一次日历?"**(默认 5 分钟,一般不用改,除非用户明确想要更快/更慢)——对应 `.env` 里的 `REMINDER_POLL_SEC`。 4. **"要不要顺便装'机器人收链接/文件自动合并'这部分?"**——这个需要额外配置飞书的"事件与回调" 长连接,如果用户只是想要一个"会议结束提醒",可以先跳过 `feishu_bridge.py` 这部分,只装 `reminder.py`。 拿到答案后,后面每一步该怎么配你心里应该已经有数了,不用装完再回头改。 ### 第 2 步:建飞书自建应用(唯一需要用���自己操作的环节) 引导用户打开 https://open.feishu.cn/app ,按这个顺序操作(跟用户说清楚每一步在页面哪里, 必要时让用户截图发给你确认): 1. 用飞书 App 扫码登录 2. 点「创建企业自建应用」,填个名字和描述,点「创建」 3. 跳到「添加应用能力」页面,「机器人」卡片点「添加」 4. 左侧「凭证与基础信息」——把 **App ID** 和 **App Secret** 发给你 5. 左侧「权限管理」,搜索开通(全部免审):`calendar:calendar:readonly`、 `docx:document:readonly`(读用户发来的文档链接正文)、`im:message`、`im:resource` 6. 左侧「安全设置」,加重定向 URL:`http://localhost:8765/callback` 7. 如果第 1 步用户说要装收消息合并:左侧「事件与回调」,连接方式选「长连接」,订阅 `im.message.receiv