DSH Plugins Marketplace

DSH Plugins

Plugins

/

Sessions & Messages

/

dsh-longtask-guard

d

dsh-longtask-guard

Manifest valid

Externalizes oversized assistant and tool messages in long sessions into project files while keeping a recent window, and archives reasoning from empty turns as a visible message so long tasks do not

hasBundlePatch

dsh-longtask-guard

DeepSeek Harness 的长任务护栏插件:把臃肿的会话历史外化到文件,把看不见的推理捞回正文。

长任务跑到几百步时,两个问题会一起出现:上下文越来越大、模型开始把整段分析写进 reasoning 而正文留空;一旦上游把这种回合判成「退化」,回合直接中止,界面上只剩一条错误,你既看不到结论,也不知道模型当时分析了什么。

这个插件针对这两点:

  • 上下文外化:请求发出前检查消息总量,超阈值就把早期超长消息正文收缩成一行索引,原文归档到项目 .dsh-task/archive/;
  • 空正文救援:监听会话事件,正文为空、分析全在 reasoning 的回合,自动落盘到 .dsh-task/reasoning/,并在回合结束时补一条可见的摘录消息。

为什么需要它

用真实长会话来举例(某 165 回合、约 7 MB 的会话日志):

  • 641 条 assistant 消息里,602 条把内容写在 reasoning 块里;
  • 其中 364 条正文为空——这些回合在界面上的观感就是「模型想了一堆,但什么都没给你」;
  • 某次长任务的第 165、166 回合,15 016 字符和 2 977 字符的分析全部落在 reasoning,正文只有一行 ❌ stream error: the turn degenerated again after the continuation nudge。

reasoning 本身不是没落盘,只是默认折叠在界面里。插件做的事就是:把这段内容挪到你能直接看到的地方,并且把超大消息的正文换成文件索引,让上下文别再涨。

安装

需要 DSH 0.2.x。把仓库 clone 到本地任意目录,然后用 DSH 的插件管理器安装(target 填该目录的绝对路径):

git clone https://github.com/zhangyahao/dsh-longtask-guard.git
# 然后在会话里:
plugin_manager(action="install_bundle", target="<克隆目录的绝对路径>")
# 重启 DSH 生效

卸载:plugin_manager(action="remove_bundle", target="dsh-longtask-guard")。

配置

cordis.patch.yml 默认值:

config:
  enabled: true
  externalizeAtChars: 600000    # 消息总字符超过它才外化(约 15 万 token)
  keepRecentMessages: 40        # 最近 40 条消息不动
  archiveDir: .dsh-task/archive # 相对会话工作目录;工作目录不可用时落 $DSH_HOME
  minMessageChars: 1200         # 单条消息至少这么长才值得收缩
  cooldownMessages: 60          # 两次收缩之间至少间隔的消息条数
  captureReasoning: true        # 是否做空正文救援
  minReasoningChars: 400        # reasoning 至少这么长才救援
  minTextChars: 20              # 正文短于这个长度视为「空正文」
  reasoningDir: .dsh-task/reasoning
  appendSummary: true           # 救援时是否往会话里补一条可见消息
  summaryExcerptChars: 2400     # 补发消息里摘录的长度上限

配置与统计持久化在 $DSH_HOME/data/longtask-guard.json,重启后保留。

归档位置怎么定(按会话目录走):依次尝试 agent.session.header.cwd、session.cwd、workingDirectory 服务、workspaceRegistry 按 sessionId 反查;拿到就落在该会话工作目录下的 .dsh-task/(例如 D:\ceyearnplm\.dsh-task\、D:\DeepSeek Harness\.dsh-task\)。$DSH_PROFILE_DIR(形如 ...\profiles\desktop)会被显式跳过——那是 DSH 的配置目录不是项目,归档落进去会变成孤儿文件;全都拿不到时才兜底 $DSH_HOME。longtask_status 会直接打印解析后的绝对路径。

工具

工具用途
longtask_status阈值、保留窗口、本次运行的收缩与救援统计
longtask_externalize手动登记一次外化(force: true 绕过冷却)
longtask_handoff把进度写成交接文件 .dsh-task/handoff-<时间>.md
longtask_reasoning列出 / 读取救援归档的 reasoning 文件

工具不是必须的——外化与救援都在插件里自动运行,工具只是查看和手动干预的入口。

工作方式

外化

  • 只收缩 assistant 与工具结果消息,不动 user 消息;单条不足 minMessageChars 的不收缩。
  • 收缩后形如:[ctx-externalized] #12 首行摘要…|全文 15382 字符:<归档路径>。
  • 消息条数与结构不变(只改 content),不破坏下游对消息 id 的引用。
  • 两次收缩之间至少间隔 cooldownMessages 条消息,避免每轮都动历史、破坏上游 prompt 缓存。

救援

  • 判定:一条 assistant 消息的 reasoning 长度 ≥ minReasoningChars,且正文 text 长度 < minTextChars。

  • 动作:回合结束时(turn/end)把 reasoning 写进 .dsh-task/reasoning/turn-<回合>-<时间>.md,再用 session.append 补一条可见消息:

    ⚠️ 上一轮正文为空,分析只写在了 reasoning 里(共 15382 字符),已归档到:
    D:\...\.dsh-task\reasoning\turn-165-2026-11-10T11-10-01.md
    
    —— 以下是这段分析的原文摘录 ——
    ……
    
    (完整内容读上面那个文件;直接回复「继续」即可从这份分析接着往下走。)
    
  • 补发用的是宿主接受的消息结构(message + compact stream),失败会静默跳过、只保留归档。

与上下文压缩插件的关系

本插件不替代压缩插件(例如 billion-context):

  • 压缩插件负责「token 总量」:按范围折叠成摘要块、可还原、可搜索;
  • 本插件负责「单条消息体积」和「内容可见性」:把超大正文换成文件索引、把空正文回合的推理捞回正文。

两者可以并存,建议把本插件的 externalizeAtChars 设得比压缩插件的触发点高一些,只在压缩管不到的单条超大消息上动手。

已知边界

  • 上游的「退化回合中止」是过程逻辑,没有配置开关;本插件只能降低触发概率并在发生后把内容找回来,不能保证一定不发生。
  • 外化会改变历史消息正文,动过的那一轮上游 prompt 缓存会失效,这是有意的取舍。
  • 救援补发的消息在界面上是一条普通 assistant 消息,会进入历史;不需要时把 appendSummary 设为 false。
  • 只处理消息正文;图片等非文本块原样保留。
  • 救援依赖 session/event 与 session.append 两个宿主能力;宿主版本不提供时,只有外化生效。

License

MIT

Comments

Loading…

Similar plugins

dsh-session-task-tags

by Som2233

Tag every DeepSeek Harness session as a long-term or short-term task plus its agent mode, and auto-archive it when its window elapses.

Development & InfrastructureSessions & MessagesManifest valid

★ 2

MIT

JavaScript

Oct 7, 2026

dsh plugin --profile web add dsh-session-task-tags

Keeps DSH agents from forgetting your requirements during long tasks. It saves important conditions and completion evidence locally, brings them back after context compaction or session resume, and st

Security & AuditTools & CapabilitiesMemory & ContextManifest valid

★ 0

Apache-2.0

TypeScript

dsh plugin --profile web add dsh-completion-guard

Keeps one reasoning-only turn from making an entire session unusable. When a turn produces no visible text and no tool call, the assistant message is persisted empty, the gateway then rejects every la

Sessions & MessagesManifest valid

★ 0

dsh plugin --profile web add dsh-reasoning-only-guard

by wackyju2-beep

更好的 DSH | Unofficial dsh plugin: archived sessions & task notifications / 已归档会话管理 · 任务系统通知

Workflow & AutomationTools & CapabilitiesManifest valid

★ 4

↓ 180/wk

MIT

JavaScript

Sep 8, 2026

dsh plugin --profile web add dsh-better

by kmyy350234-dz

Keeps heavy tool groups out of every request and brings them back on demand, by keyword, or automatically at session start.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 4

MIT

JavaScript

Nov 7, 2026

dsh plugin --profile web add dsh-tool-drawer

by huxin7735-collab

Keeps a long agent turn answerable to the user's actual request: a standing maintainer-document reminder, two pre-execute gates, an objective anchor quoting your latest instruction, and a nudge stage

Manifest valid

★ 0

MIT

JavaScript

Sep 21, 2026

dsh plugin --profile web add dsh-maintainer-doc-guard