dsh-oh-my-token
Manifest valid★ 4Native token admission for DeepSeek Harness: command-output filters, retrieval-style reads, a conservative prose trimmer, and a settings page that reports what was saved. No RTK binary, no codegraph s
dsh-oh-my-token
English | 中文
让工具输出在 agent 真正需要之前,不进入提示词。
dsh-oh-my-token 是 DeepSeek Harness 插件。它在工具结果写入日志之前完成改写,因此模型看到的字节与持久化记录完全一致;它从不改写工具参数、从不触碰磁盘上的会话文件、也不启动任何外部进程。
它把两个工具的理念内建到进程里,而不是捆绑两个二进制:
| 理念 | 来源 | 本插件的做法 |
|---|---|---|
| 按命令与输出形状压缩 | RTK(Apache-2.0) | 先解析模型已运行的命令,只保留结论和失败细节;命令过滤器没命中时,再按内容形状压缩:git diff/status/log、构建日志、grep/find/ls/tree、重复日志、编号文件与搜索结果。纯 JS,无二进制。 |
| 检索符号而非整文件 | codegraph | 把超大且未指定范围的 read 变成符号大纲,并限制过大的 grep 结果。无 SQLite 图库、无 MCP 服务。 |
外加两项模型根本不需要读取的变换(可分别开关):对可判定为散文的行,删去「谢谢」「请」「please」「thanks」等客套词;以及删除句末连续的 .、。、,、,(一行末尾有几个就删几个;ASCII 省略号 ... / … 除外)。它们作用于工具输出、你亲手输入的消息、助手的回复,以及历史对话——历史部分在组装请求时剥离,因此模型永远不会看到这些内容,而磁盘上的会话文件保持逐字节不变。
它保留了什么
过滤只允许丢弃不承载决策的文本。具体来说:
pytest→✓ 42 passed in 1.23s;失败时保留每一条FAILED、E、回溯与摘要行。git status→clean,或前 40 行。git diff→ 文件头加变更行;纯空白 diff 折叠为一行。tsc→ 每条error TSxxxx加总数;告警丢弃。npm/pnpm/yarn/bun/pip/uv/poetry安装 → 成功留摘要行,失败留错误行。- 其他命令 → 只做 ANSI、回车重绘、重复行与进度条清理。命令字符串永不改写。
- 命令过滤器没命中时(或对历史中的旧工具结果),RTK 结构压缩按形状接管:
git diff/status/log保留文件名、计数与 hunk 头;构建日志保留错误、告警与摘要;grep/find/ls/tree/search-list按文件/目录分组并给出计数;重复日志折叠;超长无结构内容保留头尾。它只收缩,不放大。
结果仍超预算时,全文通过 ctx.spillStore 保存,标记会告诉模型去哪里取。如果没挂载 spill store,标记会说明如何重跑或重新读取——插件绝不丢弃无法恢复的文本。
安装
dsh plugin --profile web add dsh-oh-my-token
本地检出:
dsh plugin --profile web add file:/path/to/dsh-oh-my-token
该命令把包加入配置目录的 dsh.profile.bundles,包自带的 cordis.patch.yml 负责挂载这一行。可用 dsh --profile web --dump-config 查看合成后的配置。
要改预算,在配置目录的 cordis.patch.yml 对应行下添加字段;省略的字段沿用 bundle patch 的默认值。开关和散文范围无需改 patch——由设置页面管理。
设置页面
设置 → 省 Token 是管理面板:
- 每个变换一个开关(5 个命令过滤器、RTK 结构压缩、2 个检索变换、句末标点、客套词、系统提示词编辑);
- 高级配置:预算、
minChars/minGain、检索阈值、超预算处理(spill/rerun/none)与logEvery,以及插件总开关; - 散文变换(句末标点 / 客套词)共用的三档范围(
off/ 仅散文输出 / 所有散文); - 节省记录:本次进程与历史累计、移除的 token 与字符、节省比例、按工具明细表,以及消息/回复剥离计数;
- 选择被写入的配置目录,方便确认开关是否真的落盘。
改动在下一次工具调用即生效,无需重启。选择写入配置目录的 dsh-oh-my-token.state.json(优先取 DSH_PROFILE_DIR,否则从携带本包的配置目录推断),下次启动时覆盖 bundle 配置。统计在同目录的 dsh-oh-my-token.stats.json,可在页面清除。
页面由三条精确路由支撑:/dsh-oh-my-token/state、/dsh-oh-my-token/stats 与 /dsh-oh-my-token/prompt(读取当前生效的系统提示词)。
系统提示词
在「设置 → 省 Token」底部的「系统提示词」卡片里,打开开关,把你要追加的内容拆成若干个小段(卡片):每张卡片一小段正文,点击「添加一小段」新增,「上移 / 下移」调整顺序,「删除这一段」移除。保存后,所有卡片按从上到下的顺序拼合成的最终系统提示词追加到现有 section 之后。保存时旧版 { mode, text } 配置自动迁移为单卡片。
- 每段一个
interpolate: false的 section——已自行替换已知变量,其余{{...}}保持字面量,不会被当作未知变量而报错; - 卡片顺序即提示词顺序;
- 运行时上下文快照不受影响;改动在下一次请求生效,无需重启。
{{变量}}:目前 DSH 内置{{provider}}(当前模型供应商)与{{model}}(当前模型名),保存后这两个写法会被替换成当前值;其他写法保持字面量,不报错。- 「恢复默认提示词」:立即按当前注册实时组装一份系统提示词(首次使用、未发过消息也能读到),按空行拆成多张卡片放进编辑器,方便在原默认内容上重新改写;读到的始终是未注入定制文本的原始提示词。
配置
| 字段 | 默认值 | 说明 |
|---|---|---|
enabled | true | 关闭插件但不移除配置行。 |
budgets.default | 6000 | 没有单独配置的工具的字符上限。 |
budgets.read | 12000 | 文件内容是编辑的基础,因此额度更高。 |
budgets.grep | 6000 | |
budgets.bash | 4000 | |
budgets.errorFactor | 2 | 错误结果允许放大到倍数。 |
minChars | 800 | 小于此值的结果不动(清理不值得冒险)。 |
minGain | 0.05 | 丢弃节省低于此比例的改写;散文句号改写始终保留。 |
filters.* | 全部 true | 各过滤器开关:pytest、git、tsc、packageManager、generic。 |
rtk | true | 命令过滤器未命中时,按输出形状再做一层 RTK 结构压缩。也可在设置页面关闭。 |
retrieval.readOutlineOverLines | 400 | 仅当行数超过此值且调用未带 offset/limit 时才生成大纲。 |
retrieval.maxOutlineSymbols | 60 | |
retrieval.maxGrepMatches | 50 | |
prose.stripTrailingPeriod | true | 删除散文行末尾连续的 . / 。 / , / ,(省略号除外)。 |
prose.stripPoliteness | true | 删去散文行里的「谢谢」「请」「please」「thanks」等客套词。 |
prose.scope | filtered | filtered = 仅命令过滤器标记为散文的输出(如 git log);all;off。 |
recovery | spill | spill | rerun | none。 |
logEvery | 0 | 每 N 次改写打印一条节省日志;0 为静默。 |
未知字段会在激活时报错,而不是静默忽略。以上字段都可以在「设置 → 省 Token」的「高级配置」里修改;enabled 是总开关,filters.* 对应上方的开关行。
为什么句号剥离有防护
删掉文件名、URL、版本号或代码行里的句号,为了省一个 token 而损坏数据,代价太大。因此 isProseLine 会拒绝:
- 围栏代码、diff 行、以
{ [ <开头或以;{}=结尾的行,以及带= ( ) ; { } [ ]等代码标点又以逗号结尾的行; - 赋值/声明/语句行(含
= ; { }或以const/function/import等开头),客套词删除不会碰它们; - 含 URL、邮箱、带扩展名路径的行;
- 看起来像版本号(
2.2.0)或host:port的内容; - 列表项(
-、*)、省略号,以及e.g./i.e.。
测量
oh-my-token report [profile-dir | session.jsonl]
按事件类型(user/message、assistant/message、tool/call、tool/result)统计会话日志,并列出最昂贵的工具结果。这是「改写前」的数字;设置页面显示「改写后」。
oh-my-token map <file|dir> # read 会生成的大纲
oh-my-token lint [config.json] # 校验行配置,不启动 DSH
设计约束
- 工具结果只追加。 替换发生在
tools/post-execute,因此被记录的就是替换后的内容。不用sessionProjections、不做追溯修改、不会让前缀缓存失效。聊天文本与旧工具结果则有意不同:历史句号与旧工具结果的 RTK 压缩只在派生请求(session.deriveMessages())中发生,从不写入持久化日志。 - 不改写参数。 DSH 在工具管线里禁止这样做,改写过的命令是另一个可能出错的地方。
- 零新依赖。
index.js只引入自己的文件。 - 过滤器故障不等于工具失败。 每个分支都有保护;出错时返回原始 decision。
- 与
dsh-token-frugal兼容。 两者同时挂载时,让dsh-token-frugal先跑无损编码,再由dsh-oh-my-token做语义准入。两者在任何变换上都不重叠。
刻意不做
- 宿主 CLI 发现。 告诉 agent 有哪些二进制可用(
PromptContext条目、oh-my-token host-tools)是独立的可选阶段;注入工具清单会让每个会话都付出提示词字节,包括从不调用 shell 的会话。 - 字符级压缩。 到处删标点风险很大,只为省一个 token 的零头。只保留上面的散文场景。
- 符号图。 大纲来自语言感知的正则。LSP 解析器更好,但那也是本插件拒绝引入的构建依赖。
- 输入框下方的小卡片。 页面放在设置里——人找策略时会去那里;输入框下方的卡片会在每个屏幕重复同样的数字。
致谢
- RTK(Apache-2.0) — 按命令过滤工具输出的思路来自 RTK;本插件的命令过滤器与结构过滤器都是纯 JS 实现。
- codegraph(MCP 服务,FSL-1.1) — 「先取符号地图,再按范围读取」的检索思路来自 codegraph;本插件用语言感知的正则做了无图库、无 MCP 服务的轻量实现。
- 许可证细节见
THIRD_PARTY_NOTICES.md与LICENSES/Apache-2.0.txt。
许可
MIT
RTK 结构过滤器按 Apache-2.0 使用;完整第三方声明(含 Apache-2.0 全文)见 THIRD_PARTY_NOTICES.md 与 LICENSES/Apache-2.0.txt。
Versions
| Latest version | Published | Size |
|---|---|---|
| 0.0.0-stage | — | — |
| 0.0.1 | — | — |
Comments
Loading…
Similar plugins
DeepSeek Harness plugin that trims tool output (head/tail plus grep folding), adds optional prompt shaping (Caveman and Ponytail), instant local responses, RTK command-output compaction, context-press
★ 1
MIT
TypeScript
dsh plugin --profile web add dsh-token-saverby WhAIthere
Read-only observer for native DeepSeek Search calls in DeepSeek Harness (dsh): appends each call's token usage to ~/.dsh/search-usage.jsonl so accounting plugins can price it. Requests and responses a
★ 0
MIT
JavaScript
Oct 26, 2026
dsh plugin --profile web add dsh-search-auditby y2zyyr
Persistent local token usage sidebar and settings page for DeepSeek Harness (DSH), with automatic history discovery and a durable SQLite ledger.
★ 3
↓ 290/wk
MIT
JavaScript
Oct 4, 2026
dsh plugin --profile web add @y2zyyr/dsh-token-usage-sidebarby jeffreyren1
Customize DeepSeek Harness without forking it—load, edit, manage, and hot-reload trusted JavaScript and TypeScript userscripts from the Web UI.自定义 DeepSeek Harness,无需 Fork——直接在 Web UI 中加载、编辑、管理并热重载可信的 JavaScript 和 TypeScript 用户脚本。
★ 1
MIT
TypeScript
Sep 28, 2026
dsh plugin --profile web add dsh-custom-jsby ilaomianyang
Long-term associative memory for DeepSeek Harness: raw episodes, typed memory cards and entity pages in a plain-text vault you own. No auto-injection, no embeddings, no binary store.
★ 0
MIT
JavaScript
Nov 3, 2026
dsh plugin --profile web add @ilaomianyang/dsh-memory-graphby haitang1
Codex-like persistent memory for DeepSeek Harness: auto-injected memory summary, raw memory tools, and per-session rollout summaries distilled into a bounded global memory file.
★ 3
MIT
JavaScript
Nov 19, 2026
dsh plugin --profile web add @dsh-external/dsh-memory