rebuild

name	rebuild
description	Rebuild the NyaaLibrary-MCP Docker image and restart its container locally (no registry push). Use whenever the project needs a Docker rebuild + restart — after changes to Dockerfile, docker-compose.yml, .dockerignore, or any server/ or frontend/ source that ends up in the image. Runs rebuild.ps1 via PowerShell with -ExecutionPolicy Bypass.

rebuild

需要重新构建镜像并重启本项目容器时调用此 skill。本项目只在本地构建并运行容器，不打包推送到镜像仓库。

触发场景

• 用户明确要求“重新构建”、“重建镜像”、“重启容器”、“部署”、“rebuild”。
• 改动了 Dockerfile、docker-compose.yml、.dockerignore 等容器构建相关文件。
• 改动了 server/**、frontend/**、package.json 等会进入镜像的源码 / 依赖。
• 通过 /rebuild 显式调用。

调用方式（Windows）

本项目为 Windows 开发环境，使用 rebuild.ps1，必须带 -ExecutionPolicy Bypass：

powershell -ExecutionPolicy Bypass -File .\rebuild.ps1

用 PowerShell 工具直接执行；执行前确认工作目录为项目根目录（含 docker-compose.yml）。

关于 -ExecutionPolicy Bypass

该参数传给 PowerShell 进程本身（不是脚本参数），临时绕过本机脚本执行策略，仅对本次进程生效、不改注册表、不需要管理员权限。rebuild.ps1 是本仓库未签名脚本，在默认 Restricted 策略的机器上不加此参数会报 “running scripts is disabled on this system”。

脚本工序（已固化在 rebuild.ps1，勿手动重复）

down → build → 清理 dangling 镜像 → up -d → 列出运行容器。

• -p nyaalibrary-mcp 锁定 compose 项目名：本机同时运行着大量其它容器，项目名锁定确保 down/up/build 只作用于本项目，绝不波及他人。
• 直接构建运行、无镜像推送：compose 用本地 tag nyaalibrary-mcp:latest 构建并 up -d 起容器即可，不做 docker tag / docker push 到任何 registry。
• 数据持久化：知识库数据落在绑定挂载 ./data，down/重建不丢；只有删除 ./data 才会重置。

缓存策略

脚本默认走 Docker 层缓存（不带 --no-cache）：

• 依赖安装层（COPY package.json + npm install）只要 lockfile/清单没变就命中缓存，秒级跳过；改源码只会让对应层失效，不会“该重建却没重建”。
• 首次或冷缓存构建会编译 better-sqlite3 原生模块；前端阶段已用 npm_config_maxsockets=1 串行下载规避 Docker Desktop 并发拉取卡死（约 8 分钟，属正常，后续走缓存即可）。

确需全量重建时，临时手动加参数，不要改脚本：

docker compose -p nyaalibrary-mcp -f docker-compose.yml build --no-cache
docker compose -p nyaalibrary-mcp -f docker-compose.yml up -d

执行后汇报

简要告知：脚本是否成功、容器是否 Up、对外端口（5106，映射到容器内 5101）与访问地址（http://localhost:5106，MCP 端点 /mcp）。

不要做的事

• 不要绕过脚本直接散调 docker compose build/up/down——用脚本保证流程一致并锁定项目名。
• 不要省略 -ExecutionPolicy Bypass。
• 不要 docker tag / docker push 到 registry（本项目不需要）。
• 不要 docker system prune -a——脚本只清理 dangling 镜像，足够且安全。
• 不要随手删除 ./data（会清空全部知识库）。