安装与升级

安装 Harness UI复制章节链接

使用 uv 将 Harness UI 安装到独立的工具环境：

uv tool install a13n-harness-ui
cd your-repository
a13n-harness-ui

不需要源码检出目录或 Node.js。如果 shell 找不到命令，运行 uv tool update-shell，然后重新启动 shell。

可选的 Bash/Zsh 快捷方式：在 shell 配置文件中加入 alias anui='a13n-harness-ui'。

升级复制章节链接

通过 uv tool 安装时，运行 a13n-harness-ui update 或 uv tool upgrade a13n-harness-ui，然后重启 Harness UI。a13n-harness-ui update 要求 PATH 中有 uv，且不会再次询问。其他安装方式请使用原来的包管理器。

启动时可以检查更新，但未经确认不会安装。使用 --no-update-check 可在本次启动时关闭检查，在 a13n-harness-ui.yaml 中设置 process.terminal_update_check: false 可永久关闭。见更新与故障行为。

依赖兼容性复制章节链接

整体升级 Harness UI；uv 会解析兼容的 Harness、Stream Protocol、Envd Client 和日志依赖。解析失败时，检查自行设置的版本约束。

沙箱运行时复制章节链接

Full Control 不需要下载 Envd。Sandbox 会在需要时获取与已安装 a13n-envd-client 版本匹配的守护进程，升级后也是如此。版本为 0.0.0 的源码构建使用 Sandbox 时，需要显式指定经过验证的 a13n-envd 可执行文件。见 Envd 安装。

从源码运行复制章节链接

使用仓库锁定的环境，不要将本地代码与手动安装的依赖混用：

git clone https://github.com/converge-ai-labs/agent-foundation.git
cd agent-foundation
make a13n-harness-ui

Make 目标会同步依赖、更新内置配置 Skill，并关闭启动更新检查。切换分支后重新运行。修改文档后只需更新 Skill 时，运行 make a13n-harness-ui-skills。开发前置条件见 CONTRIBUTING.md。

源码文档跟随 main。使用已发布的 wheel 时，如果 API 或设置不同，应查阅对应发行版的文档和元数据。

WebUI复制章节链接

安装包同时包含 TUI 和 WebUI。启动 WebUI：

a13n-harness-ui webui

打开打印的登录链接，并保持前台服务器运行。配置 Model、开始对话，与可信协作者一起工作。宿主机原生文件和终端共享默认开启；使用 --no-share-computer 可以关闭。访问和部署见 WebUI。

下一步复制章节链接

完成设置，然后找到你的配置。