快速开始

ParallelCode 快速入门指南

安装

ParallelCode 适用于 Windows、macOS 和 Linux。

下载

访问我们的 下载页面 或直接下载适合你平台的版本：

  • Windows：下载 .exe 安装程序
  • macOS：下载 .dmg 文件
  • Linux：下载 .AppImage 或 .deb 包

安装步骤

Windows：

# 运行安装程序
ParallelCode-Setup.exe

macOS：

# 打开 DMG 文件并拖到应用程序文件夹
open ParallelCode.dmg

Linux（AppImage）：

# 添加执行权限并运行
chmod +x ParallelCode.AppImage
./ParallelCode.AppImage

Linux（Debian/Ubuntu）：

# 使用 dpkg 安装
sudo dpkg -i parallelcode.deb

初始设置

安装后，首次启动 ParallelCode。

1. 配置你的项目

ParallelCode 可以直接使用你现有的项目，无需特殊设置。

  1. 点击 "添加项目" 或 "打开文件夹"
  2. 选择你的项目目录
  3. ParallelCode 会自动识别 Git 仓库

2. 创建你的第一个工作空间

工作空间是一个或多个项目的容器。

单项目工作空间：

工作空间："用户认证功能"
  └─ 项目：/path/to/my-app
     分支：feature/user-auth

多项目工作空间：

工作空间："全栈开发"
  ├─ 项目：/path/to/frontend
  ├─ 项目：/path/to/backend
  └─ 项目：/path/to/shared-types

你的第一个并行工作流

场景：同时开发两个功能

传统方式（串行）：

  1. 开发功能 A → 等待 AI → 审查 → 提交
  2. 切换分支
  3. 开发功能 B → 等待 AI → 审查 → 提交
  4. 总时间：30-40 分钟

ParallelCode 方式（并行）：

步骤 1：打开第一个工作空间

1. 启动 ParallelCode
2. 创建工作空间："功能 A - 用户登录"
3. 打开项目：/path/to/my-app
4. 切换到分支：feature/user-login
5. 在 Cursor 中打开（或你的 AI 工具）

步骤 2：开始第一个任务

在 Cursor 中：
- 写提示词："实现带 JWT 认证的用户登录"
- AI 开始工作...

步骤 3：打开第二个工作空间（不要等待！）

1. 启动另一个 ParallelCode 实例
2. 创建工作空间："功能 B - 支付集成"
3. 打开项目：/path/to/my-app
4. 切换到分支：feature/payment
5. 在 Cursor 中打开

步骤 4：开始第二个任务

在第二个 Cursor 实例中：
- 写提示词："集成 Stripe 支付 API"
- AI 开始工作...

现在两个 AI 同时在工作！

步骤 5：审查两个结果

10 分钟后：
- 检查工作空间 1：用户登录完成
- 检查工作空间 2：支付集成完成
- 审查两者，测试并提交

总时间：约 12 分钟（对比 30-40 分钟）

多项目上下文工作流

场景：微服务开发

你有三个相关的服务，希望 AI 理解所有服务。

步骤 1：创建统一工作空间

1. 启动 ParallelCode
2. 创建工作空间："微服务生态系统"
3. 添加多个项目：
   - 添加：/path/to/api-gateway
   - 添加：/path/to/user-service
   - 添加：/path/to/payment-service

步骤 2：在 Cursor 中打开

1. 点击 "在 Cursor 中打开"
2. Cursor 现在可以看到所有三个项目
3. AI 拥有你架构的完整上下文

步骤 3：使用具有上下文感知的 AI

示例提示词：
- "更新 user-service 以使用 api-gateway 中的新
   认证中间件"
- "在 payment-service 中添加新端点，调用
   user-service 验证用户状态"

AI 能够理解：

  • 服务之间如何交互
  • 共享的类型和接口
  • 项目之间的依赖关系

与 AI 工具配合使用

Cursor

ParallelCode 与 Cursor 无缝协作：

  1. 在 ParallelCode 中打开工作空间
  2. 点击 "在 Cursor 中打开"
  3. 正常使用 Cursor 的 AI 功能
  4. ParallelCode 管理工作空间和项目组织

Claude（通过 API 或桌面应用）

  1. 在 ParallelCode 中打开工作空间
  2. 在 VS Code 或通过桌面应用使用 Claude
  3. 将 Claude 指向你的工作空间目录

GitHub Copilot / 其他工具

  1. 在 ParallelCode 中打开工作空间
  2. 打开你喜欢的编辑器（VS Code 等）
  3. 正常使用 AI 工具

关键点： ParallelCode 不替代你的 AI 工具。它管理多个工作空间，让你可以并行运行多个 AI 会话。

最佳实践

1. 分支策略

为每个并行任务创建专用分支：

git checkout -b feature/task-a
git checkout -b feature/task-b
git checkout -b feature/task-c

在单独的工作空间中打开每个分支。

2. 独立任务

选择不会冲突的任务：

  • ✅ 在不同文件上的不同功能
  • ✅ 同时进行前端 + 后端
  • ✅ 功能开发 + Bug 修复
  • ❌ 修改同一文件的两个任务（高冲突风险）

3. 工作空间命名

使用描述性名称：

  • ✅ "用户认证 - OAuth 集成"
  • ✅ "支付 - Stripe 设置"
  • ❌ "工作空间 1"
  • ❌ "测试"

4. 监控进度

定期检查每个工作空间：

  • 每 5-10 分钟审查 AI 进度
  • 停止走向错误方向的任务
  • 向 AI 提供反馈以纠正方向

5. 资源管理

你的机器有限制：

  • 2-3 个并行工作空间：适合大多数开发者
  • 4-5 个工作空间：如果你有 16GB+ 内存
  • 超过 5 个：考虑关闭一些工作空间或升级硬件

常见工作流

开发 + 文档

工作空间 1：实现功能
工作空间 2：编写文档
工作空间 3：编写单元测试

前端 + 后端

工作空间 1：React 前端（分支：feature/ui）
工作空间 2：Node.js 后端（分支：feature/api）

功能 + Bug 修复

工作空间 1：新功能（分支：feature/new-dashboard）
工作空间 2：关键 Bug（分支：fix/memory-leak）

探索模式

工作空间 1：方案 A（分支：experiment/redux）
工作空间 2：方案 B（分支：experiment/mobx）
工作空间 3：方案 C（分支：experiment/zustand）

比较结果，保留最佳方案

故障排除

"多个工作空间中 AI 很慢"

你的机器可能资源受限：

  • 关闭一些工作空间
  • 增加内存分配
  • 使用更轻量的 AI 模型

"合并分支时出现 Git 冲突"

这在并行开发中很正常：

  • 合并前审查两个分支
  • 使用 Git 的合并工具
  • 彻底测试合并后的代码

"工作空间无法打开项目"

检查：

  • 项目路径是否正确
  • 是否有读/写权限
  • Git 仓库是否有效（如果使用 Git 功能）

下一步

需要帮助？