高峰守卫 Eqarx/dsh-peak-guard

dsh-peak-guard

梁文峰是谁？我只认识梁文谷！

高峰计价时段，DSH 不许调模型。被拦下的那次调用不产生任何费用，用户收到的是一句说明，以及一份「高峰期间拦下了哪些请求」的列表。

English · 中文

一个 DSH 宿主 + 客户端插件。谷时（含周末与法定假期）什么都不做；高峰时段在 llm/stream 这个瀑布式事件上直接短路 —— 不调用 next()，所以一个字节都不会发往任何模型适配器，然后自己捏一段合法的分片流回去，于是那句说明就长在模型的回复位置上。

1. 装好之后是什么样

高峰期（默认北京时间 09:00–12:00、14:00–18:00 的工作日）你在 DSH 里发一句话，模型的回复位置出现的是（默认正经版话术）：

⛔ 高峰时段暂停模型调用（本次未产生费用）

— 现在是 DeepSeek 高峰计价时段（北京时间 09:00–12:00、14:00–18:00），高峰单价约为谷时的 2 倍；本次调用没有产生费用。
谷时 18:00 开始（还有 3 小时 12 分），届时再发即可。
需要现在继续：/peak off 30（放行 30 分钟） · 查看状态：/peak status

想要最初那个彩蛋版（现在是梁文峰时间，你马内不要了？胆子真是肥嘟嘟的），把配置里的 tone 设成 joke；也可以用 message 写任意自定义话术。
不想看下面那几行说明（只留第一句），把 hint 设成 false。

会话标题生成、上下文压缩这类「管家调用」默认不拦 —— 拦了只会让标题变成那句说明、让上下文压不动。真想「高峰期一个 token 都不发」，把 blockUtilityCalls 设成 true。

输入框那一带的两块 UI

① 左边的盾牌开关（插槽 conversation.input.left）——高峰保护总开关：

| 外观 | 含义 | 悬停提示 |
| 灰色盾牌 + 斜杠 | 开关关着 | 「点击打开：高峰时段不调用模型」 |
| 品牌色盾牌 + 对勾 | 开着，现在是谷时，待命中 | 「现在是谷时，模型调用放行；下一段高峰 09:00 开始（2 天 11 小时后）」 |
| 橙色盾牌 + 右上角橙点 | 开着，现在正在拦 | 「现在是高峰，模型调用会被拦下；谷时 18:00 开始（还有 3 小时 12 分）」 |
| 左上角数字角标 | 被拦截列表里有 N 条（超过 99 显示 99+） | —— |

开关状态落盘（重启 DSH 后仍然记得），和 /peak enable|disable 是同一个状态。
宿主未就绪时它会呈现为灰色不可用态（提示「宿主半边未就绪」）—— 那说明插件代码改过但 还没重启 DSH，见下面 §3 的生效方式。

② 输入框上方的「被拦截列表」卡片（插槽 conversation.input.dock —— 和 DSH 那张「任务」卡同一个座位） 只读记录 + 两个无害小动作：高峰期间拦下了哪些请求，看得见、不动作（不排队、不重投、不打扰任何会话）。
只在有记录时出现：

⠿ 高峰期间有 2 条请求被拦下 这些请求没有发给模型，也没有产生费用 [ ˇ ] [ ✕ ] ● 把 README 里的截图换掉 09:52 ⊘ 帮我看看这个报错 09:41 ← 被关闭收起过的：空心环+斜杠 ↑ ≤3 条默认展开（最新在前），>3 条默认折叠只留标题；点箭头展开/收起，点 ✕ 把没处理的收起

* ✕ 关闭：卡片把「当时还没处理」的记录交给宿主收起（盖上「跳过」戳），并从此默认不再展示已办 ——于是卡片随即变空、自己消失；之后新拦下的请求照旧会出现在卡片上（关掉之后再勾的已办也仍留在卡上，直到下一次关闭）。
想捞回来就去「拦截记录」页点一下那条的图标，它会恢复成正常待办。与折叠键共用同一套图标键样式（20×20、圆角、悬停底色），叉号是 1.3px（= DSH 自带的 ICON_MEDIUM_STROKE）圆头描边 SVG。
* ● → ✓ → ⊘ 三态勾选：行首那颗图标有三种状态，共用同一个 SVG： 实心点（正常待办）→ 点一下变对勾（已办，绿色，文字变淡划掉）→ 再点变回点；被「关闭」收起的显示为空心圆环 + 一道斜杠（琥珀色，含义是「关掉展示框时它还没被处理」），点一下恢复成正常待办（单向：没有手动改回跳过态的入口）。
动画都在同一套描边里完成：圆环由同一个 <circle> 从实心撑开（r 3→3.7、fill-opacity 1→0、 stroke-opacity 0→1，190ms cubic-bezier(.2,.8,.2,1)），对勾与斜杠各自用 stroke-dasharray / stroke-dashoffset「画」出来 / 收回去（240ms / 220ms）；勾选是乐观更新（先动观感再发请求，失败回滚），点了不会有延迟感； prefers-reduced-motion 下自动关掉过渡。
* 卡片列什么（纯函数 cardItems(list, dismissedAtMs)）：跳过的永不展示；已办则按时间判 ——只有「关掉那一刻之前就已办」的才收起。所以在卡片上勾「已办」不会让那行当场消失，得再关一次卡片才会收起 —— 勾错了随时反悔。开关上那个角标数的就是「还等着处理」的条数。
* 三态都是纯本地状态：不影响任何拦截行为，但都会落盘 （POST /peak-guard/set 的 {check:{id,done}} / {restore:[id]} / {dismiss:true}），重启后还在。

卡头那两枚图标键

* 两个图标键的 DOM 结构必须对称，且 SVG 要 display:block：曾经折叠键外面多包了一层 ，而那条 span 的样式在一次 CSS 重写里被删掉 → inline SVG 按文字基线对齐，被顶高 1.44px（量截图才发现）。
现在两边都是「按钮里直接装 SVG」，并有回归测试盯着。
* 整组的纵向位置由一个常量控制：CHEVRON_Y_SHIFT（0.5px 一档，负值 = 上移），两个箭头方向共用同一段 y 区间，所以展开/收起切换时图标不会上下跳。
* 卡头三枚图标（lead / chevron / close）统一描边 ICON_STROKE = 1.3（对齐 DSH 自带的 ICON_MEDIUM_STROKE，官方那个 16px 关闭键就是 1.3）；列表里的对勾用 CHECK_STROKE = 1.6 略重一点。

设置 → 拦截记录（管理页）

除了输入框上方那张小卡片，插件还在 DSH 设置里注册了一整页「拦截记录」（插槽 settings.section，注册形状照 dsh-archived-chats：{id, order, label}， label 决定左侧导航文案）。页面结构对齐 DSH 自带设置页：

拦截记录 v1.0.0 [ 全部标为已办 ] [ 清空记录 ] ────────────────────────────────────────────────────────────────────────── 全部 12 待办 6 已办 3 跳过 3 ┌──────────────────────────────────────────────────────────────────────┐ │ 🔍 搜索请求内容或会话 id │ └──────────────────────────────────────────────────────────────────────┘ ⊘ 帮我看看这个报错 09:41 a1b2c3d4 [⊘] [🗑] ← 跳过：点一下恢复为待办 ● 把 README 里的截图换掉 09:52 e5f6a7b8 [✓] [🗑] …（没有记录时是收件箱图标 +「暂无拦截记录」空态）

* 标签页：全部 / 待办 / 已办 / 跳过，各带实时计数；搜索匹配请求原文与会话 id （大小写不敏感），与标签页叠加生效。「待办」只算正常待办，被展示框收起过的那些归到「跳过」。
* 每行：三态图标键（实心点 ↔ 对勾 ↔ 空心环 + 斜杠，同一套 SVG 与描边动画；跳过态点一下即恢复为正常待办，单向）、请求原文（截断）、时间、会话尾号、删除键。
操作都是即时反馈，失败会在页面上写明错误码。
* 批量：「全部标为已办」走 POST /peak-guard/set 的 {checkAll:true}（一条请求，不是 N 条）；「清空记录」是两步确认（第一次点变成「确认清空？」，再点才真删），避免误触。
* 一次拉全量：GET /peak-guard/state?limit=200（卡片用默认 20 条，设置页要 200）；超过 200 条时页面顶上一行说明「只显示了最新的 200 条」。
* 这个页面只跟插件自己的两个路由打交道，不读任何会话数据。

💡 提示：在设置里把「跳过」改回「待办」之后，对话界面那张卡片可能要等一会儿才会显示它。
改动是立刻落盘的，设置页也会顺手把新状态推给两边共用的那份内存状态，所以切回对话界面通常立刻就能看到；万一那张卡片还是旧样子（比如两个窗口各开着一份），最多等 20 秒 ——卡片每 20 秒轮询一次，窗口重新获得焦点时也会立刻刷新。

为什么没有「一键补发 / 谷时自动补发」：做过一版，投递链路脆弱（要跨会话 resume + 排队 + 串行等待，还容易和用户手上的回合并发）且语义上自相矛盾 —— 这个插件的意义是"高峰期别烧钱"，而"谷时替你自动发一遍"是在你不在场时替你花钱。已整体砍掉，相关路由、命令、依赖（sessionController）、界面控件、配置键全部删除。插件现在只做一件事：拦下 + 记账 + 让你看见。
之前的设计推演留在 docs/DESIGN-replay-tradeoffs.md 里当记录。

几何是照官方那张卡片的 CSS 抄的（aSus8q_ 那组规则：width/max-width 用 --dsh-composer-card-max-width 与 --dsh-composer- 那套 composer 变量、border-radius: var(--dsw-radius-lg)、 background: var(--dsw-specific-menu)、box-shadow: var(--dsw-elevation-panel)、__body 内边距 6px 12px、列表 gap:8px / max-height:180px / item 行高 20px），所以它跟输入框同宽、同一水平中线，不会自己长出另一种宽度或节奏。折叠箭头是 SVG 描边图标（16px 画布 / 1.6px 描边 / 圆头圆角 currentColor），不是 ^ ˇ 字符 —— 字符的字形和粗细随字体走，跟官方那枚对不上。

三个不写就会"看起来不对"的细节（都有测试盯着）：

* 表头那格灰色说明永远渲染（没内容时是空元素）。它是 flex:auto 的弹簧 ——少了它，折叠箭头就会贴在标题后面，而不会靠右。
* 圆角胶囊/圆点必须 corner-shape:round：DSH 全局把圆角做成了 superellipse，不自带这行的话角标和提示点会被渲染成方圆角（自带组件就是这么写的）。
实现上的三条自我约束（照 DSH 官方插件开发 skill 的硬规矩）：

* 不 import 任何 DSH 自带的客户端包（连 @deepseek-ai/dsh-client-ui-primitives 都不许），UI 全手写；
* 样式只用主题令牌 --dsw-alias-，浅色/深色自动跟随 —— test/client.test.mjs 里有自动检查： CSS 里出现任何非 --dsw-alias- 的变量、或硬编码颜色，测试就判失败；装样式 / 起定时器 / 挂监听器全在 ctx.effect 里（factory 阶段零副作用），随插件卸载回收；插槽注册失败只打日志，绝不连累输入区。两块 UI 共用一份轮询，不各打各的请求。

2. 判定口径（不是拍脑袋定的）

| 规则 | 值 |
| 高峰窗口 | 本地（默认 Asia/Shanghai）09:00–12:00、14:00–18:00，半开区间 [start, end) |
| 周末 | 本地周六/周日全天谷价 |
| 法定假期 | 默认内置 2026 年中秋 + 国庆共 10 天，全天谷价（每年需更新一次） |

这套口径与 dsh-cost-meter 的峰谷计价逐项一致（那边的窗口来自 DeepSeek 控制台公告并跟随官方页面同步）。test/peak.test.mjs 里有一段差分测试：从 2026-08-22T16:00Z 到 2027-03-01、每 7 分钟采一个点，逐点比对本插件的 isPeak 与 dsh-cost-meter 的 isPeakHour，另有 60 天、每 53 分钟一次的「下一个切换点」比对。两边有一个点不一致，测试就红。

3. 安装

pwsh -File install-profile.ps1 # 装进 desktop（默认） pwsh -File install-profile.ps1 -WhatIf # 只看要做什么，不落盘 pwsh -File install-profile.ps1 -Uninstall # 卸载

脚本做四件事：备份 profile 的 package.json → 加一条 link: 依赖 → 把包名追加进 dsh.profile.bundles → 在 profile 的 node_modules 下建 junction。做完会自校验（依赖 / bundles / 链接 / 入口可达），任一项不过就以非零码退出并告诉你怎么用备份还原。

desktop 是 Electron 保留 profile，命令行 dsh plugin --profile desktop … 会被拒绝（"managed exclusively by the Electron application"），所以走脚本。

生效方式（分两种，别混）：

| 改了什么 | 怎么生效 |
| profile 组合（装/卸插件、dsh.profile.bundles、profile 的 cordis.patch.yml） | 就地热生效。本机实测：脚本写完 profile 不到一秒，include:peak-guard 就是 enabled + active |
| 插件自己的代码（lib/.js、package.json 里的 dsh.client） | 必须完全退出并重开 DSH Desktop。宿主模块是启动时 import 的，客户端产物也在启动时扫描一次（dsh-hmr 只 watch 配置文件，不管模块代码）—— 实测：改完代码后新增的 HTTP 路由与 /plugins/dsh-peak-guard/client.js 都还是 404，重启后才出现 |

4. 逃生门

被锁在门外还进不去，那就不是插件是牢房。所以留了这些路，任何一条都能把人捞出来：

| 逃生门 | 怎么用 | 生效范围 |
| 输入框左边那个开关 | 点一下（走 fetch，不需要模型参与） | 立刻，且落盘 |
| /peak enable｜disable | 等价于上面那个开关 | 立刻，且落盘 |
| /peak off [分钟] | 临时放行（命令走 commands 服务，不需要模型） | 运行时，最长到重启 |
| /peak force / /peak on | 现场强制拦 / 立刻收回 | 运行时 |
| allowSessions | 配置里写 session id 白名单 | 直到改配置 |
| DSH_PEAK_GUARD=off | 启动 DSH 前设环境变量（0/off/false/no/disable 都算关） | 整进程，重启前一直有效 |

/peak 的全部子命令：

/peak 看当前峰谷状态、窗口、拦截计数、话术与被拦截列表 /peak test 不下发请求，先看看提示语长什么样（dry-run） /peak force [分钟] 无视峰谷强制拦一段时间（默认 5 分钟）—— 用来现场验收 /peak enable|disable 高峰保护总开关（和输入框左边那个开关同一个状态，会落盘） /peak off [分钟|forever] 临时放行（默认 30 分钟；forever = 放行到重启） /peak on 立刻恢复拦截（同时收回 force / off） /peak list 列出高峰期间被拦下的请求（只是记录，插件不会替它们重投）

5. 配置

配置在 profile 的 cordis.patch.yml（id: peak-guard）；插件包自带一份带注释的 cordis.patch.yml，随 bundle 一起生效。改了配置同样要重开 DSH。

| 键 | 默认 | 说明 |
| enabled | true | 高峰保护默认值；界面开关一旦点过就以开关为准（开关落盘） |
| timeZone | Asia/Shanghai | 「本地钟点」按哪个时区算 |
| peakWindows | ["09:00-12:00","14:00-18:00"] | 高峰窗口，半开区间，支持跨午夜；[] = 永不拦截 |
| weekendsOffPeak | true | 周末全天谷价 |
| holidays | 2026 中秋+国庆 10 天 | YYYY-MM-DD，或区间 A..B |
| tone | polite | 内置话术：polite（正经）/ joke（彩蛋） |
| message | 不写 | 自定义话术，盖过 tone |
| hint | true | 是否补几行「几点转谷时 / 怎么硬闯」 |
| blockUtilityCalls | false | 是否连会话标题/压缩也拦 |
| allowSessions | [] | 白名单 session id |
| snoozeMinutes | 30 | /peak off 不带参数时的默认放行分钟数 |
| blockedLimit | 50 | 被拦截列表最多记多少条（1–200） |
| blockedMaxAgeMinutes | 720 | 记录最大存活分钟数，超过丢弃（12 小时） |
| statePath | 不写 = <DSH_HOME>/plugin-data/dsh-peak-guard/state.json | 开关与列表的落盘位置；显式写 "" = 不落盘 |

配置写坏了不会让 DSH 起不来：类型不对的键被丢弃、退回默认值，并在 DSH 日志里留一条告警（normalizeConfig 永不抛错）。

6. 测试

powershell
node test/peak.test.mjs # 20 项：解析/边界/周末假期/坏配置/话术三态 + 与 dsh-cost-meter 的差分
node test/blocked.test.mjs # 13 项：被拦截列表纯逻辑（预览抽取、去重、上限、过期、净化、勾选、摘要）
node test/plugin.test.mjs # 34 项：假 ctx 起的宿主集成（短路、放行、命令、HTTP 路由、落盘、列表记录、老状态迁移、fail-open）
node test/client.test.mjs # 49 项：客户端离线验收（模块形态、插槽注册、令牌、文案、卡片、箭头、关闭、勾选落盘、设置页、fail-open）
node test/patch.test.mjs # 用 DSH 自己那份 js-yaml 解析 cordis.patch.yml，并把 config 过一遍归一化

合计 116 项断言，五套 exit 0 才算过。

plugin.test.mjs 用一个最小 cordis 替身把插件真的 apply 起来，然后像 DSH 那样 dispatch llm/stream，断言的是：

高峰时 next() 调用次数为 0（= 真适配器没被碰过）；
* 吐出去的分片逐个都在 StreamChunk 联合类型里，且能按 BlockAssembler 的语义组装成
一条 {type:'text'} 消息，内容逐字等于那句话，usage 在 finish 之前；
* 谷时 / enabled=false / purpose 管家调用 / 白名单 / DSH_PEAK_GUARD=off / /peak off 六条路径都真的走回真模型；
* 畸形输入（options=null、getter 抛错、next 不是函数、垃圾 config、没有 logger 的 ctx）一律不抛错，该放行的放行 —— fail-open，插件坏了不能把 DSH 弄死。

本机跑测试用的 node 是 DSH 自带的那份： %USERPROFILE%\.dsh\dsh-runtimes\dsh-primary-runtime\dependencies\node\bin\node.exe。

7. 实现要点（给下一个改它的人）

lib/peak.js 纯逻辑：解析窗口/时区、isPeak、nextTransition、话术。零 import，可单跑。
lib/http.js 界面通路：两条同源 JSON 路由的处理与防 CSRF 闸门。零 import，可用假 req/res 测。
lib/store.js 开关状态落盘：<DSH_HOME>/plugin-data/dsh-peak-guard/state.json，原子替换、永不抛错。
lib/index.js 胶水：apply(ctx, config) 里挂 llm/stream 监听器 + 注册 /peak 命令 + 注册路由。
lib/client.js 客户端半边：输入框左边那个开关（浏览器里跑，只 require('react')）。
cordis.patch.yml 随包配置（改口径就改它）。

* 拦截点：ctx.on('llm/stream', (options, next) => …)。这个事件是瀑布式的，
LlmRuntime.streamWithRegistration() 里 ctx.waterfall(this, 'llm/stream', options, () => adapterStream(...))，
返回自己的 AsyncIterable<StreamChunk> 就等于从上游把真适配器整个掐掉。
* 分片协议：block-start → text-delta → block-end → usage → finish({kind:'stop'})。
BlockAssembler 容忍只有增量的流，但补齐 block-start/end 更干净。
* options 是深冻结的：loop 构建的请求不可改写，所以这里只读、不改。
* 不写会话日志：拦下的调用没有产生任何模型可见输入，因此不存在「模型可见 ⟺ 已记录」的破坏；那次助手回复会以 0 token 记账。
* fail-open：decide() 和整条监听器都包在 try/catch 里，任何异常都退回 next()。
apply() 整体 try/catch，最坏情况是插件静默不生效。
* /peak 必须走 ctx.inject(['commands'], …) 注册（踩过的坑，别改回去）：直接写
ctx.commands.register(...) 时，如果 apply 跑得比 commands 服务 provide 早，ctx.commands
是 undefined，命令就静默不存在。后果不是报错，而是 —— 你在输入框里打 /peak test，客户端在本地命令目录里查不到这个名字（dsh-client-ui-commands 的 matchEnter： desc === undefined → return void 0），于是把它当成一句普通消息发给了模型。
挂钩 commands/change 的 UI 刷新只会在「宿主真的注册了」之后才生效，救不了这种情况。
* 永远不要直接读 ctx.<服务名>（踩过两次的坑，commands 一次、sessionController 一次）： cordis 对未 inject 的服务访问是抛错（cannot get property "X" without inject），指望 try { ctx.x } catch { ctx.get('x') } 兜底也不行 —— catch 会把 ctx.get 那条路一起短路。
统一走 ctx.inject(['x'], (scope) => { ref = scope.x })，服务就绪时把引用交进来；
再退回契约里给可选依赖用的 ctx.get("x")。表现层的症状很误导：宿主回了 no-session-controller（HTTP 409），看起来像服务不存在，其实是没 inject。
（那条用到它的补发链路后来整体砍掉了，但这条教训留着 —— 本插件仍然要 inject commands 与 webServer。）
* 界面通路同理走 ctx.inject(['webServer'], …)：webServer 在契约里是可选服务
（ctx.get("webServer") 需要判 undefined），晚到就晚注册；永远缺席也只是没有界面开关。
* 开关与相位解耦：isPeak() 是纯时间函数（不看开关），「要不要拦」由宿主半边的
effectiveEnabled() 决定。否则界面开关一旦覆盖 config.enabled，相位显示会跟着失真。
* 开关落盘：<DSH_HOME>/plugin-data/<包名>/state.json，先写 .tmp 再 rename；
* 被拦截列表的投递接口（已删除，留作记录）：曾经用宿主服务
sessionController.prompt({requestId, sessionId, mode:'queue', content:[{type:'text',text}]})
往任意会话补投一句提示。它本身可用，但整条链路（跨会话 resume、串行等待、跳过运行中会话、失败重试）复杂度远超收益，且"谷时替你自动发"与"高峰期别烧钱"自相矛盾 —— 现已整体移除，插件不再依赖 sessionController，也不再发任何写请求。
* 被拦截列表的三条不变式（lib/blocked.js）：不重（同会话同内容 60 秒内只记一条）、有界（条数上限 + 最大存活时长，坏数据一律丢弃）、只读（模块零依赖零副作用；给界面的是「最新在前 + 总数 + 截断标记」）。
* 老状态文件兼容：上一版把列表存在 queue 键下，sanitizeState 读到就搬进 list，不会让用户已经攒下的记录凭空消失（有测试盯着）。

为什么这条路真的通（源码级核对，不是猜的）

* LlmRuntime.prepareCall() 返回的 PreparedLlmCall.stream(options)，内部第一件事就是
this.streamWithRegistration(options, …)；而 streamWithRegistration 的实现正是
ctx.waterfall(this, 'llm/stream', options, () => adapterStream(...))。agent loop 用的就是这条路
（dsh-agent-loop/lib/index.js：preparedCall?.stream(request) ?? loopCtx.llm.stream(request)）
—— 必经本插件。
* loop 拿到流后逐片 AssistantStreamAttempt.push() → AssistantStreamAccumulator（严格校验： time 安全整数、chunk 可无损 JSON 化、text-delta 的 index/text 类型）→ BlockAssembler；本插件吐的五条分片逐条满足这些校验（block-start/block-end/usage/finish 按不透明 chunk 记录，text-delta 的 index=0、text 为字符串）。
* 收尾：finish.kind === 'stop'、块里没有 tool-call → loop 落一条带 usage 的 assistant/message 并 return { kind: 'completed' } 结束本步。于是那句话就长在助手气泡里，且没有任何字节离开本机。

8. 已知边界

* 假期表是年抛型数据：每年国务院安排公布后要更新 holidays（也顺手更新 dsh-cost-meter 的 DEFAULT_PEAK_HOLIDAYS，保持两边一致，差分测试才继续绿）。
* nextTransition() 用「先按小时粗扫、再在小时内按分钟定位」，对小时级窗口是精确的；若把窗口配成 15 分钟级的碎片窗口，理论上可能漏掉同小时内的多次切换（默认配置不受影响）。
* 两块 UI 都没有做浏览器端的视觉验收：开发时浏览器扩展桥没连上，所以「它们长什么样、在浅色/深色下读起来对不对、气泡和弹窗有没有被裁剪」是靠离线测试（模块形态、插槽注册、主题令牌白名单、状态→文案映射、元素树渲染、弹窗结构与按钮行为）加人工读码得到的，不等于你已经看到它。刷新页面确认过一次之后，这条限制才算解除。
* 客户端文案按 navigator.language 在中/英两套里挑，没有走 DSH 的 locale 服务 ——故意如此：多声明一个可能缺席的服务会让 fiber 停在 PENDING，代价（整块控件消失）大于收益。
要做正规本地化，再补 dsh.client.inject + locale 文案包。
* 被拦截列表只记「带 sessionId 的对话请求」：管家调用（标题/压缩）本来就不拦，没有 sessionId 的手搓调用也归不到具体会话，所以列表里不会出现它们。
* 列表是「拦下了什么」的证据，不是「可以补答的任务」：插件不会替你重投。
真想继续那条请求，请自己把话重发一遍 —— 这也是我们砍掉自动补发的原因之一。

9. 仓库结构

dsh-peak-guard/
├─ README.md / README.en.md 中文（本文）/ English ├─ CHANGELOG.md 版本记录 ├─ LICENSE MIT ├─ package.json 含 dsh.bundle.patch 与 dsh.client 声明（零运行时依赖） ├─ cordis.patch.yml 随包配置：装进 profile 后这一行就生效 ├─ publish.cmd / publish.ps1 一键发布：提交 + 推送 + 打 tag（可选自动建仓、设 topics） ├─ install.cmd / install-profile.ps1 Windows 一键装进 desktop profile（可 -WhatIf / -Uninstall） ├─ lib/ │ ├─ index.js 宿主半边：llm/stream 短路、命令、HTTP 路由、状态落盘 │ ├─ peak.js 纯逻辑：峰谷判定、窗口/假期解析、话术（无副作用，可单独跑） │ ├─ blocked.js 纯逻辑：被拦截列表（不重 / 有界 / 只读） │ ├─ store.js 极小的 JSON 状态文件（原子替换、坏数据不抛错） │ ├─ http.js 两个同源 JSON 路由 + 两道写闸（自定义头 + 同源） │ └─ client.js 客户端半边：开关、卡片、设置页（零依赖，只用主题令牌） ├─ test/ 五套断言，npm test 全绿（116 项） ├─ docs/DESIGN-replay-tradeoffs.md 被砍掉的「谷时补发」设计推演（留档） ├─ docs/PUBLISHING.md 发布到 GitHub / 上架 dsh-market 的完整步骤 └─ docs/awesome-dsh-plugin-entry.yml 上架精选列表用的条目（去掉注释即可提交）

零运行时依赖（Windows 与 Node 内置模块除外），不需要 npm install 就能跑测试。

10. 许可

MIT。