快速了解

它能做什么

一个用于缩减长会话上下文和工具输出 Token 载荷的 DeepSeek Harness 插件包。

本站提供的是中文说明，不代表该项目或 Plugin 自身提供中文界面；语言支持请以上游文档为准。

有代码证据的贡献

它为 DSH 增加什么

分层 Token 优化管道

压缩或缩减部分上下文与工具结果载荷，统计缓存使用情况，并可在长 DSH 会话中触发压缩。

机制证据 ↗

选择前先看

该插件包会将 dsh-token-optimizer 挂载到 DeepSeek Harness。文档说明它可通过视觉流程摘要超长自然语言输入、压缩大型工具输出、把重复文件读取折叠为 diff、按需暴露 MCP 工具、驱动压缩，并汇报缓存与会话节省情况。

适合谁

适合需要管理长时间、重度工具调用会话，并愿意审查 profile 级插件配置的 DeepSeek Harness 用户。

常见任务

减少大型 Shell、CSV、JSON 数组和错误结果在上下文中保留的载荷。
对重复文件读取折叠未变内容，或仅发送变更区段 diff。
配置 MCP 懒加载，避免未使用的 MCP 工具 schema 进入请求。
在恢复所需核心压缩后端后，为长 web profile 会话启用压缩驱动。

权限与数据

插件会处理 agent 上下文和工具输出；可选模块可能保留原文并调用外部 API。

权限

可处理自然语言上下文、工具输出和重复文件读取结果。
随附插件补丁为可见工具配置了 allowlist，其中包括文件、PowerShell、联网搜索、协作、GitHub、记忆和撤销工具。

数据处理

文档说明，当 saveOriginal 启用时，text2img 和 outputLadder 会保存原始内容。
文档中的缓存默认 TTL 为 3600 秒。

外部服务

可选的 text2img 摘要会使用配置的 DeepSeek API 端点。
可选 MCP 懒加载需要已挂载 DSH MCP client，且至少配置一个 MCP 服务器。

凭据

text2img 摘要需要 DEEPSEEK_API_KEY。

局限

README 中的 Token 节省数据来自作者陈述，未在所供证据中独立验证。
在非 Windows 系统上，text2img 渲染会降级为仅保存原文。
对于 web 部署，必须在 profile 中重新启用 compaction-basic 和 command-compact，compactionDriver 才会生效。
未配置 MCP 服务器时，MCP 懒加载不会执行实际操作。

DSHub 已核对

包清单确认版本为 2.0.0、许可证为 MIT、入口为 ES module，并声明了 DSH bundle patch。
固定提交的 Git 插件包交付路径和插件包结构已验证。
插件补丁会挂载 token-optimizer 配置。

DSHub 未核对

未实际执行安装。
未运行 smoke test 或端到端测试。
未证实与某个特定 DeepSeek Harness 版本的运行时兼容性。
未独立复现所报告的 Token 节省和缓存命中率。

固定版本安装

安装 DSH Token Optimizer

这个Plugin Bundle没有 DSH Plugin 安装操作，请根据源码文档使用真实交付方式。

访问源码项目 ↗

维护者原文

项目 README

查看 commit aca6c70 对应的 README ↗

维护者编写的上游内容原文于 2026/9/6 从 README.md 获取，正文和仓库相对媒体固定到 commit aca6c7038d48，内容哈希为 47244c6e667a。以下是未经 DSHub 翻译的上游原文，语言可能与当前页面不同；第三方托管的 badge 可能独立更新。

dsh-token-optimizer

DeepSeek Harness 分层 Token 优化管道。在 DSH 已内置能力之外做真实增量：把进入模型的文本压缩/裁剪/采样，降低 token 开销，不牺牲模型能力。

基于真实 DSH 插件 API（agent/pre-step、tools/execute、tools/post-execute、agent/status 等）实现，与社区方案文档中虚构的事件(如 message:before / context:building)无关。

它做什么（30 秒版）

模块	钩子	作用
text2img	`agent/pre-step`	超长自然语言文本（>5000 字符）→ 渲染成图 → vision 读图 → 摘要替换进上下文。单次样本曾省 ~72%；真正价值是长会话越省（后续轮次不再携带原文）。JSON/代码自动跳过
outputLadder	`tools/post-execute`	工具输出出生点单次遍历分流：错误结果→300 字符摘要；JSON 数组/CSV（≥10k 字符）→结构感知压缩；shell 输出（≥8k 字符）→头尾+等距采样；≥50k 字节交核心 spill；read 类豁免。原文落盘可逆
fileDiff	`tools/post-execute`	重复读文件：未变→折叠标记；有变→只发变更区段 diff
toolTrim	`agent/created`	工具可见性管理：静态裁剪 + MCP 懒加载——不用的 `mcp__` 工具 schema 不进请求*（实测省 ~9.4k token/请求）
compactionDriver	`agent/status`	agent idle 时按自定义压力比（默认 45%）驱动核心 `compactNow`，让长会话压缩真正发生（核心 0.8 阈值对 1M 窗口几乎永不触发）
monitor	`session/disposed`	会话结束输出节省统计 + 真实 usage 聚合与缓存命中率(长会话常态 97%–99.3%)

与 DSH 核心的边界

DSH 已内置 token-meter、compaction-basic、tool-result-pruner、spill、llm-retry、repeat-tool-reminder—— 本插件一律不重复实现，只做上面这些内置之外的增量。

安装

dsh plugin --profile web add ./dsh-token-optimizer

卸载：

dsh plugin --profile web remove dsh-token-optimizer

配置

挂载后在 profile 的 cordis.patch.yml 中覆盖（示例，均为默认值）：

- id: token-optimizer
  name: 'dsh-token-optimizer'
  config:
    text2img:
      enabled: true
      threshold: 5000
      pageFontSize: 24
      pageMaxHeight: 3000
      visionModel: 'deepseek-v4-flash-vision-exp'
      baseUrl: 'https://api.deepseek.com/v1'
      maxSummaryChars: 2000
      saveOriginal: true
      askOnSkip: true
    outputLadder:
      enabled: true
      structureThreshold: 10000
      compressionRate: 0.5
      preserveHeadTail: 1000
      shellTools: ['pwsh', 'bash', 'sh', 'powershell', 'zsh', 'cmd']
      shellThreshold: 8000
      headLines: 10
      tailLines: 10
      sampleInterval: 20
      errorSummaryChars: 300
      spillBytes: 50000
      readTools: ['read', 'read_image']
      saveOriginal: true
    cache:
      enabled: true
      ttl: 3600
    fileDiff:
      enabled: true
      tools: ['read']
      minSize: 2048
      maxFileBytes: 200000
      contextLines: 3
      collapseUnchanged: true
    toolTrim:
      enabled: false          # 默认关闭；启用后对每个 agent 作用域生效
      allow: []
      deny: []
      mcpLazy: true
      mcpPrefix: 'mcp__'
      mcpLoadToolName: 'mcp_load_tools'
    compactionDriver:
      enabled: true
      pressureRatio: 0.45     # totalTokens / contextWindow 超过该比才触发
      minTurns: 6
      minTokens: 100000
      maxCompactionsPerSession: 3
      contextWindow: 1000000
      timeoutMs: 120000

v1 的 compress / sample / pruning / dedup 节已退役（合并进 outputLadder），旧配置节会被静默忽略并在日志提示，不会导致加载失败。

web 部署必读：重新启用核心压缩后端

dsh-web-app 的 bundle patch 默认禁用了 compaction-basic 与 command-compact（配合 /compact 命令）， web 部署因此没有 compaction 服务，compactionDriver 会静默不生效。在 profile 的 cordis.patch.yml 顶层补：

- id: compaction-basic
  disabled: false
- id: command-compact
  disabled: false

依赖

text2img 渲染：Windows 需 PowerShell + .NET System.Drawing（scripts/render-text.ps1，免第三方依赖）；非 Windows 渲染降级为仅落盘原文。
text2img 摘要：需 DEEPSEEK_API_KEY 环境变量（DSH 已配置）。
mcpLazy：需 profile 挂载 @deepseek-ai/dsh-mcp-client 并配置至少一个 MCP 服务器；无 MCP 时自动 no-op。

开发

node test/smoke.mjs          # 单进程全量自检（无需 API），npm test 同
node --test test/modules.test.js
node test/text2img-e2e.mjs   # 真实端到端（需 API key + Windows 渲染）

路线图

自然语言配置工具（让模型改配置）
长文本→图片的跨平台渲染 fallback
与 dsh-behavior-enhancer 协同（内容压缩 × 行为管理，可独立安装）

有意识地管理

安装与管理

前置条件与目标 Profile

目标： Web Profile

交付方式： Git Bundle — Liora2050348900/dsh-token-optimizer#aca6c7038d48df53c2452fed82de471a58e773a6。

验证、更新与移除

显示生命周期命令

验证

dsh plugin --profile web list

兼容性与访问范围

DeepSeek Harness DSH bundle; web profile setup is documented： Not declared in supplied evidence。

检查兼容性证据 ↗

风险事实

tool-visibility

The bundled patch enables tool trimming and allows a specific list of file, shell, web, collaboration, GitHub, memory, and undo tools.

证据 ↗

external-api

The optional text-to-image summary feature requires DEEPSEEK_API_KEY and sends work to the configured DeepSeek API endpoint.

证据 ↗

证据与编辑审查Manifest、Bundle patch、分发与新鲜度

不可变证据

审查状态与源码活动

AI 已审查

安装前请审查 profile 补丁，尤其是已启用的工具裁剪 allowlist，以及会保留原始内容或调用 DeepSeek API 的设置。

AI 审查于 2026/9/9 UTC 13:56。GitHub 事实核对日期： 2026/9/9 UTC 13:56。

自当前证据基线以来，没有记录到重要源码变化。

下一步

按 Plugin 安装流程操作 →

订阅重要变化： DSH Token Optimizer →