From 6f8ed6842256997069a6ea495c14a180285ec9ce Mon Sep 17 00:00:00 2001 From: Ubuntu Date: Thu, 30 Apr 2026 18:26:33 +0000 Subject: [PATCH] chore(config): document canonical Agnet base URL from integration doc Made-with: Cursor --- heicode/.env.example | 4 +++- heicode/controller/heicode_agnet_session.go | 1 + heicode/docker-compose.azure-vm.yml | 1 + 3 files changed, 5 insertions(+), 1 deletion(-) diff --git a/heicode/.env.example b/heicode/.env.example index bf17825..440c6ef 100644 --- a/heicode/.env.example +++ b/heicode/.env.example @@ -68,7 +68,9 @@ # 会话密钥 # SESSION_SECRET=random_string -# Agnet / Heicode 身份平台 Base URL（与前端 VITE_HEICODE_AUTH_BASE_URL 一致，勿尾缀斜杠） +# Agnet / Heicode 身份 Base URL：省略时后端与 docker-compose.azure-vm.yml 均使用文档 §2.1 约定地址（与 web/default 内建默认一致）。 +# 参考：docs/integration/Heicode-登录接口对接文档.md +# 仅在自建网关与非文档地址不一致时需要覆盖： # HEICODE_AUTH_BASE_URL=https://apimtaiji.azure-api.net/api/mcp # 其他配置 diff --git a/heicode/controller/heicode_agnet_session.go b/heicode/controller/heicode_agnet_session.go index b97c22c..c96a3ed 100644 --- a/heicode/controller/heicode_agnet_session.go +++ b/heicode/controller/heicode_agnet_session.go @@ -56,6 +56,7 @@ func defaultHeicodeAuthBaseURL() string { if v := strings.TrimSpace(os.Getenv("HEICODE_AUTH_BASE_URL")); v != "" { return strings.TrimRight(v, "/") } + // 与 docs/integration/Heicode-登录接口对接文档.md §2.1 生产 Base URL 一致（前端 VITE 默认同源）。 return "https://apimtaiji.azure-api.net/api/mcp" } diff --git a/heicode/docker-compose.azure-vm.yml b/heicode/docker-compose.azure-vm.yml index bd0ea01..7d0fdb6 100644 --- a/heicode/docker-compose.azure-vm.yml +++ b/heicode/docker-compose.azure-vm.yml @@ -42,6 +42,7 @@ services: - ERROR_LOG_ENABLED=true - BATCH_UPDATE_ENABLED=true - NODE_NAME=heicode-node-1 + # 默认与 docs/integration/Heicode-登录接口对接文档.md §2.1 一致；覆盖仅用于非标准网关。 - HEICODE_AUTH_BASE_URL=${HEICODE_AUTH_BASE_URL:-https://apimtaiji.azure-api.net/api/mcp} networks: - heicode-network