实战指南 · 免费在线阅读 · 持续更新

AtomGit 使用指南

从注册账号到推送第一行代码，从 Fork 到 Pull Request，从建仓到运营一个真正的开源项目 —— 一本写给国内开发者的 AtomGit 上手手册，照着做就能跑通全流程。

5 分钟快速上手 查看目录

平台速览

AtomGit 是由开放原子开源基金会推出的开源社区与代码托管平台，提供代码托管、协作编程、项目管理、开源组织运营等能力，并在 2025 年进一步升级为覆盖「代码 + 模型 + 环境 + 算力」的开源基础设施。对国内开发者来说，它最大的价值是：中文界面、国内网络访问稳定、可以直接参与国产开源项目。

375万+
注册用户
28万+
开源项目
4200+
开源组织

快速上手：4 步跑通第一个仓库

1

注册账号，完善资料

打开 atomgit.com 完成注册，设置用户名（决定你的主页与仓库地址），顺便填好头像、简介和邮箱。用户名一旦改了，旧的仓库链接可能会失效，第一次就要取好。

2

配置 SSH 密钥

本地生成密钥对，把公钥添加到「设置 → SSH 公钥」，之后推代码就不用每次输密码。

bash 
# 1. 生成密钥（一路回车即可，已存在则跳过）
ssh-keygen -t ed25519 -C "you@example.com"

# 2. 复制公钥内容，粘贴到 AtomGit「设置 → SSH 公钥」
cat ~/.ssh/id_ed25519.pub        # macOS / Linux
type %USERPROFILE%\.ssh\id_ed25519.pub   # Windows PowerShell

# 3. 验证连通性
ssh -T git@atomgit.com
3

创建仓库

点击右上角新建仓库，填写仓库名、简介，选择开源可见性，初始化 README.md 与 .gitignore。如果你在 GitHub / Gitee 上已有项目，也可以直接用「导入仓库」功能一键搬过来，历史提交记录会一并保留。

4

把本地代码推上去

bash 
# 已有项目：关联远端并推送
git remote add origin git@atomgit.com:<你的用户名>/<仓库名>.git
git branch -M master
git push -u origin master

# 全新项目：从零开始
git init
git add .
git commit -m "feat: 项目初始化"
git remote add origin git@atomgit.com:<你的用户名>/<仓库名>.git
git push -u origin master

习惯用 HTTPS 也可以：https://atomgit.com/<用户名>/<仓库名>.git，首次推送时输入账号密码或个人访问令牌。

你必须掌握的核心能力

代码托管

公开 / 私有仓库、分支保护、标签与 Release 发布，完整兼容标准 Git 协议，现有工具链零迁移成本。

协作编程

Fork 项目 → 新建分支 → 提交改动 → 发起 Pull Request → Code Review → 合并，标准的开源协作闭环。

Issue 与讨论

用 Issue 反馈缺陷与需求，用标签、里程碑做排期，让项目进度对外透明，也让新人能快速上手。

开源组织

以组织为单位管理成员权限与多个仓库，适合团队、高校社团、城市开发者社区统一运营。

文档与 Wiki

README、Wiki 与帮助文档共同构成项目的门面，写清楚「它是什么、怎么装、怎么用」。

模型与 AI 能力

升级后的 AtomGit 把模型管理与代码托管放在同一个社区里，代码、模型、数据集可以在一处流转。

如何为别人的项目提交第一个 PR

1

Fork 到自己账号下

打开目标仓库，点击 Fork，就得到一份完全属于自己的副本，随便改都不会影响原项目。

bash 
git clone git@atomgit.com:<你的用户名>/<仓库名>.git
cd <仓库名>

# 加上游仓库，方便后续同步原项目的最新代码
git remote add upstream git@atomgit.com:<原作者>/<仓库名>.git
git remote -v
2

开分支，小步提交

永远不要在 master 上直接改代码。一个分支只做一件事，提交信息写清楚动机。

bash 
# 先同步上游最新代码，避免白改
git fetch upstream
git checkout master
git merge upstream/master

# 新建功能分支
git checkout -b feat/fix-typo-in-readme
git add .
git commit -m "docs: 修正 README 中的安装步骤笔误"
git push origin feat/fix-typo-in-readme
3

发起 Pull Request

回到 AtomGit 页面会看到「创建 Pull Request」提示：写清改动背景、解决方式、影响范围，能截图就截图，能关联 Issue 就关联。描述写得越清楚，被合并的速度越快。

4

配合 Review 迭代

维护者提出修改意见后，在同一个分支继续提交即可，PR 会自动更新。合并完成后删除本地与远端分支，回到 master 重新同步上游，下一个贡献就从这个干净的起点开始。

完整目录

01认识 AtomGit：开源社区与代码托管
02注册账号与个人信息设置
03SSH 密钥配置与本地 Git 环境
04创建仓库与从 GitHub 导入项目
05代码推送、分支策略与提交规范
06Fork / Pull Request 协作全流程
07Issue、标签与里程碑项目管理
08开源组织：团队、权限与仓库治理
09把项目做成开源：README、协议、贡献指南
10模型托管与 AI 能力实践

让项目被看见的 5 个细节

一份能跑通的 README

项目简介、效果截图、30 秒快速开始、常见问题。新人能不能留下，取决于前三屏。

明确开源许可证

没有 LICENSE 的项目等于「默认不可商用」。MIT、Apache-2.0、GPL 按需选择，写进仓库根目录。

CONTRIBUTING 贡献指南

写清楚怎么跑起来、怎么提 PR、代码风格要求，能显著降低协作沟通成本。

稳定的发版节奏

用 Tag 与 Release Notes 记录每个版本的变化，用户才知道该不该升级、升了会有什么影响。

认真回复每一个 Issue

开源项目的口碑是攒出来的。哪怕暂时修不了，回一句「已复现，下周处理」也比沉默强得多。

把项目分享出去

写好项目后发到社区、技术群、开源活动里。有人用，才会有反馈；有反馈，项目才活得下去。

适合谁阅读

1

第一次用 Git 的新手

照着「快速上手」四步走完，就能拥有第一个属于自己的线上仓库。

2

想参与开源贡献的开发者

搞懂 Fork、分支、PR 与 Review 的流程，提交第一个能被合并的改动。

3

准备开源自己项目的作者

从协议选择、README 撰写到发版节奏，把项目做成别人敢用、愿意参与的样子。

4

高校社团与城市技术社区

用开源组织统一管理仓库与成员权限，把活动产出沉淀成可复用的资产。

常见问题

推送时提示没有权限，怎么办？
先确认用的是 git@ 开头的 SSH 地址，并且公钥已经加到账号里；用 ssh -T git@atomgit.com 验证。HTTPS 方式下则需要用个人访问令牌代替密码。
能从 GitHub 把项目搬过来吗？
可以。新建仓库时选择「导入仓库」，填入原仓库地址即可，提交历史、分支和标签都会保留。导入后记得在本地把 remote 换成新的 AtomGit 地址。
Fork 之后怎么跟上原项目的更新？
把原仓库加为 upstream 远端，需要时用 git fetch upstream 加 git merge upstream/master 同步，再推回自己的 Fork。
不小心把密钥或密码提交上去了？
第一时间是去平台轮换密钥，而不是只删提交记录 —— Git 历史是可追溯的，泄露过的凭据必须作废重发。
私有仓库可以转公开吗？
可以，在仓库设置里调整可见性。转公开前请确认代码里没有内部地址、密钥、客户数据等敏感信息。

现在就创建你的第一个 AtomGit 仓库

注册只需一分钟，SSH 配好之后，剩下的就是写代码和提 PR

前往 AtomGit 官网 官方帮助文档