$_ tt2-cli

推送标准

────────────────────────────────────────

所有 tt2 push 提交的产物都会经过服务端「猹询码」的审查与适配。 符合以下标准可确保一次通过;不满足标准时猹询码会尝试自动修补,修补不了则拒绝并说明原因。

基本要求

项目要求
产物形态纯静态文件:HTML / CSS / JS / 图片 / 字体等。不含任何服务端代码(PHP / Node / Python 等不会被执行,也不会被上传)
入口文件目录根部必须包含 index.html
总大小单包 ≤ 50 MB(压缩后)
单文件建议 ≤ 10 MB;超大媒体请使用外链或压缩
路径相对路径引用资源;避免以 / 开头的绝对路径指向域外资源

文件类型白名单

以下扩展名允许上传,其余类型将被猹询码剔除并在任务结果中列出:

类别扩展名
页面与样式.html .htm .css .js .mjs .map .json .xml .txt .md
图片.png .jpg .jpeg .gif .webp .avif .svg .ico
字体.woff .woff2 .ttf .otf .eot
媒体.mp3 .mp4 .webm .ogg .wav
文档与数据.pdf .zip .wasm .webmanifest

可执行脚本与服务器侧文件(.php .py .sh .env .htaccess 等)一律拒绝上传。

猹询码会做的自动修补

产物进入审查队列后,猹询码(cran-code lite)会执行:

  • 安全扫描:检测恶意脚本、挖矿代码、钓鱼表单、混淆载荷等,命中即拒绝并在任务结果中给出原因。
  • 缺失入口修补:目录中只有一个明显的入口 HTML(如 home.html)时,自动生成 index.html 跳转页。
  • 编码修正:为缺失 <meta charset> 的 HTML 注入 UTF-8 声明,避免中文乱码。
  • SPA 适配:携带 --spa 时自动写入 404 回退规则。
  • 缓存头优化:为带哈希指纹的静态资源设置长缓存,为 HTML 设置协商缓存。
  • 白名单过滤:剔除不允许的文件类型,并在 tt2 reply <task_id> 的回复中逐项说明。

所有修补都会记录在任务结果里,Agent 可通过 tt2 reply --json 读取完整报告。

常见拒绝原因

  • 缺少 index.html 且无法推断入口;
  • 压缩包超过 50 MB;
  • 包含可执行代码或恶意特征;
  • 内容违反内容政策