Workspace Git Foundation - 用户指南

什么是 Workspace？

Workspace（工作空间）是 Refresh Agents 中的隔离 Git 环境，让你可以同时处理多个功能而不会冲突。每个 workspace 都有自己的：

• 独立的 Git 分支 - 你的功能分支与 main 隔离
• 独立的 worktree - 物理目录隔离
• 独立的状态 - 分支状态、PR 跟踪、冲突管理
• 自动恢复 - 如果 workspace 丢失会自动恢复

为什么使用 Workspace？

传统 Git 工作流的问题

# 问题：切换分支会丢失未提交的工作
git checkout main
# 错误：你的本地修改会被覆盖

# 问题：stash 很繁琐
git stash
git checkout main
# ... 做一些事情
git checkout feature-branch
git stash pop

Workspace 解决方案

# ✅ 每个 workspace 都是独立的
Workspace A: feature/authentication (未提交的修改被保留)
Workspace B: feature/dashboard (并行工作)
Workspace C: bugfix/login-error (热修复，无需切换上下文)

快速开始

步骤 1：创建新对话

1. 打开 Refresh Agents
2. 点击侧边栏的 "新建对话"
3. 选择你的项目文件夹

步骤 2：Workspace 自动创建

当你创建对话时，Refresh 会自动：

1. ✅ 创建 workspace 记录
2. ✅ 生成唯一的分支名（例如：feature/chat-abc123）
3. ✅ 在 .worktrees/ 目录创建 Git worktree
4. ✅ 设置目标分支（默认：main）

步骤 3：开始编码

你的 workspace 已就绪！现在你可以：

• ✅ 修改代码而不影响其他 workspace
• ✅ 独立提交和推送
• ✅ 创建 Pull Request
• ✅ 在隔离环境中解决冲突

Workspace 状态栏

在对话顶部，你会看到 workspace 状态：

┌─────────────────────────────────────────────────┐
│ 🌿 feature/chat-abc123  │  ↑2 ↓1 ●3  │  PR #42 │
└─────────────────────────────────────────────────┘

• 🌿 分支名 - 你当前的功能分支
• ↑2 - 领先目标分支 2 个提交
• ↓1 - 落后目标分支 1 个提交
• ●3 - 3 个未提交的修改
• PR #42 - 关联的 Pull Request

核心功能

自动推荐

Workspace 会自动推荐下一步操作：

• 有未提交的修改？ → "提交修改"
• 领先远程分支？ → "推送到远程"
• 落后目标分支？ → "同步远程"
• 准备创建 PR？ → "创建 Pull Request"

多仓库支持

一个 workspace 可以包含多个仓库：

Workspace A
├─ 仓库: frontend (feature/new-ui)
├─ 仓库: backend (feature/new-api)
└─ 仓库: shared (feature/types)

自动清理

Workspace 会在 72 小时不活动后自动垃圾回收：

• 活跃的 workspace：无限期保留
• 固定的 workspace：保留 7 天
• 归档的 workspace：1 小时后清理

下一步

• 管理 Git 分支 - 学习如何同步、推送和拉取
• 解决冲突 - 分步冲突解决指南
• 创建 Pull Request - 使用智能描述自动生成 PR
• 故障排查 - 常见问题和解决方案

获取帮助

• 文档：https://refresh-agents.com/docs
• Discord：https://discord.gg/refresh-agents
• 邮箱：[email protected]