@blade-hq/agent-react 2612.0.0-beta.54 → 2612.0.0-beta.55

package/README.md

@@ -501,3 +501,16 @@ ChatView 和 `<blade-chat>` 的默认轻量输入支持 @ 搜索插件条目，
 入口同时导出 `AskUserQuestionData` 和 `AskUserAnswerData` 类型。通过 `data`、`answered`、`answerData` 和 `sessionStatus` 提供问题及状态；`onAnswer(text, toolCallId, answerData)` 交给宿主，使用 `session.send(text, { askUserAnswer: { tool_call_id: toolCallId, ...answerData } })` 将原生结构化回答送回原始会话，不能送入普通文本队列。
 
 Questionnaire 负责必答校验、原生单选/多选、自填和前后分页，不提供跳过问题的业务行为。宿主负责传输、提交失败反馈、刷新已保存的回答及主题样式；提交失败时以 `sessionStatus="failed"` 恢复当前选择供重试。问题类型及文本格式化函数与 BA 原生协议共用。
+
+## 飞书授权接入
+
+`DeviceConnection` 接收宿主的 `read`、`act`、`onChanged` 回调及可选 `onDisable`、`diagnostics`。宿主可用 `initialPage="manage"` 在首次挂载时直达管理页；尚未关联应用时仍进入连接入口，不会自动创建应用或授权。组件按真实能力目录中的业务分类、审核证据和可执行状态展示工作能力；免审默认全选，需审核和待飞书确认分别列出且默认不选。未实现的操作不参与选择。
+
+首次关联应用后，再确认已查明的免审范围。添加能力会先重新核验当前权限，成功后才按最新免审证据默认选择；核验失败保留连接与错误。统一授权流程按 `authorize` / `poll` 逐步展示当前飞书官方二维码，完成后显式 `finish`；PA 通过 `bindDelivery` 接入机器人消息，接入失败保留授权，可单独重试。完整分类选择在完成时替换启用集合，局部补权保留其他已选项；取消申请保留已有授权。增加能力时保留此助手原有停用状态，按钮显示“授权并保存”，暂停推送也不会被自动恢复。日志、历史步骤和原生错误编号放在连接帮助的高级排查内。
+
+PA 等只需要授权界面的宿主可从 `@blade-hq/agent-react/connectors` 导入，避免加载整套聊天 UI。组件仅接收公开授权链接，二维码在本地生成。宿主须扫描组件源码（含 `FeishuCapabilitySelection.tsx`）的 Tailwind 样式，或使用 SDK 完整样式。认证身份变化时重建组件，避免沿用前一账号的视图。
+
+
+### 聊天中的飞书连接
+
+`@blade-hq/agent-react/connectors` 的 `DeviceConnection` 可传 `autoAuthorize`：仅在用户主动打开聊天授权卡片时开始准备官方二维码，设置页默认仍手动发起。`authorizationCapabilities` 用于只补当前操作需要的能力；已有有效二维码会继续使用，不重复生成。生成二维码不代表用户授权或企业审核已通过。

package/dist/{chunk-OQQCJD3L.js → chunk-2U5HZ3PG.js}

@@ -11,12 +11,14 @@ import {
   X,
   cn,
   copyToClipboard,
-  dist_exports3 as dist_exports,
   useChatEnvironment,
   useHighlightedCode,
-  useOptionalBladeClient,
+  useOptionalBladeClient
+} from "./chunk-PMNUGFTJ.js";
+import {
+  dist_exports5 as dist_exports,
   useOverlayRoot
-} from "./chunk-VUDRKCD4.js";
+} from "./chunk-HS5G33FO.js";
 import {
   __export
 } from "./chunk-PR4QN5HX.js";
@@ -9475,4 +9477,4 @@ export {
   CodeBlockPre,
   MarkdownContent
 };
-//# sourceMappingURL=chunk-OQQCJD3L.js.map
+//# sourceMappingURL=chunk-2U5HZ3PG.js.map