@fengye_nobug/dsh-qq-bot 0.2.10 → 0.2.11

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # 更新日志
 
+## v0.2.11 — 2026-11-02
+
+- **轮数上限会用到人设里的压缩**：`maxRecentTurns`（默认 40，填 0 不限制）在 QQ 叫醒的一轮结束并空闲后，压缩更早的内容。标准人设把压缩放在隔离域里，插件所在的宿主上下文看不见，所以 0.2.9 这次调用直接跳过，会话会一直变长，日志里也没有压缩记录。现在先向这条会话的人设要压缩服务，没有再看会话作用域和宿主。已经超限却找不到，或这次压缩没有改动会话时，记一条警告。仍然等这一轮空闲，并带上未取消的取消信号。不必在宿主配置里再打开压缩。哪一层都没有压缩时不影响收发。
+
 ## v0.2.10 — 2026-11-02
 
 - **用法说明和发消息工具不再用具体表情名当例子**：注入的用法说明，以及 `qq_bridge_send` 的工具说明和参数说明，不再把笑哭、挥手写成推荐写法。模型之前会抓住这两个例子反复使用。现在只说明半角方括号里写 `[表情名]` 或 `[表情数字]`。对得上的表情名仍会变成 QQ 系统表情，名字表还在 `faces.js`。认不出的方括号仍留在文字里。

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(agent, signal)` 尽量压缩。`signal` 是未取消的 AbortSignal，不传命令 id。有投影时看投影轮数。压完没变短就停。`0` = 不限制。compaction 不在 inject 里，宿主没有这项服务时跳过 |
+| `maxRecentTurns` | `40` | 每个会话最多留几轮。超出后，等这一轮回到空闲，再调用 `compaction.compactNow(agent, signal)` 尽量压缩。压缩服务先从这条会话的人设读取（`agentPresets.serviceFor(agent, 'compaction')`，标准人设把它放在隔离域里），没有再看会话作用域，最后看宿主。`signal` 是未取消的 AbortSignal，不传命令 id。有投影时看投影轮数。压完没变短就停。返回空也停，并记一条警告。`0` = 不限制。compaction 不在 inject 里。已经超限、三层都没有这项服务时记一条警告并跳过，收发不受影响 |
 | `nicknames` | `['244','小助手']` | 听到这些名字就回应 |
 | `wakeProbability` | `0.05` | 没点名时的回应概率 |
 | `whitelist` / `groupWhitelist` | `[]` | 哪些私聊可以叫醒 / 哪些群可以叫醒（**留空 = 谁都不能叫醒**）。群白名单在卡片里按群号填；连上且查到群名时，群号旁边显示当前群名和头像，查不到或没连上只显示群号，不影响保存 |

package/README.md

@@ -62,7 +62,7 @@ DSH 0.2 的卡片把值写进 `$DSH_HOME/qq-bridge-settings.json`。这份文件
 |---|---|---|
 | `targetSessionId` | 空 | `single` 时接到哪个会话。留空 = 不接到任何会话 |
 | `sessionScope` | `single` | `perGroup` 时每个群、每个私聊各一条会话 |
-| `maxRecentTurns` | `40` | 每个会话最多留几轮。QQ 一轮结束后，更早的内容会尽量压缩掉。`0` = 不限制 |
+| `maxRecentTurns` | `40` | 每个会话最多留几轮。QQ 一轮结束并空闲后，更早的内容会尽量压缩掉。用的是这条会话自己的压缩（标准人设里就有）。人设没有时再看会话作用域和宿主。已经超限却找不到压缩，或这次压缩没有改动会话时，记一条警告。`0` = 不限制 |
 | `nicknames` | `244`、`小助手` | 听到这些名字就叫醒 |
 | `wakeProbability` | `0.05` | 没点名时的叫醒概率 |
 | `whitelist` | `[]` | 哪些私聊可以叫醒。留空 = 都不叫醒 |

package/index.js

@@ -1899,16 +1899,48 @@ export function apply(ctx, config) {
     }
   }
 
+  /**
+   * 读一份能调用的 compaction。
+   *
+   * 标准人设把 `dsh-compaction-basic` 放在 `isolate: { compaction: true }` 里。
+   * 这份服务只在人设那一组的 realm 里，宿主 `ctx.get('compaction')` 和 `agent.ctx.get`
+   * 都按自己的 realm 查找，读到的是空。`/compact` 能用，是因为 `dsh-command-compact`
+   * 和压缩后端在同一组里，调用的是这一份 `compactNow`。
+   * 宿主侧对应的读法是 `agentPresets.serviceFor(agent, 'compaction')`。
+   *
+   * 人设注册表没有这个方法，或这份人设没挂压缩时，再看会话作用域，最后看宿主。
+   * 宿主自己提供 compaction 的布局因此仍然可用。某一层抛错就换下一层。
+   * @returns {{ service: any, detail: string }}
+   */
+  function compactionFor(agent) {
+    let detail = ''
+    const take = (read) => {
+      try {
+        const value = read()
+        if (value && typeof value.compactNow === 'function') return value
+      } catch (error) {
+        if (!detail) detail = error?.message ?? String(error)
+      }
+      return undefined
+    }
+    const service =
+      take(() => ctx.get?.('agentPresets')?.serviceFor?.(agent, 'compaction')) ??
+      take(() => agent?.ctx?.get?.('compaction')) ??
+      take(() => (typeof ctx.get === 'function' ? ctx.get('compaction') : undefined))
+    return { service, detail }
+  }
+
   /**
    * QQ 驱动的一轮结束后，把该会话压到 maxRecentTurns。
-   * 0 或宿主没有 compaction 时什么都不做。压缩失败只记日志，不挡出站。
+   * 0 时什么都不做。压缩失败只记日志，不挡出站。
    *
-   * compaction 不放进 inject。它是可选服务：宿主没装压缩时，桥仍要收发 QQ。
-   * `ctx.get` 不要求 inject；没有这项服务时返回 undefined。
+   * compaction 不放进 inject。它是可选服务：哪一层都没有时，桥仍要收发 QQ。
+   * 会话已经超过上限、却找不到 compactNow 时记一条 warn，避免静默不压缩。
    *
-   * 宿主 `compactNow(agent, signal, sourceCommandId?)` 会立刻 `signal.throwIfAborted()`。
-   * 官方 `/compact` 传的是这次命令的 signal 和 commandId。这里没有命令，传一个未中止的
-   * AbortSignal，不传 sourceCommandId。少传 signal 会在写入 compaction 事件之前抛错。
+   * `compactNow(agent, signal, sourceCommandId?)` 会立刻 `signal.throwIfAborted()`。
+   * 这里没有命令，传一个未中止的 AbortSignal，不传 sourceCommandId。
+   * 少传 signal 会在写入 compaction 事件之前抛错。
+   * 返回 null 表示没有可压的区间：记 warn 并停，不再空转。
    *
    * `turn/end` 写入日志时，驱动还占着 running。这时调用会在 `runMaintenance` 上失败，
    * 同样写不出 compaction 事件。先等 `whenIdle`。旧宿主没有这个方法时让出一个宏任务
@@ -1917,8 +1949,6 @@ export function apply(ctx, config) {
   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))
@@ -1946,19 +1976,40 @@ export function apply(ctx, config) {
         return 0
       }
     }
+    const sessionId = () => agent.session?.id ?? agent.id
+    let compaction
+    let lookupDetail = ''
+    let resolved = false
+    const engine = () => {
+      if (!resolved) {
+        const found = compactionFor(agent)
+        compaction = found.service
+        lookupDetail = found.detail
+        resolved = true
+      }
+      return compaction
+    }
     let previous = Infinity
     for (let i = 0; i < 6; i++) {
       const turns = countTurns()
       if (!turns || turns <= max) return
       if (turns >= previous) {
-        logger.info(`session ${agent.session?.id ?? agent.id} compact 后轮次没有减少（${turns}），停止`)
+        logger.info(`session ${sessionId()} compact 后轮次没有减少（${turns}），停止`)
+        return
+      }
+      if (!engine()) {
+        const why = lookupDetail ? `（${lookupDetail}）` : ''
+        logger.warn(`compact trim: 会话 ${sessionId()} 约 ${turns} 轮，超过上限 ${max}，但没有可用的压缩服务${why}`)
         return
       }
       previous = turns
       try {
         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})`)
+        if (result == null) {
+          logger.warn(`compact trim: 会话 ${sessionId()} 的 compactNow 返回空（当时约 ${turns} 轮，上限 ${max}）`)
+          return
+        }
+        logger.info(`session ${sessionId()} trimmed via compact (turns~${turns} > ${max})`)
       } catch (error) {
         logger.warn(`compact trim failed: ${error?.message ?? error}`)
         return

package/package.json

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