运行你的第一个 Holon 任务

装好 Holon 之后，从这里开始跑通一个任务。挑一个和你手头事情相符的例子，每个都很短、可以独立运行。如果还没安装，先看快速开始。精确参数和配置见参考。

1. 单次提问

提一个问题，不创建持久 Agent：

holon run "Explain how Rust ownership works in three sentences"

用 --json 获取机器可读输出：

holon run --json "List files in the current directory"

创建一个跨会话保留的命名 Agent：

holon agent create reviewer

从已安装或已同步的模板创建 Agent：

holon agent create reviewer --template code-reviewer

然后与它交互：

holon run --agent reviewer "Review the changes in src/runtime/turn.rs"

修改全局默认模型：

holon config set model.default "deepseek-anthropic@default/deepseek-v4-pro"

设置 Agent 级模型覆盖：

holon agent model set "anthropic@default/claude-sonnet-4-6" reviewer

查看某个 Agent 使用的模型：

holon agent model get reviewer

启动 daemon：

holon daemon start

查看 daemon 状态：

holon daemon status

查看 daemon 日志：

holon daemon logs

停止 daemon：

holon daemon stop

用指定访问模式启动：

holon daemon start --access tunnel

在本地启动交互式终端 UI：

holon tui

通过 TUI 连接远程 daemon：

holon tui --connect http://your-server:8787 --token "your-token"

或从文件读取 token：

holon tui --connect http://your-server:8787 --token-file ~/.holon/remote.token

使用已保存的 token profile：

holon tui --connect http://your-server:8787 --token-profile my-profile

如果终端渲染异常，禁用备用屏幕：

holon tui --no-alt-screen

在 TUI 中输入 / 打开斜杠命令菜单。用 /model 切换模型，用 /agent 管理 Agent，用 /help 查看所有命令。完整的斜杠命令参考见 TUI 指南。

把控制平面暴露为 HTTP API：

holon serve --port 8787

带访问控制：

holon serve --port 8787 --token "your-secret-token"

安全存储 API key（推荐方式）：

holon config credentials set --kind api_key --stdin deepseek
# Paste your API key and press Enter, then Ctrl+D

或使用环境变量：

export DEEPSEEK_API_KEY="sk-..."
holon run "Hello"

验证凭据是否可用：

holon config doctor

查看当前全部配置：

holon config list

查看所有可用配置项及其默认值：

holon config schema

列出已配置的提供商：

holon config providers list

列出可用模型：

holon config models list

限制最大轮次数：

holon run --max-turns 5 "Write a Rust function that reverses a string, with tests"

在指定 workspace 中运行：

holon run --workspace-root /path/to/project "Analyze this codebase"

holon agent create my-builder
holon run --agent my-builder --workspace-root /path/to/project "Build the project"