---
title: 指南
summary: 按你用 Holon 做什么来分组的任务导向指南。
order: 30
---

# 指南

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

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

## 评估和试用 Holon

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

- **[快速示例](/guides/quick-examples)**（英文）— 单次命令、Agent 创建、模型配置、daemon 和 TUI 基础。
- **[本地运行时](/guides/local-runtime)**（英文）— 从源码运行和检查 Holon 的保守工作流。

## 使用图形界面

- **[Web GUI](/guides/web-gui)**（英文）— 内置浏览器界面，用于 Agent 管理、对话、搜索和设置。

## 自动化 GitHub 工作

- **[holon solve](/guides/solve)**（英文）— GitHub issue 和 pull request 的无头自动化，带自动 skill 分发。

## 运维和配置

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

- **[故障排查](/guides/troubleshooting)**（英文）— 按常见遭遇顺序诊断 daemon、模型、配置和 TUI 问题。

## 集成和自动化

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

- **[集成指南](/guides/integration)**（英文）— HTTP 控制平面，含 curl 示例和端点参考。

## 协作和委托

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

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

## 为这些文档做贡献

编辑和构建 Holon 文档网站。

- **[文档工作流](/guides/documentation-workflow)**（英文）— 如何编辑和构建由 mdorigin 驱动的 Holon 网站。

## 本节页面

- [持久 Agent 工作流](/guides/durable-agent-workflow.md)（英文）
  端到端的持久 Agent 故事：创建 Agent、启动长任务、断线存活、等待事件、交付最终简报。

- [holon solve](/guides/solve.md)（英文）
  用 holon solve 以无头模式自动化 GitHub issue 和 pull request。

- [本地运行时](/guides/local-runtime.md)（英文）
  在本地运行和检查 Holon 的保守工作流。

- [TUI 指南](/guides/tui.md)（英文）
  Holon 的交互式终端 UI——导航、斜杠命令、事件日志、模型选择和远程连接。

- [快速示例](/guides/quick-examples.md)（英文）
  完成 Getting Started 后可以尝试的常见 Holon 任务。

- [工作区](/guides/workspaces.md)（英文）
  Workspace 生命周期——attach、exit、detach、worktree 隔离，以及 workspace 与 shell 目录的区别。

- [Agent 模板](/guides/agent-templates.md)（英文）
  Agent 模板是什么、如何同步或安装、如何使用 --template，以及如何创建自定义模板。

- [文档工作流](/guides/documentation-workflow.md)（英文）
  如何编辑和构建由 mdorigin 驱动的 Holon 网站。

- [远程访问](/guides/remote-access.md)（英文）
  远程 daemon 访问——tunnel、tailnet、LAN 模式，token 管理，以及从远程 TUI 连接。

- [集成指南](/guides/integration.md)（英文）
  通过 curl 示例和端点参考以编程方式访问 Holon 的 HTTP 控制平面。

- [Web GUI](/guides/web-gui.md)（英文）
  用 Holon 内置的 Web 界面在浏览器中管理 Agent、监控运行时状态和配置设置。

- [故障排查](/guides/troubleshooting.md)（英文）
  覆盖 daemon、配置、模型和 TUI 问题的常见 Holon 问题解决方案。

- [多 Agent 协作](/guides/multi-agent.md)（英文）
  派生子 Agent、监督契约和用于并行工作的 workspace 模式。

- [Skills 指南](/guides/skills.md)（英文）
  可复用的 SKILL.md 工作流、skill 位置，以及如何开发自定义 skill。

- [WebFetch 和 WebSearch 指南](/guides/webfetch-websearch.md)（英文）
  获取网页和搜索网络的 Agent 工具——工具参考、extract 模式、搜索提供商和使用模式。

- [工作项指南](/guides/work-items.md)（英文）
  用工作项、计划、todo 清单和生命周期管理进行持久目标跟踪。

- [ViewImage 指南](/guides/view-image.md)（英文）
  通过视觉模型检查本地图片的 Agent 工具——模型选择、视觉观察、持久元数据和缓存。

- [图像生成指南](/guides/image-generation.md)（英文）
  从文本提示生成图像的 Agent 工具——模型选择、尺寸和格式选项、输出管理和缓存。

<!-- INDEX:START -->

<!-- INDEX:END -->
