双会话并行提交时，各自只暂存本目录文件，提交前核对暂存区；提交信息文件放仓库外，多行用 -F，禁用 git commit -a，index.lock 冲突重试不删锁。源码由 git 保护，提交钩子自动推送到本地裸仓库和 NAS 私有 Gitea，改完应尽快提交。.env 及凭据不入库，只更新脱敏示例；release 包不入库，frontend/dist 保留 gitkeep。内网 Gitea 需绕过系统代理，发布附件用 Node 脚本而非 curl.exe。

环境变量配置分两份模板：根 .env.example 69 项用于本机开发，deploy/cloud/.env.example 202 项用于云生产，含证书、DDNS、反代、转发、备份、告警及 compose 变量，不可混用。优先级为环境变量>.env>代码默认，约 60 项可在 Web 热改。上线前须改 JWT_SECRET、TOKEN_SALT、32 字节 CONFIG_ENCRYPT_KEY、ADMIN_PASSWORD、数据库密码，并保持 ALLOW_PRIVATE_UPSTREAM、BACKUP_INCLUDE_SECRETS 为 false。Halo 实际运行 Pro 2.26.1，镜像 tag 2.26 是滚动标签，锁定或回滚应按 digest；Halo 与 PostgreSQL 15.4 容器健康，端口 28090->8090，内网与公网健康检查均 200。