Directories
¶
| Path | Synopsis |
|---|---|
|
Package auth 承载用户认证体系：bcrypt 密码哈希（与 sub2api 同参数）、 JWT 签发/验证（HS256，TTL 24h）与 RBAC 中间件（/user 组 RequireJWT + 快照用户状态校验；/admin = platform_admin JWT OR platform_admin 管理 key）。
|
Package auth 承载用户认证体系：bcrypt 密码哈希（与 sub2api 同参数）、 JWT 签发/验证（HS256，TTL 24h）与 RBAC 中间件（/user 组 RequireJWT + 快照用户状态校验；/admin = platform_admin JWT OR platform_admin 管理 key）。 |
|
Package billing 计费核心：service_tier 归一化 + 价格矩阵纯函数 + 余额快照 + 批量扣费 flusher。
|
Package billing 计费核心：service_tier 归一化 + 价格矩阵纯函数 + 余额快照 + 批量扣费 flusher。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
SPDX-License-Identifier: AGPL-3.0-or-later |
|
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——两面包共享的分页上限钳制）。 |
|
supplier
Package supplier provides primitives to interact with the openapi HTTP API.
|
Package supplier provides primitives to interact with the openapi HTTP API. |
|
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 管理面变更的去抖定向失效：
|
Package invalidate 管理面变更的去抖定向失效： |
|
Package latch 是规则失效锁存的一等组件（根因重开）：单实例内存 锁存（account+fingerprint+revision）+ 规则失败事件的同步扇出中介。
|
Package latch 是规则失效锁存的一等组件（根因重开）：单实例内存 锁存（account+fingerprint+revision）+ 规则失败事件的同步扇出中介。 |
|
Package notify 多实例变更广播（基础层）：PG LISTEN/NOTIFY 定向刷新。
|
Package notify 多实例变更广播（基础层）：PG LISTEN/NOTIFY 定向刷新。 |
|
Package protoconv 提供网关级协议转换（只补差语义）：客户端协议请求体 → 模板协议请求体（ConvertRequest）、模板协议响应 → 客户端协议响应 （ConvertResponse 非流式 JSON / StreamMapper 流式 SSE 事件映射）。
|
Package protoconv 提供网关级协议转换（只补差语义）：客户端协议请求体 → 模板协议请求体（ConvertRequest）、模板协议响应 → 客户端协议响应 （ConvertResponse 非流式 JSON / StreamMapper 流式 SSE 事件映射）。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
SPDX-License-Identifier: AGPL-3.0-or-later |
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
SPDX-License-Identifier: AGPL-3.0-or-later |
|
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 首中匹配）→ typed 动作（Throttle→RuntimeHealth / FailAccount→latch+CAS） + 响应整形。
|
Package rule 实现规则引擎（可编排状态管理）：事件 → 有界 channel → 规则 worker （priority 首中匹配）→ typed 动作（Throttle→RuntimeHealth / FailAccount→latch+CAS） + 响应整形。 |
|
SPDX-License-Identifier: AGPL-3.0-or-later
|
SPDX-License-Identifier: AGPL-3.0-or-later |
|
Package sdkbridge 是 SDK 适配层与网关之间的契约面（零 SDK 依赖——SDK 调用从此后）：统一失效回调 + 失效处理链装配（写失效字段 / 调度摘除 / 审计）、网关侧信封错误与凭据传递形态（AccountCredential 派生在 internal/domain）。
|
Package sdkbridge 是 SDK 适配层与网关之间的契约面（零 SDK 依赖——SDK 调用从此后）：统一失效回调 + 失效处理链装配（写失效字段 / 调度摘除 / 审计）、网关侧信封错误与凭据传递形态（AccountCredential 派生在 internal/domain）。 |
|
Package server 装配 chi 路由：/api/admin/*（platform_admin JWT 或该身份的管理 key mk-）+ /api/user/*（身份鉴权，register/login 公开）+ 三个 AI 端点 + /healthz。
|
Package server 装配 chi 路由：/api/admin/*（platform_admin JWT 或该身份的管理 key mk-）+ /api/user/*（身份鉴权，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 settingssnap 是 settings 全量内存快照的唯一事实源（根因重开）： Service 与 MailWorker 同源共享单个 *Snapshot（单指针，无双快照分叉）。
|
Package settingssnap 是 settings 全量内存快照的唯一事实源（根因重开）： Service 与 MailWorker 同源共享单个 *Snapshot（单指针，无双快照分叉）。 |
|
Package snapshot 统一网关各内存快照的生命周期：启动就绪（ReloadAll 全量首刷） + NOTIFY 事件分发（按 scope 精确重载）+ 状态可观测（Status）。
|
Package snapshot 统一网关各内存快照的生命周期：启动就绪（ReloadAll 全量首刷） + NOTIFY 事件分发（按 scope 精确重载）+ 状态可观测（Status）。 |
|
Package supplier 供应商收益记账链 / 解冻链的纯逻辑与 worker 契约 （spec 2026-10-09 §5）。
|
Package supplier 供应商收益记账链 / 解冻链的纯逻辑与 worker 契约 （spec 2026-10-09 §5）。 |
|
testsupport
|
|
|
pgtest
Package pgtest hands each PostgreSQL integration test its own isolated database, cloned from a single migrated template with CREATE DATABASE ...
|
Package pgtest hands each PostgreSQL integration test its own isolated database, cloned from a single migrated template with CREATE DATABASE ... |
|
pgtest/pgrepo
Package pgrepo wires the c3api data layer into pgtest.
|
Package pgrepo wires the c3api data layer into pgtest. |
|
pgtestctl
command
Command pgtestctl is the database-side helper behind scripts/test.sh.
|
Command pgtestctl is the database-side helper behind scripts/test.sh. |
|
归属说明：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。 |
|
Package worker 提供统一后台任务抽象（Global Constraints）：顺序启动、 反向排空、panic 捕获（进程不崩）。
|
Package worker 提供统一后台任务抽象（Global Constraints）：顺序启动、 反向排空、panic 捕获（进程不崩）。 |
Click to show internal directories.
Click to hide internal directories.