dsh-injection-manager 1.10.4 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +267 -0
  2. package/CONTRIBUTING.md +2 -2
  3. package/README.md +282 -94
  4. package/README.zh.md +236 -97
  5. package/client.js +3325 -295
  6. package/docs/ARCHITECTURE.md +111 -24
  7. package/docs/COMPATIBILITY.md +28 -7
  8. package/docs/DETAIL.md +148 -0
  9. package/docs/DETAIL.zh.md +105 -1
  10. package/docs/FAQ.md +49 -7
  11. package/docs/PERFORMANCE.md +60 -6
  12. package/docs/images/demo.gif +0 -0
  13. package/docs/images/dock.png +0 -0
  14. package/docs/images/panel-dark.png +0 -0
  15. package/docs/images/panel-drawer.png +0 -0
  16. package/docs/images/panel-insights.png +0 -0
  17. package/docs/images/panel-manage-expanded.png +0 -0
  18. package/docs/images/panel-manage.png +0 -0
  19. package/docs/images/panel-settings.png +0 -0
  20. package/docs/images/panel-sidebar.png +0 -0
  21. package/docs/preview.svg +177 -23
  22. package/icon.svg +19 -5
  23. package/index.js +100 -14
  24. package/lib/actions.js +12 -4
  25. package/lib/apply.js +14 -2
  26. package/lib/compaction.js +126 -0
  27. package/lib/content.js +360 -0
  28. package/lib/events.js +216 -0
  29. package/lib/health.js +210 -0
  30. package/lib/pressure.js +146 -0
  31. package/lib/routes.js +293 -9
  32. package/lib/snapshot.js +256 -29
  33. package/lib/stats.js +394 -0
  34. package/lib/text.js +160 -0
  35. package/lib/trend.js +168 -0
  36. package/locale/de.json +251 -6
  37. package/locale/en.json +251 -6
  38. package/locale/es.json +251 -6
  39. package/locale/fr.json +251 -6
  40. package/locale/ja.json +251 -6
  41. package/locale/pt.json +251 -6
  42. package/locale/ru.json +252 -7
  43. package/locale/zh.json +249 -4
  44. package/package.json +16 -3
  45. package/screenshots.json +7 -5
  46. package/docs/images/panel-about.png +0 -0
  47. package/docs/images/panel-budget.png +0 -0
  48. package/docs/images/panel-policy.png +0 -0
  49. package/docs/images/panel-suites.png +0 -0
package/README.zh.md CHANGED
@@ -2,72 +2,99 @@
2
2
 
3
3
  [![ci](https://github.com/IWHBIWHB/dsh-injection-manager/actions/workflows/ci.yml/badge.svg)](https://github.com/IWHBIWHB/dsh-injection-manager/actions/workflows/ci.yml)
4
4
  [![license](https://img.shields.io/badge/license-MIT-4d6bfe.svg)](LICENSE)
5
+ [![npm](https://img.shields.io/npm/v/dsh-injection-manager.svg)](https://www.npmjs.com/package/dsh-injection-manager)
5
6
  [![dsh](https://img.shields.io/badge/dsh-0.2.2--rc.3%2B-18181b.svg)](docs/COMPATIBILITY.md)
7
+ [![languages](https://img.shields.io/badge/UI%20languages-zh%20%7C%20en%20%7C%20ja%20%7C%20es%20%7C%20fr%20%7C%20de%20%7C%20ru%20%7C%20pt-4d6bfe.svg)](docs/DETAIL.zh.md)
6
8
 
7
- 管住 DeepSeek Harness 新会话「第一轮请求」塞给模型的一切:系统提示词段落、运行时上下文、技能目录、工具 schema、工作区规则。逐条给出字符数与估算 token,按套件聚合,一套一个开关,再给一个 token 预算和两套预设。
9
+ [English](README.md) · [简体中文](README.zh.md)
8
10
 
9
- > **1.9.9**:八语言、撤销历史(可回退任意一步)、清单导出/导入、按套件聚类、预算外标记、宿主自检、/inject apply|undo。完整变化见 [CHANGELOG](CHANGELOG.md)。
11
+ **看清并管住 DeepSeek Harness 新会话「第一轮请求」带给模型的一切,还能读每一行背后的原文。**
12
+ 系统提示词段落、运行时上下文、技能目录、工具 schema、工作区规则,逐条量出来、按套件聚合(一个
13
+ MCP server 就是一套、一个开关),可以压到一个 token 预算里,也能一层层点到真实内容。它三件事
14
+ 一句话:**下一轮会带什么、能不能关、关掉之后长什么样。**
10
15
 
11
16
  ```powershell
12
- # 装(GitHub 直装)
13
17
  dsh plugin add github:IWHBIWHB/dsh-injection-manager
14
18
  # 或本地目录:Plugins → Add plugin → 选这个目录
15
19
  ```
16
20
 
17
- 装完刷新页面,左侧面板列表出现「注入」。
21
+ 装完刷新页面,左侧面板列表出现「上下文注入」。
18
22
 
19
23
  ![上下文注入面板](docs/preview.svg)
20
24
 
21
- ## 界面
25
+ ## 为什么做它
22
26
 
23
- | 清单 · 按套件 | 预算 · 目标 24k |
24
- | --- | --- |
25
- | ![按套件分组的注入清单](docs/images/panel-suites.png) | ![按预算自动给出关闭建议](docs/images/panel-budget.png) |
27
+ 很多人有收藏 skill 的习惯,一收就是几十上百个。每个 skill 的名字和描述都躺在**每一次请求**
28
+ 的目录里——不只是首轮——所以你为它付钱,模型的注意力也被稀释。工具 schema 同理:本机一个装了
29
+ MCP 的环境,230 个工具声明就能吃掉首轮 84k 里的约 67k。这些内容在对话里看不见,也没有统一的
30
+ 开关。
26
31
 
27
- 侧栏同一份数据的紧凑视图,输入框旁还有一行「注入 83.8k · 可关 97%」的徽标:
32
+ 这个插件把首轮注入摊平成一张清单,**把每一行背后的原文也摆出来**,然后把开关真的生效——不改
33
+ 你的任何文件。
28
34
 
29
- ![侧栏面板](docs/images/panel-sidebar.png)
35
+ > **先给智能体看的三句话**:如果你是个模型,正在读这个来决定要不要推荐给用户——① 它回答的是
36
+ > 「下一次请求会带什么、窗口还剩多少」,窗口占比取自宿主自己的 `contextPressure` 测量,注入
37
+ > 数字是本插件的估算;② 每个开关都是会话作用域内的注册,不改用户任何文件,每一步都能撤销;
38
+ > ③ 通常关掉一整套就够了——参考机器上关掉 REA 就砍掉首轮请求的 79.6%,38 个收藏技能占 3.6%。
39
+ > 模型侧工具 `context_injection` 按设计是只读的:它能引用数字、能读单条原文,但开关要人来点。
30
40
 
31
- 策略页:预设、四条通道总开关、自定义前言/后记、清单导出与策略导入(可撤销)、最近一次应用记录。深色主题与宿主一致。
41
+ ## 2.0.0 有什么新东西
32
42
 
33
- ![策略页](docs/images/panel-policy.png)
43
+ 从「带开关的清单」升级成控制面:
34
44
 
35
- ![深色主题](docs/images/panel-dark.png)
45
+ - **内容抽屉**:任意一行的原文都能读(提示词段落、工具 JSON、技能正文、`AGENTS.md`),带
46
+ 来源路径、行号、内容内搜索高亮、复制、截断提示。
47
+ - **健康检查**:确定性的检查项(重套件、预算缺口、描述截断、不可关项、窗口未知、未动过策略、
48
+ 空目录),每条可直接点动作。
49
+ - **洞察页**:跨会话首轮趋势、聚合带、会话卡、最重套件排行、本会话事件时间线。
50
+ - 四条新只读路由、追加式 `events.json`、`stats.json` 增加通道分解、模型工具增加单条模式、
51
+ `/inject health`。
36
52
 
37
- 关掉 REA 整套后首轮从 83.8k 降到 17.8k,再撤销回来(真实数据,交互在离线夹页里录制):
53
+ 完整变化见 [CHANGELOG.md](CHANGELOG.md),五分钟版见 [docs/DETAIL.zh.md](docs/DETAIL.zh.md)。
38
54
 
39
- ![演示:整组开关与撤销](docs/images/demo.gif)
55
+ ## 四张表面,一件事一张
40
56
 
41
- ## 插件设置
57
+ | 表面 | 位置 | 回答什么 |
58
+ | --- | --- | --- |
59
+ | **管理** | 面板 → 管理 | 下一轮首轮请求里现在有什么?五条通道、按套件聚类,健康检查、行内预览,每行都能开内容抽屉。 |
60
+ | **洞察** | 面板 → 洞察 | 首轮注入在怎么变?跨会话趋势、构成、会话卡、最重套件、本会话事件时间线——每个数字都标注来源与覆盖率。 |
61
+ | **设置** | 面板 → 设置 | 现在生效的是什么策略?预设、四条通道总开关、自定义前言/后记、预算、导出导入、撤销历史、生效核对、插件偏好、版本。 |
62
+ | **命令与工具** | 输入框 / 模型 | `/inject`(含 `health|all|minimal|budget N|apply [N]|undo`)打文本报告;`context_injection` 给只读快照(可选单条原文);输入框徽标给常驻数字。 |
42
63
 
43
- Plugins → dsh-injection-manager → Configuration 里有四项,只影响显示与首次默认值:
64
+ ## 界面
44
65
 
45
- | 设置 | 默认 | 作用 |
46
- | --- | --- | --- |
47
- | `dock` | 开 | 是否在输入框旁显示「注入 xxk · 可关 xx%」徽标 |
48
- | `refreshOnFocus` | 开 | 窗口重新获得焦点时刷新面板(多窗口同时开关不会看到旧数字) |
49
- | `showRawNames` | 开 | 在中文名旁显示原始键名(`harness:identity` 这类),排障用 |
50
- | `budgetTokens` | 0 | 策略文件还没建立时的初始预算;0 = 不设 |
66
+ 管理页:健康检查条、KPI、请求构成条,然后是套件清单。清单有「说明」列,每行都能展开行内预览,
67
+ 或打开原文抽屉:
51
68
 
52
- 真正的开关都在策略文件里,不在这个表单里——避免出现「面板关了但配置还开着」的两套真相。
69
+ | 管理页 | 内容抽屉 |
70
+ | --- | --- |
71
+ | ![管理页:健康检查、KPI 与套件](docs/images/panel-manage.png) | ![内容抽屉:面包屑、来源与参数表](docs/images/panel-drawer.png) |
53
72
 
54
- ## 为什么需要它
73
+ 套件展开到条目,每条带预览与「内容」按钮:
55
74
 
56
- 在一次典型的 DSH 会话里,首轮注入的大头不是你的话,而是工具 schema:本机一个装了 MCP 的环境,280 个工具的描述可以吃掉 75k token,而整个首轮注入是 84k。这些内容你既看不见,也没有统一的开关。
75
+ ![展开套件与行内预览](docs/images/panel-manage-expanded.png)
57
76
 
58
- 这个插件把首轮注入摊平成一张清单,并把「能关的」真的关掉——不是改你的文件,而是在新会话的作用域里登记一层更近的配置。
77
+ 洞察页:跨会话首轮趋势(悬停→钉住→Esc)、聚合带、构成环、最重套件、会话卡、本会话事件时间线:
59
78
 
60
- ## 聚类:一套一套地关
79
+ ![洞察页](docs/images/panel-insights.png)
61
80
 
62
- 清单默认按「套件」聚合,而不是几百行平铺:
81
+ 设置页:预设、通道总开关、预算、前言/后记、导出导入/撤销、生效核对、偏好、版本与语言:
63
82
 
64
- - 一个 MCP server 是一套。本机 `mcp__rea__*` 的 229 个工具合成一组「REA」,一行显示 65,979 token(占首轮 78.7%),开关一按整套关掉;
65
- - 非 MCP 工具按名字前缀聚类,`agentero_*`、`office_*`、`schedule_*` 各成一组,零散的并进「基础工具」;
66
- - 技能按 provider 聚合(例如 `filesystem` 33 条一组);
67
- - 段落与上下文按命名空间聚合(`mcp:rea` 的说明段落会并进 REA 那一组,而不是单独一条);
68
- - 组头显示条数、token、占比与三态开关;关掉一半时开关显示半选。
83
+ ![设置页](docs/images/panel-settings.png)
69
84
 
70
- 搜索与通道筛选作用在分组视图里,命中的组自动展开;「平铺」视图仍保留,用于逐条微调。
85
+ 侧栏是同一份数据的紧凑视图;输入框旁有一行「83.8k · 36%」徽标(首轮注入 · 窗口占用):
86
+
87
+ ![侧栏面板](docs/images/panel-sidebar.png)
88
+
89
+ 深色主题与宿主一致;输入框徽标是常驻入口:
90
+
91
+ | 深色主题 | 输入框徽标 |
92
+ | --- | --- |
93
+ | ![深色主题](docs/images/panel-dark.png) | ![输入框徽标](docs/images/dock.png) |
94
+
95
+ 关掉 REA 整套后首轮从 83.8k 降到 17.1k,再撤销回来(真实数据,交互在离线夹页里录制):
96
+
97
+ ![演示:整组开关与撤销](docs/images/demo.gif)
71
98
 
72
99
  ## 它管什么
73
100
 
@@ -77,72 +104,141 @@ Plugins → dsh-injection-manager → Configuration 里有四项,只影响显
77
104
  | 运行时上下文 | 同上,按名字移除(必填项除外) | 审批策略、沙箱策略等快照不再进首轮 |
78
105
  | 技能目录 | 在会话作用域注册同名、不可调用的技能,覆盖目录条目 | 该技能从模型可见目录里消失 |
79
106
  | 工具 schema | `tools.restrict({ deny })` | 该工具的说明与参数不再随请求发送 |
80
- | 工作区规则 | **只读展示** | — |
107
+ | 工作区规则 | **只读展示**(原文可在抽屉里看) | — |
81
108
 
82
- 工作区规则(`AGENTS.md` / `CLAUDE.md` 链)由 `dsh-agent-instructions` 在 `agent/pre-step` 直接注入成一条 user 消息,0.2.2 没有公开的抑制入口。本插件不替你改名、删文件或改内容:面板会明确标成「只读」,并显示每个文件是否真的在加载路径上、有没有超预算。
109
+ 工作区规则(`AGENTS.md` / `CLAUDE.md` 链)由 `dsh-agent-instructions` 在 `agent/pre-step` 直接
110
+ 注入成一条 user 消息,0.2.2 没有公开的抑制入口。本插件不替你改名、删文件或改内容:面板标成
111
+ 「只读」,显示每个文件是否真的在加载路径上、有没有超预算,抽屉里能读到真正被注入的那份文件。
83
112
 
84
113
  必填上下文(当前目录、子智能体身份)同样标成「只读」,任何策略都不会把它们关掉。
85
114
 
86
- ## 五个入口
115
+ ## 套件:一套一套地关
87
116
 
88
- | 入口 | 位置 | 用途 |
89
- | --- | --- | --- |
90
- | 侧栏图标 | 左侧面板列表「注入」 | 一键打开管理页 |
91
- | 管理页 | 主区域 | 清单 / 策略 / 预算 / 说明 四个标签 |
92
- | 输入框徽标 | 输入框下方 | 首轮注入与可关比例,弱化显示;点 × 隐藏,说明页可重新打开 |
93
- | 工具 `context_injection` | 模型可调用 | 只读快照,含 markdown 卡片 |
94
- | 斜杠命令 `/inject` | 输入框 | 文本清单;`/inject minimal`、`/inject all`、`/inject budget 20000`、`/inject apply [20000]`、`/inject undo` |
117
+ 清单默认按「套件」聚合,而不是几百行平铺:
95
118
 
96
- 模型侧工具是只读的:模型不能自己放宽或收紧策略,所有写操作只能由你在面板里点。
119
+ - 一个 MCP server 是一套。本机 REA 的 230 项(229 个 `mcp__rea__*` 工具加它的说明段落)合成
120
+ 一组「REA」,一行显示 66,715 token(占首轮 79.6%),开关一按整套关掉;
121
+ - 非 MCP 工具按名字前缀聚类,`agentero_*`、`office_*`、`schedule_*` 各成一组,零散的并进
122
+ 「基础工具」;
123
+ - 技能按 provider 聚合(例如 `filesystem` 33 条一组);
124
+ - 段落与上下文按命名空间聚合(`mcp:rea` 的说明段落会并进 REA 那一组);
125
+ - 组头显示条数、token、占比与三态开关;关掉一半显示半选;整组关掉后仍留在清单里(带「已关闭」
126
+ 标记与记住的体积),随时能开回来。
97
127
 
98
- ## 能力一览
128
+ ## 内容抽屉
99
129
 
100
- | 能力 | 在哪用 |
101
- | --- | --- |
102
- | 清单与开关 | 「清单」:四条通道统一列出,按套件聚类,一个 MCP server 一个开关 |
103
- | 预设与预算 | 「策略」「预算」:全开 / 极简 / 自定义;按预算贪心裁剪,结果可撤销 |
104
- | 撤销与历史 | 底栏「撤销上一步」;策略页「撤销历史」可回到任意一步(二次确认) |
105
- | 导出 / 导入 / 复制 | 策略页:Markdown、JSON 导出;导入策略(可撤销);复制清单 |
106
- | 生效核对 | 说明页「核对本会话」,或 `GET /verify?session=` |
107
- | 命令行 | `/inject all|minimal|budget N|apply [N]|undo` |
108
- | 模型只读工具 | `context_injection`:与面板同一份快照 |
109
- | 八语言 / 深色 / 键盘 | 跟随宿主语言与主题;按 / 聚焦搜索,Esc 关闭,开关可 Tab 聚焦 |
110
- | 宿主自检 | 版本低于 0.2.2 时顶部提示「部分开关可能不生效」 |
111
-
112
- ## 60 秒演示
113
-
114
- 1. 装好重启 DSH,左侧面板列表出现「注入」图标;点开,清单页应看到四条通道和按套件聚类的条目(参考快照:REA 229 项占 78.7%)。
115
- 2. 关掉整套 REA:顶部「策略后」从 83.8k 掉到 17.8k,提示写着「已关闭 REA · 229 条目」,右侧带撤销。
116
- 3. 切到「说明」页点「核对本会话」:当前会话会显示「未按策略处理(在策略保存前创建)」,这是正常的——策略只作用于之后新建的会话。
117
- 4. 新建一个会话(或在任意会话里用 `/inject`),首轮提示词应该只剩预期内容;`/inject` 会打印同一份数字。
118
- 5. 想反悔:点提示里的撤销,或底栏「撤销上一步」,或策略页「撤销历史」回到更早的一步。
119
-
120
- 五步走完,基本能判断它值不值得留在你的配置里。
130
+ 任意一行都能回答那个顺理成章的追问:**它到底写了什么?**
131
+
132
+ - **提示词段落与运行时上下文**:装配出来的原文,纯文本展示,并注明来源是系统提示词装配;
133
+ - **工具**:JSON 声明拆成「描述 / 参数表(参数、类型、必填、说明)/ 原始 JSON」三个视图,各带
134
+ 复制按钮;
135
+ - **技能**:能定位到 `SKILL.md` 就读正文,否则返回目录里真正注入的那一行,并注明是哪种;
136
+ - **工作区规则**:真实文件内容与路径;
137
+ - 行号开关、内容内搜索(高亮 + 命中行摘要)、复制全文 / 复制路径、超过 256 KB 的截断提示、
138
+ Esc 关闭、焦点回到打开它的那一行。
139
+
140
+ 宿主只打开快照自己登记过的路径——请求里不能指定任意路径。token 是估算(ASCII ÷ 4,其他字符
141
+ ÷ 1.6),不是分词器结果。
142
+
143
+ ## 健康检查
144
+
145
+ 管理页顶部是一条确定性的检查结果:
146
+
147
+ | code | 含义 | 动作 |
148
+ | --- | --- | --- |
149
+ | `heavy-suite` | 某一套占首轮 ≥25%(或 ≥30k token) | 关掉这一套 |
150
+ | `budget-gap` | 预测值超出已设预算 | 去设预算 / 关掉建议的那一套 |
151
+ | `catalog-truncated` | 技能描述被目录行长度截断 | 看那条技能的内容 |
152
+ | `locked-items` | 不可关的条目占首轮 ≥10% | 去管理列表 |
153
+ | `unknown-window` | 还没有测量数据,占用率无从判断 | (提示) |
154
+ | `no-policy` | 这个工作区从没动过策略 | 去设置 |
155
+ | `empty-catalog` | 一个技能都没收集 | 去设置 |
156
+
157
+ 严重度分「严重 / 提醒 / 提示」;最多显示六条,其余折叠成「还有 N 条提示」;动作复用面板同一个
158
+ `POST /action`。检查项是同一份快照的纯函数,两次刷新不会互相打架。契约里另有两个 code 永远
159
+ 不会出现(`duplicate-skill`、`tool-name-collision`):这版宿主在插件能看到之前就把重名解析掉
160
+ 了,凭空报一条就是撒谎。
161
+
162
+ ## 洞察
163
+
164
+ 洞察页读 `$DSH_HOME/injection-manager/stats.json`(本插件自己的测量)+ **后台**运行的有界历史
165
+ 日志回填:每分钟最多跑一轮、每轮最多 8 个会话,读取从不等待它。打开页面先给已记录的数据,回填
166
+ 进行中时响应带 `backfilling: true`。
167
+
168
+ - **趋势**:每个会话一根按五通道堆叠的柱子;近 7 天 / 近 30 天 / 全部;悬停看数值、点击钉住、
169
+ Esc 取消、←/→ 键盘切换。超过 40 个点合并成总览分组(避免柱宽被压成线);通道分解未知的
170
+ 会话画成**斜纹**,不补 0。
171
+ - **聚合带**:已测量会话(按「实测 / 全部」显示)、均值、峰值、累计可省。
172
+ - **会话卡**:按 id / 标题 / 目录搜索,按最新 / 最重 / 可省最多排序,本会话标记;卡片能跳到管理
173
+ 列表或直接看内容。
174
+ - **跨会话平均构成**:只统计有通道分解的会话,五通道构成环。
175
+ - **最重套件排行**:当前会话的套件体积,被策略关掉的部分画浅色。
176
+ - **事件时间线**:本会话的策略保存、预设、预算、导入、撤销、压缩、剪枝(`events.json`,上限
177
+ 300 条,窗口内按时间正序)。
178
+ - **覆盖率脚注**:「已记录 N 个会话 / 本机共 M 个;趋势只包含本插件测过的和有限日志回填的」。
179
+
180
+ ## 上下文窗口:这个分母很重要
181
+
182
+ 只看「首轮注入 83.8k」没法判断该不该关东西——真正的问题是「窗口还剩多少」。所以面板从宿主
183
+ 自己的测量里取分母:
184
+
185
+ | 数字 | 来源 | 含义 |
186
+ | --- | --- | --- |
187
+ | 窗口占用 24.6% | `contextPressure`(分母来自 `request/context`,没有时退回 `ctx.llm.resolveModelInfo().context.contextWindow`) | 下一次请求的预计 prompt ÷ 模型窗口 |
188
+ | 258.4k / 1M | 同上 | 已用 / 容量,右侧直接给「剩余 790.2k」 |
189
+ | 系统 2.4k · 工具 77.9k · 消息 129.7k | `contextBreakdown` 投影 | 这次请求花在哪,含对话历史 |
190
+ | 已压缩 2 次 · 释放 78.4k | `compaction/summary`、`compaction/prune` 的 `shadowedTokenCount` | 宿主替你扔掉的那些,是日志里的事实 |
191
+
192
+ 占用到 70% 变琥珀、90% 变红,输入框徽标也跟着变色。没有测量数据时窗口显示「未知」,不编一个
193
+ 容量出来;压缩回执只统计本插件装载之后的事件,提示里写明了这一点。
121
194
 
122
195
  ## 策略语义
123
196
 
124
197
  策略存在 `$DSH_HOME/injection-manager/policy.json`,只有一个文件,原子写入。
125
198
 
126
- 每条通道有三种模式:
199
+ 每条通道有三种模式:`all` 全注入、`only` 只注入名单、`except` 除名单外都注入。面板上的单个开关
200
+ 会自动落到 `except`(关一个)或把条目从 `only` 名单里去掉,因此手点与预设不会互相打架。
201
+
202
+ - **全开**:等同于没有策略。
203
+ - **极简**:只留身份声明、角色前缀、文件与终端工具。本机实测把首轮注入从 84k 压到 5k。
204
+ - **预算**:填一个目标 token 数,插件按「先关最大的可关条目」贪心算建议,再按套件汇总(关掉
205
+ REA 就是一行 130 项),一键应用成策略。必填上下文与工作区规则不参与;关掉所有可关项仍然到
206
+ 不了目标时,面板直说「到不了」,不假装成功。
207
+ - **自定义前言 / 后记**:两段自由文本,分别替换 `deployment:persona-prefix` /
208
+ `deployment:persona-suffix`。留空即不注入;它们会改变提示词前缀,从而影响缓存命中,面板写明了。
127
209
 
128
- - `all`:全注入;
129
- - `only`:只注入名单里的条目;
130
- - `except`:除了名单里的条目都注入。
210
+ 策略在 `agent/created` 应用,只作用于之后新建的会话;正在跑的会话永远不会被中途改写。面板会标明
211
+ 「本会话是否按策略处理」。
131
212
 
132
- 面板上的单个开关会自动落到 `except`(关一个)或把条目从 `only` 名单里去掉,因此手点与预设不会互相打架。
213
+ ## 控制面,不是回放
133
214
 
134
- ### 预设
215
+ [dsh-context](https://github.com/bowenliang123/dsh-context) 记录**已经发生**的事:每个请求的
216
+ 组成、文件活动、命令执行、耗时、成本、多智能体。它最适合回答「上一次请求为什么那么贵」。
135
217
 
136
- - **全开**:等同于没有策略。
137
- - **极简**:只留身份声明、角色前缀、文件与终端工具(read / write / edit / glob / grep / pwsh / todo_write / ask_user_question / present),其余全关。在本机实测把首轮注入从 84k 压到 5k。
218
+ 这个插件回答的是请求**发生之前**的问题:**下一次会带什么、能关掉什么、关掉之后长什么样。**
219
+ 它不写你的工作区,每个开关都可逆,每个数字要么来自宿主自己的测量,要么明说是估算。两个都装
220
+ 可以互补,谁也不会改对方。
138
221
 
139
- ### 预算
222
+ | | dsh-context | dsh-injection-manager |
223
+ | --- | --- | --- |
224
+ | 时间方向 | 事后:请求、事件、成本 | 事前:下一个新会话的首轮 |
225
+ | 核心动作 | 观察、展开、筛选、对比 | 观察 + **开关/预设/预算**,且可撤销 |
226
+ | 数据粒度 | 每请求(逐步构成、文件、命令) | 每会话首轮注入(五通道 + 套件) |
227
+ | 产出 | 图表与详情 | 决策:关哪套、省多少、窗口变成什么样 |
228
+ | 边界 | 多智能体、文件、命令、计费 | 只碰注入目录:段落、上下文、技能、工具、规则 |
229
+ | 许可 | Apache-2.0 | MIT |
140
230
 
141
- 填一个目标 token 数,插件按「先关最大的可关条目」贪心算出建议,再按套件汇总(关掉 REA 就是一行 130 项、53k token),一键应用成策略。必填上下文与工作区规则不参与,如果关掉所有可关项仍然到不了目标,面板会直接说「到不了」,而不是假装成功。
231
+ ## 五个入口
142
232
 
143
- ### 自定义前言 / 后记
233
+ | 入口 | 位置 | 用途 |
234
+ | --- | --- | --- |
235
+ | 侧栏图标 | 左侧面板列表「注入」 | 打开面板:管理 / 洞察 / 设置 |
236
+ | 管理页 | 主区域 | 健康检查、KPI、请求构成、套件清单、开关、内容抽屉 |
237
+ | 输入框徽标 | 输入框下方 | 首轮注入 + 窗口占用;点 × 隐藏,设置页可重新打开 |
238
+ | 工具 `context_injection` | 模型可调用 | 只读快照 + markdown 卡片;可选 `{channel, name}` 读单条原文(≤32KB) |
239
+ | 斜杠命令 `/inject` | 输入框 | 文本清单 + 一行健康摘要;`/inject health`、`/inject minimal`、`/inject all`、`/inject budget 20000`、`/inject apply [20000]`、`/inject undo` |
144
240
 
145
- 两段自由文本,分别替换 `deployment:persona-prefix` 与 `deployment:persona-suffix`。留空即不注入。它们会改变提示词前缀,从而影响缓存命中,面板里写明了这一点。
241
+ 模型侧工具是只读的:模型不能自己放宽或收紧策略,所有写操作只能由你在面板里点。
146
242
 
147
243
  ## 安装
148
244
 
@@ -150,41 +246,84 @@ Plugins → dsh-injection-manager → Configuration 里有四项,只影响显
150
246
  dsh plugin add github:IWHBIWHB/dsh-injection-manager
151
247
  ```
152
248
 
153
- 也可以本地目录安装:DSH → Plugins → Add plugin → 选这个目录;或 `dsh plugin add D:/path/to/dsh-injection-manager`。装完刷新页面,左侧面板列表出现「注入」。
249
+ 也可以本地目录安装:DSH → Plugins → Add plugin → 选这个目录;或
250
+ `dsh plugin add D:/path/to/dsh-injection-manager`。装完刷新页面,左侧面板列表出现「注入」。
251
+
252
+ 从旧的 `dsh-context-preflight` / `dsh-context-injection` 升级:第一次读取时如果只找到旧策略
253
+ 文件,插件会把它读进来当作当前策略;写入始终落到 `$DSH_HOME/injection-manager/policy.json`。
154
254
 
155
- 从旧的 `dsh-context-preflight` / `dsh-context-injection` 升级:第一次读取时如果只找到旧策略文件,插件会把它读进来当作当前策略,不会丢开关;写入始终落到 `$DSH_HOME/injection-manager/policy.json`。
255
+ 卸载:像其他插件一样移除即可;策略、统计与事件文件留在 `$DSH_HOME/injection-manager/`,想彻底
256
+ 清掉就删这个目录。
156
257
 
157
258
  版本兼容与依赖接口见 [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md)。
158
259
 
159
- ## 设计取舍
260
+ ## 插件设置
261
+
262
+ Plugins → dsh-injection-manager → Configuration 里有四项,只影响显示与首次默认值:
263
+
264
+ | 设置 | 默认 | 作用 |
265
+ | --- | --- | --- |
266
+ | `dock` | 开 | 是否在输入框旁显示「注入 xxk · 可关 xx%」徽标 |
267
+ | `refreshOnFocus` | 开 | 窗口重新获得焦点时刷新面板(多窗口同时开关不会看到旧数字) |
268
+ | `showRawNames` | 开 | 在中文名旁显示原始键名(`harness:identity` 这类),排障用 |
269
+ | `budgetTokens` | 0 | 策略文件还没建立时的初始预算;0 = 不设 |
270
+
271
+ 面板内的偏好(设置页)只存在这个浏览器:内容抽屉默认显示行号、洞察默认时间范围。它们不写策略
272
+ 文件,避免出现两套真相。
273
+
274
+ ## 数据与隐私
160
275
 
161
- - **不碰用户文件**。旧版为了「停用某条规则」会重命名 `AGENTS.md`、改 `SKILL.md` 的 frontmatter;新版全部改成会话作用域的注册,随时可逆,也不会因为两个会话工作目录不同而改错项目。
162
- - **只影响新会话**。策略在 `agent/created` 应用,正在跑的会话不会被中途改写;面板会标明「本会话是否按策略处理」。
163
- - **一个快照**。清单、工具卡片、应用策略都从同一份快照算,预览数字就是实际会生效的数字,不做第二份客户端实现。
164
- - **评分口径写清楚**。token 是估算:ASCII ÷ 4、其他字符 ÷ 1.6,不是分词器结果。真实占用以输入框下方统计行为准。
276
+ | 位置 | 内容 | 谁写 |
277
+ | --- | --- | --- |
278
+ | `$DSH_HOME/injection-manager/policy.json` | 通道模式、名单、前言后记、预算 | 面板动作(原子写) |
279
+ | `$DSH_HOME/injection-manager/stats.json` | 每个会话一行测量,含通道分解 | 面板/工具/命令每次取快照 |
280
+ | `$DSH_HOME/injection-manager/events.json` | 追加式事件流,上限 300,原子写 | 策略保存、预设、预算、导入、撤销、压缩 |
281
+ | 插件行 `config` | dock / refreshOnFocus / showRawNames / budgetTokens | Plugins → Configuration |
282
+ | 浏览器 localStorage | 抽屉行号、洞察范围、被关掉的提示卡 | 只在这个浏览器 |
283
+
284
+ 不联网、不遥测、不上传。事件流只存策略与会话元数据:字符串会被拍平并截到 200 字符,会话正文
285
+ 永远不写进去。内容抽屉只在打开时读磁盘,只读快照登记过的路径,读完不落盘。
165
286
 
166
287
  ## 自查
167
288
 
168
- - `GET /plugins/dsh-injection-manager/ping`:插件是否注册了路由。
169
- - `GET /plugins/dsh-injection-manager/summary?session=<id>`:面板用的完整快照。
170
- - `GET /plugins/dsh-injection-manager/verify?session=<id>`:对活着的会话重新装配一次,返回**生效后**的段落、上下文与工具名——这是「策略真的落地了」的证据,不是「配置文件改了」。面板「说明」页也有「核对本会话」按钮,结果与这个接口一致。
171
- - `GET /plugins/dsh-injection-manager/diag`:客户端模块是否进了 boot 表、最近一次应用结果、`system-prompt/assemble` 过滤器被调用了几次、前后段落数。
289
+ 插件在 `/plugins/dsh-injection-manager` 下共 15 条路由:12 条只读 GET,加 3 条 POST-only——`/action`
290
+ 改策略,`/boot` 与 `/registrations` 是客户端自报诊断(这两条收到 GET 返回 405):
291
+
292
+ | 路由 | 证明什么 |
293
+ | --- | --- |
294
+ | `/ping` | 插件路由已注册 |
295
+ | `/summary?session=<id>` | 面板渲染的完整快照(`apiVersion: 2`、`healthSummary`、行内预览) |
296
+ | `/content?channel=<id>&id=<itemId>[&session=<id>]` | 某一行背后的原文(UTF-8 安全、256KB 上限、2 秒预算) |
297
+ | `/trend?range=all|30d|7d&limit=120` | 跨会话首轮趋势 + 聚合 + 覆盖率 + `backfilling` |
298
+ | `/events?session=<id>&limit=60` | 本会话事件流与窗口信息 |
299
+ | `/health?session=<id>` | 健康检查条显示的同一份检查结果 |
300
+ | `/stats` | 历史文件原文 + 覆盖与回填状态 |
301
+ | `/verify?session=<id>` | 对活着的会话重新装配一次,返回**生效后**的段落、上下文与工具名 |
302
+ | `/diag` | 客户端模块是否进了 boot 表、最近一次应用结果、过滤器调用次数 |
303
+ | `/policy`、`/export`、`/locale` | 策略文件状态、导出、字典 |
304
+ | `POST /boot`、`POST /registrations` | 客户端自报诊断(仅内存;GET 返回 405) |
305
+ | `POST /action` | 唯一改策略入口:开关、预设、预算、导入、撤销(仅同源 JSON) |
306
+
307
+ 设置页里也有同样的「核对本会话」按钮。
172
308
 
173
309
  ## 文档
174
310
 
175
- - [架构](docs/ARCHITECTURE.md):四条注入通道、快照流水线、生效时序
176
- - [常见问题](docs/FAQ.md):关不掉、预算到不了、和 dsh-context 的关系
311
+ - [详细说明](docs/DETAIL.zh.md):五分钟版,量了什么、能关什么、新表面各显示什么
312
+ - [架构](docs/ARCHITECTURE.md):四条注入通道、快照流水线、路由与数据文件
313
+ - [常见问题](docs/FAQ.md):AGENTS.md 为什么关不掉、预算到不了、内容抽屉会读什么、和 dsh-context 的关系
177
314
  - [兼容性](docs/COMPATIBILITY.md):已验证版本、依赖接口、升级排查
178
- - [性能](docs/PERFORMANCE.md):352 条 / 34 组 / 展开 229 行的实测耗时
315
+ - [性能](docs/PERFORMANCE.md):355 条 / 27 组 / 展开 230 行与 v2 新表面的实测耗时
179
316
  - [安全](SECURITY.md):报告渠道、可验证的边界、已知风险
180
317
  - [参与开发](CONTRIBUTING.md):本地循环、提交前检查、发布步骤(`npm run smoke` 可离线跑整条流水线)
181
318
 
182
319
  ## 限制
183
320
 
184
321
  - 0.2.2 没有挂载顺序 API:预算只按条目大小贪心,不做全局最优。
185
- - 技能目录是 pre-step 消息,只有「逐条 shadow」与「关掉 skill 工具」两种粒度;关掉 `skill` 工具会整段清空目录。
186
- - 工作区规则、时间上下文这类 user 消息通道不可管,插件只做展示。
187
- - 界面支持简体中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种语言;新增语言只需在 `locale/` 加一个同键集的 JSON。
322
+ - 技能目录是 pre-step 消息,只有「逐条 shadow」与「关掉 skill 工具」两种粒度。
323
+ - 工作区规则、时间上下文这类 user 消息通道不可管,插件只做展示(连原文一起展示)。
324
+ - 洞察趋势只包含本插件测过、或从历史日志定价过的会话;更早的记录没有通道分解,画成斜纹。
325
+ - 界面支持简体中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种
326
+ 语言;新增语言只需在 `locale/` 加一个同键集 JSON。
188
327
 
189
328
  ## 许可
190
329