补齐客户端埋点环境变量示例

补充本地、生产及容器的埋点 origin 配置示例和 dev/release 说明。同步技术方案中的运行时配置入口与地址匹配要求。
2026-09-22 16:14:05 +00:00
parent 1e186369c9
commit 85f2831f16
4 changed files with 16 additions and 0 deletions
@@ -611,6 +611,7 @@ session.json 是本地恢复元数据，不是待上传事件；事件文件不
 - 批次与所有事件的 user_id 必须相同且等于鉴权主体；匿名、未知 origin 批次不上传，不补认领到后来登录的账号。
 - destination_origin 必须匹配当前服务部署的可信公开 origin 配置，不使用未经信任的 Host 头作为判据。
 - 接收端配置 `GENARRATIVE_AGC_ANALYTICS_ORIGIN` 为规范 origin（无路径和尾部斜杠）：正式站 `https://www.genarrative.world`，测试站 `https://dev.genarrative.world`，本地联调填写客户端实际连接的 loopback origin。未配置/非法配置时接口返回 503，不猜测默认站点；允许 HTTPS 和本地 loopback HTTP。
+- 该变量在 API Server 运行时注入，修改后重启服务；客户端与管理后台无需新增埋点构建变量。配置示例见根目录 `.env.example`（本地默认 `http://127.0.0.1:8082`）、`deploy/env/api-server.env.example`（release，并注明 dev 值）与 `deploy/container/api-server.env.example`（compose 默认宿主机入口 `http://127.0.0.1:18080`）。实际端口、映射或域名变化时同步修改，始终与客户端登录地址一致。
 - 复用现有事件版本、枚举、字段长度与必填 nullable 校验；批内重复 event_id、未知字段或非法事件整批拒绝。
 - 本接口不进入普通成功路由 tracking 映射，不为每次上传另生成主站产品事件。