#!/usr/bin/env bash # # pack-jnpf-assets.sh —— 打「JNPF 通用资产包」(静态前端 + 示例数据库) # # 🔴 为什么单独一个包(2026-11-06 定的分发模型): # 这两样东西**跟部署环境、目标平台、sspf 版本、rust 工具链都无关**, # **只跟 JNPF 版本有关**: # · web/ = 官方 JNPF 7.0 web 前端的构建产物(纯静态文件,任何 OS/CPU 都能托管) # · db/ = 官方 JNPF 7.0 初始库(jnpf_dbnull_init.sql)按本仓契约裁出的示例数据 # ⇒ 不该塞进 `sspf-vX.Y.Z-.tar.gz`(那个包按 sspf 版本 × 目标平台出, # ABI 锁 rustc)。资产包**一份**即可被所有 sspf 版本 / 所有平台 / 所有环境复用。 # # 包结构: # jnpf-7.0-assets/ # ├── manifest.json # 🔴 版本绑定声明 + 来源 sha256 + 全树摘要 + 消费方式 # ├── README.md # 解包即用(SSW_ASSETS_DIR 一个 env 搞定) # ├── SHA256SUMS # 每个文件的 sha256(含 web/ 全量) # ├── web/ # 官方前端静态产物(同源托管,免 node/pnpm) # │ └── api/file/Image/ # 官方数据库/AI 图标(14 张,供 /api/file/Image/** 同源返回) # ├── db/ # │ ├── demo_seed.sql # 示例数据(58 表 / 14242 行,INSERT 幂等) # │ ├── schema.sql # 本仓实际使用的官方 DDL(裁列规则的依据) # │ └── SOURCE.md # 官方 init SQL 是哪个文件、怎么裁的 # └── tools/gen-demo-seed.py # 生成器副本(可从官方 init SQL 复现 demo_seed.sql) # # 用法: # bash scripts/pack-jnpf-assets.sh # 用现有 dist/web + db 出包 # bash scripts/pack-jnpf-assets.sh --rebuild-web # 先重构建官方前端 # bash scripts/pack-jnpf-assets.sh --web # 指定已有静态产物目录 # bash scripts/pack-jnpf-assets.sh --version 7.0 # 指定 JNPF 版本(默认 7.0) # bash scripts/pack-jnpf-assets.sh --publish # 出包并发布到 Gitea Release # # 🔴 **发布与 sspf 发版解耦**:资产包发到独立 release `jnpf-assets-`, # 不在 `vX.Y.Z` 平台包 release 下。同名 asset 先删后传 ⇒ 重出包可幂等覆盖; # 同时上传 `.sha256` 校验文件。tag 不存在时先推轻量 tag(指向当前 HEAD)。 # # 环境变量: # JNPF_VERSION 默认 7.0 # JNPF_INIT_SQL 官方初始库路径(只用于记录来源 sha256,不随包分发) # WEB_OUT 已有静态产物目录(默认 dist/web) # ASSETS_OUT 打包输出目录(默认 dist) # GITEA_URL 默认 http://127.0.0.1:13300 # GITEA_REPO 默认 ssw/ssw-platform # GITEA_USER / GITEA_PASS 不给则从 git credential 取 # set -euo pipefail cd "$(dirname "$0")/.." REPO_ROOT="$(pwd)" VERSION="${JNPF_VERSION:-7.0}" WEB_DIR="${WEB_OUT:-${REPO_ROOT}/dist/web}" OUT="${ASSETS_OUT:-${REPO_ROOT}/dist}" INIT_SQL="${JNPF_INIT_SQL:-/Users/xs/Desktop/workspace/jnpf/7.0/database/PostgreSQL/jnpf_dbnull_init.sql}" REBUILD_WEB=0 PUBLISH=0 while [[ $# -gt 0 ]]; do case "$1" in --publish) PUBLISH=1; shift ;; --rebuild-web) REBUILD_WEB=1; shift ;; --web) WEB_DIR="${2:-}"; shift 2 ;; --version) VERSION="${2:-}"; shift 2 ;; -h|--help) sed -n '1,40p' "$0"; exit 0 ;; *) echo "未知参数: $1" >&2; exit 1 ;; esac done PKG="jnpf-${VERSION}-assets" PKG_DIR="${OUT}/${PKG}" TAR="${OUT}/${PKG}.tar.gz" echo "==> JNPF 通用资产包: ${PKG}" echo " 与 sspf 版本 / OS / CPU / rust 工具链 / 部署环境无关,只绑定 JNPF ${VERSION}" # ── 1. 前置检查 ─────────────────────────────────────────────── if [[ "${REBUILD_WEB}" == "1" ]]; then echo "==> 重新构建官方前端(build-web.sh)" bash "${REPO_ROOT}/scripts/build-web.sh" fi if [[ ! -f "${WEB_DIR}/index.html" ]]; then echo "!! 缺少静态前端产物: ${WEB_DIR}/index.html" >&2 echo " 先跑: bash scripts/build-web.sh 或 bash scripts/pack-jnpf-assets.sh --rebuild-web" >&2 exit 1 fi SEED="${REPO_ROOT}/src/backend/db/demo_seed.sql" SCHEMA="${REPO_ROOT}/src/backend/db/schema.sql" GENERATOR="${REPO_ROOT}/scripts/gen-demo-seed.py" for f in "${SEED}" "${SCHEMA}" "${GENERATOR}"; do if [[ ! -f "${f}" ]]; then echo "!! 缺少资源: ${f}" >&2; exit 1; fi done # 官方 init SQL 只用于记录来源摘要;找不到不阻塞(换台机器出包时常见)。 if [[ ! -f "${INIT_SQL}" ]]; then echo "!! 提示:找不到官方初始库 ${INIT_SQL}(manifest 里来源 sha256 记为 null)" >&2 INIT_SQL="" fi # ── 2. 组装目录(旧目录移到 /tmp,不 rm -rf)────────────────── if [[ -d "${PKG_DIR}" ]]; then DEST="/tmp/old_${PKG}_$(date +%s)" mv "${PKG_DIR}" "${DEST}" echo "==> 旧目录已移走: ${DEST}" fi mkdir -p "${PKG_DIR}/web" "${PKG_DIR}/db" "${PKG_DIR}/tools" rsync -a --exclude '.DS_Store' "${WEB_DIR}/" "${PKG_DIR}/web/" cp "${SEED}" "${PKG_DIR}/db/demo_seed.sql" cp "${SCHEMA}" "${PKG_DIR}/db/schema.sql" cp "${GENERATOR}" "${PKG_DIR}/tools/gen-demo-seed.py" # ── 2.5 官方文件图标(`/api/file/Image/**`)──────────────────── # 官方前端把数据库类型 / AI 模型图标放在 `/api/file/Image/**`(官方后端 302 到文件服务)。 # 同源静态托管没有文件服务 ⇒ 之前这些 URL 全返信封 404(图标不显示 + 控制台报错)。 # ⇒ 资产包把官方 jnpf-resources 的 14 张图入仓后放到 `web/api/file/Image/`, # 后端 fallback 的精确白名单命中即返文件(见 routes.rs::fallback_response)。 FILE_IMAGES="${REPO_ROOT}/src/backend/assets/jnpf-7.0/file-images" IMG_DST="${PKG_DIR}/web/api/file/Image" if [[ -d "${FILE_IMAGES}" ]]; then mkdir -p "${IMG_DST}" for d in databaseicon AiFile aimodelicon; do if [[ -d "${FILE_IMAGES}/${d}" ]]; then mkdir -p "${IMG_DST}/${d}" cp "${FILE_IMAGES}/${d}"/*.png "${IMG_DST}/${d}/" fi done IMG_N="$(find "${IMG_DST}" -type f | wc -l | tr -d ' ')" echo "==> web/api/file/Image/ ${IMG_N} 张官方图标(数据库 6 / AI 8)" else IMG_N=0 echo "!! 缺少 ${FILE_IMAGES} —— 资产包不含官方图标(相关页面图标会 404)" >&2 fi WEB_N="$(find "${PKG_DIR}/web" -type f | wc -l | tr -d ' ')" WEB_SIZE="$(du -sh "${PKG_DIR}/web" | cut -f1)" echo "==> web/ ${WEB_N} 文件 / ${WEB_SIZE}" echo "==> db/ demo_seed.sql $(du -h "${SEED}" | cut -f1), schema.sql $(du -h "${SCHEMA}" | cut -f1)" # ── 3. 生成 manifest.json(版本绑定声明 + 来源 + 全树摘要)───── export PKG_DIR WEB_DIR INIT_SQL VERSION REPO_ROOT python3 - <<'PY' import hashlib, json, os, re, sys, time root = os.environ["PKG_DIR"] version = os.environ["VERSION"] init_sql = os.environ["INIT_SQL"] def sha(path): h = hashlib.sha256() with open(path, "rb") as f: for b in iter(lambda: f.read(1 << 20), b""): h.update(b) return h.hexdigest() # 全树摘要:相对路径排序后逐文件 hash,再对「路径+hash」串做一次 hash # ⇒ 与目录时间戳/文件顺序/打包工具无关,跨平台可复算。 tree = hashlib.sha256() files = [] for base, dirs, names in os.walk(os.path.join(root, "web")): dirs.sort() for n in sorted(names): p = os.path.join(base, n) if not os.path.isfile(p): continue rel = os.path.relpath(p, os.path.join(root, "web")) d = sha(p) files.append((rel, os.path.getsize(p), d)) tree.update((rel + "\0" + d + "\n").encode()) img_dir = os.path.join(root, "web", "api", "file", "Image") img_n = 0 if os.path.isdir(img_dir): for _base, _dirs, _names in os.walk(img_dir): img_n += sum(1 for n in _names if os.path.isfile(os.path.join(_base, n))) seed_path = os.path.join(root, "db", "demo_seed.sql") seed_txt = open(seed_path, encoding="utf-8").read() # demo_seed.sql 里只有 13 张「本仓 schema 没有的示例系统表」带 DDL; # 其余表的 DDL 由 db/schema.sql 负责 ⇒ 表数要按 INSERT 涉及的表统计(58)。 ddl_tables = sorted(set(re.findall(r"CREATE TABLE IF NOT EXISTS\s+(\w+)", seed_txt))) insert_tables = sorted(set(re.findall(r"^INSERT INTO\s+(\w+)", seed_txt, re.M))) inserts = len(re.findall(r"^INSERT INTO\s+", seed_txt, re.M)) create_n = len(re.findall(r"^CREATE TABLE", seed_txt, re.M)) manifest = { "pack": os.path.basename(root), "schema_version": 1, "jnpf_version": version, "built_at": time.strftime("%Y-%m-%dT%H:%M:%S%z"), "binding": { "depends_on": ["jnpf " + version], "independent_of": [ "sspf_version", "os", "cpu_arch", "rust_toolchain", "build_target", "deployment_env", "database_runtime", ], "note": "同一 JNPF 版本只出一份;任意 sspf 版本 / 平台 / 环境直接复用,无需重编二进制。", }, "source": { "web": { "kind": "official JNPF web frontend build output", "build": "pnpm run build:main (@jnpf/main)", "build_script": "scripts/build-web.sh", }, "database": { "kind": "official JNPF init SQL (demo data)", "file": os.path.basename(init_sql) if init_sql else None, "path": init_sql or None, "sha256": sha(init_sql) if init_sql else None, "bytes": os.path.getsize(init_sql) if init_sql else None, }, }, "contents": { "web": { "files": len(files), "bytes": sum(x[1] for x in files), "tree_sha256": tree.hexdigest(), "entry": "index.html", "api_base": "", "note": "API 前缀为空 ⇒ 与后端同源托管,请求 /api/* 打到同一进程。", "file_images": { "files": img_n, "path": "web/api/file/Image/", "note": "官方数据库类型 / AI 模型图标;后端 fallback 白名单命中 /api/file/Image/** 时返文件,避免 404。", }, }, "db/demo_seed.sql": { "sha256": sha(seed_path), "bytes": os.path.getsize(seed_path), "create_tables": create_n, "ddl_tables": len(ddl_tables), "tables": len(insert_tables), "insert_statements": inserts, "generator": "tools/gen-demo-seed.py", "note": "裁剪版(排除 5 张纯大表 + 7 张本仓自管表;3 张 ext_* 裁列;3 张大表部分保留);所有 INSERT 带 ON CONFLICT DO NOTHING ⇒ 幂等。", }, "db/schema.sql": { "sha256": sha(os.path.join(root, "db", "schema.sql")), "note": "本仓实际使用的官方 DDL,是裁列规则的依据。", }, }, "consumption": { "one_env": "SSW_ASSETS_DIR=./" + os.path.basename(root), "explicit": { "SSW_STATIC_DIR": "./" + os.path.basename(root) + "/web", "SSW_DEMO_SEED_FILE": "./" + os.path.basename(root) + "/db/demo_seed.sql", }, "disable_demo_data": "SSW_DEMO_DATA=false", "fallback": "不设任何 env ⇒ 二进制内嵌的编译期示例数据(旧行为,保持兼容)", }, "verify": "shasum -a 256 -c SHA256SUMS(在包根目录执行)", } with open(os.path.join(root, "manifest.json"), "w", encoding="utf-8") as f: json.dump(manifest, f, ensure_ascii=False, indent=2) f.write("\n") print(f"==> manifest.json(web 全树 sha256={tree.hexdigest()[:16]}…," f"示例数据 {len(insert_tables)} 表 / {inserts} 条 INSERT / {create_n} 条 CREATE)") PY # ── 4. SOURCE.md + README.md ─────────────────────────────────── cat > "${PKG_DIR}/db/SOURCE.md" < "${PKG_DIR}/README.md" < \`SSW_ASSETS_DIR\` 自动推导 \> 二进制内嵌兜底。 - 不想要示例数据:\`SSW_DEMO_DATA=false\`(纯净库)。 - 资产包路径可以是相对路径,服务启动时会按 CWD 绝对化(PGlite 会 chdir,见 config.rs)。 ## 校验 \`\`\`bash cd ${PKG} && shasum -a 256 -c SHA256SUMS | tail -1 \`\`\` ## 边界 - 本包**不含**任何可执行二进制、rlib、node_modules ⇒ 与平台 ABI 无关。 - 换 JNPF 版本 ⇒ 重新出一份资产包;换 sspf 版本 ⇒ **不用动本包**。 EOF # ── 5. SHA256SUMS(含 web/ 全量文件)─────────────────────────── python3 - <<'PY' import hashlib, os root = os.environ["PKG_DIR"] out = [] for base, dirs, names in os.walk(root): dirs.sort() for n in sorted(names): if n == "SHA256SUMS": continue p = os.path.join(base, n) if not os.path.isfile(p): continue h = hashlib.sha256() with open(p, "rb") as f: for b in iter(lambda: f.read(1 << 20), b""): h.update(b) out.append(f"{h.hexdigest()} {os.path.relpath(p, root)}") with open(os.path.join(root, "SHA256SUMS"), "w", encoding="utf-8") as f: f.write("\n".join(out) + "\n") print(f"==> SHA256SUMS({len(out)} 个文件)") PY # ── 6. 打 tar.gz + 自检 ─────────────────────────────────────── tar -czf "${TAR}" -C "${OUT}" "${PKG}" TAR_SIZE="$(du -h "${TAR}" | cut -f1)" for f in manifest.json README.md SHA256SUMS web/index.html db/demo_seed.sql db/schema.sql db/SOURCE.md tools/gen-demo-seed.py; do if ! tar -tzf "${TAR}" | grep -q "^${PKG}/${f}$"; then echo "!! 包内缺少 ${f}" >&2; exit 1 fi done ENTRY="$(tar -tzf "${TAR}" | wc -l | tr -d ' ')" echo "==> ✅ ${TAR} (${TAR_SIZE} / ${ENTRY} 项)" echo "" echo "==================================================" echo "✅ JNPF ${VERSION} 通用资产包完成" echo " 目录: ${PKG_DIR}" echo " 压缩包: ${TAR} (${TAR_SIZE})" echo " 静态前端: web/ (${WEB_N} 文件 / ${WEB_SIZE})" echo " 示例数据: db/demo_seed.sql" echo " 用法: SSW_ASSETS_DIR=./${PKG} PORT=30010 ./bin/sspf-admin" echo " 🔴 只绑定 JNPF 版本:所有 sspf 版本 / 所有平台 / 所有环境复用同一份" echo "==================================================" # ── 7. 发布(--publish):独立 release,不挂到 sspf 版本包下 ─── publish_assets() { local base="${GITEA_URL:-http://127.0.0.1:13300}" local repo="${GITEA_REPO:-ssw/ssw-platform}" local tag="jnpf-assets-${VERSION}" local user="${GITEA_USER:-}" pass="${GITEA_PASS:-}" if [[ -z "${user}" || -z "${pass}" ]]; then local cred cred="$(printf 'protocol=http\nhost=%s\n\n' "${base#http://}" | GIT_TERMINAL_PROMPT=0 git credential fill 2>/dev/null || true)" user="$(printf '%s\n' "${cred}" | sed -n 's/^username=//p')" pass="$(printf '%s\n' "${cred}" | sed -n 's/^password=//p')" fi if [[ -z "${user}" || -z "${pass}" ]]; then echo "!! 发布失败:无 Gitea 凭据(设 GITEA_USER/GITEA_PASS,或配置 git credential)" >&2 return 1 fi local -a AUTH=(-u "${user}:${pass}") # 1) release:有则复用;无则先确保远端 tag 存在,再创建(幂等重发) local code rel_id code="$(curl -s -o /tmp/jnpf_assets_rel.json -w '%{http_code}' --noproxy '*' -m 20 "${AUTH[@]}" \ "${base}/api/v1/repos/${repo}/releases/tags/${tag}" || true)" if [[ "${code}" == "200" ]]; then rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/jnpf_assets_rel.json"))["id"])')" echo "==> 复用已有 release ${tag} (id=${rel_id})" else if [[ -z "$(git ls-remote --tags origin "refs/tags/${tag}" 2>/dev/null)" ]]; then if ! git rev-parse -q --verify "refs/tags/${tag}" >/dev/null 2>&1; then git tag "${tag}" HEAD fi GIT_TERMINAL_PROMPT=0 git push origin "refs/tags/${tag}" echo "==> 已推 tag ${tag}" fi python3 - "${tag}" "${VERSION}" > /tmp/jnpf_assets_release_body.json <<'PY' import json, sys tag, ver = sys.argv[1:3] pkg = f"jnpf-{ver}-assets" print(json.dumps({ "tag_name": tag, "name": f"JNPF {ver} 通用资产包(前端 + 示例数据库)", "target_commitish": "main", "body": ( f"只绑定 JNPF {ver},与 sspf 版本 / OS / CPU / rust 工具链 / 部署环境无关;" "所有平台、所有 sspf 版本复用同一份。\n\n" f"- `{pkg}.tar.gz`:官方 web 静态产物 + 官方 init SQL 示例数据" " + manifest.json / SHA256SUMS / 官方图标\n" "- `.sha256`:整包校验;解包后 `shasum -a 256 -c SHA256SUMS` 逐文件校验\n\n" f"用法:`tar -xzf {pkg}.tar.gz` 后 " f"`SSW_ASSETS_DIR=./{pkg} PORT=30010 ./bin/sspf-admin`" ), }, ensure_ascii=False)) PY code="$(curl -s -o /tmp/jnpf_assets_rel.json -w '%{http_code}' --noproxy '*' -m 30 "${AUTH[@]}" \ -X POST "${base}/api/v1/repos/${repo}/releases" \ -H 'Content-Type: application/json' -d @/tmp/jnpf_assets_release_body.json || true)" if [[ "${code}" != "201" ]]; then echo "!! 创建 release ${tag} 失败 (HTTP ${code}): $(head -c 300 /tmp/jnpf_assets_rel.json)" >&2 return 1 fi rel_id="$(python3 -c 'import json;print(json.load(open("/tmp/jnpf_assets_rel.json"))["id"])')" echo "==> 已创建 release ${tag} (id=${rel_id})" fi # 2) 整包 sha256(消费方可先验整包再解包) local asset_name; asset_name="$(basename "${TAR}")" shasum -a 256 "${TAR}" | sed "s| .*| ${asset_name}|" > "${TAR}.sha256" # 3) 逐个上传;同名 asset 先删(幂等覆盖) local f name old_id for f in "${TAR}" "${TAR}.sha256"; do name="$(basename "${f}")" old_id="$(curl -s --noproxy '*' -m 20 "${AUTH[@]}" \ "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets" \ | ASSET_NAME="${name}" python3 -c ' import json, os, sys try: d = json.load(sys.stdin) except Exception: d = [] for a in d: if a.get("name") == os.environ["ASSET_NAME"]: print(a["id"]); break ' 2>/dev/null || true)" if [[ -n "${old_id}" ]]; then curl -s -o /dev/null --noproxy '*' -m 30 "${AUTH[@]}" \ -X DELETE "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets/${old_id}" || true echo "==> 已删除同名旧 asset ${name} (id=${old_id})" fi code="$(curl -s -o /tmp/jnpf_assets_upload.json -w '%{http_code}' --noproxy '*' -m 900 "${AUTH[@]}" \ -X POST "${base}/api/v1/repos/${repo}/releases/${rel_id}/assets?name=${name}" \ -F "attachment=@${f}" || true)" if [[ "${code}" != "201" ]]; then echo "!! 上传 ${name} 失败 (HTTP ${code}): $(head -c 300 /tmp/jnpf_assets_upload.json)" >&2 return 1 fi local dl dl="$(python3 -c 'import json;print(json.load(open("/tmp/jnpf_assets_upload.json")).get("browser_download_url",""))')" echo "==> ✅ 已发布 ${tag} / ${name} ($(du -h "${f}" | cut -f1))" echo " ${dl}" done return 0 } if [[ "${PUBLISH}" == "1" ]]; then echo "==> 发布资产包到 Gitea Release ..." publish_assets || { echo "!! 发布失败(本地包仍在 ${TAR})" >&2; exit 1; } else echo "==> 未发布(加 --publish 推到独立 release jnpf-assets-${VERSION})" fi