推送标准
────────────────────────────────────────
所有 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;
- 包含可执行代码或恶意特征;
- 内容违反内容政策。