feat: workspace volume in docker deploy

2026-07-21 06:07:13 +08:00 · 2026-03-18 16:03:03 +08:00
parent 8993e8ad3e
commit c6384363f9
6 changed files with 77 additions and 17 deletions
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -59,7 +59,8 @@
                "group": "安装部署",
                "pages": [
                  "guide/quick-start",
-                  "guide/manual-install"
+                  "guide/manual-install",
+                  "guide/upgrade"
                ]
              }
            ]
--- a/docs/guide/upgrade.mdx
+++ b/docs/guide/upgrade.mdx
@@ -0,0 +1,52 @@
+---
+title: 更新升级
+description: CowAgent 的升级方式说明
+---
+
+## 脚本升级（推荐）
+
+如果使用 `run.sh` 管理服务，执行以下命令即可一键升级：
+
+```bash
+./run.sh update
+```
+
+该命令会自动完成以下流程：
+
+1. 停止当前运行的服务
+2. 拉取最新代码
+3. 重新检查依赖
+4. 启动服务
+
+## 手动升级
+
+在项目根目录下执行：
+
+```bash
+git pull
+pip3 install -r requirements.txt
+```
+
+更新完成后重启服务：
+
+```bash
+# 如果使用 run.sh 管理
+./run.sh restart
+
+# 如果使用 nohup 直接运行
+kill $(ps -ef | grep app.py | grep -v grep | awk '{print $2}')
+nohup python3 app.py & tail -f nohup.out
+```
+
+## Docker 升级
+
+在 `docker-compose.yml` 所在目录下执行：
+
+```bash
+sudo docker compose pull
+sudo docker compose up -d
+```
+
+<Tip>
+  升级前建议备份 `config.json` 配置文件。Docker 环境下如需保留数据，可通过 volume 挂载持久化工作空间目录。
+</Tip>
--- a/docs/releases/v2.0.3.mdx
+++ b/docs/releases/v2.0.3.mdx
@@ -9,7 +9,7 @@ description: CowAgent 2.0.3 - 新增企微智能机器人和 QQ 通道、Web 控

 新增企业微信智能机器人（`wecom_bot`）通道，支持流式卡片消息输出，支持文本和图片消息的接收与回复，可在 Web 控制台中进行通道配置和管理。

-接入文档：[企微智能机器人接入](/channels/wecom-bot)。
+接入文档：[企微智能机器人接入](https://docs.cowagent.ai/channels/wecom-bot)。

 相关提交：[d4480b6](https://github.com/zhayujie/chatgpt-on-wechat/commit/d4480b6), [a42f31f](https://github.com/zhayujie/chatgpt-on-wechat/commit/a42f31f), [4ecd4df](https://github.com/zhayujie/chatgpt-on-wechat/commit/4ecd4df), [8b45d6c](https://github.com/zhayujie/chatgpt-on-wechat/commit/8b45d6c)

@@ -17,7 +17,7 @@ description: CowAgent 2.0.3 - 新增企微智能机器人和 QQ 通道、Web 控

 新增 QQ 官方机器人（`qq`）通道，支持文本和图片消息的接收与回复，支持私聊和群聊场景。

-接入文档参考： [QQ机器人接入](/channels/qq)。
+接入文档参考：[QQ机器人接入](https://docs.cowagent.ai/channels/qq)。

 相关提交：[005a0e1](https://github.com/zhayujie/chatgpt-on-wechat/commit/005a0e1), [a4d54f5](https://github.com/zhayujie/chatgpt-on-wechat/commit/a4d54f5)

@@ -36,11 +36,11 @@ Web 控制台对话界面支持文件和图片上传，可直接发送文件给

 新增各厂商 Coding Plan（编程包月套餐）的接入支持，通过 OpenAI 兼容方式统一接入。目前已支持阿里云、MiniMax、智谱 GLM、Kimi、火山引擎等厂商。

-详细配置参考 [Coding Plan 文档](/models/coding-plan)。
+详细配置参考 [Coding Plan 文档](https://docs.cowagent.ai/models/coding-plan)。

 ## 🧠 记忆系统升级

-记忆冲刷（Memory Flush）系统全面升级：
+记忆写入（Memory Flush）升级：

 - 使用 LLM 对超出上下文窗口的对话内容进行智能摘要，生成精炼的每日记忆条目
 - 摘要在后台线程异步执行，不阻塞回复
@@ -60,6 +60,7 @@ Web 控制台对话界面支持文件和图片上传，可直接发送文件给
 - **配置模板对齐**：`docker-compose.yml` 环境变量与 `config-template.json` 对齐，补充完整的模型 API Key 和 Agent 等配置项
 - **Web 控制台端口映射**：新增 `9899` 端口映射，Docker 部署后可通过浏览器访问 Web 控制台
 - **配置热更新**：各模型 Bot 的 API Key 和 API Base 改为实时读取，通过 Web 控制台修改配置后无需重启即可生效
+- **工作空间持久化**：新增 `./cow` Volume 挂载，Agent 工作空间数据（记忆、人格、技能等）持久化到宿主机，容器重建或升级不丢失

 ## ⚡ 性能优化

@@ -68,11 +69,11 @@ Web 控制台对话界面支持文件和图片上传，可直接发送文件给

 ## 🐛 问题修复

- **bot_type 配置**：修复 Agent 模式下 `bot_type` 配置传递问题 ([36d54ca](https://github.com/zhayujie/chatgpt-on-wechat/commit/36d54ca)) ([#2691](https://github.com/zhayujie/chatgpt-on-wechat/pull/2691)) Thanks [@Weikjssss](https://github.com/Weikjssss)
- **bot_type 优先级**：调整 Agent 模式下 `bot_type` 的解析优先级 ([d0a70d3](https://github.com/zhayujie/chatgpt-on-wechat/commit/d0a70d3)) ([#2692](https://github.com/zhayujie/chatgpt-on-wechat/pull/2692)) Thanks [@6vision](https://github.com/6vision)
- **智谱模型配置**：修复智谱 `bot_type` 命名、Web 控制台持久化及正则转义问题 ([c4a93b7](https://github.com/zhayujie/chatgpt-on-wechat/commit/c4a93b7)) ([#2693](https://github.com/zhayujie/chatgpt-on-wechat/pull/2693)) Thanks [@6vision](https://github.com/6vision)
- **OpenAI 兼容层**：使用 `openai_compat` 层统一错误处理 ([f1e888f](https://github.com/zhayujie/chatgpt-on-wechat/commit/f1e888f)) ([#2688](https://github.com/zhayujie/chatgpt-on-wechat/pull/2688)) Thanks [@JasonOA888](https://github.com/JasonOA888)
- **OpenAI 兼容迁移**：完成所有模型 Bot 的 `openai_compat` 迁移 ([d5d0b94](https://github.com/zhayujie/chatgpt-on-wechat/commit/d5d0b94)) ([#2689](https://github.com/zhayujie/chatgpt-on-wechat/pull/2689))
+- **bot_type 配置**：修复 Agent 模式下 `bot_type` 配置传递问题 ([#2691](https://github.com/zhayujie/chatgpt-on-wechat/pull/2691)) Thanks [@Weikjssss](https://github.com/Weikjssss)
+- **bot_type 优先级**：调整 Agent 模式下 `bot_type` 的解析优先级 ([#2692](https://github.com/zhayujie/chatgpt-on-wechat/pull/2692)) Thanks [@6vision](https://github.com/6vision)
+- **智谱模型配置**：修复智谱 `bot_type` 命名、Web 控制台持久化及正则转义问题 ([#2693](https://github.com/zhayujie/chatgpt-on-wechat/pull/2693)) Thanks [@6vision](https://github.com/6vision)
+- **OpenAI 兼容层**：使用 `openai_compat` 层统一错误处理 ([#2688](https://github.com/zhayujie/chatgpt-on-wechat/pull/2688)) Thanks [@JasonOA888](https://github.com/JasonOA888)
+- **OpenAI 兼容迁移**：完成所有模型 Bot 的 `openai_compat` 迁移 ([#2689](https://github.com/zhayujie/chatgpt-on-wechat/pull/2689))
 - **Gemini 工具调用**：修复 Gemini 模型的工具调用匹配问题 ([eda82ba](https://github.com/zhayujie/chatgpt-on-wechat/commit/eda82ba))
 - **会话并发**：修复会话并发场景下的竞态条件问题 ([9879878](https://github.com/zhayujie/chatgpt-on-wechat/commit/9879878))
 - **历史消息恢复**：修复历史会话消息不完整问题，仅恢复 user/assistant 文本消息，剥离工具调用 ([b788a3d](https://github.com/zhayujie/chatgpt-on-wechat/commit/b788a3d), [a33ce97](https://github.com/zhayujie/chatgpt-on-wechat/commit/a33ce97))
@@ -80,7 +81,11 @@ Web 控制台对话界面支持文件和图片上传，可直接发送文件给
 - **Safari 兼容**：修复 Safari 浏览器 IME 回车键误触发消息发送问题 ([0687916](https://github.com/zhayujie/chatgpt-on-wechat/commit/0687916))
 - **Windows 兼容**：修复 Windows 下 bash 风格 `$VAR` 环境变量转换为 `%VAR%` 的问题 ([7c67513](https://github.com/zhayujie/chatgpt-on-wechat/commit/7c67513))
 - **MiniMax 参数**：增加 MiniMax 模型的 `max_tokens` 限制 ([1767413](https://github.com/zhayujie/chatgpt-on-wechat/commit/1767413))
- **.gitignore 更新**：添加 Python 目录忽略规则 ([9318138](https://github.com/zhayujie/chatgpt-on-wechat/commit/9318138)) ([#2683](https://github.com/zhayujie/chatgpt-on-wechat/pull/2683)) Thanks [@pelioo](https://github.com/pelioo)
+- **.gitignore 更新**：添加 Python 目录忽略规则 ([#2683](https://github.com/zhayujie/chatgpt-on-wechat/pull/2683)) Thanks [@pelioo](https://github.com/pelioo)
 - **AGENT.md 主动演进**：优化系统提示词中对 AGENT.md 的更新引导，从被动的"用户修改时更新"改为主动识别对话中的性格、风格变化并自动更新

+## 📦 升级方式
+
+源码部署可执行 `./run.sh update` 一键升级，或手动拉取代码后重启。详见 [更新升级文档](https://docs.cowagent.ai/guide/upgrade)。
+
 **发布日期**：2026.03.18 | [Full Changelog](https://github.com/zhayujie/chatgpt-on-wechat/compare/2.0.2...master)