前言¶
在 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。启用后,智能体与用户可以在每次生成前主动修剪、压缩并整理当前会话状态,而不是被动接受不断变长的原始历史。
核心功能¶
资料中明确列出的能力如下:
- 实时上下文同步: ongoing 会话上下文写入结构化 Markdown(
.dsh/clm/LIVE_CONTEXT.md)。 - 主动上下文裁剪:便于把冗长终端 dump、工具结果压成简短摘要笔记。
- 界面开关:聊天输入栏集成
[ CLM ON / CLM OFF ]切换,后台运行。 - Token 溢出防护:自动执行上下文预算(
budgetTokens: 64000,reserveTokens: 4096),降低突然撑爆上下文的风险。 - 按会话持久化:应用重载后仍记住各对话的启用/关闭状态。
安装与启用¶
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 仓库。