企业官网建设流程全解析

如何在Radicle Upstream中提交你的第一个Patch：Fork与代码贡献新手完整指南

【免费下载链接】radicle-upstreamDesktop client for Radicle.项目地址: https://gitcode.com/gh_mirrors/ra/radicle-upstream

Radicle Upstream 是 Radicle 分布式代码协作协议的桌面客户端，让你无需任何中心化平台，就能 Fork 项目、创建并公开分享自己的第一个 Patch（可理解为去中心化版的 Pull Request）。本指南面向新手，带你从零完成完整的代码贡献流程。

1. 先认识一下：Patch 是什么？

在 Radicle 的世界里，Patch 就是你对一个项目提出的代码修改提案。它和传统 Pull Request 的工作方式很像：你基于项目创建一个分支、提交修改、然后"发布"这个提案给维护者审查。

整个流程只涉及两个工具：

• Upstream 桌面应用：负责 Fork 项目、查看 Patch 列表、查看代码差异
• 终端命令：rad（Radicle CLI）与upstream命令，负责身份认证和 Patch 的创建

💡 Upstream 官方项目本身就通过这套流程接受社区贡献，你完全可以照着本指南给 Upstream 自己提交第一个补丁。

2. 安装 Upstream 并创建你的 Radicle 身份

1. 下载并安装最新版 Radicle Upstream 桌面应用
2. 启动应用，按照引导创建你的Radicle 身份
3. 在最后一个 "All set!" 页面选择"Go to profile"

✅小提示：提交 Patch不需要设置钱包（Wallet），这一步可以完全跳过，新手不必被钱包配置吓到。

3. 配置 rad CLI：一条命令完成认证

rad是 Radicle 的命令行工具，负责把你的身份和 Upstream 打通：

1. 安装最新版本的radCLI
2. 在终端运行认证命令：

rad auth

完成后，Upstream 就能识别到你的身份，并自动进入个人 Profile 页面。

4. 找到项目：用 Project ID 一键跟随

这是新手最容易卡住的环节，其实只需要两步：

1. 按⌘ + p（macOS）或Ctrl + p（Linux）打开Search 搜索框
2. 粘贴 Upstream 项目的 Project ID 并回车：

rad:git:hnrk8ueib11sen1g9n1xbt71qdns9n4gipw1o

页面会出现一张标题为 "Still looking…" 的卡片，几秒内项目从种子节点（seed）拉取完成后，卡片会变成radicle-upstream，点击即可进入项目页面。

5. 一键 Fork：创建你的本地工作副本

进入项目页面后，Fork 就是"把项目复制一份到我自己的 Radicle 身份下并检出到本地磁盘"：

1. 点击"Fork"按钮
2. 在弹窗中点击"Choose"，选择本地磁盘上的一个目录
3. 再点一次弹窗中的"Fork"按钮

稍等片刻，你会看到通知"radicle-upstream checked out to …"，说明工作副本已就位。最后进入该目录，为副本指定 Upstream 的种子节点：

git config --local rad.seed https://maple.radicle.garden

6. 让终端认识 upstream 命令

Upstream 会把upstream和git-remote-rad两个命令安装到~/.radicle/bin。在你的终端配置（或~/.profile）中加入：

export PATH="$HOME/.radicle/bin:$PATH"

重启终端后运行which upstream验证，能看到文件路径就说明集成成功。

7. 创建你的第一个 Patch（核心步骤）

一切准备就绪，真正动手只需 4 步：

1. 建分支：进入工作副本目录，创建一个简短且有描述性的分支名（它会被用来标识 Patch）：

git checkout --branch my-proposed-changes

2. 改代码并提交：进行修改后，按git commit -s提交。-s参数会自动为提交附加DCO 签署行（Developer Certificate of Origin 开发者来源证书），这是本项目接受贡献的硬性要求，详见 docs/contributing.md 与 DCO

3. 创建 Patch：

upstream patch create

默认编辑器会打开，第一行写标题，空一行后写描述。描述中可以引用相关 issue，让维护者快速理解你的修改动机。保存退出即可。

4. 验证发布：回到 Upstream，进入项目的Patches标签页（界面源码见 ui/App/ProjectScreen/Patch.svelte），你的 Patch 应该已经出现在列表中 🎉

8. 通知维护者：别让你的 Patch 石沉大海

发布只是第一步，还需要主动告知维护者：

• 在项目的Discord #upstream 频道里留言
• 或在项目仓库的issue中留言

两种渠道都记得附上Patch URL：点击 Patch 列表中的 Patch ID 即可复制到剪贴板，格式形如radicle://upstream/v0/project/<项目ID>/patch/<对等方ID>/<PatchID>。

9. 回应审查意见：更新并重新发布 Patch

维护者审查后如果要求修改，流程非常顺滑：

1. 回到工作副本目录，切回 Patch 所在分支
2. 完成要求修改的内容，用git commit -s提交
3. 更新并发布：

upstream patch update

编辑器会再次打开标题和描述，可改可不改，保存退出后会提示输入密码短语，然后自动把更新的 Patch 重新发布出去。别忘了再通知维护者"已按意见更新"。

📌 这个"修改—更新—再审查"的循环可能会重复几次，直到 Patch 被合并。完整流程文档见 docs/submit-patch-using-upstream.md，维护者内部视角的贡献流程见 docs/code-contribution-using-upstream.md。

10. 新手常见坑位清单

写在最后

整个过程可以浓缩为一句话：装好 Upstream → 认证 rad → Fork 项目 → 建分支提交 →upstream patch create→ 通知维护者。

相比传统平台，这里没有账号、没有托管方，你的身份、代码和 Patch 都通过 Radicle 协议在节点间自由流转。完成第一个 Patch 后，不妨看看项目 issue 列表里还有哪些等待解决的问题——你的下一次贡献，随时可以开始 🚀

【免费下载链接】radicle-upstreamDesktop client for Radicle.项目地址: https://gitcode.com/gh_mirrors/ra/radicle-upstream