前言¶
長會話跑久了,上下文會越積越多:早期塞進去的資料一直佔着 token,真正有用的信息反而被淹沒,想刪又不知道從哪裏下手。DSH(DeepSeek Harness)的理念是「一切皆插件」,上下文治理這件事同樣可以交給插件來做,而不是散落在各個 prompt 和腳本里。
下面介紹 dsh-agent-context,一個把上下文注入、用量計量和剪枝工具合併在一起的 DSH 插件。
這是什麼¶
dsh-agent-context 是 jonah791 維護的 DSH 插件,一句話定位:會話上下文的注入與管理。它在同一個插件裏提供三塊能力:/context 命令、ctx.contextMeter 服務,以及一組剪枝工具,其中剪枝部分合並自作者此前的 dsh-agent-context-pruner 插件。
License 爲 MIT,README 和 package.json 裏均有註明。
核心功能¶
README 列出的功能特性有兩條:
- 上下文注入:按需向會話請求注入上下文內容;
- 會話感知:與 agent 會話模型聯動。
在此基礎上,插件的生態公約聲明(plugin-ecosystem-convention)裏還能確認幾件事:
- 提供
/context命令; - 提供
ctx.contextMeter服務; - 提供五個剪枝工具:
prune_candidates、prune_apply、prune_guard、prune_stats、expand; - 聲明瞭四個注入點:
commands、tokenMeter、sessionProjections、tools。
也就是說,這個插件不只是掛一個命令,而是同時註冊命令(commands)、接入 token 計量(tokenMeter)、參與會話投影(sessionProjections),並對外提供工具(tools)。運行形態上,插件聲明爲 runtime: host-only,envDeps 爲無(純邏輯 / 標準 Node),沒有特殊的授權邊界。
安裝與啓用¶
README 沒有提供 dsh plugin add 這類一鍵安裝命令,安裝方式是手動把倉庫 clone 到你的 self-plugins 目錄,再用 pnpm 裝依賴並構建:
cd <你的 self-plugins 目錄>
git clone https://github.com/jonah791/dsh-agent-context.git
cd dsh-agent-context
pnpm install
pnpm build
先進入你的 self-plugins 目錄,clone 倉庫,然後 pnpm install 安裝依賴、pnpm build 完成構建。經過上面的步驟,插件就裝好了。
依賴方面,插件的 peerDependencies 覆蓋一組 @deepseek-ai 包:
@deepseek-ai/cordis
@deepseek-ai/dsh-agent
@deepseek-ai/dsh-commands
@deepseek-ai/dsh-session
@deepseek-ai/dsh-session-projection
@deepseek-ai/dsh-token-meter
@deepseek-ai/schemastery
@deepseek-ai/dsh-tools
兼容性聲明爲 cordis ^4.0.1 / dsh-tools ^0.1.0-rc.6。這些是 peer 依賴,具體版本由 DSH 宿主環境提供,插件本身不打包。
可用入口¶
截至抓取 README 時,倉庫沒有提供完整的用法示例。能確認的入口有三類:
1、/context 命令:在會話中調用,README 未展開其參數與行爲;
2、ctx.contextMeter 服務:掛載在 ctx 上,供代碼訪問的上下文計量服務;
3、五個剪枝工具:prune_candidates、prune_apply、prune_guard、prune_stats、expand,註冊在 tools 注入點下。
每個工具的具體入參和行爲,README 都沒有展開,使用前建議直接閱讀倉庫源碼。
適用場景與注意¶
適合誰:
- 在 DSH 上跑長會話智能體、需要控制上下文體積的開發者;
- 希望按需向會話注入上下文內容,而不是一次性把資料全塞進去的人;
- 想把上下文的計量與剪枝收斂到一個插件裏統一維護的人。
注意幾點:
1、插件以當前 dsh 進程權限運行。安裝第三方插件前,務必檢查源碼與許可證,dsh-agent-context 採用 MIT 協議;
2、插件聲明 runtime: host-only,envDeps 爲無,boundary 爲無特殊授權邊界;
3、安裝沒有一鍵命令,需要手動 clone 到 self-plugins 目錄並本地構建;
4、剪枝能力合併自 dsh-agent-context-pruner。如果你之前單獨裝過那個插件,留意其功能已併入本插件;
5、兼容性以聲明爲準:cordis ^4.0.1 / dsh-tools ^0.1.0-rc.6。
小結¶
dsh-agent-context 把 /context 命令、ctx.contextMeter 服務和五個剪枝工具收進一個插件,覆蓋上下文的注入、計量與剪枝三件事,適合在 DSH 上維護長會話的開發者。安裝是手動 clone 加本地構建,動手前記得檢查源碼與許可證。
- 社區目錄頁:https://www.skillhub.cn/plugins/jonah791/dsh-agent-context (社區維護的獨立目錄站點,與 DeepSeek / 幻方無官方從屬關係)
- GitHub 倉庫:https://github.com/jonah791/dsh-agent-context