Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@ To deploy by hand, prepare the platform to connect and an API key for a chat mod
<summary><b>Docker</b></summary>

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

Expand All @@ -86,14 +86,14 @@ docker logs lenbot
<details>
<summary><b>Package</b></summary>

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

</details>

Expand Down
10 changes: 5 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -77,7 +77,7 @@
<summary><b>Docker</b></summary>

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

Expand All @@ -86,14 +86,14 @@ docker logs lenbot
<details>
<summary><b>部署包</b></summary>

从 [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`。

</details>

Expand Down
32 changes: 32 additions & 0 deletions changelogs/v0.2.8.md
Original file line number Diff line number Diff line change
@@ -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 无法打开新格式的数据库,回退需要使用升级前的快照。
18 changes: 9 additions & 9 deletions deploy/current/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
```

Expand All @@ -42,15 +42,15 @@ 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 镜像。

### 启动

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

Expand All @@ -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 ...`。
Expand Down
2 changes: 1 addition & 1 deletion pyproject.toml
Original file line number Diff line number Diff line change
@@ -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"
Expand Down
2 changes: 1 addition & 1 deletion uv.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

10 changes: 5 additions & 5 deletions website/start/agent.md
Original file line number Diff line number Diff line change
Expand Up @@ -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. 查看环境

Expand All @@ -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
```

Expand All @@ -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
```

Expand Down
12 changes: 6 additions & 6 deletions website/start/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -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),部署其他版本时换成对应的版本号。

## 准备

Expand All @@ -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
```

Expand Down Expand Up @@ -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 步用该版本的镜像启动。
Expand All @@ -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)。
Expand All @@ -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`,其中包含初始密码和模型密钥。
Expand Down
14 changes: 7 additions & 7 deletions website/start/package.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,29 +2,29 @@

部署包内含 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
```

arm64 换成对应的文件名。部署包适用于 glibc 2.28 及以上的发行版,例如 Debian 10、Ubuntu 20.04、RHEL 8 及更新版本。

## Windows

解压 `lenbot-0.2.7-windows-x64.zip`,双击目录中的 `run.cmd`,或在 PowerShell 中执行:
解压 `lenbot-0.2.8-windows-x64.zip`,双击目录中的 `run.cmd`,或在 PowerShell 中执行:

```powershell
.\run.cmd
Expand Down
2 changes: 1 addition & 1 deletion website/start/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -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` |
Loading