@cxyhhhhh/dsh-qqbot 0.3.0-dev.202608160954 → 0.4.0

package/.orange-ci.yml

@@ -1,68 +1,2 @@
-$:
-  tag_push:
-    - services:
-        - docker
-      docker:
-        image: node:24
-      runner:
-        network: devnet
-      stages:
-        - name: 安装依赖
-          script: npm install
-        - name: 构建项目
-          script: npm run build
-        - name: 配置 npm 官方源
-          script: npm config set registry https://registry.npmjs.org
-        - name: 配置 token
-          imports: https://git.woa.com/qq-ai/web/secret/blob/master/envs/npm/npmjs.txt
-          script: npm config set //registry.npmjs.org/:_authToken=$NPM_TOKEN
-        - name: 设置 npm 包版本号
-          script: npm version ${ORANGE_BRANCH} --no-git-tag-version --allow-same-version
-        - name: 发布 npm 包
-          script: npm publish --access public
-        - name: 生成通知
-          script: echo "@tencent-connect/dsh-qqbot@${ORANGE_BRANCH} 发布成功" > message.txt
-        - name: 发送通知
-          type: wework:message
-          options:
-            fromFile: message.txt
-
-# ── master 分支：MR 检查 ──
-master:
-  merge_request:
-    - docker:
-        image: node:24
-      wework:
-        silent: true
-      stages:
-        - name: 安装依赖
-          script: npm install
-        - name: TypeScript 类型检查
-          script: npx tsc --noEmit
-
-# ── feat/fix 分支 push：内网发布 dev 版本 ──
-(feat|fix)/**:
-  push:
-    - docker:
-        image: node:24
-      runner:
-        network: devnet
-      stages:
-        - name: 安装依赖
-          script: npm install
-        - name: 构建项目
-          script: npm run build
-        - name: 设置测试包名
-          script: npm run ci:prepare-test-pkg
-        - name: 设置测试版本
-          script: npm version "0.0.0-dev.${ORANGE_COMMIT_SHORT}" --no-git-tag-version
-        - name: 发布 npm 包
-          image: tencentcom/npm:latest
-          imports: https://git.woa.com/qq-ai/web/secret/blob/master/envs/npm/public.txt
-          settings:
-            username: $USER
-            password: $PWD
-            email: $EMAIL
-            registry: https://mirrors.tencent.com/npm/
-            folder: ./
-            tag: dev
+include:
+  - https://git.woa.com/qq-ai/web/secret/blob/master/ci/tencent-connect/dsh-qqbot.yml

package/CHANGELOG.md

@@ -4,6 +4,21 @@
 
 格式遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)。
 
+## [0.4.0] - 2026-08-16
+
+### 新功能
+
+- **扫码链接**：二维码显示异常时，可直接点击终端输出的链接，在浏览器中完成扫码。
+
+### 体验优化
+
+- 支持 Windows 平台自动保存扫码凭据（此前会因路径问题失效）。
+- 凭据自动保存失败时，会明确引导手动配置，不再静默丢失已有配置。
+
+### 文档
+
+- 新增扫码示意图与升级引导。
+
 ## [0.3.0] - 2026-08-15
 
 ### 新功能

package/README.md

@@ -1,8 +1,19 @@
-# @tencent-connect/dsh-qqbot
+<div align="center">
 
-基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot IM 插件，将 QQ 消息平台作为 dsh agent 的前端协议驱动。
+<img width="120" src="https://img.shields.io/badge/🤖-QQ_Bot-blue?style=for-the-badge" alt="QQ Bot" />
 
-中文 | [English](./README_EN.md)
+**基于 [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) 的 QQ Bot 插件，将 DeepSeek AI 助手接入 QQ 私聊与群聊。**
+
+[![npm version](https://img.shields.io/npm/v/@tencent-connect/dsh-qqbot)](https://www.npmjs.com/package/@tencent-connect/dsh-qqbot)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/tencent-connect/dsh-qqbot)](https://github.com/tencent-connect/dsh-qqbot)
+[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
+
+<br/>
+
+**[English](./README_EN.md) | 简体中文**
+
+</div>
 
 ## 架构
 
@@ -19,14 +30,18 @@ QQ 用户 → QQ WebSocket → dsh-im-qqbot → ctx.agents → dsh agent loop
 
 ```bash
 # 安装到 profile
-dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
+npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
 
 # 启动
-dsh --profile qqbot
+npx @deepseek-ai/dsh --profile qqbot
 ```
 
 首次启动时，插件检测到凭据未配置会自动进入扫码引导：终端输出二维码 → 手机 QQ 扫码绑定 → 凭据自动保存到 profile，后续启动无需再次扫码。
 
+<img src="./docs/assets/qrcode.png" alt="二维码扫码示意图" width="280" />
+
+> **提示**：建议升级至 `0.4.0` 以上版本扫码，支持点击链接在浏览器打开，避免部分终端二维码渲染错位的问题。
+
 ### 方式二：本地路径安装
 
 ```bash
@@ -35,19 +50,18 @@ cd /path/to/dsh-qqbot
 pnpm install && pnpm build
 
 # 安装到 profile（本地路径）
-dsh plugin --profile qqbot add /path/to/dsh-qqbot
+npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot
 
 # 启动
 export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
-dsh --profile qqbot
+npx @deepseek-ai/dsh --profile qqbot
 ```
 
 ### 方式三：--patch 开发模式
 
 ```bash
-cd /path/to/deepseek-harness
 export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
-pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 ```
 
 ## 配置项
@@ -65,14 +79,20 @@ pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 | `directPrompt` | string | - | 私聊额外 system prompt |
 | `textChunkLimit` | number | `4500` | 单条消息最大字符数 |
 | `sessionIdleTimeout` | number | `1800000` | 会话闲置超时(ms)，默认 30 分钟 |
+| `askTimeoutMs` | number | `300000` | 待答问题超时(ms)，默认 5 分钟（ask_user_question） |
 | `debug` | boolean | `false` | 调试模式 |
 
 ## 内置命令
 
 | 命令 | 说明 |
 |------|------|
-| `/bot-reset` | 重置当前会话（清除上下文） |
-| `/bot-model` | 查看或切换模型 |
+| `/new`（别名 `/reset` `/clear`） | 开始新会话（清空上下文） |
+| `/compact` | 压缩会话历史（摘要替换旧记录，保留上下文） |
+| `/model` | 查看或切换模型 |
+| `/preset` | 查看或切换 agent preset（新会话生效） |
+| `/stop` | 中止当前生成 |
+| `/bot-ping` | 连通性测试 |
+| `/bot-version` | 查看版本信息 |
 | `/bot-status` | 查看当前会话状态 |
 | `/bot-help` | 查看所有指令 |
 
@@ -118,6 +138,7 @@ sessionKey: `qqbot:${appId}:${scope}:${peerId}`，由 SHA-256 确定性派生 Se
 - **Preset 支持** — 可通过 `agent-presets` 服务挂载预设（工具集、prompt 等）
 - **闲置回收** — 超时自动 dispose Agent，防止内存泄漏
 - **Markdown 输出** — 回复以 Markdown 格式发送，支持代码块/表格感知切分
+- **问答互动** — 支持 `ask_user_question`，单选生成内联按钮（点一个其余变灰）、多选回复编号，逐题推进 + 问题级超时
 
 ## 本地开发
 
@@ -131,10 +152,9 @@ pnpm build
 # 开发模式（watch）
 pnpm dev
 
-# 用 --patch 方式调试（在 dsh monorepo 中）
-cd /path/to/deepseek-harness
+# 用 --patch 方式调试
 export QQBOT_APPID="xxx" QQBOT_SECRET="xxx"
-pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 ```
 
 ## License

package/README_EN.md

@@ -1,8 +1,19 @@
-# @tencent-connect/dsh-qqbot
+<div align="center">
 
-A QQ Bot IM plugin for [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh), driving the dsh agent loop with the QQ messaging platform as the frontend protocol.
+<img width="120" src="https://img.shields.io/badge/🤖-QQ_Bot-blue?style=for-the-badge" alt="QQ Bot" />
 
-[中文文档](./README.md) | English
+**A QQ Bot plugin for [deepseek-harness](https://github.com/deepseek-ai/deepseek-harness) (dsh), connecting DeepSeek AI assistants to QQ private and group chats.**
+
+[![npm version](https://img.shields.io/npm/v/@tencent-connect/dsh-qqbot)](https://www.npmjs.com/package/@tencent-connect/dsh-qqbot)
+[![License](https://img.shields.io/badge/license-MIT-green)](./LICENSE)
+[![GitHub stars](https://img.shields.io/github/stars/tencent-connect/dsh-qqbot)](https://github.com/tencent-connect/dsh-qqbot)
+[![QQ Bot](https://img.shields.io/badge/QQ_Bot-API_v2-red)](https://bot.q.qq.com/wiki/)
+
+<br/>
+
+**[简体中文](./README.md) | English**
+
+</div>
 
 ## Architecture
 
@@ -19,14 +30,18 @@ QQ User → QQ WebSocket → dsh-im-qqbot → ctx.agents → dsh agent loop →
 
 ```bash
 # Add to a profile
-dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
+npx @deepseek-ai/dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
 
 # Start
-dsh --profile qqbot
+npx @deepseek-ai/dsh --profile qqbot
 ```
 
 On first launch, the plugin detects missing credentials and automatically starts the QR flow: a QR code is printed in the terminal → scan it with the QQ mobile app → credentials are saved to the profile, so subsequent launches require no re-scan.
 
+<img src="./docs/assets/qrcode.png" alt="QR code scan example" width="280" />
+
+> **Note**: Upgrade to `0.4.0` or later for browser-link scanning, which avoids QR code misalignment in some terminals.
+
 ### Method 2: Local path
 
 ```bash
@@ -35,19 +50,18 @@ cd /path/to/dsh-qqbot
 pnpm install && pnpm build
 
 # Add to a profile (local path)
-dsh plugin --profile qqbot add /path/to/dsh-qqbot
+npx @deepseek-ai/dsh plugin --profile qqbot add /path/to/dsh-qqbot
 
 # Start
 export QQBOT_APPID="yourAppID" QQBOT_SECRET="yourAppSecret"
-dsh --profile qqbot
+npx @deepseek-ai/dsh --profile qqbot
 ```
 
 ### Method 3: --patch dev mode
 
 ```bash
-cd /path/to/deepseek-harness
 export QQBOT_APPID="yourAppID" QQBOT_SECRET="yourAppSecret"
-pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 ```
 
 ## Configuration
@@ -65,14 +79,20 @@ pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 | `directPrompt` | string | - | Extra system prompt for direct chats |
 | `textChunkLimit` | number | `4500` | Max chars per message |
 | `sessionIdleTimeout` | number | `1800000` | Session idle timeout (ms), default 30 min |
+| `askTimeoutMs` | number | `300000` | Question timeout (ms), default 5 min (ask_user_question) |
 | `debug` | boolean | `false` | Debug mode |
 
 ## Built-in Commands
 
 | Command | Description |
 |------|------|
-| `/bot-reset` | Reset the current session (clear context) |
-| `/bot-model` | View or switch model |
+| `/new` (aliases `/reset` `/clear`) | Start a new session (clear context) |
+| `/compact` | Compact session history (replace old records with a summary) |
+| `/model` | View or switch model |
+| `/preset` | View or switch agent preset (applies to new sessions) |
+| `/stop` | Abort the current generation |
+| `/bot-ping` | Connectivity test |
+| `/bot-version` | View version info |
 | `/bot-status` | View current session status |
 | `/bot-help` | View all commands |
 
@@ -118,6 +138,7 @@ Resolution strategy: in-process reuse → persisted resume → fresh create.
 - **Preset support** — mount presets (toolkits, prompts, etc.) via the `agent-presets` service
 - **Idle eviction** — auto-dispose Agents on timeout to prevent memory leaks
 - **Markdown output** — replies sent as Markdown with code-block/table-aware chunking
+- **Question interaction** — supports `ask_user_question` with inline keyboard buttons (mutually exclusive) or numbered replies, one question at a time with timeout
 
 ## Local Development
 
@@ -131,10 +152,9 @@ pnpm build
 # Dev mode (watch)
 pnpm dev
 
-# Debug via --patch (inside the dsh monorepo)
-cd /path/to/deepseek-harness
+# Debug via --patch
 export QQBOT_APPID="xxx" QQBOT_SECRET="xxx"
-pnpm dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
+npx @deepseek-ai/dsh web --patch /path/to/dsh-qqbot/cordis.dev.yml
 ```
 
 ## License

package/cordis.patch.yml

@@ -22,7 +22,7 @@
         textChunkLimit: 4500
         sessionIdleTimeout: 1800000
         maxQueue: 20
-        processingTimeoutMs: 120000
+        processingTimeoutMs: 1800000
         historyLimit: 10
         access:
           c2cMode: open

package/cordis.yml

@@ -7,6 +7,8 @@
 #   QQBOT_SECRET    - QQ Bot AppSecret
 #   DEEPSEEK_API_KEY - DeepSeek API Key
 #   DSH_CWD         - Agent 工作目录（可选）
+#   HUNYUAN_API_KEY - 视觉模型 API Key（qqbot_describe_image 工具，hunyuan-vision）
+#   DSH_PRESET_ROOT - 系统预置 preset 目录（可选，默认 ./apps/cli/config/agent-presets）
 
 # ── 核心 spine ──
 - id: sessions
@@ -21,15 +23,52 @@
 - id: system-prompt
   name: '@deepseek-ai/dsh-system-prompt'
 
+- id: approval
+  name: '@deepseek-ai/dsh-user-approval'
+  config:
+    policy: !!js "process.platform === 'win32' ? 'never' : ((process.env.DSH_PERMISSION_MODE ?? 'workspace-write') === 'danger-full-access' ? 'never' : 'ask')"
+
 - id: tools
   name: '@deepseek-ai/dsh-tools'
 
+# ── Agent Preset 服务（/preset 命令切换 preset 依赖） ──
+- id: agent-presets
+  name: '@deepseek-ai/dsh-agent-presets'
+  config:
+    default: standard
+    roots:
+      # 系统预置 preset 目录（deepseek-harness 的 apps/cli/config/agent-presets，含 standard/code/cordis/minimal）
+      - path: ${DSH_PRESET_ROOT:-./apps/cli/config/agent-presets}
+        trust: system
+    # includeUserRoot 默认 true：额外加载 $DSH_HOME/.agent-presets（用户自定义 preset）
+
+# ── 附件存储（describe_image 工具的 attachments.saveImage 依赖） ──
+- id: attachment-local
+  name: '@deepseek-ai/dsh-attachment-local'
+
 # ── LLM 适配器 ──
 - id: llm-deepseek
   name: '@deepseek-ai/dsh-llm-deepseek'
   config:
     apiKey: ${DEEPSEEK_API_KEY}
 
+# 视觉模型适配器（qqbot_describe_image 工具用 llm.stream 调多模态模型）
+- id: llm-pi-ai
+  name: '@deepseek-ai/dsh-llm-pi-ai'
+  config:
+    providers:
+      hunyuan:
+        displayName: Hunyuan Vision
+        apiKeyEnv: HUNYUAN_API_KEY
+        api: openai-completions
+        baseURL: https://api.hunyuan.cloud.tencent.com/v1
+        defaultInput: [text, image]
+        models:
+          - id: hunyuan-vision
+            name: Hunyuan Vision
+            contextWindow: 32768
+            maxTokens: 4096
+
 # ── 执行能力（按需启用） ──
 - id: tool-bash
   name: '@deepseek-ai/dsh-tool-bash'
@@ -55,15 +94,19 @@
 
 # ── QQ Bot IM 驱动 ──
 - id: im-qqbot
-  name: '@deepseek-ai/dsh-im-qqbot'
+  name: '@tencent-connect/dsh-qqbot'
   config:
     appId: ${QQBOT_APPID}
     appSecret: ${QQBOT_SECRET}
-    transport: websocket
     provider: deepseek
     model: deepseek-chat
     cwd: ${DSH_CWD:-/tmp/dsh-qqbot}
-    requireMention: false
+    requireMention: true
     textChunkLimit: 4500
     sessionIdleTimeout: 1800000
+    showToolResults: false
     debug: false
+    vision:
+      enabled: false
+      provider: ''   # 视觉模型 provider（需与上方 llm-pi-ai 配置的路由一致，如 hunyuan）
+      model: ''      # 视觉模型 id（如 hunyuan-vision）

package/dist/commands/help.d.ts

@@ -1,11 +1,10 @@
 /**
- * /bot-help — 查看所有指令以及用途
+ * /bot-help — 查看所有指令，按「通用能力 / QQBot 特有」分组展示
  *
- * 参考 openclaw-qqbot 的 bot-help.ts：遍历所有非隐藏命令，
- * 用 <qqbot-cmd-input> 展示为可点击按钮，以 Markdown 格式发送。
+ * 通用能力：对应底层 dsh agent 能力（new/compact/model/stop），无前缀
+ * QQBot 特有：插件自身封装（bot-ping/bot-version/bot-status/bot-help），带 bot- 前缀
  */
-import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
-import type { CommandDeps } from './types.js';
-/** /bot-help — 查看所有指令以及用途 */
-export declare function helpCommand({ config }: CommandDeps, allCommands: () => SlashCommand[]): SlashCommand;
+import type { CommandDeps, CategorizedCommand } from './types.ts';
+/** /bot-help — 分组查看所有指令 */
+export declare function helpCommand({ config }: CommandDeps, allCommands: () => CategorizedCommand[]): CategorizedCommand;
 //# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,6BAA6B;AAC7B,wBAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,EAAE,GAAG,YAAY,CAkBpG"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGlE,2BAA2B;AAC3B,wBAAgB,WAAW,CACzB,EAAE,MAAM,EAAE,EAAE,WAAW,EACvB,WAAW,EAAE,MAAM,kBAAkB,EAAE,GACtC,kBAAkB,CAoCpB"}

package/dist/commands/help.js

@@ -1,18 +1,34 @@
-import { sendMarkdownChunked } from '../shared/index.js';
-/** /bot-help — 查看所有指令以及用途 */
+import { sendMarkdownChunked, PLUGIN_VERSION } from "../shared/index.js";
+/** /bot-help — 分组查看所有指令 */
 export function helpCommand({ config }, allCommands) {
     return {
         name: 'bot-help',
-        description: '查看所有指令以及用途',
+        category: 'qqbot',
+        description: '查看所有指令',
         handler: async (cmdCtx) => {
-            const lines = ['### QQBot插件内置指令', ''];
+            const agentCmds = [];
+            const qqbotCmds = [];
             for (const cmd of allCommands()) {
-                const name = Array.isArray(cmd.name) ? cmd.name[0] : cmd.name;
                 if (cmd.hidden)
                     continue;
-                lines.push(`<qqbot-cmd-input text="/${name}" show="/${name}"/> ${cmd.description ?? ''}`);
+                (cmd.category === 'agent' ? agentCmds : qqbotCmds).push(cmd);
             }
-            lines.push('', '> dsh-qqbot v0.1.0');
+            const render = (cmds) => {
+                const out = [];
+                for (const cmd of cmds) {
+                    const name = Array.isArray(cmd.name) ? cmd.name[0] : cmd.name;
+                    out.push(`<qqbot-cmd-input text="/${name}" show="/${name}"/> ${cmd.description ?? ''}`);
+                }
+                return out;
+            };
+            const lines = ['### 🤖 QQBot 指令', ''];
+            if (agentCmds.length > 0) {
+                lines.push('**通用能力**', '', ...render(agentCmds), '');
+            }
+            if (qqbotCmds.length > 0) {
+                lines.push('**插件内置指令**', '', ...render(qqbotCmds), '');
+            }
+            lines.push('', `> dsh-qqbot v${PLUGIN_VERSION}`);
             await sendMarkdownChunked(cmdCtx, lines.join('\n'), config.textChunkLimit);
             return { kind: 'noop' };
         },

package/dist/commands/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,6BAA6B;AAC7B,MAAM,UAAU,WAAW,CAAC,EAAE,MAAM,EAAe,EAAE,WAAiC;IACpF,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,YAAY;QACzB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,KAAK,GAAG,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAEtC,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,EAAE,CAAC;gBAChC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC9D,IAAI,GAAG,CAAC,MAAM;oBAAE,SAAS;gBACzB,KAAK,CAAC,IAAI,CAAC,2BAA2B,IAAI,YAAY,IAAI,OAAO,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5F,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC;YACrC,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;YAC3E,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,2BAA2B;AAC3B,MAAM,UAAU,WAAW,CACzB,EAAE,MAAM,EAAe,EACvB,WAAuC;IAEvC,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACxB,MAAM,SAAS,GAAyB,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAyB,EAAE,CAAC;YAC3C,KAAK,MAAM,GAAG,IAAI,WAAW,EAAE,EAAE,CAAC;gBAChC,IAAI,GAAG,CAAC,MAAM;oBAAE,SAAS;gBACzB,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/D,CAAC;YAED,MAAM,MAAM,GAAG,CAAC,IAA0B,EAAY,EAAE;gBACtD,MAAM,GAAG,GAAa,EAAE,CAAC;gBACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;oBACvB,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC;oBAC9D,GAAG,CAAC,IAAI,CAAC,2BAA2B,IAAI,YAAY,IAAI,OAAO,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC1F,CAAC;gBACD,OAAO,GAAG,CAAC;YACb,CAAC,CAAC;YAEF,MAAM,KAAK,GAAa,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;YAEhD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;YACzD,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,gBAAgB,cAAc,EAAE,CAAC,CAAC;YACjD,MAAM,mBAAmB,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;YAC3E,OAAO,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;QACnC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/commands/index.d.ts

@@ -1,13 +1,15 @@
 /**
  * 斜杠命令注册中心
  *
- * 每个命令拆分为独立文件，此处仅编排。参考 openclaw-qqbot 的
- * commands/index.ts 模式：工厂函数注入依赖，统一导出命令列表。
+ * 每个命令拆分为独立文件，此处仅编排。工厂函数注入依赖，统一导出命令列表。
+ *
+ * 命令按 category 分两类：
+ *   - agent：底层 dsh agent 通用能力（new/compact/model/stop）
+ *   - qqbot：插件自身特有（ping/version/status/help）
  */
-import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
-import type { CommandDeps } from './types.js';
+import type { CommandDeps, CategorizedCommand } from './types.ts';
 /**
  * 构建标准命令列表
  */
-export declare function buildCommandList(deps: CommandDeps): SlashCommand[];
+export declare function buildCommandList(deps: CommandDeps): CategorizedCommand[];
 //# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAO9C;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE,CAmBlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAQlE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,GAAG,kBAAkB,EAAE,CAkBxE"}

package/dist/commands/index.js

@@ -1,24 +1,24 @@
-import { resetCommand, newCommand } from './session.js';
-import { modelCommand } from './model.js';
-import { statusCommand } from './status.js';
-import { helpCommand } from './help.js';
-import { pingCommand, versionCommand, stopCommand } from './misc.js';
+import { newCommand, compactCommand } from "./session.js";
+import { modelCommand } from "./model.js";
+import { presetCommand } from "./preset.js";
+import { statusCommand } from "./status.js";
+import { helpCommand } from "./help.js";
+import { pingCommand, versionCommand, stopCommand } from "./misc.js";
 /**
  * 构建标准命令列表
  */
 export function buildCommandList(deps) {
     const commands = [
-        // 会话
-        resetCommand(deps),
+        // 通用能力（底层 agent）
         newCommand(deps),
-        // 模型
+        compactCommand(deps),
         modelCommand(deps),
-        // 状态
-        statusCommand(deps),
-        // 杂项
+        presetCommand(deps),
+        stopCommand(deps),
+        // QQBot 特有
         pingCommand(),
         versionCommand(deps),
-        stopCommand(),
+        statusCommand(deps),
     ];
     // help 需要访问完整列表（含自身），通过闭包惰性引用
     commands.push(helpCommand(deps, () => commands));

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAErE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,MAAM,QAAQ,GAAmB;QAC/B,KAAK;QACL,YAAY,CAAC,IAAI,CAAC;QAClB,UAAU,CAAC,IAAI,CAAC;QAChB,KAAK;QACL,YAAY,CAAC,IAAI,CAAC;QAClB,KAAK;QACL,aAAa,CAAC,IAAI,CAAC;QACnB,KAAK;QACL,WAAW,EAAE;QACb,cAAc,CAAC,IAAI,CAAC;QACpB,WAAW,EAAE;KACd,CAAC;IAEF,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAErE;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAiB;IAChD,MAAM,QAAQ,GAAyB;QACrC,iBAAiB;QACjB,UAAU,CAAC,IAAI,CAAC;QAChB,cAAc,CAAC,IAAI,CAAC;QACpB,YAAY,CAAC,IAAI,CAAC;QAClB,aAAa,CAAC,IAAI,CAAC;QACnB,WAAW,CAAC,IAAI,CAAC;QACjB,WAAW;QACX,WAAW,EAAE;QACb,cAAc,CAAC,IAAI,CAAC;QACpB,aAAa,CAAC,IAAI,CAAC;KACpB,CAAC;IAEF,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEjD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/commands/misc.d.ts

@@ -1,12 +1,14 @@
 /**
- * 杂项命令：/ping /version /stop
+ * 杂项命令
+ *
+ * - /bot-ping /bot-version：QQBot 插件特有（连通性测试、版本信息）
+ * - /stop：中止当前生成（对应底层 agent cancel，通用能力）
  */
-import type { SlashCommand } from '@tencent-connect/qqbot-nodejs';
-import type { CommandDeps } from './types.js';
+import type { CommandDeps, CategorizedCommand } from './types.ts';
 /** /bot-ping — 连通性测试 */
-export declare function pingCommand(): SlashCommand;
+export declare function pingCommand(): CategorizedCommand;
 /** /bot-version — 查看版本信息 */
-export declare function versionCommand({ manager }: CommandDeps): SlashCommand;
-/** /bot-stop — 中止当前生成（隐藏） */
-export declare function stopCommand(): SlashCommand;
+export declare function versionCommand({ manager }: CommandDeps): CategorizedCommand;
+/** /stop — 中止当前生成（隐藏） */
+export declare function stopCommand({ manager }: CommandDeps): CategorizedCommand;
 //# sourceMappingURL=misc.d.ts.map

package/dist/commands/misc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/commands/misc.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAwB;AACxB,wBAAgB,WAAW,IAAI,YAAY,CAM1C;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,WAAW,GAAG,YAAY,CAUrE;AAED,6BAA6B;AAC7B,wBAAgB,WAAW,IAAI,YAAY,CAO1C"}
+{"version":3,"file":"misc.d.ts","sourceRoot":"","sources":["../../src/commands/misc.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGlE,wBAAwB;AACxB,wBAAgB,WAAW,IAAI,kBAAkB,CAOhD;AAED,4BAA4B;AAC5B,wBAAgB,cAAc,CAAC,EAAE,OAAO,EAAE,EAAE,WAAW,GAAG,kBAAkB,CAW3E;AAED,yBAAyB;AACzB,wBAAgB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,WAAW,GAAG,kBAAkB,CAoBxE"}

package/dist/commands/misc.js

@@ -1,7 +1,9 @@
+import { getScopePeer, PLUGIN_VERSION } from "../shared/index.js";
 /** /bot-ping — 连通性测试 */
 export function pingCommand() {
     return {
         name: 'bot-ping',
+        category: 'qqbot',
         description: '连通性测试',
         handler: () => 'pong 🏓',
     };
@@ -10,21 +12,34 @@ export function pingCommand() {
 export function versionCommand({ manager }) {
     return {
         name: 'bot-version',
+        category: 'qqbot',
         description: '查看版本信息',
         handler: () => {
             const current = manager.getEffectiveModel('c2c', '');
             const modelInfo = current ? `${current.provider}/${current.model}` : '宿主默认';
-            return `dsh-qqbot v0.1.0 | model: ${modelInfo}`;
+            return `dsh-qqbot v${PLUGIN_VERSION} | model: ${modelInfo}`;
         },
     };
 }
-/** /bot-stop — 中止当前生成（隐藏） */
-export function stopCommand() {
+/** /stop — 中止当前生成（隐藏） */
+export function stopCommand({ manager }) {
     return {
-        name: 'bot-stop',
+        name: 'stop',
+        category: 'agent',
         description: '中止当前生成',
         hidden: true,
-        handler: () => ({ kind: 'noop' }),
+        handler: (cmdCtx) => {
+            const { scope, peerId } = getScopePeer(cmdCtx);
+            const record = manager.getSessionRecord(scope, peerId);
+            // 会话存在不等于正在生成：只有 agent 处于 running 才算有进行中的回复
+            if (record === undefined || record.agent.status !== 'running') {
+                return '当前没有进行中的生成';
+            }
+            // cancel 会让当前轮以 turn/end (kind=interrupted) 收尾，
+            // 出站侧据此 flush 已生成的文本并关闭流式会话。
+            record.agent.cancel({ kind: 'user' });
+            return '已中止 ⛔';
+        },
     };
 }
 //# sourceMappingURL=misc.js.map

package/dist/commands/misc.js.map

@@ -1 +1 @@
-{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/commands/misc.ts"],"names":[],"mappings":"AAMA,wBAAwB;AACxB,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,cAAc,CAAC,EAAE,OAAO,EAAe;IACrD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC5E,OAAO,6BAA6B,SAAS,EAAE,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"misc.js","sourceRoot":"","sources":["../../src/commands/misc.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElE,wBAAwB;AACxB,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,OAAO;QACpB,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,cAAc,CAAC,EAAE,OAAO,EAAe;IACrD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,QAAQ;QACrB,OAAO,EAAE,GAAG,EAAE;YACZ,MAAM,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrD,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;YAC5E,OAAO,cAAc,cAAc,aAAa,SAAS,EAAE,CAAC;QAC9D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,WAAW,CAAC,EAAE,OAAO,EAAe;IAClD,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,QAAQ;QACrB,MAAM,EAAE,IAAI;QACZ,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACvD,4CAA4C;YAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9D,OAAO,YAAY,CAAC;YACtB,CAAC;YAED,gDAAgD;YAChD,6BAA6B;YAC7B,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACtC,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC"}