指南

指南按用户任务组织——找到你的目标，顺着路径走。

本节除本页外暂为英文，链接会跳转到对应英文页面。中文翻译在逐步补充中。

评估和试用 Holon

想用最少的配置看看 Holon 能做什么，从这里开始。

• 快速示例（英文）— 单次命令、Agent 创建、模型配置、daemon 和 TUI 基础。
• 本地运行时（英文）— 从源码运行和检查 Holon 的保守工作流。

使用图形界面

• Web GUI（英文）— 内置浏览器界面，用于 Agent 管理、对话、搜索和设置。

自动化 GitHub 工作

• holon solve（英文）— GitHub issue 和 pull request 的无头自动化，带自动 skill 分发。

运维和配置

让长期运行的 Holon 实例保持健康和配置正确。

• 故障排查（英文）— 按常见遭遇顺序诊断 daemon、模型、配置和 TUI 问题。

集成和自动化

通过控制平面把 Holon 接入外部系统。

• 集成指南（英文）— HTTP 控制平面，含 curl 示例和端点参考。

协作和委托

与多个 Agent、持久目标和可复用 skills 协作。

• 多 Agent 协作（英文）— 派生子 Agent、监督契约和 workspace 模式。
• 工作项指南（英文）— 用计划、todo 清单和生命周期管理跟踪持久目标。
• 持久 Agent 工作流（英文）— 端到端的持久 Agent 故事：WorkItem、wait/wake/resume 和最终简报。
• Skills 指南（英文）— 可复用的 SKILL.md 工作流、skill 位置和自定义 skill 开发。

为这些文档做贡献

编辑和构建 Holon 文档网站。

• 文档工作流（英文）— 如何编辑和构建由 mdorigin 驱动的 Holon 网站。

本节页面

• 持久 Agent 工作流（英文） 端到端的持久 Agent 故事：创建 Agent、启动长任务、断线存活、等待事件、交付最终简报。

• holon solve（英文） 用 holon solve 以无头模式自动化 GitHub issue 和 pull request。

• 本地运行时（英文） 在本地运行和检查 Holon 的保守工作流。

• TUI 指南（英文） Holon 的交互式终端 UI——导航、斜杠命令、事件日志、模型选择和远程连接。

• 快速示例（英文） 完成 Getting Started 后可以尝试的常见 Holon 任务。

• 工作区（英文） Workspace 生命周期——attach、exit、detach、worktree 隔离，以及 workspace 与 shell 目录的区别。

• Agent 模板（英文） Agent 模板是什么、如何同步或安装、如何使用 --template，以及如何创建自定义模板。

• 文档工作流（英文） 如何编辑和构建由 mdorigin 驱动的 Holon 网站。

• 远程访问（英文） 远程 daemon 访问——tunnel、tailnet、LAN 模式，token 管理，以及从远程 TUI 连接。

• 集成指南（英文） 通过 curl 示例和端点参考以编程方式访问 Holon 的 HTTP 控制平面。

• Web GUI（英文） 用 Holon 内置的 Web 界面在浏览器中管理 Agent、监控运行时状态和配置设置。

• 故障排查（英文） 覆盖 daemon、配置、模型和 TUI 问题的常见 Holon 问题解决方案。

• 多 Agent 协作（英文） 派生子 Agent、监督契约和用于并行工作的 workspace 模式。

• Skills 指南（英文） 可复用的 SKILL.md 工作流、skill 位置，以及如何开发自定义 skill。

• WebFetch 和 WebSearch 指南（英文） 获取网页和搜索网络的 Agent 工具——工具参考、extract 模式、搜索提供商和使用模式。

• 工作项指南（英文） 用工作项、计划、todo 清单和生命周期管理进行持久目标跟踪。

• ViewImage 指南（英文） 通过视觉模型检查本地图片的 Agent 工具——模型选择、视觉观察、持久元数据和缓存。

• 图像生成指南（英文） 从文本提示生成图像的 Agent 工具——模型选择、尺寸和格式选项、输出管理和缓存。