DSH Plugins Marketplace

DSH Plugins

Plugins

/

dsh-thinking-compact

s

dsh-thinking-compact

Discovered

Compress an agent's historical reasoning chains into a first-person recap card; tool calls and results stay byte-identical. / Compress an agent's historical reasoning chains into a first-person recap card; tool calls and results stay byte-identical.

Machine translated

dsh-thinking-compact

把 DeepSeek Harness(DSH)历史轮次里的思考链压成一段第一人称摘录卡片,工具调用与工具结果原文照抄。

状态:插件已成型、离线测试通过、装配链路已在 headless profile 验证;尚未在真实会话里跑出过一次切刀。骨架已对齐上游 v1.1.4(含 issue #34 的长会话冻结修复)。见 还没做完的。


解决什么问题

一段对话跑久了,思考链是上下文里最贵也最没用的部分:它每一步都要被重新读一遍,却很少再被用到。工具输出至少还能当事实依据,思考过程在得出结论之后就只是过程。

本插件在每轮结束时检查,挑一段已经翻过去的完整助手轮,把里面的 reasoning 交给模型缩句——保留第一人称的推理口气、转折、判断依据、数值和函数名,删掉重复验算和填充——然后用一条 user 卡片把整段事件替换掉。

压的是思考链,不是工具。 切段里工具调用与结果原文照抄;tool-call 没等到对应 tool-result 的轮次一律不动,否则会留下孤立 tool_use,上游直接 400。

为什么不直接改 reasoning_content

带 tools 的请求里 reasoning_content 必须原样回传,改写会 400;Anthropic 和 Gemini 的 thinking 签名同理。所以遮盖的对象是一轮会话事件,不是某个 API 字段:被切轮次的 assistant 消息替换成一条卡片后,它压根不在发给上游的 messages 里,协议校验无从触发。

怎么工作

官方只开放一个扩展点:实现 CompactionEngine。本插件继承 @deepseek-ai/dsh-compaction-basic 的 BasicCompactionEngine,通过 cordis.patch.yml disable 官方 compaction-basic 并 insert 自己(ctx.compaction 是单例,只能有一个引擎)。

落刀长这样:

session.append("user/message", checkpointMessage, {
  surfaceOp: { op: "replace", startSeq: chunk.start, endSeq: chunk.end },
});
await this.ctx.sessions.flush(session);

压缩结果是一条 checkpoint 消息,驻留在会话里——下一个请求天然带着它,卡片文本不变,上游前缀缓存不用重建。这是插件相对外部代理的根本差别。

选段的三条硬规则

  1. 只切完整助手轮:每个 tool-call 都必须有对应 tool-result。
  2. 不跨真人消息、不跨半截轮次;checkpoint 卡片是地板,切点必须在它之后。
  3. 双阈值:思考 token ≥ reasoningTokens(默认 4000),切段 token ≥ chunkMin。

摘要不合格(空 / JSON / 不比原文短)、备份失败、span 在提交前被改动 —— 任何一条不满足就整刀放弃,原文完整保留。宁可少压,不压坏。

缩句提示词

摘要走第一人称连续段落纯文本,不做第三人称纪要、不做 JSON。

这不是偏好,是实测结论:先前用 事实/反应/决定 三段式 JSON,模型不信任二手纪要、反复重做已完成的工作,步数从 29 涨到 45(+55%);换成缩句后两组持平在 68 vs 68。

提示词唯一事实来源是 bench/samples/compress_prompt.txt,插件运行时读 plugin/prompt.txt,两者逐字节一致,有测试守着。

装法

git clone https://github.com/sefanty17/dsh-thinking-compact.git
cd dsh-thinking-compact
dsh plugin --profile headless add ./plugin

目录

plugin/
  shell.js          薄入口:加载失败也不能把宿主拖死
  engine.js         引擎:fork 自 dsh-live-compact v1.1.4,改了选段/卡片/摘要三处
  reasoning.js      本项目的实质内容:选段、卡片渲染、提示词装载、摘要校验
  prompt.txt        缩句提示词(与 bench 定版逐字节一致)
  plan.js shadow.js raw.js    沿用上游:工具结果摘录、shadow 备份、原文捕获
  gate.js settings.js adapter.js cooldown.js thunder.js   沿用上游
  test/reasoning.test.mjs     离线测试,不需要 DSH 运行时
bench/
  steps.yaml        30 轮长程任务定义(VoxeLibre 分层实现)
  steps.py score.py 任务读取与验收评分(纯标准库,与实现语言无关)
  samples/          真实思考样本 + 定版提示词
outputs/
  ab-5round-report.md  5 轮 A/B 报告(**代理时代归档**,只对提示词风格有参考价值)

实测

5 轮长程 A/B,逐字相同输入,模型 deepseek-flash:

指标A(原版 DSH)B(+ 压缩)
完成轮次5 / 55 / 5
验收通过率1.01.0
总步数6868
总 token—−8.3%
成本¥0.631¥0.872(+38%)

那一轮跑的是外部代理版。token 省了但成本反而涨,原因已经查清:代理只改转发给上游的 payload、不回写 DSH 会话,于是每个请求都从原文重压一遍,卡片每轮措辞不同,切点处前缀断裂,缓存未命中的单价是命中价的三十倍,省下的 token 全赔进去。

插件版把这个问题从架构上消掉了(压缩结果驻留会话、卡片固定),但成本还没重测。完整归因见 outputs/ab-5round-report.md。

还没做完的

  • 没在真实会话里跑出过一次切刀。装配链路(dsh --dump-config 看到 disable + insert、__probe.mjs 加载成功)已验证,但 compaction/summary 事件是否真落进会话日志未验证。
  • 摘要路由要显式配置。官方 summarizationProvider / summarizationModel 默认为空串;插件现在按「显式配置 → 最近一次请求的模型 → agent 选项」三级兜底,仍未在真实路由下验证过。
  • shadow 备份没接进切段路径。当前只沿用上游对工具结果的 raw 捕获,被缩句的思考原文还没做独立备份。
  • plan.js 里约 1100 行工具结果摘录启发式现在用不到,删之前要先确认 shadowSections 等被复用的导出。
  • 压测脚本要重写。bench/runner.py 是围着代理写的,已删;30 轮全量需要新的 runner 走「装插件 → 跑 DSH → 读会话日志」。
  • 摘要质量只做过端到端任务成功率评测,没单独评摘要文本——摘要本身是另一次生成,单独评它没有证据效力。
  • 5 轮样本量偏小。

致谢

骨架 fork 自 MerkyorLynn/dsh-live-compact(MIT,见 plugin/LICENSE.upstream),并已跟进其 v1.1.4 的 defer large catch-up after turn end 修复(issue #34):切段、shadow 备份、surfaceOp: replace 卡片遮盖、commit 前的一整套校验都是它的。本项目把同一套机制从工具结果迁移到思考链,差别在于思考链走模型缩句而不是规则截断,并且默认不碰工具。

设计过程中参考过 T-Auto/dsh-ops 的工具链。

License

MIT © 2026 sefanty17。plugin/ 下 fork 自上游的部分版权归其作者,见 plugin/LICENSE.upstream。

Comments

Loading…

Similar plugins

rcs-context

by ScreamingMaggot

把长对话的重复计费砍掉一半,并给模型配一名只读调查员:先核实,后动手。面向 DeepSeek Harness 的上下文压缩与外置推理插件(MIT)。

Memory & ContextSessions & MessagesManifest valid

★ 1

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add rcs-context

by TacitSay

可配置的上下文压缩插件:总压缩 / 思考压缩 / 工具输出压缩,带左栏面板(DeepSeek Harness)

Development & InfrastructureMemory & ContextManifest valid

★ 1

MIT

JavaScript

Nov 8, 2026

dsh plugin --profile web add dsh-compact-arsenal

by chuxindd

Persistent task state and context-aware compaction for DeepSeek Harness coding sessions.

Terminal & ClientsManifest valid

★ 0

MIT

TypeScript

Sep 20, 2026

dsh plugin --profile web add dsh-context-enhancement

by 2877905731

dsh-think-autoexpand:让 DeepSeek Harness 里的 Think 思考行始终可见,并在流式输出时自动展开,实时查看 Agent 完整推理过程;保留工具卡折叠体验。

Tools & CapabilitiesUI & ExperienceManifest valid

★ 7

JavaScript

Sep 1, 2026

dsh plugin --profile web add dsh-think-autoexpand

by john-walks-slow

Context compaction for DeepSeek Harness: mind_map and clear_mind agent tools turn selected history into self-written checkpoints, with auditable GUI tombstones and proactive threshold reminders.

Development & InfrastructureMemory & ContextSessions & MessagesManifest valid

★ 10

↓ 377/wk

MIT

TypeScript

Oct 26, 2026

dsh plugin --profile web add dsh-clear-mind

by Shuffle-1992

DSH 上下文智能压缩 + 智能思考:每轮注入用量、模型自主决定压缩并自动续跑;可选让模型按任务难度自主调整思考强度档位

Development & InfrastructureManifest valid

★ 4

↓ 35/wk

MIT

JavaScript

Nov 6, 2026

dsh plugin --profile web add dsh-context-pilot