回到首页

输入关键词,多个关键词用空格分隔。

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

约 11 分钟

摘要

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

本页目录

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 同一套视觉:圆角卡片、底部模型位、右侧圆形发送 / 停止按钮,按 ⌘/Ctrl + Enter 也能发。背景只取当前会话最近 6 条真人 / 助手文本,总长度有上限;默认用当前会话模型,也能在底部换一个,只影响这次旁问。

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

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

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

设置项不多,也不怎么互相重叠:

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

配置页里的输入与回复设置

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,npm 包是 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,装法和界面都没变。

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

本文 Markdown 版本机器可读站点索引:llms.txt

相关文章