更新日志¶
1.2.1¶
Web 服务与前端¶
- 新增智能体运行状态事件，前端可准确展示智能体开始与结束运行的状态。
- 修复活动预览在更新时闪烁的问题；窄屏下改用工作状态图标，减少界面占用。
- 页脚新增彩色光谱线。
1.2.0¶
扩展系统¶
- 扩展状态与显示事件：
/extensions呈现加载状态，初始化异常可抛出并清晰展示，不再只是静默告警。 - 版本兼容门槛：
@extension_attr声明支持的版本区间，区间外的扩展标记为skipped且不加载； - 新增
xun_version()查询当前版本。
核心与钩子¶
- 执行钩子可接管执行：设置
takeover_result后由钩子处理器直接返回结果，跳过执行步骤且不写入会话历史。 - 新增
html信息事件，Web 端按富文本渲染。 - 工具返回图片时自动检测尺寸，过大自动缩放；URL 图片先下载后上传。
request_image新增crop参数。- 工具调用参数统一容忍 list 传成字符串的情况。
- 默认最大迭代次数 256 → 512。
Web 服务与前端¶
- 会话支持重命名。
- 事件流重构：消息独立于回合展示、折叠优化、单智能体自动展开、运行中摘要卡片与活动预览。
- 静态托管允许直接服务工作目录根。
- 斜杠命令缓存随会话更新。
1.1.1¶
容器与多用户¶
- 修复
xunc <目录>挂载后工作区不符的问题。 - 新增
xunx pause <user>/xunx resume <user>：暂停或恢复某个用户的容器而不丢弃其状态。 - 修复令牌以
-开头时被xuns当作选项解析的问题，容器启动改用--token=<token>传参。
Web 服务与前端¶
- 优化ws消息发送：消息与命令带上
client_id，收到服务端accepted回执后才清空输入框与附件；重连后自动重发，服务端按client_id去重以避免重复执行。 - 文件信息中的体积改为按量级展示（B / KiB / MiB ...）。
xuns支持--no-initial-agent，在不配置 LLM 的情况下浏览文档。
扩展系统¶
- 启动时不再打印
Loaded extensions:提示。
1.1.0¶
扩展系统（新增）¶
$XUN_HOME/extensions/下的源文件在每个智能体初始化时自动加载，支持包形式{name}/setup_extension.py与扁平形式{name}.py；入口setup_extension(ctx)。- 导入或初始化失败只告警，不阻断启动；配置项
enable_extensions可关闭。 - 新增显示层钩子
before_display_info/before_display_warning/before_display_error，可拦截智能体输出；新增/extensions命令与仓库内示例。
核心与工具¶
- 会话压缩分级：先回收旧工具结果，仍超标才转摘要压缩，摘要后仍超标可继续再压；摘要正文不再混入 info 消息。
- 取消事件改为链式结构，父智能体取消级联到子智能体；Web 端等待输入时同样响应取消。
- 生命周期状态独立为
agent_state.py；显示方法抽为AgentDisplayMixin并纳入类型状态约束。 - 子智能体 getter 参数改为 dataclass
AgentGetterParam。 shell工具更名为bash；copy覆盖已存在目标需要确认。get_choice/get_confirm返回ChoiceOutcome（选择值 + 来源）；自动确认不再写入命令与路径允许列表。- 修复工具调用参数被 JSON 修复后与历史不同步的问题。
配置与提示词¶
auto_confirm支持环境变量XUN_AUTO_CONFIRM。- 系统提示词要求先查看并遵循工作目录下的
AGENTS.md。
Web 服务与前端¶
- 文件浏览：PDF 与全屏预览、文本预览语法高亮、行内编辑；列表与信息分列，扫描更快；窄屏下面板互斥。
- 上传支持整个目录，结果通知列出全部文件并自动消失。
- 新增静态目录托管
/srv/，可直接访问工作目录里的站点（默认 1 小时过期）。 - 事件列表加载与传输优化；输入内容跨会话保持；界面文案中/英双语。
容器与多用户¶
- 容器启动时把宿主 xun home 复制进
/.xun（只取config.json与extensions）。 xunc --env/xunx serve --env支持NAME=VALUE赋值与通配转发宿主变量。xunx容器持久化：serve重启后重新接管已有容器并保留会话，已删除用户的容器在对账时清理。- 新增
xunx upgrade，由运行中的serve在下一次对账时重建容器。
文档¶
- 新增中英双语文档（MkDocs），Web 服务在
/docs提供无需登录的访问。
1.0 — 2026-09-15¶
首个正式版本：执行循环与结构化输出、函数即工具与 8 组内置工具、显示层（控制台 / Web / 空）与 Web 前端、子智能体生成与会话压缩、会话命令与策略确认、xun / xuns / xunc 三种入口与 xunx 多用户复用服务。