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 倉庫。

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

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

小夜