跳到主要内容

更新日志

本文记录 xAgent 免费二进制版本中与安装、使用和安全治理相关的重要变化。当前仍是测试版，功能、界面和协议可能继续调整。

v0.0.10.beta - 2026-08-16​

查看安装方式 · 任务理解与能力选择说明 · Agent Loop 与上下文管理说明

本版本重点完善任务理解、能力准备与跨会话协作链路，让 Agent 能围绕当前任务更准确地选择 Skill、Tool 和长期记忆，并在任务目标变化时及时调整执行环境。同时补齐平台能力自知、项目化会话导航、上下文观察、文件交付、Skill 展示和管理员恢复能力。

任务理解、能力准备与长期记忆​

  • 子会话收到新消息后，会先判断消息与当前阶段目标及会话总目标的关系。目标延续时直接继续当前任务，目标变化时再调整 Skill、Tool 和长期记忆等任务环境。
  • 能力检索会从任务目标中分别提炼 Skill、Tool 和 Memory 所需的检索短语，围绕方法、动作、证据、质量、领域、交付物和可复用知识查找候选能力。
  • Skill、Tool 和 ToolSet 使用统一的能力摘要参与候选检索，再由任务能力编排完成最终选择；独立 Tool 也可以直接进入候选范围。
  • xAgent 会向 Agent 说明稳定的平台能力范围，包括发现 Skill 与 Tool、使用长期记忆、管理凭据引用、通过 Connector 连接外部系统，以及接收外部入口或定时触发器产生的信号；当前运行时事实和权限仍决定本轮实际可用能力。
  • 会话界面会显示理解任务语义、提取任务要点、查找相关能力、编排任务和应用任务环境等准备阶段。
  • 提供 Tool 不再强制模型调用；有 Tool 时由模型根据任务决定是否使用，没有 Tool 时明确禁用 Tool 调用，减少重复调用和无意义循环。
  • 强化短请求、计划执行和能力使用规则，Agent 会先确认任务是否具备执行条件，再选择直接处理、补充信息或调用能力。

项目化会话与跨会话协作​

  • 会话侧栏按会话、项目、团队和 Connector 分组展示；支持创建项目，以及在项目中继续创建独立会话。
  • 子会话创建使用明确的会话目标和首条任务消息，原始附件会随任务传递，但不会把路由包装重复当成执行指令。
  • 主会话与子会话之间的协作请求会持久保存，子会话结果会回到准确的来源会话；刷新页面或服务恢复后不再依赖临时内存维持等待关系。
  • 会话可以向另一个已存在的内部会话发送单向消息，并通过精确会话引用避免误投递。
  • 执行中发现当前计划步骤过大时，Agent 可以把该步骤拆成连续检查点，同时保留原计划顺序和已完成进度。
  • 改进长会话历史加载、运行状态恢复和消息时间线展示，加载更早消息失败时会提供明确状态。

Skill 展示与上下文管理​

  • Skill 支持按用户语言展示名称、描述和图标；管理列表、详情页和会话能力选择器使用一致的 Skill Card 信息。
  • 高级配置会展示当前会话实际加载的 Skill 与 Tool，并保留不可用但已选择的能力状态，便于核对真实运行配置。
  • 会话工具栏新增只读的上下文缓存快照，可查看 History、System Prompt、已加载 Skill、执行上下文、本轮上下文和长期记忆的大小与缓存状态，并可复制摘要用于排查。
  • 管理后台新增“任务相关度 Agent”角色配置，与会话 Agent、任务能力编排、摘要和 OCR 角色分开管理。
  • Skill 摘要生成与检索材料使用同一版本边界，旧摘要会按需刷新，避免界面信息与能力检索描述不一致。

文件预览与交付​

  • Markdown 文件新增渲染预览，并可在“预览”和“源码”之间切换；表格、代码块、列表和换行会按文档结构展示。
  • 电子表格预览支持在同一文件中切换工作表，并对大表格使用独立滚动区域。
  • Workspace 文件提供稳定的独立下载页面，支持直接打开下载链接、失败重试和再次下载，文件名中的特殊字符也会按原路径处理。
  • Workspace 中的 Agent 会话、项目文件、共享文件、业务空间、上传文件和团队资料统一使用本地化名称与说明。

用户偏好与管理员恢复​

  • 回复语言调整为确定的中文或英文选项，并与当前界面语言保持一致；切换语言后，界面和后续 Agent 回复使用同一语言设置。
  • 回复详细程度和“直接执行 / 先列计划”工作流偏好继续由个人设置统一保存，并稳定作用于新一轮任务。
  • 管理员格式化用户数据时，会同时清理长期记忆、记忆摘要和后台提取状态；账号、Skill、密钥、Connector、模型配置和 Token 统计会保留，确认框会明确展示新的清理范围。
  • 新增服务器本机管理员密码恢复命令。密码只能在交互式终端输入，重置成功后该管理员的旧登录状态会全部失效。

稳定性改进​

  • OpenAI 及兼容 Provider 在 Tool 参数流被输出上限截断时，不再把半截参数当作空对象执行，而是按输出上限结束并交由上层恢复。
  • 统一流式与非流式响应的 Tool 参数校验、结束原因和历史回放处理，减少模型已经结束但界面仍重复调用 Tool 的情况。
  • Tool Schema 会保留输入字段顺序，并继续适配不同 Provider 的结构限制，提高复杂文件写入和多参数 Tool 的调用稳定性。
  • 收口会话回复、Prompt 装配、文件访问和存储兼容路径，删除会造成双重解释或重复执行的旧流程。

升级说明​

  • 本版本会自动升级会话协作等相关存储结构，无需手工执行数据库迁移。
  • “格式化用户数据”的清理范围已扩大到长期记忆和后台记忆任务；执行前请重新确认保留与删除内容。
  • 管理员无法登录时，可在服务器本机停止服务后执行 xagent admin reset-password --username <管理员用户名> --config <config.yml 路径> 完成恢复。
  • 升级前请备份 xAgent 配置、数据库、用户工作区、Memory、Skill、Tool 包和 Connector 状态。

v0.0.9.beta - 2026-08-10​

查看安装方式 · 完整发布说明

本版本把管理后台与用户工作区拆分为两个独立入口，统一 Web 与桌面端的会话布局，并让会话级提示词可以直接编辑且从下一轮请求生效。

管理后台与用户工作区​

  • 新增独立的 /admin/login 和 /admin 管理入口，管理菜单、登录跳转、退出登录和版本升级均在管理后台内完成。
  • /app 固定为用户入口；管理员从这里登录时也使用个人会话和工作区，不再混入系统治理菜单。
  • 用户端与管理后台不再互相提供跳转入口，避免把个人工作与组织管理放在同一导航结构中。

会话工作区​

  • Web 与桌面端统一为左侧会话栏、右侧会话内容的双栏结构。
  • 主会话固定在搜索框上方，子会话继续按最近活跃顺序展示。
  • 会话内容随可用空间按比例伸缩并保持居中，空状态、消息区和输入区使用一致的内容基准线。
  • 工具栏不再显示内部 Session 标识，高级配置改为图标入口；侧栏账号菜单提供个人设置和退出登录。

会话提示词与配置​

  • 中文界面统一使用“提示词”名称；没有现有内容时也会显示可编辑文本框。
  • 提示词默认展开并提供更大的编辑区域，长内容在文本框内部滚动，不会遮挡实际配置。
  • 保存后的会话级提示词从下一轮请求生效，适用于主会话、Connector 会话和普通子会话。
  • 配置类抽屉不再因误点遮罩关闭，减少未保存内容丢失；只读信息抽屉仍可点击空白处关闭。

用量统计与稳定性​

  • 用户端仪表盘调整为“用量统计”，仅展示当前用户的 Token、模型调用和 Tool 调用；管理后台继续提供组织级统计。
  • 模型用量明细默认直接展示，无需再次展开。
  • 修复旧 Memory 数据在读取或列表查询时可能被改写的问题，并统一数据库检查、建表和升级的启动顺序。

升级说明​

管理员需要把旧的 /app/admin/... 书签和反向代理规则更新为 /admin/...，新的管理登录页是 /admin/login。/app 现在直接进入用户会话工作区，个人用量统计位于 /app/dashboard。升级前请备份配置、数据库、用户工作区、Memory、Skill、Tool 包和 Connector 状态。

v0.0.8.beta - 2026-08-09​

查看安装方式 · 完整发布说明 · 备份与恢复指南

本版本新增在线增量备份与灾难恢复，重新明确本地正式文件和外部云存储的边界，并完善会话文件复用、Skill 多语言治理和本地存储清理。

在线备份与灾难恢复​

  • 支持把 S3、兼容 S3 或 WebDAV 配置为备份仓库，并在启用前测试连接和初始化仓库。
  • 支持手动与定时备份；每个完成的快照都可独立恢复，远端只上传新增或变化的加密内容。
  • 支持在线下载、校验和准备指定或最新快照；正式目录切换在 xAgent 停止后执行。
  • 切换后可以验证并确认，失败时可以停机回滚；中断的恢复流程可以从持久化日志继续。
  • 支持下载独立的 recovery.yml，原数据库不可用时仍可列出完整快照和准备恢复。

云存储与公共目录​

  • 支持把 S3、兼容 S3 和 WebDAV 映射到公共目录，每个接入使用独立前缀。
  • 公共目录原有用户和用户组 ACL 继续生效；管理员可以创建目录和上传文件，授权用户可以浏览、预览和下载。
  • 静态凭据加密保存；内部自签名存储可以按接入单独跳过 TLS 证书校验。
  • 远端不可用时保留入口并显示不可用状态，不再把连接失败误认为空目录。

会话、Skill 与生产能力​

  • 消息输入区可以直接选择当前可见的工作区、公共目录和云存储文件作为会话附件。
  • 远端公共文件按需处理为模型可读内容，原文件仍保留在外部存储；失败的导入不会留下无效附件。
  • Skill 列表、搜索和运行时能力按回复语言投影，并统一使用 SKILL.md 中的正式名称。
  • Connector 卡片使用服务声明的真实版本并校验关联 Skill ID。
  • 生产模式隐藏开发期 Tool 管理页面和修改接口，不影响会话与智能体选 Tool、审批策略或个人 MCP。

本地存储与升级边界​

  • 后台清理同时观察磁盘空间与 inode，仅回收过期暂存、终态诊断、临时数据和未被引用的文件内容，不按年龄删除正式用户数据。
  • 0.0.8.beta 起，正式文件存储固定为本地目录；旧版 S3 正式存储会在完整性校验后迁回本地，失败时停止启动并保留原配置。
  • S3 与 WebDAV 现在用于公共目录云存储接入，不再作为正式文件存储 Provider。

升级说明​

升级前请备份配置、数据库、工作区、Memory、Skill、Tool 包和 Connector 状态。备份仓库初始化后应立即下载并离线保存 recovery.yml；它包含仓库访问和解密所需的敏感信息。公共目录背后的第三方云存储内容不进入 xAgent 备份，需要在对应存储服务上单独保护。

v0.0.7.beta - 2026-08-06​

查看安装方式

本版本重点升级文件存储与团队共享，推出首个桌面端版本，并继续优化模型请求缓存、Provider 兼容性和图片识别能力。

文件存储与团队共享​

  • 新增统一的 Local/S3 文件存储 Provider，支持 AWS S3 和兼容 S3 的对象存储；启用前可以验证连通性与读写权限。
  • 支持在 Local 与 S3 之间迁移正式文件。迁移失败不会替换当前有效 Provider；S3 暂时不可用时可以降级到本地存储，恢复后补传内容并切回 S3。
  • 新增实例级 share 共享目录，管理员可以创建目录，并上传、移动、重命名、下载和删除共享内容。
  • 统一 workspace、upload 和 share 的文件 ACL；共享目录支持按用户或用户组设置可继承的只读 R 和读写 RW 权限。

图片识别与 OCR​

  • 新增可配置的 OCR 模型角色，管理员可以选择支持视觉输入的模型，并单独配置 OCR 模型策略。
  • 图片附件需要文本内容时，可以生成包含可见文字、必要视觉描述和主要语言的规范 Markdown 内容。
  • 本版本 OCR 面向图片附件；没有文本层的纯扫描 PDF 仍暂不支持。

Desktop Client v0.0.1​

  • 首次发布 xAgent Desktop Client，提供 macOS Apple Silicon 和 Windows AMD64 安装包。
  • 客户端可以发现当前平台的新版本，确认后下载对应安装包、校验 SHA-256、替换程序并自动重启；替换失败时保留原安装并尝试恢复启动。

模型上下文与 Provider​

  • 优化单轮任务中的稳定上下文与实时状态组织，整体 Token Cache 缓存率提升 13%，减少重复请求带来的等待和消耗。
  • 增强 LLM Provider 适配兼容度，改善不同模型服务配置的接入体验。
  • 统一 OpenAI、Anthropic 和 Gemini 的缓存 Token 上报语义，并补齐模型连通性测试产生的系统用量统计。

界面与稳定性​

  • 完善共享目录、文件存储状态和 S3 迁移进度的管理界面与中英文文案。
  • 修复 Session Timeline 对部分历史消息和思考块状态的兼容问题。

升级说明​

升级前请备份配置、数据库、工作区、共享目录和 Connector 状态。首次启用 S3 前请先保存并测试配置，再执行 Provider 迁移；迁移完成前，当前 Provider 保持不变。重新运行现有安装命令即可检查并安装 v0.0.7.beta。

v0.0.6.beta - 2026-08-01​

查看安装方式

文件与附件​

  • 统一会话附件和工作区文件的接收流程；格式、大小和内容解析未通过的文件不会留下不可用记录。
  • 支持 DOCX、可提取文本的 PDF、PPTX、XLSX、CSV、TSV、静态 HTML、Markdown、常见文本与代码文件，以及 PNG、JPEG、WebP 图片。
  • 上传限制由服务端能力按文件类型和入口处理，保存前会给出明确错误；不再依赖前端固定限制或统一大小上限。
  • 小型文本可直接读取；长文档提供页、工作表、幻灯片或区段定位，由任务按需读取，避免一次性占满上下文。
  • Word 和 HTML 尽量保留语义结构；PDF、表格和演示文稿保留页、工作表和幻灯片定位。
  • 修复部分工作区文件显示存在但无法读取，以及中文或空格文件名下载异常的问题。
  • GIF、旧版 Office 文件、加密文档和没有文本层的扫描 PDF 暂不支持上传。

Word 文档与字体​

  • 新增内置 Word 模板库和默认模板，支持基于内置或用户提供模板生成 .docx，并保留模板样式、页眉、页脚和占位符。
  • 文档生成会先完成全文，再创建文件；交付前通过 DOCX 转 PDF 和逐页渲染检查分页、字体、间距、表格和文本裁切。
  • 新增共享字体资源，首批内置 Noto Sans SC、Noto Serif SC 和 Noto Sans Mono CJK SC；管理员可以补充本地字体或登记具备完整性校验的内部在线字体。

子会话、模型与运行环境​

  • 创建子会话时自动完成初始化编排和能力选择，无需额外审批；同时减少重复加载能力、重复执行委派和重复发送结果。
  • 提升连续会话中的模型请求缓存稳定性，完善 OpenAI、Anthropic 和 Gemini 配置兼容性，并加快模型配置变更生效。
  • Python 依赖改为用户级共享安装，内置运行资源保持只读；CLI 输出隐藏宿主机和临时目录，默认启用管道失败检测。

升级与稳定性​

  • 受支持的托管安装可在控制台发现新版本后下载、切换并重启；健康检查失败时自动回滚。
  • 旧版 OpenAI 模型配置会在升级时适配当前类型；单条损坏或无法识别的旧文件不会阻断服务启动。
  • 完善用户数据格式化，清理触发器、会话、附件、工作区及相关运行数据；账号、模型用量和明确保留的外部连接信息不受影响。

升级说明​

升级前建议备份 xAgent 运行目录、配置、数据库和 Connector 状态。重新运行现有安装命令即可检查并安装 v0.0.6.beta；安装器会保留当前配置和状态，并记录当前与上一个二进制版本。具体步骤见开始安装。

v0.0.5.beta - 2026-07-27​

查看安装方式

本版本重点升级控制台体验、Connector 实时交互、任务进程隔离和自动安装流程，并把服务端、Runtime Assets 与三个 IM Connector 纳入统一版本目录。

控制台与会话体验​

  • 统一控制台的品牌、字体密度、页面层级、状态表达和响应式布局。
  • 资源列表统一使用可搜索、可分页的数据表格，详情和编辑流程改为抽屉或对话框，减少页面跳转。
  • 左侧菜单按工作区、操作、个人设置、分析、Agent 治理和系统配置重新组织。
  • 管理员可以为用户开启高级模式；普通模式保留会话、文件、审批、连接和账号等高频入口，高级模式再显示触发器、Agent、Skill、Tool、MCP 和会话诊断能力。
  • Agent 会话重新整理时间线、附件、工具调用、运行状态、会话文件和高级设置，并增强窄屏与移动端布局。

Connector 与浏览器连接​

  • Connector 源码、公共协议和架构文档统一收口到 xAgent 仓库的 connectors/ 与 docs/architecture/connector/。
  • 公共协议升级到 3.0；微信、Telegram 与飞书使用 xagent.im.v2 传输双向最终消息、流式增量、消息确认、活动状态和文件引用。
  • 图片、音频、视频和普通文件通过独立文件传输链路收发，不再把文件正文或 Base64 放入消息 WebSocket。
  • Connector health 连续失败一至两次显示为“不稳定”，第三次起显示为“断开”；恢复成功后可以重新回到在线状态。
  • 微信 Connector 增加按接收人维护的凭据续期和到期提醒，凭据过期后停止无效发送。
  • 浏览器扩展通过内置 Browser Connector 建立受控连接，用于浏览器消息、页面上下文和工具调用。
  • 该版本发布时，独立 Connector 版本为微信 0.0.8、Telegram 0.0.9、飞书 0.0.8；当前版本以连接器管理为准。

ProcessSandbox 与运行环境​

  • 新增统一 ProcessSandbox，所有不受信任命令都通过同一执行边界启动和回收，不继承未声明的宿主环境。
  • Linux 使用 bubblewrap + cgroup v2 + seccomp；macOS 使用 sandbox-exec 和每次执行独立的私有文件视图。
  • 每次执行只挂载明确允许的只读文件、可写目录、输入、输出、Runtime Assets 和临时目录，并限制超时、进程数、内存、CPU 与输出大小。
  • Workspace execution lease 负责串行化重叠写入范围、扫描真实文件差量并提交工作区事实；失败的提交可以在后续恢复。
  • Python、Node.js 和其他 Runtime Assets 独立安装，进入沙箱时只读挂载，不再回退到用户任务可直接使用的宿主运行环境。

自动安装、升级与回滚​

  • Linux 和 macOS 使用同一个稳定安装入口：

    curl -fsSL https://downloads.xagent.xiagaogao.com/scripts/install.sh | bash

  • 安装器自动检测操作系统与 CPU 架构，读取 versions.json，校验平台安装包和内部模块的 SHA256，并在退出时清理临时文件。

  • 已安装版本低于版本目录时自动升级；本地版本更高时不会自动降级。

  • 服务端和 Connector 二进制按版本保留，通过稳定符号链接原子切换；Linux 服务启动失败时恢复到上一个可用版本。

  • Linux 自动执行 xagent setup、生成或更新 systemd 服务并启动；macOS 使用用户级安装目录。

  • 交互安装会先询问是否安装 Connector，再逐个询问微信、Telegram 与飞书；无人值守场景可以使用 --connectors 或 --no-connectors。

升级说明​

该版本发布时，重新运行安装命令即可检查并安装 v0.0.5.beta。当前升级请以 v0.0.10.beta 的升级说明为准。

v0.0.4.beta - 2026-07-15​

使用安装器安装指定版本

本版本重点统一了会话定向、对象引用和审批回复的表达方式，并让用户可以从 Web 或可用 IM 连接器中处理同一张审批单。

快捷指令与统一标识​

  • /command 用于执行系统明确支持的确定性会话命令。
  • @{session:id} 可以把消息或命令定向发送到明确会话。
  • #{type:id} 只表示对象引用，不改变消息路由，也不会隐式执行读取、删除或审批等操作。
  • @{approval:id} 同意/不同意 用于向明确审批提交意见，英文环境可以使用 approve/reject。
  • Web、IM Connector 和 Agent 会话采用同一套目标与引用语义。

详细使用方式请阅读快捷指令协议。

Web 与 IM 审批​

  • 所有新挂起确认都会创建带编号的审批记录。
  • 会话进入审批等待状态后，xAgent 会尝试向该用户全部可用的 IM 消息通道发送审批通知。
  • 通知包含目标会话、审批内容、风险信息和可直接回复的标准指令。
  • 用户可以从 Web、微信或 Telegram 提交意见，系统会把审批编号路由回正确会话。
  • 第一个有效意见生效，后续同号意见不会重复改变审批状态。

连接器管理与 Connector v0.0.4​

  • 用户连接按照 Connector Card 声明的连接模式管理，减少重复或无效连接。

  • Connector 管理页面补充软件版本和认证方式信息。

  • “我的连接”补充连接删除、失效状态和异常连接处理。

  • Connector Release v0.0.4 新增飞书 Connector，并同时提供微信、Telegram 与飞书三种连接器。

  • 同一 Release 提供 12 个 Linux/Darwin、AMD64/ARM64 平台二进制包，以及 SHA256SUMS 校验文件。

  • 飞书 Connector 当前支持国内飞书的单聊消息和群聊 @ 机器人消息，暂不支持 Lark。具体接入与授权方式见连接器使用手册。

  • 该版本的 Connector 当时以统一 v0.0.4 Release 发布；当前版本已经改为三个 Connector 独立版本和独立下载目录。

稳定性修复​

  • 修复审批恢复、会话运行状态和定时调度并发时可能重复推进的问题。
  • 修复无效审批编号返回内部错误、纯定向消息误触发空 Agent 执行等问题。
  • 修复 IM 审批通知、回复路由和多入口重复审批不一致的问题。
  • 会话等待审批时，定时触发不会持续追加重复任务提示。

下载内容​

Release 仅包含：

  • SHA256SUMS
  • Linux AMD64 二进制包
  • Linux ARM64 二进制包
  • macOS AMD64 二进制包
  • macOS ARM64 二进制包

每个压缩包只包含 xAgent 可执行文件、README 和版本元数据，不包含源代码。

当时的升级方式​

v0.0.4.beta 当时需要停机、备份并手工替换二进制。当前安装器已提供自动安装、升级和失败回滚流程，具体步骤请参考开始安装。

v0.0.3.beta​

该版本完善了 Connector 接入、Telegram Connector、使用手册和基础安全治理能力，是 v0.0.4.beta 之前的公开测试版本。

新部署和升级应直接使用当前安装脚本与 v0.0.10.beta 版本目录。

最后于 更新