# JSKCloud / SCCK 静态站

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

```text
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 和项目依赖：

```bash
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` 中。可由公开内容重建的分类页会生成正常静态列表；已失效的装饰图片和未使用的支付图标引用会清理，不生成虚构图片或内容。