@@ -245,8 +245,40 @@ Full guide: [Getting Started](/start/getting-started)
245245246246## Windows companion app
247247248-We do not have a Windows companion app yet. Contributions are welcome if you want
249-contributions to make it happen.
248+We do not have a Windows companion app yet. Contributions are welcome if you want to
249+help make it happen.
250+251+## Git and GitHub connectivity (contributors)
252+253+Some networks block or throttle HTTPS to GitHub. If `git clone` fails with timeouts
254+or connection resets, try another network, a VPN, or an HTTP/HTTPS proxy your
255+organization provides.
256+257+If `gh auth login` fails during the browser device flow (for example a timeout
258+reaching `github.com:443`), authenticate with a personal access token instead:
259+260+1. Create a token with at least the `repo` scope (classic PAT) or equivalent
261+ fine-grained access.
262+2. In PowerShell for the current session:
263+264+```powershell
265+$env:GH_TOKEN="<your-token>"
266+gh auth status
267+gh auth setup-git
268+```
269+270+3. If `gh auth status` warns about missing `read:org`, mint a token that includes
271+ that scope and re-assign the variable:
272+273+```powershell
274+$env:GH_TOKEN="<your-token-with-repo-and-read:org>"
275+gh auth status
276+```
277+278+`gh auth refresh -s read:org` only applies when you authenticated via `gh auth login`
279+and have stored credentials to refresh (not when using `GH_TOKEN`).
280+281+Never commit tokens or paste them into issues or pull requests.
250282251283## Related
252284此内容由惯性聚合(RSS阅读器)自动聚合整理，仅供阅读参考。 原文来自 — 版权归原作者所有。