@chen_hu_hu/pi-qq 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +5 -6
- package/doc/{features.md → features-v1.md} +28 -50
- package/doc/{plan.md → plan-v1.md} +22 -27
- package/index.ts +14 -54
- package/package.json +2 -2
- package/src/append-stream.ts +21 -20
- package/src/bot.ts +16 -16
- package/src/budget-status.ts +1 -1
- package/src/config.ts +2 -5
- package/src/download.ts +3 -3
- package/src/files.ts +6 -6
- package/src/format.ts +6 -1
- package/src/images.ts +6 -6
- package/src/inbound.ts +7 -7
- package/src/outbound.ts +22 -22
- package/src/qrcode-terminal.d.ts +1 -1
- package/src/reply-budget.ts +15 -15
- package/src/run-feedback.ts +70 -75
- package/src/usage.ts +0 -93
package/README.md
CHANGED
|
@@ -49,9 +49,9 @@ Run these in the pi terminal:
|
|
|
49
49
|
| `/qq-login` | Log in with a QR code and bind the scanning QQ user |
|
|
50
50
|
| `/qq-status` | Show login, connection, model, context, and bound user |
|
|
51
51
|
| `/qq-logout` | Log out and clear in-memory credentials |
|
|
52
|
-
| `/qq-budget` | Show passive-reply budget and stream-bubble diagnostics |
|
|
53
|
-
| `/qq-md [text]` | Send a Markdown test message |
|
|
54
|
-
| `/qq-stream
|
|
52
|
+
| `/qq-test-budget` | Show passive-reply budget and stream-bubble diagnostics |
|
|
53
|
+
| `/qq-test-md [text]` | Send a Markdown test message |
|
|
54
|
+
| `/qq-test-stream` | Run a streamed timeline diagnostic |
|
|
55
55
|
| `/qq-new` | Reset the current session (used by QQ `/new`) |
|
|
56
56
|
|
|
57
57
|
QQ-side commands:
|
|
@@ -61,7 +61,7 @@ QQ-side commands:
|
|
|
61
61
|
| `/new` | Start a new pi session |
|
|
62
62
|
| `/stop` | Abort the current run |
|
|
63
63
|
| `/compact` | Compact the current context |
|
|
64
|
-
| `/status` | Show session and
|
|
64
|
+
| `/status` | Show session and context status |
|
|
65
65
|
| `/help` | Show command help |
|
|
66
66
|
|
|
67
67
|
## Settings
|
|
@@ -80,7 +80,6 @@ Create `~/.pi/agent/pi-qq.json` to override defaults. This file contains setting
|
|
|
80
80
|
| --- | --- | --- |
|
|
81
81
|
| `streamAssistant` | `true` | Stream assistant replies |
|
|
82
82
|
| `markdownSupport` | `false` | Bot has QQ Markdown permission; pass Markdown through |
|
|
83
|
-
| `usageRelay` | `true` | Send the per-run usage summary |
|
|
84
83
|
| `deliverAs` | `"steer"` | Queue new messages while busy: `steer` or `followUp` |
|
|
85
84
|
| `imageMaxSize` | `10485760` | QQ image download limit in bytes (10MB) |
|
|
86
85
|
| `fileMaxSize` | `52428800` | QQ file download limit in bytes (50MB) |
|
|
@@ -95,7 +94,7 @@ Create `~/.pi/agent/pi-qq.json` to override defaults. This file contains setting
|
|
|
95
94
|
- Only C2C (QQ private chat) is supported.
|
|
96
95
|
- Incoming images are passed to the model as vision input; the current model must support image input.
|
|
97
96
|
- Saved files are workspace-local under `.pi/`; add `.pi/` to your own project `.gitignore` if needed.
|
|
98
|
-
- QQ limits passive replies per inbound message. Use `/qq-budget` to inspect the local budget.
|
|
97
|
+
- QQ limits passive replies per inbound message. Use `/qq-test-budget` to inspect the local budget.
|
|
99
98
|
|
|
100
99
|
## License
|
|
101
100
|
|
|
@@ -1,7 +1,7 @@
|
|
|
1
|
-
# pi-qq — features.md
|
|
1
|
+
# pi-qq — features-v1.md
|
|
2
2
|
|
|
3
3
|
> pi 扩展:通过 QQ 机器人把 pi 接入 QQ 单人私聊(C2C)。
|
|
4
|
-
> 手机 QQ
|
|
4
|
+
> 手机 QQ 上发消息(含图片/文件)→ pi 在机器上干活 → 完整回复(Markdown → 纯文本)回传到 QQ;上下文占比可通过 `/status` 查看。
|
|
5
5
|
|
|
6
6
|
技术栈:
|
|
7
7
|
|
|
@@ -53,7 +53,7 @@ pi-qq 扩展 ── pi.sendUserMessage(text+images) ─┴─ pi 事件:
|
|
|
53
53
|
|
|
54
54
|
**通用**
|
|
55
55
|
|
|
56
|
-
- `/qq-status`、`/qq-login`、`/qq-logout`、`/qq-budget`、`/qq-md`、`/qq-stream
|
|
56
|
+
- `/qq-status`、`/qq-login`、`/qq-logout`、`/qq-test-budget`、`/qq-test-md`、`/qq-test-stream`、`/qq-new` 的命令说明与 pi 终端输出均为英文。
|
|
57
57
|
- `/qq-status` 显示登录状态(in memory)、连接状态、模型、上下文与绑定用户;AppID 仅显示前 4 位 + `****`。
|
|
58
58
|
- 配置文件 `~/.pi/agent/pi-qq.json` 只保存非敏感设置;旧的 `AppID` / `AppSecret` / `allowedOpenid` 键会被忽略,不再用于登录。
|
|
59
59
|
- 白名单只接受扫码绑定的 openid;未登录时入站消息直接忽略。
|
|
@@ -102,6 +102,7 @@ pi-qq 扩展 ── pi.sendUserMessage(text+images) ─┴─ pi 事件:
|
|
|
102
102
|
帮我总结这个文件
|
|
103
103
|
```
|
|
104
104
|
- 纯文件消息(无文字)也会触发 run,提示词只含文件块;文件内容不直接注入 LLM,由 pi 用工具按需读取。
|
|
105
|
+
- **实测**:2026-10-29 用户已验证 QQ 发送文件后保存到工作空间 `.pi/pi-qq/`,提示词中的路径可正常关联。
|
|
105
106
|
|
|
106
107
|
### F4 回传 assistant 消息
|
|
107
108
|
|
|
@@ -122,37 +123,14 @@ pi-qq 扩展 ── pi.sendUserMessage(text+images) ─┴─ pi 事件:
|
|
|
122
123
|
- **非流式/降级**:`sendText` 一次性发送。
|
|
123
124
|
- `stopReason === "error"` 时回传错误摘要而非静默。
|
|
124
125
|
|
|
125
|
-
### F5
|
|
126
|
+
### F5/F6 用量摘要(已移除)
|
|
126
127
|
|
|
127
|
-
|
|
128
|
+
每轮 QQ 对话后的 token 用量摘要已取消:
|
|
128
129
|
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
-
|
|
132
|
-
|
|
133
|
-
```
|
|
134
|
-
📊 用量摘要
|
|
135
|
-
• 输入:4.1k (99.9%)
|
|
136
|
-
• 输出:2.3k
|
|
137
|
-
• 上下文:0.4%
|
|
138
|
-
```
|
|
139
|
-
|
|
140
|
-
- **输入** = 本次 run 累计总输入(`input + cacheRead + cacheWrite`)。
|
|
141
|
-
- **括号百分比** = 本次 run 累计缓存命中率(`cacheRead / 总输入`),保留一位小数;无缓存时显示 `0.0%`。
|
|
142
|
-
- **输出** = 本次 run 累计输出。
|
|
143
|
-
- 不展示成本、本轮、上下文绝对值;严格保持三行。
|
|
144
|
-
- 与 F6 合并为一条消息发送,避免刷屏。
|
|
145
|
-
|
|
146
|
-
### F6 回传上下文窗口占比
|
|
147
|
-
|
|
148
|
-
**数据源**:`ctx.getContextUsage()` → `{ tokens, contextWindow, percent }`。
|
|
149
|
-
|
|
150
|
-
**行为**
|
|
151
|
-
|
|
152
|
-
- 与 F5 同条消息的第三行:`• 上下文:0.4%`。
|
|
153
|
-
- `tokens === null`(压缩后尚未产生新响应)时显示 `重建中`。
|
|
154
|
-
- `percent` 缺失时按 `tokens / contextWindow` 计算。
|
|
155
|
-
- 严格三行格式,不追加 `/compact` 文字提示(百分比已可见)。
|
|
130
|
+
- 不再在 `agent_end` 发送 `📊 用量摘要`。
|
|
131
|
+
- 上下文占比通过 QQ 侧 `/status` 或 pi 终端 `/qq-status` 查看。
|
|
132
|
+
- 不展示 token、缓存命中率、成本;减少一条被动回复消息。
|
|
133
|
+
- `usageRelay` 配置项已移除(旧配置键会被忽略)。
|
|
156
134
|
|
|
157
135
|
### F7 长任务反馈(10~60 分钟级任务)
|
|
158
136
|
|
|
@@ -161,26 +139,26 @@ pi-qq 扩展 ── pi.sendUserMessage(text+images) ─┴─ pi 事件:
|
|
|
161
139
|
**行为**:**assistant 文本消息与思考/工具汇总使用独立气泡**——每条文本消息独占一个纯文本气泡(同一消息的流式增量续写),思考/工具行组进入活动气泡;文本前后的工具执行均另起活动气泡;最终回复独立成文本气泡。`streamRelay` 默认开,实测可用;气泡内按 `streamFlushMs`(默认 10000ms,最小 300)固定频率发送窗口汇总帧(工具调用每 10s 汇总一次):
|
|
162
140
|
|
|
163
141
|
```
|
|
164
|
-
[活动气泡] 💭
|
|
165
|
-
[活动气泡] [3]
|
|
166
|
-
[活动气泡] [2]
|
|
142
|
+
[活动气泡] [💭] Thinking...
|
|
143
|
+
[活动气泡] [🔧] [3] bash
|
|
144
|
+
[活动气泡] [🔧] [2] read
|
|
167
145
|
|
|
168
146
|
[文本气泡] 中间消息原文
|
|
169
147
|
|
|
170
|
-
[活动气泡] [1]
|
|
148
|
+
[活动气泡] [🔧] [1] edit
|
|
171
149
|
|
|
172
150
|
[文本气泡] 最终回复原文(流式增量)
|
|
173
151
|
```
|
|
174
152
|
|
|
175
|
-
- **汇总帧内容**(窗口增量,间隔 `streamFlushMs` 默认 10000ms;`agent_end` 补发剩余并收 DONE
|
|
153
|
+
- **汇总帧内容**(窗口增量,间隔 `streamFlushMs` 默认 10000ms;`agent_end` 补发剩余并收 DONE)。活动气泡帧:**debug 模式下行首带 `[HH:MM:SS]` 时间戳**,普通模式不带时间戳。行组**严格按事件实际发生顺序**输出:思考状态行 `[💭] Thinking...` 与工具计数行 `[🔧] [n] name` 按到达顺序交错;连续同名工具合并为一条计数,不改变相对顺序。文本气泡帧:原始 Markdown 增量(流式帧按 markdown 渲染),debug 模式才加时间戳以免插断回答。工具总在 message_end 后执行,故文本消息与其后工具天然分入不同气泡。
|
|
176
154
|
- **排版规则**:活动气泡内行与行相邻不空行;文本气泡内续写直接拼接;文本与工具不再混排。
|
|
177
155
|
- **气泡边界**:文本消息的**首个增量**到达 → 封口当前活动气泡,开文本气泡;思考/工具行组到达 → 封口当前文本气泡,开或续活动气泡;同一消息的后续流式增量不切泡;最终回复独立成文本气泡。
|
|
178
156
|
- **事件映射**:`tool_execution_start` → 窗口计数;`message_update`(thinking/text)→ 窗口状态/快照;`message_end` → 文本定稿;`agent_end` → 补帧 + DONE。AppendStream 内部仍有 500ms 节流与限流退避作安全网。
|
|
179
157
|
- **额度提示**:每条文本消息、每段活动各占一条 msg_seq 消息;长回合任务的气泡数多于单气泡模式,需关注被动额度;若平台拒绝(帧失败),该回合自动降级消息路径,文本仍完整送达。
|
|
180
158
|
- **降级**:任何一帧失败即标 dead,已追加部分作废,未发出的结果文本自动转消息路径补发;`streamRelay: false` 时整条时间线关闭,assistant 消息走普通消息路径(M2 行为)。
|
|
181
159
|
- **typing 保鲜**:run 开始立即发送"正在输入",之后每 50s 续期(0 额度),`agent_end` 清理。
|
|
182
|
-
- **空窗口活性线**:窗口无增量且静默 ≥60s 时补一条
|
|
183
|
-
- **心跳兜底**:流不可用时降级为普通消息心跳(每 run ≤3
|
|
160
|
+
- **空窗口活性线**:窗口无增量且静默 ≥60s 时补一条 `⏱ 已运行 X 分钟…`——长思考/单工具长执行期间每分钟一行,不再无推送(debug 模式带时间戳)。
|
|
161
|
+
- **心跳兜底**:流不可用时降级为普通消息心跳(每 run ≤3 条保险丝;debug 模式带时间戳)。
|
|
184
162
|
- 不发送"已收到"开始确认(节省被动额度):QQ 触发的 run 在首个汇总帧前保持安静。
|
|
185
163
|
- 非 QQ 触发的 run(本地终端)不发心跳/时间线,但 assistant 消息仍照常回传(现状)。
|
|
186
164
|
|
|
@@ -190,13 +168,13 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
190
168
|
|
|
191
169
|
| 限制 | 数值 | 应对 |
|
|
192
170
|
| --- | --- | --- |
|
|
193
|
-
| 被动回复额度 | 每条入站消息 5 分钟内有效,约 4 条/小时 | 扩展内维护回复预算(复用 SDK `ReplyLimiter` 思路);assistant
|
|
171
|
+
| 被动回复额度 | 每条入站消息 5 分钟内有效,约 4 条/小时 | 扩展内维护回复预算(复用 SDK `ReplyLimiter` 思路);assistant 时间线按文本/活动分泡 |
|
|
194
172
|
| 主动消息 | 无 `msgId` 发送受平台额度限制 | 被动额度耗尽时才降级为主动发送,且给出明确提示 |
|
|
195
173
|
| 流式消息 | 仅 C2C;节流 ≥300ms;基于 5 分钟内 `msgId` | 流式仅用于 assistant 文本;无关联 `msgId` 时自动降级 `sendText` |
|
|
196
174
|
| 文本长度 | 单条 ~5000 字符 | SDK 分块;超出部分按序发送 |
|
|
197
175
|
| markdown | 默认无权限(`markdownSupport: false`) | Markdown → 纯文本降级渲染 |
|
|
198
176
|
|
|
199
|
-
**合并规则**(默认):assistant 文本消息与活动时间线严格分泡(每条文本消息 1
|
|
177
|
+
**合并规则**(默认):assistant 文本消息与活动时间线严格分泡(每条文本消息 1 条纯文本气泡,工具间隔另起活动气泡);不再发送用量摘要,上下文占比通过 `/status` 查询。气泡数随回合内文本消息数增长,需关注 `msgId` 的被动额度;若平台拒绝(帧失败),自动降级消息路径。工具调用过程本身不逐条回传。
|
|
200
178
|
|
|
201
179
|
## 4. 配置
|
|
202
180
|
|
|
@@ -206,7 +184,6 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
206
184
|
| --- | --- | --- |
|
|
207
185
|
| `streamAssistant` | `true` | assistant 流式回传开关 |
|
|
208
186
|
| `markdownSupport` | `false` | 机器人是否有 markdown 权限;`true` 时回传透传 Markdown |
|
|
209
|
-
| `usageRelay` | `true` | 本次 run 的 token/缓存命中率/上下文占比摘要开关 |
|
|
210
187
|
| `deliverAs` | `"steer"` | 忙碌时新消息的处理方式 |
|
|
211
188
|
| `imageMaxSize` | `10MB` | QQ 图片下载上限 |
|
|
212
189
|
| `fileMaxSize` | `50MB` | QQ 文件下载上限 |
|
|
@@ -214,7 +191,7 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
214
191
|
| `heartbeatMaxMessages` | `3` | F7 每 run 消息心跳上限(流式心跳不受限) |
|
|
215
192
|
| `streamRelay` | `true` | F7 流式载体开关(append 追加 + 节流合帧 + 限流退避,实测可用;失败自动降级消息路径) |
|
|
216
193
|
| `streamFlushMs` | `10000`(最小 300) | F7 流式汇总帧间隔(毫秒,默认每 10s 汇总工具调用) |
|
|
217
|
-
| `debug` | `false` | 诊断模式:SDK 日志转终端 +
|
|
194
|
+
| `debug` | `false` | 诊断模式:SDK 日志转终端 + 流式重试/超时日志 + 行组/文本帧时间戳 |
|
|
218
195
|
|
|
219
196
|
## 5. 命令总表
|
|
220
197
|
|
|
@@ -222,11 +199,11 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
222
199
|
| --- | --- | --- |
|
|
223
200
|
| pi 侧 | `/qq-login` | 扫码登录并绑定(QR only) |
|
|
224
201
|
| pi 侧 | `/qq-status` | 登录态、连接状态、绑定用户 |
|
|
225
|
-
| pi 侧 | `/qq-budget` | 诊断:被动额度、流式气泡数、最近 msgId 新鲜度 |
|
|
202
|
+
| pi 侧 | `/qq-test-budget` | 诊断:被动额度、流式气泡数、最近 msgId 新鲜度 |
|
|
226
203
|
| pi 侧 | `/qq-logout` | 清除内存凭据并断开 |
|
|
227
204
|
| pi 侧 | `/qq-new` | 重置当前会话(QQ `/new` 调用) |
|
|
228
|
-
| pi 侧 | `/qq-md [text]` | 诊断:发送 Markdown 消息,验证 C2C markdown 渲染能力 |
|
|
229
|
-
| pi 侧 | `/qq-stream
|
|
205
|
+
| pi 侧 | `/qq-test-md [text]` | 诊断:发送 Markdown 消息,验证 C2C markdown 渲染能力 |
|
|
206
|
+
| pi 侧 | `/qq-test-stream` | 诊断:开流→三帧→complete,验证流式帧是否渲染 |
|
|
230
207
|
| QQ 侧 | `/new` `/stop` `/compact` `/status` `/help` | 会话控制(见 F2) |
|
|
231
208
|
|
|
232
209
|
## 6. 可靠性与安全
|
|
@@ -242,10 +219,10 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
242
219
|
| # | 问题 | 决策 |
|
|
243
220
|
| --- | --- | --- |
|
|
244
221
|
| 1 | TUI 二维码渲染 | 登录协议用 connector;展示用 `qrcode-terminal`(零依赖)在 `ctx.ui` 弹窗画码 |
|
|
245
|
-
| 2 | thinking 内容 | 不回传具体内容(始终剔除,无配置开关);F7 时间线中仅以
|
|
246
|
-
| 3 | tool 消息 |
|
|
222
|
+
| 2 | thinking 内容 | 不回传具体内容(始终剔除,无配置开关);F7 时间线中仅以 `[💭] Thinking...` 标记体现 |
|
|
223
|
+
| 3 | tool 消息 | **完全不回传**;只回传 assistant 消息,上下文占比通过 `/status` 查询 |
|
|
247
224
|
| 4 | 图片方向 | F3 为 QQ → pi(用户发图给 pi);pi 不向 QQ 发图片(LLM 仅输出纯文本) |
|
|
248
|
-
| 5 |
|
|
225
|
+
| 5 | 成本/用量摘要 | 已移除每轮用量摘要;不展示 token、缓存命中率、成本 |
|
|
249
226
|
| 6 | 回复格式 | 回复通常为 Markdown 格式的总结/提问文本(不在回复中写代码);默认轻量转纯文本,有 markdown 权限可透传 |
|
|
250
227
|
| 7 | 登录方式 | 仅 `/qq-login` 扫码;凭据只存进程内存、不落盘;pi 进程退出后必须重新扫码 |
|
|
251
228
|
| 8 | 长任务反馈 | typing 保鲜 + 每 10s 汇总工具调用 + 节流心跳(默认 10 分钟/条,流式载体优先,每 run ≤3 条消息心跳保险丝)+ 机会性流式(平台拒绝即降级);不发送开始确认 |
|
|
@@ -257,5 +234,6 @@ QQ 开放平台的发送限制直接决定回传策略,必须统一管理:
|
|
|
257
234
|
| --- | --- | --- |
|
|
258
235
|
| M1 | F1 扫码登录 + 内存凭据 + 连接启动 | 扫码后 `/qq-status` 在线;重启 pi 需重新扫码 |
|
|
259
236
|
| M2 | F2 单人聊天 + F4 assistant 回传(先非流式) | QQ 发消息得到 pi 回复 |
|
|
260
|
-
| M3 | F5/F6 用量摘要(本次 run 输入/缓存命中率/输出/上下文) | 严格三行摘要正确呈现 |
|
|
261
237
|
| M4 | F3 QQ 图片/文件消息 + markdownSupport + 打磨 | 图片可进入 pi 会话;文件保存并关联到提示词 |
|
|
238
|
+
|
|
239
|
+
> 原 M3 用量摘要已取消(2026-10-29)。
|
|
@@ -1,6 +1,6 @@
|
|
|
1
|
-
# pi-qq — plan.md
|
|
1
|
+
# pi-qq — plan-v1.md
|
|
2
2
|
|
|
3
|
-
> 执行计划。功能范围与决策见 [features.md](./features.md),本文只回答:装什么、建什么文件、按什么顺序做、每步怎么验收。
|
|
3
|
+
> 执行计划。功能范围与决策见 [features-v1.md](./features-v1.md),本文只回答:装什么、建什么文件、按什么顺序做、每步怎么验收。
|
|
4
4
|
|
|
5
5
|
## 0. 前置:依赖安装(需你手动执行)
|
|
6
6
|
|
|
@@ -35,11 +35,10 @@ pi-qq/
|
|
|
35
35
|
├── images.ts # F3:图片类型/大小校验、15s 超时下载、ImageContent 组装
|
|
36
36
|
├── files.ts # F3:文件下载落盘、安全文件名、提示词路径关联
|
|
37
37
|
├── download.ts # 图片/文件共用:超时与流式大小限制下载
|
|
38
|
-
├── format.ts #
|
|
38
|
+
├── format.ts # 人类可读字节/ token 数格式化
|
|
39
39
|
├── outbound.ts # F4:markdown→纯文本转换、流式(openStream)/降级(sendText)、分块
|
|
40
40
|
├── reply-budget.ts # §3:被动回复预算(msgId 5min 窗口、4条/h、降级主动发送)
|
|
41
|
-
|
|
42
|
-
└── usage.ts # F5/F6:本次 run 用量汇总(agent_end messages)、严格三行摘要
|
|
41
|
+
└── budget-status.ts # /qq-test-budget 纯格式化(普通/流式/估算剩余)
|
|
43
42
|
```
|
|
44
43
|
|
|
45
44
|
职责边界:`index.ts` 只做装配与订阅,不含业务逻辑;每个模块可独立测试;模块间只经 `index.ts` 传递的共享状态对象(bot 实例、当前 target/msgId、配置)通信。
|
|
@@ -51,9 +50,8 @@ pi-qq/
|
|
|
51
50
|
| QQ → pi | `bot.on("message")`(kind=c2c) | 白名单 → QQ 命令(`/new` `/stop` `/compact` `/status` `/help`)→ 文本+图片 → `pi.sendUserMessage()` |
|
|
52
51
|
| pi → QQ | `message_update`(assistant) | 流式:`openStream().update(转换后全文)`,节流 ≥300ms |
|
|
53
52
|
| pi → QQ | `message_end`(assistant) | `stream.complete()`;无流上下文时 `sendText`;`stopReason==="error"` 回错误摘要 |
|
|
54
|
-
| pi → QQ | `agent_end` | 用量摘要一条(F5 本次 run token/缓存命中率 + F6 上下文占比) |
|
|
55
53
|
| 状态 | `session_start` / `session_shutdown` | 有内存登录态则启动 bot / 幂等停止 |
|
|
56
|
-
|
|
|
54
|
+
| 收尾 | `agent_end` | 封口最后一个流式气泡(DONE);不再发送用量摘要 |
|
|
57
55
|
|
|
58
56
|
## 3. 里程碑
|
|
59
57
|
|
|
@@ -88,20 +86,20 @@ pi-qq/
|
|
|
88
86
|
|
|
89
87
|
**验收**:QQ 发任务 → 不发送确认 → 10s 内收到首个汇总帧 → typing 持续 → 心跳按期到达(流或消息)→ 结果回传不双发。
|
|
90
88
|
|
|
91
|
-
### M3 —
|
|
89
|
+
### M3 — 用量摘要(已取消)
|
|
92
90
|
|
|
93
|
-
|
|
94
|
-
2. 严格三行格式:`📊 用量摘要` / `• 输入:4.1k (99.9%)` / `• 输出:2.3k` / `• 上下文:0.4%`;输入为总输入(含 cacheRead/cacheWrite),括号为缓存命中率。
|
|
95
|
-
3. 仅 QQ 触发且成功完成的 run 发送;经 reply-budget 发送。
|
|
91
|
+
用量摘要已按用户要求移除:
|
|
96
92
|
|
|
97
|
-
|
|
93
|
+
- 不再在 `agent_end` 汇总或发送 token/缓存/成本/上下文摘要。
|
|
94
|
+
- 上下文占比通过 QQ 侧 `/status` 或 pi 终端 `/qq-status` 查看。
|
|
95
|
+
- `src/usage.ts`、`usageRelay` 配置和对应单测已删除。
|
|
96
|
+
- 收益:每轮少一条 QQ 消息,降低被动额度消耗。
|
|
98
97
|
|
|
99
98
|
### M4 — 图片与打磨(F3 + markdownSupport 透传)
|
|
100
99
|
|
|
101
100
|
1. [x] F3 图片/文件:图片转 `ImageContent`;非图片附件保存到当前工作空间的 `.pi/pi-qq/YYYY-MM-DD/<msgId>/`,提示词中追加绝对路径、大小与原始文件名;`fileMaxSize` 默认 50MB。
|
|
102
101
|
2. [x] `markdownSupport: true`:`QQBot` 构造时已传入该开关,SDK 的 `sendText` 自动使用 msg_type=2;调用方保留原始 Markdown 即可,无需额外 `sendMarkdown`。
|
|
103
102
|
3. [x] QQ 侧 `/new`:inbound 调用隐藏扩展命令 `qq-new`,命令 handler 使用 `ctx.newSession()`;非 idle 时提示先 `/stop`。
|
|
104
|
-
4. [ ] 长代码块转文件附件(backlog);多气泡 + 摘要额度实测已完成。
|
|
105
103
|
|
|
106
104
|
**验收**:QQ 发图后 pi 能描述图片内容;QQ 发文件后保存到本机并在提示词中关联路径;额度全程不超限。
|
|
107
105
|
|
|
@@ -155,8 +153,8 @@ pi-qq/
|
|
|
155
153
|
- [x] `index.ts`:`agent_start`/`agent_end`/`tool_execution_end`/`message_update` 接线;`message_end` 流接管判定
|
|
156
154
|
- [x] 单测:`formatHeartbeat`(test/run.ts 共 33 项断言)
|
|
157
155
|
- [x] 验收:QQ 发任务 → 不发送确认 → 10s 内收到汇总帧 → typing 持续 → 心跳按期 → 结果回传不双发(用户实测通过)
|
|
158
|
-
- 首轮实测(2026-10-28):确认/typing 正常;SDK 内置流式 replace 语义被平台拒绝("已经提交的消息内容不可修改",首帧可渲染、第二帧报错);C2C markdown 渲染正常(`/qq-md` ✓)。
|
|
159
|
-
- 修复:自实现 `src/append-stream.ts`(input_mode="append",追加语义),RunFeedback 改为增量追加,`/qq-stream
|
|
156
|
+
- 首轮实测(2026-10-28):确认/typing 正常;SDK 内置流式 replace 语义被平台拒绝("已经提交的消息内容不可修改",首帧可渲染、第二帧报错);C2C markdown 渲染正常(`/qq-test-md` ✓)。
|
|
157
|
+
- 修复:自实现 `src/append-stream.ts`(input_mode="append",追加语义),RunFeedback 改为增量追加,`/qq-test-stream` 改测 append 模式。
|
|
160
158
|
- 复验(2026-10-28):append 两帧 + DONE 全部渲染 ✓,流式链路打通。后续任务:心跳/结果追加需开启 `streamRelay: true`。
|
|
161
159
|
- 时间线升级(用户构想):流式气泡改为**回合活动时间线**——💭 思考中…(惰性标记,不回传内容)/ 🔧 工具名(tool_execution_start)/ 智能体消息原文(流式增量)依次追加,心跳与 DONE 照旧;帧失败自动降级消息路径并补发未发结果。
|
|
162
160
|
- 汇总帧重构(用户构想):逐事件追加改为**固定 3s 窗口汇总帧**——思考状态行 + 工具计数行(`[n] 🔧 name`)+ 消息文本增量,按设计稿分组排版;流式帧按 markdown 渲染(实测),故流内传原始文本。用户实测反馈:长思考/长工具期间静默——已加行组帧时间戳 + 空窗口 60s 活性行 + flush 队列串行化(防限流重试与定时器交错)。追加 debug 开关(SDK 日志转终端 + 文本帧时间戳)用于定位用户报告的「超时」现象。
|
|
@@ -166,16 +164,14 @@ pi-qq/
|
|
|
166
164
|
- 四轮实测(2026-10-29,`log/pi.jsonl` + `log/qq.png`):首条中间文本(工具活动之后的 assistant 消息)被并入活动气泡,未独立成泡。根因:切泡条件要求旧气泡已含文本,而首条文本之前只有思考/工具行组。修复:文本消息首个增量到达时,只要当前气泡已有内容就封口(含仅行组);工具计数行格式改为 `[n] 🔧 name`(心跳同步),新增活动气泡→文本气泡回归断言。
|
|
167
165
|
- 五轮调整(2026-10-29,用户要求):删除 t=0 的"✅ 已收到"开始确认(含忙碌合并提示),节省被动额度;汇总帧默认间隔 3000ms → 10000ms,工具调用每 10s 汇总一次(`streamFlushMs` 仍可配置)。
|
|
168
166
|
- 六轮调整(2026-10-29,用户 QQ 截图):中间文本消息与工具汇总混在同一气泡(如“已写入…”后紧跟 read 行)。改为**文本/活动严格分泡**:每条 assistant 文本独占纯文本气泡,思考/工具行组进活动气泡,文本前后的工具均另起活动气泡;新增“活动→文本→活动→文本→活动→最终文本”六气泡交错回归断言。
|
|
169
|
-
- 七轮自检(2026-10-29,`log/pi.png` + `log/qq.png
|
|
167
|
+
- 七轮自检(2026-10-29,`log/pi.png` + `log/qq.png`):当时的用量摘要与 pi Session Info 一致(该摘要后来已移除)。发现无文本 assistant 消息不走 `onAssistantFinal`,逐消息思考标记未重置,导致下一条消息的 thinking 行被吞(截图中 read 前缺 thinking)。修复:`message_end` 对无文本 assistant 也调用 `onAssistantFinal("")`,冲刷行组并重置逐消息状态;新增“无文本消息不吞后续行组”回归断言。
|
|
170
168
|
- 八轮调整(2026-10-29,重跑截图):read 与下一条消息的 thinking 落入同一 10s 窗口时,旧逻辑固定“thinking 优先”,显示顺序与真实事件相反(应 read → thinking → bash)。修复:窗口行组改为 `winLines` 事件序列,按事件到达顺序输出;连续同名工具合并计数;新增严格顺序回归断言。
|
|
171
169
|
|
|
172
|
-
### M3 —
|
|
170
|
+
### M3 — 用量摘要(已取消)
|
|
173
171
|
|
|
174
|
-
- [x] `
|
|
175
|
-
- [x]
|
|
176
|
-
-
|
|
177
|
-
- [ ] 验收(待 QQ 实测):摘要数字与本次 run 实际用量一致
|
|
178
|
-
- 2026-10-29:单测覆盖严格三行/命中率/无缓存/重建中/上下文计算/本次 run 汇总/无文本消息行组/图片类型与大小校验/QQ /new 分发/预算快照/流式气泡计数/文件保存与提示词(vitest:8 个测试文件 / 81 个测试通过)。
|
|
172
|
+
- [x] 按用户要求移除每轮用量摘要;上下文占比改用 `/status` / `/qq-status`
|
|
173
|
+
- [x] 删除 `src/usage.ts`、`usageRelay` 配置及对应测试
|
|
174
|
+
- 当前全量:8 个测试文件 / 77 个测试通过。
|
|
179
175
|
|
|
180
176
|
### M4 — 图片与打磨
|
|
181
177
|
|
|
@@ -184,12 +180,11 @@ pi-qq/
|
|
|
184
180
|
- [x] `/compact` 命令、typing 指示(C2C)
|
|
185
181
|
- [x] `markdownSupport: true`:SDK `sendText` 自动 msg_type=2(无需新增 sendMarkdown 路径)
|
|
186
182
|
- [x] QQ 侧 `/new` 支持(`qq-new` 扩展命令 → `ctx.newSession()`)
|
|
187
|
-
- [x] `/qq-budget` 诊断命令(普通被动剩余 / 流式气泡数 / 估算剩余 / 最近 msgId 新鲜度)
|
|
188
|
-
- [x] 单元测试迁移到 vitest(`test/*.test.ts`,8 个文件 /
|
|
189
|
-
- [
|
|
190
|
-
- [x] 多气泡 + 摘要下的被动额度实测(2026-10-29:`/qq-budget` 实测符合预期:4 个流式气泡 + 1 条摘要,普通剩余 3 / 估算剩余 0 / 窗口有效)
|
|
183
|
+
- [x] `/qq-test-budget` 诊断命令(普通被动剩余 / 流式气泡数 / 估算剩余 / 最近 msgId 新鲜度)
|
|
184
|
+
- [x] 单元测试迁移到 vitest(`test/*.test.ts`,8 个文件 / 77 个测试;`npm test`)
|
|
185
|
+
- [x] 多气泡流式额度实测(2026-10-29:当时包含 1 条摘要;摘要后来已移除,仅作历史记录)
|
|
191
186
|
- [x] `debug` 抓超时日志:AppendStream 限流重试/最终失败 + run start/end 日志
|
|
192
187
|
- [x] 验收:QQ 发图后 pi 能描述图片内容;全程额度不超限(2026-10-29 实测通过)
|
|
193
|
-
- [
|
|
188
|
+
- [x] 文件传输实机验收(2026-10-29 用户实测通过:QQ 发 zip/pdf 等文件,保存到工作空间 `.pi/pi-qq/` 并在提示词中关联路径)
|
|
194
189
|
- 2026-10-29:图片+文字、纯图片(均被模型正确识别)、非图片附件拒绝(zip 提示“附件处理失败”)、多气泡+摘要额度诊断已实测通过。
|
|
195
190
|
- 无视觉模型场景按用户决定不验证(代码仍保留 `ctx.model.input` 检查)。
|
package/index.ts
CHANGED
|
@@ -7,7 +7,7 @@ import { markdownToPlain, sendReply } from "./src/outbound";
|
|
|
7
7
|
import { ReplyBudget } from "./src/reply-budget";
|
|
8
8
|
import { RunFeedback } from "./src/run-feedback";
|
|
9
9
|
import { AppendStream } from "./src/append-stream";
|
|
10
|
-
import { formatTokenCount
|
|
10
|
+
import { formatTokenCount } from "./src/format";
|
|
11
11
|
import { formatBudgetStatus } from "./src/budget-status";
|
|
12
12
|
|
|
13
13
|
/**
|
|
@@ -62,7 +62,7 @@ const fmtTokens = (n: number | null): string => (n === null ? "unknown" : format
|
|
|
62
62
|
export default function (pi: ExtensionAPI) {
|
|
63
63
|
const maskAppId = (appId: string) => `${appId.slice(0, 4)}****`;
|
|
64
64
|
|
|
65
|
-
//
|
|
65
|
+
// Live settings reader (binding/settings changes apply immediately).
|
|
66
66
|
|
|
67
67
|
const getAllowedOpenid = () => getLoginState()?.allowedOpenid;
|
|
68
68
|
const getBoundOpenid = getAllowedOpenid;
|
|
@@ -70,32 +70,6 @@ export default function (pi: ExtensionAPI) {
|
|
|
70
70
|
|
|
71
71
|
const onWarn = (ctx: ExtensionContext) => (msg: string) => ctx.ui.notify(`pi-qq ${msg}`, "warning");
|
|
72
72
|
|
|
73
|
-
/** F5/F6:在 agent_end 时快照本次 run 用量,返回发送函数(等时间线封口后再调用) */
|
|
74
|
-
const prepareUsageSummary = (ctx: ExtensionContext, usage: UsageTotals): (() => void) | null => {
|
|
75
|
-
const { config } = readConfig();
|
|
76
|
-
const settings = getSettings(config);
|
|
77
|
-
if (!settings.usageRelay) return null;
|
|
78
|
-
|
|
79
|
-
const bound = getLoginState()?.allowedOpenid;
|
|
80
|
-
const bot = running?.bot;
|
|
81
|
-
const hasUsage = usage.input + usage.output + usage.cacheRead + usage.cacheWrite > 0;
|
|
82
|
-
if (!bound || !bot || !hasUsage) return null;
|
|
83
|
-
|
|
84
|
-
const summary = formatUsageSummary({
|
|
85
|
-
usage,
|
|
86
|
-
context: ctx.getContextUsage(),
|
|
87
|
-
});
|
|
88
|
-
// 快照文本,避免等待时间线封口期间新 run 覆盖本次数据
|
|
89
|
-
return () => {
|
|
90
|
-
if (running?.bot !== bot) return;
|
|
91
|
-
void sendReply(bot, summary, {
|
|
92
|
-
budget,
|
|
93
|
-
boundOpenid: bound,
|
|
94
|
-
onWarn: onWarn(ctx),
|
|
95
|
-
});
|
|
96
|
-
};
|
|
97
|
-
};
|
|
98
|
-
|
|
99
73
|
const getStatusLines = (): string[] => {
|
|
100
74
|
const login = getLoginState();
|
|
101
75
|
const usage = sessionCtx?.getContextUsage();
|
|
@@ -178,28 +152,14 @@ export default function (pi: ExtensionAPI) {
|
|
|
178
152
|
runFeedback.dispose();
|
|
179
153
|
});
|
|
180
154
|
|
|
181
|
-
//
|
|
155
|
+
// F7 run feedback: agent lifecycle / tool counts / text streaming.
|
|
182
156
|
|
|
183
157
|
pi.on("agent_start", () => {
|
|
184
158
|
runFeedback.onAgentStart();
|
|
185
159
|
});
|
|
186
160
|
|
|
187
|
-
pi.on("agent_end", (
|
|
188
|
-
|
|
189
|
-
// 错误/中止的 run 不发摘要:自动重试时避免每轮失败都刷一条消息
|
|
190
|
-
const completed =
|
|
191
|
-
lastAssistant !== undefined && lastAssistant.stopReason !== "error" && lastAssistant.stopReason !== "aborted";
|
|
192
|
-
const wasQQRun = runFeedback.isQQTriggeredRun();
|
|
193
|
-
// 在异步封口时间线前快照本次 run 的用量,避免新 run 覆盖
|
|
194
|
-
const runUsage = sumUsageMessages(event.messages);
|
|
195
|
-
const sendSummary = wasQQRun && completed ? prepareUsageSummary(ctx, runUsage) : null;
|
|
196
|
-
// 先封口时间线气泡,再发用量摘要(保证 QQ 消息顺序)
|
|
197
|
-
void runFeedback
|
|
198
|
-
.onAgentEnd()
|
|
199
|
-
.then(() => {
|
|
200
|
-
sendSummary?.();
|
|
201
|
-
})
|
|
202
|
-
.catch(() => {});
|
|
161
|
+
pi.on("agent_end", () => {
|
|
162
|
+
void runFeedback.onAgentEnd();
|
|
203
163
|
});
|
|
204
164
|
|
|
205
165
|
pi.on("tool_execution_start", (event) => {
|
|
@@ -224,7 +184,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
224
184
|
void runFeedback.onAssistantDelta(snapshot, thinking);
|
|
225
185
|
});
|
|
226
186
|
|
|
227
|
-
//
|
|
187
|
+
// pi → QQ: assistant message relay (non-streaming path + F7 stream takeover).
|
|
228
188
|
|
|
229
189
|
pi.on("message_end", async (event, ctx) => {
|
|
230
190
|
const msg = event.message;
|
|
@@ -245,13 +205,13 @@ export default function (pi: ExtensionAPI) {
|
|
|
245
205
|
.trim();
|
|
246
206
|
}
|
|
247
207
|
if (!text) {
|
|
248
|
-
//
|
|
249
|
-
//
|
|
208
|
+
// Textless assistant messages also end the feedback turn: reset thinking state
|
|
209
|
+
// and flush pending thinking rows so the next message does not swallow them.
|
|
250
210
|
await runFeedback.onAssistantFinal("", isError);
|
|
251
211
|
return;
|
|
252
212
|
}
|
|
253
213
|
|
|
254
|
-
// F7
|
|
214
|
+
// F7 stream takeover: stream frames render Markdown; send raw text so lengths match.
|
|
255
215
|
if (await runFeedback.onAssistantFinal(text, isError)) return;
|
|
256
216
|
|
|
257
217
|
const payload = settings.markdownSupport ? text : markdownToPlain(text);
|
|
@@ -299,7 +259,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
299
259
|
},
|
|
300
260
|
});
|
|
301
261
|
|
|
302
|
-
pi.registerCommand("qq-budget", {
|
|
262
|
+
pi.registerCommand("qq-test-budget", {
|
|
303
263
|
description: "pi-qq: show passive reply budget, stream bubbles, and last inbound target",
|
|
304
264
|
handler: async (_args, ctx) => {
|
|
305
265
|
ctx.ui.notify(formatBudgetStatus(budget.snapshot(), budget.lastTarget).join("\n"), "info");
|
|
@@ -336,7 +296,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
336
296
|
return bound ? { scope: "c2c" as const, targetId: bound } : undefined;
|
|
337
297
|
};
|
|
338
298
|
|
|
339
|
-
pi.registerCommand("qq-md", {
|
|
299
|
+
pi.registerCommand("qq-test-md", {
|
|
340
300
|
description: "pi-qq: send a Markdown message to verify QQ C2C Markdown rendering",
|
|
341
301
|
handler: async (args, ctx) => {
|
|
342
302
|
if (!running) {
|
|
@@ -358,7 +318,7 @@ export default function (pi: ExtensionAPI) {
|
|
|
358
318
|
},
|
|
359
319
|
});
|
|
360
320
|
|
|
361
|
-
pi.registerCommand("qq-stream
|
|
321
|
+
pi.registerCommand("qq-test-stream", {
|
|
362
322
|
description: "pi-qq: run a streamed timeline diagnostic (thinking/tools/text)",
|
|
363
323
|
handler: async (_args, ctx) => {
|
|
364
324
|
if (!running) {
|
|
@@ -373,11 +333,11 @@ export default function (pi: ExtensionAPI) {
|
|
|
373
333
|
const sleep = (ms: number) => new Promise((r) => setTimeout(r, ms));
|
|
374
334
|
try {
|
|
375
335
|
const stream = new AppendStream(running.bot.messageApi, running.bot.getCredentials(), last.openid, last.msgId);
|
|
376
|
-
await stream.append("Thinking...\n[3]
|
|
336
|
+
await stream.append("[💭] Thinking...\n[🔧] [3] bash\n[🔧] [2] read\n");
|
|
377
337
|
await sleep(1200);
|
|
378
338
|
await stream.append("\n**Intermediate message**: first-turn reply.\n");
|
|
379
339
|
await sleep(1200);
|
|
380
|
-
await stream.append("[1]
|
|
340
|
+
await stream.append("[🔧] [1] edit\n");
|
|
381
341
|
await sleep(800);
|
|
382
342
|
await stream.append("\n**Final reply** (streamed append)");
|
|
383
343
|
let doneNote = "DONE succeeded";
|
package/package.json
CHANGED
package/src/append-stream.ts
CHANGED
|
@@ -7,16 +7,17 @@ import type {
|
|
|
7
7
|
} from "@tencent-connect/qqbot-nodejs/protocol";
|
|
8
8
|
|
|
9
9
|
/**
|
|
10
|
-
*
|
|
10
|
+
* Minimal append-mode (input_mode="append") stream sender.
|
|
11
11
|
*
|
|
12
|
-
* SDK
|
|
13
|
-
*
|
|
14
|
-
*
|
|
12
|
+
* The SDK StreamSession hardcodes input_mode="replace"; in 2026-10 the platform
|
|
13
|
+
* rejected it with "submitted message content cannot be modified". In append mode
|
|
14
|
+
* each content_raw frame carries only the **new** text, matching the platform rule
|
|
15
|
+
* that already-submitted content is immutable.
|
|
15
16
|
*
|
|
16
|
-
*
|
|
17
|
-
* 1.
|
|
18
|
-
*
|
|
19
|
-
* 2.
|
|
17
|
+
* Two built-in safeguards (aligned with SDK StreamSession best practices):
|
|
18
|
+
* 1. Throttle: token increments are buffered and merged into frames per throttle
|
|
19
|
+
* window (default 500ms, minimum 300ms) to avoid flooding the API.
|
|
20
|
+
* 2. Rate-limit backoff: 429 / err_code 50002 retry exponentially (1s→2s→4s, max 3).
|
|
20
21
|
*/
|
|
21
22
|
|
|
22
23
|
const MIN_INTERVAL_MS = 300;
|
|
@@ -24,13 +25,13 @@ const RATE_LIMIT_BASE_MS = 1000;
|
|
|
24
25
|
const MAX_RETRIES = 3;
|
|
25
26
|
|
|
26
27
|
export interface AppendStreamOptions {
|
|
27
|
-
/**
|
|
28
|
+
/** Minimum interval between frames; increments are merged during the window. */
|
|
28
29
|
throttleMs?: number;
|
|
29
|
-
/**
|
|
30
|
+
/** Rate-limit backoff base in ms (for tests). */
|
|
30
31
|
retryBaseMs?: number;
|
|
31
|
-
/**
|
|
32
|
+
/** Background throttle flush failure (stream is no longer trusted). */
|
|
32
33
|
onError?: (err: Error) => void;
|
|
33
|
-
/**
|
|
34
|
+
/** Diagnostic log (debug mode): rate-limit retries/final failures. */
|
|
34
35
|
onDebug?: (message: string) => void;
|
|
35
36
|
}
|
|
36
37
|
|
|
@@ -56,12 +57,12 @@ export class AppendStream {
|
|
|
56
57
|
return Math.max(this.opts.throttleMs ?? 500, MIN_INTERVAL_MS);
|
|
57
58
|
}
|
|
58
59
|
|
|
59
|
-
/**
|
|
60
|
+
/** Append text; frames are merged by throttle window and sent in the background. */
|
|
60
61
|
async append(delta: string): Promise<void> {
|
|
61
62
|
if (this.doneSent || !delta) return;
|
|
62
63
|
this.buffer += delta;
|
|
63
64
|
const elapsed = Date.now() - this.lastFlushAt;
|
|
64
|
-
if (this.flushing) return; //
|
|
65
|
+
if (this.flushing) return; // The in-flight flush trailing logic will pick up the buffer.
|
|
65
66
|
if (elapsed >= this.throttleMs()) {
|
|
66
67
|
await this.doFlush("generating");
|
|
67
68
|
return;
|
|
@@ -74,7 +75,7 @@ export class AppendStream {
|
|
|
74
75
|
}
|
|
75
76
|
}
|
|
76
77
|
|
|
77
|
-
/**
|
|
78
|
+
/** Flush remaining text and send DONE. Errors propagate to the caller. */
|
|
78
79
|
async done(): Promise<void> {
|
|
79
80
|
if (this.doneSent) return;
|
|
80
81
|
if (this.flushTimer) {
|
|
@@ -85,11 +86,11 @@ export class AppendStream {
|
|
|
85
86
|
await new Promise((r) => setTimeout(r, 20));
|
|
86
87
|
}
|
|
87
88
|
if (this.buffer) await this.doFlush("generating");
|
|
88
|
-
await this.doFlush("done"); // DONE
|
|
89
|
+
await this.doFlush("done"); // DONE frames carry empty content_raw (verified).
|
|
89
90
|
this.doneSent = true;
|
|
90
91
|
}
|
|
91
92
|
|
|
92
|
-
/**
|
|
93
|
+
/** Stop background timers only; no DONE (for shutdown/error paths). */
|
|
93
94
|
dispose(): void {
|
|
94
95
|
if (this.flushTimer) {
|
|
95
96
|
clearTimeout(this.flushTimer);
|
|
@@ -101,13 +102,13 @@ export class AppendStream {
|
|
|
101
102
|
private async doFlush(state: "generating" | "done"): Promise<void> {
|
|
102
103
|
if (this.flushing) return;
|
|
103
104
|
const content = state === "done" ? "" : this.buffer;
|
|
104
|
-
// DONE
|
|
105
|
+
// DONE frames may be empty (generation finished); empty generating frames are skipped.
|
|
105
106
|
if (!content && state === "generating") return;
|
|
106
107
|
this.flushing = true;
|
|
107
108
|
let failed = false;
|
|
108
109
|
try {
|
|
109
110
|
if (this.msgSeq === null) this.msgSeq = getNextMsgSeq(this.msgId);
|
|
110
|
-
// input_mode
|
|
111
|
+
// input_mode is outside the SDK type (replace only); the platform defines its runtime meaning.
|
|
111
112
|
const req = {
|
|
112
113
|
input_mode: "append",
|
|
113
114
|
input_state: state === "done" ? StreamInputState.DONE : StreamInputState.GENERATING,
|
|
@@ -128,7 +129,7 @@ export class AppendStream {
|
|
|
128
129
|
throw err;
|
|
129
130
|
} finally {
|
|
130
131
|
this.flushing = false;
|
|
131
|
-
//
|
|
132
|
+
// Trailing: new data arrived during flush; schedule the next frame.
|
|
132
133
|
if (!failed && state === "generating" && this.buffer && !this.doneSent && !this.flushTimer) {
|
|
133
134
|
this.flushTimer = setTimeout(() => {
|
|
134
135
|
this.flushTimer = null;
|