# 【AI Work】03 少一次打断：WDX Relief

> WDX Relief 从两个功能长到六个：输入框里的下一句预测和逐轮进度，右侧栏的待跟进、会话回顾和旁问，以及回复风格。我的判断是，前两件省打字，后三件省找上下文，回复风格省重复交代。

- 作者：[小土刀](https://wdxtub.com/about)
- 发布日期：2026-11-09
- 更新日期：2026-11-17
- 原文（引用请使用此链接）：https://wdxtub.com/blog/aiwork/aiwork-03
- 所属系列：aiwork AI Work
- 标签：AI、Work、Harness、插件、效率
- 许可：CC BY-NC-SA 4.0（https://creativecommons.org/licenses/by-nc-sa/4.0/deed.zh）
- 正文中的站内图片路径以 https://wdxtub.com 为根目录。

---

WDX Relief 最早只有两个功能：输入框里的下一句预测，和一套只影响表达方式的回复风格。用了一阵子，我发现这两件之外，真正打断工作的还有一段：离开之后，怎么把上下文捡回来。

去回个消息、开个会，回来不知道刚才那轮做到哪；上个会话里还有件事等我拍板，切走就忘了；想顺手问一句「这段代码为什么这么写」，又不想把主会话的上下文搅浑。

这一版把界面补成了两处：输入框上面一行逐轮进度，右侧栏一个 WDX Relief 页面，页面里放待跟进、会话回顾和旁问。加上原来的两个，一共六个。

## 省流版

+ 下一句预测：对话结束、输入框空着时，用灰字猜你下一句，Tab 填入，Esc 忽略
+ 输入框上的一行：逐轮告诉你「这一轮在做什么、到哪了」，默认只显示语义摘要
+ 待跟进：过去会话里助手踢回给你、你还没接的事，点条目跳回原会话
+ 会话回顾：这个会话生成过的每一行摘要，留在右侧面板回看
+ 旁问：只带最近几轮文本、只活在面板内存里的随手问答，可以单独选模型
+ 回复风格：长度、风格、便于行动和一个 2000 字的自定义指令，编译成一段 prompt

这两处界面有个共同点：它们都不写进主会话的上下文。所有设置也还在插件自己的配置页里，不往 DSH 的 Settings 导航插新页面。插件关掉，配置页和右侧栏页面一起消失，不会留下「插件没了但设置还在」的幽灵。

## 下一句预测：只在该猜的时候猜

预测很容易做成骚扰，所以约束比功能多：

+ 只在会话空闲、输入框为空、最后一条是助手消息时触发
+ 同一轮只生成一次，按 `session.seq` 缓存；客户端还有 350ms 防抖
+ 只读最近 8 条真人用户 / 助手文本，15 秒超时，最多 60 字，超出截断
+ 失败、模型不可用、输出 `<none>` 都静默隐藏
+ Tab 走标准的 `inputActions.setDraft()` 写入 Lexical 编辑器，不是模拟键盘

它不替你做决定。灰字只是「如果你不知道说什么，可以从这里开始」。猜错了，按 Esc 就好，不会留下任何东西。

## 输入框上的一行：这一轮到哪了

这一行是逐轮的，不是会话级的。跑的时候显示正在读文件、跑命令还是改代码；跑完换成一句「这一轮要什么、结果是什么」。两类内容分别开关，默认只开摘要。

活动流水、耗时、思考预览都从事件窗口本地推导，零模型调用。语义摘要才走一次模型：至少 3 轮后开始，之后每 3 轮更新一次；新旧摘要的词重合到 0.7，就沿用旧的那行，不重复烧 token。预算 40 字，中文按字算。

摘要模型先按你配置的便宜模型链试，留空就自动挑 flash / mini / lite，最后退回默认模型。模型失败就退回「要求 · 结果」的本地短拼接；半句停住会重试一次，仍不完整就截到分句边界补省略号——不会把「…表前缀已替换，待」这种半句留在面板上。

这一行只是 UI：不写会话、不注入 prompt、不进入模型上下文。输入框有字时它自己隐藏，也可以按 × 收起。位置能放输入框上方或下方。生成过的摘要会另外留一份给右侧的「会话回顾」。

## 右侧栏的三件事

右侧栏的入口和 WDX Git 一样在工具列表里。页面三个 Tab：待跟进、会话回顾、旁问。我的判断是，待跟进是这个版本最值钱的部分——它解决的不是「不知道问什么」，而是「忘了还有件事」。

### 待跟进：把踢给你的球捡回来

它只回答一个问题：过去几个会话里，助手把球踢给你了，你还没接。

取数范围很窄：同一工作区、两周内创建、空闲超过两小时的会话，最多 8 个，每个只读最后一条助手消息的尾部 800 字。最后一条是用户消息的会话直接跳过——那是助手没回，不是你漏了。

算不算「等你跟进」交给一次模型调用，它只输出 JSON，不许新增输入里没有的事；跨会话重复的合并成一条，最多 5 条。模型挂了就退回关键词清单（问句、「还没 / 未推送 / 等你确认」），面板会写明这份是按关键词挑的，不假装整理成功。结果按工作区和会话集合缓存 15 分钟，右上角的刷新能强制重来。

点条目跳回原会话。每条右边的 × 是清掉（这个 Tab 之前叫「没接住的事」）：不想要的建议划掉就不再出现，旁边能撤销。记录在 `$DSH_HOME/wdx-relief/followups.json`，不写会话；按「会话 + 归一化文本」去重，`PR #12` 和 `PR #13`、`v0.4.0` 和 `v0.5.0` 不会混成一条。清掉只影响面板，不会重跑模型。

它依赖 profile 里的会话查询（base profile 默认挂 `session-query-sqlite`），没有就显示「无法整理」。

### 会话回顾：这一路是怎么走过来的

每生成一条摘要就留一份，关掉输入框那行也还能回看。点开能看到当时的要求、回复和待回答。记录存在本地 `recaps.json`，最多 300 条，可以清空当前会话的历史。它只读本地记录，不重新生成，也不额外调模型。

### 旁问：不弄脏主上下文的随手一问

输入框和 composer 同一套视觉：圆角卡片、底部模型位、右侧圆形发送 / 停止按钮，按 <kbd>⌘/Ctrl + Enter</kbd> 也能发。背景只取当前会话最近 6 条真人 / 助手文本，总长度有上限；默认用当前会话模型，也能在底部换一个，只影响这次旁问。

问答只存在面板内存里：不写会话、不写命令日志、不进下一次模型请求，关闭面板或切会话就清空。它适合「这个字段为什么这么写」这种顺手一问，不适合需要留档的讨论。没有打开会话时它会说「先打开一个会话」，而不是硬发一个请求。

## 回复风格：把偏好编译成一段 prompt

以前的回复风格要在每次对话开头手动交代：短一点、别列清单、先给结论。说一次是偏好，说一百次就是税。现在设置一次就够。

设置项不多，也不怎么互相重叠：

| 设置 | 作用 |
| --- | --- |
| 输出详细程度 | 短 / 标准 / 详细，控制展开多少 |
| 回复风格 | 默认 / 专业 / 亲和 / 直接 / 跟随我的风格 |
| 便于行动 | 先结果和下一步，按内容比例组织，保留风险 |
| 自定义指令 | 最多 2000 字，优先级最高 |

![配置页里的输入与回复设置](/static/images/aiwork/aw03/config.webp)

Host 把这几项编译成一段 system prompt，注册在 `ctx.systemPrompt` 的 order `10300`，放在部署 persona 之后。默认项不写进 prompt，避免每轮都付无意义的 token；自定义指令用 `interpolate: false` 注册，里面写 `{{...}}` 也不会把 prompt 装配弄炸。

「便于行动」是我默认开启的：先给结果或下一步，不写「好的」「我来看看」；能一句说清的不写一段；必须用术语时先用白话说明；风险、失败条件和已授权该做的工作不能因为精简而省略。这套规则改编自 `i-have-adhd` skill（MIT），我觉得它比「请简洁一点」有用得多，因为它说的是怎么组织内容，不是少写几个字。

一个必须说清楚的取舍：风格是软约束，不是硬截断。复杂任务该长还是长，模型不会为了「短」漏掉关键步骤。想要硬限制只能在客户端截断，但那会把话说一半，得不偿失。

## 它是怎么挂上去的

Host 现在注册七个 POST 路由：`predict`（下一句）、`recap`（一行摘要）、`recaps`（回顾历史）、`today`（待跟进）、`today/dismiss` 与 `today/restore`（清掉 / 撤销）、`btw`（旁问）。预测、摘要、待跟进、旁问都走 `ctx.llm`，不写 session log，也不触发 agent loop。

Client 挂五处：`conversation.input.overlay` 画输入框灰字；`conversation.input.dock` 和 `conversation.composer.dock` 各挂同一个组件，按设置只渲染其中一个；`plugins.bundle.config` 渲染配置页；右侧栏用 `sidebarRightTabs` 注册 WDX Relief 页面。所有字段都是 Host `Config` 的 `.volatile()` 引用，写完落到 profile 的 `cordis.patch.yml`，HMR 生效。

本地只多两个状态文件：`recaps.json`（回顾历史，300 条）和 `followups.json`（清掉的条目，200 条）。当前 102 个单测，覆盖风格编译、预测清洗、摘要门限与模型链、待跟进筛选与清掉、旁问和插件装配。

## 它不做什么

+ 风格是 prompt 软约束，不硬截断；复杂任务该长还是长
+ 风格全局生效，不做 per-session
+ 待跟进只看同工作区、两周内、空闲两小时以上的最后一条助手消息；模型失败时退化成关键词挑选，会漏
+ 旁问不读工作区文件、不带未提交的改动，每次独立，回答只留在内存里
+ 会话回顾和清掉记录只在本机，不跨设备同步
+ 灰字定位依赖 composer 的 DOM 属性，DSH 改版要跟着改

## 安装

侧栏 **插件 → 添加插件**，输入 `dsh-wdx-relief`，装好后启用并刷新页面（右侧栏页面在下次页面加载时挂上）。插件面向 DSH 0.2.x，配置在 bundle 页面下方。源码在 [GitHub](https://github.com/wdxtub/dsh-wdx-relief)，npm 包是 [dsh-wdx-relief](https://www.npmjs.com/package/dsh-wdx-relief)。

WDX Relief 没有新增设置页，也没有新增快捷键。它只是在输入框上放一行，在右侧栏放一个页面，把原来要翻会话才能找回的上下文摆到眼前。

预测猜错了按 Esc；待跟进清掉了能撤销。真正要你做的决定，插件一个都没替你做。

## 更新（2026-11-17）：从 0.5.0 到 0.6.0

正文写完之后，WDX Relief 发了三个版本：0.5.1、0.5.2 和 0.6.0。前两个是修 bug，第三个加了一个不算界面的功能——正文里说「一共六个」，现在多了一个第七件：工具调用泄漏守卫。

+ 输入框上那一行改成每轮都更新（原来是每 3 轮），相似度阈值从 0.7 提到 0.9
+ 灰字预测的上下文里现在带上了提问框的问答
+ 新增工具调用泄漏守卫：模型把工具调用写成正文时当场检测，同一轮内让它重发

### 那一行现在每轮都更新

正文里写的是「至少 3 轮后开始，之后每 3 轮更新一次，词重合到 0.7 就沿用旧的那行」。这个默认值后来改了：`recapCooldownTurns` 从 3 变成 1，阈值从 0.7 提到 0.9。

原因很实在：第 4、5 轮还挂着第 3 轮的摘要，看起来就像那一行卡住了、没更新。而要看那一行，恰恰是「又问了一轮，想知道现在到哪了」的时候。现在默认每轮都更新，只有新旧几乎完全一样时才不动那行。模型调用还是终局后一次便宜模型，没有变成每轮多次；不想每轮都动的，在设置页把间隔调回 3。

### 预测终于看得见提问框

DSH 里助手会用提问框问你，你在框里选或者打字回答。这类问答以前在预测的上下文里被当成工具噪音丢掉：前台回答写在工具结果的 `{"answers":[…]}` 里，排队回答是一条 `source.kind === 'user-question-reply'` 的用户消息，两种都不在「真人用户文本」里。结果是预测只看到助手最后那句「已写入…」，看起来就像助手没问过任何人就把事做完了，猜出来的下一句自然对不上。

现在这两种都会读出来，渲染成「助手（提问）…」「用户（回答）…」两行，同一题只留一条回答，坏 JSON、失败的工具结果和 `isError` 直接跳过。预测的 prompt 里补了一句说明：这两行是已经发生的确认，不是待确认。

### 工具调用泄漏守卫

这是这一批里唯一的新功能，默认开启，解决一类静默失败：模型把工具调用**直接写成正文**，而不是发出真正的工具调用。常见的是 strata 引擎 serve 的模型吐出 `<tool_call>` / `<function=NAME>` / `<parameter=NAME>`，或者是 `<invoke>` / `<parameter>` 信封、`antml:` 前缀那种。DSH 不会解析这种写法，信封就落在正文里，这一步没有任何工具卡，agent loop 看到 `toolCalls.length === 0`，把 turn 当「已完成」关掉了。既不执行，也不报错。

这种失败最阴的地方是不报错：你看到一段像是干完活的话，其实什么都没发生。

守卫的做法是当场检测，并在同一轮里注入一条纠正，让 turn 不关闭、模型用小块把调用重发一遍。第一次纠正会讲清楚为什么被拒、要求小块重试；第二次更硬更短；每轮最多纠正两次，到顶就停。除了这一条，还有几个配套：分发前扫参数，结构截断或者尾部结束序列增殖的大调用直接拒（声明了必填参数却收到 `{}` 也拒）；写入类工具自报空转时补一条提示；损坏那一步在模型可见面上被遮蔽成一条说明（日志仍保留原始事件，零模型调用）；fork 出去的会话首步收到一次简报，告诉它历史里那个孤立调用标记是坏的，不要模仿。

检测核心是零依赖的纯函数，不抛错、不改输入；它先做一份影子拷贝，剥掉命名空间前缀，把 strata 的方言折成同一种标记，配对、截断、头部开场这些规则就能复用同一套逻辑。实现移植自 `@irwdone/dsh-tool-call-leak-fix`（MIT），按本插件的 volatile Config 改了一遍：配置改动下一个事件就生效。设置页多了「工具调用守卫」一个分组，四个字段：总开关、修复提示语言（中 / 英）、每轮最多纠正次数（填 0 表示只标记不自动纠正）、诊断日志。Host 也多依赖了一个 `tools` 服务。

边界要说清楚。它只能把静默失败变成显式失败，并在同一轮里重试一次，改不了模型本身的退化；触发时最多多一次模型步。另外它平时零开销，但如果你正常引用 `<tool_call>` 字样、而这一步确实没有任何工具调用，理论上会被判成泄漏并注入一次纠正——下一个事件就会取消待定记录，不会连续误伤。默认开着，觉得误伤就关。

### 现在

当前版本 0.6.0，129 个测试（正文写的时候是 102 个），多出来的两组覆盖工具调用的检测核心和宿主接线。路由还是那七个 POST，装法和界面都没变。

正文那句「真正要你做的决定，插件一个都没替你做」还是成立：守卫只是让模型重发工具调用，没有替你改任务，也没有替你决定要不要执行。

