Yuxi

本次 beta5 默认使用 Container 沙盒，同步 Linux/macOS 与 Windows 初始化、中英文 README、快速开始和生产部署指南。API 接入页提供完整 APP 凭据与使用统计，知识库提供 MCP 接入指引；暗色界面通过背景色阶区分区域，输入框去除装饰边框与阴影，发送按钮采用白色，并修正空态文字可读性。

0.8 面向全新部署。Container 适用于可信单租户场景；需要持久用户 VM 或强隔离时，显式选择 Cube。启动 Container 时使用 docker compose --profile container up --build -d。

以下保留相对 v0.7.3 的完整 0.8 更新与兼容说明。

Yuxi 0.8.0：面向企业智能体基座进化

Yuxi 0.8 围绕企业使用智能体的完整过程展开升级：将业务知识接入任务，让多个智能体分工协作，在关键环节保留人的参与，并把成果、来源和执行记录留在同一工作空间。

这个版本的重点，是让智能体能力更容易融入企业业务、更容易沉淀复用，也让复杂任务的执行更可控。开放集成、团队治理、多智能体协作、知识溯源与底层架构共同构成了这次演进。

当前测试版本为 0.8.0.beta5。默认部署与试用步骤见快速开始。

一、面向企业智能体基座进化

从团队内部的专属助手，到嵌入业务系统的智能体服务，0.8 进一步打通身份、能力、知识与应用之间的连接。

开放接入，让智能体融入已有业务

• 将智能体接入业务应用与自动化流程：统一的 Public API 和全新 npm CLI 提供会话、任务提交与流式结果入口，支持附件及图片输入，让网页之外的应用和脚本也能使用 Yuxi 的智能体能力。设置中的 API 接入页集中展示 APP 凭据、使用统计和接口示例，知识库提供同源 MCP 接入指引。
• 让企业知识服务于更多 Agent：内置知识库 MCP 服务，向外部客户端开放知识检索、文件查找和正文阅读。外部 Agent 可以在用户授权范围内使用 Yuxi 知识，无需单独部署知识 MCP 服务。
• 连接员工自己的工具账号：远程 MCP 增加个人 OAuth 授权，每位用户可以连接自己的资源账号，平台统一管理服务入口。企业登录与外部工具授权分别管理，适配范围见 MCP 集成。

团队治理，让能力共享有边界

• 融入企业身份体系：完善 OIDC 登录与账号绑定，区分平台用户和业务应用终端用户；应用之间的会话、附件与执行按 APP 隔离。智能体支持私有使用和授权共享，工具、知识库与 Skills 按当前用户权限使用。
• 把业务经验沉淀为可复用能力：智能体可绑定专属 Skill，将操作方法、脚本和模板一起交付；支持完整包在线编辑、专属 Skill 发版与历史恢复，方便团队维护和迭代自己的业务助手。
• 看清平台使用与改进方向：管理概览汇总智能体、模型、工具和 Token 使用趋势，并可配合模型网关按用户归集用量。结合用户反馈、Agent 改进线索和整轮任务调试，帮助团队了解使用情况、定位改进方向。
• 呈现企业自己的品牌：产品名称、Logo、首页口号与登录背景统一配置，让任务入口与企业品牌保持一致。

接入指南：Agents API · CLI · 知识库 MCP · 企业登录 · Skills 管理

二、多智能体协作，推进复杂任务交付

研究、分析与内容制作往往需要多种能力配合。0.8 将分工协作、人工引导与成果呈现串联起来，让用户能够持续参与任务推进。

• 多个智能体，围绕同一个项目工作：协作成员拥有独立上下文和会话，可以分派任务、互发消息、等待并汇总结果，共享项目文件。用户可提及已有智能体参与分工；管理员可按部署容量调整协作深度与并发名额。
• 复杂过程看得见，关键环节接得住：协作面板展示成员层级、状态和人工待办，用户可以直接进入成员会话回答问题、处理审批或调整要求，减少在多个执行过程之间寻找信息的负担。
• 追加任务与调整方向各有入口：普通消息按顺序排队，运行中可以发送优先引导；待处理输入支持逐条取消或转为引导，也可停止整组协作并在需要时继续队列。引导在安全执行边界生效，已完成的外部操作不会自动撤销。
• 从资料输入到成果交付更连贯：支持多图输入和保留目录结构的文件夹上传；回答可组合图表、图片与图文卡片，简短表单帮助一次收集任务条件，文件交付物可继续预览与下载。
• 切换会话，也能接着工作：会话草稿、侧栏与阅读位置随任务保留，实时输出与历史读取衔接。智能体被删除或撤回访问后，用户仍可在原有权限范围内查阅自己的历史工作记录。

了解更多：会话协作 · 工具与交付

三、知识服务升级，让答案有据可查

企业知识的价值，既在于找到相关内容，也在于让使用者能够核对依据。0.8 将检索、阅读与来源追溯连成更完整的知识使用体验。

• 兼顾语义理解与精确查找：知识库支持向量、BM25 和混合检索，并提供必含词、排除词、完整短语与命中高亮，兼顾自然语言问题，以及术语、型号、编号等精确查询。
• 从答案直达原文依据：来源胶囊支持引用预览与文档定位，正文行号连接检索片段和原文阅读。来源标注可独立选择模型，按需处理已完成回答中的正文、图片与表格；标注失败可重试，不改写原回答。
• 直接使用已有飞书知识：新增飞书知识库只读连接，在线搜索指定知识空间并读取新版普通文档正文，减少维护本地文档副本的工作。连接使用管理员配置的身份权限，适用文档类型见知识库 API。
• 让知识资产更易组织和维护：目录上传、移动与重命名采用统一的目录规则，文件状态摘要集中呈现待处理、处理中和失败情况，帮助管理员快速发现入库问题。
• 让文档处理适应不同资料：补充旧版 Excel 多工作表解析与离线 HTML 正文提取；MinerU 支持选择自托管解析后端、处理强度或官方解析模型，便于按资料特点配置处理方式。

使用指南：知识库入门 · 文档处理 · 知识图谱

四、架构焕新，让智能体运行更可靠

能力越丰富，越需要清晰的运行基础。0.8 对任务执行、知识接入和部署装配进行系统梳理，为持续扩展与问题定位建立更明确的边界。

• 以持久任务记录支撑长流程：输入接收、排队、执行与最终结果围绕统一的会话和任务模型组织。任务状态持久保存，审批、引导和协作等待能够接续；异常退出有恢复处理和可查询的失败结果，便于追踪任务停在哪里。
• 执行环境按场景选择：默认 Container 为每段执行创建临时容器，在可信代码、单租户或本地开发场景下无需 KVM；显式选择 Cube 时，每位用户拥有可跨会话复用的持久虚拟机。两者共用文件工具、审批与审计，停止和接续都纳入执行清理流程。

⚠️ 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 对象，确认新结果后再清理旧公开图片。

完整步骤见：

• 生产部署指南
• v0.7.2.beta1 版本变更记录

主要更新

• 新增 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。

Yuxi v0.7.1 正式版

Yuxi v0.7.1 重点增强了生产部署安全性、Agent 运行能力、知识库大规模文件处理能力，并正式完善了 Yuxi CLI 工具链。

主要更新

• 强化生产部署安全：隔离动态沙箱网络，引入 Sandbox Provisioner Token，收紧生产环境默认凭证、CORS、Dashboard 权限及 MinIO 访问边界。
• 增强 Agent 能力：支持异步子智能体、Agent Invocation、Agent Eval、Summary 上下文压缩状态、Token Usage 面板及图片 OCR 自动回退。
• 升级知识库体验：支持大规模文件分页与懒加载、增量思维导图、PaddleOCR 云端解析、分块策略接口及异步文档处理。
• 完善 Skills 与工具系统：知识库能力迁移为内置 Skill，新增 search_file、ocr_parse_file 等工具，并增强工具结果卸载与运行时配置同步。
• 发布 Yuxi CLI 0.1.3：支持浏览器/API Key 登录、知识库批量上传、重复文件预检、Agent Eval 及远程实例管理。
• 优化稳定性与性能：修复数据库连接长期占用、Redis SSE 连接竞争、Tasker 关闭死锁、Milvus 同步调用阻塞事件循环等问题。

重要升级说明

本版本包含以下破坏性变更，请在升级前阅读：

• 沙箱 provisioner 现在强制要求 SANDBOX_PROVISIONER_TOKEN，已有动态沙箱将按新的隔离网络重建。
• 历史未绑定用户的 API Key 将在 schema 升级时被清理。升级前请检查：SELECT id, name, department_id FROM api_keys WHERE user_id IS NULL;
• Dashboard 现在仅允许 superadmin 访问。
• 生产环境默认拒绝跨域请求；跨域部署需要显式设置 YUXI_CORS_ORIGINS。
• /api/system/config 调整为所有登录用户可读，其中可能包含不带密钥的基础设施配置信息。

升级前建议备份数据库和环境配置，并重新运行初始化脚本补齐新增的安全配置。

完整变更

• 完整 Changelog
• v0.7.0...v0.7.1

Yuxi 0.7.0 发布说明

发布日期：2026-06-13 · 许可证：MIT

1. 版本变更记录
2. 语析 Yuxi 0.7 发布-小红书
3. 开源语析 Yuxi 0.7 Beta 多智能体协同调度演示 - Bilibili
4. 开源语析 Yuxi 0.7 知识库、知识图谱演示 - Bilibili

Yuxi 0.7.0 是一次以「能力边界收敛 + 智能体体系升级」为主线的重要版本。我们将分散的模型配置、智能体配置、知识库类型、Skill 安装与用户身份等多条历史链路统一收敛到清晰的一级模型上，并在此基础上交付了深度研究多智能体、知识图谱检索、个人工作区等一批新能力。

⚠️ 本版本包含多项破坏性变更，建议全新部署或在升级前阅读「升级须知」。

✨ 版本亮点

智能体

• 深度研究多智能体：内置编排器 deep-research（负责澄清、拆解、并行调度与综合成稿）+ 子智能体 research-explorer（多轮检索网页/知识库并返回带引用发现）+ fact-verifier（对抗式核验关键论断、标注冲突与置信度），研究方法论沉淀为内置 Skill deep-research。
• 子智能体升级为 Agent-backed 形态：子智能体即 agents.is_subagent=true，通过 task 工具启动真实子 Agent graph，支持真实流式输出、产物回传父线程、child thread 续聊与执行状态展示。
• 智能体配置收敛为一级 Agent：用户可见配置统一持久化为数据库 Agent，聊天/运行/审批/文件预览均从线程绑定的 Agent 解析运行时上下文，前端只提交 agent_id。

知识库与图谱

• Milvus 知识库内图谱构建与检索：支持 entity/triple 抽取入库、Neo4j 2-hop 子图 + igraph PPR，并以 Chunk 为产物经 RRF 与向量召回融合。
• 知识库 Chunk 持久化到 PostgreSQL：索引/更新流程将 chunks 双写到 PostgreSQL 与 Milvus，文件内容查看优先查 PostgreSQL，分批 embedding 与分批写入规避 gRPC 消息大小限制。
• 只读知识源连接器：新增 ReadOnlyConnectors 基类与 Notion Data Source（支持 Search/Find/Open），前端按知识库类型动态渲染创建表单。
• RAG 评估体系入库：数据集、题目、评估运行与逐题结果统一入库，JSONL 仅作导入/导出格式。

模型与运行时

• Provider 与模型配置统一：运行时模型统一使用 provider_id:model_id，自定义 provider 迁移到数据库与独立 provider 模块；新增 Anthropic provider type 适配。
• Agent run/SSE 标准化执行链路：统一 Redis Stream envelope、Last-Event-ID 回放、心跳与终止事件，并新增 verbose=false 精简模式降低传输冗余。

其他

• 图片生成迁移为内置 Skill image-gen，复用 present_artifacts 产物展示链路。
• 个人工作区：独立于对话线程的用户级 workspace 浏览/编辑/上传/下载，并支持用户级沙盒环境变量。
• 聊天附件与 @ 文件提及：支持 MinIO 临时上传、可选 PDF/图片解析、跨 workspace/thread 来源搜索与引用单元渲染。

🛠️ 重要修复

• 修复 SiliconFlow MiniMax 与阿里云百炼工具调用经 LangGraph v3 流式累积丢失 function.name / tool_call.id 导致工具状态卡在「进行中」的问题（对这两类 provider 默认禁用工具调用流式，正文回答仍流式）。
• 修复多模态对话上传透明 PNG 失真、.jpg 包裹 PNG 内容时前端按错误格式加载的问题。
• 修复用户管理列表超过 100 人被默认分页截断的问题。
• 修复知识库文件大小显示为 0、MinERU 文档解析配置说明错误等问题。

💥 升级须知（破坏性变更）

1. 模型配置：移除旧版 v1 模型配置与 Ollama 支持，运行时统一 provider_id:model_id。升级后需在「模型配置」中重新确认 provider 与启用模型。
2. 智能体：用户可见的 AgentConfig 收敛为数据库一级 Agent，前端只提交 agent_id；旧的线程绑定配置语义不再兼容。
3. 知识库：移除 Upload 与 LightRAG 知识库/图谱能力，知识库类型收敛为 Milvus 与只读连接器；知识库 API 统一为 /databases/{kb_id}/xxx，并整合 mindmap / eval 子接口。旧 LightRAG/Upload 知识库无法迁移。
4. Skill：元数据改用 source_type/share_config/enabled 表达来源/范围/启用状态；上传与远程添加统一为「解析草稿后确认安装」，不再保留旧直接安装路径。
5. 用户身份：业务登录标识统一为字符串 uid，user_id 仅保留给数值 users.id 或真实外键场景。
6. 历史兼容层精简：移除 sandbox provisioner local 后端别名、ask_user_question 单问题旧协议、JWT 历史默认密钥特殊判断、内置 Skill SKILLS.md 文件名回退、运行事件数字 seq 兼容及前端旧字段回退。

由于涉及数据库结构与资源标识的多处收敛，推荐全新部署；如需在已有实例上升级，请提前备份数据库并验证。

🚀 升级方式

# 拉取 v0.7.0
git clone --branch v0.7.0 --depth 1 https://github.com/xerrors/Yuxi.git
cd Yuxi

# 配置环境变量后启动
docker compose up -d

镜像标签默认 YUXI_VERSION=0.7.0，可通过 .env 覆盖。

完整变更

逐条变更（破坏性变更 + 开发记录共数十项）见 版本变更记录 · v0.7.0。

What's Changed

• feat(mention): 优化@提及搜索排序与高亮展示，修复唤醒交互及路径硬编码问题 by @supreme0597 in https://github.com/xerrors/Yuxi/pull/708
• fix(knowledge): 在 LITE_MODE 下安全跳过不支持的知识库类型，防止 API 崩溃 by @supreme0597 in https://github.com/xerrors/Yuxi/pull/719
• Feat: 新增支持 AI 对话回复带 svg 渲染 by @supreme0597 in https://github.com/xerrors/Yuxi/pull/716
• fix: 修复 sandbox backend edit 方法错误访问 result.data.success by @supreme0597 in https://github.com/xerrors/Yuxi/pull/720
• fix(backend): 统一为本地及MCP动态工具注入handle_tool_error容错 by @supreme0597 in https://github.com/xerrors/Yuxi/pull/725
• fix(docker): worker 使用 watchfiles 替代 arq 以优化热重载 by