门禁兼容修复

This commit is contained in:
andy committed 2026-09-05 17:36:23 +08:00
1 parent f60b416949
commit 801c0af692
18 files changed
+257 -87

No files matched your search

+12 -9
View File
@@ -4,14 +4,14 @@
| --- | --- |
| 最近更新 | 2026-09-05 |
| 当前分支 | `main` |
| 当前阶段 | 对话、SuperAgent、空间 MCP 与测试环境容器部署基线已完成;目标机首次构建排障中 |
| 当前重点 | 解决目标服务器访问 Go module proxy 超时,完成容器启动后再验证公网链路 |
| 当前阶段 | 对话、SuperAgent、空间 MCP 与测试环境容器部署基线已完成;目标机镜像构建成功,Chat 短凭证兼容方案已完成并待部署 |
| 当前重点 | 部署默认关闭的 Chat 短凭证兼容开关,完成容器启动后再验证 health 与公网链路 |
## 1. 当前 Checkpoint
- 名称:`fire-safety-ymd-test-server-build-network-recovery`
- 状态:In Progress
- 目标:在不关闭 Go module 校验的前提下,让 Docker 构建可显式选择目标服务器可达且经认可的模块代理,完成 `/home/firee-safety-ymd` 首次镜像构建与容器启动。
- 目标:在不关闭 Go module 校验的前提下,让 Docker 构建可显式选择目标服务器可达且经认可的模块代理,并处理已交付旧 Chat 短凭证的受控兼容,完成 `/home/firee-safety-ymd` 容器启动。
- 非目标:替用户提交或推送 Git、直接修改远程服务器、创建数据库容器、迁移生产数据、签发证书、改变 DNS/安全组、实现真实用户认证、动态授权、会话持久化或生产审计。
当前进展:
@@ -29,13 +29,13 @@
- Compose 配置不包含明文 Secret,且没有数据库容器、数据卷或迁移命令;现有业务数据库不会被部署动作重建。
- Nginx 上游固定为宿主机回环地址,兼容 Chat SSE 禁用缓冲和自动重试,未列出路径固定 404。
- 目标机执行步骤包含不渲染 `.env` 内容的 Compose 检查、`nginx -t` 前置门禁和可恢复的配置替换。
- 目标服务器已开始部署:Nginx 配置语法检查通过,但 Docker 构建在 `go mod download` 阶段因访问 `proxy.golang.org:443` 超时而停止,应用尚未监听 16587。
- 目标服务器已开始部署:Nginx 配置语法检查通过,Docker 镜像已构建成功;容器启动日志显示 `FIRE_SAFETY_CHAT_AUTH_TOKEN` 未通过默认至少 32 字符门禁而反复重启,`16587/health` 尚未验证。
## 2. 当前优先级
1. 为 Docker build 配置目标服务器实际可达、经运维认可的 Go module proxy,保留 `go.sum`/checksum database 校验并重新构建。
1. 由用户审查、提交并部署显式 legacy 兼容开关;仅在已交付旧 Chat 短凭证的受控测试/迁移窗口开启,并确保轮换后恢复关闭。
2. 由用户审查本 checkpoint 变更后提交并推送 `origin/main`;服务器只部署明确提交的 revision。
3. 在 `/home/firee-safety-ymd` 构建并启动 Compose,确认宿主机 16587 只绑定回环地址、容器内 8080 健康可达且数据库连接正常。
3. 在 `/home/firee-safety-ymd` recreate Compose,确认宿主机 16587 只绑定回环地址、容器内 8080 健康可达且数据库连接正常。
4. reload 已通过语法检查的 Nginx 配置,只公开 HTTPS 兼容路径、`/mcp` 和可选 `/health`。
5. 使用项目专属测试 Key 和已发布消防 Profile 做兼容 `completion` 首轮/多轮真实冒烟,核对最终回答、用量和会话复用。
6. 为所有查询表补齐适用 GiST 索引并验证查询计划;当前小数据可做联调,但生产前必须完成索引与并发验证。
@@ -72,9 +72,10 @@
- 除防火网格外 7 张表缺少 GiST 几何索引;当前 geography 距离表达式的生产索引方案需根据实库查询计划确认。
- 水源/设施 `syzt`、水源 `hc_datetime` 等字段的枚举、单位、时区和更新责任人尚未确认。
- SuperAgent MCP 的公网/内网 URL、TLS、网络白名单、Header 行为、Token 注入和轮换尚未联调。
- `/api/chat` 静态 Bearer 和兼容路径 `xtoken` 只适用于受控联调,浏览器用户可以看到它;真实用户身份、动态授权、生产速率限制和滥用防护尚未实现。
- `/api/chat` 静态 Bearer 和兼容路径 `xtoken` 只适用于受控联调,浏览器用户可以看到它;真实用户身份、动态授权、生产速率限制和滥用防护尚未实现。Chat 短凭证仅可通过默认关闭的显式 legacy 开关在受控测试/迁移窗口使用,MCP Token 仍要求至少 32 个可打印 ASCII 字符,三种凭证必须不同。
- 目标公网机器的 Docker/Compose 和 Nginx 版本、配置 include 层级、证书、DNS、安全组及 PostgreSQL 网络拓扑尚未完整验证;用户已开始远程部署,仓库资产与服务器现场配置仍需完成一致性核验。
- 目标服务器可以拉取 Docker 基础镜像元数据,但连续两次访问 `proxy.golang.org:443` 均在约 91 秒后超时;当前不能据此判断替代代理、GitHub direct 或所有外部 HTTPS 都不可达。
- 目标服务器此前连续两次访问 `proxy.golang.org:443` 均在约 91 秒后超时,随后已通过可达的构建路径完成 Docker 镜像构建;该事实不代表所有外部 HTTPS 都可达。
- 目标机当前容器因 `FIRE_SAFETY_CHAT_AUTH_TOKEN` 为已交付短凭证而未通过默认配置门禁,反复重启;`curl http://127.0.0.1:16587/health` 因服务未稳定监听而返回 connection refused。仓库已加入 `FIRE_SAFETY_CHAT_ALLOW_LEGACY_SHORT_TOKEN` 显式兼容方案,待用户提交并部署;公网 HTTPS、reload 和健康检查均尚未验证。
- Chat 会话只在单个 Go 进程内存中保存;重启或多实例切换会丢失上下文,且当前没有历史查询、持久审计或主动取消 Provider Run。
- 当前 `all`/`town_allowlist` 都是服务账号静态范围,不是最终用户级授权;`all` 会授权当前数据库中 MCP 固定查询表内所有镇街和镇街字段为空的记录,身份提供方、角色、租户和精确位置权限尚未确定。
- 地名搜索是无索引的有界包含匹配;真实数据量下的耗时、重名率和名称字段质量尚未验证,生产优化可能需要标准地名表、别名词典或 `pg_trgm` 索引。
@@ -103,12 +104,14 @@
- `GOCACHE=/private/tmp/fire-safety-go-cache go test -count=1 ./...`:通过;新增覆盖兼容 App ID、`xtoken`、CORS、严格请求子集、`null -> stop` SSE、会话复用映射、用量/模型名、错误脱敏和路由/应用装配;原有 Chat、SuperAgent、MCP/PostGIS 覆盖继续通过。
- `GOCACHE=/private/tmp/fire-safety-go-cache go vet ./...`:通过。
- `GOCACHE=/private/tmp/fire-safety-go-cache go test -race -count=1 ./...`:通过。
- Chat legacy 短凭证回归:默认仍拒绝少于 32 个字符的 Chat Token;仅在 `FIRE_SAFETY_CHAT_ALLOW_LEGACY_SHORT_TOKEN=true` 时接受非空、最多 4096 字节且仅含 ASCII `0x21-0x7e` 的短值;原生与兼容入口均通过,MCP 至少 32 字符和三凭证分离门禁保持不变。
- 模拟 SuperAgent Chat 端到端:原生与兼容入口均通过;应用创建 Provider Session、发送消息、解析严格完成事件,原生返回 `conversation/message/done`,兼容入口返回 `result` 且最终 `finish_reason=stop`。
- Nginx:配置已完成静态检查且未包含真实 Secret;开发机未安装 Nginx。据用户截图,目标机 `nginx -t` 已通过,reload 和 HTTPS 实际响应尚未验证。
- Docker/Compose:部署文件已通过 YAML/静态安全断言;开发机未安装 Docker。目标机已发起真实构建但未生成镜像,`docker compose config --quiet`、健康状态和运行容器仍待现场确认。
- Docker/Compose:部署文件已通过 YAML/静态安全断言;开发机未安装 Docker。目标机后续 Docker 镜像构建已成功,但容器因 Chat 短凭证默认门禁反复重启;`docker compose config --quiet`、稳定健康状态和公网运行容器仍待现场确认。
- 构建代理回归检查:修复前静态反馈命令返回 `RED: Docker build has no configurable GOPROXY`;修复后确认 Compose build arg、Dockerfile `GOPROXY` 和运行容器清空边界,返回 GREEN。
- `CGO_ENABLED=0 GOOS=linux go build -buildvcs=false -trimpath ./cmd/server`:通过,生成 Linux 静态服务二进制;不替代目标机真实 Docker build。
- 目标机首次 Docker 构建:失败;`go mod download` 获取 `github.com/jackc/pgpassfile@v1.0.0` 时连接 `proxy.golang.org:443` 超时,镜像/容器未生成,随后 `curl http://127.0.0.1:16587/health` 得到 connection refused,符合前置构建失败。
- 目标机后续 Docker 构建:成功;但 `docker compose logs --tail=100 api` 报 `FIRE_SAFETY_CHAT_AUTH_TOKEN must contain at least 32 printable ASCII characters`,容器因配置校验失败重启,故 `curl http://127.0.0.1:16587/health` 仍未形成通过证据。
- 目标机 Nginx:用户截图显示 `nginx -t` 配置语法检查成功;是否已 reload 以及 HTTPS 实际响应仍待确认。
- SRID 迁移预检:通过;使用临时 `admin` 连接确认 4,048 条候选、8 表 UPDATE 权限和 7 表 ALTER 权限,未输出 DSN 或业务记录。
- SRID 数据迁移:通过;事务更新 4,048 条非空几何,7 张二维表改为 `geometry(Geometry,4326)`,防火通道保持裸 `geometry`,迁移前后几何载荷指纹与维度一致。