dsh-onebot-companion

Name: dsh-onebot-companion
Availability: InStock
Author: xfgil

QQ 通道一体化插件：出站沉默守卫、每轮行为规则、对话节奏（入站合并/出站分段）、人设（情绪+主动发言+风格学习）、语音（qq_say: 文字→edge-tts→语音消息）。Runtime prototype patching for dsh-onebot-qq — upgrade-proof, no node_modules edits.

Stars: 0
Language: JavaScript
Created: Oct 13, 2026
Updated: Oct 16, 2026

Notify

GitHub repo

Introduction

dsh-onebot-companion

一个插件，把 QQ 通道该有的都装回来：出站沉默守卫 + 每轮行为规则 + 对话节奏 + 人设 + 语音 + 会话换代防护 + 时间戳。

中文 · English

DSH 插件 · 为 dsh-onebot-qq 补上被 0.9.0 升级冲掉的能力。

同系列：dsh-hot-reloader（热重载）· dsh-session-clock（会话时钟）· dsh-proxy-on-demand（按需代理） · dsh-second-opinion（第二意见）

本仓库取代 dsh-onebot-guard / dsh-onebot-prompt / dsh-onebot-rhythm 三个独立插件（它们的能力已全部并入本插件的模块）。已装过旧插件的请先卸载再装这个，不要同时装—— 两套代码会各自包装同一条原型链，导致重复分条、重复计数。

为什么需要它

dsh-onebot-qq 只负责把 QQ 通道接上，聊天本身该有的东西它不管：沉默怎么表达、括号里的旁白算不算话、一条长回复要不要分几次发、对方连打三行算几个回合、她此刻什么心情、要不要主动开口、消息之间隔了多久。这些都得由外面补上 —— 本插件补的就是这一整套：

能力	现状
沉默协议（`[[silent]]`）	由 `guard` 拦下
括号旁白剥离	由 `guard` 剥掉
出站分段（一条长回复分几次发）	由 `rhythm` 完成
入站合并（连打三行算一个回合）	由 `rhythm` 完成
情绪 / 主动发言 / 风格学习	由 `persona` 提供
10 条行为规则	由 `prompt` 每轮注入
会话换代防护	`adopt` 模块
时间戳与间隔（`time=`/`gap=`）	`stamp` 模块

为什么不手改 node_modules：把那批约定直接写进 node_modules 里，dsh-onebot-qq 一升级（pnpm 换目录）就会整个被冲掉，同样的坑会再踩一遍。所以本插件一行都不改 node_modules，只从外面给原型挂包装 —— 升级不会再把功能冲掉。

为什么是一个插件而不是四个

这四个能力最初被拆成 guard / prompt / rhythm / persona 四个独立包。合并的理由很实在：

四份代码里重复的东西太多 —— resolveProfileDirs()（探测 profile 目录）逐字重复两份、 patchMethod() 两份、HTTP 观测面三份、loopback 判定三份、状态落盘两份。
四个包各自 import() 同一个 dsh-onebot-qq，各自起一个 3 秒扫描定时器，各自维护一份统计。
用户只装一个、只配一块，比装四个再对着四份文档调参好得多。

合并后：一个包、一份配置、一个 HTTP 面，内部按职责分成七个模块，各自可独立开关。

它做什么

模块	干什么	挂在哪
`guard`	出站闸：拦 `[[silent]]`、剥整行括号旁白、吞「⏳ 排队提示」；整条为空就不发	`OutboundPipeline.prototype.sendToChat` / `sendMsg`
`adopt`	会话换代防护：裸 id 还有磁盘日志时接管（resume）而不是把它永久退休、另开一个新会话	`ChatRegistry.prototype.createChat`
`stamp`	给注入边界补回 `time="..."`（本条消息的时刻）与 `gap="..."`（距上一条的间隔，如 `3m47s`），让模型不必自己做时间戳减法	`ChatBridge.prototype.handleInbound`（记账）+ `ChatBridge.prototype.dispatchFollowup`（注入）
`prompt`	每轮注入 10 条行为规则 + 情绪行 + 风格行	宿主 `agent/pre-step`（不挂原型）
`rhythm`	入站合并（连打三行 = 一个回合）+ 出站分段（一条长回复分几次发）	`ChatBridge.prototype.dispatchFollowup` / `sendToChat`
`persona`	情绪四变量 + 随机主动发言 + 风格学习	`ChatBridge.prototype.handleInbound` / `onSessionEvent`
`voice`	`qq_say` 工具：文字 → edge-tts 合成 → 作为 QQ 语音发出	只注册工具，不挂原型

七个模块中有五个挂在原型上，且存在共享挂载点（dispatchFollowup 上是 stamp + rhythm， handleInbound 上是 stamp + persona）。它们靠 core/patch.js 的模块身份标记共存、互不吞并，链上的先后由模块优先级唯一决定，与挂载时序无关。

`adopt` 修的是什么

dsh-onebot-qq 原生的 createChat 里有这么一段：

let sessionId = makeSessionId(sessionIdForChat(chatId));
if (this.isSessionIdBlocked(sessionId)) {
    sessionId = this.freshSessionId(chatId);
}
else if (await this.hasPersistedLog(sessionId)) {
    this.retireSession(sessionId);          // ← 永久退休，写进 retired-sessions.json
    sessionId = this.freshSessionId(chatId);
}

裸 id（如 onebot-group-535746440）在磁盘上还有历史日志时，它不接管，而是把裸 id 永久退休、换一个带时间戳后缀的新 id。retireSession 是永久的，此后每次 createChat 都从第一个分支掉进 freshSessionId —— 表现就是每条消息开一个新会话，上下文全丢。

关键区别：只有 agents.create() 会和已存在的日志撞车；agents.resume() 正是「接管这份日志」的那个调用。 所以本模块从外面包住 createChat，在进入原方法之前先做决定。三种情况明确放行给原方法：① evictedChats 里有这个 chat（快照 id 比裸 id 更权威） ② 裸 id 已被退休（尊重记录）③ 裸 id 没有持久化日志（没有可接管的）。

会话 id 的推导直接用上游自己的 chat.js#sessionIdForChat，不在本模块里复刻那个正则 —— 抄一份就等于埋「上游改了规则而我们还按老规则算 id」的坑，算错 id 的后果是「采纳一个不存在的会话」，比不采纳更糟。拿不到该函数时直接放弃挂载，不退化成猜。

`stamp` 修的是什么

上游的 <user_message ...> 边界上一点时间信息都没有。lib/chat.js 两个构造器都是 3 参，签名里没有时刻：

export function wrapUserMessage(content, userId, nickname) { … }            // lib/chat.js:133
export function buildGroupMessagePrefix(nickname, userId, mentioned) { … }  // lib/chat.js:109

lib/inbound.js 的 normalizeOneBot11(event) 返回的对象里同样没有 time 字段 —— 它把 event.time 丢掉了。所以模型看到的每条消息都是「刚才」，两个时间戳都没有。

为什么需要：模型不会可靠地做两个时间戳的减法，很容易把「隔了两小时」说成「过了一整天」。这正是加这两个属性的全部动机 —— 把已经算好的间隔直接递过去，等于把那道算术从模型手里拿走，让它没有算术可做错。

本模块往开标签上补回两个属性：

time="2026-10-08T15:15:23+08:00" —— 对方按下发送的时刻（本地时区、带秒；保留秒是为了同一分钟内的两条也能排序、能被可靠相减）。
gap="3m47s" —— 距他上一条消息隔了多久，已经算好。写法是紧凑、不含空格、最多两个最高整单位的时长：47s / 3m47s / 15h35m / 2d4h。不含空格是为了原样穿过下面那道字符白名单，短到一眼能读完。

首次没有基线时 gap 留空，不猜 —— 省略属性好过印一个模型会当真的间隔。跨宿主重启的「上一条入站时刻」因此要落盘（stamp-state.json，与 mood-state.json / style-state.json 同目录同范式，debounce 3 秒原子替换）。不落盘的话，重启后基线就是空的，第一条只能省略 gap，模型随即去读周期旁白里的 Elapsed 行，又把「两小时」说成「过了一整天」。基线表最多 500 个 chat（沿用同一套 MAX_CHATS），超出时按「最久没来消息」淘汰 —— 没有这道闸，那张表会随这辈子收过消息的 chat 数单调增长。

字符白名单：两个值都用正则洗过 —— 时间戳只留数字与 T:+- （replace(/[^0-9T:+-]/g, '')），间隔只留数字与 dhms （replace(/[^0-9dhms]/g, '')）。保证这两个值永远不可能闭合标签、也永远不可能从 <user_message> 边界里逃出去。文本改写只动开标签，块内内容一字不碰；同名属性先摘掉再写，重复注入 / 热重载重入都不会堆出两个 time=。

为什么挂两个点：职责不同，两张表语义也必须分开。

挂载点	干什么	记的什么
`ChatBridge.prototype.handleInbound`	记账：把 OneBot 事件的 `time`（unix 秒）连同它属于哪个 chat 记下来	`seenAt`：每次入站都覆盖，含后来被门禁吞掉的未 @ 消息、去重、限流、命令 —— 只回答「这个 chat 最近一次入站是什么时候」
`ChatBridge.prototype.dispatchFollowup`	注入：把属性写进交给模型的文本	`baseline`：注入成功后才写，是 `gap` 的基线 —— 只对真正到达模型的消息推进，命令回执之类的投递不污染它

dispatchFollowup 已被 rhythm 挂着（入站合并）。core/patch.js 的语义是后挂的在外层，所以本模块必须排在 scanAll() 里 rhythm 之后：这样每条消息各自单独经过本模块（各自注入自己那一刻的 time/gap），再由 rhythm 把已注入的几条合并成一批。换过来（本模块在内层）只会在合并后拿到一整批文本，只能贴一个时间。

chatId 的推导直接用上游自己的 chat.js#buildChatId，不复刻那个拼法 —— 抄一份就是埋「上游改了规则而我们还按老规则算」的坑，算错的后果是把时刻记到别的 chat 名下。拿不到该函数时直接放弃挂载，不退化成猜。入站时刻还要求像样（2001–2286 年的 unix 秒），坏值退回当前时刻 —— 一个坏值绝不该给消息盖上胡说八道的钟。

已知未补回的一处：群消息前缀 [HH:MM 昵称(QQ)] 不受本模块影响 —— 它用的是处理时刻，与 time 属性只差几秒，而改写群前缀要啃昵称里的方括号，不划算。

10 条行为规则

id	规则	默认
`silent`	沉默就用 `[[silent]]`，不许用文字或括号表示沉默	开
`aside`	正文只写要说的话，旁白整行括号、且注明「说给对方」	开
`image`	图片可主动发（`qq_send_image`），但严禁编造本地路径	开
`quarrel`	群里有人争执/对线时默认不接，被 @ 也可沉默	开
`face`	表情善用但别滥用，别拿表情代替说话	开
`tone`	短句口语、别写文档、绝不暴露运行状态；含真人统计刻度（中位 6 字 / 九成 ≤20 字）与「想说的多就分几条发」	开
`voice`	话一长就用 `qq_say` 说出来，但别滥用	开
`time`	心里有时间数，但不报时间、更不编造隔了多久	开
`channel`	分得清私聊/群聊与发言人，别把 A 的话当 B 说的	开
`batch`	对方连着发的几句合起来一起回，别一句回一次	开

silent 这条是与 guard 模块的契约：规则层明令禁止用括号表达沉默，只许用 [[silent]] 一个写法，这样 guard 的判别器才能 100% 命中且不留残余。改这条措辞前请先同步 guard 的判别逻辑。

节奏参数

方向	行为	默认
入站	一个 chat 连发的消息攒进安静窗口，合成一个回合	私聊 8s / 群聊 3s
入站	被 @ 立刻穿透窗口	开
入站	攒批硬上限	30s
出站	模型最终回复切成几条短消息，带打字间隔发出	≤20 字/条，≤6 条
出站	分条期间脉冲「正在输入」（仅私聊）	开

人设四变量

变量	管什么	时间尺度	初始
`mood`	此刻的感觉（8 态）	分钟级	`calm`
`energy`	此刻的电量	小时级	80
`affinity`	关系有多深	天级	20
`warmth`	当下多来劲、话多不多	小时级	50

主动发言没有 cron：只有两处随机 —— 下一次评估的间隔是区间随机的，评估时每个候选 chat 各掷一次概率门。默认只对私聊主动（群里主动开口是打扰所有人）。

语音（`qq_say`）

对应需求：「能不能回复我也尽量用一句话（尽量20字内），跟群聊一样，长的就发语音」+ 「语音声音能改吗？改成熟点」。

提供 qq_say 工具：给一段文字，插件用 edge-tts 合成 mp3，再作为 QQ 语音消息发出去。配合 voice 这条规则，长内容她会用说的。

为什么不做成「超长自动转语音」：哪些话适合说、哪些适合打字是聊天判断的一部分（一句吐槽用念的很怪）。自动替换会抢走这个判断，所以只提供能力 + 讲清何时用。

音色可选（默认 zh-CN-XiaoxiaoNeural 晓晓，成熟取向）：

音色 id	名字	风格
`zh-CN-XiaoxiaoNeural`	晓晓	成熟温柔（默认）
`zh-CN-XiaoyiNeural`	晓伊	活泼少女
`zh-CN-liaoning-XiaobeiNeural`	晓北	东北口音，直爽
`zh-CN-shaanxi-XiaoniNeural`	晓妮	陕西口音，爽利
`zh-CN-YunxiNeural`	云希	清朗少年
`zh-CN-YunyangNeural`	云扬	沉稳播音腔
`zh-CN-YunjianNeural`	云健	浑厚有力

依赖（需要你自行安装）：一个装了 edge-tts 的 Python —— pip install edge-tts。插件本体不额外引入 Node 依赖，也不下载任何东西；qq_say 起的 Python 进程读的是你本机已装好的 edge-tts。

语音的三点机制

合成端点替换：edge-tts 默认走 speech.platform.bing.com，而该 host 在很多地区对合成 WebSocket 直接回 403（上游 issue rany2/edge-tts#490）。现行做法见 PR #491：改用 api.msedgeservices.com/tts/cognitiveservices/websocket/v1，且 token 要作为 Ocp-Apim-Subscription-Key 查询参数传入（不是旧的 TrustedClientToken）。插件用运行时 shim（内联 python -c）完成替换，不改 site-packages —— pip 升级会覆盖回去，与 node_modules 同一个坑。shim 带幂等保护：上游发版后旧 host 消失，替换自动跳过。两处都要改：constants.WSS_URL 与 communicate.py 里 from .constants import (... WSS_URL ...) 绑定的模块级常量 —— 只改前者无效。
退避重试：语音服务有瞬时抖动，插件内置退避重试（默认 3 次，基数 800ms）。语音是用户直接看到的东西，失败一次就是「她突然说不出话」，重试比报错友好。
剥代理变量：edge-tts 直连微软，而宿主环境常带 HTTP(S)_PROXY（给 LLM 上游用）。插件从子进程环境里删掉这六个键（HTTP_PROXY / HTTPS_PROXY / ALL_PROXY 及其小写）。剥掉没有副作用，作为防御保留。

环境要求

DSH（DeepSeek Harness）宿主，已装并启用 dsh-onebot-qq（目标包，默认按 0.9.x 的内部结构挂载）。
Node.js ≥ 22。
本插件不额外依赖任何第三方包 —— 全部用 Node 内置模块。
用语音功能需要自行 pip install edge-tts（见上）。

安装

1. 放进插件目录

git clone https://github.com/xfgil/dsh-onebot-companion.git D:\path\to\plugins\dsh-onebot-companion

（任何目录都行，下称 <插件目录>。）

2. 在 profile 里注册

编辑 <DSH_HOME>\profiles\<profile>\package.json，加两处：

{
  "dependencies": {
    "dsh-onebot-companion": "link:D:/path/to/plugins/dsh-onebot-companion"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-onebot-companion"   // ← 加进 bundles，bundle 会自注册
      ]
    }
  }
}

本插件自带 cordis.patch.yml（dsh.bundle.patch 指向它），bundle 自注册—— 不要再往 profile 的 cordis.patch.yml 里手写 insert，重复 insert 会起两个实例。

3. 建链接并让宿主加载

cd <DSH_HOME>\profiles\<profile>
pnpm install

⚠️ 顺序很重要：先建 node_modules 链接，再改 profile 清单。 宿主的热更新 refresh(manifestOnly) 里有一行短路：
if (manifestOnly && bundles === lastBundles) return;   // 清单没变就直接返回
如果先改清单、后建链接，那次 reconcile 解析不到包就跳过了，而 lastBundles 已经被更新 —— 之后再怎么改 package.json 都被这行短路，永不重试。表现是：插件管理页显示 enabled: true，但那一行没有 entryId，功能完全不生效。

补救：在插件管理页把它关掉再打开（让清单内容真的变一次），即可绕过短路。

改完不用重启宿主：宿主的热更新会重新加载。若你装了 dsh-hot-reloader，它也会自动跟进。

4. 确认它在跑

curl.exe http://127.0.0.1:<端口>/onebot-companion

或者直接看状态文件有没有落盘：

Get-Content "$env:USERPROFILE\.dsh\onebot-companion\state.json"

配置

配置写在 profile 的 bundle 配置段里（宿主会把它透传给 apply(ctx, config)）。 本插件刻意不导出 Config schema —— profile 侧解析不到宿主的 schemastery，导出非 schema 对象会让 loader 投影 config 时报错。

dsh-onebot-companion:
  enabled: true
  packageName: dsh-onebot-qq     # 要挂的 QQ 通道插件
  profileDir: ''                 # 留空则多路自动探测
  pollMs: 3000                   # 补挂扫描周期；目标包被升级换目录后靠它自愈
  stateFile: ''                  # 留空用 $DSH_HOME/onebot-companion/state.json

  guard:
    enabled: true
    stripAside: true             # 是否连「整行一对括号」的旁白一起剥
    muteQueueNotice: true        # 吞掉 dsh-onebot-qq 的「⏳ 当前任务运行中」排队提示
    logHits: true

  adopt:
    enabled: true
    logAdoptions: true           # 每次接管既有会话时记一条 info 日志

  stamp:
    enabled: true
    injectTime: true             # 注入 time=（对方按下发送的时刻）；关掉只留 gap
    injectGap: true              # 注入 gap=（距上一条已算好的间隔）
    logStamps: false             # 每次注入都记一条 info（排查用，平时太吵）

  prompt:
    enabled: true
    rules: {}                    # 按 id 单独开关，如 { quarrel: false }；缺省全开
    firstStepOnly: true          # 仅第一步注入（推荐）；关掉会撑大上下文
    sourceName: onebot-prompt

  rhythm:
    enabled: true
    inbound:
      enabled: true
      quietMs: 8000              # 私聊安静窗口
      groupQuietMs: 3000         # 群聊安静窗口
      maxWaitMs: 30000           # 攒批硬上限
      mentionPierces: true       # 被 @ 立刻穿透
    burst:
      enabled: true
      maxChars: 20               # 每条消息字数预算（对齐真人：中位 6 字、九成 ≤20）
      maxChunks: 6               # 一次回复最多几条（尾巴折叠进最后一条）
      delayMs: 300               # 分条基础停顿
      perCharMs: 45              # 按上一条字数折算的打字时间
    typing: true

  persona:
    enabled: true
    mediaDir: ''                 # 情绪/风格状态目录；留空从 bridge 配置取
    moodEnabled: true
    styleEnabled: true
    proactiveEnabled: true
    moodDriftMinutes: 20
    energyDecayPerHour: 7
    nightRecoveryPerHour: 14
    nightStartHour: 0
    nightEndHour: 8
    affinityDecayPerHour: 0.8
    affinityGraceHours: 6
    warmthBaseline: 30
    warmthRegressPerHour: 10
    warmthJitter: 8
    proactiveChance: 0.45
    proactiveMinMinutes: 25
    proactiveMaxMinutes: 150
    proactiveIdleMinutes: 20
    proactiveMaxPerDay: 6
    proactiveQuietStart: 1
    proactiveQuietEnd: 8
    # 「主动只对我，我才是管理员」——allowAllUsers: true 时陌生人也能私聊，
    # 不设白名单她就会去主动搭话陌生人。写纯 QQ 号或完整 chatId 都认。
    proactiveOnlyChats: []

  voice:
    enabled: true
    program: python              # 装了 edge-tts 的解释器（可写绝对路径）
    voice: zh-CN-XiaoxiaoNeural  # 音色，见上表
    rate: -5%                    # 语速（edge-tts 语法）
    pitch: -10Hz                 # 音调
    maxChars: 120                # 每次最多念多少字
    timeoutMs: 45000
    retries: 3                   # 偶发失败重试次数（含首次）
    retryDelayMs: 800            # 重试退避基数
    mediaDir: ''                 # 语音文件目录；留空用 config.mediaDir

packageName / profileDir 会自动下发到七个模块段，不需要在每个段里重复写。

状态文件放在哪

文件	内容	位置
`state.json`	本插件运行态（挂了哪些闸、扫了几次、命中多少）	`$DSH_HOME/onebot-companion/`
`mood-state.json`	情绪四变量（每 chat 一条）	`config.persona.mediaDir`
`style-state.json`	风格画像（每 chat 一条）	`config.persona.mediaDir`
`stamp-state.json`	`gap` 基线（每 chat 一条「上一条已注入消息的时刻」，最多 500 条，超出淘汰最久没来消息的）	bridge 运行时配置的 `mediaDir`
`media_*.mp3`	`qq_say` 合成的语音	`config.voice.mediaDir`

情绪与风格刻意不放在 state.json 里：mediaDir 是那批历史数据本来的家，换插件/重写插件都能继承，亲密度和风格画像攒了几天的东西不该因为换插件清零。

HTTP 观测面

全部 loopback only（非 127.0.0.1 一律 403）。

方法	路径	作用
GET	`/onebot-companion`	总状态：配置、统计、七个模块挂载情况
GET	`/onebot-companion/hits?limit=`	最近 200 条 guard 命中（原文 + 清理后文本；含 `blocked` / `stripped` / `muted` 三类）
GET	`/onebot-companion/mood`	情绪快照（每 chat）
GET	`/onebot-companion/style`	风格画像快照（每 chat）
GET	`/onebot-companion/voice`	语音配置、可用音色表、上次失败原因
POST	`/onebot-companion/toggle`	`{"enabled": bool}` 总开关
POST	`/onebot-companion/module`	`{"module":"guard\|adopt\|prompt\|rhythm\|stamp\|persona\|voice","enabled":bool}`
POST	`/onebot-companion/rule`	`{"id":"silent","enabled":false}` 单条规则开关
POST	`/onebot-companion/rescan`	立刻补挂一次
POST	`/onebot-companion/selftest`	跑 guard 自测（喂真实文本看会怎么处理）
POST	`/onebot-companion/selftest-adopt`	跑 adopt 自测（不碰真 registry，9 条用例）
POST	`/onebot-companion/selftest-stamp`	跑 stamp 自测（格式/白名单/注入的纯函数用例 + 「记账 → 注入 → 基线推进」整条链，全在假 proto 上跑，不碰真 bridge）
POST	`/onebot-companion/burst`	`{"text":"…","maxChars":20}` 看分段结果
POST	`/onebot-companion/seed-style`	`{"chatId":"private:745516569","profile":{…}}` 灌离线画像（只收统计，不收原话）
POST	`/onebot-companion/unarchive`	`{"sessionId":"onebot-group-…"}` 取消会话归档；不传 `sessionId` 则释放全部 `onebot-*` 归档会话
POST	`/onebot-companion/say`	`{"text":"…"}` 试合成语音（只落盘，不发送）
POST	`/onebot-companion/reset-hits`	清空命中记录与计数

工作原理

挂载：运行时包装原型，不落盘

core/patch.js 用 pathToFileURL() 定位目标类的绝对路径并 import()，然后包装原型方法。为什么不用 require.resolve('dsh-onebot-qq/lib/outbound.js')：

Package subpath './lib/outbound.js' is not defined by "exports"

上游 exports 字段没暴露子路径，所以直接拼绝对路径更省事。

模块同一性（这是整套做法的前提）：pathToFileURL 规范化后的 URL import() 回来的命名空间对象，与宿主正在实例化的那一个是同一个 —— 因为 ESM 模块缓存按解析后的 URL 命中。包装原型方法因此能影响宿主真实的实例。

升级抗性

包装发生在运行时，不落地任何文件。pnpm 下次把 lib/*.js 覆盖回原版，只是让闸消失而已 —— 插件的 pollMs 扫描（默认 3 秒）会重新 import() 并检查原型上还有没有本模块的标记，没有就补挂。目标包被升级换目录也不会失效。

脱链语义：多个模块互不吞并

同一个原型方法可能被多个模块包装（例如 sendToChat 同时被 guard 和 rhythm 关注）。朴素的 unwrap() 会剥到链底，把别的模块的包装一起丢掉。core/patch.js 因此给每个包装打上 Symbol.for 模块标记，脱链时只剥自己那一层：

// 只脱本模块的层，链上其他模块的包装原样保留

同时它保留 originalOf()（取链底原方法）给需要「绕过所有包装直接发」的路径用。

失败降级

guard 清洗异常 → 按原文放行。一个守卫把用户消息吃掉，比漏一条标记严重得多。
入站合并异常 → 按原文直投（原方法照常调用）。
出站分段异常 → 按原文整条发；分条中途失败 → 剩余内容合并补发。
情绪/风格记录异常 → 只记 lastError，绝不影响消息投递。
时刻记账异常 → 入站流程一字不改（记账失败只是少了间隔）；时刻注入异常 → 按原文投递，一个字都不能丢。
所有计时器 unref()，停着的批绝不把宿主进程钉住。

已知边界

挂载点绑定 0.9.x 的内部结构。 上游若改名 sendToChat / sendMsg / dispatchFollowup / handleInbound / onSessionEvent，对应模块会静默失效。 pollMs 扫描会把丢失记进 lost，但不会自动适配。
吞「⏳ 排队提示」会让对方收不到任何回执。 长任务期间对方连发几条消息，聊天里就是一片安静、没有任何「已收到、排队中」的反馈 —— 这正是 guard.muteQueueNotice（默认开启）的代价。想恢复原提示把它设为 false 即可。
agent/pre-step 每轮多一条消息。 这是实打实的 token 成本，长聊场景按天算可观。所以 prompt.firstStepOnly 默认为 true（只在每轮第一步注入一次）。
提示词层压不过历史惯性。 如果会话历史里已经堆了几百条 [[silent]] 示范，注入一句新规则未必压得过；guard 的硬拦才是主防线，提示词层是辅助。
合并器只在 dispatchFollowup 这一层工作。 插话（steer）与语音转写走另一条路径，不经过合并器 —— 这是刻意的，插话本来就该立刻生效。
分条会改变消息计数。 依赖「一条回复 = 一条消息」的下游逻辑会看到多条。
分条只在标点与英文空格处断。 优先切在句末（。！？…），超长句退到逗号、顿号、分号；中文正文里的空格不算断点 —— 「攒了 100 多块」「7 月到 10 月」这种排版空格两侧都是汉字或数字，在那儿切会把词劈成两半。英文句子不受影响，照旧能在空格处断。
文字图卡片不分条：textImageThreshold 生效时整条走卡片，卡片本来就是一条。
主动发言是拉取式的：宿主没给插件「替某个空闲会话发起一轮」的公开接口，调度器只在有活跃 chat 表时才工作。
情绪变量按时间积分，落盘值会有 IEEE-754 浮点尾差（56 可能是 55.99999722222222）。这是正常的，不是 bug。
语音依赖外部服务：qq_say 起 Python + edge-tts，连的是微软一个非官方端点，而且该端点已经变过一次（见语音章节）。它坏掉时 qq_say 只返回一个普通错误、不影响别的功能，/voice 端点会显示上次失败原因。
每次合成都起一个 Python 进程（几百毫秒 + 网络）。调用是串行的，所以连着几次 qq_say 会排队而不是并发。
本插件为自用工具，不保证与其他第三方 OneBot 实现的兼容性。

License

自用插件，按「够用就好」的标准写。生产环境请自行评估。

dsh-onebot-companion

Introduction

dsh-onebot-companion

目录

为什么需要它

为什么是一个插件而不是四个

它做什么

adopt 修的是什么

stamp 修的是什么

10 条行为规则

节奏参数

人设四变量

语音（qq_say）

语音的三点机制

环境要求

安装

1. 放进插件目录

2. 在 profile 里注册

3. 建链接并让宿主加载

4. 确认它在跑

配置

状态文件放在哪

HTTP 观测面

工作原理

挂载：运行时包装原型，不落盘

升级抗性

脱链语义：多个模块互不吞并

失败降级

已知边界

License

`adopt` 修的是什么

`stamp` 修的是什么

语音（`qq_say`）