v0.7.2 正式版

Yuxi v0.7.2 正式版

Yuxi v0.7.2 是自 v0.7.1 以来的一次完整运行时与工作区升级，重点重构了 Project/Workdir、Agent 调度与恢复、知识库处理、安全边界和 CLI 工具链。以下内容按 v0.7.1 → v0.7.2 汇总，包含 beta1、beta2 以及正式版收尾的全部主要变化。

主要更新

Project、Workspace 与持久化

• 新增 Project 业务资源，作为 Conversation Workdir 的持久化 Owner；支持创建、选择、更新和删除 Project，并完成侧边栏项目分组与生命周期同步。
• 顶层 Conversation 与子 Agent 共用稳定的 runtime scope，不同顶层 Conversation 即使绑定同一目录也保持运行隔离。
• 统一 UserWorkspace、Workdir、Viewer、附件和 artifact 的文件边界，移除开发期 file-bridge 与旧 Thread 文件浏览路径。
• 提供 v0.7.1 存储迁移流程，将历史 Conversation、附件、产物、共享 Skill 和运行身份迁移到新布局。

Agent 运行、队列与调试

• 普通请求先持久化后按同一用户、Agent、线程的 FIFO 顺序调度；支持排队、取消、暂停恢复、Resume 和 Steer 安全接替。
• AgentRun 新增 write-once 运行清单、RunAttempt、执行 Owner、lease/heartbeat 和失联收敛，输出、事件、artifact 与错误严格绑定同一 request/run。
• LangGraph checkpoint 统一使用 PostgreSQL，不再提供 SQLite 后端或静默降级。
• 新增工具审批与完全信任模式、用户级 Memory、Skill 预加载、Token Usage 统计、子智能体安全过滤及确定性 Agent E2E 门禁。
• Debug 面板按真实 Run 分组消息，可查看原始事件并精确跳转对应 Langfuse trace。

知识库、图谱与评估

• 完善真实文件夹管理、目录上传、历史虚拟目录迁移、大规模文件分页与统计性能。
• 支持知识库 OCR 配置、Office/PDF 预览、交付物目录选择、QA Markdown 标题解析和超长分块边界修复。
• 知识图谱构建支持持续队列、失败重试、断点恢复、向量 reconcile 和分阶段进度展示。
• 统一知识库读取与权限契约，新增私有图片代理，修复公开图片访问风险。
• 优化扩展详情、评估数据集续跑和评估结果刷新体验。

Skills、MCP 与安全

• 新增个人 Skill、共享投影和远程 Skill 来源白名单；远程安装改用无环境凭据的一次性 Sandbox，并限制回流路径、文件数、深度和总大小。
• HTML 预览迁移为内置 Skill；新增工作区和 Agent 文件搜索、原生异步文件读取及安全路径校验。
• 用户配置不再允许 stdio MCP，避免通过管理接口启动任意本地进程；系统内置 stdio MCP 保持代码级管理。
• 增加登录 IP 级限速、API Key 安全重放与 tombstone、头像与知识库图片内容校验，并收紧 Sandbox、MinIO 和权限边界。
• 修复 transformers save_pretrained chat template 路径遍历漏洞，发布依赖审计无已知产品漏洞。

Web、Dashboard 与开发体验

• 优化 Agent 文件面板、全局搜索、对话草稿、流式消息、执行耗时、审批交互和项目/最近对话分组。
• Dashboard 保留聚合统计，移除智能体 TOP 5 排行；无项目时不再展示空 Project 分组。
• Compose 支持 project-scoped 镜像、端口与状态目录，可为多个 Git worktree 分配隔离运行槽位。
• 建立 Engineering Trust、Spec Loop、依赖供应链审计、真实 readiness 和运行时系统测试门禁。

Yuxi CLI 0.1.4

• 在现有 Agent Eval、知识库批量操作和远程实例管理能力上，新增本地网页聊天与纯文本 Channel 入口。
• 新增 yuxi agent list 与 yuxi agent show <slug>，可查看当前用户授权可见的 Agent 及角色过滤后的配置。
• 保持浏览器/API Key 登录和 JSON 输出；CLI 0.1.4 已同步发布至 PyPI。

重要升级说明

从 v0.7.1 升级时，本版本包含数据库和持久文件布局迁移：

1. 安排维护窗口并停止 API、worker 及业务写入。
2. 在同一停机时点完整备份 PostgreSQL、MinIO 和 Yuxi 文件卷，并确认可成套恢复。
3. 使用与正式重启完全相同的 Compose、env file 和 profile 参数执行 scripts/migrate-storage.sh；迁移成功前不要启动新 API 或 worker。
4. 历史 SQLite LangGraph checkpoint 不迁移。升级前请完成或终止重要审批、中断和运行。
5. 历史知识库 Markdown 与 public bucket 图片不会自动迁移到私有 bucket；需要重新解析并在核对结果后清理旧公开对象。
6. 历史用户 stdio MCP 会被禁用，请迁移到 SSE 或 Streamable HTTP。

完整迁移边界与回滚要求请阅读 Changelog 中的 v0.7.2 beta1/beta2 升级说明及生产部署文档。

完整变更

• 完整 Changelog
• v0.7.1...v0.7.2