From c1cd5627bb9967262fed809a27c5b80674347589 Mon Sep 17 00:00:00 2001
From: Soulter <905617992@qq.com>
Date: Thu, 23 Apr 2026 12:00:10 +0800
Subject: [PATCH] chore: bump version to 4.23.3

---
 astrbot/cli/__init__.py        |  2 +-
 astrbot/core/config/default.py |  2 +-
 changelogs/v4.23.3.md          | 62 ++++++++++++++++++++++++++++++++++
 docs/en/use/webui.md           | 19 ++++++++++-
 docs/zh/use/webui.md           | 19 ++++++++++-
 pyproject.toml                 |  2 +-
 6 files changed, 101 insertions(+), 5 deletions(-)
 create mode 100644 changelogs/v4.23.3.md

diff --git a/astrbot/cli/__init__.py b/astrbot/cli/__init__.py
index f09cd959a..f71bb949a 100644
--- a/astrbot/cli/__init__.py
+++ b/astrbot/cli/__init__.py
@@ -1 +1 @@
-__version__ = "4.23.2"
+__version__ = "4.23.3"
diff --git a/astrbot/core/config/default.py b/astrbot/core/config/default.py
index 09976f7c4..1cdd1d2e4 100644
--- a/astrbot/core/config/default.py
+++ b/astrbot/core/config/default.py
@@ -5,7 +5,7 @@ from typing import Any, TypedDict
 
 from astrbot.core.utils.astrbot_path import get_astrbot_data_path
 
-VERSION = "4.23.2"
+VERSION = "4.23.3"
 DB_PATH = os.path.join(get_astrbot_data_path(), "data_v4.db")
 PERSONAL_WECHAT_CONFIG_METADATA = {
     "weixin_oc_base_url": {
diff --git a/changelogs/v4.23.3.md b/changelogs/v4.23.3.md
new file mode 100644
index 000000000..16150d4b2
--- /dev/null
+++ b/changelogs/v4.23.3.md
@@ -0,0 +1,62 @@
+- [更新日志(简体中文)](#chinese)
+- [Changelog(English)](#english)
+
+<a id="chinese"></a>
+
+## What's Changed
+
+### 新增
+
+- WebUI ChatUI 新增消息重新编辑、从重新生成 AI 回复、分支询问面板（划选 AI 回复内容即可看到）与会话 checkpoint 支持。（[#7673](https://github.com/AstrBotDevs/AstrBot/pull/7673)）
+- WebUI 聊天附件处理新增预览与文件签名校验，改善上传前的附件识别与展示体验，修复用户消息气泡无法正常显示图片的问题。（[commit](https://github.com/AstrBotDevs/AstrBot/commit/0748f0a42)）
+- 知识库文档上传新增 EPUB 支持，并补充 EPUB 解析、文件读取与相关测试。（[#7594](https://github.com/AstrBotDevs/AstrBot/pull/7594)）
+- 非流式 Agent Loop 新增中间工具调用消息过程折叠发送功能。（[#7627](https://github.com/AstrBotDevs/AstrBot/pull/7627)）
+- 重新内置 `/provider` 命令，支持通过命令管理与查看 Provider 相关信息。（[#7691](https://github.com/AstrBotDevs/AstrBot/pull/7691)）
+- 插件页新增“有新版本时置顶显示”能力，并支持保存该偏好设置。（[#7665](https://github.com/AstrBotDevs/AstrBot/pull/7665)）
+
+### 优化
+
+- 优化 FileReadTool 描述，明确图片、PDF 与 DOCX 支持，并增强工具结果的模态能力检查。（[#7506](https://github.com/AstrBotDevs/AstrBot/pull/7506)）
+- 统一多处文档链接，修正 CLI、配置、Dashboard 与知识库页面中的文档入口。（[#7709](https://github.com/AstrBotDevs/AstrBot/pull/7709)）
+
+### 修复
+
+- 修复部分国内或自定义 OpenAI/Anthropic 兼容模型提供商因 TLS 证书链、代理或模型列表能力差异导致配置不可用的问题。（[#7685](https://github.com/AstrBotDevs/AstrBot/pull/7685)）
+- 修复模型回复包含 reasoning content 时可能漏发普通回复的问题。（[#7715](https://github.com/AstrBotDevs/AstrBot/pull/7715)）
+- 修复 QQ 官方 API 在 DNS 或连接瞬时异常下缺少重试导致请求失败的问题。（[#7718](https://github.com/AstrBotDevs/AstrBot/pull/7718)）
+- 修复 `RegexFilter` 不能同时接受 `str` 与 `re.Pattern` 的问题。（[#7633](https://github.com/AstrBotDevs/AstrBot/pull/7633)）
+- 修复备份导入器存在路径穿越风险的问题。（[#7681](https://github.com/AstrBotDevs/AstrBot/pull/7681)）
+- 修复旧版 `documents_fts` 表残留时可能影响知识库 FTS 迁移的问题。（[#7706](https://github.com/AstrBotDevs/AstrBot/pull/7706)）
+- 修复 MiniMax Token Plan Provider 在已配置模型不在硬编码列表中时直接阻塞的问题，改为警告提示。（[#7692](https://github.com/AstrBotDevs/AstrBot/pull/7692)）
+- 修复 MCP schema 中无效 `required` 字段未被规范化导致工具 schema 异常的问题。（[#6077](https://github.com/AstrBotDevs/AstrBot/pull/6077)）
+- 修复视频附件传给 LLM 时的处理问题，并补充相关测试。（[#7679](https://github.com/AstrBotDevs/AstrBot/pull/7679)）
+
+<a id="english"></a>
+
+## What's Changed (EN)
+
+### New Features
+
+- Added inline message editing, regeneration from a selected message, a thread panel, and conversation checkpoint support to the WebUI chat page. ([#7673](https://github.com/AstrBotDevs/AstrBot/pull/7673))
+- Added chat attachment previews and file signature checks in WebUI to improve attachment recognition and display before upload. ([commit](https://github.com/AstrBotDevs/AstrBot/commit/0748f0a42))
+- Added buffered intermediate messages for the non-streaming Agent Loop, allowing process messages such as tool calls to be surfaced in non-streaming scenarios. ([#7627](https://github.com/AstrBotDevs/AstrBot/pull/7627))
+- Reintroduced `/provider` as a built-in command for viewing and managing Provider-related information. ([#7691](https://github.com/AstrBotDevs/AstrBot/pull/7691))
+- Added an option to pin installed plugins with available updates to the top of the plugin page, with persisted preference storage. ([#7665](https://github.com/AstrBotDevs/AstrBot/pull/7665))
+- Added EPUB support for knowledge-base document upload, including EPUB parsing, file reading support, and tests. ([#7594](https://github.com/AstrBotDevs/AstrBot/pull/7594))
+
+### Improvements
+
+- Updated the FileReadTool description to mention image, PDF, and DOCX support, and improved modality checks for tool results. ([#7506](https://github.com/AstrBotDevs/AstrBot/pull/7506))
+- Unified documentation links across CLI output, configuration, Dashboard, and knowledge-base pages. ([#7709](https://github.com/AstrBotDevs/AstrBot/pull/7709))
+
+### Bug Fixes
+
+- Fixed missing normal replies when model output contains reasoning content. ([#7715](https://github.com/AstrBotDevs/AstrBot/pull/7715))
+- Added retries for transient DNS and connection errors in the QQ Official API flow. ([#7718](https://github.com/AstrBotDevs/AstrBot/pull/7718))
+- Fixed `RegexFilter` so it accepts both `str` and `re.Pattern`. ([#7633](https://github.com/AstrBotDevs/AstrBot/pull/7633))
+- Fixed a path traversal vulnerability in the backup importer. ([#7681](https://github.com/AstrBotDevs/AstrBot/pull/7681))
+- Dropped legacy `documents_fts` tables when present to avoid knowledge-base FTS migration issues. ([#7706](https://github.com/AstrBotDevs/AstrBot/pull/7706))
+- Fixed configuration failures for some domestic or custom OpenAI/Anthropic-compatible model providers caused by TLS certificate chains, proxy handling, or model-list capability differences. ([#7685](https://github.com/AstrBotDevs/AstrBot/pull/7685))
+- Changed MiniMax Token Plan Provider behavior to warn instead of blocking when a configured model is not in the hardcoded model list. ([#7692](https://github.com/AstrBotDevs/AstrBot/pull/7692))
+- Normalized invalid `required` flags in MCP schemas to avoid tool schema errors. ([#6077](https://github.com/AstrBotDevs/AstrBot/pull/6077))
+- Fixed video attachment handling for LLM requests and added related tests. ([#7679](https://github.com/AstrBotDevs/AstrBot/pull/7679))
diff --git a/docs/en/use/webui.md b/docs/en/use/webui.md
index 986946370..dd17994c0 100644
--- a/docs/en/use/webui.md
+++ b/docs/en/use/webui.md
@@ -1,4 +1,4 @@
-# Admin Panel
+# WebUI
 
 The AstrBot admin panel features plugin management, log viewing, visual configuration, statistics viewing, and more.
 
@@ -15,6 +15,23 @@ After starting AstrBot, you can access the admin panel by visiting `http://local
 
 The default username and password are both `astrbot`.
 
+## ChatUI
+
+AstrBot includes a built-in ChatUI for talking to configured models directly in your browser.
+
+ChatUI supports these common workflows:
+
+- Create, rename, and delete conversations, and switch previous conversations from the sidebar.
+- Select the config profile, model provider, and model on the chat page; if Provider session separation is enabled, you can also choose a model for the current session only.
+- Send text, images, files, and voice input; uploaded attachments show previews and use file signature checks to help identify file types.
+- View model thinking, tool-call status, knowledge-base or web-search references, and per-message token and latency statistics.
+- Copy or regenerate existing replies, including regenerating with another model.
+- Edit a user message and continue generation from that point, or start a thread from a specific excerpt.
+- Switch between streaming/normal response modes and SSE/WebSocket transport modes.
+
+> [!NOTE]
+> To keep message delivery ordered, keep only one ChatUI page open for the same browser session. If you open chat in multiple tabs, the system may ask you to reconnect.
+
 ## Visual Configuration
 
 In the admin panel, you can configure AstrBot's plugins through visual configuration. Click `Configuration` in the left sidebar to enter the configuration page.
diff --git a/docs/zh/use/webui.md b/docs/zh/use/webui.md
index f52f4a3ff..972538056 100644
--- a/docs/zh/use/webui.md
+++ b/docs/zh/use/webui.md
@@ -1,4 +1,4 @@
-# 管理面板
+# WebUI
 
 AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看统计信息等功能。
 
@@ -15,6 +15,23 @@ AstrBot 管理面板具有管理插件、查看日志、可视化配置、查看
 
 默认用户名和密码是 `astrbot` 和 `astrbot`。
 
+## ChatUI
+
+AstrBot 内置 ChatUI，可在浏览器中直接与已配置的模型对话。
+
+ChatUI 支持以下常用能力：
+
+- 创建、重命名、删除对话，并在左侧会话列表中切换历史对话。
+- 在聊天页选择配置文件、模型提供商与模型；如果启用了 Provider 会话隔离，也可以为当前会话单独选择模型。
+- 发送文本、图片、文件与语音输入；上传附件时会展示预览，并根据文件签名辅助识别文件类型。
+- 查看模型思考过程、工具调用状态、知识库或网页搜索引用来源，以及每条回复的 Token 和耗时统计。
+- 对已有回复执行复制、重新生成，或使用其他模型重新生成。
+- 编辑用户消息后从该消息继续生成，也可以针对某段内容开启分支追问。
+- 切换流式/普通响应模式，以及 SSE/WebSocket 通信模式。
+
+> [!NOTE]
+> 为保证消息接收顺序，同一浏览器会话建议只保留一个 ChatUI 页面。如果你在多个标签页中同时打开聊天页面，系统可能会提示需要重新建立连接。
+
 ## 可视化配置
 
 在管理面板中，你可以通过可视化配置来配置 AstrBot 的插件。点击左栏 `配置` 即可进入配置页面。
diff --git a/pyproject.toml b/pyproject.toml
index ce59ac9ac..459b59cde 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -1,6 +1,6 @@
 [project]
 name = "AstrBot"
-version = "4.23.2"
+version = "4.23.3"
 description = "Easy-to-use multi-platform LLM chatbot and development framework"
 readme = "README.md"
 license = { text = "AGPL-3.0-or-later" }