技能介绍

要解决什么问题

做前端复刻或站点镜像时，常见难点不只是“下载 HTML”：页面可能由 JS 渲染，CSS、字体、图片可能跨域，链接仍指向原站，资源缺失后本地预览正常但上线后出现 404。Replication Agent 把这类工作压成一条可审查的流程：先确认授权，再爬取、渲染、下载资源、改写链接，并生成质量报告，最后才允许本地预览或静态部署。

技能如何工作

授权门禁：运行前要求确认用户拥有目标站点或拥有明确授权；若授权不清，会停止并等待确认；拒绝复制私有区域、绕过付费墙/认证、克隆登录支付流程、冒充其他品牌。
资源抓取与改写：scripts/replication_agent.py 负责 crawl、render、download assets、rewrite links，并产出报告。
质检输出：需要查看 quality_report.json、crawl_table.json 和 resource_table.json，判断 ready_for_release、页面成功率、CSS/JS/图片/字体/视频/文档资源是否仍然 remote 或 missing，以及内链是否仍指向源站。
本地预览与部署：scripts/serve_replica.py 用于预览聚合后的 localhost 输出；scripts/deploy_static_mirror.py 可通过 SSH 上传静态输出和 Nginx 配置。部署只在质量检查通过且用户明确要求时进行。
配置与检查单：configs/replication_agent.example.json 提供最小配置模板；references/usage.md 与 references/release-checklist.md 保存命令示例、配置细节和发布检查项。

适用边界

这个技能适合拥有权限的站点镜像、内部预览、静态站备份，不适合用来抓取未授权内容、绕过登录/支付、复制品牌资产或构造仿冒页。上线前必须把 quality_report.json 当作发布门槛：如果资源仍远程、控制台错误影响渲染、同域 404 或成功率低于阈值，就不要推荐公网部署。增量更新时可省略 --force-refresh 避免全量刷新，但核心原则仍是先授权、再复制、后验收。