From 5d395116d15c72904d6e54f85461e7d1446b0125 Mon Sep 17 00:00:00 2001 From: JianFeeeee Date: Sun, 20 Sep 2026 22:49:56 +0800 Subject: [PATCH] =?UTF-8?q?site:=20=E4=BF=AE=E6=AD=A3=20FAQ=20=E4=B8=89?= =?UTF-8?q?=E5=A4=84=E4=B8=8E=E6=BA=90=E7=A0=81=E4=B8=8D=E7=AC=A6=E7=9A=84?= =?UTF-8?q?=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户指出「常见问题部分描述不太符合事实」。逐条对着源码核了六条， 查出三处不准（第 4 条是实质性误导），另修掉一个由此暴露的滚动缺陷。 ## ① 第 3 条：「L4 是内核保留的」漏了一半 源码 `interruptLevel(evt, privileged)` 有**两条**放行 L4 的路径： `privileged=true`（内核）与 `isKernelLevelSource`（编译期内置插件）。 `scheduler.go:74` 的注释也写明「只给内核与编译期内置插件」。 原文只说「内核保留」，会把内置插件的能力说没。已补上。 （「外部插件声明 L4 会被夹到 L3」这句本身没错，`clampPluginLevel` 确实如此。） ## ② 第 4 条：自动转投默认是关闭的 —— 原文读起来像默认行为 `DefaultOffloadOptions()` 返回 `Enabled: false`，源码注明理由： 「默认关闭、由部署方显式打开，与『显式才是特权』同一条理由」。 原文说「内核拉起临时驻留子接手」，通篇没提这个前提，读者会以为开箱即用。 已补上「默认关闭」并给出默认阈值（实测 `defaultOffloadBusyAfter = 5min`、 `defaultOffloadMinPending = 3`，原文只说「忙超阈值」「积压够多」，没给数）。 ## ③ 第 5 条：「媒体跟着记忆块走」不完整 `payloadHeld()` 的存在说明有**共享**一说：同一份字节可能被多个块持有， 此时**不删**。两个删除点（`medialoop.forgetPayloads` 与 `sdk/memory_impl.go`） 都各自做了 `stillHeld` / `payloadHeld` 检查，注释写明 「同一张图可能被多个块引用」。「跟着块走」会让人以为按块计数即可。 已改为「如果同一份字节仍被别的块共享，则不删」。 ## 核对无误的四条（未改） - 第 1 条：`现场保存/恢复`、`中断栈` 都是 `scheduler.go` 的原词；四级中断、 上下文预算、蒸馏与召回均在 - 第 2 条：三通道准确（`proc/shm.go` 顶注：`stdio JSON-RPC` 控制面 / `shm + 偏移` 数据面 / `eventfd` 通知面「事件环 post-and-forget」）； 「摘除工具、阶段与通道」对应 `UnregisterPluginTools` / `UnregisterPluginStages` / `releasePluginChannels`；`onProcCrash` 注释即 「摘注册面、喂健康计数、排一次重启」 - 第 6 条：`go:embed adapters/*.lua` 真嵌入；9 个名字与 `internal/lua/adapters/` 下文件逐一对应（`server.lua` 是网关脚本，不计入） ## ④ 顺带修掉：FAQ 全部展开后滚不到底 改动后我照例量了末尾能否到底，发现**全部展开时卡住、页脚不可见**： 展开后 faq 712 + footer 367 = 1079 > 一屏 900，`mandatory` 又把滚动锁住。 这里走了两次弯路，都记进注释了： - 先想只让 faq 退出吸附 → **死锁**：它下方没有吸附点，而 mandatory 只允许 停在吸附点，实测卡在 plugins 的吸附位（y=9455）不再前进 - 阈值先误用「视口高」→ 展开后 faq 高 712 < 892，判不出超限，类根本加不上 最终改为「展开超过『视口高 − 页脚高』时整页切到自由滚动」， 因为 faq 是最后一个吸附节，它一旦装不下，末尾就必须整体自由。 ## 验证 - 折叠态：到底=true，页脚可见，faq 标题不被导航遮挡（h2 顶 210 > 67） - 展开 1 条 / 展开全部 6 条：两种状态都到底=true、页脚可见 - 一滑一页仍生效（8/8 次停靠不同节，72px 偏移为导航高度） - 深浅双主题 / JS 禁用 / reduce / 390·768·1440 三档：全绿，零横向溢出，无控制台错误 --- site/index.html | 42 +++++++++++++++++++++++++++++++++++++----- 1 file changed, 37 insertions(+), 5 deletions(-) diff --git a/site/index.html b/site/index.html index 03be0b5..cd953a6 100644 --- a/site/index.html +++ b/site/index.html @@ -342,6 +342,13 @@ scroll-snap-align: start; } section > .wrap { width: min(1120px, 92vw); margin: 0 auto; } + /* FAQ 展开超过一屏时：整页切到自由滚动。 + 为何不是只让 faq 退出吸附 —— 试过了，会死锁：faq 退出吸附后它下方 + 没有吸附点，而 mandatory 只允许停在吸附点，实测卡在 plugins 的 + 吸附位（y=9455）不再前进，页脚永远到不了。 + 因为 faq 是最后一个吸附节，它一旦不能吸附，末尾就必须整体自由滚动。 */ + html.faq-open { scroll-snap-type: none; } + /* 内容比一屏高的节（运行时打 .too-tall）：取消 min-height 撑高， 但**保留吸附点**。 为何不让它退出吸附（实测过的死锁）：把它设为 snap-align:none 后， @@ -2822,8 +2829,8 @@ echo "你好，记住我喜欢喝咖啡" | ./build/waiter 为什么消息会「排队」而不是立即处理？

因为同一时刻只应有一个任务在改上下文。同级抢占会让两边都做一半。 - 需要立刻插队时用更高级别的中断：插件可声明 L1–L3，L4 是内核保留的 - 「立即打断」（panic、内核事件），外部插件声明 L4 会被夹到 L3。 + 需要立刻插队时用更高级别的中断：插件声明 L1–L3，L4 是「立即打断」 + （panic、内核事件），只给内核与编译期内置插件 —— 外部插件声明 L4 会被夹到 L3。 不该让所有消息都变成抢占者。

@@ -2831,8 +2838,10 @@ echo "你好，记住我喜欢喝咖啡" | ./build/waiter
长任务会不会让用户等很久？

- 这正是「分诊助手」的用途。主 agent 忙超阈值且积压够多时，内核拉起临时 - 驻留子接手：能办的直接办，需要主 agent 的立刻回「忙碌中，请稍候」。 + 这正是「分诊助手」的用途。主 agent 忙超阈值（默认 5 分钟）且积压够多（默认 3 条） + 时，内核可拉起临时驻留子接手：能办的直接办，需要主 agent 的立刻回「忙碌中，请稍候」。 + 这个自动转投默认关闭，由部署方显式打开 —— 它属于「内核替父做决策」，与 + 「显式才是特权」同一条理由。

@@ -2840,7 +2849,7 @@ echo "你好，记住我喜欢喝咖啡" | ./build/waiter 记忆会不会无限膨胀？

不会。三层是迁移而非复制：上下文事件裁剪后归档成文档，文档冷掉后蒸馏成 - 图谱三元组。图谱有去重与 UNIQUE 约束；媒体跟着记忆块走，块被永久删除时才回收字节。 + 图谱三元组。图谱有去重与 UNIQUE 约束；媒体字节在块被永久删除时回收，但如果同一份字节仍被别的块共享，则不删。

@@ -3039,6 +3048,29 @@ echo "你好，记住我喜欢喝咖啡" | ./build/waiter window.addEventListener("load", markTall); window.addEventListener("resize", markTall); + // FAQ 展开后可能远超一屏。此时若仍吸附，mandatory 会把滚动锁在 + // 吸附点上，末尾（含页脚）就再也到不了 —— 实测全部展开时卡住、 + // 页脚不可见。故展开态一旦超一屏就让该节退出吸附。 + var markFaqOpen = function () { + var faq = document.getElementById("faq"); + if (!faq) return; + // 阈值不是「视口高」而是「视口高 − 页脚高」： + // 末尾的约束是 faq + footer 要一起装进一屏。用视口高当阈值时， + // 展开后 faq 高 712 < 892，判不出超限，类加不上（踩过这个错）。 + var ft = document.querySelector("footer"); + var ftH = ft ? ft.getBoundingClientRect().height : 0; + var limit = window.innerHeight - ftH - 8; + var over = faq.getBoundingClientRect().height > limit; + // 注意是切 html 上的类（整页退出吸附），不是在 faq 上加类。 + // 只让 faq 退出吸附会死锁：它下方没有吸附点，而 mandatory + // 只允许停在吸附点 —— 实测卡在 plugins 的吸附位不再前进。 + document.documentElement.classList.toggle("faq-open", over); + }; + markFaqOpen(); + [].slice.call(document.querySelectorAll("details.faq")).forEach(function (d) { + d.addEventListener("toggle", markFaqOpen); + }); + // 不再用「3 秒后强制全部 reveal」的兜底： // 那会把已退场的元素强行拉回来，退场动画就废了。 // 改为只在 observer 不存在时（已在上面分支处理）整体 reveal。