Zhin.js

Appearance

ADR 0038: Activity Feedback 资格与 Schedule 三相位 ​

状态 ​

Accepted

背景 ​

  • 人类入站 AI turn 需要 queued/thinking/active 类 activity feedback。
  • Schedule / TaskExecutor turn 不应误触 ai.processing.* 的 queued/thinking/active。
  • Schedule 任务在 activityFeedback=true 时需要独立的 start/finish/error 指示。

决策 ​

D1. activityFeedbackEligible ​

  • TurnContextStore.activityFeedbackEligible：仅 register-ai-trigger 人类入站 turn 为 true。
  • TaskExecutor、subagent、deferred worker：false（经 initScheduleTurnContext / 默认）。

D2. Schedule 三事件 ​

事件派发点
schedule.startTaskExecutor.executeTask 入口（activityFeedback=true）
schedule.finish执行成功、投递前
schedule.errorcatch 失败路径

Activity Feedback 插件订阅上述事件；不走 ai.processing.start/finish 的 queued/thinking/active。

D3. 门控 ​

isActivityFeedbackEnabled(payload, phase)：

  • 手动 turn + activityFeedbackEligible===true → queued/thinking/active
  • Schedule turn + scheduleActivityFeedback===true → schedule_start / schedule_finish / schedule_error

D4. 配置 ​

activityFeedback.schedule.phases: { start, error, finish } per scene type（service 插件 config）。

实现位置 ​

相关 ​