Skip to content

docs: 校准 roadmap 状态与近期依赖 #205

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
eric8810 wants to merge 2 commits into
base: master
Choose a base branch
from
Draft

docs: 校准 roadmap 状态与近期依赖 #205

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f9559de
docs: 校准 roadmap 状态与近期依赖
eric8810 Oct 3, 2026
0b82edd
docs: 明确 roadmap 基线为发布后的 master
eric8810 Oct 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,8 @@ difference: aimux is an access layer, those are orchestration layers.

---

For planned milestones and their current status, see the [roadmap](ROADMAP.md).

## Why aimux

- **327 providers** (as of 2026-09-24) — 251 registry-backed OpenAI-compatible
Expand Down
28 changes: 20 additions & 8 deletions ROADMAP.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,18 @@

> 基线：v0.5.0（2026-09-27 发布）。方向依据 [RFC-0036](rfc/0036-positioning-and-layered-architecture.md)
> （定位与分层架构）；本文档只做排期，单项设计与差距分析在各 issue / RFC 内。
> 上次复核：2026-09-29（open issues #95 #166 #167 #170 #171 #174 #175 #179 #180 #181 #185）。
> 上次复核：2026-10-03；代码基线：`72a37b5`（v0.5.0 发布后的 master）。阶段划分沿用已合并的 #197 / #198；完成状态以合并记录和源码为准，未合并提案单独列出。
>
> 位置说明：放在仓库根目录而非 `docs/plan/`——后者在 E1 文档重组中整体归档；`docs/` 的英文约定不适用于本文。
> 位置说明：放在仓库根目录而非 `docs/plan/`——后者计划在 E1 文档重组时整体归档，目前仍保留；`docs/` 的英文约定不适用于本文。

## 当前状态（2026-10-03）

- **已合并的路线基线**：[#198](https://github.com/arcships/aimux/pull/198)（`cddfee7`）加入定位与分层架构 RFC，[#197](https://github.com/arcships/aimux/pull/197)（`9ce501a`）加入本文的 0.6 → 1.0 分期。RFC 文件仍标 Draft，设计状态需与决策记录同步。
- **已完成的前置工作**：#164 请求管线、[#169](https://github.com/arcships/aimux/pull/169) A1 脚本与依赖清理、[#196](https://github.com/arcships/aimux/pull/196) iOS staticlib 体积修复已合并。A1 以 #169 的实际保留/删除清单为准；#196 不代表桌面 S1 或全产物 S2 已完成。
- **仍待实施**：RFC-0032 / 0033 入库、B1 / C2、桌面 S1、全产物 S2、性能门禁 P、ops 协议与 L0 passthrough。RFC-0031 当前位于 [docs/ai-sdk-request-pipeline.md](docs/ai-sdk-request-pipeline.md)，迁入 `rfc/` 属文档整理，不是重新实现请求管线。
- **未合并提案**：[#200](https://github.com/arcships/aimux/pull/200) 提出全链路 AI SDK 对齐，新增文件与现有 RFC-0036 同号。它在切换方式、兼容策略、auth/replay 结构及 L2 定位上与当前路线有差异，需明确编号、与现行基线的继承或替代关系，并核对已有决策记录后同步本文及相关 issue；本轮状态整理不裁定这些架构选择。

阶段中的版本和工期为规划估算，不是已承诺发布日期。完成项附合并 PR；未合并提案不计入完成进度。

## 0. 方向（RFC-0036 摘要）

Expand Down Expand Up @@ -111,13 +120,16 @@ aimux 是 **provider 接入与治理的运行时**：
- **瘦身不改变对外 API**（§6.1）。
- 语言规则：`docs/` 与 `bindings/*/README` 英文，`rfc/` 中文。

## 4. 近期第一步（本周可并行开）
## 4. 近期入口与依赖门

1. **状态与方向对齐**：#166 A1 按 #169 的实际交付补勾，E1 改为 master 上独立 PR；#200 先厘清 RFC 同号、已有决策记录及与现行路线的关系。不在本轮文档维护中决定 ABI 切换方式或 #185 的最终类型架构。
2. **RFC-0032 / 0033 入库**：B1 与 #174 的规范前提。纳入 #166 已记录的修正；不能以未合并分支中的文档替代 master 的规范。
3. **S1 / S2 / P**：S1 只改 staticlib job，cdylib 保持现有 profile；S2 给出各发布产物的基线与阈值；P 明确测量方法、回归阈值与基线更新规则，再作为发布门禁。
4. **A2–A5 与 #185**：按现有独立 PR 边界推进；涉及公开类型、绑定生成或 provider/core 边界的部分，先核对 #200 的决策影响，避免重复实施。A2 的源码迁移说明保留。
5. **B1 + C2**：后续 provider 删除的解锁项；B4/B5 还需完成直接构造调用点迁移。#174 依赖 B1，#175 依赖 #174。
6. **ops schema / L0 passthrough**：分别明确跟踪项和验收条件。ops 至少覆盖 op×handle、错误信封、二进制帧、版本协商与取消；passthrough 覆盖字节保真及 auth / 重试 / 录制的共享路径。

1. **RFC-0032 / 0033 入库**：B1 与 #174 的前提。
2. **S1 + S2**：一个小 PR——改 profile 名、staticlib job 换 profile、全产物体积阈值。
3. **A2–A5**：四个独立 PR；#166 的 A1 checkbox 补勾（#169 已合入）。
4. **#185**：先删 tracker，再换 `ToolInput`。
5. **B1 + C2**：解锁项。
每项记录依赖、验收条件、关联 PR 和复核日期；方向变更确认后再调整版本归属。

## 5. 版本节奏预估

Expand Down
Loading