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

# 概览

> 了解 workspace repository 和本地 workspace directory

## 什么是 Workspace？

Osmosis workspace 是团队在平台上管理数据集、训练任务、模型、deployments、成员和一个已连接 GitHub 仓库的空间。

已连接的 GitHub 仓库就是 **workspace repository**。您的本地 clone 是 **workspace directory**。

| Term                     | Meaning                         |
| ------------------------ | ------------------------------- |
| **Platform workspace**   | Osmosis Platform 中的团队空间。        |
| **Workspace repository** | 连接到该平台 workspace 的 GitHub 仓库。   |
| **Workspace directory**  | workspace repository 的本地 clone。 |

## 开始使用

从 [Onboarding](/zh/platform/onboarding) 开始，创建或加入平台 workspace、连接 GitHub、clone workspace repository，并认证 CLI。

Onboarding 完成后，您的本地 workspace directory 会包含标准 workspace 结构：

```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
repository/
├── rollouts/            # AgentWorkflow + Grader code
├── configs/             # Training and evaluation configs
├── data/                # Local test datasets
├── pyproject.toml       # Python project config
├── AGENTS.md            # AI coding assistant instructions
├── CLAUDE.md            # Claude Code instructions
└── .gitignore
```

详细拆解请参见 [Structure & Configuration](/zh/cli/workspace/structure-and-config)。

## CLI Context

CLI 会将平台命令限定到您当前所在的 workspace repository。它读取 Git `origin`，解析 GitHub `owner/repo`，并将该仓库身份发送到平台。

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
git remote get-url origin
osmosis dataset list
```

如果 CLI 无法解析 workspace，请运行：

```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
osmosis doctor
```

## 典型本地循环

<Steps>
  <Step title="编辑或创建 rollout scaffold">
    ```cli theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
    osmosis rollout init <name>
    ```
  </Step>

  <Step title="Push 并同步">
    ```bash theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
    git add .
    git commit -m "add rollout"
    git push
    ```
  </Step>

  <Step title="提交 evaluation run">
    ```cli theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
    osmosis eval submit configs/eval/<name>.toml
    ```
  </Step>

  <Step title="提交训练">
    ```cli theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/cli.json"]}}
    osmosis train submit configs/training/<name>.toml
    ```
  </Step>
</Steps>

## 下一步

<CardGroup cols={2}>
  <Card title="Workspace Repository" icon="code-branch" href="/zh/cli/workspace/repository">
    了解 GitHub `origin` 如何将 CLI 命令限定到平台 workspace。
  </Card>

  <Card title="Structure & Configuration" icon="folder-tree" href="/zh/cli/workspace/structure-and-config">
    了解已 clone workspace repository 中的文件。
  </Card>

  <Card title="Git Sync" icon="rotate" href="/zh/cli/workspace/git-sync">
    Push 到 GitHub，并让平台自动同步 rollout 代码。
  </Card>
</CardGroup>