feat(overlay): 内容块级寻址 + 实例逐步拉起 + 骨干选路 + 组密钥加密（序24–㉛ 累积同步）
代码
- 内容分发块级寻址：新增 src/net/relay/content/{chunker,store,runtime,source,peer,crypto}.ts
- 组密钥（C 档）确定性加密：AES-256-GCM，块 id β′ = sha256(密文) 前 32 hex；双 epoch 过渡窗口
- 实例生命周期：三处 teardown() 不再杀实例（local/remote/leased-spawner）；启动认领 + TCP 探活判孤儿
- 骨干选路：jitter 选路 + endpoint-target；relay client/server/wire/identity/directory/rendezvous/switcher 调整
- 工作台 src/web/server.ts、src/worker/relay-tunnel.ts 装配与候选链观测
脚本与测试
- scripts/overlay-{probe,keyring,jitter}.cjs 更新
- 探针新增 OBS-21（每连接候选数）/ OBS-22（teardown 静态守卫 + 认领面）/ OBS-23（组密钥加密）
- 新增 test/{orchestrator-teardown,orchestrator-rehydrate,overlay-content,overlay-jitter}.test.mjs；relay 两例更新
文档
- 新增交接单：覆盖网络-序24-内容分发块级寻址 / 序25-实例逐步拉起 / 序26-骨干稳定选路与加密
- INDEX.md、交接单/README.md、skills/dsh-auto-handoff-chain/SKILL.md 同步
验收（零回归，2026-09-18 08:0x 复核）
- npm test 201 tests / 200 pass / 0 fail / 1 skipped
- overlay-failover-drill --scene all --table 12 PASS / 0 SKIP / 0 FAIL
- overlay-probe --table 23 PASS / 0 SKIP / 0 FAIL (rc=0)
This commit is contained in:
admin committed
1 parent
04776af4b1
commit
09ce76f3af
38 files changed
+9133
-211
No files matched your search
@@ -1,8 +1,8 @@
|
||||
---
|
||||
name: dsh-auto-handoff-chain
|
||||
description: 长任务「多棒自动接力」编排法 —— 把一个跨越多个上下文窗口的大任务，拆成「规划棒 ↔ 执行棒」交替的一次性自动化链条，每棒做完自动开新会话接下一棒，**全程零人工点击**。当用户说「自动新建会话接续处理」「接力跑下去」「多步骤任务自动推进」「跑完一棒自动接下一棒」「无人值守推进」，或一个任务预计要跨 ≥3 个会话 / 超过一个上下文窗口时触发。核心 = 六件套 prompt 骨架（状态单点 → 唯一执行依据指针 → 全局锁 → 单一动作 → 成本纪律 → 收尾四件套）+ **登记门禁（★要拍板的，等拍了再登记 —— 用户 2026-09-17 明令，当天已有实测事故 §3.3.1）** + 五条实测防护（断链 / 双开 / once 不转完成态 / 跨过拍板点 / **下一棒定太晚**，间隔纪律见 §3.1.1）+ 实测成本基线 + 复跑脚本 `scripts/chain_report.py`。⛔ 两条关键判据：**prompt 里绝不抄任务细节**（细节只有一个漂移源 = 入口文件的「本轮动作」块）；**先判「是不是要拍板」，未命中才轮到「候选排不排得出优劣」—— 顺序颠倒就会自我扩权**。
|
||||
version: 1.3.2
|
||||
updated_at: 2026-09-17
|
||||
description: 长任务「多棒自动接力」编排法 —— 把一个跨越多个上下文窗口的大任务，拆成「规划棒 ↔ 执行棒」交替的一次性自动化链条，每棒做完自动开新会话接下一棒，**全程零人工点击**。当用户说「自动新建会话接续处理」「接力跑下去」「多步骤任务自动推进」「跑完一棒自动接下一棒」「无人值守推进」，或一个任务预计要跨 ≥3 个会话 / 超过一个上下文窗口时触发。核心 = 六件套 prompt 骨架（状态单点 → 唯一执行依据指针 → 全局锁 → 单一动作 → 成本纪律 → 收尾四件套）+ **登记门禁（★要拍板的，等拍了再登记 —— 用户 2026-09-17 明令，当天已有实测事故 §3.3.1）** + 六条实测防护（断链 / 双开 / once 不转完成态 / 跨过拍板点 / **下一棒定太晚** / **预登记多个接续棒**，排期纪律见 §3.1.1）+ 实测成本基线 + 复跑脚本 `scripts/chain_report.py`。⛔ **排期两条铁律（§3.1.1，用户 2026-09-18 明令）**：首个（唯一）接续棒 = 收口 + **5~8 分钟**；**同一时刻只挂一个接续棒**，下一棒由当棒收官时再排。⛔ 两条关键判据：**prompt 里绝不抄任务细节**（细节只有一个漂移源 = 入口文件的「本轮动作」块）；**先判「是不是要拍板」，未命中才轮到「候选排不排得出优劣」—— 顺序颠倒就会自我扩权**。
|
||||
version: 1.4.0
|
||||
updated_at: 2026-09-18
|
||||
created_from: 覆盖网络线 19 个会话（2026-09-16 ~ 09-17）的实测复盘 —— 09-17 链条连续 8 棒零断链，规划棒成本降至旧形态的 1/8–1/12
|
||||
agent_created: true
|
||||
---
|
||||
@@ -74,7 +74,7 @@ agent_created: true
|
||||
|
||||
纪律：技术实现项**自决不上抛**；只有「没有客观优劣」的取舍才列候选，且每个候选必须写「优点 / 缺点」、**候选竖排成段**（不横排）；判据必须可被第三方复现。
|
||||
|
||||
收尾（缺一即算未完成）：① 释放锁 `--release-exec`；② **先过登记门禁（见 §3.3）**——只有「下一棒可自决」才登记，**`scheduledAt` = 此刻 + 2~5 分钟（见 §3.1.1，⛔ 不许留长等待窗口）**；用**陈述句**告知「已登记自动接续、约 2~5 分钟后自动开新会话、接续点 = X」；③ 把入口 §2「🎯 本轮动作」推进到再下一棒；④ 写工作区日志。
|
||||
收尾（缺一即算未完成）：① 释放锁 `--release-exec`；② **先过登记门禁（见 §3.3）**——只有「下一棒可自决」才登记，**`scheduledAt` = 此刻 + 5~8 分钟（见 §3.1.1 铁律①，⛔ 不许留长等待窗口）**，且**同一时刻只挂一个接续棒**（§3.1.1 铁律②：⛔ 不预登记队列，后续项写进入口 §2 的「⏭️ 本线下一项」由下一棒自己排）；用**陈述句**告知「已登记自动接续、约 5~8 分钟后自动开新会话、接续点 = X」；③ 把入口 §2「🎯 本轮动作」推进到再下一棒；④ 写工作区日志。
|
||||
```
|
||||
|
||||
### 2.1 三条骨架为什么长这样（都有实测出处）
|
||||
@@ -100,18 +100,19 @@ agent_created: true
|
||||
## 3. 收尾四件套（缺一即算未完成）
|
||||
|
||||
> 这四件里**第 ② 件是唯一会"断链"的地方**，也是钩子**做不到**的地方（钩子不能创建会话、不能创建自动化）。
|
||||
> 🔴 第 ② 件的两条硬约束（详见 §3.1.1）：**只排"下一棒"这一棒**（⛔ 不预登记队列）＋ **`scheduledAt` = 收口 + 5~8 分钟**。
|
||||
|
||||
| # | 动作 | 判据 |
|
||||
|---|---|---|
|
||||
| ① | 释放锁 `--release-exec` | 跑一次信息模式确认已释放 |
|
||||
| ② | **先过 §3.3 登记门禁** → 登记下一棒的一次性 automation（**`scheduledAt` = 此刻 + 2~5 分钟**，见 §3.1.1）+ **在给用户的回复里用陈述句告知** | 门禁不过 ⇒ **不登记，改为告知"链条已暂停待拍板"**；陈述句三要素：约 2~5 分钟后自动开新会话 / **不用你操作** / 接续点 = X |
|
||||
| ② | **先过 §3.3 登记门禁** → 登记下一棒的一次性 automation（**`scheduledAt` = 此刻 + 5~8 分钟**，见 §3.1.1 铁律①；**同一时刻只挂一个**，铁律②）+ **在给用户的回复里用陈述句告知** | 门禁不过 ⇒ **不登记，改为告知"链条已暂停待拍板"**；陈述句三要素：约 5~8 分钟后自动开新会话 / **不用你操作** / 接续点 = X |
|
||||
| ③ | 把入口文件 §2「🎯 本轮动作」**推进到再下一棒** | 入口 = 下一棒的**第一信息源**；不推进 ⇒ 下一棒照旧口径做，做重工 |
|
||||
| ④ | 写工作区日志（当日 `memory/YYYY-MM-DD.md` 追加自己的小节） | 只追加自己的小节，⛔ 不重写别人的段落 |
|
||||
|
||||
### 3.1 收尾陈述句模板（实测原文，照抄）
|
||||
|
||||
```text
|
||||
已登记自动接续：一次性 automation `<id>`，约 5 分钟后（08:37）自动开新会话，不用你操作；
|
||||
已登记自动接续：一次性 automation `<id>`，约 5~8 分钟后（08:37）自动开新会话，不用你操作；
|
||||
接续点 = 序 ④「443/TCP 兜底」的规划棒（出 `交接单_443兜底_20260917.md`，只出单、不改服务器）。
|
||||
|
||||
收口：锁 抢 ✓ → 释放 ✓（08:32）｜未 commit / 未 push｜入口 §0/§2 已刷到「③ 已完成 → 下一棒 ④」｜产出物已交付。
|
||||
@@ -119,12 +120,30 @@ agent_created: true
|
||||
|
||||
**⛔ 只登记不告知 = 缺陷**：新建会话是**用户可感知的状态变更**。实测：`408636f2` 登记了自动化却一字未提，用户两小时后自己发现才追问。
|
||||
|
||||
#### 3.1.1 🔴 间隔纪律：`scheduledAt` = 收口时刻 **+ 2~5 分钟**（2026-09-17 用户追问后定）
|
||||
#### 3.1.1 🔴 排期两条铁律：**首个（也是唯一的）接续棒** = 收口 + **5~8 分钟**；⛔ **同一时刻只挂一个**（2026-09-18 用户明令定稿）
|
||||
|
||||
- **实测反例**：序⑦ 执行棒 12:2x 收口，把下一棒定在 **12:50**（留 ~25 min）⇒ 用户 12:26 直接追问「**为什么要等20多分钟才执行接续会话**」。当时的自我理由是「给用户留一个在本会话追改的窗口」＋「让旧锁自然陈旧」——**两条都站不住**：锁在收尾 ① 里**已经释放**（不存在"等锁陈旧"），而"追改窗口"等价于**主动制造 20 分钟空转**。
|
||||
- **判据**：收口那一刻，链条上**没有任何"要等的对象"** ⇒ **等待时间越短越好**（2~5 min 只用于避开调度器的最小提前量与文件落盘竞态）。
|
||||
- **唯一允许拉长的情形**：下一棒**明确要等一个外部窗口**（对方服务重启完 / 另一条棒在跑 / 用户拍板）⇒ 可以拉长，但**必须在陈述句里写明在等什么**。
|
||||
- ⛔ **不许把"给用户留追改窗口"当理由** —— 用户要的是**尽快推进**，追改可以在任何一轮直接打断。
|
||||
> 用户 2026-09-18 原话：「**首个接续任务 5-8分钟**」＋「**最好不要建立多个接续任务，一个会话结束时在排下一个**」
|
||||
|
||||
- **铁律①（间隔）**：`scheduledAt` = **收口时刻 + 5~8 分钟**。⚠️ 这 5~8 分钟是「**从本会话收口，到那"唯一一个"接续棒开跑**」的间隔 —— ⛔ **不是"棒与棒之间的间隔"**，后者根本不存在（由铁律②，任何时刻只该有一个待跑接续棒）。
|
||||
- **铁律②（唯一）**：**同一时刻只挂一个接续棒**，下一棒**只能由"正在收官的那一棒"自己排**。⛔ **禁止预登记队列 / 堆叠**（"我先把后面两棒都排上" = 违规）。
|
||||
- **后续项不会丢**：把它写进入口文件 §2 的 **「⏭️ 本线下一项（⛔ 本棒不预登记）」** 行（含要点 / 根因 / 验收基线），**由当前那一棒收官时照此立棒**。
|
||||
|
||||
**边界（哪一头都不能越）**
|
||||
|
||||
| 方向 | 判据 |
|
||||
|---|---|
|
||||
| 下限为何是 5（不是 2） | 避开调度器最小提前量与文件落盘竞态 |
|
||||
| 上限 8 何时可越 | ⛔ 只有「**要等一个外部窗口**」才允许拉长（对方服务重启完 / 另一条棒在跑 / 用户拍板），且**必须在陈述句里写明在等什么** |
|
||||
| ⛔ 不许的两条理由 | 「**给用户留追改窗口**」（追改可在任何一轮直接打断 ⇒ 等价于主动空转）· 「**怕它跑不完**」（**排期按实测基线算，不按猜不确定性算**：规划棒实测只需 **6–13 分钟**，序⑦/⑨/⑪/⑯/⑱/㉔） |
|
||||
|
||||
**实测事故 2026-09-18（一棒之内两处都犯过 ⇒ 本节因此重写）**
|
||||
|
||||
| # | 我做了什么 | 用户原话 | 性质 |
|
||||
|---|---|---|---|
|
||||
| ① | ㉘ 规划棒排到 **收口 + ~2 h**，又给 ㉙ 留 **1.5 h 余量** | 「为什么时间要定在3：00」→「㉘ 规划棒 = 01:30 **也还有1个多小时呢**」 | 违反铁律①：长空转 ＋ **用"猜不确定性"代替实测基线** |
|
||||
| ② | 用户说「**5-8分钟即可**」后，我把它读成 **"棒与棒之间的间隔"**（㉘→㉙ = 8 分钟），于是**同时挂了 ㉘ ＋ ㉙ 两个接续棒** | 「我说的是**首个**接续任务 5-8分钟，**最好不要建立多个接续任务，一个会话结束时在排下一个**」 | 违反铁律②：预登记队列。**根因 = 改规则时只在旧句子上换了个数字，没有回到本节核对规则的完整定义** |
|
||||
|
||||
⇒ **判据**：任何一次"排期调整"都要**回到本节逐条对照两条铁律**；⛔ 不许只换数字就交差 —— 数字与"口径落在哪个对象上"会一起漂移。
|
||||
|
||||
#### 3.1.2 🔴 下一棒的 **automation id 只能来自工具返回值**（2026-09-17 实测踩坑）
|
||||
|
||||
@@ -174,7 +193,7 @@ agent_created: true
|
||||
|
||||
---
|
||||
|
||||
## 4. 五条实测防护（都是真踩过的）
|
||||
## 4. 六条实测防护（都是真踩过的）
|
||||
|
||||
| # | 现象 | 后果 | 处置 |
|
||||
|---|---|---|---|
|
||||
@@ -182,7 +201,8 @@ agent_created: true
|
||||
| ② | **双开 / 重复登记** | 同一份活被跑两遍，白烧一轮 | 见 §3.2（登记前先看有没有在跑的） |
|
||||
| ③ | **once 型 automation 跑完不自动转完成态** | 列表里堆积"已过期但 ACTIVE"的一次性任务；调度器补跑窗口 **12 小时** ⇒ 理论上可能被扫到、**多开一个会话** | 实测 09-17：列表里躺着 4 条过期仍 ACTIVE 的 once 型任务。处置：**保持原样**（不动既有配置）或**设为暂停**；⛔ 不要用 shell 去改库 |
|
||||
| ④ | **自动跨过"需要拍板"的点** | 拍板未定就跑，**要等用户自己发现**（已有实测事故 §3.3.1） | **要拍板的，等拍了再登记**（§3.3 门禁） |
|
||||
| ⑤ | **下一棒 `scheduledAt` 拉太长**（实测 ~25 min） | 链条白白空转，**用户当场追问** | 实测：序⑦执行棒 12:2x 收口、下一棒排 12:50 ⇒ 用户 12:26 追问「**为什么要等20多分钟才执行接续会话**」。⇒ 修法 = §3.1.1：**= 收口时刻 + 2~5 分钟** |
|
||||
| ⑤ | **下一棒 `scheduledAt` 拉太长**（实测 ~25 min，甚至 ~2 h） | 链条白白空转，**用户当场追问** | 实测：序⑦执行棒 12:2x 收口、下一棒排 12:50 ⇒ 用户 12:26 追问「**为什么要等20多分钟才执行接续会话**」；09-18 又排过「收口 + ~2 h」。⇒ 修法 = §3.1.1 铁律①：**= 收口时刻 + 5~8 分钟**，且**按实测基线算**（规划棒 6–13 分钟） |
|
||||
| ⑥ | **预登记多个接续棒**（队列堆叠） | 链条上挂着 ≥2 个待跑棒 ⇒ 抢锁空转；后续项要么白烧要么被撤，**用户当场纠正** | 实测 09-18：㉗ 棒同时挂了 ㉘＋㉙ 两条 ⇒ 用户原话「**最好不要建立多个接续任务，一个会话结束时在排下一个**」。⇒ 修法 = §3.1.1 铁律②：**同一时刻只挂一个**；后续项写进入口 §2 的「⏭️ 本线下一项（⛔ 本棒不预登记）」，由当棒收官时立棒 |
|
||||
|
||||
---
|
||||
|
||||
@@ -231,7 +251,7 @@ agent_created: true
|
||||
1. **建入口文件** `接续入口_<线名>_<日期>.md`，把状态、定序、`§2「🎯 本轮动作」块` 写进去
|
||||
2. **让 `state.py` 能读到它**（状态脚本的 `[入口]` 段只展开入口 §2 ⇒ 钉在 §2 顶部才有用）
|
||||
3. **定序**：把整条线切成「规划棒①→执行棒①→规划棒②→…」，并**写进入口 §0**
|
||||
4. **起第一棒**：`automation_update` 建一次性 automation（`+2~15 分钟`），prompt 照 §2 骨架填
|
||||
5. **每棒收尾走完 §3 四件套**（其中第 ② 件**前置 §3.3 登记门禁**）—— 推进 §2 + 登记下一棒
|
||||
4. **起第一棒**：`automation_update` 建一次性 automation（`+5~8 分钟`，见 §3.1.1 铁律①），prompt 照 §2 骨架填
|
||||
5. **每棒收尾走完 §3 四件套**（其中第 ② 件**前置 §3.3 登记门禁**）—— 推进 §2 + 登记下一棒；🔴 **同一时刻只挂一个接续棒**：本棒只排"下一棒"一棒，后续项写进入口 §2 的「⏭️ 本线下一项」行，⛔ 不预登记队列
|
||||
6. **收口**：链条跑完时，最后一棒不登记下一棒，改为**明确告知用户"链条已完结"**
|
||||
7. **遇到拍板点**：停在「待你拍板」节（候选竖排 + 优缺点 + 我的倾向），**并明确告知链条已暂停**；等用户拍板后再由当时会话登记下一棒
|
||||
Reference in new issue
Block a user