@fengye_nobug/dsh-qq-bot 0.2.8 → 0.2.9

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 更新日志
 
+## v0.2.9 — 2026-11-02
+
+- **每个会话的轮数上限会真正压缩**：`maxRecentTurns`（默认 40，填 0 不限制）在 QQ 叫醒的一轮结束后，会请宿主把更早的内容压掉。以前这次调用少传了宿主要求的取消信号，压缩还没开始就失败，失败只留在日志里，会话仍会一直变长。现在会等这一轮结束并空闲下来，再按宿主的参数去压缩。宿主没有压缩能力时仍然跳过，不影响收发。
+
 ## 0.2.8
 
 - 设置卡片：群白名单在连上 NapCat 时可显示群名和头像；查不到时仍只显示群号

package/DESIGN.md

@@ -603,7 +603,7 @@ QQ 的“拍一拍”在 OneBot 里走的是 **notice 事件**，不是消息段
 |---|---|---|
 | `targetSessionId` | `''` | 接到哪个会话。`single` 时**空 = 不接到任何会话**。`perGroup` 时可以留空（新建会话用宿主当前默认模型）；填了则新建会话沿用该会话的模型 |
 | `sessionScope` | `single` | 会话怎么分。`single` = 所有群共用一个会话；`perGroup` = 每个群、每个私聊各记各的，映射写在状态文件的 `sessionByDest`（键为 `group:<群号>` / `private:<QQ号>`）。新建会话带工作目录和「QQ群 / QQ私聊」标题，见 [README 的功能](./README.md#功能) |
-| `maxRecentTurns` | `40` | 每个会话最多留几轮。超出后调用宿主 `compaction.compactNow` 尽量压缩。有投影时看投影轮数。压完没变短就停。`0` = 不限制 |
+| `maxRecentTurns` | `40` | 每个会话最多留几轮。超出后，等这一轮回到空闲，再调用宿主 `compaction.compactNow(agent, signal)` 尽量压缩。`signal` 是未取消的 AbortSignal，不传命令 id。有投影时看投影轮数。压完没变短就停。`0` = 不限制。compaction 不在 inject 里，宿主没有这项服务时跳过 |
 | `nicknames` | `['244','小助手']` | 听到这些名字就回应 |
 | `wakeProbability` | `0.05` | 没点名时的回应概率 |
 | `whitelist` / `groupWhitelist` | `[]` | 哪些私聊可以叫醒 / 哪些群可以叫醒（**留空 = 谁都不能叫醒**）。群白名单在卡片里按群号填；连上且查到群名时，群号旁边显示当前群名和头像，查不到或没连上只显示群号，不影响保存 |

package/README.md

@@ -62,6 +62,7 @@ DSH 0.2 的卡片把值写进 `$DSH_HOME/qq-bridge-settings.json`。这份文件
 |---|---|---|
 | `targetSessionId` | 空 | `single` 时接到哪个会话。留空 = 不接到任何会话 |
 | `sessionScope` | `single` | `perGroup` 时每个群、每个私聊各一条会话 |
+| `maxRecentTurns` | `40` | 每个会话最多留几轮。QQ 一轮结束后，更早的内容会尽量压缩掉。`0` = 不限制 |
 | `nicknames` | `244`、`小助手` | 听到这些名字就叫醒 |
 | `wakeProbability` | `0.05` | 没点名时的叫醒概率 |
 | `whitelist` | `[]` | 哪些私聊可以叫醒。留空 = 都不叫醒 |

package/index.js

@@ -1902,12 +1902,30 @@ export function apply(ctx, config) {
   /**
    * QQ 驱动的一轮结束后，把该会话压到 maxRecentTurns。
    * 0 或宿主没有 compaction 时什么都不做。压缩失败只记日志，不挡出站。
+   *
+   * compaction 不放进 inject。它是可选服务：宿主没装压缩时，桥仍要收发 QQ。
+   * `ctx.get` 不要求 inject；没有这项服务时返回 undefined。
+   *
+   * 宿主 `compactNow(agent, signal, sourceCommandId?)` 会立刻 `signal.throwIfAborted()`。
+   * 官方 `/compact` 传的是这次命令的 signal 和 commandId。这里没有命令，传一个未中止的
+   * AbortSignal，不传 sourceCommandId。少传 signal 会在写入 compaction 事件之前抛错。
+   *
+   * `turn/end` 写入日志时，驱动还占着 running。这时调用会在 `runMaintenance` 上失败，
+   * 同样写不出 compaction 事件。先等 `whenIdle`。旧宿主没有这个方法时让出一个宏任务
+   * （微任务会排在驱动回到 idle 之前）。
    */
   async function maybeTrimSession(agent) {
     const max = readSettings().maxRecentTurns
     if (!max || max <= 0 || !agent) return
     const compaction = ctx.get('compaction')
     if (!compaction || typeof compaction.compactNow !== 'function') return
+    try {
+      if (typeof agent.whenIdle === 'function') await agent.whenIdle()
+      else await new Promise((resolve) => setTimeout(resolve, 0))
+    } catch (error) {
+      logger.warn(`compact trim skipped: ${error?.message ?? error}`)
+      return
+    }
     const countTurns = () => {
       // 投影里的轮次是压缩之后还留着的。历史事件里的 turn/end 压不掉，先数它会一直超限。
       try {
@@ -1938,7 +1956,7 @@ export function apply(ctx, config) {
       }
       previous = turns
       try {
-        const result = await compaction.compactNow(agent)
+        const result = await compaction.compactNow(agent, new AbortController().signal)
         if (!result) return
         logger.info(`session ${agent.session?.id ?? agent.id} trimmed via compact (turns~${turns} > ${max})`)
       } catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fengye_nobug/dsh-qq-bot",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "type": "module",
   "main": "index.js",
   "description": "把 DSH 会话接到 QQ（OneBot/NapCat）的插件。白名单默认全关；被 @、叫到昵称或被戳一定叫醒，其余消息按可调概率抽样。Fork 自 sj244/dsh-qq-bridge（MIT）。",