# AI Gateway Go 0.10.0 clean deployment bundle

Generated on 2026-08-11 from `/home/ben/ai-gateway-go`.

Included:

- Go backend and worker source
- 21 PostgreSQL migrations
- Admin and portal Art Design Pro source
- OpenAPI contract, operations documents and legacy migration tools
- Local and production Docker Compose definitions

Excluded:

- `node_modules`, frontend `dist`, Go binaries and caches
- local `.env`, `deploy/production.env`, logs and coverage output
- database volumes, Redis data and all runtime credentials

Start with `deploy/PRODUCTION.md`. Verify the accompanying ZIP checksum before
copying the bundle to a deployment host.

## 0.11.2 — 旗舰版第三轮完善

发布时间:2026-08-13

新增功能:

- **门户通用聊天**:门户工作台新增「通用聊天」页面,选择已批准模型直接对话,
  支持会话管理(新建/改名/删除/历史)。模型权限申请审批通过后,系统自动为该
  用户开通一把 gateway API Key(加密落库 `portal_user_runtime_credentials`,
  限额取批准申请值),聊天调用经受管网关执行,认证/限流/配额/审计与外部
  API Key 完全同权;会话消息沿用哈希链完整性校验与 busy 租约防并发。
- **企微/钉钉/飞书扫码登录**:`identity_providers` 表扩展 wecom/dingtalk/feishu
  kind,管理端「账号与权限 → 扫码登录」配置身份源(AppID/AppSecret/AgentID、
  回调 URL、自动开户、默认部门)。登录页自动展示已启用身份源按钮,回调经
  one-time state 防 CSRF,支持三种平台 code 换取身份协议;未绑定账号默认
  需先在「账号安全」扫码绑定(同一平台账号全局唯一绑定),可开启自动开户。
- **个人安全策略**:门户「账号安全」页面提供登录设备管理(IP/UA/时间,可
  吊销任意非当前会话)、新设备登录提醒开关(默认开启,经 outbox → 站内信,
  可单独关闭)、扫码登录绑定/解绑。

迁移:000038_portal_chat / 000039_social_login / 000040_security_prefs /
000041_inbox_security_category(共 41 个迁移)。

安全要点:

- 扫码登录 state 为 128-bit 一次性令牌(5 分钟),回调原子消费;
  provider_uid 全局唯一,防止平台账号同时绑定多个本系统账号。
- 会话索引只存令牌 SHA-256 摘要,列表时惰性清理过期项;当前会话不可吊销。
- 登录提醒事件只落站内信,不包含凭据;开关按账号独立生效。

## 0.11.3 — 旗舰版第四轮完善

发布时间:2026-08-13

新增功能:

- **统一审批中心**:管理端「系统管理 → 审批中心」统一处理三类申请——
  模型访问、资源/渠道权限(新增 `resource_access_requests`,支持
  mcp_server/skill/digital_employee/channel)、工具使用(`tool_approval_requests`)。
  资源/渠道申请通过后自动开通(marketplace 安装 use 等级;渠道以批准记录为授权),
  门户「我的申请」可发起/撤回,审批结果经 outbox → 站内信通知双方。
- **工具治理**:工具支持「限流(RPM)」与「需审批」标记;审批标记工具首次调用
  自动发起审批并拒绝执行,管理员通过后可用;限流用 PostgreSQL 固定窗口原子
  upsert 实现,多实例共享同一额度。管理端工具中心可配置两项治理参数。
- **平台环境变量**:系统管理新增「平台环境变量」,平台级配置注入 skill/MCP
  运行时(加密存储),个人环境变量可覆盖平台默认值(优先级:请求 < 平台 < 个人)。
- **数字员工会话入口**:门户「数字员工」页列出已授权员工、直接对话(复用用户
  运行时凭据)、查看调用记录(检索/工具/延迟/状态)。
- **个人渠道**:门户「个人渠道」自建 Webhook 渠道绑定已批准模型;入站
  `POST /v1/personal-channels/{code}/inbound` 以 `X-Inbound-Token` 常量时间
  校验,经用户运行时凭据应答,用量归属用户 Key;支持令牌轮换与调用时间展示。
- **报表多维统计**:企业报表新增「工具调用 / 审批授权 / 安全事件」三个维度
  (工具成功率与延迟、三类申请状态分布、登录成功/失败与来源 IP 分布)。
- **租户(部门)配额**:部门支持 Key 数量上限与月 Token 上限(0=不限),门户
  运行时凭据开通时强制校验;租户概览展示配额用量与当月消耗。

迁移:000042_governance / 000043_platform_env_vars / 000044_personal_channels /
000045_tenant_quotas(共 45 个迁移)。

安全要点:

- 工具审批:每工具至多一个待审项(部分唯一索引),审批通过前执行一律拒绝;
  限流窗口在提交侧原子递增,超限即拒,无竞态放大。
- 个人渠道令牌只存 SHA-256 摘要、仅创建/轮换时显示一次,校验走
  constant-time 比较;渠道代码全局唯一。
- 平台环境变量与个人变量同用 AES-256-GCM 加密,管理端仅系统管理员可写。

## 0.11.4 — 旗舰版第五轮完善

发布时间:2026-08-13

新增功能:

- **智能体节点任务下发**(迁移 000046):管理端「安全与审计 → 节点任务」向节点池
  下发任务(Prompt/HTTP/MCP/Skill/数字员工/自定义),支持指定节点或池路由、
  最大尝试次数;节点经令牌认证后 `POST /v1/agent/nodes/{code}/tasks/claim`
  按 FIFO 认领(SKIP LOCKED 防多节点重复认领),执行后凭认领令牌上报结果
  (`/tasks/{id}/complete`,防重放/防串扰);失败按 30s×次数退避自动重入队,
  达上限标记 failed;支持取消排队任务与失败重试;完成/失败经站内信通知管理员。
- **个人智能体安全策略**:门户「账号安全」新增智能体安全策略——个人工具
  自动审批(个人凭据调用需审批工具时不再拦截)与个人限流倍数(个人调用
  按 (tool,user) 独立窗口放宽限流,默认倍数 1);运行时治理即时生效。
- 修复: `/v1/agent/nodes/` 从未挂载 publicMux(心跳端点在部署拓扑下不可达,
  0.11.0 存量缺陷)。

迁移:000046_agent_tasks(共 46 个迁移)。

安全要点:

- 任务认领 SKIP LOCKED + 15 分钟认领租约;上报必须携带认领令牌,伪造/复用
  一律拒绝;认领令牌仅认领响应返回,管理端列表/详情不回传。
- 节点令牌沿用心跳同一套 SHA-256 + constant-time 校验,未知节点与错误令牌
  返回同一错误,不泄露节点存在性。
- 个人限流按 (tool_id, portal_user_id) 独立窗口计数,个人倍数不影响全局额度。

## 0.11.5 — 旗舰版第六轮完善

发布时间:2026-08-13

新增交付:

- **智能体节点 Agent 程序**(`cmd/agent-node`):可独立部署到裸机/VM 的节点
  执行器。周期心跳(上报版本/能力/最近错误)刷新在线状态;轮询认领节点池
  任务;按类型执行——prompt(优先本地 OpenAI 兼容 LLM,缺省经网关)、
  http(仅 http(s)、禁重定向、响应限 1 MiB)、mcp_invoke / skill_run /
  digital_employee(经网关运行时转发,需 AGENT_GATEWAY_KEY)、custom(回显);
  凭认领令牌上报结果/错误,失败交由网关按退避重试;串行执行 + 优雅退出 +
  JSON 结构化日志。安全边界:不执行任意 shell 命令,载荷为网关下发的
  类型化 JSON,节点令牌经环境注入。
- **裸机安装脚本**(`scripts/install-agent-node.sh`):自动构建二进制、
  安装到 /usr/local/bin、生成 0600 权限节点配置(含令牌)、注册 systemd
  服务并启动;支持 AGENT_GATEWAY_URL/AGENT_CODE/AGENT_TOKEN 等环境配置。
- **集群/冷备部署方案**(`deploy/CLUSTER.md`):单机/冷备/集群三种形态对照;
  compose override 多副本网关 + nginx least_conn 入口示例;冷备数据层
  备份与恢复要点(master key 同步、WAL 归档、MinIO 异地);生产建议清单。

端到端验证:

- 真实 Agent 进程注册节点 → 心跳上线(版本/能力上报) → 下发 custom/http
  任务 → Agent 认领执行并上报 → 管理端任务成功、结果可见;日志含
  认领/上报全链路。修复 Agent claim 未解包网关 apiresponse 信封的问题。

至此旗舰版矩阵中所有可独立实施的功能与交付物完成;剩余依赖外部条件:
企微/钉钉/飞书真实平台联调、多租户物理隔离、企业环境内的节点批量部署。