飞书紧急提醒

通过飞书发送加急消息，实现紧急提醒。支持电话加急（真正打电话到手机）和应用内加急（飞书 App 强推送）两种方式。

首次使用配置（最高优先级）

每次执行技能前，必须先检查环境变量。 缺哪项补哪项，不要全量重配。

检查步骤

bash
echo APPID=${FEISHUAPPID:-(未设置)} && echo APPSECRET=${FEISHUAPPSECRET:-(未设置)} && echo USEROPENID=${FEISHUUSEROPEN_ID:-(未设置)}

• - 三项都存在 → 跳过本节，直接执行用户请求
• 任何一项显示「未设置」→ 只针对缺失项执行下方对应步骤

补全缺失的 FEISHUAPPID / FEISHUAPPSECRET

仅当 APPID 或 APPSECRET 缺失时执行。

向用户索取凭证：

需要配置飞书应用凭证才能使用。请提供：

• - App ID 和 App Secret — 在 飞书开放平台 → 应用详情 → 凭证与基础信息 中获取

如果还没有飞书应用，请参考下方「飞书应用创建指南」创建。

用户提供后，用 save-config 保存凭证（跨平台、幂等）：

bash
python3 {baseDir}/scripts/feishu_meeting.py save-config --app-id 用户提供的AppID --app-secret 用户提供的AppSecret

安全提醒：写入完成后，不要在聊天中回显 App Secret 明文。只需告诉用户「凭证已保存」。

补全缺失的 FEISHUUSEROPEN_ID

仅当 FEISHUUSEROPENID 缺失时执行。需要 APPID/SECRET 已就绪。

向用户索取手机号或邮箱，然后 lookup：

bash
python3 {baseDir}/scripts/feishu_meeting.py lookup --phone 用户的手机号

查到 open_id 后，保存到配置文件：

bash
python3 {baseDir}/scripts/feishumeeting.py save-config --user-id 查到的openid

配置完成

补全所有缺失项后告诉用户：

飞书配置已保存，后续使用无需再次配置。

然后继续执行用户原本的请求（发提醒、打电话等），Python 脚本会自动加载配置文件：

bash
python3 {baseDir}/scripts/feishu_meeting.py notify --message xxx

飞书应用创建指南

如果用户还没有飞书应用，引导他们：

1. 1. 打开 飞书开放平台，点击「创建企业自建应用」
2. 填写应用名称和描述，创建应用
3. 记录 App ID 和 App Secret
4. 左侧「应用能力」→ 添加「机器人」能力
5. 左侧「权限管理」→ 搜索并开通以下权限：

- im:message（发送消息） - im:message.urgent:phone（电话加急） - contact:user.id:readonly（查找用户）

1. 6. 左侧「版本管理与发布」→ 可用范围中添加自己 → 创建版本并发布

目标用户判断（重要）

执行提醒前，你需要判断提醒发给谁：

情况 1：提醒自己（默认）

用户说「提醒我」「给我打个电话」「叫我一下」等没有提到其他人的情况，直接使用默认的 FEISHUUSEROPEN_ID（即用户自己）。

bash

不需要 --user-id，自动使用环境变量中配置的用户

python3 {baseDir}/scripts/feishu_meeting.py notify --message 小龙虾提醒你：该干活了

如果 FEISHUUSEROPEN_ID 环境变量未配置，回到上方「首次使用配置」流程引导用户完成配置。

情况 2：提醒其他人（用户提供了手机号或邮箱）

用户说「提醒 13912345678 的张三」「给 zhangsan@company.com 打个电话」等包含手机号或邮箱的情况：

注意： 对方必须满足以下条件才能被提醒：

1. 1. 对方已注册飞书账号（手机号/邮箱已关联飞书）
2. 对方与你在同一个飞书组织（租户）内
3. 对方已被添加到应用的可用范围中

如果 lookup 查不到用户，请提醒用户确认以上条件。

第一步：用 lookup 查找对方的 open_id

bash

手机号不需要用户手动加 +86，脚本会自动补全

python3 {baseDir}/scripts/feishu_meeting.py lookup --phone 13912345678

第二步：用查到的 open_id 发起提醒

bash
python3 {baseDir}/scripts/feishumeeting.py notify --message 小龙虾提醒你：xxx --user-id 查到的openid --phone-call

手机号自动补全

用户提供的手机号不需要加 +86 前缀，脚本会自动处理：

• - 13800138000 → 自动补全为 +8613800138000
• 8613800138000 → 自动补全为 +8613800138000
• +8613800138000 → 保持不变

判断流程总结

1. 1. 用户没有提到其他人 → 使用默认 FEISHUUSEROPENID
2. 用户提到了手机号或邮箱 → 先 lookup 查 openid，再用 --user-id 指定
3. FEISHUUSEROPEN_ID 未配置且未提供手机号 → 提示用户先配置

快速开始

bash

发送加急消息（应用内加急）

python3 {baseDir}/scripts/feishu_meeting.py notify --message 小龙虾提醒你：该干活了

电话加急（真正打电话到手机！）

python3 {baseDir}/scripts/feishu_meeting.py notify --message 紧急！线上故障 --phone-call

提醒其他人（先查 open_id，再提醒）

python3 {baseDir}/scripts/feishu_meeting.py lookup --phone 13912345678 python3 {baseDir}/scripts/feishumeeting.py notify --message 小龙虾提醒你：xxx --user-id 查到的openid --phone-call

命令说明

1. notify — 发送加急消息（推荐）

发送一条加急文本消息，支持应用内加急和电话加急。

bash

应用内加急（默认）

python3 {baseDir}/scripts/feishu_meeting.py notify --message 你的任务快到截止日期了

电话加急（真正打电话到手机！）

python3 {baseDir}/scripts/feishu_meeting.py notify --message 紧急！ --phone-call

参数	说明	默认值
--message / -m	消息内容（必填）	-
--user-id / -u

用户 openid | 从 FEISHUUSEROPENID 读取 | | --phone-call | 使用电话加急（拨打手机），不加则默认应用内加急 | 默认不加 |

2. lookup — 查找用户 open_id

bash
python3 {baseDir}/scripts/feishu_meeting.py lookup --email user@company.com
python3 {baseDir}/scripts/feishu_meeting.py lookup --phone +8613800138000

使用场景

场景	推荐命令	说明
重要任务到期	notify	发送加急消息提醒
紧急消息通知

notify | 应用内加急推送 | | 需要电话提醒 | notify --phone-call | 直接打电话到手机 | | 查找其他用户 | lookup | 通过手机号/邮箱查找 open_id |

使用示例

紧急任务提醒

bash python3 {baseDir}/scripts/feishu_meeting.py notify --message 小龙虾提醒你：15分钟后有客户会议

电话加急提醒

bash python3 {baseDir}/scripts/feishu_meeting.py notify --message 小龙虾提醒你：紧急线上故障 --phone-call

简单消息提醒

bash python3 {baseDir}/scripts/feishu_meeting.py notify --message 数据分析报告已完成，请查收

使用注意

1. 1. 不要