dsh-agent-context: Injection, Metering, and Pruning of DSH Session Context

前言

长会话跑久了,上下文会越积越多:早期塞进去的资料一直占着 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
羽毛球分组比赛记分
小程序二维码

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

Xiaoye