JaguarTV 文案工具
維護適用於 JaguarTV 的中文轉巴西葡萄牙語文案產生器。
該工具有兩種模式：
tv：針對巴西用戶的 JaguarTV 產品推廣。generic：僅基於用戶的中文關鍵詞產生內容文案，不提及任何電視產品。
檔案
- 前端：
src/jaguartv_factory/web/copywriter.html - UI 樣式：
src/jaguartv_factory/web/copywriter.css - 客戶端產生器和後備模板：
src/jaguartv_factory/web/copywriter.js - 伺服器 API 和 Gemini 代理：
src/jaguartv_factory/dashboard.py - 測試：
tests/test_dashboard.py - 產品/工廠操作技能：
.agents/skills/jaguartv-content-factory/SKILL.md
更改行為、Gemini 整合、部署或公用存取時，請閱讀 references/tool-spec.md。
防護措施
- 絕不將
GEMINI_API_KEY或任何秘密寫死在程式碼中。僅使用環境變數。 - 瀏覽器程式碼不得包含 API 金鑰；Gemini 呼叫必須透過
/api/copywriter/generate。 - 維持
generic模式的邊界：不得輸出JaguarTV、Jarg.top、TV ao vivo、Android TV 或產品/下載網站的宣稱。 - 在
tv模式下，避免對受版權保護的頻道、價格、免費存取、保證可用性或區域覆蓋範圍做出無法驗證的承諾。 - 將中文稽核翻譯保持在 pt-BR 輸出之下，並包含在複製全部文字中。
- 將 localtunnel URL 視為暫時預覽，而非正式部署。
工作流程
- 使用
rg -n "copywriter|Gemini|GEMINI|generate_copywriter"檢查當前實作。 - 針對產生行為的變更，同時更新
dashboard.py中的 Gemini 提示/正規化以及copywriter.js中的本機後備模板。 - 對於 UI 變更，保持控制項可存取、響應式，並與現有緊湊工具佈局一致。
- 驗證方式：
python3 -m py_compile src/jaguartv_factory/dashboard.py tests/test_dashboard.py
PYTHONPATH=src python3 -m pytest tests/test_dashboard.py -q
node --check src/jaguartv_factory/web/copywriter.js
git diff --check -- src/jaguartv_factory/dashboard.py src/jaguartv_factory/web/copywriter.js src/jaguartv_factory/web/copywriter.css tests/test_dashboard.py
- 如需瀏覽器驗證，請啟動儀表板並測試兩種模式：
cd "/path/to/jaguartv-project"
PYTHONPATH="$PWD/src" python3 -m jaguartv_factory.cli ui --host 127.0.0.1 --port 8788
- 如果用戶需要暫時的公用存取，請隧穿正在運行的儀表板，而非靜態伺服器：
npx --yes localtunnel --port 8788 --local-host 127.0.0.1 --subdomain jaguartv-copywriter-ai
Gemini 預設值
當用戶想要真實模型產生時，請使用以下環境變數：
export GEMINI_API_KEY="..."
export GEMINI_MODEL="gemini-3.1-pro-preview"
export GEMINI_TIMEOUT_SECONDS="20"
後端會正規化常見的 3.1 別名，並從 gemini-3.1-pro-preview 降級至 gemini-3.1-flash-lite，然後至 gemini-2.5-flash。