Repository navigation
RunForge v0.16.2
历史对话与任务恢复以 step 聚合响应、工具结果及 run 元数据为依据;刷新后保留追加输入顺序、问答选择、工具结果与分支历史。
- 原始流式事件和 Provider trace 按 run、UTC 日期保存为本地 JSONL,自动保留三十天。
- 日志使用全局有限缓冲,磁盘写入失败自动重试;超限丢弃新日志并告警,业务继续。正常关闭等待执行资源结束后排空日志。
- HTTP 历史接口使用共享 Zod 契约,只传输展示所需内容;未完成 step 通过 WebSocket 重放内存流。
- CI 分别执行构建与快速测试、真实 PostgreSQL 迁移和存储集成验证;镜像发布前验证两种 PostgreSQL 部署方式。
升级操作
- 停止旧版 RunForge 实例并备份数据库、工作区、用户文件和业务插件持久卷。
- 更新 Compose 的日志配置:
RUNFORGE_TRACE_DIR=/app/traces,将该目录映射为持久卷或可写宿主机目录;保留现有数据库和其他持久卷。 - 使用新镜像的默认入口启动。入口先准备历史数据归档,再执行 Prisma migration,校验后删除旧事件、原始流字段和重复消息正文。不要绕过准备脚本单独执行 Prisma migration。
- 确认健康检查、历史对话和日志写入正常后,恢复 Bot 接入。
旧 runforge-provider-traces 卷保留原内容,不自动搬移或删除;新日志写入 runforge-traces。旧日志不参与对话恢复。
本版本包含数据库结构与数据迁移。回滚需要旧镜像配合迁移前数据库备份,不能只降级镜像;不要执行 docker compose down --volumes。
镜像:ghcr.io/4o4e/runforge:v0.16.2(linux/amd64)。