# 常见工作流

这篇文档按任务场景组织，回答"我想做 XX，应该怎么操作"的问题。

## 这篇文档解决什么问题

以任务为线索的快速操作指南，适合熟悉界面后查找具体步骤。

## 前置条件

- Coder Studio 已安装并启动
- 已配置至少一个 Provider（Claude 或 Codex）

## 打开一个本地项目并开始工作

1. 启动服务：`coder-studio open`
2. 浏览器中点击"打开工作区"
3. 在目录选择器中找到你的项目目录并确认
4. 项目加载后，点击"创建会话"选择 Provider
5. Agent 会话启动后，你就可以通过终端输入指令开始协作

## 启动一个新的 Agent 会话

- **桌面端**：在 Agent 面板中点击创建会话，选择 Provider
- **移动端**：点击底部 Dock 的 Agent，然后点击创建会话

每个会话是独立的，可以在同一工作区内并行运行多个会话。

## 在 Agent 运行时查看文件和终端

Agent 工作期间，你可以：

- 通过左侧文件树查看被修改的文件
- 通过底部终端面板中的 Agent 终端观察 Agent 输出
- 同时创建 Shell 终端来独立验证 Agent 的成果

## 查看 Git 变更

1. 在左侧面板切换到 Git 标签
2. 查看当前分支名称和变更列表
3. 点击某个文件可以查看差异内容
4. 差异视图支持在中央区域查看具体变更

## 修改 Provider 启动参数

1. 点击顶栏的设置按钮
2. 进入 Providers 页面
3. 选择对应的 Provider
4. 在文本框中添加每行一个额外参数
5. 通过 Command Preview 确认最终命令

## 在桌面端和移动端之间切换使用

Coder Studio 的服务运行在本机上，通过同一个 IP 和端口访问：

- 桌面端：打开 `http://localhost:<端口>`
- 移动端：打开 `http://<本机IP>:<端口>`（需要设备在同一网络）

服务无需切换，界面会自动适配。

## 结束工作前建议检查什么

- 检查 Agent 是否处于空闲状态（避免意外中断）
- 检查是否有未保存的文件更改
- 检查 Git 变更列表，必要时进行提交
- 如果不再需要该工作区，点击顶栏标签上的 X 关闭
