Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
0819e35
docs: 立项 M14 网络源测速与回环中继并定稿增补 2 (T14.1)
qiyinxi Sep 11, 2026
5544b78
feat: progress 事件追加细目字段与 network.probe stage (T14.6)
qiyinxi Sep 11, 2026
96387bb
feat: 并行探测网络源吞吐与首字节延迟 (T14.2)
qiyinxi Sep 11, 2026
54e28ce
feat: 按实测结果重排镜像源顺序 (T14.2)
qiyinxi Sep 11, 2026
b2e214b
feat: 锁内制品规划器与 marker 子集求值 (T14.4)
qiyinxi Sep 11, 2026
06f1f95
docs: 规划器改用 LockArtifact 并记录真实锁的规划结果 (T14.4)
qiyinxi Sep 11, 2026
f8c2d25
feat: 回环中继服务与路由校验 (T14.3)
qiyinxi Sep 11, 2026
fe94d5f
feat: 进程内缓存网络源实测顺序 (T14.2)
qiyinxi Sep 11, 2026
b77f6ef
feat: UV_HTTP_TIMEOUT 受控覆盖与 python 探针路径来源 (T14.4)
qiyinxi Sep 11, 2026
9dbce7c
feat: Python 分发源目录增补 astral (T14.2)
qiyinxi Sep 11, 2026
b9f18a2
feat: 中继单流取回与多源回退 (T14.3)
qiyinxi Sep 11, 2026
53800da
refactor: Git 源尝试顺序改为可注入的 ctx 感知构造函数 (T14.4)
qiyinxi Sep 11, 2026
5741db6
feat: 中继大文件分片并行取回 (T14.3)
qiyinxi Sep 11, 2026
0d7dea6
feat: 中继 simple 索引改写与回退 (T14.3)
qiyinxi Sep 11, 2026
c6bad2c
feat: 网络源尝试顺序统一经可注入的 PlanFunc 取得 (T14.4)
qiyinxi Sep 11, 2026
8589fa5
merge: 并入 T14.2 网络源测速与实测排序
qiyinxi Sep 11, 2026
7fd8edd
test: 覆盖中继进度节流与结果摘要 (T14.3)
qiyinxi Sep 11, 2026
2666725
test: 覆盖中继并发共享取回与文件数背压 (T14.3)
qiyinxi Sep 11, 2026
3af800e
feat: Ranker 把探测、排序与缓存组合成可注入的 PlanFunc (T14.4)
qiyinxi Sep 11, 2026
0b2cba5
feat: Ranker 增加排序完成回调供 network.probe 收口 (T14.4)
qiyinxi Sep 11, 2026
3e2977b
merge: 并入 T14.3 回环中继 internal/relay
qiyinxi Sep 11, 2026
84b19b3
feat: 依赖同步与 Python 安装改经回环中继 (T14.4)
qiyinxi Sep 11, 2026
19ce0e9
feat: 受监督注入面支持回环中继首项 (T14.4)
qiyinxi Sep 11, 2026
64d44a5
feat: 会话级测速器接入各命令并在 supervise 期间常驻回环中继 (T14.5)
qiyinxi Sep 11, 2026
17677db
feat: 中继字节进度与摘要接入 bootstrap / dependencies / repair (T14.5)
qiyinxi Sep 11, 2026
7504a42
test: 真实中继串起锁改写、假 uv 取回与坏源换源的组件测试 (T14.7)
qiyinxi Sep 11, 2026
ccbe2d3
docs: 记录 M14 完成情况与黑盒验收,探测改为惰性触发 (T14.7)
qiyinxi Sep 11, 2026
1a7e533
docs: 回写 M14 设计验收记录与任务进度,C16 触发口径改为惰性 (T14.7)
qiyinxi Sep 11, 2026
aab1843
chore: 删除未使用的 relay.ErrClosed (T14.3)
qiyinxi Sep 11, 2026
092961c
fix: 测速吞吐改三态并给 uv.download 补细目字段 (T14.5)
qiyinxi Sep 11, 2026
8b063f0
fix: 中继诊断不再丢失 (T14.5)
qiyinxi Sep 11, 2026
a0f4174
feat: 分片取回的慢源判定 (T14.8)
qiyinxi Sep 11, 2026
c2dc461
fix: 收尾判慢等落后者够龄再判,不再退出后干等 (T14.8)
qiyinxi Sep 11, 2026
2bf1242
docs: 记录复核修复、T14.8 与后两次黑盒 (T14.7)
qiyinxi Sep 11, 2026
6a2a9cf
fix: 隔离宿主 uv 配置与 Python 环境变量 (T14.9)
qiyinxi Sep 11, 2026
0d8ac22
test: 锁定显式注入例外并稳定 NO_PROXY 测试清理 (T14.9)
qiyinxi Sep 11, 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
4 changes: 3 additions & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,6 +48,7 @@ Vue/Electron/Python 的改写、CI/CD 发布流程本身。
| M11 跨平台适配(Linux/macOS) | 规划中(决策 D7,2026-08-04 立项);仅 T11.1 设计任务可执行 |
| M12 遥测与错误观测(Sentry-only) | T12.1、T12.2、T12.4、T12.5、T12.7 已完成;T12.6 本地发布配置已提交,待 Repository secret 与授权后的远端验收;T12.3/Umami 已取消 |
| M13 dev 基线接入配套 | 2026-08-31 按决策 D12 与 `doc/契约补充-v1-增补1.md`(C6~C11)立项;T13.1(后端工作目录)、T13.2(Job 允许显式脱离)、T13.3(关闭超时参数化,含优雅关闭误报修复)、T13.4(锁副本改写参与包索引镜像轮换,显式 package-index 排最前)**已完成**;T13.5 **已完成**(注入面 `020b3b9`:`AUTO_MAS_UV_CACHE_DIR` / `AUTO_MAS_UV_PYTHON_INSTALL_DIR` / `AUTO_MAS_MIRROR_PACKAGE_INDEX` / `AUTO_MAS_MIRROR_PYTHON`;池目录重新分类按设计关闭——Runtime 的 repair/cleanup 只处理自己的目录,池 venv 失效后由后端判定重建);T13.6 ⏸ 未开始;2026-09-02 真机联调后按增补 1 **C12 / C13** 完成 T13.7(`f7d5edb`:`backend supervise --port`,缺省 managed 36163 / development 36164,注入 `AUTO_MAS_SUPERVISED_PORT`,健康/关闭地址与 `baseUrl` 由 `internal/health` 派生,E2E 改用空闲端口)与 T13.8(`41c51d3`,收尾 `23033f9`:`backend supervise` 的 stdin EOF / 读取出错视为隐式 shutdown,stdout 已断不影响 HTTP 优雅关闭,真实 exe 黑盒 E2E 锁定,宿主崩溃不再留孤儿)**已完成**;T13.9(`da710c4`,增补 1 C14:新 warning `BACKEND_ORPHANS_REAPED`,`BACKEND_FORCE_TERMINATED` 收窄为主进程被强杀)**已完成**;T13.10(`c46babf`,C13 第 4 条修订:协议日志转发失败不再回给 process 层,避免宿主崩溃时把正在优雅关闭的后端连同进程树杀掉)与 T13.11(`7fa56a1`,C15:Job 快照跳过正在消亡的成员、健康探针错误连续 3 次才判失败、根进程已退出时不再发 close)**已完成**;T13.14(`e8bc217`:克隆传输期脉冲由「按 sideband 写入次数计数、上限 64」改为固定间隔时间心跳,仍只发不带数值的 running)**已完成** |
| M14 网络源测速与回环中继 | 2026-09-11 按用户需求与 `doc/契约补充-v1-增补2.md`(C16~C20)立项并当日完成:T14.1(契约与设计)、T14.2(测速排序,惰性触发)、T14.3(`internal/relay` 回环中继)、T14.4(uv 接线与锁规划)、T14.5(CLI、字节进度、supervise 常驻)、T14.6(protocol 字段与 `network.probe`)、T14.7(组件矩阵与三次真实镜像黑盒)、T14.8(分片取回的慢源判定)、T14.9(宿主配置与 Python 环境隔离:`UV_NO_CONFIG=1`、`PYTHON*` / 颜色 / Rust 调试变量剔除、`NO_PROXY` 必含回环)**已完成**;本地 `main` 领先 `origin/main` 未推送,发版与 AUTO-MAS 钉扎待用户授权 |

代码现状:

Expand Down Expand Up @@ -79,12 +80,13 @@ Git:远端 `origin` = `git@github.com:AUTO-MAS-Project/AUTO-MAS-Runtime.git`
| [doc/架构设计.md](doc/架构设计.md) | 冻结的系统架构:边界、CLI 命令树、NDJSON 协议、错误码/退出码/stage/state 全集、Git 更新流程、uv 策略、目录安全、测试矩阵、验收标准 | 任何涉及对外契约的改动 |
| [doc/契约补充-v1.md](doc/契约补充-v1.md) | 协议 v1 的 5 项定稿细节(C1~C5:后端端口(已由增补 1 C12 改为 Runtime 注入)、身份注入环境变量、`failed` 字面量、`AUTO_MAS_SUPERVISED=1`、development 检查边界) | 涉及后端启动/健康检查/环境变量 |
| [doc/契约补充-v1-增补1.md](doc/契约补充-v1-增补1.md) | 对 v1 的增量修订(C6~C11:后端工作目录、受监督优先级扩展到端口、Job 逃逸、关闭预算参数化、依赖镜像改写轮换、运行池基础设施共享),并修订 C2 第 1 条与 C4 第 1 条 | 同上;**与 `契约补充-v1.md` 冲突时以本文件为准** |
| [doc/契约补充-v1-增补2.md](doc/契约补充-v1-增补2.md) | 第二次增量修订(C16~C19:网络源测速排序、回环中继、进度事件字节字段与细目、Python 分发源增补),并修订增补 1 的 C10 第 3/7 条与 C11 第 3 条 | 涉及镜像、下载、进度事件;**与增补 1 冲突时以本文件为准** |
| [doc/任务拆分.md](doc/任务拆分.md) | 逐任务清单、依赖、验收项、决策记录 D1~D12、待决项 D-open-*、AUTO-MAS 侧 TODO、变更记录 | **每次开工前**确认自己在做哪个任务 |
| [doc/代码审查清单.md](doc/代码审查清单.md) | 自动化门禁覆盖不到的架构边界检查 | 提交前自查、审查他人代码 |
| `doc/current/M*/` | 尚未完成任务的设计与实施计划 | 执行某个具体任务时 |
| `doc/archive/M*/` | 已完成阶段仍有解释价值的设计与审查记录 | 追溯设计背景时 |

**优先级:** 契约补充-v1-增补1(最新增量修订) > 契约补充-v1(更具体) > 架构设计(概括) > 任务拆分(派生清单)。
**优先级:** 契约补充-v1-增补2(最新增量修订) > 契约补充-v1-增补1 > 契约补充-v1(更具体) > 架构设计(概括) > 任务拆分(派生清单)。

---

Expand Down
3 changes: 2 additions & 1 deletion doc/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,12 @@
| [架构设计](./架构设计.md) | 系统边界、对外契约、目录安全、命令树和验收标准 |
| [协议 v1 契约补充](./契约补充-v1.md) | 后端端口、身份注入、健康检查等具体契约(C1~C5) |
| [协议 v1 契约补充 增补 1](./契约补充-v1-增补1.md) | 对 v1 的增量修订:工作目录、受监督优先级、Job 逃逸、关闭预算、依赖镜像、运行池基础设施(C6~C11) |
| [协议 v1 契约补充 增补 2](./契约补充-v1-增补2.md) | 第二次增量修订:网络源测速排序、回环中继、进度事件字节字段与细目、Python 分发源增补(C16~C19) |
| [任务拆分](./任务拆分.md) | 任务依赖、验收、决策和当前进度 |
| [代码审查清单](./代码审查清单.md) | 自动化门禁之外的架构边界检查 |
| [T1.3 生命周期设计](./设计-T1.3-生命周期状态机.md) | 协议测试直接读取的生命周期契约夹具 |

权威优先级仍为:`契约补充-v1-增补1.md` > `契约补充-v1.md` > `架构设计.md` > `任务拆分.md`。
权威优先级仍为:`契约补充-v1-增补2.md` > `契约补充-v1-增补1.md` > `契约补充-v1.md` > `架构设计.md` > `任务拆分.md`。

## 按用途浏览

Expand Down
Loading