dsh-qqchat 0.2.6 → 0.2.7

package/README.en.md

@@ -7,7 +7,7 @@
 <p>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/DSH-0.1.6--alpha.1-6f42c1.svg" alt="DSH 0.1.6-alpha.1">
-  <img src="https://img.shields.io/badge/QQChat-0.2.6-2ea44f.svg" alt="QQChat 0.2.6">
+  <img src="https://img.shields.io/badge/QQChat-0.2.7-2ea44f.svg" alt="QQChat 0.2.7">
   <img src="https://img.shields.io/badge/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -36,8 +36,8 @@
 | QR connection | Binds an official QQ Bot from **Settings -> QQ Chat** | Cancel the binding and scan again when needed |
 | Manual connection | Connects with AppID and AppSecret from the settings page | Useful for headless servers or QR failures; the secret is sent only to the Host |
 | Group receive modes | Auto reply, Mention only or Silent record | Silent record stores messages without waking the Agent |
-| Message formats | Smart, Markdown or Plain compatibility | Group and direct-chat formats are configured separately; groups default to Plain compatibility |
-| Direct-chat streaming | Optionally uses QQ's official streaming message API for private chats | Private chats only; Plain compatibility disables it automatically; some clients may not display streaming |
+| Message formats | Markdown or Plain compatibility | Group and direct-chat formats are configured separately; groups default to Plain compatibility |
+| Direct-chat streaming | Markdown format automatically uses QQ's official streaming message API | Plain compatibility uses a regular send; some clients may not display streaming |
 | Quotes and mentions | Preserves quoted messages and resolves QQ mentions to display names | Stable IDs remain in metadata |
 | Memory system | Stores group, member and direct-user memory; user memory can be reused across groups under the same Bot | Group relationships and group events stay scoped; can be disabled |
 | Memory reflection | Converts recent daily notes into long-term memory | Runs asynchronously after idle or batch thresholds |
@@ -146,7 +146,7 @@ Configure **Settings -> QQ Chat -> Message reception**:
 | Mention only | All messages are stored, but only messages mentioning the Bot trigger a reply |
 | Silent record | Stores messages and memory without actively replying |
 
-Groups default to Plain compatibility format. Group and direct-chat formats can be selected independently. Plain compatibility for direct chats automatically disables streaming.
+Groups default to Plain compatibility format. Group and direct-chat formats can be selected independently between Markdown and Plain compatibility. Markdown direct chats stream by default; Plain compatibility uses a regular send. There is no separate streaming toggle.
 
 ## Commands
 

package/README.md

@@ -7,7 +7,7 @@
 <p>
   <a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License"></a>
   <img src="https://img.shields.io/badge/DSH-0.1.6--alpha.1-6f42c1.svg" alt="DSH 0.1.6-alpha.1">
-  <img src="https://img.shields.io/badge/QQChat-0.2.6-2ea44f.svg" alt="QQChat 0.2.6">
+  <img src="https://img.shields.io/badge/QQChat-0.2.7-2ea44f.svg" alt="QQChat 0.2.7">
   <img src="https://img.shields.io/badge/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -34,8 +34,8 @@
 | 手动连接 | 在设置页填写 AppID 和 AppSecret 连接 QQ Bot | 适合无手机、服务器或扫码失败场景；密钥只提交到 Host |
 | 断线重连 | QQ Gateway 断线后自动恢复连接 | 无需重复扫码 |
 | 群聊回复模式 | 自动回应、@回复、静默记录 | 可在设置页随时切换 |
-| 消息格式兼容 | 智能兼容、Markdown、纯文本兼容 | 可兼容旧版本QQ的群友们！ |
-| 私聊流式回复 | 私聊可选用 QQ 官方流式消息接口逐步更新回复 | 仅适用于私聊；纯文本兼容模式自动关闭；部分客户端可能不可见 |
+| 消息格式 | Markdown、纯文本兼容 | 群聊与私聊可分别设置；群聊默认纯文本兼容 |
+| 私聊流式回复 | Markdown 格式自动使用 QQ 官方流式接口 | 纯文本兼容格式使用普通发送；部分客户端可能不可见 |
 | 消息引用与 @ | 支持引用消息和 QQ @消息 | @用户优先显示用户名 |
 | 会话隔离 | QQ 群聊和私聊分别使用独立会话 | 不同群、不同用户的上下文互相隔离 |
 | 记忆系统 | 保存群聊、群成员和私聊用户的独立记忆；同一 Bot 下的用户记忆支持跨群复用 | 群关系和群级事件不会跨群共享；设置中可关闭 |
@@ -121,7 +121,7 @@ npx @deepseek-ai/dsh --profile qqchat
 | @回复 | 所有消息都会记录，但只有 @Bot 的消息会触发回复 |
 | 静默记录 | 只保存消息和记忆，不主动回复 |
 
-群聊默认使用纯文本兼容格式，适合不同 QQ 客户端。私聊和群聊可以分别选择智能兼容、Markdown 或纯文本兼容。私聊使用纯文本兼容时会自动关闭流式传输。
+群聊默认使用纯文本兼容格式，适合不同 QQ 客户端。私聊和群聊可以分别选择 Markdown 或纯文本兼容。私聊选择 Markdown 时默认使用 QQ 官方流式传输；选择纯文本兼容时使用普通发送，不再提供单独的流式开关。
 
 ## 命令
 

package/client-src/settings.cts

@@ -116,8 +116,8 @@ export function QQSettings({ rpc }: { rpc: Rpc }) {
     align: 'end',
     items: [{ id: '', label: '不设置 Owner' }, ...members.map(member => ({ id: member.platformUserId, label: member.displayName || 'QQ 群友' }))],
   })
-  const formatLabel = (value: ReplyFormat | undefined) => value === 'markdown' ? 'Markdown' : value === 'compat' ? '纯文本兼容' : '智能兼容'
-  const formatItems = [{ id: 'smart', label: '智能兼容' }, { id: 'markdown', label: 'Markdown' }, { id: 'compat', label: '纯文本兼容' }]
+  const formatLabel = (value: ReplyFormat | undefined) => value === 'compat' ? '纯文本兼容' : 'Markdown'
+  const formatItems = [{ id: 'markdown', label: 'Markdown' }, { id: 'compat', label: '纯文本兼容' }]
   const groupReplyPicker = h(Menu, {
     open: groupReplyMenuOpen,
     onClose: () => setGroupReplyMenuOpen(false),
@@ -195,23 +195,10 @@ export function QQSettings({ rpc }: { rpc: Rpc }) {
       h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), h('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')),
       h('div', { className: 'qqControl' }, groupReplyPicker)),
     h('div', { className: 'qqSetting' },
-      h('div', null, h('div', { className: 'qqSettingTitle' }, '私聊消息兼容格式'), h('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 私聊时使用的消息格式。')),
-      h('div', { className: 'qqControl' }, directReplyPicker)),
-    h('div', { className: 'qqSetting' },
-      h('label', { className: 'qqCheckRow' },
-        h('input', {
-          type: 'checkbox',
-          checked: settings.directStreamingEnabled && settings.directReplyFormat !== 'compat',
-          disabled: settings.directReplyFormat === 'compat',
-          onChange: (event: import('react').ChangeEvent<HTMLInputElement>) => void patch({ directStreamingEnabled: event.target.checked }),
-        }),
-        h('span', null,
-          h('div', { className: 'qqSettingTitle' }, '私聊流式回复'),
-          h('div', { className: 'qqSettingHelp' }, settings.directReplyFormat === 'compat'
-            ? '纯文本兼容模式不支持流式传输，已自动关闭。'
-            : settings.directStreamingEnabled
-            ? '使用 QQ 官方流式接口逐步更新私聊回复；部分 QQ 客户端可能看不到流式效果。'
-            : '使用普通一次性消息发送，兼容性更好。'))))
+      h('div', null, h('div', { className: 'qqSettingTitle' }, '私聊消息格式'), h('div', { className: 'qqSettingHelp' }, settings.directReplyFormat === 'markdown'
+        ? 'Markdown 格式默认使用 QQ 官方流式接口逐步更新回复；部分客户端可能看不到流式效果。'
+        : '纯文本兼容格式使用普通发送，不启用流式传输。')),
+      h('div', { className: 'qqControl' }, directReplyPicker))
   )
   const memoryGroup = h('div', { className: 'qqSettingsGroup' },
     h('h3', null, '记忆系统'),

package/client-src/shared.cts

@@ -18,7 +18,7 @@ export function getQQRpc(): Rpc | undefined { return qqRpc }
 
 export type ChatType = 'c2c' | 'group'
 export type GroupReceiveMode = 'auto' | 'mention' | 'silent'
-export type ReplyFormat = 'smart' | 'markdown' | 'compat'
+export type ReplyFormat = 'markdown' | 'compat'
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
 export type RpcResult<T> = { ok: true; value: T } | { ok: false; error?: { message?: string } }
 export interface Rpc { call(channel: string, endpoint: string, payload: unknown): Promise<RpcResult<unknown>> }
@@ -38,7 +38,7 @@ export interface Ctx {
   slots: SlotRegistry
 }
 export interface Account { id: number; appId: string; enabled: boolean; gatewayStatus: string; gatewayLastError?: string | null }
-export interface Settings { memoryEnabled: boolean; memoryMemberBatchEnabled: boolean; groupReceiveMode: GroupReceiveMode; groupReplyFormat: ReplyFormat; directReplyFormat: ReplyFormat; directStreamingEnabled: boolean; groupMembersCanUseTools: boolean; groupMembersCanReceiveMedia: boolean; groupMembersCanReadMedia: boolean; ownerUserId: string }
+export interface Settings { memoryEnabled: boolean; memoryMemberBatchEnabled: boolean; groupReceiveMode: GroupReceiveMode; groupReplyFormat: ReplyFormat; directReplyFormat: ReplyFormat; groupMembersCanUseTools: boolean; groupMembersCanReceiveMedia: boolean; groupMembersCanReadMedia: boolean; ownerUserId: string }
 export interface KnownMember { id: number; platformUserId: string; displayName: string; lastSeenAt: number }
 export interface ChatItem { chatType: ChatType; rowId: number; platformId: string; displayName: string; dshSessionId: string | null; lastMessageAt: number | null; messageCount: number }
 export interface Memory { profile: string; summary: string; daily: string; memory: string; pattern: string }

package/cordis.patch.yml

@@ -6,7 +6,6 @@
       config:
         dataDir: !!js dshHomePath('plugins/dsh-qqchat')
 
-# DSH 0.1.6's Connection RPC registry owns route lifetimes on the
-# connection fiber, so that fiber must also receive the Web server service.
+# Connection RPC 需要 Web 启动配置和 Web Server 来配置 trusted hosts、注册 Host routes。
 - id: connection
-  inject: [webRuntime, webServer]
+  inject: [webStartup, webServer]

package/docs/DEVELOPMENT.md

@@ -33,7 +33,7 @@ QQChat 是 TypeScript 插件，Host 和 Client 一起构建。日常开发不需
 | 群友静默记录、未 @ 消息展示 | 无 QQ 自定义展示事件 | 使用插件 Client 渲染 `qqchat/message`；不送入模型 |
 | 图片输入 | 取决于当前 DSH 模型路由和附件服务 | 使用 DSH 原生图片块；不支持视觉时使用稳定文本降级和读取工具 |
 | 音频、视频和普通文件 | DSH 不提供统一的 QQ 媒体理解能力 | 保存附件并提供类型提示、文件工具或媒体信息工具 |
-| QQ 私聊流式回复 | DSH 不负责 QQ Gateway 流式协议 | 插件调用 QQ 官方接口；失败时回退普通发送，纯文本兼容模式自动关闭 |
+| QQ 私聊流式回复 | DSH 不负责 QQ Gateway 流式协议 | Markdown 格式自动使用 QQ 官方流式接口；纯文本兼容格式使用普通发送；失败时按已发送帧安全回退 |
 | QQ 引用、@和气泡 | DSH 不认识 QQ 协议字段 | 插件把引用和 @ 转为可读文本/元数据，并由 Client 做展示 |
 | DSH 原生命令 | DSH 只处理 DSH Web 自己收到的命令 | 插件将 `/qq...` 命令解析后转交或执行，避免与 DSH 原命令冲突 |
 

package/docs/STREAMING.md

@@ -207,25 +207,15 @@ abort()
 | 已成功发送部分流式内容 | 不发送完整普通消息，避免用户收到重复回复 |
 | DONE 帧失败但已有内容 | 记录错误，不重复发送全文 |
 | 模型没有文本输出 | 不创建流，沿用插件已有的空回复处理 |
-| 设置关闭 | 完全跳过流式接口，直接使用普通发送 |
+| 纯文本兼容格式 | 完全跳过流式接口，直接使用普通发送 |
 
 普通发送也要继续使用已有的 Markdown/纯文本兼容格式和主动发送回退逻辑。
 
-## 设置设计
+## 设置与格式联动
 
-建议将开关放在私聊消息设置中，而不是群聊设置中：
+设置页只提供两种发送格式：Markdown 与纯文本兼容，不再提供“智能格式”或独立流式开关。私聊选择 Markdown 时自动使用 QQ 官方流式接口；选择纯文本兼容时跳过流式接口并普通发送。私聊默认 Markdown，群聊默认纯文本兼容；群聊始终普通发送，因为官方 `stream_messages` 只覆盖 C2C 私聊。
 
-```ts
-interface QQChatRuntimeSettings {
-  directStreamingEnabled: boolean
-}
-```
-
-推荐默认值：`true`，保持官方流式能力；如果目标客户端普遍看不到流式效果，也可以在产品层默认关闭。
-
-设置说明应明确：
-
-> 私聊流式回复使用 QQ 官方流式接口逐步更新消息；部分 QQ 客户端可能看不到流式效果。关闭后使用普通一次性消息发送。
+历史设置中的 `smart` 会迁移为 Markdown；旧的 `directStreamingEnabled` 设置项会被清理。Markdown 权限不可用时，普通发送仍保留纯文本降级。
 
 群聊不应被这个开关影响，因为 QQ 官方 `stream_messages` 方案只覆盖 C2C 私聊。
 
@@ -310,7 +300,7 @@ if (writer.sentFrameCount === 0) {
 - [x] 所有请求通过串行队列；
 - [x] 使用节流减少更新频率；
 - [x] 对发送失败区分“尚未发送”和“已经发送部分”；
-- [x] 提供流式开关和普通发送回退；
+- [x] 私聊 Markdown 自动流式，纯文本兼容自动普通发送；
 - [x] 使用模拟 HTTP 测试覆盖首帧、后续帧、结束帧和队列竞态；
 - [ ] 真实 QQ 手机端和桌面端分别验证所有客户端的可见性；
 - [x] 日志只记录 `msg_seq`、`index`、是否有 `stream_msg_id` 等定位信息，不记录完整敏感正文。
@@ -333,7 +323,7 @@ QQ 会在 `msg_seq` 重复或流式上下文不完整时返回 `40054005`。当
 | 中途失败 | 不发送完整重复消息 |
 | 429/50002 | 按退避策略重试，超过次数后降级或报错 |
 | 空回复 | 不发送空流式消息 |
-| 设置关闭 | 不访问 `stream_messages` |
+| 私聊纯文本兼容 | 不访问 `stream_messages` |
 | 群聊 | 不访问 `stream_messages` |
 
 ## 当前实现位置

package/lib/client.js

@@ -182,8 +182,8 @@ function QQSettings({ rpc }) {
         align: 'end',
         items: [{ id: '', label: '不设置 Owner' }, ...members.map(member => ({ id: member.platformUserId, label: member.displayName || 'QQ 群友' }))],
     });
-    const formatLabel = (value) => value === 'markdown' ? 'Markdown' : value === 'compat' ? '纯文本兼容' : '智能兼容';
-    const formatItems = [{ id: 'smart', label: '智能兼容' }, { id: 'markdown', label: 'Markdown' }, { id: 'compat', label: '纯文本兼容' }];
+    const formatLabel = (value) => value === 'compat' ? '纯文本兼容' : 'Markdown';
+    const formatItems = [{ id: 'markdown', label: 'Markdown' }, { id: 'compat', label: '纯文本兼容' }];
     const groupReplyPicker = (0, shared_cjs_1.h)(shared_cjs_1.Menu, {
         open: groupReplyMenuOpen,
         onClose: () => setGroupReplyMenuOpen(false),
@@ -235,16 +235,9 @@ function QQSettings({ rpc }) {
         footer: [{ type: 'label', id: 'receive-help-note', text: '未开启时只能收到 @ 消息，非 @ 消息不会进入会话记录' }],
         anchor: (0, shared_cjs_1.h)(shared_cjs_1.Button, { size: 'sm', variant: 'outline', onClick: () => setReceiveHelpOpen(!receiveHelpOpen) }, '设置方法'),
     });
-    const receiveGroup = (0, shared_cjs_1.h)('div', { className: 'qqSettingsGroup' }, (0, shared_cjs_1.h)('h3', null, '消息接收'), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊接收方式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp qqHelpRow' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。', receiveHelp)), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, receiveButtons)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, groupReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '私聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 私聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, directReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('label', { className: 'qqCheckRow' }, (0, shared_cjs_1.h)('input', {
-        type: 'checkbox',
-        checked: settings.directStreamingEnabled && settings.directReplyFormat !== 'compat',
-        disabled: settings.directReplyFormat === 'compat',
-        onChange: (event) => void patch({ directStreamingEnabled: event.target.checked }),
-    }), (0, shared_cjs_1.h)('span', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '私聊流式回复'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, settings.directReplyFormat === 'compat'
-        ? '纯文本兼容模式不支持流式传输，已自动关闭。'
-        : settings.directStreamingEnabled
-            ? '使用 QQ 官方流式接口逐步更新私聊回复；部分 QQ 客户端可能看不到流式效果。'
-            : '使用普通一次性消息发送，兼容性更好。')))));
+    const receiveGroup = (0, shared_cjs_1.h)('div', { className: 'qqSettingsGroup' }, (0, shared_cjs_1.h)('h3', null, '消息接收'), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊接收方式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp qqHelpRow' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。', receiveHelp)), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, receiveButtons)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, groupReplyPicker)), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '私聊消息格式'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, settings.directReplyFormat === 'markdown'
+        ? 'Markdown 格式默认使用 QQ 官方流式接口逐步更新回复；部分客户端可能看不到流式效果。'
+        : '纯文本兼容格式使用普通发送，不启用流式传输。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, directReplyPicker)));
     const memoryGroup = (0, shared_cjs_1.h)('div', { className: 'qqSettingsGroup' }, (0, shared_cjs_1.h)('h3', null, '记忆系统'), (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, '启用记忆系统'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '记忆会在新 Session、上下文 TTL 过期、记忆变化或 Session 压缩后刷新，不会每轮重复注入完整上下文；后台会在空闲时整理近期消息。启用记忆可能降低上下文缓存命中率并增加输入 token。关闭后停止记忆注入和后台整理，但不会删除已有记忆。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, (0, shared_cjs_1.h)(shared_cjs_1.Button, { size: 'sm', variant: settings.memoryEnabled ? 'primary' : 'outline', onClick: () => void patch({ memoryEnabled: !settings.memoryEnabled }) }, settings.memoryEnabled ? '已启用' : '已关闭'))));
     const ownerSetting = !settings.groupMembersCanUseTools
         ? (0, shared_cjs_1.h)('div', { className: 'qqSetting' }, (0, shared_cjs_1.h)('div', null, (0, shared_cjs_1.h)('div', { className: 'qqSettingTitle' }, 'Owner stable ID'), (0, shared_cjs_1.h)('div', { className: 'qqSettingHelp' }, '使用 stable sender ID，不根据昵称判断。')), (0, shared_cjs_1.h)('div', { className: 'qqControl' }, (0, shared_cjs_1.h)(shared_cjs_1.Input, {

package/lib/config.js

@@ -6,7 +6,7 @@ const DEFAULT_CONFIG = Object.freeze({
     groupChatEnabled: true,
     groupRequiresAt: true,
     groupReadEnabled: true,
-    replyFormat: 'smart',
+    replyFormat: 'markdown',
     recentGroupMessages: 40,
     reflectionIdleMs: 900_000,
     reflectionBatchSize: 20,
@@ -16,9 +16,7 @@ const DEFAULT_CONFIG = Object.freeze({
 });
 export function resolveConfig(input = {}) {
     const home = process.env.DSH_HOME || join(homedir(), '.dsh');
-    const replyFormat = ['smart', 'markdown', 'compat'].includes(input.replyFormat ?? '')
-        ? input.replyFormat
-        : DEFAULT_CONFIG.replyFormat;
+    const replyFormat = input.replyFormat === 'compat' ? 'compat' : 'markdown';
     return Object.freeze({
         dataDir: resolve(input.dataDir || join(home, 'plugins', 'dsh-qqchat')),
         source: input.source || DEFAULT_CONFIG.source,
@@ -49,7 +47,6 @@ export function defaultRuntimeSettings(config) {
         groupReceiveMode,
         groupReplyFormat: 'compat',
         directReplyFormat: config.replyFormat,
-        directStreamingEnabled: config.replyFormat !== 'compat',
         groupMembersCanUseTools: false,
         groupMembersCanReceiveMedia: true,
         groupMembersCanReadMedia: false,

package/lib/gateway/api.d.ts

@@ -1,5 +1,5 @@
 import type { QQChatDatabase } from '../storage/db.js';
-import type { AccountRow, QQChatConfig, QQSendOptions, ReplyFormat } from '../types.js';
+import type { AccountRow, QQChatConfig, QQSendOptions } from '../types.js';
 export interface QQPrivateTextStream {
     push(delta: string): void;
     finish(text: string): Promise<void>;
@@ -25,6 +25,5 @@ export declare class QQApiClient {
     private request;
     sendText(account: AccountRow, targetId: string, text: string, { group, messageId, format }?: QQSendOptions): Promise<Record<string, unknown>>;
     sendReplyWithActiveFallback(account: AccountRow, targetId: string, text: string, options: QQSendOptions): Promise<Record<string, unknown>>;
-    createPrivateTextStream(account: AccountRow, targetId: string, { messageId, format }?: QQSendOptions): QQPrivateTextStream;
+    createPrivateTextStream(account: AccountRow, targetId: string, { messageId }?: Pick<QQSendOptions, 'messageId'>): QQPrivateTextStream;
 }
-export declare function isReplyFormat(value: string): value is ReplyFormat;

package/lib/gateway/api.js

@@ -1,9 +1,6 @@
 const API_BASE = 'https://api.sgroup.qq.com';
 const SANDBOX_API_BASE = 'https://sandbox.api.sgroup.qq.com';
 const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken';
-function looksLikeMarkdown(text) {
-    return /(^|\n)\s{0,3}(#{1,6}\s|[-*+]\s|\d+\.\s|>\s)|\*\*|__|`|\[[^\]]+\]\([^\)]+\)/m.test(text);
-}
 export class QQApiClient {
     db;
     config;
@@ -86,7 +83,7 @@ export class QQApiClient {
     async sendText(account, targetId, text, { group = false, messageId = null, format = this.config.replyFormat } = {}) {
         const path = group ? `/v2/groups/${encodeURIComponent(targetId)}/messages` : `/v2/users/${encodeURIComponent(targetId)}/messages`;
         const seq = this.nextSeq(messageId);
-        const useMarkdown = format === 'markdown' || (format === 'smart' && looksLikeMarkdown(text));
+        const useMarkdown = format === 'markdown';
         const makeBody = (markdown) => ({
             msg_type: markdown ? 2 : 0,
             ...(markdown ? { markdown: { content: text } } : { content: text }),
@@ -113,10 +110,9 @@ export class QQApiClient {
             return this.sendText(account, targetId, text, { ...options, messageId: null });
         }
     }
-    createPrivateTextStream(account, targetId, { messageId = null, format = this.config.replyFormat } = {}) {
+    createPrivateTextStream(account, targetId, { messageId = null } = {}) {
         const path = `/v2/users/${encodeURIComponent(targetId)}/stream_messages`;
         const msgSeq = this.nextStreamSeq();
-        const contentType = format === 'markdown' ? 'markdown' : 'text';
         let fullText = '';
         let streamMessageId;
         let index = 0;
@@ -130,7 +126,7 @@ export class QQApiClient {
                 // Build the request only when the queued task runs. The first
                 // response supplies stream_msg_id for all following frames.
                 const body = {
-                    input_mode: 'replace', input_state: inputState, index: index++, content_type: contentType,
+                    input_mode: 'replace', input_state: inputState, index: index++, content_type: 'markdown',
                     content_raw: content, msg_seq: msgSeq,
                     ...(messageId ? { msg_id: messageId, event_id: messageId } : {}),
                     ...(streamMessageId ? { stream_msg_id: streamMessageId } : {}),
@@ -201,6 +197,3 @@ async function safeJson(response) {
         return undefined;
     }
 }
-export function isReplyFormat(value) {
-    return value === 'smart' || value === 'markdown' || value === 'compat';
-}

package/lib/session/agent-bridge.d.ts

@@ -42,7 +42,6 @@ export declare class DshQQBridge {
     private attachToWorkspace;
     private rememberRoute;
     private appendDisplayIfMissing;
-    private appendOwnerMessageIfMissing;
     private ensureTitle;
     private tryResume;
     private agentOptions;

package/lib/session/agent-bridge.js

@@ -123,15 +123,6 @@ export class DshQQBridge {
             return undefined;
         const { agent, sessionId } = await this.ensureAgent(event.chatType, row);
         event.sessionId = sessionId;
-        if (event.isOwner) {
-            // Keep owner messages as native user/message events even when they carry
-            // images. DSH now owns the image projection: visual routes receive the
-            // durable image block, while text-only routes receive its stable text
-            // placeholder. Falling back to a display-only event here would discard
-            // the owner's message semantics before DSH can apply that policy.
-            this.appendOwnerMessageIfMissing(agent.session, event);
-            return sessionId;
-        }
         this.appendDisplayIfMissing(agent.session, event);
         return sessionId;
     }
@@ -352,24 +343,6 @@ export class DshQQBridge {
         // fresh Session while SQLite remains the QQ history source of truth.
         session.append('qqchat/message', displayEventPayload(event));
     }
-    appendOwnerMessageIfMissing(session, event) {
-        if (session.snapshotEvents().some(item => {
-            if (item.type !== 'user/message')
-                return false;
-            const source = item.data.source;
-            return source.messageId === event.messageId;
-        }))
-            return;
-        session.append('user/message', createUserMessage({
-            source: {
-                kind: 'user', channel: 'qq', botId: 'qqchat', chatType: event.chatType,
-                chatId: event.chatId, senderId: event.senderId,
-                ...(event.senderName ? { senderName: event.senderName } : {}),
-                messageId: event.messageId, mentioned: event.mentioned,
-            },
-            content: transcriptContent(event, this.db),
-        }), { surfaceOp: 'append' });
-    }
     ensureTitle(session, chatType, row) {
         try {
             const getService = this.ctx.get;
@@ -619,35 +592,6 @@ export function qqMessageContent(text, attachments) {
     }
     return content;
 }
-function transcriptContent(event, db) {
-    const attachments = event.attachments || [];
-    const renderableImages = attachments.filter(attachment => attachment.kind === 'image' && db.attachmentById(attachment.id)?.imageRef);
-    const imagePlaceholderLines = new Set(renderableImages.map(attachment => `[图片] ${attachment.filename}`));
-    const quote = event.quote ? formatDisplayQuote(event) : '';
-    const body = event.content.split('\n').filter(line => !imagePlaceholderLines.has(line)).join('\n').trim();
-    const text = [quote, body].filter(Boolean).join('\n\n');
-    const content = [{ type: 'text', text }];
-    for (const attachment of attachments) {
-        const imageRef = attachment.kind === 'image' ? db.attachmentById(attachment.id)?.imageRef : undefined;
-        if (imageRef) {
-            content.push({ type: 'image', attachment: imageRef });
-        }
-    }
-    return content;
-}
-function formatDisplayQuote(event) {
-    const quote = event.quote;
-    if (!quote)
-        return '';
-    return [
-        '[引用消息]',
-        quote.senderId ? `发送人ID=${quote.senderId}` : '',
-        quote.senderName ? `显示名=${quote.senderName}` : '',
-        quote.messageId ? `消息ID=${quote.messageId}` : '',
-        `正文=${quote.text || '(空消息)'}`,
-        quote.attachments.length ? `附件=${quote.attachments.map(attachment => `${attachment.kind || 'file'}:${attachment.filename}${attachment.attachmentId ? ` (attachment_id=${attachment.attachmentId})` : ''}`).join('、')}` : '',
-    ].filter(Boolean).join('\n');
-}
 function displayEventPayload(event) {
     const attachments = (event.attachments || []).map(attachment => ({
         id: String(attachment.id), kind: attachment.kind, filename: String(attachment.filename),

package/lib/session/runtime.d.ts

@@ -38,5 +38,7 @@ export declare class QQChatRuntime {
     private flushOutbox;
 }
 export declare function shouldReplyToGroup(mode: GroupReceiveMode, group: Pick<GroupRow, 'enabled' | 'read_enabled'>, mentioned: boolean): boolean;
+/** Record messages that do not enter the Agent turn, plus QQ commands handled outside Agent.followup. */
+export declare function shouldRecordQQTranscript(shouldReply: boolean, text: string, mentioned: boolean): boolean;
 export declare function mergeIndexedQuote(message: QQNormalizedMessage, indexed: import('../types.js').QQQuoteIndexRow | undefined): QQNormalizedMessage;
 export declare function indexAttachments(inputs: QQAttachmentInput[], stored: StoredAttachmentSummary[]): QQAttachmentInput[];

package/lib/session/runtime.js

@@ -2,6 +2,7 @@ import { readFile } from 'node:fs/promises';
 import { defaultRuntimeSettings } from '../config.js';
 import { QQGateway } from '../gateway/gateway.js';
 import { renderQQMentionNames } from '../gateway/normalize.js';
+import { qqCommandText } from '../commands/dispatch.js';
 const QUOTE_INDEX_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 export class QQChatRuntime {
     ctx;
@@ -52,10 +53,7 @@ export class QQChatRuntime {
         this.db.close();
     }
     settings() {
-        const settings = this.db.runtimeSettings(defaultRuntimeSettings(this.config));
-        if (settings.directReplyFormat === 'compat')
-            settings.directStreamingEnabled = false;
-        return settings;
+        return this.db.runtimeSettings(defaultRuntimeSettings(this.config));
     }
     updateSettings(patch) {
         if (patch.memoryEnabled !== undefined)
@@ -76,11 +74,7 @@ export class QQChatRuntime {
             if (!isReplyFormat(patch.directReplyFormat))
                 throw new Error('无效的私聊消息兼容格式');
             this.db.setSetting('directReplyFormat', patch.directReplyFormat);
-            if (patch.directReplyFormat === 'compat')
-                this.db.setSetting('directStreamingEnabled', false);
         }
-        if (patch.directStreamingEnabled !== undefined)
-            this.db.setSetting('directStreamingEnabled', Boolean(patch.directStreamingEnabled));
         if (patch.groupMembersCanUseTools !== undefined)
             this.db.setSetting('groupMembersCanUseTools', Boolean(patch.groupMembersCanUseTools));
         if (patch.groupMembersCanReceiveMedia !== undefined)
@@ -273,21 +267,20 @@ export class QQChatRuntime {
                     this.memory.scheduleGroupMembers(Number(group.id));
             }
         }
-        if (!shouldReply) {
+        if (shouldRecordQQTranscript(shouldReply, message.text, message.mentioned)) {
             await this.bridge.recordTranscript(displayEvent, row, true);
+        }
+        if (!shouldReply) {
             return;
         }
         try {
-            // Keep the incoming QQ message visible in Web independently from the
-            // notice-shaped message used to drive the Agent turn.
-            await this.bridge.recordTranscript(displayEvent, row, true);
             const targetId = message.chatType === 'group' ? message.groupOpenid : message.senderId;
             const sendOptions = {
                 group: message.chatType === 'group', messageId: message.messageId || null,
                 format: message.chatType === 'group' ? settings.groupReplyFormat : settings.directReplyFormat,
             };
-            const stream = message.chatType === 'c2c' && settings.directReplyFormat !== 'compat' && settings.directStreamingEnabled
-                ? this.api.createPrivateTextStream(account, targetId, sendOptions)
+            const stream = message.chatType === 'c2c' && settings.directReplyFormat === 'markdown'
+                ? this.api.createPrivateTextStream(account, targetId, { messageId: sendOptions.messageId })
                 : undefined;
             const reply = await this.bridge.reply(message, group, member, storedAttachments, stream ? delta => stream.push(delta) : undefined, isOwner);
             if (stream) {
@@ -345,12 +338,16 @@ export class QQChatRuntime {
     }
 }
 function isGroupReceiveMode(value) { return value === 'auto' || value === 'mention' || value === 'silent'; }
-function isReplyFormat(value) { return value === 'smart' || value === 'markdown' || value === 'compat'; }
+function isReplyFormat(value) { return value === 'markdown' || value === 'compat'; }
 export function shouldReplyToGroup(mode, group, mentioned) {
     if (group.enabled !== 1 || group.read_enabled !== 1)
         return false;
     return mode === 'auto' || (mode === 'mention' && mentioned);
 }
+/** Record messages that do not enter the Agent turn, plus QQ commands handled outside Agent.followup. */
+export function shouldRecordQQTranscript(shouldReply, text, mentioned) {
+    return !shouldReply || qqCommandText(text, mentioned) !== undefined;
+}
 function shortId(value) { return value.length > 10 ? `…${value.slice(-10)}` : value; }
 function publicAttachments(attachments) {
     return attachments.map(attachment => ({

package/lib/storage/db.js

@@ -239,6 +239,9 @@ export class QQChatDatabase {
         error TEXT
       );
     `);
+        this.db.prepare("UPDATE plugin_settings SET value='\"markdown\"',updated_at=? WHERE key IN ('replyFormat','groupReplyFormat','directReplyFormat') AND value='\"smart\"'")
+            .run(now());
+        this.db.prepare("DELETE FROM plugin_settings WHERE key='directStreamingEnabled'").run();
         this.db.prepare("UPDATE reflection_tasks SET status='failed',updated_at=? WHERE status='running' AND updated_at<?")
             .run(now(), now() - REFLECTION_TASK_STALE_MS);
         const columns = new Set(many(this.db.prepare('PRAGMA table_info(group_members)').all()).map(column => column.name));
@@ -362,13 +365,13 @@ export class QQChatDatabase {
             .run(key, JSON.stringify(value), now());
     }
     runtimeSettings(defaults) {
+        const legacyReplyFormat = normalizeReplyFormat(this.getSetting('replyFormat', defaults.directReplyFormat), defaults.directReplyFormat);
         return {
             memoryEnabled: this.getSetting('memoryEnabled', defaults.memoryEnabled),
             memoryMemberBatchEnabled: this.getSetting('memoryMemberBatchEnabled', defaults.memoryMemberBatchEnabled),
             groupReceiveMode: this.getSetting('groupReceiveMode', defaults.groupReceiveMode),
-            groupReplyFormat: this.getSetting('groupReplyFormat', defaults.groupReplyFormat),
-            directReplyFormat: this.getSetting('directReplyFormat', this.getSetting('replyFormat', defaults.directReplyFormat)),
-            directStreamingEnabled: this.getSetting('directStreamingEnabled', defaults.directStreamingEnabled),
+            groupReplyFormat: normalizeReplyFormat(this.getSetting('groupReplyFormat', defaults.groupReplyFormat), defaults.groupReplyFormat),
+            directReplyFormat: normalizeReplyFormat(this.getSetting('directReplyFormat', legacyReplyFormat), legacyReplyFormat),
             groupMembersCanUseTools: this.getSetting('groupMembersCanUseTools', defaults.groupMembersCanUseTools),
             groupMembersCanReceiveMedia: this.getSetting('groupMembersCanReceiveMedia', defaults.groupMembersCanReceiveMedia),
             groupMembersCanReadMedia: this.getSetting('groupMembersCanReadMedia', defaults.groupMembersCanReadMedia),
@@ -724,3 +727,9 @@ export class QQChatDatabase {
         this.db.prepare('UPDATE outbox SET status=?,sent_at=?,error=? WHERE id=?').run(error ? 'failed' : 'sent', now(), error, id);
     }
 }
+function normalizeReplyFormat(value, fallback) {
+    if (value === 'markdown' || value === 'compat')
+        return value;
+    // Older releases persisted the automatic “smart” mode. Its explicit replacement is Markdown.
+    return value === 'smart' ? 'markdown' : fallback;
+}

package/lib/transport/rpc.js

@@ -304,12 +304,10 @@ function asSettingsPatch(value) {
     if (record.groupReceiveMode === 'auto' || record.groupReceiveMode === 'mention' || record.groupReceiveMode === 'silent') {
         patch.groupReceiveMode = record.groupReceiveMode;
     }
-    if (record.groupReplyFormat === 'smart' || record.groupReplyFormat === 'markdown' || record.groupReplyFormat === 'compat')
+    if (record.groupReplyFormat === 'markdown' || record.groupReplyFormat === 'compat')
         patch.groupReplyFormat = record.groupReplyFormat;
-    if (record.directReplyFormat === 'smart' || record.directReplyFormat === 'markdown' || record.directReplyFormat === 'compat')
+    if (record.directReplyFormat === 'markdown' || record.directReplyFormat === 'compat')
         patch.directReplyFormat = record.directReplyFormat;
-    if (typeof record.directStreamingEnabled === 'boolean')
-        patch.directStreamingEnabled = record.directStreamingEnabled;
     if (typeof record.groupMembersCanUseTools === 'boolean')
         patch.groupMembersCanUseTools = record.groupMembersCanUseTools;
     if (typeof record.groupMembersCanReceiveMedia === 'boolean')

package/lib/types.d.ts

@@ -13,7 +13,7 @@ export interface DailyEntry {
     date: string;
     note: string;
 }
-export type ReplyFormat = 'smart' | 'markdown' | 'compat';
+export type ReplyFormat = 'markdown' | 'compat';
 export type GroupReceiveMode = 'auto' | 'mention' | 'silent';
 export type GatewayStatus = 'offline' | 'connecting' | 'online' | 'error';
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
@@ -58,7 +58,6 @@ export interface QQChatRuntimeSettings {
     groupReceiveMode: GroupReceiveMode;
     groupReplyFormat: ReplyFormat;
     directReplyFormat: ReplyFormat;
-    directStreamingEnabled: boolean;
     groupMembersCanUseTools: boolean;
     groupMembersCanReceiveMedia: boolean;
     groupMembersCanReadMedia: boolean;
@@ -70,7 +69,6 @@ export interface QQChatRuntimeSettingsPatch {
     groupReceiveMode?: GroupReceiveMode;
     groupReplyFormat?: ReplyFormat;
     directReplyFormat?: ReplyFormat;
-    directStreamingEnabled?: boolean;
     groupMembersCanUseTools?: boolean;
     groupMembersCanReceiveMedia?: boolean;
     groupMembersCanReadMedia?: boolean;

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "dsh-qqchat",
-  "version": "0.2.6",
+  "version": "0.2.7",
   "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
   "type": "module",
   "license": "MIT",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.1.6-alpha.1"
   },
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",

package/src/config.ts

@@ -8,7 +8,7 @@ const DEFAULT_CONFIG = Object.freeze({
   groupChatEnabled: true,
   groupRequiresAt: true,
   groupReadEnabled: true,
-  replyFormat: 'smart' as ReplyFormat,
+  replyFormat: 'markdown' as ReplyFormat,
   recentGroupMessages: 40,
   reflectionIdleMs: 900_000,
   reflectionBatchSize: 20,
@@ -19,9 +19,7 @@ const DEFAULT_CONFIG = Object.freeze({
 
 export function resolveConfig(input: QQChatConfigInput = {}): QQChatConfig {
   const home = process.env.DSH_HOME || join(homedir(), '.dsh')
-  const replyFormat: ReplyFormat = ['smart', 'markdown', 'compat'].includes(input.replyFormat ?? '')
-    ? input.replyFormat as ReplyFormat
-    : DEFAULT_CONFIG.replyFormat
+  const replyFormat: ReplyFormat = input.replyFormat === 'compat' ? 'compat' : 'markdown'
 
   return Object.freeze({
     dataDir: resolve(input.dataDir || join(home, 'plugins', 'dsh-qqchat')),
@@ -54,7 +52,6 @@ export function defaultRuntimeSettings(config: QQChatConfig): QQChatRuntimeSetti
     groupReceiveMode,
     groupReplyFormat: 'compat',
     directReplyFormat: config.replyFormat,
-    directStreamingEnabled: config.replyFormat !== 'compat',
     groupMembersCanUseTools: false,
     groupMembersCanReceiveMedia: true,
     groupMembersCanReadMedia: false,

package/src/gateway/api.ts

@@ -12,10 +12,6 @@ const API_BASE = 'https://api.sgroup.qq.com'
 const SANDBOX_API_BASE = 'https://sandbox.api.sgroup.qq.com'
 const TOKEN_URL = 'https://bots.qq.com/app/getAppAccessToken'
 
-function looksLikeMarkdown(text: string): boolean {
-  return /(^|\n)\s{0,3}(#{1,6}\s|[-*+]\s|\d+\.\s|>\s)|\*\*|__|`|\[[^\]]+\]\([^\)]+\)/m.test(text)
-}
-
 interface CachedToken {
   token: string
   expiresAt: number
@@ -33,7 +29,7 @@ interface QQStreamBody {
   input_mode: 'replace'
   input_state: 1 | 10
   index: number
-  content_type: 'text' | 'markdown'
+  content_type: 'markdown'
   content_raw: string
   msg_seq: number
   event_id?: string
@@ -143,7 +139,7 @@ export class QQApiClient {
   ): Promise<Record<string, unknown>> {
     const path = group ? `/v2/groups/${encodeURIComponent(targetId)}/messages` : `/v2/users/${encodeURIComponent(targetId)}/messages`
     const seq = this.nextSeq(messageId)
-    const useMarkdown = format === 'markdown' || (format === 'smart' && looksLikeMarkdown(text))
+    const useMarkdown = format === 'markdown'
     const makeBody = (markdown: boolean): QQSendBody => ({
       msg_type: markdown ? 2 : 0,
       ...(markdown ? { markdown: { content: text } } : { content: text }),
@@ -177,11 +173,10 @@ export class QQApiClient {
   createPrivateTextStream(
     account: AccountRow,
     targetId: string,
-    { messageId = null, format = this.config.replyFormat }: QQSendOptions = {},
+    { messageId = null }: Pick<QQSendOptions, 'messageId'> = {},
   ): QQPrivateTextStream {
     const path = `/v2/users/${encodeURIComponent(targetId)}/stream_messages`
     const msgSeq = this.nextStreamSeq()
-    const contentType = format === 'markdown' ? 'markdown' : 'text'
     let fullText = ''
     let streamMessageId: string | undefined
     let index = 0
@@ -196,7 +191,7 @@ export class QQApiClient {
         // Build the request only when the queued task runs. The first
         // response supplies stream_msg_id for all following frames.
         const body: QQStreamBody = {
-          input_mode: 'replace', input_state: inputState, index: index++, content_type: contentType,
+          input_mode: 'replace', input_state: inputState, index: index++, content_type: 'markdown',
           content_raw: content, msg_seq: msgSeq,
           ...(messageId ? { msg_id: messageId, event_id: messageId } : {}),
           ...(streamMessageId ? { stream_msg_id: streamMessageId } : {}),
@@ -258,7 +253,3 @@ export class QQApiClient {
 async function safeJson<T>(response: Response): Promise<T | undefined> {
   try { return await response.json() as T } catch { return undefined }
 }
-
-export function isReplyFormat(value: string): value is ReplyFormat {
-  return value === 'smart' || value === 'markdown' || value === 'compat'
-}

package/src/session/agent-bridge.ts

@@ -148,15 +148,6 @@ export class DshQQBridge {
     if (!existing && !createSession) return undefined
     const { agent, sessionId } = await this.ensureAgent(event.chatType, row)
     event.sessionId = sessionId
-    if (event.isOwner) {
-      // Keep owner messages as native user/message events even when they carry
-      // images. DSH now owns the image projection: visual routes receive the
-      // durable image block, while text-only routes receive its stable text
-      // placeholder. Falling back to a display-only event here would discard
-      // the owner's message semantics before DSH can apply that policy.
-      this.appendOwnerMessageIfMissing(agent.session, event)
-      return sessionId
-    }
     this.appendDisplayIfMissing(agent.session, event)
     return sessionId
   }
@@ -371,23 +362,6 @@ export class DshQQBridge {
     session.append('qqchat/message', displayEventPayload(event))
   }
 
-  private appendOwnerMessageIfMissing(session: Session, event: QQChatDisplayEvent): void {
-    if (session.snapshotEvents().some(item => {
-      if (item.type !== 'user/message') return false
-      const source = item.data.source as unknown as { messageId?: string }
-      return source.messageId === event.messageId
-    })) return
-    session.append('user/message', createUserMessage({
-      source: {
-        kind: 'user', channel: 'qq', botId: 'qqchat', chatType: event.chatType,
-        chatId: event.chatId, senderId: event.senderId,
-        ...(event.senderName ? { senderName: event.senderName } : {}),
-        messageId: event.messageId, mentioned: event.mentioned,
-      },
-      content: transcriptContent(event, this.db),
-    }), { surfaceOp: 'append' })
-  }
-
   private ensureTitle(session: Session, chatType: ChatType, row: GroupRow | MemberRow): void {
     try {
       const getService = (this.ctx as unknown as { get?: (name: string) => unknown }).get
@@ -632,36 +606,6 @@ export function qqMessageContent(text: string, attachments: readonly StoredAttac
   return content
 }
 
-function transcriptContent(event: QQChatDisplayEvent, db: QQChatDatabase): ContentBlock[] {
-  const attachments = event.attachments || []
-  const renderableImages = attachments.filter(attachment => attachment.kind === 'image' && db.attachmentById(attachment.id)?.imageRef)
-  const imagePlaceholderLines = new Set(renderableImages.map(attachment => `[图片] ${attachment.filename}`))
-  const quote = event.quote ? formatDisplayQuote(event) : ''
-  const body = event.content.split('\n').filter(line => !imagePlaceholderLines.has(line)).join('\n').trim()
-  const text = [quote, body].filter(Boolean).join('\n\n')
-  const content: ContentBlock[] = [{ type: 'text', text }]
-  for (const attachment of attachments) {
-    const imageRef = attachment.kind === 'image' ? db.attachmentById(attachment.id)?.imageRef : undefined
-    if (imageRef) {
-      content.push({ type: 'image', attachment: imageRef })
-    }
-  }
-  return content
-}
-
-function formatDisplayQuote(event: QQChatDisplayEvent): string {
-  const quote = event.quote
-  if (!quote) return ''
-  return [
-    '[引用消息]',
-    quote.senderId ? `发送人ID=${quote.senderId}` : '',
-    quote.senderName ? `显示名=${quote.senderName}` : '',
-    quote.messageId ? `消息ID=${quote.messageId}` : '',
-    `正文=${quote.text || '(空消息)'}`,
-    quote.attachments.length ? `附件=${quote.attachments.map(attachment => `${attachment.kind || 'file'}:${attachment.filename}${attachment.attachmentId ? ` (attachment_id=${attachment.attachmentId})` : ''}`).join('、')}` : '',
-  ].filter(Boolean).join('\n')
-}
-
 function displayEventPayload(event: QQChatDisplayEvent): QQChatDisplayEvent {
   const attachments = (event.attachments || []).map(attachment => ({
     id: String(attachment.id), kind: attachment.kind, filename: String(attachment.filename),

package/src/session/runtime.ts

@@ -9,6 +9,7 @@ import type { QQApiClient } from '../gateway/api.js'
 import type { QQBindService } from '../gateway/auth.js'
 import { QQGateway } from '../gateway/gateway.js'
 import { renderQQMentionNames } from '../gateway/normalize.js'
+import { qqCommandText } from '../commands/dispatch.js'
 import { QQMediaStore } from '../media/store.js'
 import type {
   AccountRow, ChatTargetRow, ChatType, GroupReceiveMode, GroupRow, MemberRow, QQAttachmentInput, QQChatConfig,
@@ -52,9 +53,7 @@ export class QQChatRuntime {
   }
 
   settings(): QQChatRuntimeSettings {
-    const settings = this.db.runtimeSettings(defaultRuntimeSettings(this.config))
-    if (settings.directReplyFormat === 'compat') settings.directStreamingEnabled = false
-    return settings
+    return this.db.runtimeSettings(defaultRuntimeSettings(this.config))
   }
 
   updateSettings(patch: QQChatRuntimeSettingsPatch): QQChatRuntimeSettings {
@@ -71,9 +70,7 @@ export class QQChatRuntime {
     if (patch.directReplyFormat !== undefined) {
       if (!isReplyFormat(patch.directReplyFormat)) throw new Error('无效的私聊消息兼容格式')
       this.db.setSetting('directReplyFormat', patch.directReplyFormat)
-      if (patch.directReplyFormat === 'compat') this.db.setSetting('directStreamingEnabled', false)
     }
-    if (patch.directStreamingEnabled !== undefined) this.db.setSetting('directStreamingEnabled', Boolean(patch.directStreamingEnabled))
     if (patch.groupMembersCanUseTools !== undefined) this.db.setSetting('groupMembersCanUseTools', Boolean(patch.groupMembersCanUseTools))
     if (patch.groupMembersCanReceiveMedia !== undefined) this.db.setSetting('groupMembersCanReceiveMedia', Boolean(patch.groupMembersCanReceiveMedia))
     if (patch.groupMembersCanReadMedia !== undefined) this.db.setSetting('groupMembersCanReadMedia', Boolean(patch.groupMembersCanReadMedia))
@@ -252,22 +249,21 @@ export class QQChatRuntime {
         }
       }
 
-    if (!shouldReply) {
+    if (shouldRecordQQTranscript(shouldReply, message.text, message.mentioned)) {
       await this.bridge.recordTranscript(displayEvent, row, true)
+    }
+    if (!shouldReply) {
       return
     }
 
     try {
-      // Keep the incoming QQ message visible in Web independently from the
-      // notice-shaped message used to drive the Agent turn.
-      await this.bridge.recordTranscript(displayEvent, row, true)
       const targetId = message.chatType === 'group' ? message.groupOpenid! : message.senderId
       const sendOptions = {
         group: message.chatType === 'group', messageId: message.messageId || null,
         format: message.chatType === 'group' ? settings.groupReplyFormat : settings.directReplyFormat,
       } as const
-      const stream = message.chatType === 'c2c' && settings.directReplyFormat !== 'compat' && settings.directStreamingEnabled
-        ? this.api.createPrivateTextStream(account, targetId, sendOptions)
+      const stream = message.chatType === 'c2c' && settings.directReplyFormat === 'markdown'
+        ? this.api.createPrivateTextStream(account, targetId, { messageId: sendOptions.messageId })
         : undefined
       const reply = await this.bridge.reply(message, group, member, storedAttachments, stream ? delta => stream.push(delta) : undefined, isOwner)
       if (stream) {
@@ -320,11 +316,15 @@ export class QQChatRuntime {
 }
 
 function isGroupReceiveMode(value: unknown): value is GroupReceiveMode { return value === 'auto' || value === 'mention' || value === 'silent' }
-function isReplyFormat(value: unknown): value is ReplyFormat { return value === 'smart' || value === 'markdown' || value === 'compat' }
+function isReplyFormat(value: unknown): value is ReplyFormat { return value === 'markdown' || value === 'compat' }
 export function shouldReplyToGroup(mode: GroupReceiveMode, group: Pick<GroupRow, 'enabled' | 'read_enabled'>, mentioned: boolean): boolean {
   if (group.enabled !== 1 || group.read_enabled !== 1) return false
   return mode === 'auto' || (mode === 'mention' && mentioned)
 }
+/** Record messages that do not enter the Agent turn, plus QQ commands handled outside Agent.followup. */
+export function shouldRecordQQTranscript(shouldReply: boolean, text: string, mentioned: boolean): boolean {
+  return !shouldReply || qqCommandText(text, mentioned) !== undefined
+}
 function shortId(value: string): string { return value.length > 10 ? `…${value.slice(-10)}` : value }
 function publicAttachments(attachments: StoredAttachmentSummary[]): StoredAttachmentSummary[] {
   return attachments.map(attachment => ({

package/src/storage/db.ts

@@ -264,6 +264,9 @@ export class QQChatDatabase {
         error TEXT
       );
     `)
+    this.db.prepare("UPDATE plugin_settings SET value='\"markdown\"',updated_at=? WHERE key IN ('replyFormat','groupReplyFormat','directReplyFormat') AND value='\"smart\"'")
+      .run(now())
+    this.db.prepare("DELETE FROM plugin_settings WHERE key='directStreamingEnabled'").run()
     this.db.prepare("UPDATE reflection_tasks SET status='failed',updated_at=? WHERE status='running' AND updated_at<?")
       .run(now(), now() - REFLECTION_TASK_STALE_MS)
     const columns = new Set(many<{ name: string }>(this.db.prepare('PRAGMA table_info(group_members)').all()).map(column => column.name))
@@ -396,13 +399,16 @@ export class QQChatDatabase {
   }
 
   runtimeSettings(defaults: QQChatRuntimeSettings): QQChatRuntimeSettings {
+    const legacyReplyFormat = normalizeReplyFormat(
+      this.getSetting<unknown>('replyFormat', defaults.directReplyFormat),
+      defaults.directReplyFormat,
+    )
     return {
       memoryEnabled: this.getSetting('memoryEnabled', defaults.memoryEnabled),
       memoryMemberBatchEnabled: this.getSetting('memoryMemberBatchEnabled', defaults.memoryMemberBatchEnabled),
       groupReceiveMode: this.getSetting('groupReceiveMode', defaults.groupReceiveMode),
-      groupReplyFormat: this.getSetting('groupReplyFormat', defaults.groupReplyFormat),
-      directReplyFormat: this.getSetting('directReplyFormat', this.getSetting('replyFormat', defaults.directReplyFormat)),
-      directStreamingEnabled: this.getSetting('directStreamingEnabled', defaults.directStreamingEnabled),
+      groupReplyFormat: normalizeReplyFormat(this.getSetting<unknown>('groupReplyFormat', defaults.groupReplyFormat), defaults.groupReplyFormat),
+      directReplyFormat: normalizeReplyFormat(this.getSetting<unknown>('directReplyFormat', legacyReplyFormat), legacyReplyFormat),
       groupMembersCanUseTools: this.getSetting('groupMembersCanUseTools', defaults.groupMembersCanUseTools),
       groupMembersCanReceiveMedia: this.getSetting('groupMembersCanReceiveMedia', defaults.groupMembersCanReceiveMedia),
       groupMembersCanReadMedia: this.getSetting('groupMembersCanReadMedia', defaults.groupMembersCanReadMedia),
@@ -828,3 +834,9 @@ export class QQChatDatabase {
     this.db.prepare('UPDATE outbox SET status=?,sent_at=?,error=? WHERE id=?').run(error ? 'failed' : 'sent', now(), error, id)
   }
 }
+
+function normalizeReplyFormat(value: unknown, fallback: QQChatRuntimeSettings['directReplyFormat']): QQChatRuntimeSettings['directReplyFormat'] {
+  if (value === 'markdown' || value === 'compat') return value
+  // Older releases persisted the automatic “smart” mode. Its explicit replacement is Markdown.
+  return value === 'smart' ? 'markdown' : fallback
+}

package/src/transport/rpc.ts

@@ -311,9 +311,8 @@ function asSettingsPatch(value: unknown): QQChatRuntimeSettingsPatch {
   if (record.groupReceiveMode === 'auto' || record.groupReceiveMode === 'mention' || record.groupReceiveMode === 'silent') {
     patch.groupReceiveMode = record.groupReceiveMode
   }
-  if (record.groupReplyFormat === 'smart' || record.groupReplyFormat === 'markdown' || record.groupReplyFormat === 'compat') patch.groupReplyFormat = record.groupReplyFormat
-  if (record.directReplyFormat === 'smart' || record.directReplyFormat === 'markdown' || record.directReplyFormat === 'compat') patch.directReplyFormat = record.directReplyFormat
-  if (typeof record.directStreamingEnabled === 'boolean') patch.directStreamingEnabled = record.directStreamingEnabled
+  if (record.groupReplyFormat === 'markdown' || record.groupReplyFormat === 'compat') patch.groupReplyFormat = record.groupReplyFormat
+  if (record.directReplyFormat === 'markdown' || record.directReplyFormat === 'compat') patch.directReplyFormat = record.directReplyFormat
   if (typeof record.groupMembersCanUseTools === 'boolean') patch.groupMembersCanUseTools = record.groupMembersCanUseTools
   if (typeof record.groupMembersCanReceiveMedia === 'boolean') patch.groupMembersCanReceiveMedia = record.groupMembersCanReceiveMedia
   if (typeof record.groupMembersCanReadMedia === 'boolean') patch.groupMembersCanReadMedia = record.groupMembersCanReadMedia

package/src/types.ts

@@ -16,7 +16,7 @@ export interface DailyEntry {
   date: string
   note: string
 }
-export type ReplyFormat = 'smart' | 'markdown' | 'compat'
+export type ReplyFormat = 'markdown' | 'compat'
 export type GroupReceiveMode = 'auto' | 'mention' | 'silent'
 export type GatewayStatus = 'offline' | 'connecting' | 'online' | 'error'
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error'
@@ -65,7 +65,6 @@ export interface QQChatRuntimeSettings {
   groupReceiveMode: GroupReceiveMode
   groupReplyFormat: ReplyFormat
   directReplyFormat: ReplyFormat
-  directStreamingEnabled: boolean
   groupMembersCanUseTools: boolean
   groupMembersCanReceiveMedia: boolean
   groupMembersCanReadMedia: boolean
@@ -78,7 +77,6 @@ export interface QQChatRuntimeSettingsPatch {
   groupReceiveMode?: GroupReceiveMode
   groupReplyFormat?: ReplyFormat
   directReplyFormat?: ReplyFormat
-  directStreamingEnabled?: boolean
   groupMembersCanUseTools?: boolean
   groupMembersCanReceiveMedia?: boolean
   groupMembersCanReadMedia?: boolean