Repository navigation

Release list

NewAPI Smart Router v0.4.0-alpha.1 — R98 Public Alpha Pre-release

Pre-release

ginsonko released this 06 Oct 05:59

v0.4.0-alpha.1

034daab

NewAPI Smart Router v0.4.0-alpha.1

基于当前 R98 通用智能路由能力更新，保留 New API / QuantumNous 身份、署名和 AGPL 许可。本版继续作为 Alpha / Pre-release，不是 Stable，也不代表任意 New API fork 均可直接无缝安装。

新功能

每把 Key 记住智能路由配置：切到固定分组后保留智能设置，切回时恢复。记忆与实际执行策略分开，不能绕过当前权限。
目录和报价权限刷新：按用户当前权限筛选分组、路线、报价及任务，避免沿用旧会话权限。
异步绘图安全回退：持久化作业与尝试身份；明确失败且退款完成后，才允许继续下一条合格路线。受理结果未知时只核对，不盲目重发。
可配置图片健康机制：默认统计最近一小时的真实请求证据；失败阈值和窗口可配置，成功记录用于恢复，不依靠付费探针。
更完整的成本选路合同：实际输入成本、缓存维度、阶梯价格、媒体报价与恢复条件一并保留。

仍按四种方式提供

形态	适用场景
Full	完整通用宿主源码、双主题前端、Worker，以及 Linux amd64 程序
Bridge	接入现有 New API 的 Hook 合同与参考库，需要完成宿主接线；无官方 revision 获 Certified
Integration Kit	定制 fork 的只读检查工具、规范与接线清单
Agent Parts Kit	提取算法、测试向量与规范，Development Kit / Not runnable

另附文档包、SPDX 源码依赖清单、发布 Manifest 和 SHA256SUMS。

验证与隐私

本地完成 30 项仓库检查、77 项发布检查、17 条构建测试命令、38 个宿主测试包、19 项默认主题 Key UI 测试及双主题构建；独立源码重组和五个 ZIP 重打包哈希一致。源码、归档和二进制已进行密钥及私有数据检查；不打包生产数据库、用户、渠道、运营配置或真实密钥。

最终下载包由 GitHub Ubuntu runner 从公开源码完整重建，运行同一宿主/双主题测试、29 项发布工具测试及 77 项发布检查后上传。本地与 Linux 构建包不是承诺逐字节相同；本页面的 Manifest 和 SHA256SUMS 描述这一套实际发布文件。最终源码提交为 034daabaac5038bfc5f0a5c54a30df59baaffb3a，主分支 CI 与最终独立检出复验均通过。完整构建与上传证据：GitHub Actions。

仓库新增可手动触发的“Build and upload existing draft”维护流程：只使用公开基线与临时 GitHub Token，完整构建、测试、扫描后上传到匹配草稿，不会自动公开发布，不会覆盖冲突程序包。失败响应先核对远端状态，避免重复上传或混用旧校验清单。

默认主题含完整记忆编辑体验，经典主题保持已有编辑器和服务端记忆保留。既有非改动范围 lint/空白告警保留记录，不通过关闭规则隐藏。该验证不等于三数据库生命周期认证、真实付费调用验收或签名容器认证。

升级提示

请先在隔离环境验证自己的配置与数据库。新增记忆列必须先于新写入端就绪，Web/Worker 建议同版；回退保留数据。仓库里的旧 bin/migration_v0.3-v0.4.sql 是上游历史脚本，不是这次 Smart Router v0.4 的升级脚本，不要按文件名直接运行。

从仓库 README 的“简明采用入口”和 docs/build-v0.4.md 开始。付款、上游受理或退款结果未知时保留原请求身份核对，不重复提交。

Assets 11

v0.3.0-alpha.1 - R52 Smart Router Public Alpha Pre-release

Pre-release

ginsonko released this 19 Aug 13:58

v0.3.0-alpha.1

d3fac38

NewAPI Smart Router v0.3.0-alpha.1

This Public Alpha updates the existing four release forms to the R52 contract while preserving the previous README and historical releases.

Highlights

real cache-rate and actual input-cost evidence with static fallback and cache-namespace isolation;
input/output-aware effective price ordering without changing host billing formulas;
token, per-request, per-second, fixed-duration, and tiered media price contracts;
one smart Key can discover authorized text, image, video, and audio models through standard /v1/models;
exact-name or explicit canonical mapping boundaries, plus endpoint and capability matching, prevent cross-model routing;
media acceptance and semantic-commit safeguards prevent unsafe duplicate dispatch;
group color metadata, same-color clustering, and within-cluster group-ratio ordering for host UIs;
expanded bounded retry/error taxonomy, attempt-chain visibility, sanitized terminal errors, and localization hooks;
Bridge candidate upgraded to bridge-spi-v1alpha3 with updated Integration and Agent Parts kits.

Four forms

Full compatibility distribution
Certified Bridge Add-on candidate
Custom Fork Integration Kit
Agent Parts Kit

Sidecar Lite remains experimental and is not a fifth Full-parity form.

Validation

merge commit: d3fac388fafd54094c1dcd54c71cb22244993e7d;
GitHub CI on PR and merged main: PASS;
repository validator: 26 checks;
release validator: PUBLIC_ALPHA_READY, 75 checks;
default/classic production builds and Full go test ./... -p=2: PASS;
core, Bridge, doctor, 16 planner vectors, and Linux amd64 build: PASS;
final secret scan: 5,142 files and 5 archives, 0 high findings;
five ZIP archives passed CRC and path-safety checks; Full contains no node_modules;
final SHA-256 values are in SHA256SUMS.

Compatibility boundary

This remains an Alpha / Pre-release. It does not certify arbitrary New API forks, Stable supply-chain guarantees, or universal drop-in compatibility. Read RELEASE-STATUS.md, docs/v0.3-contract-delta.md, and the included manifests before integration.

Assets 11

NewAPI Smart Router v0.2.0-alpha.1 Pre-release

Pre-release

ginsonko released this 02 Aug 16:19

v0.2.0-alpha.1

3f545b0

NewAPI Smart Router v0.2.0-alpha.1

这是对 v0.1.0-alpha.1 的追加式 Public Alpha 更新，保留原有完整说明书与四种采用形态。

主要更新

同步已验收 R39 Smart Router 公开核心与 Agent Parts 参考实现。
新增模型感知 RoutePrice：显式分组模型价格替换全局基础价，inherit 使用真实全局价，分组倍率只组合一次。
token、按次、按秒、固定时长和表达式价格按 comparison class 隔离，禁止跨单位伪比价。
replay-safe text 默认串行遍历全部剩余合格物理渠道；旧 1..8 数字上限保留为可选模式。
side-effecting 请求仅允许一次初始派发；dispatch 后绝不切换第二渠道；state-bound 在连接上游前拒绝。
增加 warming 新鲜成功证据重新准入、Adapter 只能收窄、false HTTP 200 语义校验、Web/Worker 同二进制合同。
planner conformance 从 8 条扩展到 16 条，Bridge 协议升级为 bridge-spi-v1alpha2。

四种发行形态

Full compatibility distribution
Certified Bridge Add-on candidate
Custom Fork Integration Kit
Agent Parts Kit

Sidecar Lite 仍是实验附录，不是第五种完整形态。

验证

GitHub Actions run 30756016605: PASS
Core / 16 vectors / Bridge / Doctor / repository contracts: PASS
两次独立发行构建：各 71 项 PASS
9 个最终资产：逐字节可复现
仓库、Full source、收据与归档秘密扫描：0 个高风险发现
Merge commit: 3f545b055ee84903084b164c48cb0212d4193374

请使用随附 SHA256SUMS 校验下载内容。

这是 Pre-release，不是 Stable，也不声明任意 NewAPI fork 可直接获得 Full parity。Bridge 仍需针对精确宿主 commit 完成认证。

Assets 11

NewAPI Smart Router v0.1.0-alpha.1 Pre-release

Pre-release

ginsonko released this 23 Jul 12:39

v0.1.0-alpha.1

681a0a3

NewAPI Smart Router v0.1.0-alpha.1

首个公开 Alpha：为 New API 站点提供每 Key 智能路由、共享健康、自愈恢复、容量感知、缓存经济、实际路线计费和可解释决策的完整参考实现与集成工具。

这是 Pre-release，适合隔离环境评估、开发和二次集成，不是无人值守生产安装包。当前没有官方 New API revision 获得 Certified Bridge 标记。

下载选择

资产	适合谁	状态
`newapi-smart-router-v0.1.0-alpha.1-full-source.zip`	希望评估完整参考体验的站长	可运行 Full Alpha；基于 rc.20 的本地参考 fork
`newapi-smart-router-v0.1.0-alpha.1-bridge-candidate.zip`	接近官方 New API、准备做精确版本集成的开发者	Bridge 候选；未知版本失败关闭
`newapi-smart-router-v0.1.0-alpha.1-integration-kit.zip`	已有明显魔改 New API fork 的站长	先运行只读 doctor，再按语义合并
`newapi-smart-router-v0.1.0-alpha.1-agent-parts-kit.zip`	想让 Codex、Claude Code 或其他 Agent 复刻模块的开发者	Development Kit / Not runnable
`newapi-smart-router-v0.1.0-alpha.1-documentation.zip`	只需要完整说明、Schema 和集成规范的人	文档与机器合同
`newapi-smart-router-v0.1.0-alpha.1-linux-amd64`	评估完整参考二进制的人	未签名 Linux amd64 Alpha

同时提供 SPDX-SBOM.json、RELEASE-MANIFEST.json 和 SHA256SUMS。

主要能力

每个 Key 独立选择分组范围、倍率上限和价格/稳定/首字/综合/手动策略；
自动发现同模型、同端点合同的真实路线，新增路线和调价可进入后续决策；
低价路线故障时在首包提交前安全升档，恢复后重新参与排序；
全站共享精确到模型与端点合同的健康证据，容量、凭据和用户错误分域处理；
后台恢复探测使用预算、租约、抖动和持久调度，不阻塞用户请求；
Prompt Cache 经济模型避免为了名义低价频繁重建昂贵上下文；
图片、视频、音频和异步任务使用媒体专属受理、幂等、亲和和对账边界；
Route Receipt 冻结实际路线、价格 revision、尝试和结算，日志解释每次选择原因；
Full、Bridge、Custom Fork Integration、Agent Parts 四种采用形态及失败关闭兼容矩阵。

兼容边界

参考源码 HEAD：6ce7305cd36f16506fb6a2c3c524a5a318539ba7
冻结快照：snapshot_sha256_a86384f73465c42d060c1919ea7b9ee03afd0002ddc328e7da69096ce0694c24
公开仓库 commit：681a0a33b95b94da8768aee646de55139e4a66da
参考 fork 基于 New API v1.0.0-rc.20，但它的 HEAD 不等于官方 rc.20 tag commit；不能把本候选视为官方 rc.20 的自动认证。
2026-07-23 联网审计观察到最新 New API Release 为 v1.0.0-rc.21；rc.21 和 main 尚未认证。

验证结果

两次独立全量构建均通过 63/63 发布门禁；
完整 New API Go 测试、核心、Bridge、planner golden vectors、doctor 和仓库合同验证通过；
5 个 ZIP、Linux 二进制、SPDX SBOM、Manifest 和校验和逐字节复现；
4,982 个文本对象与 ZIP 成员完成秘密扫描，0 findings、0 high findings；
ZIP 通过 CRC、固定时间戳、路径安全、无符号链接和逐成员往返哈希。

下载后请先验证：

sha256sum -c SHA256SUMS

许可证

社区路径为 AGPL-3.0-only，允许使用、研究、修改、再分发和遵守 AGPL 的商业使用。需要闭源二改、专有发行、OEM、商业支持或其他替代条款时，可通过仓库的 Commercial licensing issue 联系作者。商业协议只覆盖作者拥有相应权利的 Smart Router 原创部分，不重新许可 QuantumNous New API 或第三方依赖。

仍未关闭的 Stable 门禁

当前官方 New API revision 的精确 Bridge 认证；
协议级 OutcomeValidator 最终认证；
SQLite、MySQL、PostgreSQL 往返迁移；
外部非生产站点安装、升级、回滚和卸载；
容器镜像 SBOM、签名和远端可复现构建。

完整使用、架构和集成说明请阅读仓库 README 与 RELEASE-STATUS.md。

Assets 11

Releases: ginsonko/newapi-smart-router

Release list