location-spoofer/docs/COMMUNITY_TUTORIALS.md

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

我们公开征集 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. 最终是否验证通过，以及失败时看到的错误。

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

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

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

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

验证结果：

截图要求

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

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

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

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

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

审核边界

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