@wenbin_wb/dsh-bridge 2.11.3 → 2.12.0

package/docs/feishu-usage.md

@@ -1,116 +0,0 @@
-# 飞书 (Feishu / Lark) 机器人接入指南
-
-> 通过飞书官方开放平台 **WebSocket 长连接（免公网 IP）** 模式，将本地 DeepSeek Harness 接入飞书，支持单聊、群聊、表格命令与原生交互卡片权限审批。
-
----
-
-## 🌟 核心优势
-
-- **100% 免公网 IP**：基于飞书官方最新 WebSocket 长连接协议，无需配置公网服务器、无需域名、无需内网穿透工具。
-- **免验签与加密配置**：长连接由飞书官方 SDK 在建立通道时完成认证，无需开发者手动处理 HTTP 回调验签。
-- **飞书原生交互卡片**：Agent 触发敏感工具审批时，飞书端下发带点击按钮的交互卡片，手机/电脑端单手一键点击即可完成批准或拒绝。
-- **多工作区与会话持久化**：支持 `/sessions` 表格查看历史会话、`/use <序号>` 极速切换、`/workspaces` 工作区调度。
-
----
-
-## 🛠️ 第一步：创建飞书企业自建应用
-
-1. 登录 [飞书开放平台开发者后台](https://open.feishu.cn/app)；
-2. 点击右上角 **「创建企业自建应用」**，填写应用名称（如 `DeepSeek Harness`）与应用描述，上传机器人头像；
-3. 创建完成后，在左侧导航栏点击 **「凭证与基础信息」**，即可查看到：
-   - **App ID**（格式如 `cli_a1b2c3d4...`）
-   - **App Secret**（点击复制密钥）
-
----
-
-## 🤖 第二步：添加机器人能力
-
-1. 在应用详情页左侧导航栏，点击 **「添加应用能力」**；
-2. 找到 **「机器人」**，点击 **「添加」** 开启机器人能力。
-
----
-
-## 🔐 第三步：开通必要权限
-
-在左侧导航栏点击 **「权限管理」**，搜索并开通以下权限：
-
-| 权限名称 | 权限 Key | 权限说明 |
-| :--- | :--- | :--- |
-| **获取与发送单聊/群聊消息** | `im:message` | 基础消息收发权限 |
-| **以应用的身份发消息** | `im:message:send_as_bot` | 允许机器人向用户/群回复消息 |
-| **获取群组中所有消息** | `im:message.group_msg` | 允许机器人在群聊中被 `@` 时接收消息 |
-| **获取用户 user ID** | `contact:user.id:readonly` | (可选) 获取用户信息 |
-
----
-
-## ⚡ 第四步：开启 WebSocket 长连接事件订阅
-
-1. 在左侧导航栏点击 **「事件与回调」**；
-2. 在 **「事件配置」** 页面，将事件接收方式切换为 **「使用长连接接收事件」**（WebSocket 模式）；
-3. 点击 **「添加事件」**，勾选并添加：
-   - **`im.message.receive_v1`**（接收消息）
-   - **`card.action.trigger`**（消息卡片回传交互 / 审批按钮点击）
-4. 保存配置。
-
----
-
-## 🚀 第五步：版本发布
-
-1. 在左侧导航栏点击 **「版本管理与发布」**；
-2. 点击 **「创建版本」**，填写版本号（如 `1.0.0`），设置应用可用范围（如「所有员工」或「仅自己」）；
-3. 点击 **「申请发布」**（自建应用通常由企业管理员直接免审或一键通过）。
-
----
-
-## 📱 第六步：在 DSH 客户端中连接
-
-1. 打开 DeepSeek Harness，进入「设置」➔「远程访问」➔「IM 机器人」➔ 选择 **「飞书」**；
-2. 在表单中填入刚才复制的 **App ID** 和 **App Secret**；
-3. 点击 **「保存并连接」**；
-4. 状态显示为绿色 **「已连接」** 即表示长连接成功建立！
-
-![飞书机器人配置](screenshots/feishu-bot-config.jpg)
-
----
-
-## 💬 常用操作与指令
-
-在飞书与机器人单聊或在群里 `@机器人` 即可开始对话：
-
-### 1. 会话与工作区管理
-| 指令 | 说明 | 示例 |
-| :--- | :--- | :--- |
-| `/sessions` | 查看所有历史会话表格 | `/sessions` 或 `/list` |
-| `/use <编号>` | 切换到指定编号会话 | `/use 1` 或 `/resume 1` |
-| `/new <提示词>` | 在当前工作区创建新会话并开始 | `/new 帮我写个脚本` |
-| `/new <词> @N` | 在指定工作区新建会话 | `/new 帮我写个脚本 @1` |
-| `/rename <新标题>` | 重命名当前活动会话 | `/rename 优化登录交互` |
-| `/workspaces` | 查看所有已注册的工作区列表 | `/workspaces` |
-| `/addworkspace <路径>` | 注册添加新的电脑工作区目录 | `/addworkspace D:\projects\app` |
-| `/status` | 查看 Agent 运行状态看板 | `/status` |
-| `/stop` | 中断停止当前正在执行的任务 | `/stop` |
-| `/end` | 结束当前会话回到空闲状态 | `/end` |
-
-### 2. 权限审批交互
-当 Agent 尝试执行需授权的操作（如终端命令、写敏感文件）时，飞书端会自动推送 **原生交互卡片**：
-- 点击卡片上的 **「✓ 批准执行」** 或 **「✕ 拒绝执行」** 按钮即可一键处理；
-- 亦可直接回复文字 `/yes` (或 `1`) / `/no` (或 `2`)。
-
-![飞书对话与卡片审批](screenshots/feishu-chat.jpg)
-
----
-
-## ❓ 常见问题 (FAQ)
-
-### Q1: 点击卡片上的「批准」/「拒绝」按钮提示无权限或无反应？
-请依次核对以下三项飞书开放平台配置：
-1. **是否订阅了卡片交互事件**：在开放平台后台 **「事件与回调」➔「事件配置」** 中，必须添加 **`card.action.trigger`**（消息卡片回传交互）事件。若只添加了接收消息事件，卡片点击不会下发回调。
-2. **是否发布了新版本生效**：飞书平台的所有权限与事件变更，**必须在「版本管理与发布」中「创建版本」并申请发布通过后才会生效**。
-3. **应用可用范围**：在「版本管理与发布」中，确认应用可用范围包含了您当前的飞书账号（建议设为「所有员工」或将自己加入可用成员）。
-4. **快速应急处理**：如果卡片按钮暂时受网络或配置影响，可直接在聊天中回复文字 **`/yes`**（或 `1`）批准，回复 **`/no`**（或 `2`）拒绝。
-
-### Q2: 机器人无法在群聊中回复消息？
-1. 确保在「权限管理」中开通了 **`im:message.group_msg`**（获取群组中所有消息）权限；
-2. 确保在「版本管理与发布」中发布了包含该权限的新版本；
-3. 将机器人拉入群聊后，需要 **`@机器人`** 唤醒并发送指令。
-

package/docs/qq-usage.md

@@ -1,387 +0,0 @@
-# QQ Bot 使用指南
-
-本文档介绍如何接入 QQ Bot OpenAPI v2，实现私聊、群聊、流式输出、按钮交互、消息引用和富媒体消息。
-
-## ✨ v2.1.1 新特性
-
-- **🚀 流式消息输出**：长文本自动分段推送（200字符/段），实时看到 AI 输出
-- **💬 消息引用交互**：直接回复机器人消息即可继续对话，无需输入命令
-- **🔘 按钮快捷操作**：无活动会话时自动显示快捷按钮（新建会话/列表/帮助）
-- **⚡ 互动事件支持**：按钮点击自动映射到对应命令
-
-## 前置准备
-
-### 1. 创建 QQ 机器人
-
-访问 [QQ 开放平台](https://q.qq.com/) 创建机器人应用：
-
-1. 登录并进入"机器人管理"
-2. 点击"创建机器人"，填写基本信息
-3. 创建完成后获取 **AppID** 和 **ClientSecret**（开发设置 → 开发信息）
-4. 配置机器人权限：
-   - 私域机器人：可接收私聊和群聊消息
-   - 需要开通"发送消息"、"接收消息"等基础权限
-
-### 2. 配置事件订阅
-
-QQ Bot 使用 WebSocket 接收事件，需要配置 Intents（事件订阅）：
-
-- **C2C_MESSAGE_CREATE**（私聊消息）：`1 << 25`
-- **GROUP_AT_MESSAGE_CREATE**（群聊 @提及）：`1 << 25`（与私聊同属 `GROUP_AND_C2C_EVENT`）
-- **INTERACTION_CREATE**（互动事件）：`1 << 26`
-
-> dsh-bridge 默认已开启以上三个 intents，支持私聊、群聊和按钮交互，无需额外配置。
-
-## 快速开始
-
-### 1. 启动 dsh-bridge
-
-```bash
-# 安装最新版本
-npm install -g @wenbin_wb/dsh-bridge@latest
-
-# 启动服务
-dsh web
-```
-
-访问 `http://127.0.0.1:3080`，在平台选择器中选择"QQ"。
-
-### 2. 配置 QQ Bot 凭证
-
-在"未配置"区域填写：
-
-- **AppID**：QQ 开放平台应用的 AppID
-- **ClientSecret**：应用的 ClientSecret（密钥不会回传浏览器，留空表示沿用已保存密钥）
-
-点击"保存并连接"，系统会自动：
-1. 保存凭证到 `$DSH_HOME/dsh-bridge/config.json`
-2. 获取 Access Token（自动刷新，TTL 7200s）
-3. 连接 WebSocket Gateway
-4. 开始接收消息事件
-
-### 3. 配置白名单
-
-保存凭证后，在"高级设置"中添加允许的用户/群组 ID：
-
-- **私聊**：用户的 `user_openid`（形如 `11112222333344445555AAAAAAAAAAAA`）
-- **群聊**：群组的 `group_openid`（形如 `1A2B3C4D5E6F7890ABCDEFABCDEFABCD`）
-
-> **如何获取 OpenID**：
-> 1. 先不设置白名单，用户/群组发送消息后查看日志
-> 2. 日志中会显示"未在白名单中，已忽略"，复制其中的 OpenID
-> 3. 将 OpenID 添加到白名单并保存
-
-### 4. 开始对话
-
-#### 私聊场景
-
-1. 在 QQ 中搜索并添加你的机器人为好友
-2. 发送任意消息，机器人会回复带按钮的欢迎提示：
-   - 🆕 **新建会话**：创建新的 AI 对话
-   - 📋 **会话列表**：查看所有可用会话
-   - ❓ **帮助**：显示命令帮助
-3. 点击「新建会话」按钮开始对话
-4. 或者直接回复机器人的任何消息，自动创建新会话并继续对话
-
-#### 群聊场景
-
-1. 将机器人拉入 QQ 群
-2. 在群内 @机器人 并发送消息（例如：`@机器人 你好`）
-3. 机器人会响应并提供快捷按钮
-4. 后续可以：
-   - 点击按钮快捷操作
-   - 回复机器人的消息继续对话
-   - @机器人 发送新消息
-
-### 5. 流式输出与输入状态
-
-#### 流式输出（单聊全回复流式 Markdown）
-
-**单聊中所有 AI 回复统一走流式接口**，手机端实时看到消息逐段增长，且 Markdown 正常渲染：
-
-- **流式**：使用官方 `/stream_messages`（下划线）接口 + `replace` 覆盖模式（官方推荐），每片是全量前缀，服务端逐片覆盖 → 一条消息逐渐变长
-- **Markdown**：流式内容用 `content_type: markdown`，手机端正常渲染粗体/代码块/列表等，不再显示原始语法
-- **分段**：按段落边界切分，短消息自动拆两片保证"生成中→生成结束"过渡；每片带递增 `msg_seq` 避免去重
-- **安全转换**：QQ 不支持的表格自动降级为纯文本，`![图片]()` 转成链接，代码块内容原样保留
-- **回退**：流式失败时补发完整内容 replace 收尾，再失败降级「主动 Markdown」，确保消息必达
-- **群聊**：官方不支持群消息流式，群聊回复直接发送 Markdown
-
-#### 输入状态指示
-
-AI 生成过程中，QQ 会显示机器人的"正在输入"状态：
-
-- **实现方式**：普通消息接口 `msg_type: 6` + `input_notify`
-- **参数**：`input_notify: { input_type: 1, input_second: 8 }`（最长 60 秒）
-- **自动管理**：收到用户消息后、发送回复前自动显示"正在输入"
-- **API 文档**：[发送单聊消息](https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_users_user_openid_messages.post.html)
-
-### 6. 指令面板与自定义菜单（v2.2.0）
-
-连接成功后，dsh-bridge 会自动为你的机器人配置：
-
-> **⚠️ 重要提示**（2026-08-20 确认）：
-> - **自定义菜单、指令面板、消息按钮是 2026-08-12 刚上线的新功能**（[官方变更记录](https://bot.qq.com/wiki/develop/api-v2/changelog.html)）
-> - **需要最新版 QQ 客户端**才能显示（手机版 QQ 优先支持新功能，桌面版可能延后）
-> - 若 API 配置成功（`PUT /v2/menu` 返回 version、`GET /v2/panels` 有 records）但客户端不显示，是**正常现象**——更新 QQ 到最新版再试
-> - 功能可能在**灰度期**，未全量开放；无权限时纯文字命令（`/new` `/sessions` `/help`）仍完全可用
-
-#### 指令面板（单聊 + 群聊常驻）
-
-在单聊窗口和群聊中常驻显示命令面板，点击即可填入命令：
-
-| 面板项 | 说明 |
-|--------|------|
-| `/new` | 新建对话 |
-| `/list` | 查看会话列表 |
-| `/resume` | 恢复会话 |
-| `/sessions` | 切换会话 |
-| `/help` | 命令帮助 |
-
-面板按 `c2c`（单聊）和 `group`（群聊）两个场景各创建一个全局面板，幂等创建（不会重复）。
-
-#### 自定义菜单（单聊底部）
-
-单聊窗口底部常驻菜单，点击自动填入命令：
-
-- **新建** → 自动填入 `/new`
-- **列表** → 自动填入 `/list`
-- **帮助** → 自动填入 `/help`
-
-> 相关 API 文档：
-> - [自定义菜单与指令面板](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/menu-panel/)
-> - [创建指令面板](https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_panels.post.html)
-> - [修改全局自定义菜单](https://bot.q.qq.com/wiki/develop/api-v2/autogen/api/v2_menu.put.html)
-
-## 功能特性
-
-### 交互方式
-
-#### 1. 快捷按钮（推荐）
-
-当没有活动会话时，机器人会自动发送带按钮的提示：
-
-- **🆕 新建会话**：点击后立即创建新的 AI 对话
-- **📋 会话列表**：查看所有可用会话及其编号
-- **❓ 帮助**：显示所有可用命令
-
-按钮点击会触发 `INTERACTION_CREATE` 事件，自动映射到对应命令。
-
-#### 2. 消息引用（最便捷）
-
-直接回复机器人的任何消息，自动关联到对应会话：
-
-1. 机器人发送回复
-2. 你使用 QQ 的"引用回复"功能回复该消息
-3. 如果没有活动会话，自动创建新会话
-4. 你的消息会发送到 AI，无需输入 `/new` 等命令
-
-> **提示**：这是最自然的交互方式，就像正常聊天一样。
-
-#### 3. 文本命令（兼容性）
-
-所有操作都支持传统文本命令：
-
-- `/new <提示词>` - 新建会话并开始
-- `/sessions`（或 `/list`）- 列出所有会话（按工作区分组）
-- `/use N`（或 `/resume N`）- 切换到/恢复会话 N
-- `/rename <新标题>` - 重命名当前活动会话
-- `/end` - 结束当前会话（清除活动会话并触发快捷按钮）
-- `/stop` - 停止当前任务
-- `/status` - 查看状态与会话摘要
-- `/workspaces` - 列出可用工作区
-- `/addworkspace <路径>` - 注册添加新的电脑工作区目录
-- `/help` - 显示帮助
-
-### 支持的消息类型
-
-| 类型 | 方法 | 说明 |
-|------|------|------|
-| 文本消息 | `sendText(scope, text)` | 纯文本消息 |
-| 流式消息 | `sendStream(scope, text, opts)` | 长文本自动分段推送（200字符/段） |
-| Markdown | `sendMarkdown(scope, markdown, keyboard)` | 支持 Markdown 格式 + 可选按钮 |
-| 按钮键盘 | `sendKeyboard(scope, text, keyboard)` | 文本 + 按钮组（行内按钮） |
-| 富媒体 | `sendMedia(scope, type, buffer, filename)` | 图片/视频/音频/文件上传 |
-
-### 流式消息示例
-
-```javascript
-// 发送长文本，自动分段推送
-await gateway.sendStream(
-  'u_11112222333344445555AAAAAAAAAAAA',  // user_openid
-  '这是一段很长的 AI 回复内容...',
-  { msgId: 'parent_msg_id' }  // 可选：关联到某条消息
-)
-// 自动分段为 200 字符/段，每段间隔 100ms
-```
-
-### Markdown 示例
-
-```javascript
-await gateway.sendMarkdown(
-  'u_11112222333344445555AAAAAAAAAAAA',  // user_openid
-  '# 标题\n**粗体** *斜体* `代码`\n[链接](https://example.com)',
-  {
-    content: {
-      rows: [
-        {
-          buttons: [
-            { id: '1', render_data: { label: '选项 A', style: 1 }, action: { type: 2, data: '/cmd_a' } },
-            { id: '2', render_data: { label: '选项 B', style: 0 }, action: { type: 2, data: '/cmd_b' } }
-          ]
-        }
-      ]
-    }
-  }
-)
-```
-
-### 按钮交互
-
-按钮类型（`action.type`）：
-- `0` — 跳转按钮（`action.data` 为 URL）
-- `1` — 回调按钮（触发 `INTERACTION_CREATE` 事件）✅ dsh-bridge 快捷按钮使用此类型
-- `2` — 指令按钮（用户点击后自动发送 `action.data` 作为消息）
-
-按钮样式（`render_data.style`）：
-- `0` — 灰色线框（次要操作）
-- `1` — 蓝色线框（主要操作）
-
-> **按钮结构（v2.2.4 对齐官方）**：`keyboard.content.rows`（含 `content` 包裹层），按钮必填 `render_data.style` / `action.data` / `action.unsupport_tips`。快捷按钮基于 `msg_type=2`（Markdown）挂载。
-
-> **v2.2.4 互动事件处理**：仅消息按钮（type=11）与快捷菜单（type=12）需要调用 `PUT /interactions/{id}` 回应；其他类型（消息反馈/清空会话/授权等）无需回应。点击快捷按钮会自动映射到对应命令（如 `/new`、`/list`、`/help`）。
-
-### 富媒体上传
-
-```javascript
-// 发送图片
-const imageBuffer = fs.readFileSync('image.png')
-await gateway.sendMedia(
-  'g_1A2B3C4D5E6F7890ABCDEFABCDEFABCD',  // group_openid
-  'image',  // image | video | audio | file
-  imageBuffer,
-  'screenshot.png'
-)
-```
-
-支持的媒体类型：
-- `image` — 图片（PNG/JPG/GIF，< 10MB）
-- `video` — 视频（MP4，< 50MB）
-- `audio` — 音频（MP3/WAV，< 10MB）
-- `file` — 文件（任意类型，< 20MB）
-
-## 高级配置
-
-### 会话管理
-
-在 UI 的"高级设置"中配置：
-
-- **摘要间隔**（`digestIntervalSec`，默认 300s）：多久向 Agent 发送一次历史消息摘要
-  - ✅ **微信**：生效
-  - ✅ **QQ**：生效
-- **审批超时**（`approvalTimeoutSec`，默认 600s）：等待用户审批的最长时间
-  - ✅ **微信**：生效
-  - ✅ **QQ**：生效
-- **每条最大字数**（`maxMessageChars`，默认 2000）：单条流式消息最大字符数，超出会拆成多条
-  - ✅ **微信**：生效（超出拆分为多条普通文本消息，间隔 `sendChunkDelayMs`）
-  - ✅ **QQ**：生效（v2.2.2+ 修复，超出拆分为多片流式消息，每片按此配置切分）
-- **分块延迟**（`sendChunkDelayMs`，默认 1500ms）：多条消息之间的延迟，避免刷屏
-  - ✅ **微信**：生效（拆分的多条普通文本消息间隔）
-  - ✅ **QQ**：生效（v2.2.2+ 修复，流式消息多片间隔）
-
-### Token 自动刷新
-
-Access Token 有效期为 7200 秒（2 小时），dsh-bridge 会在过期前 5 分钟自动刷新，无需手动处理。
-
-### 消息去重
-
-WebSocket 可能收到重复消息（如网络抖动、重连），Gateway 使用 `msg_id` 去重（TTL 300s），确保同一消息不会被处理多次。
-
-### 断线重连
-
-Gateway 实现指数退避重连策略：
-- 初始延迟：1s
-- 最大延迟：60s
-- 每次失败后延迟翻倍（1s → 2s → 4s → 8s → ...）
-- 心跳超时（40s 未收到 `HEARTBEAT_ACK`）自动重连
-
-## 故障排查
-
-### 1. 连接失败
-
-**症状**：UI 显示"未配置"或"已停止"
-
-**排查**：
-1. 检查 AppID 和 ClientSecret 是否正确
-2. 查看浏览器控制台 Network 面板，检查 `platformLogin` 请求是否返回错误
-3. 检查 DSH 终端日志，搜索"QQ"关键词
-
-### 2. 收不到消息
-
-**症状**：用户发送消息后机器人无响应
-
-**排查**：
-1. 确认用户/群组 OpenID 已添加到白名单
-2. 群聊消息需要 @机器人 才会触发
-3. 检查机器人权限是否开通"接收消息"
-4. 查看 DSH 终端日志，确认是否收到 `C2C_MESSAGE_CREATE` 或 `GROUP_AT_MESSAGE_CREATE` 事件
-
-### 3. 发送消息失败
-
-**症状**：DSH Agent 回复后，QQ 不显示消息
-
-**排查**：
-1. 检查机器人权限是否开通"发送消息"
-2. 查看终端日志中的 API 请求错误（状态码、错误信息）
-3. 确认消息内容符合 QQ 限制（文本 < 4096 字符，媒体文件大小限制）
-
-### 4. Token 过期
-
-**症状**：运行一段时间后突然无法发送消息
-
-**排查**：
-1. 正常情况下 Token 会自动刷新，如果频繁过期可能是 ClientSecret 错误
-2. 检查终端日志中的"刷新 Access Token"记录
-3. 手动重新保存凭证触发立即刷新
-
-## 参考资料
-
-- [QQ Bot API v2 官方文档](https://bot.q.qq.com/wiki/develop/api-v2/)
-- [获取访问凭证](https://bot.q.qq.com/wiki/develop/api-v2/dev-prepare/access-token.html)
-- [WebSocket 事件](https://bot.q.qq.com/wiki/develop/api-v2/dev-prepare/event-emit/websocket.html)
-- [消息收发](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/overview.html)
-- [流式消息](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/passive.html#%E6%B6%88%E6%81%AF%E6%B5%81%E5%BC%8F%E6%8E%A8%E9%80%81)
-- [Markdown 消息](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/type/markdown.html)
-- [消息按钮](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/trans/msg-btn.html)
-- [富媒体消息](https://bot.q.qq.com/wiki/develop/api-v2/server-inter/message/send-receive/rich-media.html)
-
-## 版本历史
-
-### v2.2.0
-- 🔧 API 域名统一为 `api.bot.qq.com`（官方 2026-08-10 变更）
-- 🔧 修复流式消息：路径 `stream_messages`（下划线）、参数对齐官方、改用 `append` 追加模式
-- 🔧 输入状态改用 `msg_type: 6` + `input_notify`
-- 🔧 键盘消息改用 `msg_type: 0` + `content` + `keyboard`
-- 🔧 修复被动回复 msg_id（用用户消息事件 ID）
-- 🔧 修复群聊 scope 传递 bug
-- ✨ 新增指令面板全套 API，连接后自动创建单聊/群聊命令面板
-- ✨ 新增自定义菜单 API，自动配置单聊底部菜单
-
-### v2.1.1
-- ✨ 流式消息输出：长文本自动分段推送
-- ✨ 消息引用：检测 `message_reference`，用户回复消息时自动创建会话
-- ✨ 按钮交互：无活动会话时发送快捷按钮（新建会话/列表/帮助）
-- ✨ 事件增强：启用 `INTERACTION_CREATE` intent，支持按钮点击映射到命令
-
-### v2.1.0
-- 🎉 初始版本：QQ Bot OpenAPI v2 完整实现
-- ✨ 私聊、群聊、Markdown、按钮、富媒体
-- ✨ 平台抽象层集成
-- ✨ Web UI 自动适配
-
-## 示例项目
-
-完整示例代码见仓库：
-- Gateway 实现：`lib/qq/gateway.js`
-- Platform 适配器：`lib/qq/index.js`
-- ConversationBridge 适配：`lib/qq/node.js`
-- 单元测试：`test/qq-service.test.mjs`

package/docs/release-process.md

@@ -1,45 +0,0 @@
-# 发布流程规则（RELEASE PROCESS）
-
-> 本文件是**发布操作的红线规则**，任何一次对外发布（npm / GitHub Release）都必须遵守。
-
-## 铁律：发布前必须人工确认
-
-**任何版本（正式版 / 补丁版）在推 tag、npm publish、创建 GitHub Release 之前，必须先向仓库所有者（wenbin-wb）确认，得到明确同意后才可执行。**
-
-原因（2026-09-01 教训）：v2.10.0 发布时未先确认就自行完成了 合并 → 打 tag → 推送 → npm publish 全流程，随后发现发布说明措辞需要修订，而 npm 不允许覆盖已发布版本，只能再补 v2.10.1 修正，造成不必要的版本噪音。
-
-### 确认清单（发布前发给所有者）
-
-1. **版本号**：下一个版本号（如 `v2.10.1`）是否认可？
-2. **发布说明（releaseNotes / CHANGELOG）**：内容是否准确？是否只包含用户可感知的变更（新功能、真实修复），不包含开发过程细节？
-3. **发布范围**：npm 发布 + GitHub Release + tag，是否全部执行？
-
-得到「可以发布」的明确回复后，才允许执行发布动作。
-
-## 发布流程
-
-1. **改版本**：`package.json` 的 `version` + `releaseNotes`
-2. **写 CHANGELOG**：`CHANGELOG.md` 顶部新增对应版本条目
-3. **构建与测试**：
-   - `npm run build:client`（**必须**：客户端产物要与源码同步，`npm test` 有一项断言会校验产物内嵌的 CSS 与源码逐字一致）
-   - `npm test` + `npm run lint`
-   - `npm run verify:mobile-ui`（**发布前必做**：跑真实 GUI 的移动端行为验收，8 个套件。需要 dsh web 正在运行；Chrome 路径可用 `PUPPETEER_EXECUTABLE_PATH` 指定。它不在 CI 里跑，因为 CI 没有宿主）
-   - `npm run build:banner`（**仅当 `docs/screenshots/` 素材有变、需要重出 README banner 时执行**；输入没变时应跳过，否则只会产生 JPEG 重编码噪声。注意该脚本默认 Chrome 路径是写死的 Windows 路径，需用 `PUPPETEER_EXECUTABLE_PATH` 覆盖）
-   - `npm run build:lark`（**仅在需要重建飞书 vendor bundle 时执行**。它用当前 esbuild 重新打包 `lib/feishu/lark-bundled.mjs`，产物会随 esbuild 版本漂移；**不要放进 `prepack`**，否则每次 `npm publish` 都会让线上 tarball 里的 vendor 文件与 tag 里的不一致）
-4. **提交**：合并到 `main`（fast-forward），提交信息 `release: vX.Y.Z — ...`
-5. **打 tag**：`git tag vX.Y.Z && git push origin vX.Y.Z`（触发 GitHub Actions 自动创建 Release）
-6. **npm 发布**：`npm publish`（prepack 自动构建产物）
-7. **验证**：npm 线上版本 + GitHub Release body 是否正确
-
-## 发布说明写作规范
-
-- ✅ 只写**用户可感知**的变更：新功能、真实修复（用户报告的问题）
-- ❌ 不写开发过程中自己引入又修复的内部 bug
-- ❌ 不罗列内部重构/清理细节（一句话概括即可）
-- ✅ 修复类条目建议**合并成一条概括**，不逐条展开技术实现
-
-## 注意事项
-
-- npm **不允许覆盖已发布版本**（403）。发布后发现说明要改，只能 bump 补丁版本——所以发布前确认说明尤其重要。
-- `release.yml` workflow 只创建 GitHub Release，npm 发布是手动步骤，不要漏。
-- 发布后如发现问题，走补丁版本（`vX.Y.Z+1`），不要尝试覆盖。