dsh-qqchat 0.2.4 → 0.2.6

package/README.en.md

@@ -6,8 +6,8 @@
 
 <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.1--rc.2-6f42c1.svg" alt="DSH 0.1.1-rc.2">
-  <img src="https://img.shields.io/badge/QQChat-0.2.3-2ea44f.svg" alt="QQChat 0.2.3">
+  <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/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -18,7 +18,7 @@
 
 <p><em>Chat in QQ, then view the complete Session, memory and tool activity in DSH Web.</em></p>
 
-<p>This release is verified against DSH <code>0.1.1-rc.2</code>. Install the plugin as-is; no DSH source patch or rebuild is required.</p>
+<p>This release is verified against DSH <code>0.1.6-alpha.1</code>. Install the plugin as-is; no DSH source patch or rebuild is required.</p>
 
 `dsh-qqchat` is an official QQ Bot plugin for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness). It maps QQ groups and direct chats to ordinary DSH Sessions and uses DSH's native Conversation, Agent, command and tool surfaces.
 
@@ -126,7 +126,8 @@ npx @deepseek-ai/dsh plugin --profile qqchat add @deepseek-ai/dsh-web-app dsh-qq
 npx @deepseek-ai/dsh --profile qqchat
 ```
 
-Git installs build TypeScript through `prepare`. For local development:
+Git installs use the committed `lib/` runtime artifacts, so they do not need to run
+an install-time build. For local development:
 
 ```bash
 git clone git@github.com:Coffeiz/dsh-qqchat.git

package/README.md

@@ -6,8 +6,8 @@
 
 <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.1--rc.2-6f42c1.svg" alt="DSH 0.1.1-rc.2">
-  <img src="https://img.shields.io/badge/QQChat-0.2.3-2ea44f.svg" alt="QQChat 0.2.3">
+  <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/TypeScript-5.x-3178c6.svg" alt="TypeScript">
 </p>
 
@@ -19,7 +19,7 @@
 
 <p><em>dsh-qqchat 是 DeepSeek Harness（DSH）的 QQ Bot 插件，支持 QQ 群聊、私聊、会话隔离、记忆系统和 DSH 原生命令。</em></p>
 
-<p>当前版本基于 DSH <code>0.1.1-rc.2</code> 验证，安装插件即可使用，无需修改或重新构建 DSH。</p>
+<p>当前版本基于 DSH <code>0.1.6-alpha.1</code> 验证，安装插件即可使用，无需修改或重新构建 DSH。</p>
 
 > 本项目是一个 Vibe Coding 项目，代码质量和工程完整性可能需要改进。如果你发现问题或有更好的实现建议，欢迎提交 [Issue](https://github.com/Coffeiz/dsh-qqchat/issues) 或 [Pull Request](https://github.com/Coffeiz/dsh-qqchat/pulls)。
 

package/client-src/plugin.cts

@@ -3,12 +3,12 @@ import type { Ctx } from './shared.cjs'
 import { QQSettings } from './settings.cjs'
 import { QQSessionUtility, QQTranscriptNode, createQQMessageDefinition } from './workspace.cjs'
 
-exports.inject = ['slots', 'connection', 'conversationEvents'] as const
+exports.inject = ['slots', 'connection', 'uiConversation'] as const
 exports.apply = function apply(ctx: Ctx) {
   setQQRpc(ctx.connection.rpc)
   ctx.effect(installStyles, 'dsh-qqchat: client styles')
   ctx.effect(installQQSettingsIcon, 'dsh-qqchat: QQ settings icon')
-  ctx.conversationEvents.register(createQQMessageDefinition())
+  ctx.uiConversation.events.register(createQQMessageDefinition())
 
   ctx.slots.inject('settings.section', () => ctx.slots.register({ name: 'settings.section', id: 'qqchat', order: 35, label: () => 'QQ Chat', inject: () => ({ rpc: ctx.connection.rpc }) }, QQSettings))
   ctx.slots.inject('conversation.chat.node', () => ctx.slots.register({ name: 'conversation.chat.node', key: 'qqchat-message' }, QQTranscriptNode))

package/client-src/settings.cts

@@ -25,6 +25,7 @@ export function QQSettings({ rpc }: { rpc: Rpc }) {
   const [groupReplyMenuOpen, setGroupReplyMenuOpen] = useState(false)
   const [directReplyMenuOpen, setDirectReplyMenuOpen] = useState(false)
   const [ownerMenuOpen, setOwnerMenuOpen] = useState(false)
+  const [receiveHelpOpen, setReceiveHelpOpen] = useState(false)
 
   const refresh = useCallback(async () => {
     try {
@@ -168,11 +169,27 @@ export function QQSettings({ rpc }: { rpc: Rpc }) {
       variant: settings.groupReceiveMode === mode ? 'primary' : 'outline',
       onClick: () => void patch({ groupReceiveMode: mode }),
     }, mode === 'auto' ? '自动回应' : mode === 'mention' ? '@回复' : '静默记录')))
+  const receiveHelp = h(Menu, {
+    open: receiveHelpOpen,
+    onClose: () => setReceiveHelpOpen(false),
+    onSelect: () => undefined,
+    portal: true,
+    align: 'end',
+    items: [
+      { type: 'label', id: 'receive-help-title', text: '开启全量消息接收' },
+      { type: 'label', id: 'receive-help-step-1', text: '1. 手机端 QQ 打开机器人所在的群' },
+      { type: 'label', id: 'receive-help-step-2', text: '2. 点击机器人的头像进入资料页' },
+      { type: 'label', id: 'receive-help-step-3', text: '3. 点击右上角「设置」' },
+      { type: 'label', id: 'receive-help-step-4', text: '4. 打开「全量消息接收」' },
+    ],
+    footer: [{ type: 'label', id: 'receive-help-note', text: '未开启时只能收到 @ 消息，非 @ 消息不会进入会话记录' }],
+    anchor: h(Button, { size: 'sm', variant: 'outline', onClick: () => setReceiveHelpOpen(!receiveHelpOpen) }, '设置方法'),
+  })
 
   const receiveGroup = h('div', { className: 'qqSettingsGroup' },
     h('h3', null, '消息接收'),
     h('div', { className: 'qqSetting' },
-      h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊接收方式'), h('div', { className: 'qqSettingHelp' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。')),
+      h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊接收方式'), h('div', { className: 'qqSettingHelp qqHelpRow' }, '自动回应：每条群消息都会触发 Agent；@回复：所有消息都记录，但只有 @Bot 才唤醒 Agent；静默记录：只记录群聊与记忆，不主动回应。', receiveHelp)),
       h('div', { className: 'qqControl' }, receiveButtons)),
     h('div', { className: 'qqSetting' },
       h('div', null, h('div', { className: 'qqSettingTitle' }, '群聊消息兼容格式'), h('div', { className: 'qqSettingHelp' }, '仅控制发送到 QQ 群聊时使用的消息格式。')),

package/client-src/shared.cts

@@ -29,16 +29,16 @@ export interface SlotRegistry {
   inject(name: string, fn: () => unknown): unknown
   register<P>(options: Record<string, unknown>, component: import('react').ComponentType<P>): unknown
 }
-export interface ConversationEvents { register(definition: Record<string, unknown>): unknown }
+export interface UiConversation { events: { register(definition: Record<string, unknown>): unknown } }
 export interface Ctx {
   connection: { rpc: Rpc }
   sessions: SessionsService
-  conversationEvents: ConversationEvents
+  uiConversation: UiConversation
   effect(fn: () => (() => void) | void, label: string): unknown
   slots: SlotRegistry
 }
 export interface Account { id: number; appId: string; enabled: boolean; gatewayStatus: string; gatewayLastError?: string | null }
-export interface Settings { memoryEnabled: 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; directStreamingEnabled: boolean; 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 }
@@ -118,7 +118,7 @@ const css = `
 .qqWideModal{width:min(760px,calc(100vw - 48px));max-height:calc(100vh - 48px);min-height:0;overflow:hidden}.qqModalContent{min-height:0;overflow:auto}.qqModalContent .qqMemoryGrid{min-width:0}.qqModalContent .qqLog{overflow-wrap:anywhere;word-break:break-word}
 `.concat('.qqQuoteSender{margin-top:4px;font-size:10px;color:var(--dsw-alias-label-secondary)}.qqMediaList{display:flex;flex-wrap:wrap;gap:6px;margin-top:7px}.qqMediaCard{display:flex;align-items:center;gap:6px;max-width:100%;padding:6px 8px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;background:var(--dsw-alias-bg-layer-1);font-size:11px}.qqMediaKind{color:var(--dsw-alias-brand-primary);font-weight:650}.qqMediaPreview{width:42px;height:42px;object-fit:cover;border-radius:6px}.qqMediaName{max-width:220px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.qqMediaSize,.qqMediaQuoted{color:var(--dsw-alias-label-secondary)}')
 
-const qqThemeOverrides = '.qqTranscript.out .qqBubble{background:var(--dsw-alias-bg-layer-2);color:var(--dsw-alias-label-primary)}'
+const qqThemeOverrides = '.qqBubble{background:var(--dsw-specific-bubble);color:var(--dsw-alias-label-primary)}.qqTranscript.out .qqBubble{background:var(--dsw-specific-bubble);color:var(--dsw-alias-label-primary)}'
 
 export function installStyles(): () => void {
   if (typeof document === 'undefined' || document.querySelector(`style[data-plugin-css="${STYLE_ID}"]`)) return () => {}

package/cordis.patch.yml

@@ -5,3 +5,8 @@
       name: dsh-qqchat
       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.
+- id: connection
+  inject: [webRuntime, webServer]

package/docs/ARCHITECTURE.en.md

@@ -339,7 +339,7 @@ client-src/*.cts
 tests/*.test.ts
 ```
 
-The Host is built with `tsc`. The Client is compiled to temporary CJS and then wrapped by `scripts/wrap-client.mjs` as a DSH Client factory. `lib/` is generated output rather than source truth.
+The Host is built with `tsc`. The Client is compiled to temporary CJS and then wrapped by `scripts/wrap-client.mjs` as a DSH Client factory. `lib/` is generated release output committed with fixed revisions so DSH Store can find the runtime entry without executing third-party install scripts; source remains the implementation truth.
 
 ## Development and security documentation
 

package/docs/ARCHITECTURE.md

@@ -401,7 +401,8 @@ tests/*.test.ts
 
 Host 使用 `tsc`；Client 编译到临时 CJS 后由 `scripts/wrap-client.mjs` 包装成 DSH Client factory。
 
-`lib/` 是生成物，不作为源码真相。
+`lib/` 是由源码生成的发布产物，并随固定 Commit 提交，以便 DSH Store 无需执行
+第三方安装脚本即可找到运行入口；源码仍是实现真相。
 
 ## 开发与安全文档
 

package/docs/DEVELOPMENT.md

@@ -60,7 +60,9 @@ client-src/*.cts      -> 临时 CJS       Client
 临时 CJS              -> lib/client.js  DSH ModuleLoader factory
 ```
 
-`lib/` 和临时 Client 构建目录是生成物，不是源码真相。
+`lib/` 是由构建生成的发布产物，同时提交到仓库以支持 DSH Store 从固定 Commit
+直接安装；修改源码后发布前必须重新构建并检查 `lib/` 的变更。临时 Client
+构建目录仍是本地生成物，不提交。
 
 ## 启动 DSH Web
 

package/docs/MEMORY.md

@@ -2,7 +2,7 @@
 
 ## 易读概述
 
-QQChat 的 SQLite 是 QQ 世界事实来源，DSH Session 只保存 Agent 实际经历过的 turn 和展示事件。记忆反思从 SQLite 读取消息，再写回 group/member scope。
+QQChat 的 SQLite 是 QQ 世界事实来源，DSH Session 只保存 Agent 实际经历过的 turn 和展示事件。记忆反思从 SQLite 读取消息，再写回 group/member scope。群记忆和群友批量记忆的后续调整见 [PRD-MEM-1](prds/PRD-MEM-1-群记忆与群友记忆策略调整.md)。
 
 身份主键始终是 stable sender ID；昵称、群内称呼和历史昵称是展示或画像信息，不能替代身份主键。
 
@@ -45,12 +45,28 @@ QQChat 的 SQLite 是 QQ 世界事实来源，DSH Session 只保存 Agent 实际
 
 默认配置：
 
-- 空闲约 120 秒触发一次反思
-- 未反思消息达到 20 条时立即触发
+- 群聊连续空闲 15 分钟后触发一次群反思
+- 群反思不因固定消息条数立即触发；成员批量反思达到 50 条群消息时仍可提前触发
 - 单次最多取 80 条未反思消息
 
+当前已拆分群记忆与成员记忆：群反思只写 group scope；群友批量反思使用独立的成员游标，累计 50 条已落库群消息或空闲时触发，一次处理本批真实出现的多个成员。私聊反思使用独立的 `private-owner` 任务，并保留用户/Bot 消息方向。任务、游标和 snapshot 集成仍在持续完善。
+
+成员批量反思可以通过运行时设置 `memoryMemberBatchEnabled` 灰度关闭；关闭只停止
+新的群友批量调度，不删除已有成员记忆，也不影响群反思和私聊记忆。
+
 群聊和私聊分别维护反思游标和模型路由。私聊首次没有成功 Agent 路由时不能凭空创建反思请求；需要先完成一次正常 Agent 回复。
 
+反思任务统一使用以下 scope/task 契约：
+
+```text
+scope: group | member | private
+task:  group | member-batch | private-owner
+```
+
+群反思和群友批量反思共享群消息，但使用两条独立游标；私聊任务使用 member scope
+和私聊自己的消息范围。旧数据库如果缺少成员批量游标或任务表，启动迁移会补齐
+默认值，不会删除已有记忆或跳过未处理消息。
+
 ## 压缩策略
 
 记忆如何进入 DSH Session 的生命周期、TTL 和 Session compact 处理，见[记忆系统上下文注入方案](./MEMORY_CONTEXT.md)。
@@ -60,7 +76,7 @@ QQChat 的 SQLite 是 QQ 世界事实来源，DSH Session 只保存 Agent 实际
 | Scope | 触发条数 | 保留最近 | 压缩到 |
 | --- | ---: | ---: | --- |
 | member | 100 | 50 | `memory` |
-| group | 1000 | 500 | `memory` |
+| group | 200 | 100 | `memory` |
 
 压缩模型最多使用 `memoryCompressionMaxTokens=15000`。压缩输入包含已有 memory、相关 profile/pattern 和待压缩 daily。
 
@@ -77,9 +93,21 @@ QQChat 的 SQLite 是 QQ 世界事实来源，DSH Session 只保存 Agent 实际
 `@deepseek-ai/dsh-system-prompt` 来源标记。注入策略遵循“新 Session、TTL
 过期、Session compact 后刷新”的生命周期规则，连续对话只刷新对应群或当前
 成员的 TTL，不重复注入完整记忆。群持续活跃不会替潜水成员刷新成员 TTL。
+每个记忆 scope 的直注入预算为 2000 个字符，daily 优先保留最新内容；超出
+部分仍保存在 SQLite，不会因上下文裁剪而删除。
 具体状态、hash、版本和失败处理见[记忆系统上下文注入方案](./MEMORY_CONTEXT.md)。
 当前 QQ 消息仍作为正常 user prompt 进入 turn。
 
+### 反思提示词策略
+
+三类反思提示词分别对应不同的记忆主体，不共享一套模糊的“总结聊天”指令：
+
+- **群组反思**只维护当前群的公开事实、规则、协作约定、群项目和群状态；不写成员个人资料，也不把昵称、引用、转述或推测当成群事实。
+- **群友批量反思**先判断语义主体，再按真实 `senderId` 分配成员记忆；只允许本批实际发言且有明确个人事实的成员进入输出，群规、群项目和第三方属性留在群 scope。
+- **私聊反思**使用消息 `direction` 作为事实边界：只有用户入站消息可以产生用户画像，BOT 出站消息只能作为上下文，不能反向证明用户的身份、偏好或经历。
+
+三类提示词都要求增量输出、保留已有事实、使用绝对日期，并在主体不明确时宁可漏记；`profile`、`pattern`、`summary`、`daily` 和 `memory` 的字段职责分别受证据门槛约束。具体提示词实现位于 `src/storage/memory.ts`，压缩提示词则单独负责 `daily → memory` 沉淀，不参与成员主体判断。
+
 群聊 Agent turn 注入：
 
 ```text

package/docs/MEMORY_CONTEXT.md

@@ -16,6 +16,22 @@ QQChat 的记忆属于 DSH Session 上下文的一部分，不脱离 Session 单
 
 ## 2. 记忆快照的范围
 
+### 2.1 直注入预算
+
+记忆快照遵循与咕咕一致的按 scope 限制策略，避免 profile、daily 或长期
+memory 无限增长后挤占 DSH 对话上下文：
+
+- 群级记忆字段合计最多直注入 2000 个字符；
+- 当前发言成员的记忆字段合计最多直注入 2000 个字符；
+- 私聊成员记忆字段合计最多直注入 2000 个字符；
+- 近期沉淀优先保留末尾的最新内容；其他字段从开头保留；
+- 被裁剪的内容仍保存在 SQLite 中，不会因为注入预算被删除；
+- 预算只限制本轮 snapshot 文本，不改变 DSH Session 的历史或 compact 规则。
+
+这里的 2000 是稳定、可预测的字符预算，不是模型输出 `maxTokens`。反思和
+`daily → memory` 压缩仍分别使用 `memoryMaxTokens` 与
+`memoryCompressionMaxTokens` 控制输出长度。
+
 快照按照 Session 的聊天范围生成：
 
 ### 群聊 Session

package/docs/README.md

@@ -12,6 +12,8 @@ QQChat 是 DSH 的 out-of-tree QQ 官方 Bot 插件。文档按“如何开发
 | [DEVELOPMENT.md](DEVELOPMENT.md) | 安装、构建、测试、启动和 UI 验证 |
 | [MEMORY.md](MEMORY.md) | group/member scope、daily、memory、反思和压缩 |
 | [MEMORY_CONTEXT.md](MEMORY_CONTEXT.md) | DSH Session 内的记忆快照、TTL、compact 刷新和注入生命周期 |
+| [prds/README.md](prds/README.md) | PRD 撰写规范和产品需求文档导航 |
+| [prds/PRD-MEM-1-群记忆与群友记忆策略调整.md](prds/PRD-MEM-1-群记忆与群友记忆策略调整.md) | 基于 Gugu 策略的群记忆、群友批量记忆和私聊记忆调整计划 |
 | [MEDIA_AND_QUOTES.md](MEDIA_AND_QUOTES.md) | 媒体输入、引用消息、附件存储、安全和分阶段实现方案 |
 | [QUOTES.md](QUOTES.md) | QQ 引用索引、引用回填、附件复用和 Web 展示实施方案 |
 | [STREAMING.md](STREAMING.md) | QQ 私聊官方流式传输、队列、降级和故障复盘 |

package/docs/STREAMING.md

@@ -11,7 +11,7 @@
 推荐采用以下结构：
 
 ```text
-DSH assistant/chunk
+DSH `agent/assistant-stream` 的 chunk frame
   -> StreamingWriter
   -> 累计完整文本
   -> 节流定时器
@@ -118,7 +118,7 @@ interface StreamingWriterState {
 
 ### 2. 累计全文，不累计分片
 
-DSH 的 `assistant/chunk` 通常是增量文本：
+DSH 的 `agent/assistant-stream` chunk frame 通常携带增量文本：
 
 ```text
 "你好"