@chen_hu_hu/pi-qq 1.5.1 → 1.6.1

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/CHANGELOG.md CHANGED
@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [1.6.1] - 2026-11-11
11
+
12
+ ### Changed
13
+
14
+ - Settings are loaded when the extension starts and re-read on every inbound QQ message from the bound user, so edits to `pi-qq.json` take effect on the next message without restarting pi or logging in again. Config errors are reported once per distinct text.
15
+
16
+ ### Removed
17
+
18
+ - Removed the `thinkingRelay` setting. `replyType: "full"` now always relays thinking, while `simple` and `last` never do. Existing `thinkingRelay` keys are ignored.
19
+
20
+ ## [1.6.0] - 2026-11-09
21
+
22
+ ### Added
23
+
24
+ - Added the `replyType` setting to control how much of an agent run is pushed to QQ: `full` (thinking, tool calls, and tool results), `simple` (assistant messages only, one bubble each), or `last` (only the last assistant message, delivered when the run ends). The default is `full`, so the default behaviour is unchanged; set `"replyType": "simple"` or `"last"` to push less to QQ.
25
+ - Added the effective reply type to `/qq-status`.
26
+
27
+ ### Changed
28
+
29
+ - In `last` mode, `/last` during a running task now replies that the task is still running instead of repushing partial output.
30
+ - Consolidated the v6 design and delivery record into `doc/archive/delivery.1.6.0.md`; removed the working document.
31
+
32
+ ### Fixed
33
+
34
+ - The `last` reply mode now records its delivery result (`last delivered`) in the debug log before the run state is cleared, so the record is no longer dropped by the QQ-run log gate.
35
+ - Bubbles that pass 12k characters are now split at the next line break found in the incoming text chunk. Previously the split only happened when a chunk happened to end with a newline, which almost never occurred, so long messages were split by the platform instead and thinking blocks lost their repeated heading.
36
+
10
37
  ## [1.5.1] - 2026-11-05
11
38
 
12
39
  ### Changed
@@ -22,7 +49,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
22
49
 
23
50
  ### Changed
24
51
 
25
- - Consolidated the v5 research, feature, and implementation plan into `doc/archive/delivery-v5.md`; removed the three working documents.
52
+ - Consolidated the v5 research, feature, and implementation plan into `doc/archive/delivery.1.5.0.md`; removed the three working documents.
26
53
 
27
54
  ### Fixed
28
55
 
@@ -54,7 +81,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
54
81
  ### Changed
55
82
 
56
83
  - Tool bubbles now use `## <icon> <name>`, show `bash` commands in a `bash` code block without truncation, and choose result code-block languages from `read` file extensions (for example `markdown`, `python`, `json`).
57
- - Consolidated the v4 design and investigation records into `doc/archive/delivery-v4.md` and `doc/archive/delivery-v4-zh.md`.
84
+ - Consolidated the v4 design and investigation records into `doc/archive/delivery.1.4.0.md` and `doc/archive/delivery-v4-zh.md`.
58
85
 
59
86
  ## [1.3.6] - 2026-11-04
60
87
 
@@ -134,7 +161,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
134
161
  - Added thinking labels, per-tool icons, model-error recovery, and idle-safe session handling.
135
162
  - Reorganized modules by bounded context and updated settings and delivery documentation.
136
163
 
137
- [Unreleased]: https://github.com/CQ-Developer/pi-qq/compare/v1.5.0...HEAD
164
+ [Unreleased]: https://github.com/CQ-Developer/pi-qq/compare/v1.6.1...HEAD
165
+ [1.6.1]: https://github.com/CQ-Developer/pi-qq/compare/v1.6.0...v1.6.1
166
+ [1.6.0]: https://github.com/CQ-Developer/pi-qq/compare/v1.5.1...v1.6.0
167
+ [1.5.1]: https://github.com/CQ-Developer/pi-qq/compare/v1.5.0...v1.5.1
138
168
  [1.5.0]: https://github.com/CQ-Developer/pi-qq/compare/v1.4.2...v1.5.0
139
169
  [1.4.2]: https://github.com/CQ-Developer/pi-qq/compare/v1.4.1...v1.4.2
140
170
  [1.4.1]: https://github.com/CQ-Developer/pi-qq/compare/v1.4.0...v1.4.1
package/README-zh.md CHANGED
@@ -35,7 +35,7 @@ pi --extension /path/to/pi-qq
35
35
  给机器人发送 QQ 私聊消息即可开始任务。
36
36
 
37
37
  - **文字**:普通聊天消息。
38
- - **语音**:直接使用 QQ 内置 ASR 文本;音频不会下载或保存。如果 ASR 没有返回文本,机器人会提示你重发或改用文字。
38
+ - **语音**:QQ 内置 ASR 转写文本(`asr_refer_text`)会作为普通用户文本交给 pi;音频不会下载或保存,也不会使用外部语音识别服务。如果 ASR 没有返回文本,机器人会提示你重发或改用文字。通常语音和文字是两条独立的 QQ 消息,需要时按顺序发送。
39
39
  - **图片和文件**:保存到 `.pi/pi-qq/<sessionId>/uploads/`。如果消息中没有指令,pi 会等待你的下一条文字或语音消息。
40
40
 
41
41
  QQ 客户端对混合消息的支持不同。手机 QQ 通常一次只发一种类型,桌面版 QQ 可以发送“文字 + 图片”。当客户端把文字/语音和附件放在同一条消息里时,pi-qq 会把它们合并到同一个提示词中处理。
@@ -50,6 +50,7 @@ QQ 客户端对混合消息的支持不同。手机 QQ 通常一次只发一种
50
50
  - 图片通过 pi 的 `read` 工具查看,因此当前模型必须支持图片输入才能看到内容。
51
51
  - `/new` 会清空等待指令的附件。
52
52
  - 附件按当前 pi 会话隔离。相同文件名且内容相同会复用已有文件;相同文件名但内容不同会保存为 `name-1.ext`;不同文件名但内容相同会分别保存。
53
+ - 如有需要,请把 `.pi/` 加入你自己的项目 `.gitignore`。
53
54
 
54
55
  pi 看到的提示词示例:
55
56
 
@@ -74,25 +75,16 @@ Summarize this file.
74
75
  - 每条媒体消息消耗一次被动回复;超过限制后自动降级为主动消息。
75
76
  - 工具气泡与其它工具一致:`## 📤 qq_send_media`。
76
77
 
77
- ### 语音消息
78
-
79
- 语音消息使用 QQ 内置 ASR(`asr_refer_text`)。转写文本会作为普通用户文本交给 pi;pi 不会收到音频文件。
80
-
81
- - 语音附件不会下载或保存为 `.amr` / `.silk`。
82
- - 不使用本地或外部语音识别服务。
83
- - 如果 QQ ASR 没有返回文本,机器人会回复 `Could not transcribe this voice message; please resend or type it.`,并且不会启动 pi。
84
- - 语音和文字是两条独立的 QQ 消息;需要时按顺序发送。
85
- - 如果客户端允许语音消息同时携带文件或图片,它们会与转写文本一起处理。
86
-
87
- 将 `logLevel` 设为 `debug` 时,日志会包含原始 `asr_refer_text` 和附件元数据。
88
-
89
78
  ### 回复格式
90
79
 
91
- - **思考**:独立气泡,纯文本,首行 `## 💭 思考`。长思考可能续到新气泡,并重复标题。
80
+ `replyType: "full"` 模式下,QQ 会收到这些块类型:
81
+
82
+ - **思考**:独立气泡,纯文本,首行是本地化的 `## 💭 <标签>`(`Thinking` 或 `思考`)。长思考可能续到新气泡,并重复标题。
92
83
  - **工具**:每次调用独立气泡,首行 `## <图标> <工具名>`;`bash` 命令使用 `bash` 代码块,其他参数使用行内代码;结果按工具/文件类型使用 `text`、`markdown`、`python`、`json` 等代码块。
93
84
  - **普通消息**:原文,不加标题。
94
85
  - **工具图标**:💻 bash、📖 read、📝 write、✏️ edit、🔎 grep、🔍 search、🗂️ find、📁 ls、📋 list、🌐 web、📡 fetch、🗑️ delete、❌ remove、✅ todo、🧪 test;未配置工具使用 🔧。
95
- - **错误恢复**:模型错误后 60 秒内自动恢复的 run 会继续推送到原 QQ 会话;`/stop` 会等待当前工具和流收尾后再回复。
86
+
87
+ 模型错误后 60 秒内自动恢复的 run 会继续推送到原 QQ 会话;`/stop` 会等待当前工具和流收尾后再回复。
96
88
 
97
89
  ## 命令
98
90
 
@@ -126,31 +118,73 @@ QQ 侧命令:
126
118
  | `/qq-test-md [text]` | 发送 Markdown 测试消息 |
127
119
  | `/qq-test-stream` | 运行流式时间线诊断(`resume` 验证续写) |
128
120
 
129
- 将 `logLevel` 设为 `debug` 时,只有在登录后由 QQ 消息触发的 run 期间才会写入 agent/message/tool 日志;本地 run、登录流程和空闲时段不写日志。`scope: "media"` 记录媒体工具在这些 run 中的关键步骤,QQ relay 日志也只在 QQ 触发的 run 中出现。
130
-
131
121
  ## 设置
132
122
 
133
123
  创建 `~/.pi/agent/pi-qq.json` 覆盖默认值。该文件只保存设置;凭据不会写入其中。
134
124
 
135
125
  ```json
136
126
  {
137
- "thinkingRelay": true,
127
+ "replyType": "full",
128
+ "deliverAs": "steer",
129
+ "fileMaxSize": 52428800,
138
130
  "language": "zh-cn",
139
131
  "logLevel": "silent"
140
132
  }
141
133
  ```
142
134
 
143
- | 配置项 | 默认值 | 说明 |
144
- | --------------- | ---------- | ------------------------------------------------------ |
145
- | `thinkingRelay` | `true` | 以本地化的 `## 💭` 标题纯文本回传思考;`false` 时隐藏 |
146
- | `deliverAs` | `"steer"` | 忙碌时新消息的排队方式:`steer` 或 `followUp` |
147
- | `fileMaxSize` | `52428800` | QQ 附件下载上限(字节,50MB) |
148
- | `language` | `"zh-cn"` | UI 和日志语言:`zh-cn` 或 `en-us` |
149
- | `logLevel` | `"silent"` | 日志阈值:`silent`、`error`、`warn`、`info` 或 `debug` |
135
+ | 配置项 | 默认值 | 说明 |
136
+ | ------------- | ---------- | ------------------------------------------------------ |
137
+ | `replyType` | `"full"` | 推送到 QQ 的内容粒度:`full`、`simple`、`last` |
138
+ | `deliverAs` | `"steer"` | 忙碌时新消息的排队方式:`steer` 或 `followUp` |
139
+ | `fileMaxSize` | `52428800` | QQ 附件下载上限(字节,50MB) |
140
+ | `language` | `"zh-cn"` | UI 和日志语言:`zh-cn` 或 `en-us` |
141
+ | `logLevel` | `"silent"` | 日志阈值:`silent`、`error`、`warn`、`info` 或 `debug` |
142
+
143
+ 配置在扩展加载时读取,并在每条来自已绑定用户的 QQ 消息处理前重新读取。修改后下一条消息即生效,无需重启 pi 或重新登录。未知配置项会被忽略,无效值会回退到默认值并给出提示。
144
+
145
+ ### `replyType`
146
+
147
+ 一次 run 中哪些内容会被推送到 QQ。
148
+
149
+ | 模式 | QQ 收到的内容 |
150
+ | -------- | ------------------------------------------------------------- |
151
+ | `full` | 思考块、工具调用、工具结果,以及每一条 assistant 消息(默认) |
152
+ | `simple` | 只推 assistant 消息,每条一个气泡 |
153
+ | `last` | 只推 run 中最后一条 assistant 消息,在 run 结束时送出 |
154
+
155
+ - `full` 是默认值,保持 pi-qq 1.5.x 的行为;该模式固定回传思考。
156
+ - `simple` 会实时流出每一条 assistant 消息,一条消息一个气泡。
157
+ - `last` 在任务运行期间不推送任何内容;运行期间执行 `/last` 会回复“任务仍在进行中”。
158
+ - 无论哪种模式,模型错误消息都会立即以普通消息发出。
159
+ - `simple` 与 `last` 不回传工具输出,但 `qq_send_media` 发送的文件仍然会送达。
160
+
161
+ ### `deliverAs`
162
+
163
+ 任务正在运行时,QQ 消息如何进入 pi。
164
+
165
+ - `steer`(默认):在下一个安全点注入当前任务。
166
+ - `followUp`:排队,等当前任务结束后再处理。
167
+
168
+ ### `fileMaxSize`
169
+
170
+ 入站附件的大小上限,单位为字节(默认 `52428800`,即 50MB)。超过上限的附件会被拒绝并提示,不会下载,避免占满本地磁盘和下载额度。
171
+
172
+ ### `language`
173
+
174
+ UI 提示与日志的语言。
175
+
176
+ - `zh-cn`(默认):简体中文。
177
+ - `en-us`:英文。
178
+
179
+ ### `logLevel`
150
180
 
151
- 配置在 pi 会话启动时读取;修改文件后请重启 pi。未知配置项会被忽略,无效值会回退到默认值并给出提示。
181
+ 日志阈值。只有登录后 QQ 触发的 run 处于活动状态时才会写记录,路径为 `<cwd>/.pi/pi-qq/logs/pi-qq-YYYY-MM-DD.log`;可用 `PI_QQ_LOG_DIR` 覆盖目录。`scope: "media"` 记录媒体工具在这些 run 中的步骤。
152
182
 
153
- 启用日志后,只有 QQ 触发的 run 处于活动状态时才会写入记录,路径为 `<cwd>/.pi/pi-qq/logs/pi-qq-YYYY-MM-DD.log`;可用 `PI_QQ_LOG_DIR` 覆盖目录。`info` 只记录元数据;`debug` 记录完整事件、附件、提示词和工具参数/结果。
183
+ - `silent`(默认):完全不写日志文件。
184
+ - `error`:只记录失败。
185
+ - `warn`:记录失败与可恢复的问题。
186
+ - `info`:额外记录 run 元信息——消息 id、内容长度、agent 开始与结束。
187
+ - `debug`:记录全部内容,包括工具参数与结果、附件元数据、提示词和语音转写原文。
154
188
 
155
189
  ## 开发
156
190
 
@@ -176,8 +210,6 @@ npm run format:check
176
210
 
177
211
  - 仅支持 C2C(QQ 私聊)。
178
212
  - QQ 入站消息触发的任务会回传 QQ;直接在 pi 中启动的无关任务不会推送。
179
- - 图片会保存为文件,并通过 pi 的 `read` 工具查看;当前模型必须支持图片输入才能看到内容。
180
- - 保存的附件位于工作区 `.pi/` 下;如有需要,请把 `.pi/` 加入你自己的项目 `.gitignore`。
181
213
  - QQ 对每条入站消息的被动回复次数有限制。可用 `/qq-test-budget` 查看本地额度。
182
214
  - 读取 `SKILL.md` 时,QQ 显示 `## 🧩 技能` 和 skill 名称,不转发文件内容。
183
215
 
package/README.md CHANGED
@@ -35,7 +35,7 @@ Credentials are not written to `pi-qq.json`. Restarting pi requires scanning aga
35
35
  Send a private message to the bot to start a task.
36
36
 
37
37
  - **Text**: normal chat message.
38
- - **Voice**: QQ's built-in ASR text is sent to pi. The audio is not downloaded or saved. If ASR returns no text, the bot asks you to resend or type it.
38
+ - **Voice**: QQ's built-in ASR transcript (`asr_refer_text`) is sent to pi as normal user text. The audio is not downloaded or saved, and no external speech-to-text service is used. If ASR returns no text, the bot asks you to resend or type it. Voice and text are normally separate QQ messages; send them in sequence when needed.
39
39
  - **Images and files**: saved under `.pi/pi-qq/<sessionId>/uploads/`. If the message has no instruction, pi waits for your next text or voice message.
40
40
 
41
41
  QQ clients differ in mixed-message support. Mobile QQ usually sends one message type at a time; desktop QQ can send text with an image. When a client includes text or voice together with attachments, pi-qq processes them in the same prompt.
@@ -50,6 +50,7 @@ An attachment-only message does **not** start pi. Files and images are saved, an
50
50
  - Images are read through pi's `read` tool, so the current model must support image input to see them.
51
51
  - `/new` clears attachments waiting for an instruction.
52
52
  - Uploads are scoped to the current pi session. Same filename and identical content reuse the existing file; same filename with different content becomes `name-1.ext`; different filenames with identical content are kept separately.
53
+ - Add `.pi/` to your project `.gitignore` if needed.
53
54
 
54
55
  Example prompt seen by pi:
55
56
 
@@ -74,25 +75,16 @@ Ask pi explicitly, for example `send me the screenshot` or `把截图发给我`.
74
75
  - Each media message consumes one passive reply; after the limit, pi-qq falls back to a proactive message.
75
76
  - The tool bubble is the same as any other tool: `## 📤 qq_send_media`.
76
77
 
77
- ### Voice messages
78
-
79
- Voice messages use QQ's built-in ASR (`asr_refer_text`). The transcript is sent to pi as normal user text; pi never receives the audio file.
80
-
81
- - The voice attachment is not downloaded or saved as `.amr` / `.silk`.
82
- - No local or external speech-to-text service is used.
83
- - If QQ ASR returns no text, the bot replies `Could not transcribe this voice message; please resend or type it.` and does not start a pi run.
84
- - Voice and text are separate QQ messages; send them one after another when needed.
85
- - If a client sends files or images together with a voice message, they are processed with the transcript.
86
-
87
- Debug logs include the raw `asr_refer_text` and attachment metadata when `logLevel` is set to `debug`.
88
-
89
78
  ### Reply format
90
79
 
91
- - **Thinking**: its own bubble, plain text, starting with `## 💭 思考`. Long thinking may continue in a new bubble with the header repeated.
80
+ In `replyType: "full"` mode, QQ receives these block types:
81
+
82
+ - **Thinking**: its own bubble, plain text, starting with a localized `## 💭 <label>` heading (`Thinking` or `思考`). Long thinking may continue in a new bubble with the header repeated.
92
83
  - **Tools**: one bubble per call: `## <icon> <name>`; `bash` commands use a `bash` code block, other arguments use inline code, and results use `text`, `markdown`, `python`, `json`, etc. depending on the tool and file type.
93
84
  - **Regular messages**: raw text with no header.
94
85
  - **Tool icons**: 💻 bash, 📖 read, 📝 write, ✏️ edit, 🔎 grep, 🔍 search, 🗂️ find, 📁 ls, 📋 list, 🌐 web, 📡 fetch, 🗑️ delete, ❌ remove, ✅ todo, 🧪 test; unconfigured tools use 🔧.
95
- - **Error recovery**: after a model error, automatic retry runs within 60 seconds keep pushing to the original QQ chat. `/stop` waits for active tools and streams to finish before replying.
86
+
87
+ After a model error, automatic retries within 60 seconds keep pushing to the original QQ chat. `/stop` waits for active tools and streams to finish before replying.
96
88
 
97
89
  ## Commands
98
90
 
@@ -126,31 +118,73 @@ These terminal commands are intended for troubleshooting:
126
118
  | `/qq-test-md [text]` | Send a Markdown test message |
127
119
  | `/qq-test-stream` | Run a streamed timeline diagnostic (`resume` for probe) |
128
120
 
129
- With `logLevel: "debug"`, logs are written only while a QQ-triggered run is active after login; local runs, login, and idle periods are not logged. `scope: "media"` covers media-tool steps during those runs, and QQ relay logs only appear for QQ-triggered runs.
130
-
131
121
  ## Settings
132
122
 
133
123
  Create `~/.pi/agent/pi-qq.json` to override defaults. It stores settings only; credentials are never written to it.
134
124
 
135
125
  ```json
136
126
  {
137
- "thinkingRelay": true,
127
+ "replyType": "full",
128
+ "deliverAs": "steer",
129
+ "fileMaxSize": 52428800,
138
130
  "language": "zh-cn",
139
131
  "logLevel": "silent"
140
132
  }
141
133
  ```
142
134
 
143
- | Key | Default | Description |
144
- | --------------- | ---------- | ------------------------------------------------------------ |
145
- | `thinkingRelay` | `true` | Relay thinking as plain text with a localized `## 💭` header |
146
- | `deliverAs` | `"steer"` | Queue new messages while busy: `steer` or `followUp` |
147
- | `fileMaxSize` | `52428800` | QQ attachment download limit in bytes (50MB) |
148
- | `language` | `"zh-cn"` | UI and log language: `zh-cn` or `en-us` |
149
- | `logLevel` | `"silent"` | Log threshold: `silent`, `error`, `warn`, `info`, or `debug` |
135
+ | Key | Default | Description |
136
+ | ------------- | ---------- | ------------------------------------------------------------ |
137
+ | `replyType` | `"full"` | How much of a run is pushed to QQ: `full`, `simple`, `last` |
138
+ | `deliverAs` | `"steer"` | Queue new messages while busy: `steer` or `followUp` |
139
+ | `fileMaxSize` | `52428800` | QQ attachment download limit in bytes (50MB) |
140
+ | `language` | `"zh-cn"` | UI and log language: `zh-cn` or `en-us` |
141
+ | `logLevel` | `"silent"` | Log threshold: `silent`, `error`, `warn`, `info`, or `debug` |
142
+
143
+ Settings are loaded when the extension starts and re-read on every inbound QQ message from the bound user, so edits take effect on the next message without restarting pi or logging in again. Unknown keys are ignored, and invalid values fall back to defaults with a warning.
144
+
145
+ ### `replyType`
146
+
147
+ How much of an agent run is pushed to QQ.
148
+
149
+ | Value | QQ receives |
150
+ | -------- | -------------------------------------------------------------------------------- |
151
+ | `full` | Thinking blocks, tool calls, tool results, and every assistant message (default) |
152
+ | `simple` | Assistant messages only, one bubble each |
153
+ | `last` | Only the last assistant message of the run, sent when the run ends |
154
+
155
+ - `full` is the default and keeps the behaviour of pi-qq 1.5.x; thinking is always relayed in this mode.
156
+ - `simple` streams every assistant message live, one QQ bubble per message.
157
+ - `last` sends nothing while the task is running; `/last` during a running task replies that the task is still running.
158
+ - Model errors are always delivered immediately as a normal message, in every mode.
159
+ - Tool output is not relayed in `simple` or `last`, but files sent with `qq_send_media` are still delivered.
160
+
161
+ ### `deliverAs`
162
+
163
+ How a QQ message reaches pi while a task is already running.
164
+
165
+ - `steer` (default): the message is injected into the running task at the next safe point.
166
+ - `followUp`: the message is queued and processed after the running task finishes.
167
+
168
+ ### `fileMaxSize`
169
+
170
+ Maximum size of an inbound attachment, in bytes (default `52428800`, 50MB). Larger files are rejected with a notice instead of being downloaded, which keeps the local disk and the download quota under control.
171
+
172
+ ### `language`
173
+
174
+ Language of the UI notifications and the log messages.
175
+
176
+ - `zh-cn` (default): Simplified Chinese.
177
+ - `en-us`: English.
178
+
179
+ ### `logLevel`
150
180
 
151
- Settings are read when a pi session starts; restart pi after editing the file. Unknown keys are ignored, and invalid values fall back to defaults with a warning.
181
+ Log threshold. Records are written only while a QQ-triggered run is active after login, to `<cwd>/.pi/pi-qq/logs/pi-qq-YYYY-MM-DD.log`; `PI_QQ_LOG_DIR` overrides the directory. `scope: "media"` covers media-tool steps during those runs.
152
182
 
153
- When logging is enabled, records are written only while a QQ-triggered run is active. Logs go to `<cwd>/.pi/pi-qq/logs/pi-qq-YYYY-MM-DD.log`; `PI_QQ_LOG_DIR` overrides the directory. `info` records metadata only; `debug` records full events, attachments, prompts, and tool payloads.
183
+ - `silent` (default): no log file at all.
184
+ - `error`: failures only.
185
+ - `warn`: failures and recoverable problems.
186
+ - `info`: run metadata as well — message ids, content lengths, agent start and end.
187
+ - `debug`: everything, including tool arguments and results, attachment metadata, prompts, and raw voice transcripts.
154
188
 
155
189
  ## Development
156
190
 
@@ -176,8 +210,6 @@ The extension entrypoint is `index.ts`. Source modules are grouped by responsibi
176
210
 
177
211
  - Only C2C (QQ private chat) is supported.
178
212
  - Runs triggered by inbound QQ messages are relayed to QQ. Unrelated tasks started directly in pi stay local.
179
- - Images are saved as files and read through pi's `read` tool; the current model must support image input to see them.
180
- - Saved attachments are workspace-local under `.pi/`; add `.pi/` to your own project `.gitignore` if needed.
181
213
  - QQ limits passive replies per inbound message. Use `/qq-test-budget` to inspect the local budget.
182
214
  - Reading a `SKILL.md` is shown as a `## 🧩 Skill` block with the skill name; the file content is not forwarded to QQ.
183
215
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > **Archived record.** Content reflects the delivery at that time and may reference removed modules or settings. See [README](../../README.md) for current behavior.
4
4
  > Status: v1 delivered; this is a historical baseline for later versions.
5
- > Later versions: [delivery-v2.md](./delivery-v2.md), [delivery-v3.md](./delivery-v3.md).
5
+ > Later versions: [delivery.1.2.0.md](./delivery.1.2.0.md), [delivery.1.3.0.md](./delivery.1.3.0.md).
6
6
 
7
7
  ## 1. Scope
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  > **Archived record.** Content reflects the delivery at that time and may reference removed modules or settings. See [README](../../README.md) for current behavior.
4
4
  > Status: v2 delivered; this is a historical record.
5
- > Previous: [delivery-v1.md](./delivery-v1.md); next: [delivery-v3.md](./delivery-v3.md).
5
+ > Previous: [delivery.1.0.0.md](./delivery.1.0.0.md); next: [delivery.1.3.0.md](./delivery.1.3.0.md).
6
6
 
7
7
  ## 1. Scope
8
8
 
@@ -3,7 +3,7 @@
3
3
  > **Archived record.** Content reflects the delivery at that time and may reference removed modules or settings. See [README](../../README.md) for current behavior.
4
4
  > Status: v3 implemented and the main path has been verified on real QQ.
5
5
  > Note: later changes removed the image-specific pipeline; images now use the same save/pending path as files.
6
- > Previous: [delivery-v1.md](./delivery-v1.md), [delivery-v2.md](./delivery-v2.md).
6
+ > Previous: [delivery.1.0.0.md](./delivery.1.0.0.md), [delivery.1.2.0.md](./delivery.1.2.0.md).
7
7
 
8
8
  ## 1. Scope
9
9
 
@@ -4,7 +4,7 @@
4
4
  > Status: v4 delivered. Tool block types were verified on real QQ; long-running tool handling and offline delivery remain open items.
5
5
  > Version: 1.4.0
6
6
  > Date: 2026-11-04
7
- > Previous: [delivery-v1.md](./delivery-v1.md), [delivery-v2.md](./delivery-v2.md), [delivery-v3.md](./delivery-v3.md).
7
+ > Previous: [delivery.1.0.0.md](./delivery.1.0.0.md), [delivery.1.2.0.md](./delivery.1.2.0.md), [delivery.1.3.0.md](./delivery.1.3.0.md).
8
8
  > Open work: [doc/todo.md](../todo.md).
9
9
 
10
10
  ## 1. Scope
@@ -3,7 +3,7 @@
3
3
  > **Delivery record.** v5 adds outbound media delivery and fixes debug log coverage for non-QQ runs. See [README](../../README.md) for current user-facing behavior.
4
4
  > Version: 1.5.0
5
5
  > Date: 2026-11-05
6
- > Previous: [delivery-v1.md](./delivery-v1.md), [delivery-v2.md](./delivery-v2.md), [delivery-v3.md](./delivery-v3.md), [delivery-v4.md](./delivery-v4.md).
6
+ > Previous: [delivery.1.0.0.md](./delivery.1.0.0.md), [delivery.1.2.0.md](./delivery.1.2.0.md), [delivery.1.3.0.md](./delivery.1.3.0.md), [delivery.1.4.0.md](./delivery.1.4.0.md).
7
7
  > Supersedes: `doc/research.md`, `doc/feature.md`, and `doc/plan.md`; those working documents were consolidated into this record and removed.
8
8
  > Open work: [doc/todo.md](../todo.md).
9
9
 
@@ -211,7 +211,7 @@ The v5 acceptance log does not cover the two long-running bash scenarios; they r
211
211
 
212
212
  ## 12. References
213
213
 
214
- - Design history: [delivery-v4.md](./delivery-v4.md).
214
+ - Design history: [delivery.1.4.0.md](./delivery.1.4.0.md).
215
215
  - User-facing behavior: [README.md](../../README.md), [README-zh.md](../../README-zh.md).
216
216
  - QQ SDK: `@tencent-connect/qqbot-nodejs` 1.0.5, `src/QQBot.ts`, `src/protocol/api/media.ts`.
217
217
  - pi extension API: `pi/packages/coding-agent/docs/extensions.md`.