docs: update README with repo URL, add setup guide and .gitignore

- Update README installation to use uv tool install with self-hosted repo URL
- Add docs/SETUP.md for AI agent consumption
- Add .gitignore for __pycache__, build artifacts, venv, IDE files
- Remove obsolete superpowers planning docs

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-28 18:15:50 +08:00
parent f54d142fde
commit 8af421206b
5 changed files with 44 additions and 1241 deletions

View File

@@ -2,6 +2,8 @@
HTTP proxy for Gitea LFS -- rewrites Host header to bypass ICP domain blocking.
**Repository:** `ssh://git@git.zz.com:2222/Developer/jianda-proxy.git`
## Background
Internal Gitea is exposed via a reverse tunnel on a Tencent Cloud server. The client resolves the domain via `hosts` file to the cloud IP. SSH clone works fine, but LFS file downloads go over HTTP. Tencent Cloud detects the unregistered domain from the Host header and blocks the request with a 302 redirect.
@@ -11,11 +13,7 @@ This proxy rewrites the Host header on all requests to the upstream IP address,
## Installation
```bash
# Install as a global CLI tool (recommended)
uv tool install .
# Or with pip
pip install .
uv tool install git+ssh://git@git.zz.com:2222/Developer/jianda-proxy.git
```
## CLI Commands
@@ -92,7 +90,7 @@ git config --global http.http://git.zz.com:3000/.proxy http://127.0.0.1:13000
3. Clone as usual:
```bash
git clone ssh://git@git.zz.com:2222/your-repo.git
git clone ssh://git@git.zz.com:2222/Developer/jianda-proxy.git
```
LFS downloads will be routed through the proxy transparently.