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 输出下方，并包含在全文复制（copy-all）文本中。
- 将 localtunnel 网址视为临时预览，而非生产部署。
工作流程
- 使用
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。