Directories
¶
| Path | Synopsis |
|---|---|
|
Package auth 承载用户认证体系：bcrypt 密码哈希（与 sub2api 同参数）、 JWT 签发/验证（HS256，TTL 24h）与 RBAC 中间件（/user 组 RequireJWT + 快照用户状态校验；/admin = 静态 token OR platform_admin JWT）。
|
Package auth 承载用户认证体系：bcrypt 密码哈希（与 sub2api 同参数）、 JWT 签发/验证（HS256，TTL 24h）与 RBAC 中间件（/user 组 RequireJWT + 快照用户状态校验；/admin = 静态 token OR platform_admin JWT）。 |
|
Package billing 计费核心：service_tier 归一化 + 价格矩阵纯函数 + 余额快照 + 批量扣费 flusher（T2/T3）。
|
Package billing 计费核心：service_tier 归一化 + 价格矩阵纯函数 + 余额快照 + 批量扣费 flusher（T2/T3）。 |
|
Package credential 是账号凭据抽象层：类型注册表 + Provider 分发，为后续 多种号池类型（codex oauth、codex personal_access_token、claude code 等） 打地基。
|
Package credential 是账号凭据抽象层：类型注册表 + Provider 分发，为后续 多种号池类型（codex oauth、codex personal_access_token、claude code 等） 打地基。 |
|
Package discovery Redis 实例发现（spec 2026-08-25-redis-instance-discovery-design， 基建面见 2026-08-25-redis-foundation-design）：单 ZSET 心跳成员协议替换手工 cluster.instances 设置——实例心跳注册、活体计数即多实例预算分摊基数 N。
|
Package discovery Redis 实例发现（spec 2026-08-25-redis-instance-discovery-design， 基建面见 2026-08-25-redis-foundation-design）：单 ZSET 心跳成员协议替换手工 cluster.instances 设置——实例心跳注册、活体计数即多实例预算分摊基数 N。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial.
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial. |
|
Package handler provides primitives to interact with the openapi HTTP API.
|
Package handler provides primitives to interact with the openapi HTTP API. |
|
httpface
Package httpface 管理面/用户面 HTTP 边界：响应书写（WriteJSON/WriteErr/ WriteServiceErr，service 错误→HTTP 状态映射表唯一一份）+ 请求参数边界 （ClampLimit——两面包共享的分页上限钳制）。
|
Package httpface 管理面/用户面 HTTP 边界：响应书写（WriteJSON/WriteErr/ WriteServiceErr，service 错误→HTTP 状态映射表唯一一份）+ 请求参数边界 （ClampLimit——两面包共享的分页上限钳制）。 |
|
user
Package user provides primitives to interact with the openapi HTTP API.
|
Package user provides primitives to interact with the openapi HTTP API. |
|
Package invalidate 管理面变更的去抖定向失效（Phase 6 O2）：
|
Package invalidate 管理面变更的去抖定向失效（Phase 6 O2）： |
|
Package notify 多实例变更广播（#14 T1 基础层）：PG LISTEN/NOTIFY 定向刷新。
|
Package notify 多实例变更广播（#14 T1 基础层）：PG LISTEN/NOTIFY 定向刷新。 |
|
Package protoconv 提供网关级协议转换（W5，只补差语义）：客户端协议请求体 → 模板协议请求体（ConvertRequest）、模板协议响应 → 客户端协议响应 （ConvertResponse 非流式 JSON / StreamMapper 流式 SSE 事件映射）。
|
Package protoconv 提供网关级协议转换（W5，只补差语义）：客户端协议请求体 → 模板协议请求体（ConvertRequest）、模板协议响应 → 客户端协议响应 （ConvertResponse 非流式 JSON / StreamMapper 流式 SSE 事件映射）。 |
|
Package proxy 是 AI 请求热路径：分组 key 鉴权 → 调度器选号 → SDK 转发 → 用量采集。
|
Package proxy 是 AI 请求热路径：分组 key 鉴权 → 调度器选号 → SDK 转发 → 用量采集。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial.
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial. |
|
Package rule 实现规则引擎（可编排状态管理）：事件 → 有界 channel → 规则 worker （priority 首中匹配）→ 状态/冷却/权重更新。
|
Package rule 实现规则引擎（可编排状态管理）：事件 → 有界 channel → 规则 worker （priority 首中匹配）→ 状态/冷却/权重更新。 |
|
Package scheduler 实现内存优先的账号调度：规则驱动的状态管理（internal/rule 引擎 事件投递 + apply 回调）、选号（格式硬过滤 + 模型硬白名单 + 全模型账号 tier2 兜底 + 预生成加权轮询序列）、并发槽、快照缓存与异步状态回写。
|
Package scheduler 实现内存优先的账号调度：规则驱动的状态管理（internal/rule 引擎 事件投递 + apply 回调）、选号（格式硬过滤 + 模型硬白名单 + 全模型账号 tier2 兜底 + 预生成加权轮询序列）、并发槽、快照缓存与异步状态回写。 |
|
Package sdkbridge 是 SDK 适配层与网关之间的契约面（T1，零 SDK 依赖——SDK 调用从 T2 起）：统一失效回调 + 失效处理链装配（写失效字段 / 调度摘除 / 审计）、网关侧信封错误（P2-1）与凭据传递形态（AccountCredential 派生在 internal/domain）。
|
Package sdkbridge 是 SDK 适配层与网关之间的契约面（T1，零 SDK 依赖——SDK 调用从 T2 起）：统一失效回调 + 失效处理链装配（写失效字段 / 调度摘除 / 审计）、网关侧信封错误（P2-1）与凭据传递形态（AccountCredential 派生在 internal/domain）。 |
|
Package server 装配 chi 路由：/api/admin/*（静态 token OR platform_admin JWT）+ /api/user/*（JWT 保护，register/login 公开）+ 三个 AI 端点 + /healthz。
|
Package server 装配 chi 路由：/api/admin/*（静态 token OR platform_admin JWT）+ /api/user/*（JWT 保护，register/login 公开）+ 三个 AI 端点 + /healthz。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial.
|
SPDX-License-Identifier: AGPL-3.0-or-later Dual-licensed: AGPL-3.0-or-later (open source) or commercial license (closed-source deployment exemption); see LICENSE and LICENSE.commercial. |
|
errors
Package serviceerr 定义 service 层错误哨兵（单一真相）。
|
Package serviceerr 定义 service 层错误哨兵（单一真相）。 |
|
Package snapshot 统一网关各内存快照的生命周期：启动就绪（ReloadAll 全量首刷） + NOTIFY 事件分发（按 scope 精确重载）+ 状态可观测（Status）。
|
Package snapshot 统一网关各内存快照的生命周期：启动就绪（ReloadAll 全量首刷） + NOTIFY 事件分发（按 scope 精确重载）+ 状态可观测（Status）。 |
|
归属说明：retention worker 放 usage 包——原 Recorder.janitorLoop（逐行 DELETE）已删除，保留策略整体移交本 worker；保留天数与 Recorder 配置同源 （config usage.log_retention_days），故与 Recorder 同包管理。
|
归属说明：retention worker 放 usage 包——原 Recorder.janitorLoop（逐行 DELETE）已删除，保留策略整体移交本 worker；保留天数与 Recorder 配置同源 （config usage.log_retention_days），故与 Recorder 同包管理。 |
|
Package verification 邮箱验证码的 Redis 存储（spec 2026-08-25-emailcode-redis-migration §2）：一个 (purpose,email) 一个 HASH，四命令直映 service.EmailCodeStore，零 Lua。
|
Package verification 邮箱验证码的 Redis 存储（spec 2026-08-25-emailcode-redis-migration §2）：一个 (purpose,email) 一个 HASH，四命令直映 service.EmailCodeStore，零 Lua。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
SPDX-License-Identifier: AGPL-3.0-or-later |
Click to show internal directories.
Click to hide internal directories.