1. 什么是 OpenCode？

OpenCode 是一个开源的代码托管与协作平台，类似于 GitHub 或 GitLab，但更专注于为开源项目提供轻量级、一体化的管理体验。它集成了代码仓库、问题跟踪、持续集成（CI/CD）和文档托管等功能，旨在降低开源项目的维护门槛。

2. 注册与安装

2.1 注册账号

1. 访问 OpenCode 官网（https://opencode.dev）。
2. 点击右上角的“Sign Up”按钮。
3. 使用邮箱、GitHub 账号或 GitLab 账号进行注册。
4. 完成邮箱验证后，即可登录。

2.2 安装命令行工具（可选）

对于高级用户，OpenCode 提供了命令行工具 oc，便于本地操作。

# 使用 curl 安装（Linux/macOS）
curl -fsSL https://cli.opencode.dev/install.sh | sh

# 或者使用 npm
npm install -g opencode-cli

安装后，使用 oc login 命令登录你的账号。

3. 核心功能使用

3.1 创建第一个仓库

1. 登录后，点击导航栏的“New Repository”按钮。
2. 填写仓库名称、描述，选择公开（Public）或私有（Private）。
3. （可选）添加 README、.gitignore 和许可证文件。
4. 点击“Create repository”完成创建。

3.2 克隆与本地开发

创建仓库后，你可以将其克隆到本地进行开发。

# 通过 HTTPS 克隆
git clone https://opencode.dev/your-username/your-repo.git

# 或者通过 SSH（需先配置 SSH 密钥）
git clone git@opencode.dev:your-username/your-repo.git

进入项目目录，开始你的代码编写。

3.3 提交与推送更改

完成代码修改后，使用标准的 Git 工作流提交并推送到 OpenCode。

# 添加所有更改
git add .

# 提交更改
git commit -m "feat: add new feature"

# 推送到远程仓库
git push origin main

3.4 管理 Issues 与 Pull Requests

• 创建 Issue：在仓库页面的“Issues”标签页，点击“New Issue”，描述问题或功能请求。
• 创建 Pull Request (PR)：在分支推送后，仓库页面会提示创建 PR。填写标题和描述，请求将你的更改合并到主分支。

4. 进阶功能

4.1 持续集成（CI/CD）

OpenCode 内置了 CI/CD 功能。在仓库根目录创建 .opencode.yml 文件来定义流水线。

# .opencode.yml 示例
pipeline:
  build:
    image: node:18
    steps:
      - run: npm install
      - run: npm test
      - run: npm run build

提交此文件后，每次推送都会自动触发构建和测试。

4.2 项目 Wiki 与 Pages

• Wiki：每个仓库都有一个独立的 Wiki，用于编写项目文档。
• Pages：可以发布静态网站。将网页文件推送到 pages 分支，或通过 CI/CD 自动部署。

5. 最佳实践与建议

1. 清晰的 README：一个好的 README 是项目的门面，应包含项目介绍、安装步骤、使用示例和贡献指南。
2. 使用分支策略：推荐使用 Git Flow 或 GitHub Flow 等分支策略来管理功能开发、修复和发布。
3. 善用 Issues 和 Projects：用 Issues 跟踪任务，用 Projects（看板）可视化项目进度。
4. 代码审查：对所有 Pull Request 进行代码审查，确保代码质量。
5. 定期更新依赖：使用依赖扫描工具，保持项目依赖处于最新且安全的状态。

6. 常见问题（FAQ）

Q: OpenCode 和 GitHub 的主要区别是什么？
A: OpenCode 更轻量、启动更快，且对个人和小型开源团队完全免费，CI/CD 分钟数也更慷慨。

Q: 如何将现有 GitHub 项目迁移到 OpenCode？
A: 在 OpenCode 创建新仓库后，使用 git remote set-url 命令更改远程仓库地址，然后推送即可。

Q: 支持 Webhooks 吗？
A: 支持。可以在仓库设置的“Webhooks”部分进行配置，与其他服务（如 Slack、Discord）集成。

7. 总结

OpenCode 作为一个新兴的开源平台，以其简洁的界面、完整的开箱即用功能和友好的策略，成为了个人开发者和小型开源团队的一个优秀选择。通过本文的介绍，希望你能够快速上手 OpenCode，并高效地管理你的下一个开源项目。