- ホーム
- プラグイン
- セッションとメッセージ
- traceless
traceless
lhy220402/traceless
Strips past-turn reasoning blocks from replayed context while keeping the session log intact, and lets the model recall the original thinking on demand.
インストール
dsh plugin --profile web add github:lhy220402/tracelessREADME
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-shed | dsh-plugin-traceless |
| 斜杠命令 | /shed | /traceless |
| 插件 id | reasoning-shed | traceless |
| 摘要 purpose | reasoning-shed-summarize | traceless-summarize |
| 内部标识 | shedMessage()、_shedStats{shedMessages,shedBlocks,shedChars} | stripMessageReasoning()、_stripStats{strippedMessages,strippedBlocks,strippedChars} |
| 面板 / 本地化 | Reasoning shed / 思考剥离 | Traceless / 无痕回传 |
名字由来:思考不再留在回传的轨迹(trace)里,而日志里仍一字不少。配置键与剥除行为完全不变;升级只需把 profile 的 link: 依赖、patch 里的条目 id,以及习惯用的 /shed 换成新名。
0b. v0.4.0 变更(独立审查修复 + 原始需求补齐)
| 编号 | 问题 / 缺口 | 修复 |
|---|---|---|
| P2 | summarize.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 全部在飞调用 |
| P3 | maxTokens=max(128,maxChars) 把字符当 token,中文必中途截断 | max(128, maxChars×2) 估算 |
| P3 | commands 服务晚启动时 /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 变更(实测回归修复)
| 编号 | 问题 | 修复 |
|---|---|---|
| P0 | marker 插在被剥 assistant 消息头部,历史里成串同前缀回合诱导模型模仿,污染可见回复并写进会话日志(实测复现) | 注记改为请求末尾单条 user 角色消息(官方 compaction 尾部指令消息同款形态),不再触碰任何 assistant 消息;摘要(summarize)作为被剥消息尾部 text 块附加,内容逐条不同、无固定前缀模式 |
| P1 | 配置错误 → apply 抛异常 → 插件不挂载 → /traceless 一起消失,只能手工改文件 | /traceless 在任何校验之前注册;配置解析失败降级 DEFAULTS 并 warn,错误详情经 /traceless status / /traceless json 暴露;summarize.enabled 缺 model 只关摘要不拖垮插件 |
| P1 | engines.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 变体间降级;自定义文案原样使用 |
| P2 | summaries Map 无界增长 | LRU,上限 SUMMARIES_MAX = 500 条 |
| P2 | summarize 调用无超时 / 无 maxTokens / 成本不可控 | AbortSignal.timeout(summarize.timeoutMs)(默认 30s,可配,≤600s);maxTokens = max(128, maxChars);输出按 maxChars 硬截断;思考原文输入截断 12000 字符;按消息 id 去重;带 sessionId + purpose:"traceless-summarize";dsh-go recall 保护会话经 denyAuxiliary 语义直接跳过 |
| P2 | marker:"" 时可能产生空 content 的 assistant 消息(严格 provider 潜在 400) | 剥后 content 为空的消息整条移除(只含 reasoning 的消息无 tool-call,不破坏 tool_use/tool_result 配对) |
| P2 | DEFAULTS 双份复制漂移风险 | 新增 defaults.js 单一来源,index.js / host-commands.js 共用 |
| P2 | inject 硬依赖 "commands" 与软兜底矛盾 | inject = ["llm"];commands 软获取,缺失时降级为无 /traceless 并 warn |
| P3 | strippedBlocks 按消息计数 | 按 reasoning 块计数,另计 strippedMessages |
| P3 | /traceless marker on 覆盖自定义文案找不回 | 新增 /traceless marker text <custom>(保留原文空格,≤2000 字符);on = 恢复默认 |
| P3 | keepRecentAssistant 无上限 | 上限 KEEP_RECENT_MAX = 64(命令与 resolveConfig 双侧校验) |
| P3 | 面板乐观占位 "[default marker]" 显示不准 | 写命令成功后重拉 /traceless json 真实状态;marker 显示三态(默认/自定义/静默);recordInput:false 减少命令参数入日志 |
| P3 | icon 硬编码深色底 | 透明底 + 中性灰,深浅主题均可读 |
| P3 | files 不含 test.mjs | 已加入(连同 defaults.js) |
未修(有意的):compaction 计量偏差(tokenMeter 基于 session,无可行钩子,方向保守只是多压一点);/traceless 的 command/run、command/done 生命周期记录(dsh-commands 固定行为,无法关闭);面板文案三处同步(浏览器端拿不到包内 JSON,UI-NOTES.md 已记录)。
1. 功能与开关
每项功能独立开关,三处入口等效:配置文件、/traceless 命令、网页面板(client.js)。
| 配置键 | 默认 | 含义 | 命令 / 面板 |
|---|---|---|---|
enabled | true | 总开关:是否剥除历史 reasoning | /traceless enable|disable;面板「剥除」 |
keepRecentAssistant | 2 | 保留最近 N 条含 reasoning 的 assistant 消息不动(未闭合回合需签名思考;1..64) | /traceless keep N |
marker | RECALL 注记 | 请求末尾追加的单条 user 注记文本;"" = 完全静默;等于默认文案时按召回工具在场自动降级 | /traceless marker on|off|text <custom>;面板「标记」 |
inlineSummary | false | 内联要点:模型在回复正文尾部自附「Key points」段(生成文本时直接生成;要点随正文落日志、剥除后存活)。长度预算用 summarize.maxChars | /traceless inline on|off;面板「回复自附要点」 |
summarize.enabled | false | 思考要点回传:后台小模型总结后附在被剥消息尾部 | /traceless summarize on|off;面板「要点」 |
summarize.model | "" | 总结用 provider/model(配置期校验格式;未设置时摘要保持关闭,只 warn) | /traceless summarize model <provider/model>;面板输入框 |
summarize.maxChars | 400 | 要点长度硬上限(提示词约束 + 输出截断;≤4000;也是内联要点的长度预算) | /traceless summarize maxChars N |
summarize.timeoutMs | 30000 | 单次总结调用超时(≤600000) | /traceless summarize timeoutMs N |
verbose | false | 诊断日志 | /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)有意保留,理由:
- 协议约束:Anthropic / DeepSeek Messages 要求
tool_use块必须后跟对应tool_result,剥掉一半会破坏配对、直接 400。 - 语义不同:工具调用是「动作/事实记录」,不是「思考过程」;模型需要知道 自己上一步调了什么、结果如何才能继续,剥掉等于失忆、任务断链。
- 原始需求本就是「丢思考、留对话」——工具调用属于对话的实质内容。
- 若嫌工具结果太大,官方已有
dsh-compaction-tool-result-pruner(裁超大工具 输出);把它裁掉是另一件事,默认不该动。
同理,只含 reasoning 的消息剥空后整条移除是安全的:它不含 tool-call, 移除不会产生孤儿 tool_result。
4. 架构依据(源码事实,全部核实)
- reasoning 持久化于
assistant/message且确实回传(pi-aireplayedAssistant、 DeepSeek Messagesassistant()转成带签名的thinking)。 - 改写历史的唯一官方拦截点是
llm/stream瀑布(dsh-llm/lib/index.js:2648):agent/pre-step只改本轮新输入,agent/request只改 provider/model/effort。 - cordis
waterfall的next()不接受新值 → 用「短路 + 重入」模式(见 index.js)。 - replayState 陷阱:只删块不删 replayState 会走
foreignAssistant降级、 把 thinking 原文又发出去 → 必须同步剥 replayState。 - 尾部 user 注记的官方先例:compaction 的总结请求就是「历史 + 尾部追加
{role:"user",content:[text]}指令消息」(dsh-compaction-basicsummarizeWithLlm),各适配器对该形态的处理已被官方路径验证。 - 身份标记恢复:
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)。 - 日志永不动:插件不 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 路线
- 持久化剥除决策(llm/stream 拿不到 session,改为 pre-step 借 agent 拿 session、
appendPluginRecord记决策)。 - 上游提案:放开 assistant/message 的 sourceEventSeqs 或开放第三方投影事件注册; waterfall 支持改写值(消除短路重入)。
要点「正文自附」开关→ v0.4.0 已实现(inlineSummary)。- 路由级开关(
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.json | bundle 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. |
| About | Forget 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. |
| Topics | dsh, 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)。
// Copyright 2026 <贡献者>
// SPDX-License-Identifier: Apache-2.0
- 选 Apache-2.0 而不是 MIT 的理由:显式专利授权(第 3 条)、商标不被授权(第 6 条)、修改文件需保留声明——对「会被 fork 后做商用/闭源集成」的宿主插件更稳。