> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dureai.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 第一个代理

> 从平时使用的终端启动 agent，再决定何时需要 managed-session 保证。

## 要求

* Apple Silicon Mac
* 至少一个已经安装并登录的受支持编程代理 CLI
* 一个用于 worktree 代理的 Git 仓库

如尚未安装，请先阅读[安装 Dure](/cn/install)。

<Warning>
  Dure 目前仍是 alpha 软件。当前公开构建未签名；在产品名称迁移到 Dure
  的过程中，已发布的 artifact 仍保留旧的 `Hebbian` 应用 identity。
</Warning>

## 首次启动：从近期工作开始

Dure 可以发现这台 Mac 以及符合条件的 SSH 主机上的近期 provider 原生会话，
并按仓库生成桌面与面板布局草案。你可以先查看只读提案，重命名或合并桌面、
移动面板，确认布局正确后再应用。

<video autoPlay controls loop muted playsInline title="从近期本地与 SSH 编程代理会话开始的 Dure 入门流程" className="w-full aspect-video rounded-xl" poster="/images/onboarding-walkthrough.png" src="https://mintcdn.com/hebbian/gBhXllKfo-gr_XE_/videos/onboarding-walkthrough.webm?fit=max&auto=format&n=gBhXllKfo-gr_XE_&q=85&s=ce727f944da53a954302b32161ff2e56" data-path="videos/onboarding-walkthrough.webm">
  浏览器不支持内嵌视频。
  <a href="/videos/onboarding-walkthrough.webm">打开入门演示视频。</a>
</video>

## 1. 下载与安装

从[公开发布页](https://github.com/hebbianai/hebbian-releases/releases/latest)
下载最新 disk image，将应用移动到 `/Applications`，然后执行一次：

```sh theme={"system"}
xattr -dr com.apple.quarantine /Applications/Hebbian.app
```

旧的安装路径用于保持 updater 与本地状态兼容。请不要手动重命名 app bundle。

## 2. 准备代理 CLI

先在 Dure 之外安装并登录 provider CLI。例如，在 login shell 中确认
`claude`、`codex` 或其他受支持 command 可以正常启动。

Dure 从同一 login-shell 环境中检测已安装的 provider。它不会代替你安装
provider CLI，也不包含其订阅服务。

## 3. 添加项目

打开 Dure，添加包含 Git 仓库的本地文件夹。项目会出现在 Spaces 中，并成为
新 agent pane 的工作范围。

## 4. 像平时一样从终端启动

在项目中打开普通 terminal pane，照常运行 `claude`、`codex` 或其他受支持的
provider command。Dure 会检查实时 process tree 与 terminal 证据，自动识别
provider 及其活动，并显示在 Spaces 中。无需先添加或手动注册代理。

## 5. 需要时再转为托管代理

需要 worktree 隔离和会话存活保证时，使用添加代理操作，选择 provider，设置
一个可区分的名称，并保持 worktree 隔离开启。对于已经审查的 provider 和状态，
也可以使用已识别 terminal pane 上显示的托管转换操作。Dure 会创建或复用：

```text theme={"system"}
repo/.worktrees/<agent-name>
agent/<agent-name>
```

托管 pane 从该 worktree 启动。不同代理不会共享 Git index 或工作文件。

## 6. 验证会话保证

发送一个 prompt，等待输出，然后关闭并重新打开 Dure。托管的本地代理应重新
连接到同一个运行中会话和画面，而不是启动新的 provider process。

<Tip>
  自动识别本身不保证 worktree 隔离或托管会话存活。必须保持运行的任务应先
  转为托管会话，或从 agent pane 中启动。
</Tip>

## 下一步

* [会话、snapshot 与恢复的区别](/cn/session-model)
* [协调多个代理](/cn/orchestration)
* [Provider 支持级别](/cn/providers)
* [持久性与平台的当前限制](/cn/current-limits)