OVINC-CN · OrenZhang · Dec 22, 2025 · Dec 3, 2025 · Dec 3, 2025 · Dec 3, 2025
diff --git a/.prettierignore b/.prettierignore
@@ -3,8 +3,6 @@ pnpm-lock.yaml
 package-lock.json
 yarn.lock
 
-kubernetes/
-
 # Copy of .gitignore
 .DS_Store
 node_modules

diff --git a/CHANGELOG.md b/CHANGELOG.md
diff --git a/CHANGELOG_EXTRA.md b/CHANGELOG_EXTRA.md
@@ -5,6 +5,25 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.42.1] - 2025.12.22
+
+### Added
+
+- 支持空响应时不计费 (管理员面板-设置-积分)
+- 积分统计面板支持通过用户名模糊筛选 (管理员面板-用户-积分统计)
+- 支持配置邮件发送邮箱 (管理员面板-设置-通用)
+
+### Changed
+
+- 对部分配置增加额外的校验和提示
+- 优化积分统计面板、积分日志、兑换码管理的加载性能
+- 合并官方 0.6.42 改动
+
+### Fixed
+
+- 修复部分场景频道消息加载失败的问题
+- 修复并发执行 DB 初始化的问题
+
 ## [0.6.41.1] - 2025.12.03
 
 ### Changed

diff --git a/Dockerfile b/Dockerfile
@@ -55,6 +55,9 @@ ARG USE_RERANKING_MODEL
 ARG UID
 ARG GID
 
+# Python settings
+ENV PYTHONUNBUFFERED=1
+
 ## Basis ##
 ENV ENV=prod \
     PORT=8080 \

diff --git a/INSTALLATION.md b/INSTALLATION.md
diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,4 @@
-Copyright (c) 2023-2025 Timothy Jaeryang Baek (Open WebUI)
+Copyright (c) 2023- Open WebUI Inc. [Created by Timothy Jaeryang Baek]
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

diff --git a/README.md b/README.md
@@ -1,116 +1,129 @@
-> 注意：此仓库的 `dev` 分支是开发分支，可能包含不稳定或未发布的功能。强烈建议用户在部署和生产环境中使用无预发布标签的正式版本。  
-> 该项目是社区驱动的开源 AI 平台 [Open WebUI](https://github.com/open-webui/open-webui) 的定制分支。此版本与 Open WebUI 官方团队没有任何关联，亦非由其维护。
+<div align="center">
+  <a href="https://github.com/open-webui/open-webui">
+    <img src="./static/favicon.png" alt="Logo" width="100" height="100">
+  </a>
 
-# Open WebUI 👋
+  <h1 align="center">Open WebUI (OVINC-CN)</h1>
 
-官方文档: [Open WebUI Documentation](https://docs.openwebui.com/).  
-官方更新日志: [CHANGELOG.md](./CHANGELOG.md)
+  <p align="center">
+    <strong>基于 Open WebUI 的增强版：集成计费、支付与企业级用户管理</strong>
+  </p>
 
-## 部署方式
+  <p align="center">
+    <a href="https://github.com/ovinc-cn/openwebui/releases">
+      <img src="https://img.shields.io/github/v/release/ovinc-cn/openwebui?style=flat-square" alt="Release">
+    </a>
+    <a href="https://github.com/open-webui/open-webui/blob/main/LICENSE">
+      <img src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" alt="License">
+    </a>
+    <a href="https://github.com/ovinc-cn/openwebui/pkgs/container/openwebui">
+      <img src="https://img.shields.io/badge/container-ghcr.io-blue?style=flat-square&logo=github" alt="GHCR">
+    </a>
+  </p>
 
-部署二开版本只需要替换镜像和版本，其他的部署与官方版本没有差别，版本号请在 [Release](https://github.com/ovinc-cn/openwebui/releases/latest) 中查看
+  <br />
+</div>
 
-```
-ghcr.io/ovinc-cn/openwebui:<版本号>
-```
+> ⚠️ **注意**：此仓库的 `dev` 分支是开发分支，可能包含不稳定功能。生产环境请务必使用 [Release](https://github.com/ovinc-cn/openwebui/releases) 中的正式版本。
+> 本项目是 [Open WebUI](https://github.com/open-webui/open-webui) 的定制分支，与官方团队无关联。
 
-## 拓展特性
+## 📖 简介
 
-完整特性请看更新日志 [CHANGELOG_EXTRA.md](./CHANGELOG_EXTRA.md)
+这是一个社区驱动的 Open WebUI 增强版本，旨在为个人开发者和中小团队提供开箱即用的**运营化解决方案**。我们在原版强大的对话功能基础上，补充了计费、支付、用户验证等商业化闭环所需的关键特性。
 
-### 积分报表
+## ✨ 核心特性
 
-![usage panel](./docs/usage_panel.png)
+| 功能模块                  | 说明                                                                 |
+| :------------------------ | :------------------------------------------------------------------- |
+| 💰 **灵活计费**           | 支持按 **Token** 或 **请求次数** 计费，实时扣费并在对话中显示详情。  |
+| 💳 **支付集成**           | 原生支持**易支付**和**支付宝**（当面付/订单码），轻松实现自助充值。  |
+| 📊 **数据报表**           | 内置全局积分报表与用户消费记录，运营数据一目了然。                   |
+| 🔐 **用户管理**           | 支持**邮箱验证**注册与**兑换码**系统，有效控制用户准入与权益分发。   |
+| ⚙️ **自定义定价**         | 支持对特定模型、搜索工具等进行精细化的自定义倍率或额外收费配置。     |
+| 🎨 **自定义 LOGO & 名称** | 支持自定义 LOGO 和名称，详情参考 [BRANDING.md](./docs/BRANDING.md)。 |
 
-### 全局积分设置
+完整特性列表请参阅 [CHANGELOG_EXTRA.md](./CHANGELOG_EXTRA.md)。
 
-![credit config](./docs/credit_config.png)
+## 📸 功能预览
 
-### 用户积分管理与充值
+<details>
+<summary>点击展开查看更多截图</summary>
 
-![user credit](./docs/user_credit.png)
+### 积分报表与全局设置
 
-### 按照 Token 或请求次数计费，并在对话 Usage 中显示扣费详情
+|                积分报表                |                  全局设置                  |
+| :------------------------------------: | :----------------------------------------: |
+| ![usage panel](./docs/usage_panel.png) | ![credit config](./docs/credit_config.png) |
 
-![usage](./docs/usage.png)
+### 用户充值与计费详情
 
-### 兑换码
+|                用户充值                |          计费详情          |
+| :------------------------------------: | :------------------------: |
+| ![user credit](./docs/user_credit.png) | ![usage](./docs/usage.png) |
 
-![redemption code](./docs/redemption.png)
+### 兑换码与注册验证
 
-### 支持注册邮箱验证
+|                  兑换码                   |               邮箱验证                |
+| :---------------------------------------: | :-----------------------------------: |
+| ![redemption code](./docs/redemption.png) | ![email](./docs/sign_verify_user.png) |
 
-![email](./docs/sign_verify_user.png)
+</details>
 
-## 拓展配置
+## 🚀 快速部署
 
-### 支付宝当面付/订单码支付
+部署本版本非常简单，只需替换官方镜像即可。
 
-推荐使用 [“订单码支付”](https://open.alipay.com/api/detail?code=I1080300001000068149&index=0) 功能，[“当面付”](https://open.alipay.com/api/detail?code=I1080300001000041016&index=0) 处于产品调整中，后续支付宝可能会下线这个支付方式
+```bash
+# 拉取最新镜像（请将 <版本号> 替换为具体版本，如 v0.3.0）
+docker pull ghcr.io/ovinc-cn/openwebui:<版本号>
 
-配置网关地址和授权回调地址为 `https://example.com/api/v1/credit/callback/alipay` 其中 `example.com` 替换为你的 WebUI 地址
+# 启动容器 (示例)
+docker run -d -p 3000:8080 \
+  --add-host=host.docker.internal:host-gateway \
+  -v open-webui:/app/backend/data \
+  --name open-webui \
+  --restart always \
+  ghcr.io/ovinc-cn/openwebui:<版本号>
+```
 
-使用支付宝密钥工具生成的私钥无法直接使用，需要通过 “格式转换” 转换为 PKCS1 格式，转换后工具会提示 “已转换为 PKCS1 格式”
+查看最新版本：[Releases](https://github.com/ovinc-cn/openwebui/releases/latest)
 
-![alipay_private_key](docs/alipay_private_key.png)
+## ⚙️ 进阶配置
 
-### 兑换码功能
+### 1. 支付宝支付配置
 
-需要使用 Redis 避免被多次兑换
+推荐使用 [“订单码支付”](https://open.alipay.com/api/detail?code=I1080300001000068149&index=0)。
 
-```
-REDIS_URL=redis://:<password>@<host>:6379/0
-```
+1.  **回调地址配置**：  
+    在支付宝后台配置网关地址和授权回调地址为：  
+    `https://your-domain.com/api/v1/credit/callback/alipay`  
+    _(将 `your-domain.com` 替换为你的实际域名)_
 
-### 自定义价格配置
+2.  **私钥格式转换**：  
+    支付宝工具生成的私钥需转换为 **PKCS1** 格式。
 
-可以对请求 Body 中的任何匹配的内容额外计费，例如 OpenAI 和 Gemini 原生网页搜索  
-此部分配置较为复杂，如有需要可以提 ISSUE 单获取支持，或者使用 LLM 生成，Prompt 为 "参考这个例子，生成一个 XXX 的配置"，并提供下面的例子
+### 2. 自定义价格配置
+
+(管理员面板 - 设置- 积分 - 自定义价格配置)  
+支持对请求 Body 内容进行正则匹配计费（如对 Web Search 额外收费）。
 
 ```json
 [
 	{
-		"name": "web_search", // 计费名称，使用纯英文和下划线
-		"path": "$.tools[*].type", // python jsonpath_ng 兼容的解析路径
-		"exists": false, // 是否检测到 path 就计费，优先级高于 value 匹配
-		"value": "web_search_preview", // 匹配的值
-		"cost": 1000000 // 1M 次请求的价格
+		"name": "web_search", // 计费项名称
+		"path": "$.tools[*].type", // JSONPath 路径
+		"exists": false, // 是否仅检测存在性
+		"value": "web_search_preview", // 匹配值
+		"cost": 1000000 // 价格 (1M 次请求)
 	}
 ]
 ```
 
-### HTTP Client Read Buffer Size
+### 3. 性能调优
 
-当有遇到 `Chunk too big` 报错时，可以适当调节这里的大小
+如果遇到 `Chunk too big` 错误，可调整 HTTP Client Read Buffer：
 
-```
-# 默认是 64KB
+```env
+# 默认 64KB，可根据需要增加
 AIOHTTP_CLIENT_READ_BUFFER_SIZE=65536
 ```
-
-### 注册邮箱验证
-
-![verify email](./docs/signup_verify.png)
-
-请在管理端打开注册邮箱验证，配置 WebUI URL，同时配置如下环境变量
-
-```
-# 缓存
-REDIS_URL=redis://:<password>@<host>:6379/0
-
-# 邮件相关
-SMTP_HOST=smtp.email.qq.com
-SMTP_PORT=465
-SMTP_USERNAME=example@qq.com
-SMTP_PASSWORD=password
-```
-
-### 品牌/LOGO定制能力说明
-
-本项目尊重并遵守 [Open WebUI License](https://docs.openwebui.com/license) 的品牌保护条款；我们鼓励社区用户尽量保留原有 Open WebUI 品牌，支持开源生态！
-
-如需自定义品牌标识（如 LOGO、名称等）：
-
-- 请务必确保您的实际部署满足 License 所要求的用户规模、授权条件等（详见 [官方说明#9](https://docs.openwebui.com/license#9-what-about-forks-can-i-start-one-and-remove-all-open-webui-mentions)）。
-- 未经授权的商用或大规模去除品牌属于违规，由使用者自行承担法律风险。
-- 具体自定义方法见 [docs/BRANDING.md](./docs/BRANDING.md)。