Skip to content

v0.7.2 Beta 1

Pre-release
Pre-release

Choose a tag to compare

View all tags
@Yuchuan925 Yuchuan925 released this 23 Aug 16:48
· 111 commits to main since this release
v0.7.2.beta1
82e719e

⚠️ Beta 与数据迁移警告

此版本涉及不可逆的数据与文件布局迁移，主要影响历史对话线程、附件、Agent 产物、Project/Workdir 绑定和运行状态。

不建议在重要、生产或缺少可恢复备份的环境中运行本 Beta 版本。 推荐先在隔离环境使用生产数据副本验证升级、回滚与核心业务链路。

升级前必须完成

  1. 本次自动迁移只支持从 v0.7.1 正式版或当前 v0.7.2 schema 升级；运行过未发布 Workdir 中间 schema 的实例会被拒绝。
  2. 停止业务写入，并在同一停机时点完整备份 PostgreSQL、MinIO 和 docker/volumes/yuxi；确认三者可以成套恢复。
  3. 完成或终止重要 AgentRun，并保存所需结果。迁移会把非终态 Run 收敛为失败；v0.7.1 SQLite LangGraph checkpoint 不迁移，未完成的审批、中断、摘要或执行状态无法继续恢复。
  4. 检出本 tag 后，使用与后续启动完全相同的 Compose、env file 和 profile 参数运行迁移：
bash scripts/migrate-storage.sh -f docker-compose.prod.yml --env-file .env.prod

迁移按 Workdir、系统配置、共享 Skill 和运行身份分阶段提交，不是跨 PostgreSQL、MinIO 与文件卷的单事务操作。失败后请保持 API/worker 停止，保留日志，修复冲突后使用相同参数重跑。需要回滚时，检出 v0.7.1，并从同一停机时点成套恢复 PostgreSQL、MinIO 和文件卷；不要只恢复其中一项。

历史知识库 Markdown 与 public bucket 图片不会自动迁移，旧 URL 升级后仍可能匿名可读。敏感知识库需要重新解析生成私有 kb-images 对象，确认新结果后再清理旧公开图片。

完整步骤见：

主要更新

  • 新增 Project 业务资源，Conversation 通过不可变 project_id 绑定 Workdir；支持选择或创建绑定 Workspace 目录的 Project。
  • Workdir、Viewer、附件与 artifact 收敛到 UserWorkspace 的统一持久文件边界，父子 Agent 共享 Workdir 但顶层运行环境保持隔离。
  • 新增 AgentRun 运行清单指纹与 RunAttempt 执行历史，增强运行审计和故障归因。
  • 升级 DeepAgents 0.7.7+ 与新版 LangChain，适配每 Run backend、结构化文件分页、grep 截断和 Summary 媒体 offload。
  • 新增 Skill 预加载，使选定 Skill 的根说明和依赖工具从首轮模型请求起可用。
  • 新增用户级 Memory：主 Agent 可受限更新 agents/MEMORY.md 并按需检索当前用户的普通历史对话。
  • Sandbox 异步 read_file 改用 agent-sandbox 原生文件 API，并显式管理异步 HTTP client 生命周期。
  • AgentPanel 统一文件树、文件预览和子智能体线程 Tab；Web 增加流式文本平滑、知识库结果真实身份分组和紧凑片段弹窗。
  • 建立 Agent-first 工程信任、Spec Loop、确定性 Runtime System Tests 与依赖供应链审计门禁。

已知升级影响

  • 持久 UserWorkspace、Skill source/projection 将统一为 1000:1000，目录和普通文件权限收紧为 owner-only。
  • v0.7.1 base.toml 与共享 Skill 会迁移到当前 PostgreSQL/Skill source Owner；个人 Skill 保留在用户 UserWorkspace。
  • 用户配置的 stdio MCP 将被禁用且无法重新启用；请迁移到 SSE 或 Streamable HTTP。
  • Redis 重建或升级后需要重启 worker，并等待 /api/system/ready 恢复后再接入流量。

验证

发布提交在 xerrors/Yuxi 与 Yuchuan925/Yuxi 均通过：

  • Engineering Trust Contracts
  • Ruff Format Check
  • Backend Unit Tests
  • Web Quality
  • Runtime System Tests
  • Dependency Supply Chain Audit
  • VitePress Docs Build / Deploy

本地后端非 slow unit：1502 passed, 39 skipped。

Assets 2
Loading