DSH Plugins Marketplace

DSH Plugins

Plugins

/

Sessions & Messages

/

traceless

t

traceless

Manifest valid

Strips past-turn reasoning blocks from replayed context while keeping the session log intact, and lets the model recall the original thinking on demand.

UI (client)hasBundlePatch

traceless

Forget how it thought. Keep what it said. 忘掉怎么想的,留下说了什么。

官方 DeepSeek Harness(dsh,非 dsh-go 手机版)Host 插件:发给模型的历史不再携带旧回合的思考过程,会话日志一字不动,需要时模型能自己调回原始思考。 长会话因此保留更多可用上下文,也不会重复为旧思考付费。

  • 剥除:llm/stream 中把历史轮 assistant 消息的 reasoning 块连同 replayState 剥掉,正文与工具调用原样回传。
  • 召回:请求末尾追加单条 user 注记,需要时模型用 session_event_read 取回原文;工具不在场时注记自动降级。
  • 要点:可选内联(模型回复尾部自附 Key points)或后台小模型摘要,让历史留下结论而不是纠结。
  • 三处入口等效:网页面板(输入框下方)、/traceless 命令、配置文件;每项独立开关。

English

A host plugin for DeepSeek Harness (dsh) that strips past-turn reasoning blocks from replayed context while leaving the durable session log untouched. The model can recall the original thinking on demand through session_event_read; optional key-points summaries (inline or background) keep conclusions in history. Fewer tokens replayed, more usable context, no lost evidence.

git clone https://github.com/<you>/traceless.git && cd traceless
# 安装(三选一):
# A. Web 侧栏 Plugins → 安装本地 bundle → 选这个目录(默认启用)
# B. agent 会话里让 plugin_manager install_bundle 指向这个目录
# C. CLI:dsh plugin --profile web add link:$PWD,再在 Plugins 页启用

适配版本:@deepseek-ai/dsh >=0.2.2-rc.1 <0.3.0(本机 /opt/dsh 0.2.2-rc.1 已核实源码;API 未冻结,engines 已加上限,升级见文末清单)。


0a. v0.5.0(品牌更名:reasoning-shed → traceless)

项旧新
品牌 / 仓库reasoning-shed(曾拟 dsh-shed)traceless
包名@local/dsh-plugin-reasoning-sheddsh-plugin-traceless
斜杠命令/shed/traceless
插件 idreasoning-shedtraceless
摘要 purposereasoning-shed-summarizetraceless-summarize
内部标识shedMessage()、_shedStats{shedMessages,shedBlocks,shedChars}stripMessageReasoning()、_stripStats{strippedMessages,strippedBlocks,strippedChars}
面板 / 本地化Reasoning shed / 思考剥离Traceless / 无痕回传

名字由来:思考不再留在回传的轨迹(trace)里,而日志里仍一字不少。配置键与剥除行为完全不变;升级只需把 profile 的 link: 依赖、patch 里的条目 id,以及习惯用的 /shed 换成新名。

0b. v0.4.0 变更(独立审查修复 + 原始需求补齐)

编号问题 / 缺口修复
P2summarize.model 只查字符串不查格式:"bogus" 能过配置,运行时每条消息在 parseModel 抛错(try 外),摘要永不工作且日志刷屏格式在 resolveConfig 配置期校验(parseModel 移入 defaults.js 单一判据);options 构造整体挪进 try;/traceless summarize model 同判据
P2未知键坏配置用 /traceless 修不回来(persist 把坏配置原样摊回);summarize.model/maxChars/timeoutMs 无修复命令configError 期间任何写命令从干净基底重建;新增 /traceless reset 显式恢复出厂;新增 `summarize model
P3摘要器不看 finish 块:适配器错误/超时以 finish 块返回而非抛错 → 失败静默、半截文本被当完整摘要缓存error/aborted 丢弃半截文本并 warn(卸载中止降为 info);max-tokens 保留部分要点并 warn;对照官方 compaction finishError 语义
P3面板写后刷新失败被「已保存」覆盖act 只在重拉成功时显示保存成功,失败保留错误信息
P3面板不显示 configError,坏配置时静默展示默认值快照带 configError 时面板顶部显示警告条
P3摘要并发无上限、无在飞去重、卸载不中止在飞调用并发上限 2 + 排队;在飞 id 去重;ctx.effect 卸载时 abort 全部在飞调用
P3maxTokens=max(128,maxChars) 把字符当 token,中文必中途截断max(128, maxChars×2) 估算
P3commands 服务晚启动时 /traceless 永久缺席(apply 时一次性软取)服务未在场时经 ctx.inject 子 fiber 等待注册(随父 fiber 释放)
P3注释/文档漂移(locale「ui 段」、UI-NOTES inject 说法、USAGE 漏 help、marker text「保留原文空格」表述)全部更正;tarball 补 LICENSE
需求原始需求「平常只回传概括要点(在生成文本时直接生成)」此前只有后台小模型路线新增 inlineSummary 开关:尾部注记附指令,模型在回复正文尾部自附「Key points」段;要点以 text 块落日志、剥除后存活。与后台摘要互为替代、独立开关,默认关
门槛摘要模型只能改配置文件/traceless summarize model <provider/model> + 面板模型输入框(宿主校验格式)

测试:node test.mjs 98 项断言(新增 model 格式/maxChars 上限/inline 注记合并、mock 摘要器 finish/并发/去重/卸载中止、mock 命令 reset/坏配置重建/新子命令)。

0. v0.3.0 变更(实测回归修复)

编号问题修复
P0marker 插在被剥 assistant 消息头部,历史里成串同前缀回合诱导模型模仿,污染可见回复并写进会话日志(实测复现)注记改为请求末尾单条 user 角色消息(官方 compaction 尾部指令消息同款形态),不再触碰任何 assistant 消息;摘要(summarize)作为被剥消息尾部 text 块附加,内容逐条不同、无固定前缀模式
P1配置错误 → apply 抛异常 → 插件不挂载 → /traceless 一起消失,只能手工改文件/traceless 在任何校验之前注册;配置解析失败降级 DEFAULTS 并 warn,错误详情经 /traceless status / /traceless json 暴露;summarize.enabled 缺 model 只关摘要不拖垮插件
P1engines.dsh 无上限,未来 0.3/1.0 可装上直接炸">=0.2.2-rc.1 <0.3.0"
P1重入丢失请求身份标记(AGENT_LOOP_REQUESTS / companion recall origin),dsh-go 伙伴召回会话可能 COMPANION_RECALL_* 失败重入前 best-effort 恢复:loadHostBindings 按「裸 import → apply 调用栈宿主根 → argv[1]」解析宿主 dsh-llm 同一模块实例,用官方导出的 markAgentLoopRequest / dshGoRecall.inheritRequest 复制身份;解析失败或解析到异副本 = 安全 no-op(官方 Web Harness 本就不受影响)
P1默认 marker 引导调用 session_event_read,但该工具依赖可选 bundle默认注记按请求 options.tools 是否含 session_event_read 自动在 RECALL / PLAIN 变体间降级;自定义文案原样使用
P2summaries Map 无界增长LRU,上限 SUMMARIES_MAX = 500 条
P2summarize 调用无超时 / 无 maxTokens / 成本不可控AbortSignal.timeout(summarize.timeoutMs)(默认 30s,可配,≤600s);maxTokens = max(128, maxChars);输出按 maxChars 硬截断;思考原文输入截断 12000 字符;按消息 id 去重;带 sessionId + purpose:"traceless-summarize";dsh-go recall 保护会话经 denyAuxiliary 语义直接跳过
P2marker:"" 时可能产生空 content 的 assistant 消息(严格 provider 潜在 400)剥后 content 为空的消息整条移除(只含 reasoning 的消息无 tool-call,不破坏 tool_use/tool_result 配对)
P2DEFAULTS 双份复制漂移风险新增 defaults.js 单一来源,index.js / host-commands.js 共用
P2inject 硬依赖 "commands" 与软兜底矛盾inject = ["llm"];commands 软获取,缺失时降级为无 /traceless 并 warn
P3strippedBlocks 按消息计数按 reasoning 块计数,另计 strippedMessages
P3/traceless marker on 覆盖自定义文案找不回新增 /traceless marker text <custom>(保留原文空格,≤2000 字符);on = 恢复默认
P3keepRecentAssistant 无上限上限 KEEP_RECENT_MAX = 64(命令与 resolveConfig 双侧校验)
P3面板乐观占位 "[default marker]" 显示不准写命令成功后重拉 /traceless json 真实状态;marker 显示三态(默认/自定义/静默);recordInput:false 减少命令参数入日志
P3icon 硬编码深色底透明底 + 中性灰,深浅主题均可读
P3files 不含 test.mjs已加入(连同 defaults.js)

未修(有意的):compaction 计量偏差(tokenMeter 基于 session,无可行钩子,方向保守只是多压一点);/traceless 的 command/run、command/done 生命周期记录(dsh-commands 固定行为,无法关闭);面板文案三处同步(浏览器端拿不到包内 JSON,UI-NOTES.md 已记录)。

1. 功能与开关

每项功能独立开关,三处入口等效:配置文件、/traceless 命令、网页面板(client.js)。

配置键默认含义命令 / 面板
enabledtrue总开关:是否剥除历史 reasoning/traceless enable|disable;面板「剥除」
keepRecentAssistant2保留最近 N 条含 reasoning 的 assistant 消息不动(未闭合回合需签名思考;1..64)/traceless keep N
markerRECALL 注记请求末尾追加的单条 user 注记文本;"" = 完全静默;等于默认文案时按召回工具在场自动降级/traceless marker on|off|text <custom>;面板「标记」
inlineSummaryfalse内联要点:模型在回复正文尾部自附「Key points」段(生成文本时直接生成;要点随正文落日志、剥除后存活)。长度预算用 summarize.maxChars/traceless inline on|off;面板「回复自附要点」
summarize.enabledfalse思考要点回传:后台小模型总结后附在被剥消息尾部/traceless summarize on|off;面板「要点」
summarize.model""总结用 provider/model(配置期校验格式;未设置时摘要保持关闭,只 warn)/traceless summarize model <provider/model>;面板输入框
summarize.maxChars400要点长度硬上限(提示词约束 + 输出截断;≤4000;也是内联要点的长度预算)/traceless summarize maxChars N
summarize.timeoutMs30000单次总结调用超时(≤600000)/traceless summarize timeoutMs N
verbosefalse诊断日志/traceless verbose on|off

/traceless 完整子命令:status | enable | disable | marker on|off|text <custom> | inline on|off | summarize on|off|model <provider/model>|maxChars N|timeoutMs N | keep N | verbose on|off | reset | json | help。 reset = 恢复出厂(写回空配置,未知键/坏值一并清除);坏配置期间任何写命令都会从默认值重建配置。 网页面板(conversation.composer.dock 槽位)提供剥除 / 标记 / 内联要点 / 后台要点开关、 「保留回合」步进器、摘要模型输入框与坏配置警告条, 复用 /traceless 命令——「一处逻辑、两个入口」(见官方 user-actions 规范)。

2. 需求达成度核对

原始需求状态说明
主动丢弃思考过程回传✅ 已实现llm/stream 剥 reasoning 块 + 剥 replayState
保留二人完整对话✅ 已实现正文/工具调用原样;日志(含思考)一字不动
需要时调用原思考✅ 已实现尾部 user 注记提示 + session_event_read 读原文;工具未挂载时注记自动降级、不再引导调用不存在的工具
平常只回传概括要点✅ v0.4.0 补齐两条路线均已实现、独立开关:①inlineSummary——模型生成回复时直接自附「Key points」段(原始需求括号里的路线;要点是正文 text 块,剥除后天然存活,零额外调用)②后台小模型总结(超时/截断/LRU/去重/并发上限/finish 检查)。默认都关,按需开启
压根不回传✅ 已实现marker: "" 即完全静默(剥空的消息整条移除,不发空消息)
更长的上下文⚠️ 部分请求 token 确实减少;但 compaction 计量偏差会提前触发,无可行钩子(见 compatibility.md §4)
不污染模型可见输出✅ v0.3.0 修复注记移出 assistant 正文(P0),实测污染源已消除。inlineSummary 开启时的「Key points」段是用户明确要求的可见输出,不属于污染
全部功能可操作开关✅配置 / /traceless / 面板三入口等效;v0.4.0 起摘要模型与参数也可经命令/面板调整
开箱即用、低门槛✅默认配置即生效(剥除 + 召回注记自动降级);面板在输入框下方;坏配置可用 /traceless 修回(v0.4.0)

3. 为什么保留工具调用(不是遗漏)

工具调用(assistant 的 tool-call 块)与工具结果(tool/result)有意保留,理由:

  1. 协议约束:Anthropic / DeepSeek Messages 要求 tool_use 块必须后跟对应 tool_result,剥掉一半会破坏配对、直接 400。
  2. 语义不同:工具调用是「动作/事实记录」,不是「思考过程」;模型需要知道 自己上一步调了什么、结果如何才能继续,剥掉等于失忆、任务断链。
  3. 原始需求本就是「丢思考、留对话」——工具调用属于对话的实质内容。
  4. 若嫌工具结果太大,官方已有 dsh-compaction-tool-result-pruner(裁超大工具 输出);把它裁掉是另一件事,默认不该动。

同理,只含 reasoning 的消息剥空后整条移除是安全的:它不含 tool-call, 移除不会产生孤儿 tool_result。

4. 架构依据(源码事实,全部核实)

  1. reasoning 持久化于 assistant/message 且确实回传(pi-ai replayedAssistant、 DeepSeek Messages assistant() 转成带签名的 thinking)。
  2. 改写历史的唯一官方拦截点是 llm/stream 瀑布(dsh-llm/lib/index.js:2648): agent/pre-step 只改本轮新输入,agent/request 只改 provider/model/effort。
  3. cordis waterfall 的 next() 不接受新值 → 用「短路 + 重入」模式(见 index.js)。
  4. replayState 陷阱:只删块不删 replayState 会走 foreignAssistant 降级、 把 thinking 原文又发出去 → 必须同步剥 replayState。
  5. 尾部 user 注记的官方先例:compaction 的总结请求就是「历史 + 尾部追加 {role:"user",content:[text]} 指令消息」(dsh-compaction-basic summarizeWithLlm),各适配器对该形态的处理已被官方路径验证。
  6. 身份标记恢复:markAgentLoopRequest / isAgentLoopRequest / dshGoRecall(含 inheritRequest、denyAuxiliary)都是 @deepseek-ai/dsh-llm 的导出符号;ESM 按 URL 缓存模块,解析到宿主同一文件即同一 WeakSet/WeakMap 实例。解析链:裸 import → apply 调用栈里的宿主 node_modules 根 → process.argv[1];全部失败为 no-op(行为等同 v0.2.0)。
  7. 日志永不动:插件不 append/replace 任何 surface 事件。v0.2.0 实测中会话日志 里的 marker 文本全部来自模型模仿输出,不是插件写入。

5. 设计决策:为什么不做持久 surface 影子化

理想形态是像 compaction 那样把旧 assistant 节点 surface-replace 掉,但当前版本 两条硬约束(dsh-session/lib/types/surface.js):assistant/message 禁 sourceEventSeqs (而 replace 要求覆盖被影子节点);第三方无法注册新的投影事件类型。故请求时改写 是 0.2.2-rc.1 下唯一官方途径;持久化路线列为 v3/上游提案。

另外两点已实现的加固(见 docs/compatibility.md):compaction 的总结调用 (options.purpose === "compaction")豁免不改写,保住 checkpoint 质量与前缀缓存; 剥 reasoning 必须同步剥 source.replayState(否则降级路径 foreignAssistant 仍会 把 thinking 原文发回 provider)。

6. 兼容性

见 docs/compatibility.md(独立静态审计:llm/stream 监听器 共存与顺序、短路重入与 image 请求、各适配器降级与签名、compaction 交互、路由差异、 召回工具;文末附 v0.3.0 增补)。关键结论:与官方栈总体兼容;两处需实测—— DeepSeek Messages 路由上未闭合回合对 keepRecentAssistant 的敏感性、带 image 请求重入。dsh-go 伙伴召回的身份问题已由 best-effort 恢复缓解(官方 Web 不受影响)。

7. 安装与验证

node test.mjs            # 98 项断言(纯函数 + mock 行为自测)

# 安装到官方 DSH(任选其一)
# A. agent 会话内:plugin_manager install_bundle 指向本目录
# B. GUI 插件管理安装本地 bundle;或 CLI:dsh plugin --profile web add <path>
# 替换已装包需重启进程(link: 安装改文件后重载插件即可)

验证:① verbose:true 看剥除日志(现在按块/消息双计数);② provider 抓包确认 旧回合 thinking 消失、请求末尾多一条 user 注记;③ UI 旧回合思考仍完整; ④ 回归项:连续多轮对话,确认可见回复不再出现注记前缀;⑤ 挂 dsh-tool-session-query 后问「你当时为什么这么做」看它调 session_event_read, 未挂时注记应为 PLAIN 变体;⑥ 路由矩阵(DeepSeek Messages / pi-ai / OpenAI 兼容) 各跑多步工具调用确认无 400;⑦ 故意写坏配置(如 keepRecentAssistant: "x" 或 未知键)重载后 /traceless status 应显示 WARNING 且命令可用,/traceless reset 或任一 写命令应能修回;⑧ /traceless inline on 后新回复尾部应出现「Key points」段, 后续请求剥除旧思考后该段仍保留在历史里。网页面板开关逐个点、 /traceless status 核对生效状态。

8. v3 路线

  1. 持久化剥除决策(llm/stream 拿不到 session,改为 pre-step 借 agent 拿 session、 appendPluginRecord 记决策)。
  2. 上游提案:放开 assistant/message 的 sourceEventSeqs 或开放第三方投影事件注册; waterfall 支持改写值(消除短路重入)。
  3. 要点「正文自附」开关 → v0.4.0 已实现(inlineSummary)。
  4. 路由级开关(excludeProviders)、摘要结果持久化(热重启不丢,见 §0 未修项)。

9. 升级核对清单

  • llm/stream 瀑布与 options 形态未变
  • cordis waterfall 的 next() 仍不接受新值
  • 适配器降级路径对「无 replayState + 无 reasoning」历史仍正常
  • 尾部追加 user 消息仍被各适配器接受(对照 compaction 指令消息路径)
  • markAgentLoopRequest / dshGoRecall.inheritRequest / denyAuxiliary 导出未变
  • session_event_read 语义未变
  • ctx.commands.register(含 recordInput)/ configEditor.edit 签名未变
  • engines 上限是否需要放宽(重跑本清单后)
  • 重跑 node test.mjs + §7 验证步骤

10. 文件清单

文件作用
index.js宿主插件(剥除 + 尾部注记 + 要点 + compaction 豁免 + 身份恢复;导出纯函数供自测)
defaults.js共享常量与 DEFAULTS 单一来源(默认注记文案、上限、LRU 容量)
host-commands.js宿主 /traceless 命令注册(configEditor 持久化;坏配置下仍在场)
client.js网页设置面板(composer dock 开关,复用 /traceless,写后重拉真实状态)
docs/compatibility.md独立兼容性静态审计(含路由 × 行为矩阵、v0.3.0 增补)
docs/UI-NOTES.md客户端↔宿主通道调研结论与取舍
cordis.patch.yml / package.jsonbundle manifest(含 dsh.client;engines 带版本上限)
test.mjs纯函数 + mock 行为自测(98 断言)
locale/{en,zh}.json / icon.svg显示元数据(面板文案内联在 client.js)

11. GitHub 发布信息

项值
仓库名traceless(GitHub / Gitee 同名,默认分支 main)
地址GitHub Lhy220402/traceless · Gitee leng-haoyuan/traceless
一句话Forget how it thought. Keep what it said.
AboutForget how it thought. Keep what it said. A DeepSeek Harness plugin that strips past-turn reasoning from replayed context, keeps the session log intact, and lets the model recall the original thinking on demand.
Topicsdsh, deepseek-harness, context-window, reasoning, token-saving, llm, cordis, traceless
包 / 命令dsh-plugin-traceless / /traceless;private: true 防误发 npm
许可证Apache-2.0(见 LICENSE / NOTICE)
命名核查GitHub traceless 仅 128 个同名仓库(头部是别人的用户主页 alist-encrypt);npm 的 traceless 与 dsh-plugin-traceless 均未占用(2026-11 查)
# 首次发布(先在 github.com/new 建空仓库 traceless,不勾 README / license)
git remote add origin git@github.com:<你的账号>/traceless.git
git push -u origin main --tags

已发布:GitHub https://github.com/Lhy220402/traceless、Gitee https://gitee.com/leng-haoyuan/traceless,两边默认分支均为 main,tag v0.5.0 / v0.5.1 / v0.5.2。

后续发版:git tag vX.Y.Z && git push origin main --tags && git push gitee main --tags。

12. 许可证

Apache License 2.0(SPDX-License-Identifier: Apache-2.0)。

  • 全文见仓库根目录 LICENSE,版权与归属声明见 NOTICE。
  • 贡献即表示同意以 Apache-2.0 授权;若沿用 Apache 官方模板,可在每次修改的文件头加:
// Copyright 2026 <贡献者>
// SPDX-License-Identifier: Apache-2.0
  • 选 Apache-2.0 而不是 MIT 的理由:显式专利授权(第 3 条)、商标不被授权(第 6 条)、修改文件需保留声明——对「会被 fork 后做商用/闭源集成」的宿主插件更稳。

Comments

Loading…

Similar plugins

dsh-recall

Cross-session memory for DeepSeek Harness: list earlier sessions and load one on demand, so a new session can see what was already done without polluting the current context.

Tools & CapabilitiesMemory & ContextManifest valid

★ 0

dsh plugin --profile web add dsh-recall

Marks models in use by other running sessions in the DSH model menu, and restores the remembered reasoning effort and group collapse state for each model.

UI & ExperienceManifest valid

★ 0

dsh plugin --profile web add dsh-model-in-use

by kkwings

该仓库暂未提供项目说明。

Memory & ContextSessions & MessagesManifest valid

★ 1

MIT

JavaScript

Oct 12, 2026

dsh plugin --profile web add dsh-super-memory

by ScreamingMaggot

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

Memory & ContextSessions & MessagesManifest valid

★ 1

MIT

JavaScript

Oct 22, 2026

dsh plugin --profile web add rcs-context

Stops compaction summaries and session titles from burning their output budget on reasoning, by lowering the thinking level and raising the token floor for auxiliary calls only.

Models & ProvidersManifest valid

★ 0

dsh plugin --profile web add dsh-aux-degrade

by Hanochhu

Context offloading for DeepSeek Harness: consumed tool calls and their results are replaced in the model-visible history by a short stub, while the originals stay in the session log for replay.

Sessions & MessagesManifest valid

★ 0

MIT

JavaScript

Sep 24, 2026

dsh plugin --profile web add dsh-context-offload