# 社区客户端教程与截图提交

我们公开征集 Shadowrocket、Surge、Quantumult X、Loon、Stash 和 Egern 的配置教程与真机截图。
提交内容会经过复核、统一裁剪和标注后再进入 App 或项目文档。

## 客户端分区

投稿统一进入 GitHub Discussions 的“第三方配置分享”固定入口。表单通过“第三方客户端”下拉框分类：

| 客户端 | 表单选项 |
|---|---|
| Shadowrocket | `Shadowrocket` |
| Surge | `Surge` |
| Quantumult X | `Quantumult X` |
| Loon | `Loon` |
| Stash | `Stash` |
| Egern | `Egern` |

App 始终打开同一个投稿地址，仓库中的 Discussion 表单负责维护客户端、版本、步骤、截图和署名字段。
“去提交”会先复制带当前客户端名称的投稿模板，再通过 App 内 Safari 打开固定页面，避免被不支持
Discussions 的 GitHub 客户端拦截。用户也可以从 Safari 视图的分享菜单改用其他浏览器。“复制模板”按钮仍可
单独使用，设置页的“支持 → 分享第三方配置”也提供相同入口。采纳后的配置在 README 客户端状态表中按客户端
收录，并链接到教程或原始投稿。投稿者可以选择匿名收录；未选择匿名时可在 README 中显示 GitHub 账号。

## 提交内容

请提供：

1. 客户端名称和版本；
2. iOS 版本；
3. 从导入模块到启用代理的完整操作步骤；
4. 每一步对应的原始截图文件名；
5. 需要点击、开启或填写的位置说明；
6. 最终是否验证通过，以及失败时看到的错误。

推荐按下面的格式描述步骤：

```text
客户端：Shadowrocket
版本：
iOS 版本：

步骤 1：
- 截图：01-module-list.jpg
- 操作：点击右上角“+”

步骤 2：
- 截图：02-https-decryption.jpg
- 操作：开启 HTTPS 解密，并填写 gs-loc.apple.com

验证结果：
```

## 截图要求

- 提交原始、清晰、未压缩过度的截图。
- 除敏感信息遮挡外，不要自行添加箭头、编号、边框、说明文字或其他标注。
- 不要为了突出某一步自行裁剪。请在步骤说明中写清需要点击或填写的位置，由维护者统一裁剪和编号。
- 同一张截图可以对应多个步骤，请分别说明每个步骤的位置和顺序。
- 可以遮挡账号、订阅地址、节点、密码、设备标识、开发者账号、真实位置和通知内容。
- 必须完整遮挡证书私钥、认证 Token、Cookie、完整订阅链接以及其他可用于访问账户或服务的信息。
- 遮挡后请再次检查状态栏、列表副标题、输入框、二维码和弹窗，避免遗漏。
- 建议使用稳定、描述性的英文文件名，例如 `shadowrocket-https-decryption.jpg`。

维护者会保留未标注的脱敏原图，并在 App 中使用统一的编号圆点和步骤文字叠加标注。这样同一张图可以复用
多个步骤，客户端界面变化时也能单独替换截图而不重做整套教程。

原图按客户端或运行模式分类保存：

```text
docs/onboarding-screenshots/
├── app-mode/
└── shadowrocket/
```

App 使用的裁剪、压缩和编号版本保存在 `Resources/Assets.xcassets/`，不得覆盖上述原图。新增客户端时创建
独立的小写英文目录，例如 `surge/` 或 `quantumult-x/`。

## 审核边界

- 教程必须来自实际客户端操作，不能把未验证配置描述为已支持。
- 截图和步骤不得包含付费节点、共享账号、破解内容或绕过服务限制的方法。
- 项目只审核教程是否清晰、是否脱敏以及是否能复现，不为第三方客户端、订阅服务或网络环境提供担保。
- 后续客户端版本变化导致界面或步骤失效时，教程可能被标记为待复核或替换。