前言¶
在 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 倉庫。