锁定版本与复现方式

这不是“采用全部最新版本”的承诺，而是对本次代码采用的组合进行固定和验证。升级任何一项后需要重新运行与其边界有关的测试。

组件	交付配置/实测
Python	Docker基线3.12.14；当前实际Python3.12.14
LangGraph	1.0.10
LangGraph Checkpoint Postgres	3.2.0
Pydantic	2.14.2
FastAPI	0.162.0
psycopg	3.3.7
HTTPX	0.28.1
Pillow	12.3.0
PostgreSQL/pgvector	Compose pgvector/pgvector:0.8.1-pg16；当前原生验证PG16.2、pgvector0.8.1
VitePress	1.6.4
Mermaid	11.12.0；vitepress-plugin-mermaid2.0.17
Node	部署建议22；当前实际24.22.1
FFmpeg	容器由Debian包安装；当前验证的具体版本保存在evidence/environment.json

Python的直接依赖在system/requirements.in，完整传递依赖及hash在requirements.lock；Docker使用pip --require-hashes。网站使用package-lock.json和npm ci。基础镜像采用版本标签而非digest，Debian系统包也没有快照锁定，故不声称字节级完全可复现；生产发布应追加镜像摘要和包来源快照。

修改依赖后，应更新锁文件并保留升级说明；LangGraph/checkpointer更新特别需要跑人工暂停、进程被杀和节点副作用重放测试。不要直接在运行容器里临时pip install然后忘记记录。