GitHub 零基础保姆级教程：从注册、选项目到改造、上线全流程笔记

GitHub 零基础保姆级教程：从注册、选项目到改造、上线全流程笔记

核心结论：GitHub 是 2026 年学 AI 必须掌握的开源项目托管平台；掌握注册、找项目、判断质量、本地运行、用 AI 改造、commit/branch/push、发布 Release 和部署上线，就能把别人的开源项目变成自己能用的产品，并让全世界通过链接访问。

一、背景：为什么 2026 年学 AI 要学 GitHub

• 2026 年想学 AI，必须要学会的一个网站是 GitHub，原文还提到“年初爆火的小龙虾”。
• 这段时间流行的 Codex，以及国内 DeepSeek（原文识别为 deep sick / deep Seeck）等工具，它们的安装文件、完整源代码、每一次版本更新、其他用户反馈的 bug 和解决方案，全都集中在 GitHub 上。
• 本期内容被描述为“最完整并且最容易学会的 GitHub 零基础保姆级教程”，承诺覆盖：
• 怎么注册账号；
• 怎么找到优质项目；
• 怎么判断一个项目值不值得用；
• 怎么把项目部署到电脑上运行；
• 怎么用 AI 把它改造成你自己的版本；
• 最后怎么把它部署上线，让全世界任何人通过一个链接直接使用你的网站。
• 原文提到“关于这些内容的文档教程，我也全都给大家准备好，放在这份手册里了”，但手册内容本身没有在原文中展开。

GitHub 是什么

• GitHub 是全球最大的开源项目托管平台。
• 可以简单理解成一个免费的应用和资源商店。
• 与普通应用商店的区别：
• 你不仅能够使用这些应用；
• 还能看到每个工具的完整源代码；
• 并且可以修改它，做出自己的版本。
• 案例：
• 之前很火的 AI 编程工具 Cursor，是基于微软开源的 VS Code 魔改出来的。
• 字节 Trae（原文识别为 tray），同样也是基于 VS Code 的开源代码做出来的。
• 除了工具之外，GitHub 上还有很多实用资源：
• free programming box（原文）：收录了上万本免费电子书和课程，被将近 40 万人标记过。
• prompt engineering guide：整理了一整套 AI 使用教程，从怎么提问、怎么让 AI 回答得更准确，到怎么让 AI 查资料、调用工具连续完成复杂任务，全都有对应案例讲解。
• 这些在 GitHub 上全都可以不花一分钱得到。

二、注册账号与基础界面

注册步骤

GitHub 账号注册方式很简单，基本没有什么门槛：

1. 打开 GitHub 官网；
2. 右上角点 Sign up；
3. 填写邮箱、密码、用户名三个信息；
4. 邮箱建议使用谷歌邮箱或者微软邮箱，国内邮箱有时候收不到 GitHub 的验证码；
5. 用户名只能使用英文字母、数字和横杠，不支持中文填写；
6. 填完信息之后，GitHub 会发送一封验证码邮件；
7. 把验证码复制到 GitHub，账号就注册好了。

首页与界面

完成注册后，会进入 GitHub 首页 Dashboard：

• 左侧是你订阅的仓库列表，现在还是空的。
• 中间是 Activity Feed，会显示你关注的项目和开发者的动态。
• 右上角有你的头像，点开就能进入个人设置。
• 界面是全英文的。

如果看不懂英文，可以装一个浏览器翻译插件，比如沉浸式翻译：

• 在浏览器扩展商店搜索安装；
• 装好之后刷新 GitHub 页面；
• 就可以看到所有英文旁边多了一行中文翻译。

三、找项目的 4 种常用方式

方式一：刷 Trending

• 打开 GitHub 左侧菜单，找到 Explore，点进去选 Trending。
• 这个页面会显示 GitHub 上最近一天、一周、一个月最受欢迎的开源项目，并且按热度进行排序。
• 可以在页面顶部切换时间范围。
• 也可以用 Spoken language 下拉框过滤中文项目。
• 例如切到 This week，就会出来一周内热度最高的项目卡片。
• 每个卡片上有项目名称、简介、编程语言、star 数和这周新增的 star 数。
• 这里也是很多 AI 博主的一手信息源，一般最新的 AI 工具经常会第一时间出现在这里。
• 即使不知道要找什么也没关系，先进来逛逛，看到感兴趣的项目名就点进去看看。
• 因为这里面藏着很多信息差：大部分 AI 项目在 GitHub 上发布之后，要等几天到几周才会有自媒体介绍。会用 GitHub，新工具发布当天就能看到。

方式二：直接搜索

• 点 GitHub 顶部的搜索框，输入关键词，然后回车，就会搜索出对应项目。
• 搜索结果页面一般默认按照关键词相关度排序。
• 也可以切换成 Most stars，按热度排序。

两个提升搜索质量的技巧：

1. 在关键词里加上 awesome。

• awesome 是 GitHub 社区的一个约定用法，表示精选清单。
• 加了这个词搜出来的通常是有人花时间整理过的工具合集，功能对比、价格、优缺点都帮你列好了。
• 例如搜索 awesome prompt 相关内容（原文识别为 awesome pro 你，疑似语音识别误差），搜出来的结果 star 数都很高，点进去就可以看到一堆别人已经整理好的各种提示词合集，非常全面。

1. 搜中文关键词。

• 很多国人开发的项目 README 是中文写的。
• 直接输入中文关键词就能搜到。
• 例如搜“文本转语音”“知识库管理”“自动化报表”，搜出来的结果里有不少中文文档齐全的项目，上手门槛会比纯英文项目低很多。
• 搜索结果页面左侧还有过滤选项，可以按编程语言、star 数、最近更新时间来缩小范围。

方式三：直接问 AI

• 当实在想不出来关键词的时候，可以打开常用的任何可以联网的工具，描述你的需求，让它推荐。
• 例如让 AI 推荐一个开源的 AI 聊天界面，能连接多个大模型，支持自己部署，界面好看。
• AI 就会列出几个项目的名称、功能简介和 GitHub 链接。
• 你直接点链接就能跳到对应的项目页面。

方式四：看博主推荐

• 很多技术类自媒体会分享很多高质量的开源项目。
• 评论区也经常有人互相推荐。
• 你看到感兴趣的，就可以直接拿着关键词去 GitHub 上搜索对应的项目。

四、判断项目质量：4 个核心指标 + Issue

GitHub 上有超过 4 亿个开源项目。要在这么多项目里分辨一个项目质量高不高、值不值得花时间研究，可以重点观察四个指标。

辅助判断指标：Issue 的数量和活跃度。

• 点一下项目的 Issue 标签，就能看到总数和当前 open 状态的数量。
• Issue 越多，说明用户基数越大，有人在用，也有人在反馈。
• 如果 Issue 里的问题大多在几天内就有人回复，说明维护者很活跃。
• 反过来，如果几十个 Issue 挂了几个月都没人理，那就说明这个项目没怎么在维护了。

五、准备本地环境：Git、连接 GitHub 与运行项目

安装 Git

• 开始动手之前，需要先在电脑上装一个工具叫 Git。
• GitHub 和 Git 的关系：Git 是 GitHub 背后用来管理代码的工具，需要装在你的电脑上，后面所有操作都要用到它，所以这一步不能跳过。
• 安装 Git 很简单，跟装普通软件一样：去 Git 官网下载安装包，双击安装。

配置登录认证

• Git 装好之后，还需要配置登录认证，让你的电脑和 GitHub 账号之间建立连接。
• 这一步是为了后面推送代码的时候，GitHub 能识别出这是你在操作。
• 这一步需要在终端里输入命令来完成。
• 如果不熟悉命令行操作也没关系，可以使用 Codex 或 word body 这类 agent 工具来帮助完成。
• 在 Codex 对话框输入：帮我把 Git 和我的 GitHub 账号连接起来。
• Codex 会自动发起认证流程，浏览器会弹出 GitHub 的授权页面。
• 在页面上确认授权，回到 Codex 看到登录成功的提示，就说明连接完成了。
• 如果使用的是 Codex，还有一种更简单的方法：在 Codex 的插件里找到并安装上 GitHub 插件就可以。
• 到这里准备工作就全部做好了。

把项目运行起来：Release、ZIP、Clone

想要把一个项目运行起来，第一步就是先把这个项目装到本地电脑。

方式一：Release 下载

• 如果你只是想用这个工具，不打算看代码，也不打算修改，最快的方式就是 Release 下载。
• Release 页面通常会有打包好的安装文件，跟装普通软件没什么区别。
• 找到项目页面右侧的 Releases 链接进去，找到最新版本。
• 往下滚会看到一组文件，这组文件对应的就是不同版本和不同电脑系统的安装文件。
• 如果不确定应该下哪个，直接截个图发给 AI 问一下就可以。

方式二：下载 ZIP

• 如果这个项目没有提供 Release 安装包，或者你暂时只是想把源码下载下来看看，或者本地跑一下，最简单的方式就是下载 ZIP。
• 在项目页面点绿色的 Code 按钮，选 Download ZIP，浏览器就会直接下载一个压缩包。
• 解压之后就是完整的项目文件，跟你平时下载文件没什么区别。
• ZIP 下载有一个局限：它只是把代码下载下来了，并没有和 GitHub 建立关联。
• 也就是说，你后面想要提交修改或者同步更新会比较麻烦。
• 所以如果你打算在源码基础上做修改，最好用下面这种方式，也就是把整个项目完整克隆到你的电脑上。

方式三：Clone 克隆

• Clone 这个操作通常要在终端里敲一行命令。
• 这一步也可以直接借助 agent 工具来操作。
• 直接新建一个项目，然后在对话框输入：帮我克隆这个项目到本地。
• 然后把 LobeChat 的 GitHub 链接粘贴进去，回车发送。
• 接着耐心等待 Codex 执行完成。
• 执行完成之后，打开这个项目的文件夹，就可以看到 src、public、package.json 这些文件。
• 这就说明项目已经完整保存到电脑上了。

启动项目

• 继续在对话框输入：帮我看看这个项目怎么运行并启动它。
• Codex 会读取这个项目的 README 和 package.json，并且自动安装项目运行需要的各种依赖。
• 看不懂也没关系，只需要等 Codex 操作完就可以。
• 完成之后，Codex 会输出一个 localhost 地址加端口号，比如 localhost:9877。
• 这个地址就是你本地运行的入口：
• localhost 就是你自己的电脑的意思；
• 9877 是端口号；
• 两个加在一起构成本地访问地址。
• 在浏览器地址栏输入这个地址回车，就可以看到在本地部署的 LobeChat 完整界面：
• 顶部左上角是 logo 和默认的英文标语；
• 整体是白色调；
• 左侧有一个对话列表，面板可以新建和切换多个对话；
• 中间是聊天窗口，占了大部分屏幕空间；
• 底部有一个输入框和发送按钮；
• 右侧还有一些功能图标。
• 试着在输入框输入一句话，点发送：
• 如果你配置了 API，AI 会直接回复，对话气泡出现在聊天窗口里；
• 没配的话，界面会弹出一个设置面板，提示你去填 API。

报错与 Issue 排错

• 如果这个过程中某一步出现报错，直接把报错信息发给 Codex，它就会识别出报错类型并自动尝试修复。
• 如果有 Codex 解决不了的报错，可以在项目页面顶部找到刚才提到的 Issues 标签。
• 这里是所有用户反馈问题的地方。
• 在搜索框里粘贴报错信息的关键词搜一搜，很多时候别人已经遇到过同样的问题，解决方案就在评论里。
• 搜索的时候注意一个细节：
• 搜索框里默认带着 is:open，意思是只搜还没关闭的问题；
• 把 is:open 删掉，再搜，已经关闭的问题也会出现；
• 这些往往更有用，因为关闭通常说明问题已经解决了，解决方案就在最后几条回复里。
• 搜不到的话也可以自己发一个 Issue：
• 点 New issue；
• 写清楚三个信息：操作系统版本、具体操作步骤、完整报错信息；
• 因为描述写不来，就让 AI 帮你翻译整理粘贴过去；
• 开源项目的维护者和社区通常会回复。
• 到这里，你就已经学会了怎么把一个 GitHub 项目在本地跑起来。

六、把项目改造成自己的版本：Fork、Commit、Branch、Push、PR

接下来是这条视频最核心的部分：怎么把一个项目改造成属于你自己的版本。在这个过程中，需要了解几个 Git 里最重要的概念。

Fork：复制一份到自己名下

• 回到 LobeChat 的 GitHub 页面，看右上角有一个 Fork 按钮。
• 点它会弹出一个确认框，然后直接点 Create fork 就可以了。
• 等几秒页面会自动跳转，你会发现左上角的项目名前面变成了你自己的用户名。
• 这就说明你的 GitHub 账号下已经多了一个和 LobeChat 一模一样的副本。
• Fork 的意思可以理解成复制一份到你自己名下。
• 跟直接下载不同的是，Fork 会保留和原项目的关联，以后原项目有重要更新，你也能同步过来。

克隆自己的副本到本地

• 完成之后，我们需要把这个副本克隆到本地电脑。
• 回到 Codex 输入：帮我克隆这个项目。
• 然后把你自己账号下那个副本的链接粘贴进去。
• 这里要注意一个细节：一定要用你自己的链接，不是原项目的。
• 如果用了原项目的链接，后面推送代码的时候会因为没有写入权限而报错。
• 等 Codex 执行完成，副本就已经在你电脑上了。
• 还是用刚才同样的方式，我们先让这个项目在本地运行起来。

第一次修改：主题色和标语

• 在 Codex 里输入：把聊天界面的主题色从白色改成深紫色，把顶部标语改成你的专属AI助手。
• Codex 就会自动扫描项目文件，找到需要修改的地方，然后帮你完成修改。
• 改完之后，Codex 右侧会同步显示一个变更对比面板。
• 你会看到面板里列出了两个被修改的文件：
• 第一个文件：红色是旧的英文标语，绿色是新的“你的专属AI助手”；
• 第二个文件：红色的行是被替换掉的旧颜色代码，绿色的行是新写入的紫色色值。
• 这个红绿对比就是 Git 里查看改动的标准方式，后面你会经常看到。
• 然后切到浏览器刷新一下页面，变化非常直观：
• 顶部区域从默认白色变成了深紫色；
• 渐变 logo 旁边的标语从“早上好”变成了“你的专属AI助手”；
• 整体色调统一。

Commit：手动存档

• 改完之后，还需要做一个很重要的操作叫 commit。
• 在 Git 里面修改了文件并不等于记录了这次变更。
• 你需要做一次 commit，这次改动才会被正式写进版本历史。
• Commit 可以理解为游戏里的手动存档：
• 每过一关你手动存一次；
• 每个存档记录了那一刻的完整状态；
• 下次遇到问题，你可以读取之前的存档重新来过。
• Git 的 commit 就是这个逻辑，每次修改完手动存一次档，所有存档按时间排列，你随时可以回到之前任何一个状态。
• 具体操作也很简单，直接跟 Codex 说：帮我提交这次修改描述，写更换主题色和标语。
• Codex 就会帮你完成这次存档。
• 提醒：如果你的项目经常会有改动，一定要养成每修改一次就存一次档的习惯。
• 这样万一后面哪一步改出了问题，你可以随时回退到之前任何一个正常的版本。

Branch：安全试验空间

• 接下来做第二个修改：在首页加一个快速引导卡片。
• 但大改动是有风险的，万一改出问题影响了现有功能怎么办？
• 这就需要用到另一个概念叫 branch，也就是分支。
• Branch 可以这样理解：你看过平行宇宙的设定吧，在一个时间节点分出两条时间线，两条线上的事互不干扰，最后还可以合并回来。
• Branch 就是这个逻辑：
• 你在主线旁边开一条分支；
• 在分支上随便改；
• 改好了就合并回主线；
• 改坏了直接删掉分支就行，主线完全不受影响。
• 操作：
• 跟 Codex 说：帮我创建一个新分支叫 new feature；
• Codex 执行完之后会告诉你已切换到新分支；
• 现在我们所有的操作都在这条分支上，主线不会受到任何影响。
• 然后输入第二个需求：在首页加一个快速开始引导卡片包含三个步骤，选择 AI 模型，输入问题，获取回答，卡片放在聊天区上方。
• 等 Codex 执行完毕，刷新浏览器：
• 聊天窗口上方多了一张卡片；
• 三个步骤横排展示；
• 配色还跟之前改的紫色主题自动匹配了。
• 如果这个效果你满意，就跟 Codex 说：帮我把 new feature 分支合并回主线。
• 合并成功之后，引导卡片就正式进入了主线版本。
• 如果效果不满意，也很简单：
• 直接说：帮我删掉 new feature 分支，然后切回主线就行；
• 删除之后刷新浏览器，引导卡片消失了，界面干干净净恢复到创建分支之前的样子；
• 主线代码完好无损。
• 这就是 branch 的价值：一个安全的试验空间，留下不行，丢掉非常方便。
• 案例中选择保留，所以已经合并回来了。
• 老规矩，存一次档，描述写“添加快速引导卡片”。

第三次修改：替换 logo 和应用名称

• 这次把 LobeChat 的 logo 和应用名称换成你自己的。
• 在 Codex 里输入：把应用名称从 low chat 改成阿川AI，再把默认的 logo 替换成这张图片。
• 然后把提前准备好的 logo 图片拖进对话框一起发送。
• Codex 找到了名称配置和 logo 文件的位置，把旧的替换成了新的。
• 刷新浏览器就可以看到：
• 左上角的图标变成了你自己的 logo；
• 旁边的名字从 lochat 变成了阿川。
• 到这一步，这个项目从外观上看已经有你自己的风格。
• 然后再存一次档，描述写“替换 logo 和应用名称”。

查看提交历史与回退

• 到这里，三个修改就全部完成了。
• 对应三次 commit 存档，打开提交历史看一下：
• 三条记录，从新到旧排列；
• 每一步修改都有清晰的记录，随时可以追溯。
• 如果以后某个改动出了问题，直接跟 Codex 说：帮我回退到某某版本。
• 它就会帮你恢复到指定的存档状态。

Push：上传到 GitHub

• 但是现在有个问题：到目前为止，我们的三次修改都还只保存在你自己的电脑上。
• 你的 GitHub 页面上还是 fork 过来的原始版本。
• 所以还需要做一步操作叫 push。
• 什么叫 push？
• 你电脑上的项目叫本地仓库；
• GitHub 上的叫远程仓库；
• Push 就是把本地的存档上传到远程，相当于把游戏存档同步到云端。
• 反过来还有一个操作叫 pull，就是把远程的更新拉到本地。
• 这里你只需要记住：push 是上传，pull 是下载。
• 接着直接跟 Codex 说：帮我把代码推送到 GitHub。
• 等执行完成之后，切到浏览器验证一下：
• 打开你的那个项目页面刷新；
• 你会看到最近更新时间变成了刚刚；
• 提交信息也变成了我们最后一次存档的描述；
• 点一下提交次数的链接，进入完整的提交历史，三条新记录都在；
• 本地和远程现在完全一致了。

Pull Request：向原项目贡献修改

• 最后还有一个操作叫 pull request。
• 如果你觉得你的某个修改对原项目也有价值，就可以通过 pull request 交给原作者审核。
• 操作：
• 点项目页面的 Pull requests 标签；
• 点 New pull request；
• 选择从你的仓库合并到原项目；
• 写清楚你改了什么就行。
• 描述建议用英文，不会写的话直接让 AI 帮你翻译。
• 原作者审核通过就会把你的修改合并进去。
• 当然这里演示我们用不到这个操作，大家知道有这个路径就行。

七、发布成正式开源作品：README、安全扫描、推送、Release

到这里，你已经学会了怎么 Fork 项目、用 web coding 修改代码、用 commit 存档、用 branch 创建分支，以及怎么把修改 push 到 GitHub。不过现在别人点进你的项目页面，看到的还是一堆代码文件，没有介绍，没有许可证，不知道这个项目是做什么的，也不知道能不能拿来用。接下来要把这些东西补齐，让你的项目看起来像一个正式的开源作品。

第一步：写 README

• README 就是别人点进你项目第一眼看到的介绍文档，决定了他们会不会继续往下看。
• 在 Codex 里输入：帮我写一个 README，包含项目介绍、功能列表、安装步骤和使用说明，用中英双语。
• Codex 就会帮你生成一份完整的 README 文件。
• 内容会包括中文标题、英文标题、功能列表、安装命令，格式都很清楚。
• 如果有哪个地方写得不准确，直接在对话里跟 Codex 说就行。
• 确认内容没问题之后，存一次档，描述写“添加 README”。

第二步：推送前做安全扫描

• 开源意味着你的代码对所有人完全公开。
• 如果项目里不小心残留了密码、API 等敏感信息，推送之后任何人都能看到。
• 在 Codex 里输入：帮我检查项目里有没有 API 密码或者其他敏感信息。
• 本次改的内容比较简单，大概率不会有问题。
• 但以后如果你自己从零开始写项目，或者接入了 AI 模型的 API，这一步就非常关键了。
• 养成习惯，每次推送前都检查一遍。
• 如果扫描发现问题，让 Codex 帮你处理掉。
• 处理完之后记得存一次档，描述写“清理敏感信息”。

第三步：推送

• 跟 Codex 说：帮我把代码推送到 GitHub。
• 等执行完成就可以了。
• 如果你不是 Fork 的项目，而是自己从零开始写的新项目，就跟 Codex 说：帮我在 GitHub 上创建一个公开仓库，然后推送代码。
• Codex 会帮你一步到位。
• 推送完成之后，打开浏览器看一下你的项目页面：
• 文件列表里多了 README 和许可证文件；
• README 的内容完整展示在页面下方；
• 中文标题、功能列表、安装命令都有，排版很清楚。

第四步：发正式版本 Release

• 打开你的项目页面，找到右侧边栏的 Releases，点进去。
• 点 Create a new release 按钮。
• 在 tag 那里输入 V0.10，标题也写 V0.10。
• 下面的描述框里写上这个版本做了哪些事情。
• 例如：定制了主题色、添加了引导卡片、替换了 logo 和应用名称。
• 写完之后点 Publish release。
• 之前我们下载别人的项目用的就是这个 Release 页面。
• 现在你自己的项目也有了，别人同样可以在这里下载你的作品。
• 到这里，你的第一个开源项目就正式发布了。

八、部署上线：让全世界通过链接使用

现在你的项目代码已经在 GitHub 上了，但如果是一个网页应用，别人要用的话还得自己下载安装，运行门槛很高。部署就是把你的项目放到网上，让全世界任何人通过一个链接就能直接打开使用。这里介绍两种方式，根据你的项目类型来选。

方式一：GitHub Pages

适合纯静态的网页。什么是静态网页？就是不需要后端服务的页面，比如个人博客、作品集展示页、产品介绍页。

操作很简单，四步就能搞定：

1. 打开你的项目页面，点顶部的 Settings 标签。
2. 左侧菜单找到 Pages，点进去。
3. Source 下拉框选 Deploy from a branch，Branch 选择文件夹，选择 root，然后点击 Save。
4. 如果 Save 是灰色的，说明这个配置已经保存过了，可以直接进行下一步。

配置完成后，等一两分钟再刷新一下这个页面。

有一点需要注意：

• 如果项目是 Fork 过来的，第一次部署时可能需要进入 Actions，点击绿色按钮启用工作流，然后 GitHub Pages 才会开始部署。
• 部署完成之后，你会在 GitHub Pages 这里看到网站的访问地址，点击 Visit site 就能打开。
• 现在你的网页就已经上线了，任何人都能通过这个链接直接访问，完全免费。
• 不需要买域名，也不需要买服务器。
• 以后你更新了代码，再次推送，网站内容也会自动跟着更新。

方式二：Vercel

如果你的项目比较复杂，像我们改造的 LobeChat 这种，GitHub Pages 就不适用了。这时候就需要用到第二种方式：Vercel（原文识别为 versal/vers/cell）。这是一个专门用来部署网页应用的平台，支持各种类型的项目，而且对个人用户免费。

操作流程：

1. 打开平台，用你的 GitHub 账号或者绑定 GitHub 的账号登录。
2. 登录之后进入控制台，点右上角的 Add New，选 Project。
3. 页面会列出你 GitHub 账号下的所有仓库。
4. 找到你要部署的那个项目，点 Import。
5. 下一步是配置页面，这里一般不需要改什么，Vercel 会自动识别你的项目类型。
6. 如果项目运行需要 API key，可以在这个页面的环境变量里提前填好。
7. 确认之后直接点 Deploy，然后就是等 Vercel 完成构建。
8. 根据项目大小，大概需要几十秒到 2～3 分钟。
9. 构建成功后，页面会跳转到一个完成界面，上面有一个以 .vercel.app 结尾的链接（原文识别为 cell app）。
10. 这个链接就是你的公网地址，点开这个链接，你改造过的 LobeChat 就完整加载出来了。

线上呈现效果：

• 深紫色主题；
• 阿川AI 的 logo 和名称；
• 快速引导卡片；
• 全都在线上呈现，和你本地运行的效果一模一样。

现在任何人用手机或电脑浏览器都能打开。后续你每次往 GitHub 推送新代码，Vercel 会自动重新部署，不需要手动重复这些步骤。

其实这个部署流程也可以直接用 Codex 来完成：

• Codex 的插件市场里有 Vercel 的插件；
• 安装之后跟 Codex 说：帮我把这个项目部署到 Vercel 上就行；
• 不过第一次建议跟着上面的步骤手动走一遍，了解整个流程之后，以后再用 Codex 一句话搞定。

如果后面想给项目绑定你自己的域名，在 Vercel 后台的 Domain 设置里就可以添加。你现在就可以把这个链接分享给任何人，对方打开链接就能直接使用你定制的 AI 助手。

九、适合长期保持的 3 个习惯与进阶功能

三个长期习惯

1. 每天花两分钟刷一遍 Trending。

• 把 GitHub Trending 页面加到浏览器书签栏，早上打开刷一遍。
• 不用每个项目都点进去，扫一眼项目名和简介，看到跟你领域相关的，再细看。
• 新的 AI 工具和开源项目，经常第一时间出现在这个页面上。
• 坚持一周，你会明显感觉到你对工具的敏感度会比大多数人高出一个量级。
• 很多博主分享的最新发现，你早几天就已经看到过了。

1. 遇到好项目就点 star 标记。

• 点你的头像进入个人页面，切到 Stars 标签。
• 你标记过的项目按时间排列在这里。
• 时间长了，这个页面会变成一个私人工具库。
• 下次想找某个类型的工具，先去翻自己的 star 列表，比重新搜省力不少。
• 你也可以用 star 的 List 功能给标记分类，比如 AI 对话类、自动化工具、设计素材，管理起来更方便。

1. 本地项目记得更新。

• 如果你之前克隆过项目到本地，隔一段时间记得更新一下。
• 跟 Codex 说：帮我检查这个项目有没有新版本，有的话更新一下就行。
• 开源项目的 bug 修复和新功能在持续迭代，保持同步才能用到最新版本。
• 长期不更新的话，等积累了太多版本差异，到时候一次性更新反而容易出问题。

进阶功能

• GitHub Actions：可以做定时自动化任务，比如每天定时跑一个脚本，或者每次推送代码自动运行测试。
• Codespaces（原文 code spaces）：可以在浏览器里直接打开一个完整的开发环境，不需要在本地装任何东西，适合换了电脑或者用平板的时候临时改代码。
• Discussions（原文 discussion）板块：可以看到社区讨论，有些项目的用法技巧和最佳实践就藏在里面。
• 如果你对 Codex 的进阶用法感兴趣，比如怎么用技能系统、怎么配置自动化工作流、怎么连接外部数据源，这些可以后面单独讲。

十、原文不确定与待确认问题

• 原文大量专有名词受语音识别影响，以下名称在原文中不稳定：
• GitHub 在原文中出现为“get up”“gthu”“get Thu”“gup”“get up b”等多种写法，实际应为 GitHub。
• DeepSeek 在原文中识别为“deep sick”“deep Seeck”，实际指向不排除是 DeepSeek。
• LobeChat 在原文中识别为“looup”“lohu”“low up”“Loup”“lochat”等，结合上下文疑似为 LobeChat。
• Vercel 在原文中识别为“versal”“vers”“cell”等，结合上下文疑似为 Vercel。
• 字节的 Trae 在原文中识别为“tray”。
• “word body”这类 agent 工具名称不确定。
• “web coding”在原文中出现，具体指代不明确。
• free programming box 可能是某个免费编程资源项目，但原文名称不完整。
• awesome pro 你疑似为 awesome prompt 相关搜索。
• License 部分“gpl 或 L”具体许可证名称未明确。
• Release 版本号原文写 V0.10，未进一步说明是否应为 V0.1.0。
• “小龙虾”指代不明，原文只提到“年初爆火的小龙虾”。
• 原文提到有“文档教程手册”，但手册具体内容没有在正文中展开，因此无法还原其中的额外步骤。
• 原文多处以 Codex 对话指令代替具体命令行操作，未给出完整 Git 命令、项目配置命令或环境变量细节。
• 原文中“部署到电脑上运行”主要指把 GitHub 项目克隆到本地并启动，不涉及服务器运维细节。

十一、行动清单

1. 注册 GitHub 账号：

• 用 Gmail 或微软邮箱；
• 用户名只用英文字母、数字、横杠；
• 收验证码完成注册。

1. 安装浏览器翻译插件，例如沉浸式翻译，降低英文界面门槛。
2. 学会找项目：

• 刷 Explore → Trending；
• 用搜索框，尝试加 awesome、搜中文关键词、用左侧过滤；
• 问可联网 AI 推荐；
• 看技术博主和评论区推荐。

1. 判断项目质量：

• 看 star 数；
• 看更新时间；
• 看 README 是否完整；
• 看 License；
• 辅助看 Issue 数量和活跃度。

1. 准备本地环境：

• 安装 Git；
• 用 Codex 或 GitHub 插件连接 GitHub 账号。

1. 获取项目：

• 只用不改为 Release；
• 只看源码或本地跑为 Download ZIP；
• 要改为 Clone，最好克隆自己 Fork 后的仓库。

1. 本地运行：

• 让 Codex 读取 README 和 package.json，安装依赖并启动；
• 浏览器打开 localhost:端口号；
• 配置 API；
• 报错先给 Codex，再去 Issues 搜索，必要时发 New issue。

1. 改造项目：

• Fork 到自己账号；
• 克隆自己的副本；
• 做修改；
• commit 存档；
• 大改用 branch；
• 满意就合并，不满意就删除分支；
• push 到 GitHub；
• 有价值可发 Pull Request。

1. 完善开源项目：

• 写中英双语 README；
• 推送前做敏感信息扫描；
• push；
• 发布 Release，例如 V0.10。

1. 部署上线：

• 纯静态项目用 GitHub Pages；
• 复杂网页应用用 Vercel；
• 配置环境变量；
• 获取公网链接；
• 可选绑定自定义域名；
• 后续推送后自动重新部署。

1. 长期维护：

• 每天刷 Trending；
• 遇到好项目点 star，并用 List 分类；
• 定期让 Codex 检查本地项目是否有新版本并更新。

十二、总结

这条 GitHub 零基础教程的主线非常清晰：先把 GitHub 当成开源应用和资源商店，学会注册、找项目、判断项目质量；再安装 Git 并用 Codex 连接 GitHub，通过 Release、ZIP 或 Clone 把项目放到本地运行；接着用 Fork、Commit、Branch、Push、Pull Request 把项目改成自己的版本；再补 README、安全扫描、Release，让它像正式开源作品；最后用 GitHub Pages 或 Vercel 部署上线，让全世界通过链接访问。长期则靠刷 Trending、点 star 收藏、定期更新本地项目，持续发现和使用新的 AI 工具与开源项目。