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:
JianFeeeee
2026-10-18 18:01:00 +08:00
parent c6c39aa2a8
commit cca6fdaa6b
3 changed files with 279 additions and 24 deletions

View File

@ -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 的契约不符")
}
}