From 5572f69a57bd99520880f1a0f177969ee664d628 Mon Sep 17 00:00:00 2001
From: LEN5010 <1649211052@qq.com>
Date: Sun, 15 Nov 2026 06:13:34 -0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E5=87=86=E5=A4=87=200.2.8=20=E6=AD=A3?=
=?UTF-8?q?=E5=BC=8F=E7=89=88?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
同步项目和锁文件版本、安装示例与下载链接,新增发行说明。0.2.8 包含插件请求整点卡顿修复与业务数据库格式 3、模型故障提醒与恢复后追赶、聊天参考材料补充、持续关注默认开启(根配置格式 6),以及 QQ 图片预览修复。
---
README.en.md | 10 +++++-----
README.md | 10 +++++-----
changelogs/v0.2.8.md | 32 ++++++++++++++++++++++++++++++++
deploy/current/installation.md | 18 +++++++++---------
pyproject.toml | 2 +-
uv.lock | 2 +-
website/start/agent.md | 10 +++++-----
website/start/docker.md | 12 ++++++------
website/start/package.md | 14 +++++++-------
website/start/quick-start.md | 2 +-
10 files changed, 72 insertions(+), 40 deletions(-)
create mode 100644 changelogs/v0.2.8.md
diff --git a/README.en.md b/README.en.md
index b2088ef1..1453d49b 100644
--- a/README.en.md
+++ b/README.en.md
@@ -77,7 +77,7 @@ To deploy by hand, prepare the platform to connect and an API key for a chat mod
Docker
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
docker logs lenbot
```
@@ -86,14 +86,14 @@ docker logs lenbot
Package
-Download the package for your platform from [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7), extract it and start it:
+Download the package for your platform from [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8), extract it and start it:
```sh
-tar -xzf lenbot-0.2.7-linux-x64.tar.gz
-lenbot-0.2.7-linux-x64/run
+tar -xzf lenbot-0.2.8-linux-x64.tar.gz
+lenbot-0.2.8-linux-x64/run
```
-On Windows, extract `lenbot-0.2.7-windows-x64.zip` and double-click `run.cmd`.
+On Windows, extract `lenbot-0.2.8-windows-x64.zip` and double-click `run.cmd`.
diff --git a/README.md b/README.md
index c6587bbd..1d484be5 100644
--- a/README.md
+++ b/README.md
@@ -77,7 +77,7 @@
Docker
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
docker logs lenbot
```
@@ -86,14 +86,14 @@ docker logs lenbot
部署包
-从 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7) 下载对应平台的部署包,解压后启动:
+从 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8) 下载对应平台的部署包,解压后启动:
```sh
-tar -xzf lenbot-0.2.7-linux-x64.tar.gz
-lenbot-0.2.7-linux-x64/run
+tar -xzf lenbot-0.2.8-linux-x64.tar.gz
+lenbot-0.2.8-linux-x64/run
```
-Windows 解压 `lenbot-0.2.7-windows-x64.zip` 后双击 `run.cmd`。
+Windows 解压 `lenbot-0.2.8-windows-x64.zip` 后双击 `run.cmd`。
diff --git a/changelogs/v0.2.8.md b/changelogs/v0.2.8.md
new file mode 100644
index 00000000..917bb884
--- /dev/null
+++ b/changelogs/v0.2.8.md
@@ -0,0 +1,32 @@
+# LenBot 0.2.8
+
+本次更新修复插件定时任务导致的整点卡顿,新增聊天模型故障提醒和恢复后的追赶处理,补充每轮参考材料,并默认开启持续关注。
+
+## 运行卡顿
+
+- 插件发起的模型请求不再查询本群上一次聊天请求的用量。此前每次插件请求都会在事件循环上扫描整张模型调用记录表,数据库较大时每次阻塞十几秒到二十多秒,群聊日报这类连续调用模型的任务会连续卡住数分钟。
+- 模型调用记录新增按群查询最近一次聊天调用的索引,聊天请求的同一查询改走索引。
+
+## 模型故障与恢复
+
+- 聊天模型连续 `model_alert_failed_turns` 个回合以服务商错误结束时,私聊主人提醒一次,恢复后再提醒一次。宿主不自动重试,也不切换模型。
+- 宿主重启或模型失败后恢复时,环境插话只看最近 5 分钟,更早的消息另起一段并写明原时间。因服务商错误停下的后台整理在恢复后重新开始。
+- 回想可单独设置思考强度(`compaction.reasoning_effort`)。自动压缩的回想因额度用完失败时保留已有回想,请求仍放得进上下文长度时本轮继续。
+
+## 聊天参考与持续关注
+
+- 每轮参考材料新增本群发言形态、群友对最近几句话的反应,以及角色材料里带否定的原句。自我重复提醒扩展到句式。
+- 回复效果双向调整插话间隔,放宽比收紧慢。
+- 持续关注(`attention.declarations`)默认开启。同一意图两分钟内再次命中的消息在窗口结束时合并为一次唤醒;主动开口时附上话题新鲜度。
+
+## QQ 图片
+
+- OneBot 发图时只发送 `file` 和 `sub_type`,不再把给模型看的图片说明发给协议端。此前 QQ 会把这段说明显示为消息预览文字。内部记录中的说明保持不变。
+
+## 升级
+
+在系统 → 设置 → 版本与更新中更新到 0.2.8。插件接口沿用 0.2.7。
+
+- 根配置格式由 5 升为 6:格式 5 中的 `attention.declarations: null` 按新默认开启,格式 6 起 `null` 表示关闭。
+- 业务数据库格式由 2 升为 3,升级时为现有模型调用记录建立索引。数据库较大时首次升级耗时明显增加,数 GB 的库可能需要数分钟,期间实例保持停止。
+- 升级前会自动创建快照,请确认磁盘剩余空间大于实例数据目录。升级后 0.2.7 无法打开新格式的数据库,回退需要使用升级前的快照。
diff --git a/deploy/current/installation.md b/deploy/current/installation.md
index 0fc41dc4..77cba4b5 100644
--- a/deploy/current/installation.md
+++ b/deploy/current/installation.md
@@ -2,21 +2,21 @@
部署包由 CI 的 `release-packages` 产物提供。候选镜像来自 Release 工作流的 `publish=false` 构建:每个架构分别提供 `image-host-*` 和 `image-worker-*`。选择与运行机器一致的架构,将同一次构建的包和镜像放在一起使用。
-以下以 `0.2.7` 为例。公开版本发布后,从对应 Release 下载部署包、按同一版本号拉取镜像,步骤见文档站的[部署包](https://lendevs.github.io/LenBot/start/package)和 [Docker 部署](https://lendevs.github.io/LenBot/start/docker)。
+以下以 `0.2.8` 为例。公开版本发布后,从对应 Release 下载部署包、按同一版本号拉取镜像,步骤见文档站的[部署包](https://lendevs.github.io/LenBot/start/package)和 [Docker 部署](https://lendevs.github.io/LenBot/start/docker)。
## 部署包
| 文件 | 平台 |
|---|---|
-| `lenbot-0.2.7-linux-x64.tar.gz` | Linux x64,glibc 2.28 及以上 |
-| `lenbot-0.2.7-linux-arm64.tar.gz` | Linux arm64,glibc 2.28 及以上 |
-| `lenbot-0.2.7-windows-x64.zip` | Windows x64 |
+| `lenbot-0.2.8-linux-x64.tar.gz` | Linux x64,glibc 2.28 及以上 |
+| `lenbot-0.2.8-linux-arm64.tar.gz` | Linux arm64,glibc 2.28 及以上 |
+| `lenbot-0.2.8-windows-x64.zip` | Windows x64 |
部署包内含 Python 3.13、锁定的依赖、uv(安装插件依赖)和网页面板,解压即可启动。解压出的目录就是部署目录:
```sh
-tar -xzf lenbot-0.2.7-linux-x64.tar.gz
-mv lenbot-0.2.7-linux-x64 ~/lenbot
+tar -xzf lenbot-0.2.8-linux-x64.tar.gz
+mv lenbot-0.2.8-linux-x64 ~/lenbot
~/lenbot/run
```
@@ -42,7 +42,7 @@ Windows 解压 zip 后双击 `run.cmd`。首次启动建立 `instance/`、`curre
```sh
docker load -i image-host-arm64/image.tar
-docker tag ghcr.io/lendevs/lenbot:0.2.7-arm64 ghcr.io/lendevs/lenbot:0.2.7
+docker tag ghcr.io/lendevs/lenbot:0.2.8-arm64 ghcr.io/lendevs/lenbot:0.2.8
```
amd64 机器把 `arm64` 换成 `amd64`。启用后台任务时同样载入 worker 镜像。
@@ -50,7 +50,7 @@ amd64 机器把 `arm64` 换成 `amd64`。启用后台任务时同样载入 worke
### 启动
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
docker logs lenbot
```
@@ -63,7 +63,7 @@ docker logs lenbot
把 [first-setup.example.json](first-setup.example.json) 复制为 `setup.json` 并填写,保持 `panel_host` 为 `0.0.0.0`、`panel_port` 为 `11307`,在启动容器之前执行:
```sh
-docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.7 -m len_bot.next.maintenance.initialize < setup.json
+docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.8 -m len_bot.next.maintenance.initialize < setup.json
```
PowerShell 中改用 `Get-Content -Raw setup.json | docker run ...`。
diff --git a/pyproject.toml b/pyproject.toml
index 0f71884a..162cbee9 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
[project]
name = "len-bot"
-version = "0.2.7"
+version = "0.2.8"
description = "A group chat agent for QQ that decides for itself, with a web panel and Python plugins"
readme = "README.md"
license = "AGPL-3.0-only"
diff --git a/uv.lock b/uv.lock
index 1aa97240..11235859 100644
--- a/uv.lock
+++ b/uv.lock
@@ -544,7 +544,7 @@ wheels = [
[[package]]
name = "len-bot"
-version = "0.2.7"
+version = "0.2.8"
source = { editable = "." }
dependencies = [
{ name = "anyio" },
diff --git a/website/start/agent.md b/website/start/agent.md
index 0568cfc3..c1997631 100644
--- a/website/start/agent.md
+++ b/website/start/agent.md
@@ -10,7 +10,7 @@
## 给 Agent 的部署步骤
-本节写给执行部署的 Agent。下文以 `0.2.7` 为例,该版本见 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7)。
+本节写给执行部署的 Agent。下文以 `0.2.8` 为例,该版本见 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8)。
### 1. 查看环境
@@ -36,7 +36,7 @@
**Docker**
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
docker logs lenbot
```
@@ -47,11 +47,11 @@ docker logs lenbot
**部署包**
-从 Releases 下载对应文件,地址为 `https://github.com/lendevs/LenBot/releases/download/v<版本>/<文件名>`:Linux 是 `lenbot-0.2.7-linux-x64.tar.gz` 或 `lenbot-0.2.7-linux-arm64.tar.gz`,Windows 是 `lenbot-0.2.7-windows-x64.zip`。
+从 Releases 下载对应文件,地址为 `https://github.com/lendevs/LenBot/releases/download/v<版本>/<文件名>`:Linux 是 `lenbot-0.2.8-linux-x64.tar.gz` 或 `lenbot-0.2.8-linux-arm64.tar.gz`,Windows 是 `lenbot-0.2.8-windows-x64.zip`。
```sh
-tar -xzf lenbot-0.2.7-linux-x64.tar.gz
-mv lenbot-0.2.7-linux-x64 ~/lenbot
+tar -xzf lenbot-0.2.8-linux-x64.tar.gz
+mv lenbot-0.2.8-linux-x64 ~/lenbot
~/lenbot/run
```
diff --git a/website/start/docker.md b/website/start/docker.md
index f754806b..cef9bb3a 100644
--- a/website/start/docker.md
+++ b/website/start/docker.md
@@ -2,7 +2,7 @@
宿主镜像 `ghcr.io/lendevs/lenbot` 运行 Bot 和面板,支持 amd64 和 arm64。实例数据保存在一个命名数据卷里,新版本在面板中一键更新。
-下文以 `0.2.7` 为例,该版本见 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7),部署其他版本时换成对应的版本号。
+下文以 `0.2.8` 为例,该版本见 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8),部署其他版本时换成对应的版本号。
## 准备
@@ -14,7 +14,7 @@
下文的命令在 PowerShell、macOS 和 Linux 终端中写法相同。
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
docker logs lenbot
```
@@ -56,7 +56,7 @@ ssh -L 11307:127.0.0.1:11307 你的服务器
```sh
docker stop lenbot
docker rm lenbot
-docker run --rm --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.7 -m len_bot.next.maintenance.upgrade restore --snapshot /data/backups/20261030-140217-cba39904
+docker run --rm --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.8 -m len_bot.next.maintenance.upgrade restore --snapshot /data/backups/20261030-140217-cba39904
```
然后按第 1 步用该版本的镜像启动。
@@ -66,7 +66,7 @@ docker run --rm --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot
后台任务在同版本的 `ghcr.io/lendevs/lenbot-worker` 任务容器中运行,由宿主容器通过 Docker socket 创建。启用任务时,创建容器时多挂载一项:
```sh
-docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data -v /var/run/docker.sock:/var/run/docker.sock --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.7
+docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbot-data:/data -v /var/run/docker.sock:/var/run/docker.sock --add-host host.docker.internal:host-gateway ghcr.io/lendevs/lenbot:0.2.8
```
宿主启动时加入 socket 的所属组,之后以 `10000:10000` 运行。任务目录放在 `lenbot-data` 数据卷内,任务容器按子目录挂载(`volume-subpath`),需要 Docker Engine 26 或更高版本。然后在面板**能力 → 后台任务**中启用,步骤见[后台任务](../use/tasks)。
@@ -76,13 +76,13 @@ docker run -d --name lenbot --stop-timeout 180 -p 127.0.0.1:11307:11307 -v lenbo
不使用浏览器时,可用 JSON 初始化。把 [`first-setup.example.json`](https://github.com/lendevs/LenBot/blob/master/deploy/current/first-setup.example.json) 复制为 `setup.json` 并填写,保持 `panel_host` 为 `0.0.0.0`、`panel_port` 为 `11307`,在第 1 步之前执行:
```sh
-docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.7 -m len_bot.next.maintenance.initialize < setup.json
+docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.8 -m len_bot.next.maintenance.initialize < setup.json
```
PowerShell 不支持 `<` 输入重定向,改用管道:
```powershell
-Get-Content -Raw setup.json | docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.7 -m len_bot.next.maintenance.initialize
+Get-Content -Raw setup.json | docker run --rm -i --user 10000:10000 -v lenbot-data:/data --entrypoint /opt/lenbot/.venv/bin/python ghcr.io/lendevs/lenbot:0.2.8 -m len_bot.next.maintenance.initialize
```
初始化后删除 `setup.json`,其中包含初始密码和模型密钥。
diff --git a/website/start/package.md b/website/start/package.md
index 05fbc8ae..becc5471 100644
--- a/website/start/package.md
+++ b/website/start/package.md
@@ -2,21 +2,21 @@
部署包内含 Python 3.13、锁定的依赖和预构建的网页面板,解压后直接启动,本机不需要另外安装 Python 或 uv。Linux 部署包还带有后台任务的本机沙箱运行时。macOS 使用 [Docker 部署](./docker)。
-从 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7) 下载与系统对应的文件,下文以 `0.2.7` 为例:
+从 [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8) 下载与系统对应的文件,下文以 `0.2.8` 为例:
| 系统 | 文件 |
|---|---|
-| Linux x64 | `lenbot-0.2.7-linux-x64.tar.gz` |
-| Linux arm64 | `lenbot-0.2.7-linux-arm64.tar.gz` |
-| Windows x64 | `lenbot-0.2.7-windows-x64.zip` |
+| Linux x64 | `lenbot-0.2.8-linux-x64.tar.gz` |
+| Linux arm64 | `lenbot-0.2.8-linux-arm64.tar.gz` |
+| Windows x64 | `lenbot-0.2.8-windows-x64.zip` |
解压出的目录就是部署目录,配置和数据都写在里面,可以先改名或移到常用位置再启动。
## Linux
```sh
-tar -xzf lenbot-0.2.7-linux-x64.tar.gz
-mv lenbot-0.2.7-linux-x64 ~/lenbot
+tar -xzf lenbot-0.2.8-linux-x64.tar.gz
+mv lenbot-0.2.8-linux-x64 ~/lenbot
~/lenbot/run
```
@@ -24,7 +24,7 @@ arm64 换成对应的文件名。部署包适用于 glibc 2.28 及以上的发
## Windows
-解压 `lenbot-0.2.7-windows-x64.zip`,双击目录中的 `run.cmd`,或在 PowerShell 中执行:
+解压 `lenbot-0.2.8-windows-x64.zip`,双击目录中的 `run.cmd`,或在 PowerShell 中执行:
```powershell
.\run.cmd
diff --git a/website/start/quick-start.md b/website/start/quick-start.md
index 64aec3f3..e5c0f840 100644
--- a/website/start/quick-start.md
+++ b/website/start/quick-start.md
@@ -27,7 +27,7 @@
| | Docker | 部署包 | 源码 |
|---|---|---|---|
| 运行环境 | Docker Engine 或 Docker Desktop | Linux(x64、arm64)、Windows(x64) | uv、Node.js 22 |
-| 版本来源 | 镜像 `ghcr.io/lendevs/lenbot` | [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.7) 中的部署包 | `master` 分支 |
+| 版本来源 | 镜像 `ghcr.io/lendevs/lenbot` | [Releases](https://github.com/lendevs/LenBot/releases/tag/v0.2.8) 中的部署包 | `master` 分支 |
| 数据位置 | `lenbot-data` 数据卷 | 部署目录下的 `instance/` | 仓库根目录 |
| 更新方式 | 面板的**系统 → 设置 → 版本与更新** | 面板的**系统 → 设置 → 版本与更新** | `git pull` 后重新启动 |
| 面板端口 | `11307` | `8088` | `8088` |