dsh-qqbot-expands 0.0.0-stage → 0.4.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-qqbot-fixes contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,311 @@
-# Temporary Holding Version
+# dsh-qqbot-expands
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+DeepSeek Harness（DSH）插件：**在 QQ 官方机器人插件 `@tencent-connect/dsh-qqbot` 基础上的功能拓展**。
+
+提供群聊频控、私聊主动问候、表情包、语音、绘图，以及一个统一设置页。
+
+> 本插件不是官方插件，与腾讯、DeepSeek 均无隶属关系；它是运行在官方 QQ 机器人插件之上的扩展层，只使用 QQ 开放平台公开接口与 DSH 官方插件机制。
+
+---
+
+## 合规声明（请先读）
+
+本插件是**官方 QQ 机器人插件的功能补全**，不替换、不修改官方插件代码，所有消息收发仍由官方插件完成。设计上遵守 QQ 开放平台规范：
+
+- **不伪造消息**：不合成 `msg_id` / `event_id`，不伪造平台事件，只处理平台真实下发的事件；
+- **不绕过配额**：主动消息、被动回复窗口、频率限制都按平台规则走，本插件只做“少回”的收敛，不做“多回”的突破；
+- **不读取无权限内容**：平台不下发的消息不抓取，群聊全量消息需要群主在群里开启对应权限后才生效；
+- **不收集、不上传数据**：所有状态只落在本机 `~/.dsh-qqbot/`，不向任何第三方回传；
+- **文件读取需管理员授权**：非管理员发送的图片/文件默认拦截，必须管理员明确同意后才读取；
+- 使用前请确认你的机器人已按 QQ 开放平台要求完成注册、审核，并在群主/管理员授权范围内使用。
+
+如果平台规则与本文冲突，以 QQ 开放平台规则为准。
+
+---
+
+## 前置依赖（重要）
+
+| 依赖 | 是否必须 | 说明 |
+| --- | --- | --- |
+| DSH（DeepSeek Harness） | **必须** | 插件运行在 DSH profile 中，建议 0.2.1 及以上 |
+| `@tencent-connect/dsh-qqbot` | **必须** | **官方 QQ 机器人插件，必须已安装并完成绑定**；本插件不包含任何 QQ 协议实现，没有它无法工作 |
+| `dsh-meme` | **表情包功能必须** | 提供 `send_meme` 与表情图库；不装则 `qqbot_send_meme` 找不到图库，表情包相关功能不可用 |
+| 外接 TTS / ASR 服务 | 语音功能可选 | GPT-SoVITS 或 OpenAI 兼容端点；没有则语音工具报“未配置” |
+| 绘图 API | 绘图功能可选 | 兼容 `images` / `chat` 两种协议的第三方服务 |
+
+**没有官方 QQ 机器人插件，本插件不会加载任何功能。** 本插件注册的工具都依赖官方插件提供的发送通道与会话管理。
+
+---
+
+## 安装
+
+### 方式 A：从 npm 安装（已发布版本，推荐）
+
+```bash
+dsh plugin --profile web add dsh-qqbot-expands
+```
+
+### 方式 B：从 GitHub 安装（跟 main 最新）
+
+```bash
+dsh plugin --profile web add "github:TONG5395/dsh-qqbot-expands"
+```
+
+`dsh plugin` 会把参数转给 profile 里的 pnpm。装完确认两件事：
+
+1. `~/.dsh/profiles/web/package.json` 的 `dependencies` 里有 `dsh-qqbot-expands`；
+2. 同文件 `dsh.profile.bundles` 数组里有 `"dsh-qqbot-expands"`（没有就手动加上）。
+
+也可以直接走 pnpm：
+
+```bash
+cd ~/.dsh/profiles/web
+pnpm add github:TONG5395/dsh-qqbot-expands
+```
+
+### 方式 C：本地目录
+
+```bash
+cd ~/.dsh/profiles/web
+pnpm add link:/path/to/dsh-qqbot-expands
+```
+
+### 方式 D：压缩包
+
+```bash
+cd ~/.dsh/profiles/web
+pnpm add file:/path/to/dsh-qqbot-expands-0.4.1.tar.gz
+```
+
+### 启用与配置
+
+1. 在 profile 的 `package.json` 里把 `"dsh-qqbot-expands"` 加进 `dsh.profile.bundles`；
+2. 在 profile 的 `cordis.patch.yml` 里加配置块（见下方“配置参考”）；
+3. 重启 DSH 引擎；
+4. 打开设置 →「QQ 机器人 · 问候」，六块设置都在这里。
+
+> 提示：`dsh plugin add` 只负责安装包，`dsh.profile.bundles` 与 `cordis.patch.yml` 里的配置仍需确认。装完可用 `dsh --profile web --dump-config` 检查条目是否出现。
+
+---
+
+## 功能教程
+
+### 1. 群聊频控（主动接话收敛）
+
+**解决什么问题**：官方插件在 `requireMention: false` 时，对每条群消息都回复，容易刷屏、烧 token。本插件在消息进入 agent 之前拦一道。
+
+**判定流程**（只针对群聊、且没有 @ 机器人的消息）：
+
+1. **无效消息过滤**：空内容、纯标点/表情、单个语气词（嗯/哦/好）、纯重复串（哈哈哈、66666）直接丢弃；
+2. **防抖合并**：消息先进队列，默认 30 秒内继续来的消息并入同一批，安静满 30 秒才结算；
+3. **概率**：结算时按 `chance` 掷骰，没中就**不丢弃**，进“积压”队列；
+4. **积压**：下次掷中时，把积压的消息和当前这批一起送进 agent，机器人按完整上下文回复；
+5. **限速**（可选）：`minIntervalMs` / `maxPerHour` / `maxPerDay`，默认全为 0（不限制）。
+
+**永远放行**：@ 机器人的消息、私聊消息。
+
+**文件与图片**：非管理员发送的带附件消息会被拦下，并在群里提示“需要主人同意”；管理员回复 `同意` / `允许` / `读吧` 后，原消息会被重放读取（有效期 10 分钟，同群提示有 5 分钟冷却）。管理员本人发的文件直接放行。
+
+**合并转发**：命中合并转发/ark 卡片时只取文字，不读取里面的图片和文件。
+
+**调参建议**：冷清群 `chance` 0.3~0.5；热闹群 0.1~0.2；`debounceMs` 30~60 秒；`backlogMax` 20~30 条。
+
+### 2. 私聊主动问候
+
+**触发条件**（全部满足）：
+
+- 只对**私聊**生效，群聊绝不主动搭话；
+- 对方**先说过话**（有历史对话），没聊过的新会话不打扰；
+- 当前时间在时段窗内（默认 22:00–08:00）；
+- 对方空闲时间超过 `idleBaseMs ± jitterRatio`（默认 2 小时 ±40%）；
+- 今晚问候次数未达 `maxPerNight`（默认 3 条）。
+
+**状态**：`~/.dsh-qqbot/greeting-state.json`；旧版 `greeter-state.json` 会自动迁移。
+
+**想立刻验证**：设置页把“静默时间窗”改成包含当前时间（例如 8–23），空闲基准改 1 分钟，检查间隔改 1 分钟，然后等 2~3 分钟。
+
+### 3. 表情包（依赖 dsh-meme）
+
+**前置**：必须安装 `dsh-meme` 并准备好图库（默认 `~/.dsh/meme-packs/`）。
+
+**工具**：`qqbot_send_meme`
+
+- `tag`：`daily` / `happy` / `angry` / `sad` / `confused` / `shy`；
+- `query`：按文件名关键词再筛（如 `猫`、`比心`、`无语`）；
+- 每次调用按 `meme.chance` 概率决定发不发；被概率拦下时返回 `sent:false`，这一轮不要重试。
+
+**图库目录自动检索**：配置 `packDir` → `$DSH_HOME/dsh-expression.json` 的 `memeRoot` / `enabledPacks[0]` → `$DSH_HOME/meme-packs/*` 里第一个含 `memes` 的包 → `~/.dsh/meme-packs/meme-pair-dict`。
+
+**必须在官方 QQ 插件里放行图库目录**：`im-qqbot` 配置的 `sendFile.extraRoots` 要包含图库根目录（例如 `/root/.dsh/meme-packs`），否则发送会被路径白名单拒绝。
+
+**建议提示词**（加到官方插件的 `directPrompt` / `groupPrompt`）：
+
+```
+表情包规则（qqbot_send_meme，QQ 专属）
+【默认】每轮回复配一张表情包；工具返回 sent:false 就这一轮只回文字，不要重试、不要自己补发。
+流程：1) 调 qqbot_send_meme，按情绪传 tag 或按内容传 query；
+      2) 工具会自动选图并发到当前 QQ 会话，不需要再调 qqbot_send_file；
+      3) sent:true 继续写正文；sent:false 说明频控拦了或没图，正文照常写。
+```
+
+### 4. 语音（TTS / ASR）
+
+**工具**：`qq_voice_say`（合成并发语音条）、`qq_voice_stt`（转写音频）、`qq_voice_status`（自检）。
+
+- TTS 支持两种协议：`gptsovits`（POST `{base}/tts`，`{text, ref, speed}`）与 `openai`（POST `{base}/audio/speech`）；
+- ASR 走 OpenAI 兼容 `POST {base}/audio/transcriptions`；
+- `autoSend: true` 时合成完自动调 `qqbot_send_file` 发到当前会话；
+- QQ 官方插件不会自动下载语音附件，转写需要先把音频拿到本地文件。
+
+**配置**：见下方 `voice` 段。地址可留空，用环境变量 `DSH_VOICE_TTS_BASE` / `DSH_VOICE_TTS_KEY` 等兜底。
+
+### 5. 绘图
+
+**工具**：`qqbot_draw_image`
+
+- 兼容 `images`（`POST {base}/images/generations`）与 `chat`（`POST {base}/chat/completions`）两种上游；
+- `protocol: auto` 时先按配置试，失败自动换另一条；
+- baseUrl 没写 `/v1` 时会自动补（兼容 new-api 一类服务）；
+- 生成结果落到 `~/.dsh-qqbot/media/`，模型再调 `qqbot_send_file` 发出；
+- 画角色本人时把 `character` 设为 `true`，会套用拟人化角色外观设定。
+
+### 6. 统一设置页
+
+重启后打开 设置 →「QQ 机器人 · 问候」，一页六块：
+
+- **管理员**：管理员 openid（一行一个），并生成“认人提示词”，一键复制贴进官方插件 prompt；
+- **群聊频控**：开关、接话概率、防抖秒数、无效过滤、文件审批；
+- **表情包**：开关、每条消息概率、当前图库目录；
+- **语音**：TTS/ASR 地址、密钥、协议、音色、格式、自动发送；
+- **绘图**：开关、地址、密钥、模型、尺寸、协议；
+- **私聊问候**：开关、时段窗、空闲基准、浮动、每晚额度、检查间隔、时区、问候语。
+
+保存写入 `~/.dsh-qqbot/settings.json`，立即生效；改完设置页需要刷新一次 Web 界面（首次出现该页需要重启引擎）。
+
+---
+
+## 配置参考
+
+```yaml
+- id: qqbot-expands
+  name: 'dsh-qqbot-expands'
+  config:
+    gate:
+      enabled: true
+      chance: 0.25            # 防抖到点后的接话概率
+      debounceMs: 30000       # 静默多久合并一批
+      backlogMax: 30          # 没随机到的消息最多攒多少条
+      backlogInvalid: false   # 无效噪音是否也进积压
+      minIntervalMs: 0        # 0 = 不限制
+      maxPerHour: 0
+      maxPerDay: 0
+      invalid:
+        enabled: true
+        minLength: 2
+        dropPureRepeat: true
+        dropPurePunctuation: true
+        dropFiller: true
+      files:
+        requireAdminApproval: true
+        adminOpenids: []      # 建议在设置页填
+        approvalKeywords: [同意, 允许, 可以读, 读吧, 批准, 看吧]
+        approvalTtlMs: 600000
+        noticeCooldownMs: 300000
+      skipMergedAttachments: true
+      botIds: []              # 机器人 openid 等额外 id（@ 判定兜底）
+    meme:
+      enabled: true
+      packDir: ''             # 空 = 自动检索 dsh-meme 图库
+      chance: 0.6             # 每条消息附带表情包的概率
+      maxRecent: 3
+    voice:
+      enabled: true
+      ttsBaseUrl: ''
+      ttsApiKey: ''
+      ttsProtocol: gptsovits  # gptsovits / openai
+      ttsModel: ''
+      ttsVoice: default
+      ttsFormat: wav
+      asrBaseUrl: ''
+      asrApiKey: ''
+      asrModel: whisper-large-v3-turbo
+      autoSend: true
+      timeoutMs: 120000
+    drawing:
+      enabled: true
+      baseUrl: ''
+      apiKey: ''
+      model: ''
+      size: 1024x1024
+      protocol: auto          # images / chat / auto
+      timeoutMs: 300000
+    greeting:
+      enabled: true
+      idleBaseMs: 7200000
+      jitterRatio: 0.4
+      quietStartHour: 22
+      quietEndHour: 8
+      maxPerNight: 3
+      checkIntervalMs: 300000
+      tzOffsetHours: 8
+      greetings: []
+```
+
+### 官方 QQ 插件的配套设置
+
+```yaml
+- id: im-qqbot
+  config:
+    requireMention: false     # 频控才有意义；改回 true 请同时关闭 gate.enabled
+    sendFile:
+      restrictPaths: true
+      extraRoots:
+        - /root/.dsh/meme-packs   # 表情包目录必须放行
+```
+
+---
+
+## 常见问题
+
+**机器人完全不回复？**
+先看官方插件是否正常（绑定、网关、`requireMention`），再看群主是否开启了全量消息权限；最后看设置页概率与防抖。
+
+**@ 了也不回？**
+多数是 @ 识别问题：设置页把机器人 openid 填进 `botIds`（从日志或官方插件会话里能看到）。
+
+**表情包发不出去？**
+检查 `sendFile.extraRoots` 是否包含图库根目录；设置页能看到当前解析到的图库路径。
+
+**文件/图片不读？**
+需要管理员 openid，且非管理员文件必须管理员回复“同意”。
+
+**语音没声音？**
+TTS 地址/协议/密钥是否配好；服务端是否支持对应格式。
+
+**设置页看不到？**
+重启引擎一次，再刷新页面。
+
+---
+
+## 开发与测试
+
+```bash
+node test-gate.mjs      # 群聊频控
+node test-greeting.mjs  # 私聊问候 + 设置页路由
+node test-meme.mjs      # 表情包挑选与概率
+node test-draw.mjs      # 绘图协议
+```
+
+四个测试都不联网，使用临时状态文件。
+
+> 这四个脚本只存在于源码仓库，不在 npm 包的 `files` 白名单里，所以从 npm 装到的版本没有它们；要跑测试请克隆仓库后在根目录执行。
+> `test-meme.mjs` 需要本机有可用的表情图库（默认 `~/.dsh/meme-packs/meme-pair-dict/memes/<情绪>/`），挑不到图会失败。
+
+---
+
+## 免责声明
+
+- 本项目是社区插件，非官方项目，与腾讯 / DeepSeek 无隶属关系。
+- 使用本插件即表示你已阅读并遵守 QQ 开放平台的相关规则；因违反平台规则导致的后果由使用者自行承担。
+- 请勿用于骚扰、刷屏、垃圾营销等场景。本项目只做“少回、可控”的收敛。
+- 软件按 MIT 协议“原样”提供，不附带任何担保。

package/client.js

@@ -0,0 +1,306 @@
+// client.js — @local/dsh-qqbot-expands 的浏览器半边
+//
+// 设置 →「QQ 机器人 · 问候」一页管全部 QQ 适配：
+//   管理员 / 群聊频控 / 表情包 / 语音 / 绘图 / 私聊问候。
+// 数据来自宿主路由 /qqbot-expands/settings（GET 读、POST 写），保存后立即生效。
+
+window.__ModuleLoader__.load({
+  id: 'dsh-qqbot-expands',
+  factory(require) {
+    const React = require('react')
+    const h = React.createElement
+    const module = { exports: {} }
+    const exports = module.exports
+    const API = '/qqbot-expands/settings'
+
+    const S = {
+      wrap: { display: 'flex', flexDirection: 'column', gap: 16, padding: '4px 0 24px' },
+      block: { display: 'flex', flexDirection: 'column', gap: 10, paddingBottom: 14, borderBottom: '0.5px solid var(--dsw-alias-border-l3)' },
+      title: { fontSize: 14, fontWeight: 600, color: 'var(--dsw-alias-label-primary)' },
+      row: { display: 'flex', alignItems: 'center', gap: 10, flexWrap: 'wrap' },
+      label: { fontSize: 13, color: 'var(--dsw-alias-label-secondary)', minWidth: 110 },
+      input: {
+        width: 120, height: 30, padding: '0 8px', borderRadius: 8,
+        border: '0.5px solid var(--dsw-alias-border-l3)', background: 'transparent',
+        color: 'var(--dsw-alias-label-primary)', font: 'inherit', fontSize: 13,
+      },
+      wide: {
+        width: 260, height: 30, padding: '0 8px', borderRadius: 8,
+        border: '0.5px solid var(--dsw-alias-border-l3)', background: 'transparent',
+        color: 'var(--dsw-alias-label-primary)', font: 'inherit', fontSize: 13,
+      },
+      area: {
+        width: '100%', minHeight: 72, padding: 8, borderRadius: 8, resize: 'vertical',
+        border: '0.5px solid var(--dsw-alias-border-l3)', background: 'transparent',
+        color: 'var(--dsw-alias-label-primary)', font: 'inherit', fontSize: 13, boxSizing: 'border-box',
+      },
+      btn: {
+        height: 30, padding: '0 14px', borderRadius: 999, cursor: 'pointer', font: 'inherit', fontSize: 13,
+        border: '0.5px solid var(--dsw-alias-brand-primary)', background: 'var(--dsw-alias-brand-primary)',
+        color: '#fff',
+      },
+      ghost: {
+        height: 28, padding: '0 12px', borderRadius: 999, cursor: 'pointer', font: 'inherit', fontSize: 12,
+        border: '0.5px solid var(--dsw-alias-border-l3)', background: 'transparent',
+        color: 'var(--dsw-alias-label-secondary)',
+      },
+      hint: { fontSize: 12, color: 'var(--dsw-alias-label-tertiary)' },
+      ok: { fontSize: 12, color: 'var(--dsw-alias-state-success-primary, #2f9e44)' },
+      err: { fontSize: 12, color: 'var(--dsw-alias-state-error-primary, #e03131)' },
+      mono: { fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace', fontSize: 12 },
+    }
+
+    function toDraft(d) {
+      const g = d.greeting || {}
+      const gate = d.gate || {}
+      const m = d.meme || {}
+      const v = d.voice || {}
+      const dr = d.drawing || {}
+      return {
+        adminText: (d.adminOpenids || []).join('\n'),
+        gate: {
+          enabled: gate.enabled !== false,
+          chancePct: Math.round((gate.chance ?? 0.25) * 100),
+          debounceSec: Math.round((gate.debounceMs ?? 30000) / 1000),
+          invalidEnabled: gate.invalid?.enabled !== false,
+          fileApproval: gate.files?.requireAdminApproval !== false,
+        },
+        meme: { enabled: m.enabled !== false, chancePct: Math.round((m.chance ?? 0.6) * 100) },
+        voice: {
+          enabled: v.enabled !== false,
+          ttsBaseUrl: v.ttsBaseUrl || '',
+          ttsApiKey: v.ttsApiKey || '',
+          ttsProtocol: v.ttsProtocol || 'gptsovits',
+          ttsModel: v.ttsModel || '',
+          ttsVoice: v.ttsVoice || 'default',
+          ttsFormat: v.ttsFormat || 'wav',
+          asrBaseUrl: v.asrBaseUrl || '',
+          asrApiKey: v.asrApiKey || '',
+          asrModel: v.asrModel || 'whisper-large-v3-turbo',
+          autoSend: v.autoSend !== false,
+        },
+        drawing: {
+          enabled: dr.enabled !== false,
+          baseUrl: dr.baseUrl || '',
+          apiKey: dr.apiKey || '',
+          model: dr.model || '',
+          size: dr.size || '1024x1024',
+          protocol: dr.protocol || 'auto',
+        },
+        greeting: {
+          enabled: g.enabled !== false,
+          idleMinutes: Math.round((g.idleBaseMs || 7200000) / 60000),
+          jitterPct: Math.round((g.jitterRatio || 0) * 100),
+          quietStartHour: g.quietStartHour ?? 22,
+          quietEndHour: g.quietEndHour ?? 8,
+          maxPerNight: g.maxPerNight ?? 3,
+          checkMinutes: Math.round((g.checkIntervalMs || 300000) / 60000),
+          tzOffsetHours: g.tzOffsetHours ?? 8,
+          greetingsText: Array.isArray(g.greetings) ? g.greetings.join('\n') : '',
+        },
+      }
+    }
+
+    function Section() {
+      const [draft, setDraft] = React.useState(null)
+      const [snapshot, setSnapshot] = React.useState(null)
+      const [msg, setMsg] = React.useState({ kind: '', text: '' })
+      const [busy, setBusy] = React.useState(false)
+      const [copied, setCopied] = React.useState(false)
+
+      React.useEffect(() => {
+        let alive = true
+        fetch(API)
+          .then((r) => r.json())
+          .then((d) => { if (!alive) return; setSnapshot(d); setDraft(toDraft(d)) })
+          .catch((err) => { if (alive) setMsg({ kind: 'err', text: '读取失败：' + err.message }) })
+        return () => { alive = false }
+      }, [])
+
+      if (!draft) return h('div', { style: S.wrap }, h('div', { style: S.hint }, '正在读取设置…'))
+
+      const upd = (section, key) => (event) => {
+        const value = event.target.type === 'checkbox' ? event.target.checked : event.target.value
+        setDraft({ ...draft, [section]: { ...draft[section], [key]: value } })
+      }
+      const setTop = (key) => (event) => setDraft({ ...draft, [key]: event.target.value })
+
+      const save = async () => {
+        setBusy(true)
+        setMsg({ kind: '', text: '' })
+        const g = draft.greeting, gt = draft.gate, m = draft.meme, v = draft.voice, dr = draft.drawing
+        const payload = {
+          adminOpenids: String(draft.adminText || '').split('\n').map((s) => s.trim()).filter(Boolean),
+          gate: {
+            enabled: Boolean(gt.enabled),
+            chance: Math.min(100, Math.max(0, Number(gt.chancePct) || 0)) / 100,
+            debounceMs: Math.max(5, Number(gt.debounceSec) || 0) * 1000,
+            invalid: { enabled: Boolean(gt.invalidEnabled) },
+            files: { requireAdminApproval: Boolean(gt.fileApproval) },
+          },
+          meme: { enabled: Boolean(m.enabled), chance: Math.min(100, Math.max(0, Number(m.chancePct) || 0)) / 100 },
+          voice: {
+            enabled: Boolean(v.enabled),
+            ttsBaseUrl: v.ttsBaseUrl, ttsApiKey: v.ttsApiKey, ttsProtocol: v.ttsProtocol,
+            ttsModel: v.ttsModel, ttsVoice: v.ttsVoice, ttsFormat: v.ttsFormat,
+            asrBaseUrl: v.asrBaseUrl, asrApiKey: v.asrApiKey, asrModel: v.asrModel,
+            autoSend: Boolean(v.autoSend),
+          },
+          drawing: {
+            enabled: Boolean(dr.enabled), baseUrl: dr.baseUrl, apiKey: dr.apiKey,
+            model: dr.model, size: dr.size, protocol: dr.protocol,
+          },
+          greeting: {
+            enabled: Boolean(g.enabled),
+            idleBaseMs: Math.max(1, Number(g.idleMinutes) || 0) * 60000,
+            jitterRatio: Math.min(100, Math.max(0, Number(g.jitterPct) || 0)) / 100,
+            quietStartHour: Number(g.quietStartHour),
+            quietEndHour: Number(g.quietEndHour),
+            maxPerNight: Number(g.maxPerNight),
+            checkIntervalMs: Math.max(1, Number(g.checkMinutes) || 0) * 60000,
+            tzOffsetHours: Number(g.tzOffsetHours),
+            greetings: String(g.greetingsText || '').split('\n').map((s) => s.trim()).filter(Boolean),
+          },
+        }
+        try {
+          const res = await fetch(API, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify(payload) })
+          const data = await res.json().catch(() => ({}))
+          if (!res.ok || data.ok === false) throw new Error(data.error || ('HTTP ' + res.status))
+          setSnapshot(data)
+          setDraft(toDraft(data))
+          setMsg({ kind: 'ok', text: '已保存，立即生效' })
+        } catch (err) {
+          setMsg({ kind: 'err', text: '保存失败：' + err.message })
+        } finally {
+          setBusy(false)
+        }
+      }
+
+      const copyPrompt = async () => {
+        try {
+          await navigator.clipboard.writeText(snapshot?.adminPrompt || '')
+          setCopied(true)
+          setTimeout(() => setCopied(false), 1500)
+        } catch (err) {
+          setMsg({ kind: 'err', text: '复制失败：' + err.message })
+        }
+      }
+
+      const input = (section, key, opts = {}) => h('input', {
+        style: opts.wide ? S.wide : S.input,
+        type: opts.type || 'text',
+        min: opts.min, max: opts.max, placeholder: opts.placeholder,
+        value: draft[section][key],
+        onChange: upd(section, key),
+      })
+      const check = (section, key) => h('input', { type: 'checkbox', checked: Boolean(draft[section][key]), onChange: upd(section, key) })
+      const line = (label, ...children) => h('div', { style: S.row }, h('span', { style: S.label }, label), ...children)
+
+      const g = draft.greeting, gt = draft.gate, m = draft.meme, v = draft.voice, dr = draft.drawing
+      const peers = snapshot?.greetingState?.peers || []
+
+      return h('div', { style: S.wrap },
+
+        // 管理员
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '管理员'),
+          h('div', { style: S.hint }, '一行一个 openid。文件读取审批、认人提示词都会用到。'),
+          h('textarea', { style: { ...S.area, ...S.mono }, placeholder: '在这里填管理员的 openid，一行一个', value: draft.adminText, onChange: setTop('adminText') }),
+          line('辨认提示词', h('button', { style: S.ghost, type: 'button', onClick: copyPrompt }, copied ? '已复制' : '复制'), h('span', { style: S.hint }, '贴进 QQ 机器人的 directPrompt / groupPrompt')),
+          h('textarea', { style: { ...S.area, ...S.mono, minHeight: 66 }, readOnly: true, value: snapshot?.adminPrompt || '' }),
+        ),
+
+        // 群聊频控
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '群聊频控'),
+          line('开启频控', check('gate', 'enabled'), h('span', { style: S.hint }, '未 @ 的群消息先过闸再决定接不接')),
+          line('接话概率', input('gate', 'chancePct', { type: 'number', min: 0, max: 100 }), h('span', { style: S.hint }, '%（防抖到点后掷骰）')),
+          line('防抖', input('gate', 'debounceSec', { type: 'number', min: 5 }), h('span', { style: S.hint }, '秒内继续来的消息合并成一批')),
+          line('无效消息过滤', check('gate', 'invalidEnabled'), h('span', { style: S.hint }, '语气词、纯标点、重复串直接丢')),
+          line('文件需管理员同意', check('gate', 'fileApproval'), h('span', { style: S.hint }, '非管理员发的图片/文件先拦下')),
+        ),
+
+        // 表情包
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '表情包'),
+          line('开启表情包', check('meme', 'enabled')),
+          line('每条消息概率', input('meme', 'chancePct', { type: 'number', min: 0, max: 100 }), h('span', { style: S.hint }, '%（每条回复独立掷骰）')),
+          h('div', { style: S.hint }, '图库目录：' + (snapshot?.meme?.resolvedPackDir || '自动检索中')),
+        ),
+
+        // 语音
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '语音'),
+          line('开启语音', check('voice', 'enabled'), h('span', { style: S.hint }, 'TTS 合成语音条 / ASR 转写')),
+          line('TTS 地址', input('voice', 'ttsBaseUrl', { wide: true, placeholder: 'https://…' })),
+          line('TTS 密钥', input('voice', 'ttsApiKey', { wide: true, placeholder: '可留空' })),
+          line('TTS 协议', h('select', { style: S.wide, value: v.ttsProtocol, onChange: upd('voice', 'ttsProtocol') },
+            h('option', { value: 'gptsovits' }, 'gptsovits'),
+            h('option', { value: 'openai' }, 'openai'),
+          )),
+          line('音色 / 模型', input('voice', 'ttsVoice', { wide: true }), input('voice', 'ttsModel', { wide: true })),
+          line('格式', input('voice', 'ttsFormat', { placeholder: 'wav' })),
+          line('ASR 地址', input('voice', 'asrBaseUrl', { wide: true, placeholder: '可留空' })),
+          line('ASR 密钥', input('voice', 'asrApiKey', { wide: true })),
+          line('ASR 模型', input('voice', 'asrModel', { wide: true })),
+          line('合成后自动发送', check('voice', 'autoSend')),
+        ),
+
+        // 绘图
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '绘图'),
+          line('开启绘图', check('drawing', 'enabled')),
+          line('接口地址', input('drawing', 'baseUrl', { wide: true, placeholder: 'https://…/v1' })),
+          line('密钥', input('drawing', 'apiKey', { wide: true })),
+          line('模型', input('drawing', 'model', { wide: true })),
+          line('尺寸', input('drawing', 'size', { placeholder: '1024x1024' })),
+          line('协议', h('select', { style: S.wide, value: dr.protocol, onChange: upd('drawing', 'protocol') },
+            h('option', { value: 'auto' }, 'auto'),
+            h('option', { value: 'images' }, 'images'),
+            h('option', { value: 'chat' }, 'chat'),
+          )),
+        ),
+
+        // 私聊问候
+        h('div', { style: S.block },
+          h('div', { style: S.title }, '私聊主动问候'),
+          line('开启问候', check('greeting', 'enabled'), h('span', { style: S.hint }, '只问候私聊，群聊绝不主动搭话')),
+          line('静默时间窗',
+            input('greeting', 'quietStartHour', { type: 'number', min: 0, max: 23 }), h('span', { style: S.hint }, '点 —'),
+            input('greeting', 'quietEndHour', { type: 'number', min: 0, max: 23 }), h('span', { style: S.hint }, '点（跨午夜也行）')),
+          line('空闲基准',
+            input('greeting', 'idleMinutes', { type: 'number', min: 1 }), h('span', { style: S.hint }, '分钟，±'),
+            input('greeting', 'jitterPct', { type: 'number', min: 0, max: 100 }), h('span', { style: S.hint }, '% 浮动')),
+          line('每晚最多',
+            input('greeting', 'maxPerNight', { type: 'number', min: 0, max: 50 }), h('span', { style: S.hint }, '条'),
+            h('span', { style: S.label, minWidth: 0 }, '检查间隔'),
+            input('greeting', 'checkMinutes', { type: 'number', min: 1 }), h('span', { style: S.hint }, '分钟')),
+          line('时区偏移', input('greeting', 'tzOffsetHours', { type: 'number', min: -12, max: 14 }), h('span', { style: S.hint }, '小时（东八区填 8）')),
+          line('问候语', h('textarea', { style: S.area, placeholder: '每行一条；留空用内置的几句', value: g.greetingsText, onChange: upd('greeting', 'greetingsText') })),
+          h('div', { style: S.hint }, '今晚已登记 ' + peers.length + ' 个私聊' +
+            (peers.length > 0 ? '：' + peers.slice(0, 4).map((p) => (p.name || p.id.slice(0, 6)) + '(' + (p.idleMinutes ?? '—') + '分钟)').join('、') : '')),
+        ),
+
+        h('div', { style: S.row },
+          h('button', { style: S.btn, type: 'button', disabled: busy, onClick: save }, busy ? '保存中…' : '保存'),
+          msg.kind === 'ok' ? h('span', { style: S.ok }, msg.text) : null,
+          msg.kind === 'err' ? h('span', { style: S.err }, msg.text) : null,
+        ),
+      )
+    }
+
+    function apply(ctx) {
+      ctx.slots.inject('settings.section', () => ctx.slots.register({
+        name: 'settings.section',
+        id: 'qqbot-expands',
+        order: 8,
+        label: 'QQ 机器人 · 问候',
+      }, Section))
+    }
+
+    const inject = ['slots']
+    exports.apply = apply
+    exports.inject = inject
+    return module.exports
+  },
+})