核心功能
Feishu Group Manager 是一套面向飞书（Feishu/Lark）生态的群组管理自动化工具集，主要通过命令行脚本实现对群聊元数据的程序化控制。
主要能力模块
1. 忙碌状态标记（Toggle Busy Status）
- 通过修改群名称前缀（如
[]）直观标示机器人正在执行耗时任务 - 双状态切换：
busy与idle - 触发条件：单聊控制组中运行超过 30 秒的长任务
2. 群组设置更新（Update Settings）
- 名称管理：动态修改群聊显示名称
- 公告区配置：更新群描述（announcement area）
- 权限矩阵控制：
- 群信息编辑权限（全员/仅群主）
- @全员权限（全员/仅群主）
- 邀请权限（全员/仅群主）
显著优点
- 自动化集成友好：纯 Node.js CLI 设计，便于嵌入 CI/CD 或定时任务
- 权限粒度精细：覆盖飞书群组核心权限维度，满足企业级管控需求
- 状态可视化：忙碌前缀机制提供低侵入式的实时状态反馈
- 协议驱动：遵循
MEMORY.md中定义的 Busy Status Protocol，确保行为一致性
潜在局限与风险
- 无内置鉴权：脚本依赖外部调用方提供合法
chat_id，需自行确保 API Token 安全 - 权限覆盖风险：错误配置
--edit-permission或--invite-permission可能导致群组失控或协作受阻 - 平台耦合强：深度绑定飞书 API，迁移成本较高
- 无操作审计：本地脚本执行缺乏原生日志留存，需额外接入监控体系
- 命名冲突隐患：忙碌前缀与正常群名结合时，若前缀规则不统一易造成识别混乱
适用人群
- 运维自动化工程师（SRE/DevOps）
- 企业内部机器人开发者
- 需要批量管理飞书群组的管理员
- 构建 AI Agent 控制中枢的开发者（尤其是有长时任务场景）
常规风险
| 风险类型 | 描述 |
|---------|------|
| 误操作风险 | 参数误传导致群名或权限被意外覆盖 |
| Token 泄露 | 脚本运行依赖飞书 API Token，需妥善保管 |
| 协议漂移 | 飞书 API 版本升级可能导致脚本失效 |
| 并发冲突 | 多实例同时操作同一群组可能产生竞态条件 |