中途插话时把计划保住:未完成的 todo 落盘,插话落地的当回合就把「被挂起的项 + 插话原文 + 取消 / 补充 / 另起一件事」摆到模型面前,之后以「挂起工作」段继续渲染,直到完成或取消;回合收尾再兜底催一次,让剩余工作被明确交代,而不是被静默丢掉——它缓解注意力漂移,但不消除。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-task-anchor
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:7starsseeker/dsh-task-anchor
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
English: README.md
任务执行中被打断时,别让原任务悄悄消失。
一个零依赖的 DeepSeek Harness 宿主插件:当回合中途收到用户插话、并且回合结束时还有未完成的 todo,它会把一条提示 steer 回当前回合,让模型要么把活干完,要么明确说清楚还剩下什么。
不加 core patch、不 fork、不改会话投影。
它解决的失效
DSH 里插话有两条投递路径,两条都可能把原任务丢掉:
| 路径 | 机制 | 失效点 |
|---|---|---|
| steer(忙时 Enter) | 消息进 inbox 的 next-step,下一个 step 边界被 claim,作为普通 user/message 进入模型上下文 |
插话与开场 prompt 同形同权(packages/core/session/src/surface.ts 逐字投影,是 2026-07-20 的刻意设计);系统提示里没有任何关于中途消息的指令。模型很容易把「最新一条 user 消息」当成唯一任务 |
| queue(排队) | 消息进 next-turn,当前回合正常结束、下一回合才投递 |
原回合在 todo 未完成时结束,没有任何人检查它留下了什么;下一回合被新消息占据 |
两条路径的共同点:todo 清单在 turn/start 时被投影清空(packages/todo/tool-todo/src/index.ts),模型下一轮不再被提醒「还有活没干」。
先把范围说清楚。 它缓解漂移,不能消除。插话仍然会占据它落到的那个 step,模型也仍然可能在下一个边界之前就转向——契约是建议性的,守卫只在回合已经收尾时才触发。真正改变的是「计划能扛过这次转向」:计划被写下来、被重新渲染,回合不能带着未完成项静默结束。要把缺口本身补上——让中途消息先排队,并给它一个与开场 prompt 不同的身份——那是宿主(DSH 核心)的决定,不是插件该替它做的。
它做的事
契约(system prompt section,
task-anchor:contract) 每次请求注入约 320 tokens 的规则:中途 user 消息是「新输入」,不是「任务的替代品」;先判断它属于补充约束 / 修正当前步 / 追问 / 新任务 / 改目标或中止,再决定动作。同一段还写着:被挂起的计划怎么记账、什么中间结论值得落盘、用户回答你问过的问题是决定而不是情报、被取消的任务之后不再复述。永不静默丢弃未完成的工作。挂起计划(
agent/pre-step→ 一个 JSON 文件) 插话到达且清单里还有未完成项时,把当时的未完成项写一次到suspended-<session>.json。之后每次组装 prompt 都按「挂起项 ∩ 当前未完成项」渲染回## Suspended work:还剩哪些、打断它的是哪句话、停在哪、以及当时的会话事件号(可用session_event_read回读转录)。这些项从清单里消失(做完或取消)即删文件。插话落在当前正在跑的回合时,同一份快照改渲染成## Interjection during this turn:列出被挂起的项、插话原文、三个读法(取消 / 补充 / 另起一件事),并要求模型在这一回合内自己判断——停不停是模型的判断,不是插件替它打断。没有快照但有待办时,段末只追加一行Open items: …——todo 面板只是当轮表面,日志不是。守卫(
agent/turn-stopping) 满足全部条件时,用agent.steer()把一条 notice 塞回当前回合:- 本回合观察到中途 user 消息(
step > 1且批次里有source.kind === 'user'),或inbox.nextTurn里有排队消息; - 最近一次
todo/write(不超过maxStaleTurns个回合)里还有pending/in_progress项; - 本回合最后一句不是提问(默认跳过,避免打断「停下来问用户」);
- 本回合没催过、会话内没超过
maxNudgesPerSession。
模型于是多走一步:干完,或写明「剩下 X,因为 Y」。
- 本回合观察到中途 user 消息(
观察(
agent/pre-step) 只读不改,记录本回合是否收到插话,供守卫判断;debug 日志可见。首次运行(
first-run.json) 第一次对着某个 store 启动时,section 里多一段## First run:列出会影响行为的开关(returnPolicy、forceStop、onInterject、storeTtlDays)及其当前值,要求模型用一小段话告诉用户、并问要不要改。版本号直接读package.json,不会忘了同步。标记文件保证只出现一次;store 不可写就下次再来一遍,不报错。
快照会顺手清扫:写新快照时删掉其它会话里超过 storeTtlDays 天的 suspended-*.json。插件从不触碰 DSH 自己的会话归档。
安装(挂进一个 profile)
# 1) 把本目录登记成 profile 依赖与 bundle
# 编辑 <DSH_HOME>/profiles/desktop/package.json:
# dependencies 加 "dsh-task-anchor": "link:<本仓路径>"
# dsh.profile.bundles 加 "dsh-task-anchor"
# 2) 建立链接
cd <DSH_HOME>/profiles/desktop
pnpm install
# 3) 重启 DSH(宿主插件在启动时加载,热重载不覆盖 profile bundle)
<DSH_HOME> 指包含 profiles/ 的那一层目录(DSH 存放 profile 数据的位置)。
验证加载:
Get-Item <DSH_HOME>/profiles/desktop/node_modules/dsh-task-anchor |
Select-Object Name, LinkType, Target
配置
写在 cordis.patch.yml 的 config: 下,全部可省略:
| 键 | 默认 | 含义 |
|---|---|---|
enabled |
true |
总开关;false 时不注册任何东西 |
contract |
true |
是否注入系统提示契约(约 320 tokens/请求);同时是挂起锚的总开关 |
guard |
true |
是否启用 turn-stopping 守卫 |
onInterject |
triage |
插话时是否把挂起计划落盘(triage);off = 只保留守卫 |
returnPolicy |
auto |
auto 把提醒递回回合;wait 只记录不催。单靠 wait 不能中止正在跑的回合,见 DESIGN §7.4 |
forceStop |
off |
实验性。 off / always / triage。插话落到 step 边界时直接停在那里,把这条消息交给下一回合;triage 只在文本不像取消、也不像补充修改时才停。默认关;停回合会让宿主播一次「任务结束」提示音,所以不作推荐路径 |
cancelPatterns |
内置表 | 判「这条插话是取消」的正则列表(不区分大小写);给了数组就整体替换默认值 |
amendPatterns |
内置表 | 判「这条插话是补充修改」的正则列表(不区分大小写);给了数组就整体替换默认值 |
triggerQueued |
true |
「下回合已有排队消息」是否也算触发条件 |
skipWhenAsking |
true |
回合末句是提问时不催 |
maxNudgesPerSession |
6 |
每会话最多催几次;0 = 只观察 |
maxNoticeItems |
5 |
notice / Open items: 行里最多列几项 |
maxStaleTurns |
3 |
todo 清单跨多少回合后视为过期(只影响守卫) |
storeDir |
<DSH_HOME>/task-anchor |
suspended-<session>.json 存放目录;回落到 ~/.dsh/task-anchor |
storeTtlDays |
7 |
写快照时顺手清理其它会话超过 N 天的快照;0 关闭 |
边界(明确不做的事)
- 不做关系判定:插件不调用模型、不分类插话属于哪一类。关系判断交给契约 + 模型;插件只做机械兜底(有没有留下未完成的活)。
- step 1 的插话不判定:
claim()在第一步会同时取走next-step与next-turn,无法仅凭 step 区分「插话」与「开场」,因此这种情况按已知边界放过。 - 没写 todo 的回合不催:没有声明过计划,就没有可核对的「未完成」。想让它覆盖更多场景,需要模型先写 todo。
- 不阻止插话:不做「把插话推迟到本回合结束」的策略——用户说「停,方向错了」时必须立刻被听到。
- 不动
surface.ts的逐字投影:模型侧的「插话」身份仍然是平的;要渲染层标记必须走 meta renderer + 新 Agent Note(见仓库里 2026-07-20 的 deferred 条目)。
与同类插件的关系
dsh-loop-continue、dsh-early-stop-guard也在agent/turn-stopping上agent.steer()。本插件每回合最多催一次,但两个插件同时装时同一回合可能各催一次;建议按需二选一。dsh-todo-float-ball只做 UI 展示(「被插话打断后丢失的安排」),不注入模型;与本插件互补。
验证
cd <本仓路径>
node --test # 52 条单测:策略判定 + apply() 接线,不需要启动 DSH
端到端手测(重启后):
- 让 agent 做一个三步任务,要求先写 todo;
- 第二步执行中插一句无关追问;
- 观察回合结束前是否出现
[task-anchor]notice,以及模型是否交代剩余项。
日志关键字:task-anchor: steered a reminder(info)、task-anchor: mid-turn user message observed(debug)。
已确认(2026-11-15):重启后会话 system prompt 里出现契约段 ## Mid-turn user messages ⇒ 插件加载与 section 注入正常;插话时落盘 suspended-<session>.json 并渲染 ## Suspended work;回合收尾出现 [task-anchor] notice;改写清单后快照被删。
returnPolicy: wait 也实测过一次:守卫如预期保持安静,但回合没有停 —— 模型自己接着做挂起的那份计划了。这是能力边界:wait 只拿掉「催」这个动作,剩下的只有契约措辞能请求它停,所以补了 ### Waiting for the user 明确写出来。所以主路径不是强行停,而是上面那条同回合提示:模型在插话落地的那一步就看到「挂起的是什么、刚来的是什么」,由它自己决定。forceStop: always 是实验性的机械停:agent/pre-step 里把这一批消息放回 next-turn 并返回 reject,这个 step 不会打开,turn/end 记成 blocked,下一回合从这条插话开始。2026-11-15 已 live 验证(turn/end reason=blocked → 消息在下一回合开头重新送达),同一次实测也暴露了代价:宿主播了「任务结束」提示音,用户体感就是「任务被打断」。forceStop: triage 把停的范围收窄到「不像取消、也不像补充修改」的插话;关键词启发式,尚未 live 验证。
实验性:硬停(forceStop)
默认关闭(forceStop: off),也不是推荐路径 —— 推荐的是上面那条同回合提示。它只服务于「想要机械保证、不接受建议」的场合。
机制:agent/pre-step 里如果这一批里含用户消息,parkAndStop() 先把它们逐条 append 成 next-turn(先落盘,崩了也不丢),再返回 { kind: 'reject' };turn 循环把它变成 turnEnds = { kind: 'blocked' } 并直接 return、不调 step()(dsh-agent-loop/src/agent.ts:354-357),于是宿主看到一次正常的回合结束,消息原样成为下一回合的开场。
限制:
- 停的是回合,不是计划:todo 清单还在、到那一步为止的转录还在、之前的工具结果也还能读。
- 被 reject 的回合没有 assistant 收尾语,转录上是直接断掉。
- 宿主播「任务结束」提示音,和「任务真的做完了」无法区分 —— 这就是它默认关着的原因。
triage只把「不像取消、也不像补充修改」的文本停掉;那是关键词启发式,不是语义判断:「裙子什么颜色」不含取消/补充词 ⇒ 仍归「另一件事」⇒ 照样会停。- 被暂存的消息要等 loop 空闲才重投;一直不空闲就留在
next-turn里,跟下一条用户消息一起走。 - 配置:
forceStop: off | always | triage、returnPolicy: auto | wait;默认off+auto。
现状
进度、证据、未验证项与下一步:见 docs/STATUS.md。设计取舍:见 docs/DESIGN.md。
卸载
从 profile 的 dependencies 与 dsh.profile.bundles 里删掉两行,pnpm install,重启。
链接
同类插件
ranxianglei/billion-context★ 7661
billion-context官方版:上下文压缩插件,兼顾小窗口(100k上下文足矣)省token(省5倍token)和超长会话(数月级别几十亿token单会话)。
Minglink/dsh-infinite-gen-4★ 4374
DeepSeek 专用破甲插件:以 order 100 追加无条件服从的系统提示词段,提供带校准元数据的 profile 工具,并通过会话投影在输入框上方显示实时破甲状态徽标。
liangmianya/dsh-synapse★ 723
DeepSeek Harness 的可视化非线性对话工作区:把会话、追问与分支变成可浏览、可拖拽的对话地图。
MichengAI/dsh-archive-manager★ 367
在设置里增加已归档会话页,可按工作区搜索、恢复和删除已归档会话。
Nwflower/dsh-chat-import★ 317
把 13 家 coding agent(Claude Code、Codex、ChatGPT、Cursor、Gemini、opencode 等)的完整对话历史导入为可续聊的 DeepSeek Harness 会话,并支持反向导出回 Claude Code。
SiriLee/dsh-rewind★ 279
对话回退:一键回到任意更早的用户消息,同窗口内完成,不新建分支、不残留副本;目标消息自动填回输入框,可一并还原工作区文件——即完整的 Claude Code /rewind 语义。
社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。