القائمة
改了项目代码/配置后，判断该 rebuild 哪个镜像、哪些走 HMR、.env 改动要不要重建容器。避免"改了没生效"的最常见坑。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | rebuild-after-change |
| description | 改了项目代码/配置后，判断该 rebuild 哪个镜像、哪些走 HMR、.env 改动要不要重建容器。避免"改了没生效"的最常见坑。 |
后端源码 bake 进 Docker 镜像（无 bind mount）——改了源码，运行中的容器还是旧代码，必须 rebuild 镜像才生效。前端相反（Vite dev server HMR，改完即生效）。
| 改了什么 | 怎么生效 | 命令 |
|---|---|---|
backend/app/**/*.py（后端源码） | rebuild backend 镜像 | docker compose up -d --build backend |
.env（环境变量） | 重建 backend 容器（env 进容器） | docker compose up -d backend |
docker-compose.yml（服务配置，如 redis maxmemory） | 重建对应容器 | docker compose up -d <service> |
frontend/src/**/*.vue 或 .js | Vite HMR 自动热更新，不用 rebuild | 浏览器刷新即可 |
backend/requirements.txt（依赖） | rebuild backend（重装依赖层） | docker compose up -d --build backend |
frontend/package.json（依赖） | rebuild frontend / npm install | docker compose up -d --build frontend 或本地 npm i |
| Alembic 迁移文件 | 跑迁移 | docker exec grid-backend alembic upgrade head（或 create_all 兜底） |
# 后端：rebuild 后等启动（bge 预热慢，sleep 12-20s），curl health
docker compose up -d --build backend
for i in 1 2 3 4 5 6 7 8; do
H=$(curl -s -m 5 http://localhost:8001/health 2>/dev/null|head -c10)
[ -n "$H" ] && { echo ready; break; }; sleep 6
done
# 前端：curl 编译输出确认无错 + 含新代码
curl -s http://localhost:5173/src/views/Admin.vue | grep -c "<新函数名>"
curl -s http://localhost:5173/src/views/Admin.vue | grep -ci "syntaxerror"
--build。up -d（不带 --build 也行，重建容器重读 env）。cd frontend && npm run dev（不是容器）。up -d redis 重建，但会清空内存（AOF 重载）；或 redis-cli CONFIG SET 立即生效不丢缓存。8001 backend / 5173 frontend(dev) / 3307 mysql / 6379 redis / 3000 grafana / 9090 prometheus / 7474+7687 neo4j
排查"功能静默失效"（rerank 没生效/图谱没融合/缓存没命中）时使用。项目所有降级走 DEGRADED 指标+日志，用它定位。
排查检索召回差/路由偏差/改写没效果/某文档召不出问题时使用。用 debug_search 透出每步中间结果定位。
排查问答缓存问题（不命中/脏缓存/黑名单误拦/置信度过滤/多轮不缓存）时使用。覆盖三级缓存(Redis/MySQL/Semantic)+黑名单+置信度规则。