# @aiwayds/dsh-dcp 中文文档

规范地址：https://npmcn.com/package/%40aiwayds/dsh-dcp/

版本：0\.14\.0
npm 元数据更新时间：2026-11-06T00:32:07.665Z
中文译文更新时间：2026-11-06T12:36:26.390Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40aiwayds/dsh-dcp
原文对照：https://npmcn.com/package/%40aiwayds/dsh-dcp/?lang=original
项目主页：https://github.com/fan56/dsh-dcp
源码仓库：https://github.com/fan56/dsh-dcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：156 kB，20 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.2，@deepseek-ai/dsh-llm \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-agent \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-brand \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-skill \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-session \>=0\.2\.0-rc\.2，@deepseek-ai/schemastery ^3\.18\.2，@deepseek-ai/dsh-commands \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-compaction \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-invariants \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-token-meter \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-compaction-basic \>=0\.2\.0-rc\.2，@deepseek-ai/dsh-compaction-tool-result-pruner \>=0\.2\.0-rc\.2
- 首次发布：2026-08-18T01:48:59.701Z
- 最新版本发布：2026-11-06T00:32:07.228Z
- 近 30 天下载量：3200（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：21（近 12 个月 21 个）

## 中文简介

Dsh (Deep Seek Harness) 的定型上下文压缩后端——0-LLM摘要,/dcp命令,工作出框. 设计参考 Opencode-DCP/opencode-动态-context-pruning. 互联网档案馆的存檔,存档日期2013-12-21.

## 安装

```sh
npm install @aiwayds/dsh-dcp
```

也可以使用：`pnpm add @aiwayds/dsh-dcp`、`yarn add @aiwayds/dsh-dcp`、`bun add @aiwayds/dsh-dcp`

## README

# dsh-dcp

dsh（DeepSeek Harness）的确定性压缩后端：**上下文压缩不调 LLM**，开箱即用。

**要求 dsh >= 0.2.0-rc.2** — 本插件只跟随 dsh RC/stable 线（CI 与发版在运行时解析 latest/next 中更新的 dist-tag）。**不再支持 alpha 线。**

> **简体中文** · [English](https://npmcn.com/package/%40aiwayds/dsh-dcp/README.en.md)

## 为什么做

dsh 默认的压缩（`compaction-basic`）每次压缩都要让模型把旧对话**重新总结一遍**——费 token、慢、结果还不稳定。我们参考 opencode 社区的 [opencode-dcp](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning)（去重、清错、"技术摘要代替散文"），做了一个纯代码版本：

-   **零 LLM 调用**：压缩本身不消耗任何额外 token
-   **输出稳定**：相同对话永远得到相同摘要
-   **中文友好**：用户原话/路径/命令/报错逐字保留，按 CJK 真实密度计价
-   **继承官方全部安全机制**：触发、保留尾巴、事务锁、tool-pairing 边界都复用 dsh 官方实现（只替换"摘要"这一环）

## 效果

### 与官方默认压缩的对比

|  | 官方 compaction-basic | dsh-dcp |
| --- | --- | --- |
| 摘要方式 | 每次调 LLM 重写 | 确定性代码抽取 |
| 每次压缩的模型调用 | 1 次 | **0 次** |
| 输出稳定性 | 同对话多次可能不同 | 相同输入永远相同 |
| 摘要内容 | 语义归纳 | 逐字保硬信息（路径/命令/报错/待办/用户原话） |
| 中文 | 依赖模型转写 | 原样保留 + CJK 计价 |
| 触发/保留/溢出/安全 | 官方 | **继承官方，完全相同** |
| 检查点格式 | 官方 | 兼容（可互相合并） |

设计上还吸收了 [opencode-dcp](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning) 的思路（去重、清错、`/dcp` 命令、技术摘要），但按 dsh 的压缩接口重新实现——它服务于 opencode，dsh-dcp 服务于 dsh。

### CJK 适配

内容逐字保留、不做英文转写；token 计价按 CJK 真实密度（中/日/韩/全角约 2 字符/token），不沿用宿主"4 字符/token"对中文的低估——中文会话的摘要预算反映真实成本，不会被饿死，信息更密集。

### 真实 dsh 会话实测

一段约 8 万 token 的历史压成约 700 token（**~100x**），全程零 LLM 调用；缓存命中率几乎不变（压缩后总会有一个"冷请求"，任何后端都一样）。

真实会话里压缩出的检查点（中文内容逐字保留）：

```
## Primary Request and Intent
- 帮我把登录页的重定向 bug 修掉

## Files and Code
- /app/src/auth/login.ts — W×1 R×1

## Errors and Fixes
- bash: FAIL src/auth.test.ts

## Pending Jobs
- add regression test

## Critical Context
- dsh-dcp 确定性压缩了 12 条消息 / 8 次工具调用（未调用 LLM 摘要）
```

## Not in scope

-   **不做语义归纳**：不"理解"代码，只保留"出现过的事实"。需要深度语义摘要的场景，请继续用官方 `compaction-basic`
-   **dsh 已经有的我们不重复做**：
    -   工具结果剪枝（`compaction-tool-result-pruner`，确定性按大小剪）
    -   触发策略、保留尾巴、溢出恢复（直接继承官方；本插件仅新增轮数触发，见上）
    -   `/compact` 命令、UI 检查点卡片（dsh 自带）

## 安装

**推荐：配合我们的 dsh-tui-pi 用**（tui 已依赖 dsh-dcp）：

```bash
npm i @aiwayds/dsh-tui-pi
dsh plugin add @aiwayds/dsh-dcp     # 激活 dcp，bundle 自动挂载
```

**独立使用**：

```bash
npm i @aiwayds/dsh-dcp
npx dsh-dcp-setup                   # 安全脚本：带日期备份 → 只追加 → 幂等判断，不碰你已有的配置
```

> dsh-dcp 挂在 dsh 的压缩接口上，只对挂载了它的 profile 生效。web profile 没挂 tui，继续用官方压缩，不受影响。

## 卸载

**Bundle 方式**（`dsh plugin add` 或列在 `bundles`）：

```sh
dsh plugin --profile <name> remove @aiwayds/dsh-dcp
```

宿主自动收敛：bundles 条目移除、patch 层随包消失，官方 LLM 压缩后端 `compaction-basic` 自动恢复。

**setup 脚本方式**（`npx dsh-dcp-setup` 写入的 patch 块）：

```bash
npx dsh-dcp-setup --remove                        # 默认 home patch
npx dsh-dcp-setup --remove --profile tui          # 指定 profile
npx dsh-dcp-setup --remove /path/to/cordis.patch.yml
```

`--remove` 只删除 setup 写入的挂载块（含你调过的 config），修改前同样带日期备份；手工写的挂载块不受影响；删完文件为空时自动删除文件。两条 WARN 要留意：文件里若还留有 `compaction-basic` 的 disable 条目，官方压缩后端会保持关闭 —— 不是给 dsh-dcp 用的就手动删掉；同一文件里另一处 dsh-dcp 挂载不会被碰。

不执行反向步骤直接卸包，patch 里的绝对路径会指向已消失的安装目录，profile 启动将以 module-not-found 失败。

## /dcp 命令

| 命令 | 作用 |
| --- | --- |
| `/dcp` | 立即压缩（零 LLM）；等同于 `/dcp compact` |
| `/dcp status` | 状态：配置、压缩次数、省下的 token |
| `/dcp help` / `--help` / `-h` | 显示命令用法 |
| `/dcp set <k> <v>` | 会话内调参，并提示如何持久化 |

可调键：`dedup`、`purgeErrors`、`maxItems`、`maxItemChars`、`maxSummaryTokens`、`language`、`tokenEstimate`、`thresholdRatio`、`roundInterval`、`notice`、`onModelSwitch`、`modelSwitchMinTokens`。

裸 `/dcp` 与 `/dcp compact` 走同一条手动压缩缝——最常用的动作零参数直达，不必记子命令；只读或调参的动作留在显式子命令后面（看状态打 `/dcp status`，用法打 `/dcp help`）。

> **0.11.0 起语义变更**：裸 `/dcp` 由「显示状态」改为「立即压缩」，原来的状态输出移到 `/dcp status`。升级后别再用裸 `/dcp` 查状态——它会直接压一次。

`/dcp status` 还会列出每个发生过压缩的会话（per-session 概览，含子代理），例如 `per-session: session-1 (2 compactions, ~444 tokens), child (1 compaction, ~22 tokens)`。压缩按会话独立计数；已销毁的会话（含 one-shot 子代理）自动从概览消失；列表封顶一行（最多前 10 个会话，超出显示 `+N more`）。

## 触发条件

| 触发 | 时机 | 说明 |
| --- | --- | --- |
| 压力触发 | 每步请求前 | token ≥ `thresholdRatio`（继承上游默认 0.8；本插件 bundle 挂载默认 0.7，见配置表）× 上下文窗口 |
| 溢出恢复 | 模型报 context 超限时 | 继承官方 |
| **轮数触发** | 会话每收到 `roundInterval` 条 assistant message | 本插件新增；一条 = 一次 LLM 往返（每轮工具迭代各算一条，one-shot 子代理也能触发）。**默认 50**：第 50 条后触发第一次，之后每 50 条一次（100、150……）；任何一次压缩（含压力触发）都会重置轮数时钟。到达条数后的第一个空闲点触发（阈值之下也压）。`0` 关闭；需保持 `auto: true`（默认开） |
| **模型切换** | 会话实际路由的 provider/model 变化时 | 本插件新增（`onModelSwitch`）。默认 `notice`：追加一行提醒"建议先执行 `/dcp compact` 压缩旧模型历史，节省 token"；`auto` 在该会话下一个空闲点自动压缩；`off` 关闭。两道门控：距上次压缩不足 10 条 assistant message 忽略（没有旧账可甩），上下文不足 `modelSwitchMinTokens`（默认 32768，`0` 关闭该门）忽略（不够甩的量）；`auto` 需保持 `auto: true`（默认开），否则降级为 `notice` |
| 手动 | `/dcp`（无参数）、`/dcp compact`、`/compact` | 随时可用 |

-   **subagent 同样生效**：进程内 subagent（含 continuable 与 one-shot 子代理）走同一套事件分发，压力/溢出/轮数/模型切换对子会话独立计数、独立触发。轮数触发按 assistant message 计数，所以全程只有 1 个 turn 的 one-shot 子代理（多次工具迭代）也能触发。
-   **模型切换检测原理**：折叠每请求的 `request/context` 路由快照（provider 或 model 任一变化即判定切换），覆盖所有切换入口（TUI `/model`、Web 客户端、默认模型设置变更）；会话首个请求只播种基线不告警。`notice: false` 只关压缩通知行，模型切换提醒行由 `onModelSwitch` 独立控制。上下文下限按宿主 tokenMeter 的实测计价（`measure().surfaceTokens`），测不到时 fail-open（只留轮数门控）。
-   **压缩可见性**：每次压缩成功后，会话里追加一行 `dcp: 已压缩 N 条历史（约 X tokens，触发方式）` 通知行（前端渲染为折叠行）。注意该行也会作为上下文随请求发给模型（每次压缩约 15–25 tokens），且 **0.4.0 起默认开启**；`notice: false` 可关闭。`/dcp status` 的 stats 持续累计（压力触发的多次 region 提交各计一次）。

## 配置

全部可选，默认即用：

| 键 | 默认 | 说明 |
| --- | --- | --- |
| `thresholdRatio` | 0.8 | 压力触发阈值（继承上游 compaction-basic 默认 0.8；本插件 bundle patch 挂载时默认 0.7，中文场景建议 0.7） |
| `headroomTokens` | 65536 | 继承上游 compaction-basic（0.1.7 新增）：压力预算额外余量（非负整数）。压力上限 = 上下文窗口 − 路由请求预留输出（`maxTokens`）− 本余量；小窗口模型建议下调 |
| `roundInterval` | 50 | 每 N 条 assistant message（一次 LLM 往返）触发一次压缩（0 关闭）。默认 50：50、100、150……每次压缩后重数 |
| `onModelSwitch` | `notice` | 模型切换后：`notice` 提醒执行 `/dcp compact`（默认）；`auto` 下一个空闲点自动压缩；`off` 关闭 |
| `modelSwitchMinTokens` | 32768 | 模型切换提醒/自动压缩的上下文下限（按宿主 tokenMeter 实测计价）：不足则忽略该次切换；`0` 关闭此门。默认 32k ≈ 压缩后基线（~16% 窗口）之上再涨一截才有得甩 |
| `notice` | `true` | 压缩后在会话中追加一行通知 |
| `language` | `zh` | 摘要语言；`zh` 额外识别中文报错和"待办：" |
| `tokenEstimate` | `cjk` | CJK（中/日/韩/全角）按 ~2 字符/token 计价；`ascii` 与宿主一致 |
| `dedup` | `true` | 标注重复工具调用 |
| `purgeErrors` | `true` | 旧报错折叠成一条提示 |
| `maxItems` / `maxItemChars` | 10 / 200 | 摘要密度 |
| `maxSummaryTokens` | 2048 | 摘要 token 预算 |

> **升级提示（0.5.0）**：`roundInterval` 的计数单位由 completed turn 改为 assistant message——同值下触发会更频繁（一个 turn 内往往有多条 assistant message）。

## 内置技能 / Bundled skill

插件随包注册了 `dsh-dcp-config` skill（`skills/dsh-dcp-config/SKILL.md`，经 `ctx.skills.registerProvider`）：在会话里让 agent 调压缩、配置 dcp 或排查压缩行为时，指南自动加载——内含 ask\_user\_question 交互式调参向导（先问期望再映射到具体键）与 cordis.patch.yml 挂载块 `config:` 段的持久化写法，无需翻文档。

## 设计参考

-   [Opencode-DCP/opencode-dynamic-context-pruning](https://github.com/Opencode-DCP/opencode-dynamic-context-pruning)
-   dsh 官方 compaction 接口：`docs/subsystems/compaction.md`（deepseek-harness）

## 开发

```bash
npm install && npm test     # 109 个用例：抽取/压缩/命令/配置/触发/恢复缝/安装脚本
```

## License

Apache-2.0

## 常见问题

### @aiwayds/dsh-dcp 是什么？

Dsh \(Deep Seek Harness\) 的定型上下文压缩后端——0-LLM摘要,/dcp命令,工作出框\. 设计参考 Opencode-DCP/opencode-动态-context-pruning\. 互联网档案馆的存檔,存档日期2013-12-21\.

### 如何安装 @aiwayds/dsh-dcp？

在项目目录运行 npm install @aiwayds/dsh-dcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dsh-dcp-setup，可以用 npx dsh-dcp-setup 直接运行。

### @aiwayds/dsh-dcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aiwayds\_\_dsh-dcp 是否存在。

### @aiwayds/dsh-dcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @aiwayds/dsh-dcp 可以商用吗？

@aiwayds/dsh-dcp 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @aiwayds/dsh-dcp 的下载量有多少？

根据 npm 官方下载统计，@aiwayds/dsh-dcp 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,200 次，日均约 107 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @aiwayds/dsh-dcp 还在维护吗？

最新版本 0\.14\.0 发布于 2026/11/06（1 天前）；至今共发布 21 个版本，其中过去 12 个月发布了 21 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。