角色场景
不同角色首次使用清海 AI 时收到授权卡片的完整对话旅程设计。 功能概览见 飞书个人授权，能力定义见 Skill 清单。
核心设计原则
| 原则 | 说明 |
|---|---|
| 首条消息触发，非功能触发 | 用户发任何第一条消息，清海即同步发送授权卡片，与消息内容无关 |
| 非阻塞 | 授权卡片不阻断正常对话，清海照常回复用户的问题，卡片是额外的引导 |
| 一次性原则 | 同一用户只推送一次，后续对话不重复出现（除非 refresh_token 过期需重授权） |
| 拒绝可接受 | 用户可以点「暂不授权」，清海仍可服务，但个人数据功能受限时再次友好提醒 |
场景一：老板（首次对话）
老板通常第一条消息就是业务问题，清海回答的同时附上授权卡片。
会话旅程
老板（第一条消息）：最近公司有什么大事吗
清海（正常回复 + 附加授权卡片）：
根据最近的飞书同步，上周有 3 个重要动态：
1. 研发部完成了 boss-agi v1.2 上线
2. 运营组完成了多燕瘦 Q1 复盘
3. HR 发布了新的考勤制度
┌─────────────────────────────────────────┐
│ 👋 我是清海，很高兴认识你！ │
│ │
│ 授权后我可以帮你： │
│ • 📝 整理会议妙记 → 自动生成会议纪要 │
│ • 📄 查找你的云文档和知识库 │
│ • ✅ 追踪你的个人任务进度 │
│ • 📊 读取你的多维表格数据 │
│ │
│ 授权仅用于执行你的指令，不会主动读取数据。 │
│ │
│ [ 点击授权 ] [ 暂不授权 ] │
└─────────────────────────────────────────┘
（老板点击「点击授权」，飞书弹出确认页，老板点「允许」）
清海：✅ 授权成功！现在我可以帮你读取妙记、文档、任务等个人数据了。
有什么需要我做的，随时说。后续对话（已授权）
老板（第二条消息）：帮我把昨天下午的产品评审会整理成纪要
清海：正在获取昨天下午的妙记…（直接执行，无任何授权提示）场景二：普通员工（首次对话）
员工可能用清海问日常问题，清海正常作答并附上授权卡片。
首次对话，授权
员工（第一条消息）：请假流程是什么
清海（正常回复 + 附加授权卡片）：
请假需要在飞书审批中提交「请假申请」，选择假期类型…
┌─────────────────────────────────────────┐
│ 👋 我是清海，很高兴认识你！… │
│ [ 点击授权 ] [ 暂不授权 ] │
└─────────────────────────────────────────┘
（员工点击「点击授权」，完成授权）
清海：✅ 授权成功！有什么需要我帮你的，随时说。首次对话，暂不授权
员工（第一条消息）：请假流程是什么
清海：（正常回复请假流程 + 发送授权卡片）
员工：暂不授权（点击按钮）
清海：没问题！不授权也可以正常跟我聊。
如果以后需要我帮你整理会议纪要、查找私有文档，随时告诉我，我重新发授权链接。未授权情况下触发个人数据功能
员工（未授权）：帮我整理一下今天的会议
清海：整理妙记需要访问你的个人飞书数据，我先给你发一次授权链接：
┌─────────────────────┐
│ [ 点击授权 ] │
└─────────────────────┘
授权完成后我马上帮你处理。场景三：HR（首次对话）
HR 通常关注薪酬、绩效类会议记录，清海对敏感内容有额外过滤。
首次对话
HR（第一条消息）：帮我查一下销售部最近的绩效情况
清海（回复查询结果 + 附加授权卡片）：
根据通讯录和近期同步的信息，销售部共 12 人…
┌─────────────────────────────────────────┐
│ 👋 我是清海，很高兴认识你！… │
│ [ 点击授权 ] [ 暂不授权 ] │
└─────────────────────────────────────────┘
（HR 完成授权）
清海：✅ 授权成功！现在我可以帮你读取你的妙记、文档等个人数据了。场景四：部门负责人（首次对话）
负责人通常首条消息是询问团队情况。
首次对话
部门负责人（第一条消息）：技术部最近在忙什么
清海（回复 + 附加授权卡片）：
根据 GitLab 最近的提交记录，技术部上周主要在做…
┌─────────────────────────────────────────┐
│ 👋 我是清海，很高兴认识你！… │
│ [ 点击授权 ] [ 暂不授权 ] │
└─────────────────────────────────────────┘
（负责人点击授权，完成）
清海：✅ 授权成功！有需要帮你整理会议纪要或查文档，随时说。重新授权场景（refresh_token 过期）
超过 30 天未使用任何个人数据功能，refresh_token 过期，需重新授权一次。
员工（30 天后发消息）：帮我整理一下昨天的会议
清海（检测到 refresh_token 过期）：
上次授权已过期（超过 30 天未使用个人数据功能），需要重新授权一次：
┌─────────────────────┐
│ [ 重新授权 ] │
└─────────────────────┘
（员工点击完成授权）
清海：✅ 授权成功！正在获取昨天的妙记…异常场景处理
| 异常 | 清海回复 |
|---|---|
| 点击授权后关闭了 OAuth 确认页（未完成） | 「授权未完成，随时发消息给我重新发一次授权链接」 |
| 授权回调超时（> 5 分钟未完成） | 自动作废，下次触发个人数据功能时再次引导 |
| 飞书 OAuth 服务异常 | 「飞书授权服务暂时不可用，稍后再试」 |
| 用户在飞书开放平台主动撤销授权 | 下次触发个人数据功能时检测到 token 失效，重新引导 |
| 员工询问数据安全 | 「我只在你主动发指令时才读取你的数据，不会在后台主动扫描。你可以随时通过飞书开放平台撤销授权。」 |