diff --git a/README.md b/README.md index cd065e04..987b3b9d 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,7 @@ 🇬🇧 [English Quick Start](#quick-start) · [Full Guide (advanced topics)](docs/guide.md) 🇮🇷 [راه‌اندازی سریع فارسی](#راه‌اندازی-سریع) · [راهنمای کامل (مباحث پیشرفته)](docs/guide.fa.md) +

۱. راهنمای تصویری راه اندازی به زبان فارسی (YouTube)
@@ -74,6 +75,8 @@ ISPs can't read inside encrypted HTTPS. They only see the address — `www.googl 11. Google shows a **Deployment ID** (a long random string). **Copy it** — you'll need it in Step 3. > **Tip:** if you ever update `Code.gs` later, don't make a new deployment. Edit the code, then go to **Deploy → Manage deployments → ✏️ → Version: New version → Deploy**. The Deployment ID stays the same. +> +> **Optional:** use the community [Chrome extension](https://github.com/ardalan-ab/mhrv-helper-extension) — see [How to use](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.md) (English) or [راهنمای فارسی](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.fa.md). ### Step 2 — Download mhrv-rs @@ -146,6 +149,12 @@ If something doesn't work: --- +## Community helpers + +Third-party tools are not required to run mhrv-rs; they are listed here for convenience. + +- **[mhrv-helper-extension](https://github.com/ardalan-ab/mhrv-helper-extension)** — Chrome extension (Manifest V3) maintained by **[ardalan-ab](https://github.com/ardalan-ab)**. It helps with Apps Script setup: generate an `AUTH_KEY`, fetch or fall back to canonical `Code.gs`, and copy a `config.json` snippet. **Repository:** `https://github.com/ardalan-ab/mhrv-helper-extension` — [README (English)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/README.md) · [README (فارسی)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/README.fa.md) — [How to use (English)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.md) · [راهنمای استفاده (فارسی)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.fa.md). + ## Common questions **Is this really free?** Yes. Google gives every account 20,000 outbound URL fetches per day on the free tier. That's plenty for one person's normal browsing. For a family of 3–4 sharing the same setup, make 2–3 deployments in different Google accounts and add all the IDs. @@ -198,6 +207,7 @@ Most of the Rust code in this port was written with [Anthropic's Claude](https:/ - 🖥️ **روی** مک، ویندوز، لینوکس، اندروید، روتر OpenWRT کار می‌کند - 🦊 **هر مرورگر یا برنامه‌ای** که از HTTP proxy یا SOCKS5 پشتیبانی کند + ## چطور کار می‌کند (تصویر ساده) ``` @@ -244,6 +254,8 @@ ISP داخل HTTPS رمزشده را نمی‌تواند بخواند. فقط آ ۱۱. گوگل یک **Deployment ID** نشانت می‌دهد (یک رشتهٔ تصادفی طولانی). **کپی‌اش کن** — در مرحلهٔ ۳ لازم داری. > **نکته:** اگر بعداً `Code.gs` را به‌روزرسانی کنی، Deployment جدید نساز. کد را ویرایش کن، بعد **Deploy → Manage deployments → ✏️ → Version: New version → Deploy**. Deployment ID همان قبلی می‌ماند. +> +> **اختیاری:** افزونهٔ اختیاری کروم [mhrv-helper-extension](https://github.com/ardalan-ab/mhrv-helper-extension) — [راهنمای فارسی](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.fa.md) · [How to use (English)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.md). ### مرحلهٔ ۲ — دانلود mhrv-rs @@ -315,6 +327,14 @@ System Settings → Network → Wi-Fi → Details → **Proxies** → هر دو - بخش [سؤالات رایج](#سؤالات-رایج) پایین را ببین --- +## ابزارهای جامعه + +برای اجرای mhrv-rs به این ابزارها نیاز نیست؛ فقط برای راحتی اینجا آمده‌اند. +- افزونهٔ [mhrv-helper-extension](https://github.com/ardalan-ab/mhrv-helper-extension) — کروم (Manifest V3) با نگهداری [ardalan-ab](https://github.com/ardalan-ab) برای کمک در راه‌اندازی Apps Script: تولید AUTH_KEY، گرفتن یا fallback به Code.gs رسمی، و کپی قطعهٔ config.json. +- مخزن: https://github.com/ardalan-ab/mhrv-helper-extension +- خواندن [README (فارسی)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/README.fa.md) · [README (English)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/README.md) +- راهنمای [استفاده (فارسی)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.fa.md) · [How to use (English)](https://github.com/ardalan-ab/mhrv-helper-extension/blob/main/HOW_TO_USE.md) + ## سؤالات رایج