Files

T

gongzhiyong 1f21309597 refactor: rename manager codebase dir new-api → heicode, module github.com/heicode/manager

Remove user-facing new-api naming; Docker/network/container names use heicode.
Go imports updated; Dockerfiles and workflows ldflags fixed.

Made-with: Cursor

2026-05-01 01:47:23 +08:00

2.2 KiB

Raw Blame History

Heicode Manager（源码目录 `heicode`）

本目录实现 Heicode Manager：网关与管理控制台（账号、渠道、模型策略、计费等）。目录名 heicode 为历史工程名；对外产品与文档统一称 Heicode Manager。目标是支撑 Heicode 客户端「浏览器登录后即用模型」。

本仓库角色

作为模型统一入口，管理渠道、用户、令牌、计费策略
提供 Heicode 需要的授权桥接接口
输出标准模型发现能力（/v1/models）给客户端

Heicode 相关新增能力

1) 浏览器登录授权入口

GET /heicode/oauth/authorize
GET /heicode/oauth/session

行为说明：

校验 redirect_uri 必须是 loopback（127.0.0.1 / localhost / ::1）
若用户未登录平台控制台，先引导登录
登录后签发或复用 Heicode 专用 token
回跳本地客户端并携带 state 与 token

2) 客户端模型发现

Heicode 通过 GET /v1/models 拉取可用模型集合
客户端不再依赖硬编码模型列表

快速运行（本地 Docker）

cd heicode
docker compose -f docker-compose.yml -f docker-compose.override.yml up --build -d

查看服务状态：

docker compose ps
docker compose logs -f heicode

默认访问地址：http://localhost:3000

Heicode 联调检查清单

平台已可正常登录 Web 控制台
GET /heicode/oauth/authorize 返回流程可达
GET /heicode/oauth/session 可反映登录态
GET /v1/models 返回模型列表不为空
Heicode 客户端登录后可直接发起模型请求

目录关注点

controller/heicode_oauth.go：Heicode 授权与会话检测核心逻辑
router/heicode-router.go：Heicode OAuth 路由注册
router/main.go：总路由接入点
docker-compose.override.yml：本地开发构建入口

生产建议

强制 HTTPS 与可信证书
设置稳定的会话密钥与持久化存储
对授权回调、token 签发、模型探活增加审计日志
配置限流与告警，避免异常流量冲击

许可证与来源

本工程在开源网关上游基础上演进（目录名 heicode 仅为历史路径），遵循对应许可证要求。企业使用前请完成内部合规审查。

2.2 KiB Raw Blame History Unescape Escape

Heicode Manager（源码目录 heicode）