rebuild-shared

name	rebuild-shared
description	Rebuild the NyaaChat shared-character backend (nyaachat-shared, port 5107) Docker image and restart its container, independently of the frontend. Use whenever shared-server code, its Dockerfile, or docker-compose.shared.yml changes. Runs rebuild-shared.py — a cross-platform Python script that works on Windows, Linux, and macOS.

rebuild-shared

重新编译并重启共享角色后端（nyaachat-shared，端口 5107）。它与前端 （rebuild skill）相互独立，分别重启维护。

触发场景

• 改动了 shared-server/ 下的后端源码、shared-server/Dockerfile、package.json。
• 改动了 docker-compose.shared.yml。
• 用户要求"重启共享后端"、"rebuild shared"、显式 /rebuild-shared。

注意：仅改动 nginx.conf 的 /api/shared/ 反代或主 docker-compose.yml 的网络 配置时，要重启的是前端容器（用 rebuild skill），不是本后端。

执行方式

所有平台统一使用 Python 脚本：

python rebuild-shared.py

无缓存重建：

python rebuild-shared.py --no-cache

依赖仅需系统自带 Python 3.8+ 解释器与 docker CLI，不引入额外运行时。

外部网络

脚本会在构建前确保 external 网络 nyaachat-net 存在（不存在则创建）。该网络由本后端 与主前端 compose 共享，使主 nginx 能反代 /api/shared/ → nyaachat-shared:5107。

数据落盘

sqlite 数据库与封面图通过 bind mount 落到宿主大盘 E:\DockerRes\nyaachat-shared\{db,covers}（可用 SHARED_DB_DIR / SHARED_COVERS_DIR 覆盖）。rebuild 不影响这些持久化数据。

缓存策略

默认使用 Docker layer cache。仅在升级 base image、怀疑缓存损坏或用户明确要求 "完全重建"时追加 --no-cache。

验证

构建后访问 http://<host>:3095/api/shared/health 或容器直连 http://<host>:5107/health，应返回 { "ok": true, "db": "ok" }。