Skillget

cc-translate-proxy

skill
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 8 GitHub stars
Code Uyari
  • network request — Outbound network request in scripts/render_server.py
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Type 中文, CC sees English. Sidecar i18n proxy for Claude Code.

README.md

cc-translate-proxy

讓 Claude Code 用英文跟 Anthropic 對話、你用繁中讀寫的 sidecar 翻譯 proxy。

為什麼做這個

兩件事讓我覺得值得寫個 sidecar：

  1. Claude Code 用英文比中文穩。Anthropic 自家 multilingual benchmark 顯示 Sonnet 4.5 中文（簡）對英文 MMLU 是 96.9%；最近一篇 vibe coding 實測論文 也指出中文 prompt 的問題解決率比英文低 4.5–9.9 個百分點。同樣語意中文 token 數還更多（Petrov et al. 2023 量過跨語 token 數可差 15x）。再加上 cc 會跟著「最後一句的語言」調整輸出，中英混打很容易把整段對話拉進中文模式。
  2. Sonnet 偶爾會自己切到韓文 / 日文。這是已知 bug，繁中使用者在 #30025（中文中突切韓文）跟 #46846（CLAUDE.md 明寫繁中仍回日文）都有重現案例。光靠 prompt / CLAUDE.md 提醒治不住。

這個 proxy 介在 cc 跟 api.anthropic.com 中間：你打的繁中先翻成英文再送過去；模型回的英文一邊原樣回 cc，一邊翻成繁中渲染在本機網頁上。CC 那邊的對話 100% 英文（便宜、穩定、不會自己切日韓文），你這邊讀到的 100% 繁中。

截圖

繁中與英文雙向同步

上半部是 cc-translate-proxy 的本機繁中 render（瀏覽器 localhost:9090/<uuid>），下半部是 cc TUI 看到的英文版對話 — 同一輪對話、不同語言視角。網址 ?nostatusline=1 是本機隱藏底部 statusline 用的截圖模式 query。

運作方式

你輸入「幫我重構這個函式」
   │
   ▼
cc-translate-proxy 攔截 /v1/messages
   ├─ 把繁中翻成英文（Gemini Flash / Groq / OpenRouter，自動切換）
   ├─ 英文版送 api.anthropic.com
   └─ 英文回應 fork 一份 → 翻成繁中 → 渲染到本機網頁

CC 看到乾淨英文對話；你瀏覽器讀到繁中 render。

使用前須知

  • 你的 prompt 跟 cc 回覆會送給第三方 LLM（預設 Gemini Flash）做翻譯。含敏感內容的 session 不要開。
  • 本機會留 audit log（含翻譯前後的 prompt / 回覆）在 audit/ 目錄。除錯用，要定期清。
  • 個人實驗工具，不適合 production。預期會碰到 bug。

快速開始

需要：Python 3.12+、uv。

  1. Clone 跟安裝：

    git clone https://github.com/gggodlin/cc-translate-proxy.git
cd cc-translate-proxy
uv sync

  2. 設定翻譯 provider chain（複製範例後編輯）：

    mkdir -p ~/.cc-i18n-proxy
cp providers.toml.example ~/.cc-i18n-proxy/providers.toml

    providers.toml 內 default_chain 控制嘗試順序、前面失敗才 fallback 到下一個。範例預設 ["gemini", "groq", "openrouter"]，你可以刪到只剩一個或加入 "ollama"（本機免 key）。

  3. 把對應的 API key 寫進 ~/.cc-i18n-proxy/.env（變數名要跟 providers.toml 裡 api_key_env 對齊）：

    cat > ~/.cc-i18n-proxy/.env <<'EOF'
GEMINI_API_KEY=your-key-here
# GROQ_API_KEY=...
# OPENROUTER_API_KEY=...
EOF

    申請連結：Gemini / Groq / OpenRouter。任一個有就能跑，沒設的 provider 會自動從 chain 拿掉。

  4. 把 cc 指向 proxy：

    export ANTHROPIC_BASE_URL=http://localhost:8080
export ENABLE_TOOL_SEARCH=auto      # 把 deferred MCP 載入打開（見注意事項）

  5. 啟動 proxy 跟 render server：

    uv run python -m cc_i18n_proxy > /tmp/proxy.log 2>&1 &
uv run python scripts/render_server.py > /tmp/render.log 2>&1 &

  6. 在任意 claude session 內打 /intl 啟動翻譯。

預設 proxy 是 直通模式（passthrough），你打什麼它送什麼。/intl 把當前 session 加入翻譯白名單：產一個 session UUID、把 marker 塞進對話、之後可以在 http://localhost:9090/<uuid> 讀繁中 render。打 /normal 退出。

設定 /intl skill

/intl 是 cc 的 skill，不是這個 proxy 的一部分。在 ~/.claude/skills/intl/SKILL.md 放最小範本：

---
name: intl
description: 啟動 cc-translate-proxy 對當前 session 的翻譯模式。
---

產生 12-hex session UUID、把 marker emit 出去，proxy 會在下一個 outbound request 看到 marker 然後把這個 session 加入翻譯白名單。

```bash
UUID=$(python3 -c "import secrets; print(secrets.token_hex(6))")
echo "<cc-translate-proxy:enable uuid=\"$UUID\" />"
echo "Render UI: http://localhost:9090/$UUID"
```

讓這個 skill 內容留在對話歷史裡，這樣 `/resume` 跟 proxy 重啟都能自動 recover marker。

對應的 ~/.claude/skills/normal/SKILL.md 要 emit <cc-translate-proxy:disable uuid="<uuid>" /> 退出翻譯。

注意事項

  • Auto-compaction 可能會把 marker 吃掉：對話長到 ~50+ 輪時，cc 可能把早期訊息壓縮成 summary，順便把 /intl marker 也壓沒了。發生後再打一次 /intl 就好。
  • CC 在非 first-party host 會自動關掉 ToolSearch。設 ENABLE_TOOL_SEARCH=auto 把 deferred MCP 載入打開。proxy 不動 tool_reference block 所以這樣安全。
  • 翻譯不是免費：Gemini Flash 很便宜但不是零成本。重度使用者要監控花費，failover 機制可以分散到多個 provider。

測試

uv run pytest -v

License

MIT — 見 LICENSE。

Yorumlar (0)

Sonuc bulunamadi