github-mirrors/qqbot
1
0
Fork 0
mirror of https://mirror.skon.top/github.com/sliverp/qqbot synced 2026-04-21 05:10:25 +08:00
Code Issues Packages Projects Releases Wiki Activity
441 Commits 38 Branches 10 Tags
main
Commit Graph

31 Commits

Author SHA1 Message Date
Mingkuan
e74be7a3f8 Release/1.7.1 (#247) 
* feat: 添加审批功能（Inline Keyboard 按钮交互）

- 新增 approval-handler.ts：监听 Gateway 审批事件，发送带 Inline Keyboard 的审批消息
- api.ts：添加 sendC2CMessageWithInlineKeyboard / sendGroupMessageWithInlineKeyboard
- gateway.ts：处理 Inline Keyboard 按钮回调，注册/注销 approval-handler
- channel.ts：配置 execApprovals（3.28）和 approvals（3.31+）抑制框架 Forwarder 重复通知
- types.ts：添加 InlineKeyboard / KeyboardButton 等 Keyboard 类型定义
- openclaw-plugin-sdk.d.ts：补充 approval-runtime 模块声明

* feat: 增加outbound过滤

* feat: 新增审批相关配置

1. 斜杠指令当遇到报错的时候，支持将文本代理给模型来回复用户

* feat: 新增gateway审批路由注册

* feat: 新增gateway审批路由注册

* feat: 修复低版本发现的问题

1. 3.11版本兼容性处理，动态加载gateway依赖
2. 兼容3.28版本，声明审批功能可用
3. 恢复默认配置的文案修改

* feat: 修复gateway依赖加载失败问题

* feat: update 1.7.1 release
 2026-04-03 03:12:30 +08:00
Mingkuan
2ea3dbf452 Release/1.7.0 (#243) 
* feat: support raw msg ref

* fix: mention msg content

* fix: qqmedia tag

* feat: parse msgrefid

* feat: 流式消息能力增强、斜杠指令扩展与媒体标签处理优化

## 流式消息 (streaming)
- 支持流式消息引用：回复时携带引用消息 ID，通过 message_reference 字段传递
- 重构回复边界(reply boundary)机制：检测到模型返回新回复（文本前缀不匹配）时，
  不再终结当前会话并创建新 controller，改为在已有内容后拼接 "\n\n" 分隔符，
  在同一流式会话中继续发送，移除 onReplyBoundary 回调及 gateway 中的重建逻辑
- 移除遇到未闭合媒体标签时提前终结流式会话的逻辑，改为继续正常流式发送安全文本
  部分（performFlush 内置的 stripIncompleteMediaTag 已能保证安全），等待下次
  onPartialReply 带来更多文本后标签自然闭合
- 移除 sendStreamChunk / doStartStreaming 中冗余的 resp.code 错误检查
- streaming 阶段状态转换新增 idle 回退（首分片发送失败时可回退到 idle）
- sendC2CStreamMessage 返回类型从 StreamMessageResponse 统一为 MessageResponse；
  仅终结分片(DONE)触发 sendAndNotify 引用回调，中间分片直接调用 apiRequest
- 移除 types.ts 中不再使用的 StreamMessage / PendingReply 等冗余类型定义
- 补充 streaming-controller 测试用例：覆盖回复边界检测、多段拼接连续发送、
  sentIndex 连续性等场景

## 斜杠指令 (slash-commands)
- 新增 /bot-streaming on|off 指令，支持用户在私聊中查看和切换流式消息开关，
  修改后即时生效并持久化到 openclaw.json 配置文件
- 指令仅在 c2c（私聊）场景下可用，群聊场景下返回提示信息

## API 模块 (api)
- 引入 ApiLogger 接口与 setApiLogger 注入机制，将 api 模块内散落的
  console.log/error 调用统一替换为可注入的 log 实例，便于日志分级和集中管理
- gateway 启动时自动调用 setApiLogger 注入框架 log 实例
- startBackgroundTokenRefresh 中将参数名 log 改为 refreshLog，
  避免与模块级 log 变量冲突

## 网关 (gateway)
- 简化 StreamingController 创建流程：移除 createStreamingController 工厂函数
  及 onReplyBoundary 回调注册，直接内联创建 controller
- dispatch 失败时统一输出错误日志，包含是否收到过响应的信息

## 媒体标签处理 (media-send)
- 修复 splitMessageByMediaTags 中正则贪婪匹配导致的字符异常问题，
  改为非贪婪匹配避免跨标签吞并内容
- 新增代码块感知逻辑(isInsideCodeBlock)：在匹配媒体标签前先识别并排除
  围栏代码块(```)区域，避免代码块中的标签被误当作媒体资源处理
- hasMediaTags / findFirstClosedMediaTag / splitByMediaTags 均集成代码块过滤
- findFirstClosedMediaTag 不再对 textBefore 做 trim 和多余换行合并处理
- 新增 code-block-media-tag 测试文件，覆盖代码块内标签忽略、混合内容拆分、
  嵌套代码块、未闭合代码块等边界场景

* ci: 添加插件测试环境流水线流程

* fix: 文件超2G错误信息优化

* fix: 优化文件上传兜底文案

* fix(api): 流式消息不存储引用，移除 DONE 分片的 sendAndNotify 回调

* feat: update ref struct

* fix(ref); 移除引用中暂时无用的赋值。

* feat: 支持自然语言更新版本

* feat(qqbot-upgrade): 声音qqbot-upgrade skill

* feat: 增加/bot-streaming不支持时的默认回复

* refactor: 重构升级脚本降级架构 v4 + 安全扫描绕过 + 内置插件禁用

## 降级架构重构
- 两级降级：Level 1 原生命令 → Level 2 npm pack + openclaw install 本地目录
- Level 1 去掉无效的多源重试（ClawHub 限流时换 npm 源无意义）
- Level 2 多源重试（npm pack 直接走 npm registry，真正绕过 ClawHub）

## 安全扫描绕过（openclaw ≥2026.3.30）
- ≥3.30 跳过 update 路径（update 不支持 --dangerously-force-unsafe-install）
- Level 2 传解压后的目录路径而非 tarball（绕过 installPluginFromArchive 漏传 flag 的 bug）
- 版本检测：仅 ≥3.30 时加 --dangerously-force-unsafe-install

## 内置插件冲突处理
- 默认禁用内置冲突插件（openclaw ≥2026.3.31 内置了 qqbot）
- 安装前清理历史遗留 ID（qqbot/openclaw-qq）的 entries/installs/allow
- 安装后验证内置插件确实已禁用

## 其它优化
- update 超时从 1000s 缩短至 180s（失败更快降级）
- install 前清除配置中的插件记录（避免 already exists）
- 精简告警信息：超时提示静默化，重试中间失败去掉 ⚠️
- 步骤标签对齐 [1/4]~[4/4]

* feat: inject OpenClaw version into User-Agent via runtime

- Add PluginRuntime.version field to openclaw-plugin-sdk.d.ts
- Replace static PLUGIN_USER_AGENT const with getPluginUserAgent() function
  so the OpenClaw version can be updated after runtime injection
- Add setOpenClawVersion() to api.ts for runtime to call
- Call setOpenClawVersion(runtime.version) in setQQBotRuntime()
- Update all PLUGIN_USER_AGENT usages to getPluginUserAgent()
- Fall back to OPENCLAW_VERSION / OPENCLAW_SERVICE_VERSION env vars
  before runtime is available

* fix: remove env-based OpenClaw version fallback

Reading version from process.env is a security risk as env vars
can be tampered. Use runtime.version exclusively; fall back to
"unknown" until runtime is injected.

* fix(upgrade): 切换 gateway.reload.mode=hot 防止安装期间配置写入触发 cgroup kill

问题根因：
- openclaw gateway restart 使用 systemctl --user restart
- systemd 默认 KillMode=control-group，重启时清理整个 cgroup
- 安装流程多次写 openclaw.json，hybrid 模式下触发 restart，脚本被杀

修复：
- snapshot_config 提前到所有写操作前（含 disable_builtin_plugins）
- 安装窗口开始时切换 gateway.reload.mode=hot（热更新不重启）
- 新增 restore_reload_mode()：有原值 config set 恢复，无原值 config unset 删除
- cleanup_on_exit 和 [4/4] 前均调用恢复，正常/异常退出均兜底

* fix: 修复windows下路径编码异常导致文件发送错误的问题

* feat: add preferOver to disable built-in qqbot plugin

* feat: 插件升级skill优化

* feat: 更新skill的仓库名

* feat: update 1.7.0 changelog

* Merge branch 'feat/1.7.0-revertskill' into 'main' (merge request !44)

feat: revert qqbot-upgrade skill

---------

Co-authored-by: cxyhhhhh <chenxuyang.win@qq.com>
 2026-04-02 16:51:19 +08:00
rianli
8c8d30393f fix/upgrade-script-config-cleanup (merge request !27) 
Squash merge branch 'fix/upgrade-script-config-cleanup' into 'main'
1. 升级脚本与热更指令稳定性优化 2.升级脚本性能优化 3.提醒功能多账户 Bug 修复
 2026-03-30 12:28:03 +00:00
cxyhhhhh
6909c6280d feat: optimize logic 2026-03-26 16:46:56 +08:00
cxyhhhhh
2d76f0c5e9 feat: update interaction event 2026-03-26 16:46:56 +08:00
cxyhhhhh
f7989d88e4 feat: update group config 2026-03-26 16:46:56 +08:00
cxyhhhhh
0e8cccdf10 feat: add interaction event 2026-03-26 16:46:56 +08:00
cxyhhhhh
6eec33ee8c feat: support group messages 2026-03-26 16:46:56 +08:00
leoqlin
1a88c7baa7 feat: v1.6.6 — 流式消息（C2C）+ 媒体发送队列重构 + ApiError 结构化错误 
- 新增 StreamingController 流式消息控制器，C2C 私聊 AI 回复以打字机效果实时推送
- 新增 sendC2CStreamMessage 流式 API 封装（/v2/users/{openid}/stream_messages）
- 新增 ApiError 结构化错误类，携带 HTTP status 和 path，支持按状态码重试/降级
- 新增 media-send.ts 公共媒体标签解析与发送队列，outbound.ts 和 streaming.ts 共用
- 新增 streaming/streamingConfig 账户配置项，支持按账户控制流式开关和节流间隔
- 新增 strip-incomplete-media-tag 和 streaming-controller 单元测试
- 重构 outbound.ts 媒体发送逻辑为调用公共模块，消除约 100 行重复代码
- audio-convert.ts 日志从 console.log 降级为 console.debug，减少生产日志噪音
- gateway.ts 集成流式控制器：per-message 创建、onPartialReply 回调、dispatch 后收尾
- 删除已清空的 user-messages.ts
- bump version to 1.6.6
 2026-03-25 18:36:53 +08:00
rianli
c2d97d506a feat: admin openid 按 appId 隔离存储 + 升级问候调试日志 
- admin marker 文件从 admin-{accountId}.json 改为 admin-{accountId}-{appId}.json
- 旧版文件自动迁移：读取时 fallback 旧路径并自动写入新路径
- loadUpgradeGreetingTargetOpenId 增加详细调试日志
- resolveAdminOpenId 签名增加 appId
- safeName 提取为公共函数复用
 2026-03-23 16:14:48 +08:00
rianli
d6486a4426 feat: hot reload slash commands support 2026-03-19 17:37:54 +08:00
rianli
0cccbb39fc chore: rename slash command prefix /qqbot- to /bot- 2026-03-18 07:51:20 +08:00
rianli
94e12b138c feat: v1.6.0 — 上线通知优化、斜杠指令体系完善、文档更新 2026-03-17 16:42:15 +08:00
rianli
a73b074a92 feat: v1.6.0 — 斜杠指令体系 + token缓存修复 + 版本更新 2026-03-16 22:57:33 +08:00
rianli
e89aa63c18 feat: 新增 /upgrade 指令 + 移除 /echo 指令 
- /upgrade 返回可配置的升级指引网址（默认 GitHub 仓库地址）
- types.ts 新增 upgradeUrl 配置项
- 移除 /echo 诊断指令
 2026-03-13 16:18:27 +08:00
rianli
6113fd0f1c feat: urlDirectUpload开关 + sendVoice公网URL支持 + MIME扩展名容错统一 
- 新增 urlDirectUpload 配置项（默认true），控制公网URL直传或下载后上传
- sendPhoto/sendVideoMsg/sendDocument/sendVoice 均支持该开关
- sendVoice 新增公网URL支持（直传+下载转码fallback）
- 统一 getCleanExt() 处理URL带查询参数的扩展名提取
- api.ts: sendC2CVoiceMessage/sendGroupVoiceMessage 增加 voiceUrl 参数
- sendMedia 路由移除 isLocal 限制，公网音频URL可正确路由到 sendVoice
 2026-03-13 15:37:36 +08:00
rianli
fc5d3e1d01 feat: add slash commands, remove intent downgrade, clean up ASR wording 
- Add plugin-level slash commands (/echo, /ping, /version, /help)
  with markdown formatting and latency diagnostics
- Remove WebSocket intent level downgrade logic, always use full intents
- Remove ASR fallback wording from gateway, types, ref-index-store, and SKILL.md
 2026-03-12 18:39:31 +08:00
walli
87675832e1 feat: 实现 C2C 消息的 ref-index 缓存机制 
- 新增 ref-index-store 模块，统一管理引用索引缓存
- 出站消息：通过 sendAndNotify + onMessageSent 钩子写入 ref-index
- 入站消息：优先使用 message_scene.ext 中的 msg_idx，兜底使用 InputNotify 响应的 ref_idx
- OutboundMeta 结构化元信息（text/mediaType/mediaUrl/mediaLocalPath）
- 最小化变更原则：仅修改 C2C 逻辑，Group/Channel 函数保持不变
- 修复 channel.ts normalizeTarget 返回类型，适配 NormalizeTargetResult 接口
- 修复 gateway.ts 中 GuildMessageEvent 类型缺失 message_scene 字段的编译问题
 2026-03-11 00:47:59 +08:00
ryanlee-gemini
edbeec1007 Revert "feat: 实现 C2C 消息的 ref-index 缓存机制" 2026-03-10 23:02:07 +08:00
walli
48501815f2 feat: 实现 C2C 消息的 ref-index 缓存机制 
- 新增 ref-index-store 模块，统一管理引用索引缓存
- 出站消息：通过 sendAndNotify + onMessageSent 钩子写入 ref-index
- 入站消息：优先使用 message_scene.ext 中的 msg_idx，兜底使用 InputNotify 响应的 ref_idx
- OutboundMeta 结构化元信息（text/mediaType/mediaUrl/mediaLocalPath）
- 最小化变更原则：仅修改 C2C 逻辑，Group/Channel 函数保持不变
- 修复 channel.ts normalizeTarget 返回类型，适配 NormalizeTargetResult 接口
- 修复 gateway.ts 中 GuildMessageEvent 类型缺失 message_scene 字段的编译问题
 2026-03-10 21:54:00 +08:00
rianli
9e401cf539 fix(qqbot): improve voice passthrough and appId compatibility 
- forward voice attachments + asr_refer_text to OpenClaw with explicit fallback strategy

- update qqbot-media skill docs for STT-first handling and asr fallback

- normalize appId parsing across runtime and proactive scripts (supports numeric/string values)

- align proactive config loading and token cache key handling
 2026-03-10 18:05:42 +08:00
rianli
b2f51e42e1 feat: enhance media handling with upload cache, video support, and retry 
- Add upload-cache.ts: skip duplicate uploads via content hash (like Telegram file_id)
- Add media-tags.ts: auto-fix common LLM tag misspellings (qqimage->qqimg, etc.)
- Add file-utils.ts: async file I/O, size validation (20MB limit)
- Add <qqvideo> tag support for video messages
- Add upload retry with exponential backoff for network resilience
- Add file_name param to upload APIs for proper file naming
- Improve STT/TTS config with two-level fallback (channel -> framework)
- Optimize voice handling: prefer voice_wav_url, skip SILK->WAV when possible
- Filter large base64 from API logs; switch to async file I/O in outbound
- Update SKILL.md and README docs
 2026-03-06 01:08:28 +08:00
rianli
28ee32b787 feat: markdownSupport 默认改为 true 
- config.ts: markdownSupport 使用 !== false 判断，未配置时默认启用
- types.ts: ResolvedQQBotAccount.markdownSupport 改为必填 boolean
 2026-02-11 18:17:21 +08:00
rianli
918b419fc9 feat(qqbot): 图片收发功能与定时提醒优化 
**图片功能**
- 支持接收用户发送的图片消息（自动下载到临时目录）
- 支持发送本地文件路径（自动读取转为 Base64）
- 富媒体消息接口（sendC2CImageMessage/sendGroupImageMessage）
- 图片本地代理服务（解决 QQ 图片 URL 直接访问限制）

**消息格式**
- 默认启用 Markdown 消息格式

**定时提醒优化**
- 修复 cron 提醒：移除无效 --system-prompt 参数，改用 --message 直接输出提醒内容
- 精简用户交互话术，避免冗长回复

**代码清理**
- 移除过时的流式消息处理代码
- 优化 gateway/outbound/channel 模块结构
 2026-02-02 20:36:09 +08:00
rianli
a3e87f2f37 feat(qqbot): 定时提醒技能与主动消息系统 
**新增提醒技能**
- 新增 skills/qqbot-cron/SKILL.md 定时提醒技能定义
- 支持一次性提醒（--at）和周期性提醒（--cron）
- 支持设置、查询、取消提醒操作

**主动消息系统**
- 新增 src/proactive.ts 主动消息发送模块
- 新增 src/known-users.ts 已知用户管理
- 新增 src/session-store.ts 会话存储
- 支持主动向用户/群组发送消息

**工具脚本**
- 新增 scripts/proactive-api-server.ts 主动消息API服务
 2026-02-02 20:31:14 +08:00
rianli
50422aac14 feat(qqbot): 流式消息输出与架构重构 
**流式消息**
- 新增 StreamSender 类，支持流式消息分片发送
- 实现消息队列异步处理，防止阻塞心跳
- 支持 C2C/Group 流式消息

**架构重构**
- 移除 clawdbot/moltbot 旧配置，统一为 qqbot
- 新增 upgrade-and-run.sh 一键升级脚本
- 重构 api/channel/gateway/outbound 模块
- 新增富媒体消息发送接口
 2026-02-02 20:25:06 +08:00
sliverp
a9b0c3ff10 feat: 支持可选配置图床服务器地址 2026-01-30 15:12:28 +08:00
sliverp
869519de7c feat: 支持主动发送消息和附件处理 
新增 `sendProactiveC2CMessage` 和 `sendProactiveGroupMessage` API，支持无需 msg_id 的主动消息发送（有月限额）。在网关中增加附件处理逻辑，支持解析图片和普通附件，并将附件信息传递给上下文。同时优化了 `sendText` 的目标地址解析逻辑，支持 `group:` 和 `channel:` 前缀，并新增 `sendProactiveMessage` 方法。
 2026-01-29 16:17:43 +08:00
sliverp
b58146d9b8 11 2026-01-29 12:03:48 +08:00
sliverp
c0688b1a24 11 2026-01-28 18:00:58 +08:00
sliverp
9a531cd6eb first commit 2026-01-28 17:18:41 +08:00