mirror of
https://gitcode.com/JianFeeeee/homeagent-sdk.git
synced 2026-10-31 14:27:30 +00:00
fix(qq): 打字指示器挂到正确路径 + 状态限流改为补发而非丢弃
用户反馈两处仍然不对: 「qq插件的通过在线状态展示agent工作状态还是不正确」 「正在输入中显示也不正确」 ## 缺陷 1:打字指示器一次都没触发过 诊断日志给出了决定性证据(加临时探针跑真实私聊): [qq-dbg] before_output: input_source="" qq_uid=<nil>(has=false) extra_keys=0 `extra_keys=0` —— 说明触发的是**另一条路径的 before_output**。 `before_output` 被两个语义共用: emitResponse(eventloop.go) = 一轮的回复,turn 边界 output.go = 单次 output_send__* 的工具输出 **真正把消息发出去的是后者**,而它构造 stageCtx 时**连 Extra 都没初始化** (nil)。我把打字指示器挂在它上面,读了永远不存在的 qq_uid。 修法:内核 output.go 的 stageCtx.Extra 补三个键 output_channel 目标通道 output_meta 本次发送的 meta 原文(user_id / group_id) output_type text / image / file 插件据此在**消息发出前** startTyping,发出后 stopTyping。 群聊不发(QQ 的「正在输入」只在私聊标题栏有意义)。 ## 缺陷 2:output.go 路径没有 after_output 它才是"消息真的送达"的时刻,却只发了 before_output。没有配对的收尾, 指示器只能等 30 秒超时自己灭。补上 after_output。 ★ 但 after_output 现在被两条路径共用,必须区分: 单次发送 → stopTypingAfterOutput(配对的收尾) turn 边界 → stopTypingForTurn + auth 清理 + **状态归位「在线」** 状态归位**只能由 turn 边界触发**:一轮可能发多条消息,若每条发完都归位 「在线」,状态会在干活期间反复跳回空闲 —— 那正是"用状态展示工作进度" 失效的原因之一。 ## 缺陷 3:限流把期望状态丢掉了 `applyStatusMaybe` 命中 2 秒限流时直接 `return`,**期望状态被丢弃**。 而 stage 之间常常不到 2 秒: pre_action(学习中) --0.5s--> before_toolcall(搬砖中) ⇒ "搬砖中" 被丢 状态是「当前工作阶段」的**投影**,不是事件流 —— 投影必须最终收敛到最新值。 改为:限流只限制发送频率,被推迟的记进 `pending`,窗口结束后补发**最新**值 (不是补发被拒的那个:窗口内可能连来多个,中间值没有独立意义)。 `restoreStatus` 停机时先取消待补发,否则定时器会在连接拆除后醒来。 ## 实测(真实私聊 webhook) 17:58:15 对方正在输入中 → 开始(uid=2198972886,消息发出前) 17:58:15 对方正在输入中 → 结束(uid=2198972886,消息已发出) 状态序列体现出工作阶段: 17:58:05 学习中(限流后补发) 17:58:07 搬砖中 17:58:09 学习中(限流后补发) 17:58:15 搬砖中 17:58:19 在线(turn 边界,任务结束) ## 判据 新增 TestOnlineResetOnlyOnTurnBoundary(变异咬:单次发送也归位 → 报错)。 ★ 修了判据自身的假绿:typing_test 的 bodyOf 用"找行首 }"截函数体, stageAfterOutput 新增 if 分支后,第一个行首 } 是**内层块**的结尾 ⇒ 判据只看到前半段 ⇒ 后半段的调用"看不见"、删掉也不咬。 改用括号计数的 funcBody。
This commit is contained in:
@ -149,3 +149,43 @@ func TestToolCountLoggedIsNotHardcoded(t *testing.T) {
|
||||
t.Fatal("★ regTool 没有累加 p.toolCount —— 计数恒为 0,日志会报 `0 tools`")
|
||||
}
|
||||
}
|
||||
|
||||
// ★★★ 判据 8:状态归位(在线)**只能由 turn 边界触发**,不能由单次发送触发。
|
||||
//
|
||||
// after_output 被两条路径共用(2026-10-18):
|
||||
//
|
||||
// output.go 单次 output_send__*(Extra 有 output_meta)
|
||||
// eventloop 一轮的回复(turn 边界)
|
||||
//
|
||||
// 一轮可能发多条消息。若每条发完都归位「在线」,状态会在干活期间
|
||||
// 反复跳回空闲 —— "通过状态展示工作进度"就失效了。
|
||||
func TestOnlineResetOnlyOnTurnBoundary(t *testing.T) {
|
||||
lines := codeLines(t, "status.go")
|
||||
body := funcBody(t, lines, "func (p *Plugin) stageAfterOutput(")
|
||||
|
||||
// 必须有区分两条路径的分支
|
||||
if !strings.Contains(body, "isSingleSendStage(ctx)") {
|
||||
t.Fatal("★ stageAfterOutput 没有区分「单次发送」与「turn 边界」——\n" +
|
||||
" 两条路径共用同一个 stage,不区分会让单次发送也归位「在线」")
|
||||
}
|
||||
|
||||
// 单次发送分支必须在归位之前 return(不能继续往下走到 applyStatusForce)
|
||||
iBranch := strings.Index(body, "if isSingleSendStage(ctx) {")
|
||||
iOnline := strings.Index(body, "applyStatusForce(qqStatusOnline)")
|
||||
if iBranch < 0 || iOnline < 0 {
|
||||
t.Fatal("找不到分支或状态归位调用")
|
||||
}
|
||||
branch := ifBlockAt(body, iBranch)
|
||||
if !strings.Contains(branch, "return") {
|
||||
t.Fatal("★ 单次发送分支没有 return —— 会继续走到状态归位")
|
||||
}
|
||||
if strings.Contains(branch, "applyStatusForce") {
|
||||
t.Fatal("★ 单次发送分支里归位了「在线」—— 一轮发多条消息时状态会反复跳回空闲")
|
||||
}
|
||||
|
||||
// isSingleSendStage 的判据键必须是 output_meta(内核 output.go 放的)
|
||||
helper := funcBody(t, lines, "func isSingleSendStage(")
|
||||
if !strings.Contains(helper, `ctx.Extra["output_meta"]`) {
|
||||
t.Fatal("★ isSingleSendStage 没认 output_meta —— 与内核 output.go 的契约不符")
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user