@zxh126/pi-qqbot 2.0.0 → 2.0.1

package/CHANGELOG.md

@@ -3,6 +3,29 @@
 本文件记录 pi-qqbot 的版本变更。格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [SemVer](https://semver.org/lang/zh-CN/)。
 
+## [2.0.1] - 2026-10-25
+
+### Fixed
+
+- **口令语序：「暂停汇报进度」之前不被识别**，会漏成普通对话丢给模型。现在「暂停**进度汇报**」与
+  「暂停**汇报进度**」两种语序都认；「别汇报了**吧**」这类双尾字也不再漏。
+
+### Changed
+
+- **口语静音词扩充**：「别汇报了」「别说了」「别讲了」「别推了」「别发了」「别报了」「闭嘴」「安静」
+  「打住」「甭」等，与 `/progress off` 等价（恢复用「恢复汇报」「接着说」）。
+- **「停」改为中断任务**（按用户反馈）：`停`/`停下`/`停一下`/`停停`/`停掉`/`别跑了` 归入 `RE_CANCEL`，
+  与 `/cancel` 完全等价；只有带名词的「停止汇报」或纯闭嘴词才是静音。
+- **主动问进度归为指令**：「汇报一下当前进度」「看一下进度」「说说进度」「进度如何」「进度怎么样」
+  不再当聊天转给 pi，忙时回一次摘要且不入队，空闲时直接回「当前没有正在运行的任务」。
+- `/help` 区分两种语义：只关推送用 `/progress off`/「别汇报了」/「闭嘴」；「停」是中断任务。
+- 两份 README 新增「口语说法」对照表（意图 → 可说的话）。
+
+### Tests
+
+- `test/progress.test.mjs` 16 → 22 个用例（新增 / 改写：语序两边、口语静音词、
+  「停/停下/停一下/停止/取消」均为中断、「停止汇报」仍为静音、主动问进度三姿态、口令不误伤）。
+
 ## [2.0.0] - 2026-10-25
 
 ### Added

package/README.md

@@ -100,7 +100,7 @@ Start pi, then message the bot in QQ; pi handles it and replies.
 | `/progress` | **Show the current progress summary immediately** (aliases: `/p`, 「进度」, 「当前进度」, 「进展」; plain-text questions like 「到哪了」「怎么样了」 work while busy). While you paused reports yourself it only replies once — use `/progress on` to resume; while reports are merely quota-quiet, asking resumes them |
 | `/progress off` | **Pause automatic progress reports for the rest of the session** (aliases: `pause`, `stop`, `暂停`, 「暂停汇报」, 「关闭汇报」). Manual `/progress` still works, it just no longer resumes the timer |
 | `/progress on` | **Resume automatic progress reports** (aliases: `resume`, `start`, `恢复`, 「恢复汇报」, 「继续汇报」) |
-| `/cancel` | **Interrupt the task that is running right now** and empty the queue (aliases: `/stop`, `/abort`, 「取消」, 「停止」, 「中止」, 「终止」, 「算了」) |
+| `/cancel` | **Interrupt the task that is running right now** and empty the queue (aliases: `/stop`, `/abort`, 「取消」, 「停止」, 「中止」, 「终止」, 「算了」, 「停」, 「停下」, 「停一下」, 「别跑了」). Note: a bare 「停」 interrupts the *task*; to silence progress reports say 「别汇报了」/「闭嘴」 or `/progress off` |
 | `/help` | Show help |
 
 ### Slash commands from QQ
@@ -226,6 +226,18 @@ While a run is in progress, a summary is pushed to QQ every `progress.intervalMs
 - Timer is cleared on `agent_settled` / `/cancel` / session shutdown.
 - Set `progress.enabled: false` to turn the whole thing off (across sessions; read at session start).
 
+#### Colloquial shortcuts (Chinese, matched only as a whole message)
+
+| Intent | Say any of |
+|---|---|
+| Pause automatic reports | 「暂停汇报进度」「暂停进度汇报」「别汇报了」「别说了」「闭嘴」「安静」「打住」「停止汇报」, or `/progress off` |
+| Resume them | 「恢复汇报」「恢复汇报进度」「接着说」「说下去」, or `/progress on` |
+| Ask once | 「汇报一下当前进度」「看一下进度」「说说进度」「进度如何」「进度怎么样」, or `/progress` |
+| Interrupt the task | 「停」「停下」「停一下」「停停」「停止」「取消」「别跑了」, or `/cancel` |
+
+A bare 「停」 interrupts the **task**; only phrases carrying a report noun (「停止汇报」) or an explicit
+silence word (「别说了」「闭嘴」) pause the reports. Sentences like 「帮我加个进度条」 are still forwarded to pi.
+
 ### Cancelling a run
 
 Long tasks started from QQ (installs, builds, a runaway agent loop) can be interrupted without going

package/docs/README.zh-CN.md

@@ -98,7 +98,7 @@ pi install ./pi-qqbot
 | `/progress` | **立即获取当前进度摘要**（别名 `/p`、「进度」「当前进度」「进展」；忙碌时「到哪了」「怎么样了」这类问法同样生效）。手动暂停期间**问一次只回一次**，要重新打开定时汇报需发 `/progress on` 或「恢复汇报」；若只是配额静默，问一次即恢复 |
 | `/progress off` | **在本会话内暂停自动进度汇报**（别名：`pause`、`stop`、`暂停`、「暂停汇报」、「关闭汇报」）。手动 `/progress` 仍可看一次，但不再解除暂停 |
 | `/progress on` | **恢复自动进度汇报**（别名：`resume`、`start`、`恢复`、「恢复汇报」、「继续汇报」） |
-| `/cancel` | **中断当前正在运行的任务**并清空队列（别名：`/stop`、`/abort`、「取消」、「停止」、「中止」、「终止」、「算了」） |
+| `/cancel` | **中断当前正在运行的任务**并清空队列（别名：`/stop`、`/abort`、「取消」、「停止」、「中止」、「终止」、「算了」、「停」、「停下」、「停一下」、「别跑了」）。注意：单说「停」是中断**任务**，要关进度推送请说「别汇报了」「闭嘴」或 `/progress off` |
 | `/help` | 帮助 |
 
 ### QQ 里的斜杠命令
@@ -213,6 +213,18 @@ pi 的会话一次只跑一轮 agent run，所以串行调度由 bot 自己做
 - `agent_settled` / `/cancel` / 会话关闭时定时器都会清掉。
 - 想彻底关掉（跨会话）：`progress.enabled: false`（改完需 `/new` 或重启才生效）。
 
+#### 口语说法（整句匹配，只在发整句时生效）
+
+| 意图 | 可以说 |
+|---|---|
+| 暂停自动汇报 | 「暂停汇报进度」「暂停进度汇报」「别汇报了」「别说了」「闭嘴」「安静」「打住」「停止汇报」，或 `/progress off` |
+| 恢复自动汇报 | 「恢复汇报」「恢复汇报进度」「接着说」「说下去」，或 `/progress on` |
+| 看一次当前进度 | 「汇报一下当前进度」「看一下进度」「说说进度」「进度如何」「进度怎么样」，或 `/progress` |
+| 中断当前任务 | 「停」「停下」「停一下」「停停」「停止」「取消」「别跑了」，或 `/cancel` |
+
+单说「停」是中断**任务**；只有带名词的（「停止汇报」）或明确的闭嘴词（「别说了」「闭嘴」）才是暂停汇报。
+「帮我加个进度条」这种任务句仍照常转给 pi，不会被当成口令。
+
 ### 取消正在运行的任务
 
 从 QQ 发起的耗时任务（装依赖、编译、agent 跑飞了）不必回到机器上处理：

package/index.ts

@@ -484,8 +484,15 @@ export default function (
 }
 
 /** 取消/停止这类「打断当前任务」的表达 */
+/**
+ * 取消/停止这类「打断当前任务」的表达。
+ *
+ * 注意分工：「停」「停下」「停一下」属于**中断任务**（用户定的：停 = 停止干活）；
+ * 想只关掉进度推送请用「别汇报了」「闭嘴」「/progress off」；
+ * 「停止汇报」因为带了名词，不算取消，走静音。
+ */
 const RE_CANCEL =
-  /^(\/cancel|\/stop|\/abort|取消|停止|中止|终止|算了|cancel|stop|abort)$/i;
+  /^(\/cancel|\/stop|\/abort|取消|停止|中止|终止|算了|停|停下|停一下|停停|停掉|别跑了|cancel|stop|abort)$/i;
 
 function isCancelIntent(text: string): boolean {
   return RE_CANCEL.test(text.trim());
@@ -880,7 +887,8 @@ export async function handleMessage(
           "/status — 查看状态（当前 qqbot / 忙闲 / 队列 / 自动同意 / 待审批 / 自动汇报）",
           "/queue — 查看队列；/queue clear 清空；/queue drop <编号> 删一条",
           "/reset — 清空回复缓冲、审批记忆与自动同意（不换会话；换会话发 /new）",
-          "/cancel（或「取消」「停止」）— 中断正在运行的任务并清空队列",
+          "/cancel（或「取消」「停止」「停」）— 中断正在运行的任务并清空队列",
+          "只关进度推送：/progress off（或「别汇报了」「闭嘴」）；「停」是中断任务，不是静音",
           "/help — 帮助",
           "pi 的命令优先：/reload /new /compact /session /name /model /thinking，以及扩展命令、模板与 /skill:xxx。",
           "忙碌时发来的普通消息（含模板/skill 命令）会排队，当前任务结束后自动执行。",
@@ -1109,14 +1117,65 @@ const UNMUTE_ARGS = new Set([
   "继续汇报",
 ]);
 
-/** 不带斜杠的「暂停汇报」类说法（整句匹配，避免误伤正常聊天） */
-const RE_REPORTS_OFF =
-  /^(?:请|帮我|给我)?\s*(?:暂停|停止|关闭|关掉|别|不要|别再)(?:自动)?(?:的)?(?:进度汇报|进度|进展|汇报|推送|播报|报告)(?:上报|推送|汇报)?(?:了|吧)?$/;
-const RE_REPORTS_ON =
-  /^(?:请|帮我|给我)?\s*(?:恢复|继续|开启|打开|开始)(?:自动)?(?:的)?(?:进度汇报|进度|进展|汇报|推送|播报|报告)(?:上报|推送|汇报)?(?:吧)?$/;
+/**
+ * 不带斜杠的口令（整句匹配，避免误伤正常聊天）。
+ *
+ * 三类：
+ * 1. 问进度：「汇报一下当前进度」「看一下进度」「进度如何」→ 回一次摘要
+ * 2. 静音：「暂停汇报进度」「别汇报了」「别说了」「闭嘴」「停」→ 暂停自动汇报
+ * 3. 恢复：「恢复汇报」「接着说」→ 重新打开自动汇报
+ *
+ * 注意：「停止/取消/中止」是**中断任务**（RE_CANCEL，更早判定），不是静音；
+ * 「停止汇报」才走静音。
+ */
+const REPORT_LEAD = "(?:请|帮我|给我|麻烦|暂时|先)?\\s*";
+/** 汇报名词的两种语序（进度汇报 / 汇报进度） */
+const REPORT_NOUN =
+  "(?:(?:进度|进展)(?:汇报|报告|推送|播报|上报)?|(?:汇报|报告|推送|播报|上报)(?:进度|进展)?)";
+const REPORT_TAIL = "\\s*(?:了|吧|哦|啊|呀|嘛|啦|呗)*";
+
+/** 问进度（含「汇报一下…」这类祈使句） */
+const BARE_PROGRESS_RE = new RegExp(
+  "^" +
+    REPORT_LEAD +
+    "(?:(?:汇报|报告|报|说说|讲讲|看|看看|查|查查|查看|显示|展示)(?:一下|下|个|一眼)?\\s*)?" +
+    "(?:当前|现在|目前)?\\s*(?:的)?\\s*(?:progress|进度|进展)" +
+    "(?:\\s*(?:如何|怎么样|怎样|呢|啦|了|吗))?" +
+    "(?:\\s+([\\s\\S]*))?$",
+  "i",
+);
+
+/** 静音：带「汇报」名词的 */
+const RE_REPORTS_OFF = new RegExp(
+  "^" +
+    REPORT_LEAD +
+    "(?:暂停|停止|停下|关闭|关掉|别再|别|不要|不用|甭|闭嘴|安静|打住)\\s*" +
+    "(?:自动|定时|定期)?\\s*(?:的)?\\s*" +
+    REPORT_NOUN +
+    REPORT_TAIL +
+    "$",
+);
+/** 静音：不提「汇报」的纯闭嘴类（停/停下 不在此列——它们属于中断任务） */
+const RE_SILENCE = new RegExp(
+  "^" +
+    REPORT_LEAD +
+    "(?:闭嘴|安静|安静点|安静下|别说了|别讲了|别吵了?|别推了|别发了|别报了|打住)" +
+    REPORT_TAIL +
+    "$",
+);
+/** 恢复：说清楚要恢复汇报，或者「接着说」 */
+const RE_REPORTS_ON = new RegExp(
+  "^" +
+    REPORT_LEAD +
+    "(?:恢复|继续|开启|打开|开始|接着说|接着说吧|说下去|接着报)\\s*" +
+    "(?:自动|定时|定期)?\\s*(?:的)?\\s*" +
+    REPORT_NOUN +
+    REPORT_TAIL +
+    "$",
+);
+const RE_RESUME_TALK = new RegExp("^" + REPORT_LEAD + "(?:接着说|说下去|接着报)" + REPORT_TAIL + "$");
 
-/** 不带斜杠的进度问询：「进度」「当前进度」「现在进展」（可带子命令） */
-const BARE_PROGRESS_RE = /^(?:progress|(?:当前|现在|目前)?的?(?:进度|进展))(?:\s+([\s\S]*))?$/i;
+/** 不带斜杠的进度问询：「进度」「当前进度」「汇报一下当前进度」（可带子命令） */
 
 function parseCommand(text: string): { name: "reset" | "status" | "help" | "queue" | "progress"; args: string } | null {
   // 注意：/new 现在属于 pi 的内置命令（由 slash 路由接管，真的开新会话），
@@ -1132,11 +1191,11 @@ function parseCommand(text: string): { name: "reset" | "status" | "help" | "queu
       args: (slash[2] ?? "").trim(),
     };
   }
-  // 裸文本：「进度」「当前进度」→ 看一次；「暂停汇报」「恢复汇报」→ 开关
+  // 裸文本：先认「问进度」，再认「静音/恢复」
   const bare = BARE_PROGRESS_RE.exec(t);
   if (bare) return { name: "progress", args: (bare[1] ?? "").trim() };
-  if (RE_REPORTS_OFF.test(t)) return { name: "progress", args: "off" };
-  if (RE_REPORTS_ON.test(t)) return { name: "progress", args: "on" };
+  if (RE_REPORTS_OFF.test(t) || RE_SILENCE.test(t)) return { name: "progress", args: "off" };
+  if (RE_REPORTS_ON.test(t) || RE_RESUME_TALK.test(t)) return { name: "progress", args: "on" };
   return null;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zxh126/pi-qqbot",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "type": "module",
   "description": "Bridge the Pi coding agent into QQ private chats, with remote tool-call approval",
   "license": "MIT",