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` |