chenchenandClaude Opus 4.8
2500f17189
客户端 #25/#55:A2A 直连方需 Manager 在 agent endpoint 元数据给出安全通道信息,才能在 生产强制 HTTPS。agent 对象(列表/详情/部署/状态返回)新增 security: - scheme: http | https(从 subdomain 推断) - security_profile: none | tls(显式 https→tls;http 或裸主机→none) - secure: profile != none 保守口径:无法确证 TLS 即 none,宁可客户端在生产拒绝也不回传"看似安全"的明文端点。 客户端置 HEICODE_AGENT_REQUIRE_SECURE=1 即据此强制(secure=false→拒绝)。AM 上 HTTPS/mTLS listener(azgy)后 profile 自动变 tls,客户端无需改包。元数据不含任何 secret_ref。 纯函数 agentEndpointSecurity + 单测;文档 §5/§6 更新。Manager only,无计费/审计改动。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Heicode Docs
当前 docs/ 只保留五类主线文档：
| 文档 | 用途 |
|---|---|
heicode.md |
Heicode 当前产品定位、系统边界和架构共识 |
plan.md |
按当前共识拆出的实施计划 |
heicode-runtime-auth-newapi-secret-design.md |
用户输入、登录用户复用、NewAPI 扣费映射、Azure Key Vault 凭证托管与短期凭证注入边界 |
integration/heicode-hm-template-agent-model.md |
当前模型：模板 Agent + 客户端直连，HM 端后端/前端改造说明 |
integration/heicode-hm-legacy-teardown.md |
旧 sub 任务编排模型的代码/表/前端删除清单 |
integration/heicode-desktop-client-api.md |
桌面客户端对接 HM（模板 Agent 模型），已生产验证 |
integration/heicode-am-contract.md |
HM ↔ AM（agent_management）接口契约 |
integration/heicode-swarm-deferred.md |
蜂群（Swarm）现状裁定与后续跟踪入口：HM 当前不实现 swarm runtime，旧 sub/蜂群文档作废后的上下文迁移映射与归属（AM/Swarm 侧） |
integration/telemetry-production-enablement-checklist.md |
客户端错误遥测生产开启前置 Checklist（#44 定稿）：代码侧控制核验、生产配置、隐私/法务签字硬前置、上线/回滚验证；开启 HEICODE_TELEMETRY_ENABLED 前必过 |
deployment/azure-production-deploy-guardrails.md |
Azure VM / PostgreSQL / Redis / Agent / NewAPI 生产部署前的安全守卫、环境变量注入和验证计划 |
旧 Agent API 草案、旧 sub / 蜂群任务编排、旧里程碑、旧架构说明和旧上手材料不再作为实施依据（相关文档已删除）。蜂群相关文档的作废/迁移映射与「HM 不实现 swarm runtime、新能力归 AM/Swarm 侧跟踪」的结论见 integration/heicode-swarm-deferred.md（删除≠丢上下文，迁移到此追踪入口）。 当前实施模型以 heicode.md、plan.md 与 integration/heicode-hm-template-agent-model.md 为准；生产部署操作以安全守卫文档约束，且不得覆盖产品/架构主线。
代码中的过渡期命名、旧接口注释或旧 UI 文案只作为现状参考；若与 heicode.md / plan.md 冲突，应先更新实现或另行补充当前主线文档，不得恢复旧 Agent/M1-M5 草案作为依据。