wait4x/blog
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(post): 工具三部曲——spec-harness/pi-mesh 全家桶/Agensh 论文笔记

Browse Source 
用户直派车道交付：①Spec Harness 详解（任务包解剖+流水线图，
boundary/verify 实例+12 命令+门禁）②pi-mesh 四件套（stack 图+
合奏循环图+上手安装）③Agensh 论文笔记（三支柱/协作环/规模收
益图，DeLM 血统+issue#13→pi-board 诞生线）。七张自绘 SVG、双
语（en 手写直译 locked:true，禁 TMT 覆盖）。与既有 spec-
workflow-and-mesh（实战复盘向）互补并存。

车道：worker-one（build/lint/外链 curl/视觉两轮 7/7 全绿）；收
编复验 E2E 34/34+lint 43 页 0/0/0

验证: pnpm astro build 39 文；E2E 34/34；content-lint 0/0/0

Spec: none (内容三篇，直派车道收编)

Co-authored-by: GLM-5.3
This commit is contained in:
wait4xandGLM-5.3 committed 2026-11-01 13:35:27 +08:00
1 parent 127f349fb2
commit 8571acdc8b
13 files changed
+676
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

content/posts/assets/pi-mesh-stack/loop.svg
+47
View File
@@ -0,0 +1,47 @@
<svg xmlns="http://www.w3.org/2000/svg" width="980" height="330" viewBox="0 0 980 330" font-family="ui-sans-serif, system-ui, 'Noto Sans SC', 'PingFang SC', sans-serif">
<rect width="980" height="330" fill="#ffffff"/>
<text x="490" y="40" text-anchor="middle" font-size="19" font-weight="600" fill="#111113">一次典型合奏：四件套怎么咬合</text>
<!-- 5 nodes -->
<rect x="30" y="80" width="158" height="96" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="109" y="108" text-anchor="middle" font-size="14" font-weight="600" fill="#3454d1" font-family="ui-monospace, monospace">mesh_send</text>
<text x="109" y="132" text-anchor="middle" font-size="12" fill="#33343a">契约式派单 / 对话</text>
<text x="109" y="152" text-anchor="middle" font-size="11.5" fill="#6b6e78">五字段任务包 + 期限</text>
<rect x="216" y="80" width="158" height="96" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="295" y="108" text-anchor="middle" font-size="14" font-weight="600" fill="#3454d1" font-family="ui-monospace, monospace">board_grep</text>
<text x="295" y="132" text-anchor="middle" font-size="12" fill="#33343a">先查团队记忆</text>
<text x="295" y="152" text-anchor="middle" font-size="11.5" fill="#6b6e78">FAIL 可检索不重烧</text>
<rect x="402" y="80" width="158" height="96" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="481" y="108" text-anchor="middle" font-size="14" font-weight="600" fill="#3454d1" font-family="ui-monospace, monospace">job_run</text>
<text x="481" y="132" text-anchor="middle" font-size="12" fill="#33343a">长活交后台</text>
<text x="481" y="152" text-anchor="middle" font-size="11.5" fill="#6b6e78">turn 不阻塞</text>
<rect x="588" y="80" width="158" height="96" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="667" y="108" text-anchor="middle" font-size="14" font-weight="600" fill="#3454d1" font-family="ui-monospace, monospace">mesh_claim</text>
<text x="667" y="132" text-anchor="middle" font-size="12" fill="#33343a">单写者租约</text>
<text x="667" y="152" text-anchor="middle" font-size="11.5" fill="#6b6e78">epoch:fence 围栏</text>
<rect x="774" y="80" width="158" height="96" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="853" y="108" text-anchor="middle" font-size="14" font-weight="600" fill="#3454d1" font-family="ui-monospace, monospace">board_write</text>
<text x="853" y="132" text-anchor="middle" font-size="12" fill="#33343a">留痕</text>
<text x="853" y="152" text-anchor="middle" font-size="11.5" fill="#6b6e78">CLAIM 带租约号</text>
<!-- 正向箭头 -->
<line x1="188" y1="128" x2="214" y2="128" stroke="#6b6e78" stroke-width="1.5"/>
<polygon points="214,128 205,123.5 205,132.5" fill="#6b6e78"/>
<line x1="374" y1="128" x2="400" y2="128" stroke="#6b6e78" stroke-width="1.5"/>
<polygon points="400,128 391,123.5 391,132.5" fill="#6b6e78"/>
<line x1="560" y1="128" x2="586" y2="128" stroke="#6b6e78" stroke-width="1.5"/>
<polygon points="586,128 577,123.5 577,132.5" fill="#6b6e78"/>
<line x1="746" y1="128" x2="772" y2="128" stroke="#6b6e78" stroke-width="1.5"/>
<polygon points="772,128 763,123.5 763,132.5" fill="#6b6e78"/>
<!-- 回环箭头 -->
<path d="M 853 176 L 853 216 L 109 216 L 109 178" fill="none" stroke="#a0a3ad" stroke-width="1.4" stroke-dasharray="5 4"/>
<polygon points="109,178 104,187 114,187" fill="#a0a3ad"/>
<text x="481" y="238" text-anchor="middle" font-size="12" fill="#6b6e78">发现与结论回写团队记忆，下一轮派单从存量知识起步</text>
<text x="490" y="290" text-anchor="middle" font-size="13.5" fill="#33343a">对话走 mesh · 记忆上 board · 长活交 jobd · 排他靠租约</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 3.6 KiB

content/posts/assets/pi-mesh-stack/stack.svg
+47
View File
@@ -0,0 +1,47 @@
<svg xmlns="http://www.w3.org/2000/svg" width="960" height="470" viewBox="0 0 960 470" font-family="ui-sans-serif, system-ui, 'Noto Sans SC', 'PingFang SC', sans-serif">
<rect width="960" height="470" fill="#ffffff"/>
<text x="480" y="38" text-anchor="middle" font-size="19" font-weight="600" fill="#111113">pi-mesh 工具族：一个路由器，三个卫星</text>
<!-- 顶部：pi 终端 -->
<rect x="80" y="62" width="200" height="58" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="180" y="86" text-anchor="middle" font-size="13.5" font-weight="600" fill="#111113">pi 终端 @op-gitea</text>
<text x="180" y="106" text-anchor="middle" font-size="11.5" fill="#6b6e78">edit/write 受预约拦截</text>
<rect x="380" y="62" width="200" height="58" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="480" y="86" text-anchor="middle" font-size="13.5" font-weight="600" fill="#111113">pi 终端 @op-artalk</text>
<text x="480" y="106" text-anchor="middle" font-size="11.5" fill="#6b6e78">读回执 · 忙闲状态</text>
<rect x="680" y="62" width="200" height="58" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="780" y="86" text-anchor="middle" font-size="13.5" font-weight="600" fill="#111113">pimesh attach / CLI</text>
<text x="780" y="106" text-anchor="middle" font-size="11.5" fill="#6b6e78">无会话独立 peer</text>
<line x1="180" y1="120" x2="180" y2="150" stroke="#a0a3ad"/>
<line x1="480" y1="120" x2="480" y2="150" stroke="#a0a3ad"/>
<line x1="780" y1="120" x2="780" y2="150" stroke="#a0a3ad"/>
<!-- mesh 骨干 -->
<rect x="60" y="150" width="840" height="110" rx="12" fill="#ffffff" stroke="#3454d1" stroke-width="1.6"/>
<text x="90" y="180" font-size="15" font-weight="600" fill="#3454d1">pi-mesh —— 通信骨干（github.com/cgarrot/pi-mesh）</text>
<text x="90" y="206" font-size="12.5" fill="#33343a">broker（内存态：peers / rooms / 邮箱 / 限速）· 房间与角色 member/observer</text>
<text x="90" y="228" font-size="12.5" fill="#33343a">mesh_reserve 路径预约 · mesh_claim 单写者租约（epoch:fence，commit-msg 钩子拒过期围栏）</text>
<text x="90" y="250" font-size="12.5" fill="#33343a">优先级 normal / urgent / force · 状态诚实三档 delivered ≠ read ≠ answered · 台账 hash-only</text>
<!-- 连接线到卫星 -->
<line x1="240" y1="260" x2="240" y2="300" stroke="#a0a3ad"/>
<line x1="480" y1="260" x2="480" y2="300" stroke="#a0a3ad"/>
<line x1="720" y1="260" x2="720" y2="300" stroke="#a0a3ad"/>
<!-- 三个卫星 -->
<rect x="70" y="300" width="330" height="110" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="90" y="328" font-size="14" font-weight="600" fill="#111113">pi-board —— 团队记忆板</text>
<text x="90" y="350" font-size="12" fill="#33343a">OBSERVED/FACT/FAIL/CLAIM/PATCH_SUMMARY</text>
<text x="90" y="370" font-size="12" fill="#33343a">有界 append-only 存储 · 布尔检索 board_grep</text>
<text x="90" y="390" font-size="11.5" fill="#6b6e78">以普通 peer 入房；自有存储，broker 零持久化</text>
<rect x="430" y="300" width="330" height="110" rx="10" fill="#f6f7f9" stroke="#d0d4da"/>
<text x="450" y="328" font-size="14" font-weight="600" fill="#111113">pi-jobd —— 后台作业守护</text>
<text x="450" y="350" font-size="12" fill="#33343a">脱离 turn 的进程组 · 存活于 /reload 与会话之外</text>
<text x="450" y="370" font-size="12" fill="#33343a">诚实状态机（lost = 无法证明归属则拒操作）</text>
<text x="450" y="390" font-size="11.5" fill="#6b6e78">mesh_job_control 跨 peer 远程 stop/pause/resume</text>
<rect x="70" y="424" width="690" height="38" rx="8" fill="rgba(52,84,209,0.05)" stroke="#3454d1" stroke-dasharray="6 4" stroke-width="1.1"/>
<text x="415" y="448" text-anchor="middle" font-size="12" fill="#33343a">pi-subagents（worker 控制：spawn/steer/abort，mesh_run_control）与上面三者同族协作</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 3.9 KiB