前言¶

在 DeepSeek Harness（DSH）里做长会话时，上下文会逼近模型窗口上限。DSH 内置的压缩会在边界处调用模型，把旧历史总结成一段摘要再替换原文。这种做法要等模型返回、摘要质量不稳定，被替换的内容默认也无法再被模型直接看到。

如果你更关心「边界处是否还要多打一轮模型」「重要信息由谁决定保留」「原文能不能按序号回读」，笔记式压缩是一条不同的路。下面介绍社区插件 dsh-notes-context（维护者 sqzw-x），它把 Oh My Pi（omp）里的笔记式上下文压缩思路接到 DSH 上：用模型维护的持久笔记本取代 LLM 摘要，窗口滚动时边界处零模型调用。

这是什么¶

dsh-notes-context 是 DSH 生态下的「记忆」类插件，仓库 sqzw-x/dsh-notes-context，npm 包名 dsh-notes-context（当前资料中版本 0.2.1，MIT 许可）。一句话定位：不总结、改记笔记；滚动窗口时写入固定过渡文本和当前笔记全文，不调用模型做摘要。

插件通过 Cordis patch 挂载，并会停用内置的 compaction-basic，由本包接管压缩相关行为。

与内置压缩的差异¶

内置机制在接近窗口上限时调用模型总结旧历史并用总结替换原文。README 归纳了三个常见痛点：慢（需等待总结）、不可靠（质量随当次发挥变化）、原文丢失（被替换历史默认不可见）。

本插件采用笔记本机制，对比如下（摘自官方 README）：

核心机制¶

笔记本 context_notes¶

模型在会话中维护一本笔记，记录任务状态、已定决策、改动过的文件、阻塞项、下一步等；笔记跨窗口保留。

context_notes                    → 读取
context_notes { text: "..." }    → 整本替换（非追加）
context_notes { text: "" }       → 清空

上限为 16 KiB（UTF-8 字节）；超出会直接拒绝，不部分写入。

提醒（每窗口一次）¶

当已用上下文接近压缩阈值（距阈值不足 32,000 token）时，会向模型注入一条提醒，要求更新笔记本。提醒可忽略：模型不响应时压缩仍会照常发生，目的是减少细节丢失。

窗口滚动（零模型调用）¶

到达压缩阈值时，复用 DSH 内置压缩的保留策略，仅替换「总结」步骤：写入固定过渡文本 + 当前笔记全文，不调用模型。

原文回读 context_history¶

滚动只把被替换的历史移出模型可见范围，不删除（日志 append-only）。模型可按 seq 回读：

context_history                                 → 索引
context_history { from: 120, to: 200 }          → 指定区间
context_history { from: 0, to: 50, raw: true }  → 原文

安装与启用¶

插件以当前 dsh 进程权限运行；安装前建议在 GitHub 阅读源码与 MIT 许可证，并确认与本机 DSH 版本兼容（package.json 中 engines.dsh 为 >=0.2.0-rc.2 <0.2.1-0 || >=0.2.1-rc.2 <0.3.0-0）。

从 npm 安装（README 写明发布后预构建，无需本地构建）：

dsh plugin --profile <profile> add dsh-notes-context
dsh --profile <profile> --dump-config   # 确认两层都生效

从 GitHub 源码安装时，pnpm 可能要求允许本包运行构建脚本（prepack 生成 lib/）；按 pnpm 提示把 allowBuilds 写入 profile 的 pnpm-workspace.yaml 后重试：

dsh plugin --profile <profile> add github:sqzw-x/dsh-notes-context

组合安装会包含两行 patch：停用 compaction-basic 并挂载本包。

配置示例¶

常用字段如下；完整字段见 DSH 设置页，推导过程见仓库 docs/INTERNALS.md。

触发点取 min(目标, 窗口 − 输出预留 − 余量) 中较低的一道。提醒位置无单独配置项，由压缩阈值推导：lead = min(32000, max(8192, floor(压缩阈值 × 0.125)))；例如阈值 450,000 时提醒约在 418,000。多数配置改完立即生效；rolloverText、notebookSummaryMaxChars 与两个 static* 标记仅在写入边界时读取，下次滚动才生效。

- id: notes-context
  config:
    thresholdTokens: 450000
    keepRecentTokens: 20000

典型用法¶

长任务会话中，让模型在进展变化时用 context_notes 更新笔记本（整本替换），在需要核对旧对话时用 context_history 按区间或 raw: true 拉原文。接近阈值时会收到更新笔记的提醒；到达阈值后上下文会滚动，模型看到的是过渡说明 + 笔记全文 + 保留的近期消息，而不是 LLM 生成的摘要。

适用场景与限制¶

适合：希望压缩边界可预测、不想在边界多等一轮摘要模型，且愿意让「干活的模型」自己决定笔记里记什么；偶尔需要从 seq 回读被滚出窗口的原文。

需注意（README 限制节）：

• 笔记本质量由模型决定；插件不自动补写、不代为总结，未记入笔记的信息需从 context_history 回读。
• 每次写入笔记本都是一条留在上下文里的消息，频繁重写会增大上下文。
• 边界零模型调用不等于全程零开销；写笔记本身是一次工具调用，成本前移而非消除。
• DSH 自身部分压缩配置不可见、不可改，只能改配置文件并重启 dsh（原因见内部机制文档）。
• 受限工具集的会话（如子代理）若无法调用 context_notes，会退化为无笔记本的滚动。

结尾¶

dsh-notes-context 用模型维护的持久笔记本和可回读的 context_history，在 DSH 长会话里替代 LLM 摘要式压缩，并在窗口滚动边界避免额外模型调用。插件目录页：skillhub.cn/plugins/sqzw-x/dsh-notes-context；源码与文档：github.com/sqzw-x/dsh-notes-context。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」，可按需选用并自行审计插件行为。