Harness UI
在终端和浏览器中与 Agent 一起处理真实项目的工作台。
Harness UI 是面向个人和可信小团队的 Harness 交互式试验工作台。你可以一边处理真实项目，一边尝试不同的模型、指令、工具、Skill 和执行环境。让 Agent 解释代码库、修改文件、运行检查，或将范围明确的调查交给 subagent。
TUI 是终端中的交互界面，提供个人 Agent 编程工作流。WebUI 是浏览器中的界面，还支持共享对话和草稿、文件、Git 变更、终端和配置编辑。两者使用同一个 Harness UI 应用和 Harness，无须编写 SDK 代码或部署 Service。
安装并启动
使用 uv 安装 a13n-harness-ui 命令：
uv tool install a13n-harness-ui
cd your-repository
a13n-harness-ui要启动 WebUI，运行：
a13n-harness-ui webui在浏览器中打开服务器打印的登录链接。WebUI 内提供设置向导；协作、身份验证、宿主机原生访问和服务器生命周期见 WebUI。
TUI 支持 macOS、Linux 和 Windows。安装后的应用不需要 Node.js 或仓库检出目录。如果 PATH 中找不到命令，运行 uv tool update-shell，然后打开新终端。
首次启动时，设置向导会带你完成：
- 连接 Model： 使用支持的订阅登录或 API 密钥，也可以复用现有的兼容账户存储。
- 选择模型设置： 选择提供的模型，以及适用的服务层级。推理和上下文设置可以稍后调整。
- 选择执行权限： Full Control 使用你的宿主机账户；Sandbox 要求本地隔离正常可用，不会静默降级。
- 打开输入框： 设置向导保存可编辑的文件，然后打开 TUI 输入框。在你发送提示之前，不会发出模型请求。
先试一条范围明确的提示：
Explain this repository's main entry point and tests. Do not modify any files.Full Control 使用宿主机账户的文件系统和网络权限运行命令，并非沙箱。Sandbox 要求受支持的 Linux/macOS 隔离机制；Windows 内置执行仅支持 Full Control。见执行权限。
安装与升级介绍源码开发和依赖更新；设置介绍登录、取消和高级选项。
配置在哪里？
在 shell 中运行：
a13n-harness-ui config path
a13n-harness-ui config show --format json
a13n-harness-ui config validate也可以在 TUI 中输入 /config。默认根配置文件是 ~/.a13n-harness-ui/a13n-harness-ui.yaml。Model 和 Agent 资源位于同级目录中，而不是写在该文件内：
| 要修改的内容 | 文件或操作 |
|---|---|
| 默认 Agent、显示、内置工具 | a13n-harness-ui.yaml，见根配置参考 |
| 模型、端点、凭据、推理、上下文 | models/*.yaml，见Model 参考 |
| 指令、工具、MCP 选择、子级 | agents/*.yaml，见Agent 参考 |
| 全局编程指导 | 根 YAML 旁的 AGENTS.md |
| Project 专用指导 | 工作目录中的 AGENTS.md |
| 额外 Project 目录（根目录） | projects/*.yaml，见Project 参考 |
需要可直接复制的修改示例时，从常见配置用法开始；要了解所有根字段和优先级，阅读配置指南。--config PATH 选择另一棵配置树，不会将其与默认配置树合并。
TUI 操作
| 操作 | TUI 中的操作 |
|---|---|
| 查看可用命令 | /help |
| 切换 Agent | /agent |
| 选择并记住每个 Project 的 Model | /model |
| 修改推理或优先服务 | /thinking、/fast |
| 修改执行权限 | /environment |
| 查看当前配置和用量 | /status |
| 浏览已保存的对话 | /resume |
| 引导正在执行的工作 | 输入消息并按 Enter |
| 取消执行 | Ctrl+C 或 /cancel |
附件、审批、提问、历史和恢复见使用 TUI。在 TUI 之外运行 a13n-harness-ui add model 或 a13n-harness-ui add agent，可以添加可复用资源。
进一步使用
- 自定义：Agent 与 subagent、模型与身份验证。
- 连接工具：MCP 与扩展、原生工具与 Web 提供方。
- 跨目录工作：环境与 Project。
- 自动化 Run 或排查故障：自动化与故障排查。
- 构建其他界面：嵌入 Python App或使用 HTTP API。
共享与执行边界
WebUI 实例只应与可信协作者共享：大家共用凭据、配置和可访问文件，没有分别设置的参与者权限。宿主机原生文件访问和终端默认开启；--no-share-computer 可以关闭它们，且与 Agent 的执行模式相互独立。
关闭浏览器不会停止正在运行的 Run；停止应用才会。已保存的对话可以从最后一个检查点恢复，但该检查点之后的输入或输出可能丢失。需要受管理的身份和可恢复的 Run 时，使用 Service。