@fengye_nobug/dsh-qq-bot 0.2.10 → 0.2.12

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # 更新日志
 
+## v0.2.12 — 2026-11-02
+
+- **QQ 回复风格不再鼓励使用 emoji**：`$DSH_HOME/.agent-presets/dsh-qq-bridge/skills/qq-session-reply-style/references/reply-style.md` 若还写着 “Emoji are welcome when they make the answer friendlier.”，插件启动时删掉这一句。「Avoid Markdown formatting. Use plain text.」以及前后其它行保持原样。不另加「默认不要带表情」或「少用某个表情」的规矩。这份文件不在插件目录里，DSH 升级时也不会改写 `.agent-presets`；它是人设安装时复制进去的。面板更新并重启后才会改到磁盘上的那一份。文件本来就不存在时不会新建，也不用删掉整个人设目录。用法说明和 `qq_bridge_send` 的说明不动。
+
+## 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

@@ -194,6 +194,8 @@ qq_bridge_napcat
 
 四条路。装完都要让 dsh-web 重新加载插件：
 
+0.2.12 起，插件启动时会看 `$DSH_HOME/.agent-presets/dsh-qq-bridge/skills/qq-session-reply-style/references/reply-style.md`。里面若还有 “Emoji are welcome when they make the answer friendlier.”，只删这一句。这文件不在 npm 包的安装目录里，`dsh plugin add` 不会顺手改它；人设安装时整份复制到 `$DSH_HOME/.agent-presets`，所以要等新版本的插件进程起来才写回。文件不存在就不创建。不要为了这句话删掉整个人设目录，本插件不会把人设的其它文件补回去。
+
 1. 设置卡片里先点「检查更新」。有新正式版时出现「更新到 vX.Y.Z」。点下去优先执行 `dsh plugin --profile web add @fengye_nobug/dsh-qq-bot@X.Y.Z`，走这台机器上 pnpm 已经配置的 registry，然后重启面板。装完会把 profile、`$DSH_HOME/cordis.patch.yml`（写了 `qq-bridge` 才改）和插件补丁里 `qq-bridge` 的 `name` 改成磁盘上的包名，`config` 不动。设置还在，不改 NapCat。重启后刷新页面；登录口令可能会变。
 2. 自己执行同一条命令。npm 上已经发出的是 `@fengye_nobug/dsh-qq-bot@0.2.5`。自己装不会自动改 profile 里的旧 `name`。
 3. 指定 GitHub tag：`dsh plugin --profile web add github:yunfengnobug/dsh-qq-bot#vX.Y.Z`
@@ -603,7 +605,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` | `[]` | 哪些私聊可以叫醒。留空 = 都不叫醒 |
@@ -96,6 +96,8 @@ DSH 0.2 的卡片把值写进 `$DSH_HOME/qq-bridge-settings.json`。这份文件
 
 设置卡片里先点「检查更新」。有新正式版时点「更新到 vX.Y.Z」。优先从 npm 安装；这一版还没发到 npm 时，改从 GitHub 下载。装完会自己重启 dsh-web。设置还在，不改 NapCat。刷新页面后，登录口令可能会变。
 
+0.2.12 起，重启后如果 `$DSH_HOME/.agent-presets/dsh-qq-bridge/skills/qq-session-reply-style/references/reply-style.md` 里还有 “Emoji are welcome when they make the answer friendlier.”，会删掉这一句。「Avoid Markdown formatting. Use plain text.」还在，其它行不动，也不另写禁用表情的规矩。这份文件本来没有时不会新建。不用删掉整个人设目录。已经读进当前会话的旧规则，要等下次再读这份说明，或另开一条会话。
+
 「检查更新」和「启动时检查一次」只询问，不会安装。
 
 维护者发版：

package/agent-presets/dsh-qq-bridge/skills/qq-session-reply-style/references/reply-style.md

@@ -0,0 +1,8 @@
+# Reply Style
+
+Use these rules when replying through QQ:
+
+1. Put the conclusion first.
+2. Keep the reply concise.
+3. Avoid Markdown formatting. Use plain text.
+4. If you changed files during this conversation, list only the modified file names with a brief note for each.

package/index.js

@@ -42,6 +42,7 @@ import {
   upsertSticker,
 } from './stickers.js'
 import { FACE_NAME_TO_ID, textToOneBotSegments } from './faces.js'
+import { syncInstalledReplyStyle } from './reply-style.js'
 import { applyPluginUpdate, checkPluginUpdate } from './updates.js'
 
 const require = createRequire(import.meta.url)
@@ -726,6 +727,14 @@ export function apply(ctx, config) {
   const legacySettings = hasLegacySettings(settingsService)
 
   const home = process.env.DSH_HOME || join(homedir(), '.dsh')
+  // 人设文件在 $DSH_HOME/.agent-presets，不随 node_modules 一起换。
+  // 面板升级并重启后，这里只删掉已经复制进去的那句鼓励使用 emoji 的话。
+  try {
+    const refreshed = syncInstalledReplyStyle(home)
+    if (refreshed.changed) logger.info('已去掉 QQ 回复风格里鼓励使用 emoji 的那一句。')
+  } catch (error) {
+    logger.warn(`更新 QQ 回复风格失败：${error?.message ?? error}`)
+  }
   /**
    * 用户设置的落盘位置（0.2.0 专用）。
    * 0.2.0 的宿主设置桥不给第三方插件可写域（见 docs/dsh-0.2.0-migration.md），
@@ -1899,16 +1908,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 +1958,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 +1985,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.12",
   "type": "module",
   "main": "index.js",
   "description": "把 DSH 会话接到 QQ（OneBot/NapCat）的插件。白名单默认全关；被 @、叫到昵称或被戳一定叫醒，其余消息按可调概率抽样。Fork 自 sj244/dsh-qq-bridge（MIT）。",
@@ -57,6 +57,8 @@
     "napcat.js",
     "stickers.js",
     "faces.js",
+    "reply-style.js",
+    "agent-presets",
     "client",
     "assets",
     "screenshots.json",

package/reply-style.js

@@ -0,0 +1,60 @@
+// 已装上的 QQ 人设不在插件目录里。
+// DSH 升级插件时只换 node_modules，不会改写 $DSH_HOME/.agent-presets。
+// reply-style.md 是人设安装时复制进去的。插件每次启动时，如果那份文件还在鼓励使用 emoji，
+// 就只删这一句。其它行保持原样。人设目录或这份文件不存在时，不新建。
+
+import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { isAbsolute, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+/** 磁盘上的相对路径，挂在 $DSH_HOME 下面。 */
+export const INSTALLED_REPLY_STYLE_SEGMENTS = [
+  '.agent-presets',
+  'dsh-qq-bridge',
+  'skills',
+  'qq-session-reply-style',
+  'references',
+  'reply-style.md',
+]
+
+/** 要删掉的那一句。前后其它文字不动。 */
+export const EMOJI_WELCOME_SENTENCE = 'Emoji are welcome when they make the answer friendlier.'
+
+export function packagedReplyStylePath() {
+  return fileURLToPath(
+    new URL('./agent-presets/dsh-qq-bridge/skills/qq-session-reply-style/references/reply-style.md', import.meta.url),
+  )
+}
+
+export function installedReplyStylePath(home) {
+  return join(home, ...INSTALLED_REPLY_STYLE_SEGMENTS)
+}
+
+/**
+ * 去掉鼓励使用 emoji 的那一句，以及它前面紧挨着的空格或制表符。
+ * 不改其它字符，也不另加规矩。
+ */
+export function stripEmojiEncouragement(text) {
+  return String(text ?? '').replaceAll(` ${EMOJI_WELCOME_SENTENCE}`, '').replaceAll(EMOJI_WELCOME_SENTENCE, '')
+}
+
+/**
+ * 启动时刷新已经复制到 $DSH_HOME 的回复风格。
+ * 文件不在就不创建；没有那一句就原样留下。
+ * @returns {{ changed: boolean, path: string, reason: 'bad-home' | 'missing' | 'unchanged' | 'stripped' }}
+ */
+export function syncInstalledReplyStyle(home) {
+  if (typeof home !== 'string' || !isAbsolute(home)) {
+    return { changed: false, path: '', reason: 'bad-home' }
+  }
+  const target = installedReplyStylePath(home)
+  if (!existsSync(target)) return { changed: false, path: target, reason: 'missing' }
+  const current = readFileSync(target, 'utf8')
+  if (!current.includes(EMOJI_WELCOME_SENTENCE)) {
+    return { changed: false, path: target, reason: 'unchanged' }
+  }
+  const next = stripEmojiEncouragement(current)
+  if (next === current) return { changed: false, path: target, reason: 'unchanged' }
+  writeFileSync(target, next)
+  return { changed: true, path: target, reason: 'stripped' }
+}