学习资料 上游项目:New API 固定快照,可复现 最近审阅 2026-08-23

上游功能与部署
参考中心

把已审阅的功能、客户端接入、多种部署教程、成熟度判断与采用决策集中在独立站点,便于持续学习和后续实现对照。

上游参考资料隔离区,不等同 CodeDude 已上线功能。本页条目代表审阅到的上游能力,CodeDude 实际状态以产品验收和发布记录为准。

Recommended path

CodeDude 当前推荐:强化版 Docker Compose 单节点

上游已经提供成熟的 Compose 路线,CodeDude 无需重造部署拓扑;应复用其应用、PostgreSQL、Redis 的结构,在此基础上继续保留 Caddy/TLS、不可变镜像 digest、发布前预检、数据备份、健康探针、对应源码归档与可执行回滚。

直接复用

  • Compose 的服务依赖、持久化卷和环境变量组织方式
  • PostgreSQL + Redis 的正式环境组合
  • 先备份、再拉取/构建、再重启并检查日志的更新顺序

继续加固

  • 用经过验证的 digest 替代可漂移的 latest 标签
  • 发布前执行配置、迁移、磁盘与依赖预检
  • 部署后执行 HTTP、API、浏览器与故障注入验证
  • 保留上一个镜像、数据库备份、对应源码和一键回滚入口

集群触发条件

  • 单节点资源连续接近容量阈值
  • 业务明确要求跨节点容灾或无停机维护
  • 共享数据库、会话、缓存和定时任务已通过多节点验证

Capability map

上游功能类别矩阵

11 个类别

协议与格式适配

Adapt · 适配采用
  • OpenAI Chat / Responses / Realtime
  • Claude Messages 与思考内容
  • Google Gemini 与 OpenAI 兼容格式互转
  • Rerank、图像、音频等扩展接口
CodeDude 动作
按真实供应商逐项启用,保持每种协议独立契约测试,不用“兼容”标签替代端到端验证。
验证重点:请求映射、流式输出、工具调用、错误语义、计费用量

渠道与智能路由

Adapt · 适配采用
  • 多供应商渠道管理与模型映射
  • 加权选择、失败重试与优先级
  • 分组、用户级模型限流与缓存策略
  • 渠道状态、余额与可用性检查
CodeDude 动作
复用策略框架,继续使用 CodeDude 的供应商白名单、熔断阈值、审计日志和灰度开关。
验证重点:故障注入、重试上限、跨渠道一致性、路由可解释性

用户、令牌与权限

Adapt · 适配采用
  • 用户、令牌、分组与模型权限
  • OIDC、Telegram、Discord、LinuxDO 等登录入口
  • 令牌额度查询与使用范围控制
  • 管理员与普通用户控制台
CodeDude 动作
优先采用通用 RBAC 与令牌边界;第三方登录逐个评估回调域、密钥托管与账号合并规则。
验证重点:越权矩阵、会话刷新、跨标签页一致性、吊销生效时间

账号安全与身份绑定

Adapt · 适配采用
  • 双因素认证、备份码与恢复流程
  • Passkey 与第三方账号绑定
  • 密码重置、邮件验证与登录通知
  • 管理员、普通用户与 Root 角色边界
CodeDude 动作
全功能 profile 下按回调域、供应商凭据和验收状态启用注册、OAuth、OIDC 与 Passkey;高权限操作继续执行二次验证。
验证重点:恢复码单次使用、Passkey 回退、会话失效、账号合并冲突

用量、额度与成本核算

Adapt · 适配采用
  • 请求量、Token 与缓存命中统计
  • 模型倍率、分组倍率与额度管理
  • 内部充值、兑换码与支付接口
  • 个人与组织视角的使用日志
CodeDude 动作
全功能 profile 下按商户凭据与验收状态启用充值、兑换码、订阅、支付和自动结算,并为每条资金路径保留对账、退款与幂等证据。
验证重点:供应商账单对账、舍入误差、并发扣费、退款与幂等

控制台与可观测性

Adopt · 直接采用
  • 数据看板、用量日志、任务日志
  • 渠道、用户、模型、兑换码管理
  • Playground、聊天与定价展示
  • 系统配置、公告和内容管理
CodeDude 动作
复用成熟信息架构,所有公共文案、权限入口和敏感指标按 CodeDude 产品边界重新验收。
验证重点:角色可见性、空状态、移动端、主题与多语言

客户端与开发工具接入

Adopt · 直接采用
  • Claude Code、Codex CLI、Cherry Studio
  • AionUI、DeepChat、CC Switch
  • AstrBot、LangBot、OpenClaw 等应用
  • 通用 Base URL、模型名与令牌配置
CodeDude 动作
把教程结构复用为 CodeDude 验证清单,每个客户端保留版本、最小配置和成功请求证据。
验证重点:客户端版本、配置截图、模型列表、真实请求与流式响应

图像、音频与异步任务

Adapt · 适配采用
  • 绘图、视频与第三方异步任务提交
  • 任务状态轮询、日志与结果展示
  • 供应商任务参数和模型映射
  • 失败、超时、退款与结果过期处理
CodeDude 动作
全功能 profile 下按真实供应商凭据与任务生命周期验收结果逐项启用,失败补偿、退款和结果存储必须随功能一并上线。
验证重点:任务幂等、回调校验、超时补偿、结果存储和真实成本

管理 API 与 Skills

Adapt · 适配采用
  • 渠道、用户、模型与日志管理端点
  • 兑换码、支付、任务与统计接口
  • 用户与管理员操作 Skills
  • 自动化运维和外部控制面接入
CodeDude 动作
按全功能 profile 生成实际可用端点文档;注册、支付、任务、账务与资源端点分别纳入契约、权限和审计测试。
验证重点:身份认证、最小权限、审计事件、速率限制和版本兼容

订阅资源号池与私网控制面

Adapt · 适配采用
  • 多资源账号、供应商类型与健康状态管理
  • 凭据加密托管、轮换和最小化回显
  • Worker 刷新、配额同步与失败退避
  • Scheduler 调度、熔断、恢复与容量观测
CodeDude 动作
CodeDude 号池采用私网 Worker/Vault/Scheduler:控制面不直接公开,数据面只消费健康快照;全功能 profile 下按真实凭据与验收结果启用。
验证重点:凭据密文、私网访问、租约互斥、故障熔断、恢复探测与审计闭环

部署、配置与维护

Adapt · 适配采用
  • Docker Compose 与单容器部署
  • 1Panel、宝塔和集群部署教程
  • 环境变量、Compose 配置与系统更新
  • PostgreSQL / MySQL / SQLite、Redis 与缓存
CodeDude 动作
采用成熟拓扑和操作顺序,同时保留不可变镜像、备份、预检、健康检查、TLS 与一键回滚。
验证重点:新装、升级、重启、数据恢复、回滚和灾难演练

Deployment map

部署方式与 CodeDude 采用判断

6 条路线

单 Docker 容器

Hold · 暂存观察

本机试用、小规模验证与临时环境

成熟度:成熟

单应用容器;可用 SQLite 或外接数据库

查看固定教程 ↗
采用方式

保留为快速实验入口,不替代 CodeDude 正式环境的数据库、缓存和发布链。

1Panel

Hold · 暂存观察

偏好可视化面板的单机运维

成熟度:条件成熟

面板编排应用、数据库、域名与证书

查看固定教程 ↗
采用方式

教程留档。只有面板纳入备份、审计和自动化发布后,才作为正式运维入口。

宝塔面板

Hold · 暂存观察

已有宝塔运维体系的单机部署

成熟度:条件成熟

面板 Docker、数据库、域名与证书管理

查看固定教程 ↗
采用方式

教程留档,不与当前 Compose/Caddy 发布链并行写生产状态。

集群部署

Hold · 暂存观察

单节点容量不足或需要更高可用性时

成熟度:条件成熟

多应用节点 + 负载均衡 + 共享 PostgreSQL;Redis 按一致性需求规划

查看固定教程 ↗
采用方式

先定义容量与可用性触发线;启用前补齐会话、缓存、定时任务、迁移和滚动升级验证。

源码 / 本地开发

Adopt · 直接采用

功能开发、调试、测试与上游差异分析

成熟度:成熟

本地 Go + Node/Bun 工具链,可连接隔离数据库与缓存

查看固定教程 ↗
采用方式

作为开发基线直接采用;生产交付仍通过可复现构建和不可变镜像。

Maturity review

成熟度分层

可以直接学习

  • 渠道管理与模型映射
  • 高级系统设置与个人安全设置
  • API 调用与客户端接入教程
  • Compose + PostgreSQL + Redis 的基础拓扑

需要对照源码验证

  • 异步任务、分组、Custom OAuth 与性能监控文档较薄
  • 第三方客户端和面板模板会随版本变化
  • 协议“兼容”仍要按供应商做真实端到端测试

暂不作为成熟能力宣称

  • 官方文档把 Files 与 Fine-tuning 放在未实现目录
  • 部分协议互转能力仍标注开发中或仅支持文本
  • 上游集群教程给出一致性原则,但没有可直接投产的完整 HA 清单

Improvement backlog

验证后的优化清单

已完成

公开文档与上游资料隔离

历史 Docs 链接把访客直接送到上游站点,公共页面也混入上游产品名。

主站导航、主页、页脚和关于页移除资料入口;本页仅由独立 reference 域名或隔离路径托管,公开代码示例使用 CODEDUDE_API_KEY。
已采用

强化版单节点 Compose

上游 Compose 的核心拓扑成熟,但 latest、示例密码和公开 3000 端口不适合作为当前生产文件。

保留 CodeDude 的 Caddy/TLS、内部端口、镜像 digest、preflight、对应源码、备份与回滚链。
P0

自有镜像发布与签名验真

镜像构建流程仍需统一到 CodeDude 自有仓库,部署预检尚未强制验证 cosign 身份。

迁移镜像发布目标并固定签名 issuer/identity;签名验证在现网镜像完成补签与演练后再设为 fail-closed。
P1

灾备自动化与容量调优

备份与恢复工具已经齐备,异机副本、对象锁、定时恢复演练和连接池容量仍可加强。

增加 timer、异机加密副本、保留策略与真实恢复演练;按压测结果调整数据库连接池。
触发后

独立多节点模板

当前单机规模没有替换成熟正式拓扑的收益,上游也未提供完整 HA manifest。

达到容量或 SLA 触发线后,再实现外置 PostgreSQL、稳定 Redis、双应用节点和负载均衡。

Primary sources

官方来源与审阅快照

源码快照 2d8e50bf36e94200b809dfb39e73624ec48b1e23 文档快照 cb6ee07375e03ac7556b29ece10f165807497a48 审阅库存 981 个文件 / 中文资料 355 篇