website/AGENTS.md

Website Instructions

项目定位

• 本项目是虫虫出海品牌官网，订单与客户只包含品牌展示、服务介绍以及注册和登录入口。
• 官网负责获客、建立信任和引导转化，不实现客户工作台、内部管理、订单操作或仓库作业。
• 业务能力通过清晰入口跳转到对应应用；不要为了少一次跳转在官网复制受保护业务流程。

当前阶段门禁

• 当前尚未确定框架、渲染模式、内容管理方案、部署平台和监测方案。
• 选型前不创建正式脚手架或引入依赖。决策必须考虑 SEO、首屏性能、内容维护、国际化、表单安全、可访问性和部署成本。
• 技术方案确认后先更新 README.md、依赖清单和本文件，记录准确的开发、检查、测试、构建和预览命令。

内容与信息架构

• 页面围绕访客问题组织：我们是谁、提供什么服务、适合谁、如何开始以及如何获得帮助。
• 重要服务能力必须使用可核验的业务表述，不编造客户案例、资质、报价、时效或服务覆盖范围。
• 注册和登录链接必须指向明确环境下的客户入口；外部链接、联系方式和表单提交应有失效与错误处理。
• 将可复用内容、结构化元数据和页面表现分离，避免把频繁更新的运营文案散落在组件逻辑里。
• 若引入多语言，使用稳定键和完整回退策略，不在模板中并存难以维护的语言分支。

体验、SEO 与安全

• 采用真实品牌资产和统一视觉令牌；不擅自生成或替换 Logo，不用表情符号充当功能图标。
• 保持语义化标题层级、键盘导航、可见焦点、图片替代文本、足够对比度和减少动画偏好。
• 优先保证移动端与低速网络体验，控制图片、字体、脚本和第三方标签；避免阻塞首屏的非必要依赖。
• 每个公开页面设置准确的标题、描述、规范链接和分享元数据；结构化数据必须与可见内容一致。
• 表单进行客户端体验校验和服务端安全校验，具备防滥用、提交中、成功、失败和隐私说明；不在前端暴露密钥。
• 分析与营销脚本必须经过明确批准，并遵守同意、隐私和性能约束。

质量门禁

• 技术设施建立后，至少检查构建、链接、表单、响应式布局、键盘操作、核心可访问性和核心 Web 性能指标。
• 对主要页面做真实移动设备与桌面浏览器验证，覆盖慢网、图片失败和脚本失败的降级表现。
• 当前没有可执行工程命令，不得声称自动化检查已通过；脚手架完成后立即在本文件补齐真实命令。