dsh-plugin-clm:把 DSH 上下文窗口镜像到磁盘并可编辑

前言

在 DeepSeek Harness(DSH)里做长对话或工具密集任务时,上下文往往只增不减:终端输出、检索结果、调试片段会堆进同一条 append-only 历史,token 很快膨胀,后续推理质量也会受影响。常见做法是手动清会话或换话题,但很难在「保留决策与结论」和「删掉噪声」之间精细控制。

下面介绍社区插件 dsh-plugin-clm(Context Language Models for DeepSeek Harness)。它在 DSH 侧把活跃会话上下文同步到本地 Markdown 镜像,并在生成前支持裁剪与压缩,思路受 Meta CLM 与 pi-clm 启发。维护者为 GitHub 用户 maxeone(Maximiliano Roldán),在 SkillHub 目录中归类为「模型推理」;仓库 maxeone/dsh-plugin-clm 采用 MIT 许可证。

这是什么

dsh-plugin-clm 将 DSH 默认的「整块、只追加」上下文,改成活跃、可编辑、与磁盘同步的上下文文档,默认路径为 .dsh/clm/LIVE_CONTEXT.md。启用后,智能体与用户可以在每次生成前主动修剪、压缩并整理当前会话状态,而不是被动接受不断变长的原始历史。

核心功能

资料中明确列出的能力如下:

  1. 实时上下文同步: ongoing 会话上下文写入结构化 Markdown(.dsh/clm/LIVE_CONTEXT.md)。
  2. 主动上下文裁剪:便于把冗长终端 dump、工具结果压成简短摘要笔记。
  3. 界面开关:聊天输入栏集成 [ CLM ON / CLM OFF ] 切换,后台运行。
  4. Token 溢出防护:自动执行上下文预算(budgetTokens: 64000,reserveTokens: 4096),降低突然撑爆上下文的风险。
  5. 按会话持久化:应用重载后仍记住各对话的启用/关闭状态。

安装与启用

DSH 生态采用「一切皆插件」;SkillHub(插件目录页)是社区独立站点,与 DeepSeek / 幻方无官方从属关系。安装前请自行查看仓库源码与 MIT 许可证;插件在当前 dsh 进程权限下运行,镜像文件会写在工作区相关路径下。

方式一:编辑桌面 profile 的 package.json

路径:~/.dsh/profiles/desktop/package.json。在 dependencies 与 dsh.profile.bundles 中加入插件(README 示例版本为 ^1.0.2):

{
  "dependencies": {
    "dsh-plugin-clm": "^1.0.2"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "dsh-plugin-clm"
      ]
    }
  }
}

方式二:CLI

dsh plugin add dsh-plugin-clm

完成依赖与 bundle 配置后,按你平时的 DSH 启动方式加载 profile 即可。

典型用法

斜杠命令

命令 说明
/clm on 为当前会话启用可编辑上下文镜像
/clm off 关闭 CLM,回退为标准只追加上下文
/clm status 显示估算 context tokens、修订次数与镜像文件路径
/clm reset 清空并为本会话重新生成干净的镜像状态

也可在输入栏用 CLM 开关按钮切换,无需记命令。

镜像文档结构

.dsh/clm/LIVE_CONTEXT.md 中除自由笔记块 [[CTX_NOTES]] 外,还会按轮次记录 [[CTX_TURN ...]] 片段。README 中的结构示例如下:

# CONTEXT LANGUAGE MODEL (CLM) - ACTIVE MIRROR

[[CTX_NOTES]]
- Objective: Refactor authentication architecture.
- Decisions: Retain JWT tokens in protected in-memory store.

[[CTX_TURN document=sess-1 index=1 role=user]]
Check the server logs for recent authentication errors.

[[CTX_TURN document=sess-1 index=2 role=assistant]]
Examining logs:
[Tool output summarized to the 3 relevant failure entries]

实际文件名与块内容随会话变化;/clm status 可核对路径与 token 估算。

适用场景与注意

适合:长链路调试、大量工具输出、需要在多轮中保留「目标 / 决策」又希望删掉陈旧 dump 的 DSH 用户。

注意:

  • 镜像与裁剪逻辑以插件实现为准,升级前可看 GitHub Releases / package.json 版本。
  • 不要假设 CLM 会替你做业务级审计;敏感信息仍可能进入镜像文件,工作区权限与 .gitignore 需自行处理。
  • 关闭 CLM(/clm off 或 UI)后行为回到 DSH 默认 append-only 上下文。

结尾

dsh-plugin-clm 把 DSH 会话上下文落到可编辑的 .dsh/clm/LIVE_CONTEXT.md,配合预算 guard 与 per-session 开关,面向 token 优化与主动整理上下文。进一步了解可访问 SkillHub 目录页 与 GitHub 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜