dsh-agent-context:DSH 會話上下文的注入、計量與剪枝

前言

長會話跑久了,上下文會越積越多:早期塞進去的資料一直佔着 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_candidatesprune_applyprune_guardprune_statsexpand
  • 聲明瞭四個注入點:commandstokenMetersessionProjectionstools

也就是說,這個插件不只是掛一個命令,而是同時註冊命令(commands)、接入 token 計量(tokenMeter)、參與會話投影(sessionProjections),並對外提供工具(tools)。運行形態上,插件聲明爲 runtime: host-onlyenvDeps 爲無(純邏輯 / 標準 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_candidatesprune_applyprune_guardprune_statsexpand,註冊在 tools 注入點下。

每個工具的具體入參和行爲,README 都沒有展開,使用前建議直接閱讀倉庫源碼。

適用場景與注意

適合誰:

  • 在 DSH 上跑長會話智能體、需要控制上下文體積的開發者;
  • 希望按需向會話注入上下文內容,而不是一次性把資料全塞進去的人;
  • 想把上下文的計量與剪枝收斂到一個插件裏統一維護的人。

注意幾點:

1、插件以當前 dsh 進程權限運行。安裝第三方插件前,務必檢查源碼與許可證,dsh-agent-context 採用 MIT 協議;
2、插件聲明 runtime: host-onlyenvDeps 爲無,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
羽毛球分组比赛记分
小程序二维码

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

小夜