飞书应用配置
为工作空间创建一个飞书应用，登录与通知共用。
工作空间的飞书集成使用一个自建应用同时承担登录与通知。本页指引组织管理员在 5 分钟左右完成应用创建与接入。
准备工作
- 拥有组织飞书开放平台（飞书 open.feishu.cn / Lark open.larksuite.com）的管理权限。
- 拥有将要接入的 Wujie 工作空间的 owner 或 admin 权限。
- 知道 Wujie 部署的公网地址（例如
https://wujie.example.com）。飞书只回调你预先登记的地址。
创建应用
进入飞书开放平台 → 开发者后台 → 创建应用 → 选择企业自建应用，名称如「无界 – 你的团队」。创建完成后，在应用凭证与基础信息页复制 App ID 与 App Secret，稍后回填到 Wujie。
开启机器人能力
在应用内打开应用能力 → 添加能力 → 启用机器人。通知通过该机器人在飞书私聊中投递。
登记重定向 URL
打开安全设置 → 重定向 URL，添加：
https://你的-WUJIE-域名/auth/callback这是最容易漏掉的一步。 未登记重定向 URL 时，飞书会在登录授权环节直接报 redirect_uri 错误。地址必须与域名完全一致——协议、主机、路径都要相同。
开通权限
打开权限管理，开通：
| 权限 | 标识 | 用途 |
|---|---|---|
| 获取用户基本信息 | contact:user.base:readonly | 识别登录成员的身份 |
| 获取与发送单聊、群组消息 | im:message | 通过机器人投递通知 |
发布应用
打开版本管理与发布 → 创建版本 → 提交发布。自建应用在首个版本发布前不生效——权限与机器人对组织成员都不可用。
回到 Wujie 接入
- 在工作空间打开 设置 → 集成 → 飞书。
- 粘贴 App ID 与 App Secret。
- 点击验证凭据——保存前 Wujie 会先向飞书核验。
- 保存后按需启用开关：
- 私聊通知——飞书机器人投递提及/任务事件；
- 飞书登录——允许成员使用飞书登录。
需要接收通知或使用飞书登录的成员，在应用配置完成后，到设置 → 个人资料选择工作区并绑定飞书身份。接收通知还需到设置 → 通知选择同一工作区，开启个人接收并保存；绑定身份不会自动开启通知。
登录是如何工作的
- 飞书登录按工作空间隔离：成员授权时使用的是本工作空间配置的应用。
- 在登录页选择使用飞书登录。浏览器会记住你最后访问的工作空间并直接对它发起授权；否则会要求输入工作空间标识（站点地址
/后面的部分，如https://wujie.example.com/acme中的acme）。 - 只有已存在且已绑定飞书身份的账号能用此方式登录——飞书登录不开放注册。
更换或移除应用
- 轮换 App Secret——用同一 App ID 保存新 Secret 即可，绑定关系不受影响。
- 更换 App ID——需在弹窗中二次确认；旧应用的身份绑定会被清除，成员需要重新绑定。
- 删除配置——本工作空间的飞书通知与登录都会停用，直到配置新应用。
App Secret 使用部署的加密密钥加密存储，保存后不再明文显示。
部署管理员需配置 WUJIE_WORKSPACE_SECRET_KEY（Base64 编码的 32 字节密钥），用于加密保存工作区应用的 App Secret。请持久保存此密钥；WUJIE_LARK_SECRET_KEY 用于独立的智能体 Bot 集成，不能替代它。