飞书与 Lark AI 机器人指南：按群聊话题协作，统一管理权限和 Credits

接入使用你自己的飞书或 Lark 应用机器人，需要接收消息事件，并按所用能力配置权限。群里的自定义 Webhook 机器人不能代替它。Sparkles 支持扫码创建，也支持连接已有应用；同一个应用不能同时交给其他机器人服务处理消息。

管理员使用自己的 Sparkles 账号连接，群成员按管理员设置获得使用范围，不需要各自建立另一套积分账户。个人一对一助手需求，可以改看Telegram AI 机器人指南。

1. 登录 Sparkles，点击侧栏的“连接 Telegram / 飞书”并选择飞书 / Lark，或直接进入账户页的飞书设置。
2. 选择对应平台，按页面引导扫码创建应用，由管理员本人核对并确认权限。也可以填写已有应用的 App ID 与 App Secret；已有应用需在开放平台启用机器人、配置消息事件长连接，并完成发布。凭据只填写在专用输入框。
3. 按页面要求完成管理员私聊配对：扫码创建后先私聊机器人；已有应用则发送页面显示的一次性绑定指令。默认只有管理员可以私聊。
4. 把机器人加入目标群，在群里 @ 它发送一条消息，然后回设置页刷新群列表。新群默认关闭，先配置并保存，再开始正式使用。
5. 为该群选择触发方式和成员范围。第一次可以从“仅 @ 机器人”与少量指定成员开始，确认使用方式后再扩大。

流式卡片、交互按钮等能力需要对应的平台权限和回调配置。已有应用修改后要在开放平台发布；页面选择“所有消息”也不会自动授予平台读取全部群消息的权限。

例如，选择“仅 @”和“指定成员”，意味着名单中的成员仍需 @ 机器人。选择“全体成员”也不会让一个关闭的群立即开始处理消息。“所有消息”适合明确愿意让助手参与的工作群，开启前要让成员知道使用范围和费用承担方式。

获准成员在同一话题内与机器人互动时，使用这条话题的共同上下文；不同话题、不同群和私聊保持各自的上下文。想继续修改上一张海报，应回复原话题；想做另一张不相关的海报，应开始新话题。

一个可采用的讨论顺序是：先在新话题说明活动和受众，再在该话题中补充参考图，最后继续回复具体修改要求。下面只是输入范例，正式使用时替换成自己的材料。在“仅 @”模式下，先从飞书 / Lark 的 @ 菜单实际选择机器人，再发送下方文字；直接复制“@机器人”几个字不会形成有效提及。

这条话题用于周末咖啡活动海报。
请先整理目标受众、主标题和三条必须出现的信息，不生成图片。
缺少的内容请一次列出来，等我们确认后再讨论视觉方向。

后续成员可以在原话题补充日期或更改主标题，仍需满足当前群的触发条件与成员权限。不要把不同项目的参考图和修改要求混在一条话题里；共享上下文能帮助衔接，也需要团队保持任务边界。

在群里发送 /new 会创建一个独立新话题，即使这条命令来自旧话题。群里的 /sessions 用于查看并打开这个群的历史话题，不会把当前话题换成另一段历史上下文。导航能否打开还取决于应用是否具备相应消息读取权限；缺权限时先让管理员检查配置。

私聊中，/new 在同一聊天窗口建立新会话，/sessions 可以切回这位发起人自己的历史会话。切换影响之后收到的消息，已提交任务仍属于原会话；未提交的附件也不会自动搬过去。

管理员可通过 /setting 或 /settings 打开配置卡，选择回复模型、支持的思考强度和回复语言。设置只影响后续新任务。群成员的 /stop 用于请求取消自己在当前对话范围最近提交的任务，不能代替管理员管理别人的工作。

回复按实际处理阶段进入 Markdown 卡片。有 CardKit 权限时，可以看到原生流式文字和打字机效果；缺少该权限时使用普通卡片更新。需要你选择时，助手会发出选项卡片，由原提问者回答，避免同一张卡被旁人误操作。

可以提交文字、图片、普通文件和视频附件，一次最多 6 个。先发附件再发需求时，尚未提交的附件按成员分别暂存，不会自动拿走另一成员的待用图片。格式和体积仍受工具与平台的上传限制。

图片结果保留预览，同时另发原文件附件；需要原画质时下载那个文件。超过渠道上传边界的结果不会自动降质发送，管理员可以回网页查看已有成果。若应用已取得消息表情权限，会显示处理状态；只有请求完成且结果投递成功，才标记完成。

所有渠道任务使用绑定管理员的 Credits 和模型资格。群成员可以使用，并不意味着模型调用免费，也不意味着成员获得管理员的全部网页权限。/credits 只供管理员在私聊中查询余额，不在群里披露。

管理员可以在网页查看其渠道会话，包括渠道私聊。成员自己的私聊目录不会包含其他成员的私聊或其他群，但这不等于管理员看不到内容。建议在启用群机器人时说明这一点，避免把工作机器人当作个人秘密聊天。

网页画布和私有文件入口仍需要有权访问的账号登录。把一个链接发进群，不会自动把管理员的私人项目共享给全体成员。更多成果整理方式见从聊天应用回到画布。

先选一个群、一条清楚的话题和少量获准成员，完成“讨论需求 → 确认方向 → 生成 → 下载检查”的过程。确认卡片、原文件、历史话题和管理员用量都符合预期，再扩展到更多工作。

如果机器人不响应，按“群是否启用、发送人是否在范围内、是否需要 @、应用权限是否发布”逐项检查；如果消息已有结果但附件没有送达，管理员先回网页检查，别急着重复发起付费生成。