# Zerone Docs

> Zerone App、Agent Hub、Agent Runtime 和 Agent SDK 的统一文档

## 首页

### 认识 Zerone

- [产品概览](https://docs.zerone.run/zh/index.md): 使用 Zerone App 完成日常任务，或通过 Agent Hub、Runtime、SDK 构建和管理 Agent。
- [如何选择](https://docs.zerone.run/zh/guides/choosing.md): 按使用方式选择桌面助手、管理平台、服务接口或 SDK。
- [产品如何配合](https://docs.zerone.run/zh/guides/overview.md): 理解使用入口、控制平面和执行层之间的边界。

### 开始使用

- [使用桌面助手](https://docs.zerone.run/zh/guides/desktop.md): 从一个有明确输入和结果的任务开始使用。
- [搭建团队平台](https://docs.zerone.run/zh/guides/team-platform.md): 从一个 Agent 的配置和验证开始，逐步准备团队使用。
- [集成到应用](https://docs.zerone.run/zh/guides/integration.md): 按调用边界选择 Runtime 或 SDK，并验证一次完整执行。

### 应用场景

- [文档处理](https://docs.zerone.run/zh/guides/documents.md): 从原始资料生成有依据、可复核的整理结果。
- [数据分析](https://docs.zerone.run/zh/guides/data-analysis.md): 先确认口径，再整理表格和解释变化。
- [内容创作](https://docs.zerone.run/zh/guides/content-creation.md): 从素材和表达目标出发，逐步完成草稿。
- [远程办公](https://docs.zerone.run/zh/guides/remote-work.md): 通过消息渠道向电脑上的 Agent 发起任务。
- [定时自动化](https://docs.zerone.run/zh/guides/automation.md): 把已经验证的重复任务转成可检查的定时执行。

## Zerone App

### 开始

- [产品介绍](https://docs.zerone.run/zh/app/introduction.md): 认识桌面 Agent、主要界面和第一次对话。
- [快速开始](https://docs.zerone.run/zh/app/quickstart.md): 下载安装、连接模型服务商并开始第一次对话。
- [安装](https://docs.zerone.run/zh/app/installation.md): 选择 macOS 或 Windows 安装包，安装并检查更新。

### 使用指南

- [对话](https://docs.zerone.run/zh/app/chat.md): 发送请求、附加文件、选择权限并回退对话。
- [智能体](https://docs.zerone.run/zh/app/agents.md): 选择业务专家、开始对话并配置所需能力。
- [工作区](https://docs.zerone.run/zh/app/workspaces.md): 指定工作目录，浏览、预览和编辑任务文件。
- [模型](https://docs.zerone.run/zh/app/models.md): 为对话选择模型、切换服务商并设置默认模型。

### 扩展能力

- [Skills](https://docs.zerone.run/zh/app/skills.md): 安装、管理和使用符合 Agent Skills 标准的技能。
- [MCP](https://docs.zerone.run/zh/app/mcp.md): 添加 MCP 服务器，让 Agent 使用外部工具。
- [CLI Tools](https://docs.zerone.run/zh/app/cli-tools.md): 检测命令行工具、查看安装方式并在对话中使用。
- [飞书 CLI](https://docs.zerone.run/zh/app/lark-cli.md): 安装并授权飞书 CLI，让 Agent 处理云文档和表格。

### 自动化

- [定时任务](https://docs.zerone.run/zh/app/scheduled-tasks.md): 创建单次、重复或间隔任务，管理执行状态和历史。
- [消息渠道（Beta）](https://docs.zerone.run/zh/app/channels.md): 通过 Telegram、飞书、Discord、QQ 或微信与桌面 Agent 对话。
- [飞书接入](https://docs.zerone.run/zh/app/feishu.md): 配置飞书或 Lark 机器人，在聊天中向桌面 Agent 发送任务。

### 深入了解

- [核心能力](https://docs.zerone.run/zh/app/capabilities.md): 了解本地工作区、远程协作、记忆和技能扩展。
- [应用场景](https://docs.zerone.run/zh/app/use-cases.md): 从办公、创作和开发任务中选择适合自己的使用方式。
- [版本更新](https://docs.zerone.run/zh/app/changelog.md): 查看从 V1.0.1 到 V2.1.0 的功能更新和修复记录。

## Agent Hub

### 开始

- [产品介绍](https://docs.zerone.run/zh/hub/introduction.md): 了解 Agent Hub 如何统一配置、部署和治理 Agent。
- [快速开始](https://docs.zerone.run/zh/hub/quickstart.md): 使用 Docker Compose 在本地启动 Agent Hub。

### 核心能力

- [管理 Agent](https://docs.zerone.run/zh/hub/agents.md): 理解 Agent 定义、关联资源和部署边界。
- [Tools](https://docs.zerone.run/zh/hub/tools.md): 注册 Agent 可调用的执行能力并配置授权。
- [Skills](https://docs.zerone.run/zh/hub/skills.md): 管理可复用能力包并绑定到 Agent。
- [Provider 配置](https://docs.zerone.run/zh/hub/providers.md): 集中配置模型供应商、端点和凭据。

### 运维

- [部署](https://docs.zerone.run/zh/hub/deployment.md): 了解 Agent Hub 的生产部署组件和上线检查。
- [配置](https://docs.zerone.run/zh/hub/configuration.md): Agent Hub 核心环境变量与认证模式参考。
- [安全](https://docs.zerone.run/zh/hub/security.md): 保护 Agent Hub 凭据、角色与运行接口。

### 深入了解

- [数据模型](https://docs.zerone.run/zh/hub/data-model.md): 理解 Agent、能力资源、租户和会话之间的关系。
- [API Reference](https://docs.zerone.run/zh/hub/api-reference.md): Agent Hub 管理、认证与聊天接口的入口说明。
- [本地开发](https://docs.zerone.run/zh/hub/development.md): 准备 Agent Hub 前后端开发环境并运行检查。

## Runtime

### 开始

- [产品介绍](https://docs.zerone.run/zh/runtime/introduction.md): 了解 Agent Runtime 如何把 Agent 定义转换为 HTTP 与 SSE 服务。
- [快速开始](https://docs.zerone.run/zh/runtime/quickstart.md): 创建 agents.yaml 并启动本地 Runtime。

### 运行指南

- [配置](https://docs.zerone.run/zh/runtime/configuration.md): 使用 YAML、TypeScript 和环境变量配置 Runtime。
- [响应模式](https://docs.zerone.run/zh/runtime/runs.md): 通过 Accept 头选择 Runtime 的 SSE 或 JSON 响应模式。
- [Session](https://docs.zerone.run/zh/runtime/sessions.md): 使用 Runtime Session 保持多轮 Agent 上下文。
- [Run 生命周期](https://docs.zerone.run/zh/runtime/run-lifecycle.md): 识别 runId、取消执行并处理断连与终态。

### HTTP API

- [Runs API](https://docs.zerone.run/zh/runtime/endpoints/runs.md): Runtime Agent 执行与取消接口参考。
- [Agent API](https://docs.zerone.run/zh/runtime/endpoints/agents.md): 列出 Runtime Agent 并读取可用能力。
- [Files API](https://docs.zerone.run/zh/runtime/endpoints/files.md): 安全列出和读取 Runtime 工作目录中的文件。

### 集成

- [SDK 集成](https://docs.zerone.run/zh/runtime/sdk-integration.md): 理解 Runtime 如何使用 SDK 定义和执行 Agent。

### 深入了解

- [API Reference](https://docs.zerone.run/zh/runtime/api-reference.md): Agent Runtime HTTP 接口总览。
- [AIGC 合规说明](https://docs.zerone.run/zh/runtime/compliance.md): 配置 Runtime 的生成式人工智能内容标识与审计记录。

## SDK

### 开始

- [产品介绍](https://docs.zerone.run/zh/sdk/introduction.md): 了解 Zerone 的 TypeScript Agent SDK 与核心抽象。
- [快速开始](https://docs.zerone.run/zh/sdk/quickstart.md): 安装 SDK 并运行第一个 TypeScript Agent。

### 核心概念

- [Agent](https://docs.zerone.run/zh/sdk/agents.md): 选择可复用 Agent、流式 Query 和阻塞 Prompt。
- [Query](https://docs.zerone.run/zh/sdk/query.md): 选择流式 query() 或阻塞 prompt() 执行请求。
- [Model](https://docs.zerone.run/zh/sdk/providers.md): 配置 Anthropic、OpenAI-compatible 或自定义模型服务。
- [Tools](https://docs.zerone.run/zh/sdk/tools.md): 使用内建 Tool 并通过 Zod 定义自定义能力。
- [Skills](https://docs.zerone.run/zh/sdk/skills.md): 了解 Agent Skills 标准，以及 SDK 的加载、注册和能力配置。
- [Subagent](https://docs.zerone.run/zh/sdk/subagents.md): 委派任务并显式隔离子 Agent 的能力。
- [Sessions](https://docs.zerone.run/zh/sdk/sessions.md): 持久化、恢复、分叉和压缩 Agent 会话。

### 使用指南

- [流式响应](https://docs.zerone.run/zh/sdk/streaming.md): 消费 agent.query() 的异步事件流并处理中断。
- [示例](https://docs.zerone.run/zh/sdk/examples.md): 按任务选择 Agent SDK 示例并在本地运行。

### Reference

- [API Reference](https://docs.zerone.run/zh/sdk/api-reference.md): Agent SDK 顶层函数、Agent 方法、配置选项与环境变量参考。
- [架构](https://docs.zerone.run/zh/sdk/architecture.md): 理解 Agent、QueryEngine、Provider 与 Tool 执行链。

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [English (65 pages)](https://docs.zerone.run/_llms/en.md): Documentation for English.