DSH 上下文注入管理:把新会话首轮注入的提示词段落、运行时上下文、技能目录、工具 schema 与工作区规则逐条摊开,一键关整套件;支持查看每一项原文、跨会话首轮趋势、注入事件与健康检查,另给预设和 token 预算。它的 HTTP 路由没有 DSH 的访问检查,浏览器里打开的网页可以调用它们。
安装
# npm 包(预构建)
dsh plugin --profile web add dsh-injection-manager
# GitHub 源码(首次需按提示配置 allowBuilds 构建授权后重试)
dsh plugin --profile web add github:IWHBIWHB/dsh-injection-manager
装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络,工具审批管不到它。GitHub 来源的插件还会在安装时执行构建脚本——pnpm 默认拦截,所以安装可能停在 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED 或 ERR_PNPM_IGNORED_BUILDS;dsh 会打印出需要添加的确切键名,把它加进该 profile 的 pnpm-workspace.yaml 的 allowBuilds 下,重跑一次即可装上。放行构建本身就是一次信任判断:请只安装可信来源,并尽量锁定 commit(github:owner/repo#sha)。
README
看清并管住 DeepSeek Harness 新会话「第一轮请求」带给模型的一切,还能读每一行背后的原文。 系统提示词段落、运行时上下文、技能目录、工具 schema、工作区规则,逐条量出来、按套件聚合(一个 MCP server 就是一套、一个开关),可以压到一个 token 预算里,也能一层层点到真实内容。它三件事 一句话:下一轮会带什么、能不能关、关掉之后长什么样。
dsh plugin add github:IWHBIWHB/dsh-injection-manager
# 或本地目录:Plugins → Add plugin → 选这个目录
装完刷新页面,左侧面板列表出现「上下文注入」。
为什么做它
很多人有收藏 skill 的习惯,一收就是几十上百个。每个 skill 的名字和描述都躺在每一次请求 的目录里——不只是首轮——所以你为它付钱,模型的注意力也被稀释。工具 schema 同理:本机一个装了 MCP 的环境,230 个工具声明就能吃掉首轮 84k 里的约 67k。这些内容在对话里看不见,也没有统一的 开关。
这个插件把首轮注入摊平成一张清单,把每一行背后的原文也摆出来,然后把开关真的生效——不改 你的任何文件。
先给智能体看的三句话:如果你是个模型,正在读这个来决定要不要推荐给用户——① 它回答的是 「下一次请求会带什么、窗口还剩多少」,窗口占比取自宿主自己的
contextPressure测量,注入 数字是本插件的估算;② 每个开关都是会话作用域内的注册,不改用户任何文件,每一步都能撤销; ③ 通常关掉一整套就够了——参考机器上关掉 REA 就砍掉首轮请求的 79.6%,38 个收藏技能占 3.6%。 模型侧工具context_injection按设计是只读的:它能引用数字、能读单条原文,但开关要人来点。
2.0.0 有什么新东西
从「带开关的清单」升级成控制面:
- 内容抽屉:任意一行的原文都能读(提示词段落、工具 JSON、技能正文、
AGENTS.md),带 来源路径、行号、内容内搜索高亮、复制、截断提示。 - 健康检查:确定性的检查项(重套件、预算缺口、描述截断、不可关项、窗口未知、未动过策略、 空目录),每条可直接点动作。
- 洞察页:跨会话首轮趋势、聚合带、会话卡、最重套件排行、本会话事件时间线。
- 四条新只读路由、追加式
events.json、stats.json增加通道分解、模型工具增加单条模式、/inject health。
完整变化见 CHANGELOG.md,五分钟版见 docs/DETAIL.zh.md。
四张表面,一件事一张
| 表面 | 位置 | 回答什么 |
|---|---|---|
| 管理 | 面板 → 管理 | 下一轮首轮请求里现在有什么?五条通道、按套件聚类,健康检查、行内预览,每行都能开内容抽屉。 |
| 洞察 | 面板 → 洞察 | 首轮注入在怎么变?跨会话趋势、构成、会话卡、最重套件、本会话事件时间线——每个数字都标注来源与覆盖率。 |
| 设置 | 面板 → 设置 | 现在生效的是什么策略?预设、四条通道总开关、自定义前言/后记、预算、导出导入、撤销历史、生效核对、插件偏好、版本。 |
| 命令与工具 | 输入框 / 模型 | /inject(含 health|all|minimal|budget N|apply [N]|undo)打文本报告;context_injection 给只读快照(可选单条原文);输入框徽标给常驻数字。 |
界面
管理页:健康检查条、KPI、请求构成条,然后是套件清单。清单有「说明」列,每行都能展开行内预览, 或打开原文抽屉:
| 管理页 | 内容抽屉 |
|---|---|
![]() |
![]() |
套件展开到条目,每条带预览与「内容」按钮:

洞察页:跨会话首轮趋势(悬停→钉住→Esc)、聚合带、构成环、最重套件、会话卡、本会话事件时间线:

设置页:预设、通道总开关、预算、前言/后记、导出导入/撤销、生效核对、偏好、版本与语言:

侧栏是同一份数据的紧凑视图;输入框旁有一行「83.8k · 36%」徽标(首轮注入 · 窗口占用):

深色主题与宿主一致;输入框徽标是常驻入口:
| 深色主题 | 输入框徽标 |
|---|---|
![]() |
![]() |
关掉 REA 整套后首轮从 83.8k 降到 17.1k,再撤销回来(真实数据,交互在离线夹页里录制):

它管什么
| 通道 | 怎么管 | 关掉后 |
|---|---|---|
| 系统提示词段落 | 会话作用域的 system-prompt/assemble 过滤器按名字移除 |
该段文字不再出现在系统提示词里 |
| 运行时上下文 | 同上,按名字移除(必填项除外) | 审批策略、沙箱策略等快照不再进首轮 |
| 技能目录 | 在会话作用域注册同名、不可调用的技能,覆盖目录条目 | 该技能从模型可见目录里消失 |
| 工具 schema | tools.restrict({ deny }) |
该工具的说明与参数不再随请求发送 |
| 工作区规则 | 只读展示(原文可在抽屉里看) | — |
工作区规则(AGENTS.md / CLAUDE.md 链)由 dsh-agent-instructions 在 agent/pre-step 直接
注入成一条 user 消息,0.2.2 没有公开的抑制入口。本插件不替你改名、删文件或改内容:面板标成
「只读」,显示每个文件是否真的在加载路径上、有没有超预算,抽屉里能读到真正被注入的那份文件。
必填上下文(当前目录、子智能体身份)同样标成「只读」,任何策略都不会把它们关掉。
套件:一套一套地关
清单默认按「套件」聚合,而不是几百行平铺:
- 一个 MCP server 是一套。本机 REA 的 230 项(229 个
mcp__rea__*工具加它的说明段落)合成 一组「REA」,一行显示 66,715 token(占首轮 79.6%),开关一按整套关掉; - 非 MCP 工具按名字前缀聚类,
agentero_*、office_*、schedule_*各成一组,零散的并进 「基础工具」; - 技能按 provider 聚合(例如
filesystem33 条一组); - 段落与上下文按命名空间聚合(
mcp:rea的说明段落会并进 REA 那一组); - 组头显示条数、token、占比与三态开关;关掉一半显示半选;整组关掉后仍留在清单里(带「已关闭」 标记与记住的体积),随时能开回来。
内容抽屉
任意一行都能回答那个顺理成章的追问:它到底写了什么?
- 提示词段落与运行时上下文:装配出来的原文,纯文本展示,并注明来源是系统提示词装配;
- 工具:JSON 声明拆成「描述 / 参数表(参数、类型、必填、说明)/ 原始 JSON」三个视图,各带 复制按钮;
- 技能:能定位到
SKILL.md就读正文,否则返回目录里真正注入的那一行,并注明是哪种; - 工作区规则:真实文件内容与路径;
- 行号开关、内容内搜索(高亮 + 命中行摘要)、复制全文 / 复制路径、超过 256 KB 的截断提示、 Esc 关闭、焦点回到打开它的那一行。
宿主只打开快照自己登记过的路径——请求里不能指定任意路径。token 是估算(ASCII ÷ 4,其他字符 ÷ 1.6),不是分词器结果。
健康检查
管理页顶部是一条确定性的检查结果:
| code | 含义 | 动作 |
|---|---|---|
heavy-suite |
某一套占首轮 ≥25%(或 ≥30k token) | 关掉这一套 |
budget-gap |
预测值超出已设预算 | 去设预算 / 关掉建议的那一套 |
catalog-truncated |
技能描述被目录行长度截断 | 看那条技能的内容 |
locked-items |
不可关的条目占首轮 ≥10% | 去管理列表 |
unknown-window |
还没有测量数据,占用率无从判断 | (提示) |
no-policy |
这个工作区从没动过策略 | 去设置 |
empty-catalog |
一个技能都没收集 | 去设置 |
严重度分「严重 / 提醒 / 提示」;最多显示六条,其余折叠成「还有 N 条提示」;动作复用面板同一个
POST /action。检查项是同一份快照的纯函数,两次刷新不会互相打架。契约里另有两个 code 永远
不会出现(duplicate-skill、tool-name-collision):这版宿主在插件能看到之前就把重名解析掉
了,凭空报一条就是撒谎。
洞察
洞察页读 $DSH_HOME/injection-manager/stats.json(本插件自己的测量)+ 后台运行的有界历史
日志回填:每分钟最多跑一轮、每轮最多 8 个会话,读取从不等待它。打开页面先给已记录的数据,回填
进行中时响应带 backfilling: true。
- 趋势:每个会话一根按五通道堆叠的柱子;近 7 天 / 近 30 天 / 全部;悬停看数值、点击钉住、 Esc 取消、←/→ 键盘切换。超过 40 个点合并成总览分组(避免柱宽被压成线);通道分解未知的 会话画成斜纹,不补 0。
- 聚合带:已测量会话(按「实测 / 全部」显示)、均值、峰值、累计可省。
- 会话卡:按 id / 标题 / 目录搜索,按最新 / 最重 / 可省最多排序,本会话标记;卡片能跳到管理 列表或直接看内容。
- 跨会话平均构成:只统计有通道分解的会话,五通道构成环。
- 最重套件排行:当前会话的套件体积,被策略关掉的部分画浅色。
- 事件时间线:本会话的策略保存、预设、预算、导入、撤销、压缩、剪枝(
events.json,上限 300 条,窗口内按时间正序)。 - 覆盖率脚注:「已记录 N 个会话 / 本机共 M 个;趋势只包含本插件测过的和有限日志回填的」。
上下文窗口:这个分母很重要
只看「首轮注入 83.8k」没法判断该不该关东西——真正的问题是「窗口还剩多少」。所以面板从宿主 自己的测量里取分母:
| 数字 | 来源 | 含义 |
|---|---|---|
| 窗口占用 24.6% | contextPressure(分母来自 request/context,没有时退回 ctx.llm.resolveModelInfo().context.contextWindow) |
下一次请求的预计 prompt ÷ 模型窗口 |
| 258.4k / 1M | 同上 | 已用 / 容量,右侧直接给「剩余 790.2k」 |
| 系统 2.4k · 工具 77.9k · 消息 129.7k | contextBreakdown 投影 |
这次请求花在哪,含对话历史 |
| 已压缩 2 次 · 释放 78.4k | compaction/summary、compaction/prune 的 shadowedTokenCount |
宿主替你扔掉的那些,是日志里的事实 |
占用到 70% 变琥珀、90% 变红,输入框徽标也跟着变色。没有测量数据时窗口显示「未知」,不编一个 容量出来;压缩回执只统计本插件装载之后的事件,提示里写明了这一点。
策略语义
策略存在 $DSH_HOME/injection-manager/policy.json,只有一个文件,原子写入。
每条通道有三种模式:all 全注入、only 只注入名单、except 除名单外都注入。面板上的单个开关
会自动落到 except(关一个)或把条目从 only 名单里去掉,因此手点与预设不会互相打架。
- 全开:等同于没有策略。
- 极简:只留身份声明、角色前缀、文件与终端工具。本机实测把首轮注入从 84k 压到 5k。
- 预算:填一个目标 token 数,插件按「先关最大的可关条目」贪心算建议,再按套件汇总(关掉 REA 就是一行 130 项),一键应用成策略。必填上下文与工作区规则不参与;关掉所有可关项仍然到 不了目标时,面板直说「到不了」,不假装成功。
- 自定义前言 / 后记:两段自由文本,分别替换
deployment:persona-prefix/deployment:persona-suffix。留空即不注入;它们会改变提示词前缀,从而影响缓存命中,面板写明了。
策略在 agent/created 应用,只作用于之后新建的会话;正在跑的会话永远不会被中途改写。面板会标明
「本会话是否按策略处理」。
控制面,不是回放
dsh-context 记录已经发生的事:每个请求的 组成、文件活动、命令执行、耗时、成本、多智能体。它最适合回答「上一次请求为什么那么贵」。
这个插件回答的是请求发生之前的问题:下一次会带什么、能关掉什么、关掉之后长什么样。 它不写你的工作区,每个开关都可逆,每个数字要么来自宿主自己的测量,要么明说是估算。两个都装 可以互补,谁也不会改对方。
| dsh-context | dsh-injection-manager | |
|---|---|---|
| 时间方向 | 事后:请求、事件、成本 | 事前:下一个新会话的首轮 |
| 核心动作 | 观察、展开、筛选、对比 | 观察 + 开关/预设/预算,且可撤销 |
| 数据粒度 | 每请求(逐步构成、文件、命令) | 每会话首轮注入(五通道 + 套件) |
| 产出 | 图表与详情 | 决策:关哪套、省多少、窗口变成什么样 |
| 边界 | 多智能体、文件、命令、计费 | 只碰注入目录:段落、上下文、技能、工具、规则 |
| 许可 | Apache-2.0 | MIT |
五个入口
| 入口 | 位置 | 用途 |
|---|---|---|
| 侧栏图标 | 左侧面板列表「注入」 | 打开面板:管理 / 洞察 / 设置 |
| 管理页 | 主区域 | 健康检查、KPI、请求构成、套件清单、开关、内容抽屉 |
| 输入框徽标 | 输入框下方 | 首轮注入 + 窗口占用;点 × 隐藏,设置页可重新打开 |
工具 context_injection |
模型可调用 | 只读快照 + markdown 卡片;可选 {channel, name} 读单条原文(≤32KB) |
斜杠命令 /inject |
输入框 | 文本清单 + 一行健康摘要;/inject health、/inject minimal、/inject all、/inject budget 20000、/inject apply [20000]、/inject undo |
模型侧工具是只读的:模型不能自己放宽或收紧策略,所有写操作只能由你在面板里点。
安装
dsh plugin add github:IWHBIWHB/dsh-injection-manager
也可以本地目录安装:DSH → Plugins → Add plugin → 选这个目录;或
dsh plugin add D:/path/to/dsh-injection-manager。装完刷新页面,左侧面板列表出现「注入」。
从旧的 dsh-context-preflight / dsh-context-injection 升级:第一次读取时如果只找到旧策略
文件,插件会把它读进来当作当前策略;写入始终落到 $DSH_HOME/injection-manager/policy.json。
卸载:像其他插件一样移除即可;策略、统计与事件文件留在 $DSH_HOME/injection-manager/,想彻底
清掉就删这个目录。
版本兼容与依赖接口见 docs/COMPATIBILITY.md。
插件设置
Plugins → dsh-injection-manager → Configuration 里有四项,只影响显示与首次默认值:
| 设置 | 默认 | 作用 |
|---|---|---|
dock |
开 | 是否在输入框旁显示「注入 xxk · 可关 xx%」徽标 |
refreshOnFocus |
开 | 窗口重新获得焦点时刷新面板(多窗口同时开关不会看到旧数字) |
showRawNames |
开 | 在中文名旁显示原始键名(harness:identity 这类),排障用 |
budgetTokens |
0 | 策略文件还没建立时的初始预算;0 = 不设 |
面板内的偏好(设置页)只存在这个浏览器:内容抽屉默认显示行号、洞察默认时间范围。它们不写策略 文件,避免出现两套真相。
数据与隐私
| 位置 | 内容 | 谁写 |
|---|---|---|
$DSH_HOME/injection-manager/policy.json |
通道模式、名单、前言后记、预算 | 面板动作(原子写) |
$DSH_HOME/injection-manager/stats.json |
每个会话一行测量,含通道分解 | 面板/工具/命令每次取快照 |
$DSH_HOME/injection-manager/events.json |
追加式事件流,上限 300,原子写 | 策略保存、预设、预算、导入、撤销、压缩 |
插件行 config |
dock / refreshOnFocus / showRawNames / budgetTokens | Plugins → Configuration |
| 浏览器 localStorage | 抽屉行号、洞察范围、被关掉的提示卡 | 只在这个浏览器 |
不联网、不遥测、不上传。事件流只存策略与会话元数据:字符串会被拍平并截到 200 字符,会话正文 永远不写进去。内容抽屉只在打开时读磁盘,只读快照登记过的路径,读完不落盘。
自查
插件在 /plugins/dsh-injection-manager 下共 15 条路由:12 条只读 GET,加 3 条 POST-only——/action
改策略,/boot 与 /registrations 是客户端自报诊断(这两条收到 GET 返回 405):
| 路由 | 证明什么 |
|---|---|
/ping |
插件路由已注册 |
/summary?session=<id> |
面板渲染的完整快照(apiVersion: 2、healthSummary、行内预览) |
/content?channel=<id>&id=<itemId>[&session=<id>] |
某一行背后的原文(UTF-8 安全、256KB 上限、2 秒预算) |
/trend?range=all|30d|7d&limit=120 |
跨会话首轮趋势 + 聚合 + 覆盖率 + backfilling |
/events?session=<id>&limit=60 |
本会话事件流与窗口信息 |
/health?session=<id> |
健康检查条显示的同一份检查结果 |
/stats |
历史文件原文 + 覆盖与回填状态 |
/verify?session=<id> |
对活着的会话重新装配一次,返回生效后的段落、上下文与工具名 |
/diag |
客户端模块是否进了 boot 表、最近一次应用结果、过滤器调用次数 |
/policy、/export、/locale |
策略文件状态、导出、字典 |
POST /boot、POST /registrations |
客户端自报诊断(仅内存;GET 返回 405) |
POST /action |
唯一改策略入口:开关、预设、预算、导入、撤销(仅同源 JSON) |
设置页里也有同样的「核对本会话」按钮。
文档
- 详细说明:五分钟版,量了什么、能关什么、新表面各显示什么
- 架构:四条注入通道、快照流水线、路由与数据文件
- 常见问题:AGENTS.md 为什么关不掉、预算到不了、内容抽屉会读什么、和 dsh-context 的关系
- 兼容性:已验证版本、依赖接口、升级排查
- 性能:355 条 / 27 组 / 展开 230 行与 v2 新表面的实测耗时
- 安全:报告渠道、可验证的边界、已知风险
- 参与开发:本地循环、提交前检查、发布步骤(
npm run smoke可离线跑整条流水线)
限制
- 0.2.2 没有挂载顺序 API:预算只按条目大小贪心,不做全局最优。
- 技能目录是 pre-step 消息,只有「逐条 shadow」与「关掉 skill 工具」两种粒度。
- 工作区规则、时间上下文这类 user 消息通道不可管,插件只做展示(连原文一起展示)。
- 洞察趋势只包含本插件测过、或从历史日志定价过的会话;更早的记录没有通道分解,画成斜纹。
- 界面支持简体中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种
语言;新增语言只需在
locale/加一个同键集 JSON。
许可
MIT
链接
同类插件
bowenliang123/dsh-context★ 5191
DSH 上下文洞察面板:Context 仪表盘 + /context命令 + Context 浏览器,查看 Context的分类组成、内容详情、演进趋势、压缩/注入事件、统计等一站式 Context 全生命周期管理。
Han-1413141/dsh-cost-meter★ 705
会话与当日 API 费用统计、预算图框(已用%)、官方余额、历史看板,支持峰谷计价与官方价格一键同步。
wssfk12138/dsh-damage-pulse★ 290
在 DSH Web 界面追踪 DeepSeek Token 用量、单次与会话费用及账户余额,并显示缓存感知的扣费动画。
zh667/TokenLedger★ 205
侧边栏用量面板:把 Token 归属到实际服务该请求的中转站,站点从已有的 provider 配置中读出,无需额外配置;含今日/本月/累计三窗口、按站点与模型下钻、一年活跃度热力图,以及 New API / Sub2API / DeepSeek 余额。
Ychris12138/dsh-usage-stats★ 190
多供应商用量看板:按供应商/模型统计 Token 与日期下钻,统一展示账户余额,并追踪 OpenCode Go / Z.ai 订阅额度。
Mt-Youya/dsh-plugins#sessions-insight★ 166
按工作目录浏览 Claude Code、DSH 和 Codex 会话日志,查看每轮上下文构成、token 用量、压缩点和费用估算。




社区评论
评论公开保存在 GitHub Discussions。加载评论会连接 GitHub 和 Giscus;发表内容需要 GitHub 账号。