GitHub 是什么？
GitHub 是一个用于存储、管理和协作开发代码的在线平台，同时也是全球最大的开源社区。您可以将项目上传到 GitHub，以便清晰地追踪代码的变更时间和原因。GitHub 允许多人同时处理同一个项目，通过相互审查代码变更、提出建议并进行讨论来协同工作。
总的来说，这种体验类似于具有完整版本历史记录的多人在线文档。正因如此，GitHub 已成为现代软件开发中几乎不可或缺的基础设施。
从核心功能来看，GitHub 最擅长的是版本控制。它建立在 Git 之上，Git 是一种能够持续记录项目演变过程的版本控制系统。无论您是独立开发还是与他人并行协作，这种能力都能显著降低试错成本，并使复杂项目的协作过程更加可控和透明。
GitHub 还提供稳定可靠的代码托管服务。每个项目都存储在一个仓库（Repository）中，该仓库集中包含了所有的源代码和相关文件。仓库可以是公开的（允许任何人浏览和学习），也可以是私有的（仅限特定成员访问），从而满足不同项目阶段和类型的隐私与安全需求。通过基于云端的托管，代码不再受限于单一计算机，而是成为一种长期的、随时可访问的数字资产。
从协作的角度来看，GitHub 让团队开发变得结构化且高效。讨论、Bug 追踪和功能规划都可以直接围绕代码本身进行。这些对话和决策作为项目历史的一部分被完整保留。这种“以代码为中心”的协作模式是许多团队选择 GitHub 的关键原因。
此外，GitHub还是一个高度活跃的社区。海量的高质量开源项目在此平台上持续演进。任何人都可以阅读代码、学习实现方式，甚至直接参与贡献。通过 Star（标星）、Follow（关注）和 Fork（复刻）项目，开发者之间建立了紧密的联系。因此，GitHub 不仅仅是一个工具，更是一个不断推动软件创新的生态系统。
我应该在什么时候使用 GitHub？
当您希望将代码作为长期资产安全地存储在云端时；当您需要与他人协作并希望协作过程有据可查、可追溯时；或者当您希望参与开源项目、向社区学习并分享成果时，GitHub 都是一个自然且高效的选择。
在使用方面，GitHub 的核心逻辑非常直观：您为项目创建一个仓库，在其中持续进行修改，并在适当时与他人同步这些修改，或从他人那里拉取更新。在像 Atoms 这样的工具中，这一工作流被进一步简化。用户只需完成授权，创建或连接仓库，并使用直观的“推送（Push）”和“拉取（Pull）”操作即可与 GitHub 协作，而无需深入了解底层的技术细节。
GitHub 在 Atoms 中是如何工作的？
在 Atoms 中，GitHub 充当了长期存储和协作的可信基础。Atoms 负责生成、修改和组织代码，而 GitHub 则负责可靠地存储结果并提供版本历史和协作能力。二者结合，使用户能够以媲美专业开发团队的方式进行工作，而无需掌握复杂的工程工作流。
当您在 Atoms 中启动一个项目时，您可以选择将其连接到 GitHub。完成授权后，您需要在 Atoms 中手动创建一个新仓库。从那时起，项目的每一个重要里程碑都可以同步到 GitHub，形成清晰且可追溯的历史记录。这意味着，即使您更换设备、更改工具或暂停项目一段时间，您的工作成果依然完整、安全，并随时准备继续。
在实践中，您可以将 Atoms 视为“活跃工作区”，将 GitHub 视为“最终归档与协作中心”。您在 Atoms 中借助智能体（Agent）迭代需求、生成代码并修复问题。一旦某个阶段趋于稳定，您便将结果推送到 GitHub。这种方法避免了频繁同步带来的不必要干扰，同时确保关键里程碑得到安全保存。
要启用 GitHub 集成，请前往工作区并点击右上角的 Integrations（集成），然后从下拉菜单中启用 GitHub。这一操作将反映在 Settings（设置） 面板中。您也可以直接从 Settings 页面启用 GitHub。您需要登录 GitHub 账户并授权 Atoms 以完成连接。
目前，GitHub Connect 功能仅面向 Pro+ 用户开放。
GitHub 还赋予了 Atoms 项目内置的协作潜力。您可以邀请他人访问您的仓库以审查项目结构和实现，甚至贡献代码变更。这种协作不需要其他人也使用 Atoms；它通过 GitHub 这一通用平台进行，实现了跨工具和跨角色的协作，这对个人开发者和小型团队尤为友好。
更重要的是，通过与 GitHub 集成，Atoms 项目不再是一次性的“生成产物”，而是可以持续演进的长期资产。代码可以被复用、扩展、审查和维护，并可以在合适的时机公开，融入更广泛的开源生态系统。这通过将价值从“加速当下的开发”延伸至“为未来项目构建可持续的基础”，从而扩展了 Atoms 的价值。
用户故事
在实际使用中，Atoms 中的 GitHub 集成通常发生在项目的最开始。
以用户 A 为例，他是第一次使用 Atoms。他希望生成的代码能直接保存到 GitHub，而不是仅仅保留在本地环境中。进入 Atoms 工作区后，他点击右上角 Integrations 下拉菜单中的 GitHub Connect，并在 Settings 面板中完成了 GitHub 授权。授权完成后，GitHub 模块显示为已连接状态，表明 Atoms 已可以访问他的 GitHub 账户。
接下来，用户 A 直接在对话中创建了一个新仓库。他输入了一个符合 GitHub 要求的仓库名称并确认创建。随后，他继续在 Atoms 中生成和完善代码。当他觉得当前阶段已稳定时，只需点击 Push（推送），本地代码更新便同步到了 GitHub。几秒钟内，他就能在 GitHub 上看到相应的提交（Commit），清晰地展示了包含的变更内容。
此时，用户 A 继续在 Atoms 中与智能体协作以实现特定功能。完成修改后，他再次点击 Push，所有更新即被同步回 GitHub。其他团队成员几乎可以立即看到新的提交。通过点击 Pull（拉取），用户 A 也可以将远程更新同步回他的本地环境，确保与团队进度保持一致。
这些场景展示了 Atoms 如何利用 GitHub 作为稳定且通用的协作基础。无论是启动全新的项目，还是基于现有的团队仓库工作，Atoms 都能无缝融入既有的工作流，使生成式开发成为软件生命周期中可持续且协作紧密的一部分。