web-statics/README.md

JSKCloud / SCCK 静态站

两个网站分别位于 jskcloud/ 和 scck/，各自包含完整 HTML、CSS、JS、图片、字体和三语页面。可将任意一个目录独立复制到 nginx 服务器，不需要另一站点或项目根目录中的工具文件。

jskcloud/                  JSKCloud 独立站点根目录
  index.html               默认英文首页
  assets/                  本站全部静态资源
  en/                      英文页面
  zh-cn/                   简体中文页面
  zh-hk/                   繁体中文页面
  docs/ news/ announce/    文档、新闻、公告详情
  404.html
  nginx.conf.example       独立域名部署示例
  site-manifest.json       页面映射、采集时间及源站异常记录
scck/                      SCCK 独立站点根目录，默认简体中文
scripts/                   重新采集、生成、验证工具；部署时无需上传

部署

分别将 jskcloud/、scck/ 放到服务器的 /var/www/jskcloud 和 /var/www/scck，使用各自目录内的 nginx.conf.example 配置，并根据服务器调整 root 和 server_name。已有 HTTPS 配置可沿用证书部分，把静态目录和 location 规则合并到现有 server 中。

如果要在同一个域名的 /jskcloud/、/scck/ 下访问，使用根目录的 nginx-subdirectories.conf.example。页面和资源均使用相对路径。

nginx 的 http 配置应包含系统 mime.types。上线前执行 nginx -t 检查配置，再按服务器原有方式重新加载 nginx。不要配置 PHP 转发、API 反向代理或 SPA 首页兜底。

静态功能

• 首页、公开导航页、公开新闻/公告分类及详情、文档目录及详情均生成本地 HTML。
• 简体、繁体、英文均预生成；切换语言会跳转到同一页面的对应译文，不调用在线翻译。
• 云服务器入口指向只读的 cloud.html，显示公开参数及起售价；不提供配置提交、购物车或购买功能。
• 登录、注册、会员中心、充值、工单提交等入口已移除。后台及不存在的地址返回 HTTP 404。
• 菜单、轮播、展示筛选、文档本地搜索、图片预览在浏览器中运行。联系链接仍可由用户主动打开。
• 内容和价格为采集时快照；不会自动更新。译文使用本地词典，技术型号、参数、金额保留原值。

本地预览与维护

部署成品无需安装依赖。仅重新生成或运行验证工具时需要 Node.js、curl 和项目依赖：

npm ci
PLAYWRIGHT_BROWSERS_PATH=0 npx playwright install chromium
# 如系统缺少 Chromium 运行库，按 Playwright 提示安装对应系统依赖。
npm run preview
# 浏览 http://localhost:4173/jskcloud/ 和 http://localhost:4173/scck/

# 也可单独预览任意站点：
node scripts/preview.mjs jskcloud 4174
node scripts/preview.mjs scck 4175

# 需要联网，仅访问源站的公开内容：
npm run capture
npm run build

# 或仅更新一个站点：
node scripts/capture.mjs jskcloud
node scripts/build.mjs jskcloud

# 无需外网的本地检查：
npm run verify
node scripts/verify.mjs --static-only

scripts/locales/en.json 保存英文译文，可以校订后重新生成。采集缓存位于 .cache/；capture --refresh 可重新获取源站页面和内容数据。验证报告与桌面/手机截图位于 test-results/。

原站失效页面和资源记录在各站 site-manifest.json 中。可由公开内容重建的分类页会生成正常静态列表；已失效的装饰图片和未使用的支付图标引用会清理，不生成虚构图片或内容。