dsh-injection-manager 0.0.0-stage → 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.
- package/CHANGELOG.md +642 -0
- package/CONTRIBUTING.md +49 -0
- package/LICENSE +21 -0
- package/README.md +371 -2
- package/README.zh.md +330 -0
- package/SECURITY.md +35 -0
- package/client.js +4928 -0
- package/cordis.patch.yml +4 -0
- package/docs/ARCHITECTURE.md +195 -0
- package/docs/COMPATIBILITY.md +60 -0
- package/docs/DETAIL.de.md +1 -0
- package/docs/DETAIL.es.md +1 -0
- package/docs/DETAIL.fr.md +1 -0
- package/docs/DETAIL.ja.md +1 -0
- package/docs/DETAIL.md +149 -0
- package/docs/DETAIL.pt.md +1 -0
- package/docs/DETAIL.ru.md +1 -0
- package/docs/DETAIL.zh.md +105 -0
- package/docs/FAQ.md +96 -0
- package/docs/PERFORMANCE.md +73 -0
- package/docs/images/demo.gif +0 -0
- package/docs/images/dock.png +0 -0
- package/docs/images/panel-dark.png +0 -0
- package/docs/images/panel-drawer.png +0 -0
- package/docs/images/panel-insights.png +0 -0
- package/docs/images/panel-manage-expanded.png +0 -0
- package/docs/images/panel-manage.png +0 -0
- package/docs/images/panel-settings.png +0 -0
- package/docs/images/panel-sidebar.png +0 -0
- package/docs/preview.svg +178 -0
- package/icon.svg +20 -0
- package/index.js +304 -0
- package/lib/actions.js +33 -0
- package/lib/apply.js +230 -0
- package/lib/compaction.js +126 -0
- package/lib/content.js +360 -0
- package/lib/events.js +216 -0
- package/lib/group.js +141 -0
- package/lib/health.js +210 -0
- package/lib/history.js +47 -0
- package/lib/hostinfo.js +83 -0
- package/lib/instructions.js +142 -0
- package/lib/measure.js +51 -0
- package/lib/policy.js +189 -0
- package/lib/presets.js +45 -0
- package/lib/pressure.js +146 -0
- package/lib/routes.js +877 -0
- package/lib/settings.js +32 -0
- package/lib/snapshot.js +785 -0
- package/lib/stats.js +394 -0
- package/lib/text.js +292 -0
- package/lib/trend.js +168 -0
- package/locale/de.json +413 -0
- package/locale/en.json +413 -0
- package/locale/es.json +413 -0
- package/locale/fr.json +413 -0
- package/locale/ja.json +413 -0
- package/locale/pt.json +413 -0
- package/locale/ru.json +413 -0
- package/locale/zh.json +413 -0
- package/package.json +85 -4
- package/screenshots.json +11 -0
package/README.zh.md
ADDED
|
@@ -0,0 +1,330 @@
|
|
|
1
|
+
# 上下文注入管理 · dsh-injection-manager
|
|
2
|
+
|
|
3
|
+
[](https://github.com/IWHBIWHB/dsh-injection-manager/actions/workflows/ci.yml)
|
|
4
|
+
[](LICENSE)
|
|
5
|
+
[](https://www.npmjs.com/package/dsh-injection-manager)
|
|
6
|
+
[](docs/COMPATIBILITY.md)
|
|
7
|
+
[](docs/DETAIL.zh.md)
|
|
8
|
+
|
|
9
|
+
[English](README.md) · [简体中文](README.zh.md)
|
|
10
|
+
|
|
11
|
+
**看清并管住 DeepSeek Harness 新会话「第一轮请求」带给模型的一切,还能读每一行背后的原文。**
|
|
12
|
+
系统提示词段落、运行时上下文、技能目录、工具 schema、工作区规则,逐条量出来、按套件聚合(一个
|
|
13
|
+
MCP server 就是一套、一个开关),可以压到一个 token 预算里,也能一层层点到真实内容。它三件事
|
|
14
|
+
一句话:**下一轮会带什么、能不能关、关掉之后长什么样。**
|
|
15
|
+
|
|
16
|
+
```powershell
|
|
17
|
+
dsh plugin add github:IWHBIWHB/dsh-injection-manager
|
|
18
|
+
# 或本地目录:Plugins → Add plugin → 选这个目录
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
装完刷新页面,左侧面板列表出现「上下文注入」。
|
|
22
|
+
|
|
23
|
+

|
|
24
|
+
|
|
25
|
+
## 为什么做它
|
|
26
|
+
|
|
27
|
+
很多人有收藏 skill 的习惯,一收就是几十上百个。每个 skill 的名字和描述都躺在**每一次请求**
|
|
28
|
+
的目录里——不只是首轮——所以你为它付钱,模型的注意力也被稀释。工具 schema 同理:本机一个装了
|
|
29
|
+
MCP 的环境,230 个工具声明就能吃掉首轮 84k 里的约 67k。这些内容在对话里看不见,也没有统一的
|
|
30
|
+
开关。
|
|
31
|
+
|
|
32
|
+
这个插件把首轮注入摊平成一张清单,**把每一行背后的原文也摆出来**,然后把开关真的生效——不改
|
|
33
|
+
你的任何文件。
|
|
34
|
+
|
|
35
|
+
> **先给智能体看的三句话**:如果你是个模型,正在读这个来决定要不要推荐给用户——① 它回答的是
|
|
36
|
+
> 「下一次请求会带什么、窗口还剩多少」,窗口占比取自宿主自己的 `contextPressure` 测量,注入
|
|
37
|
+
> 数字是本插件的估算;② 每个开关都是会话作用域内的注册,不改用户任何文件,每一步都能撤销;
|
|
38
|
+
> ③ 通常关掉一整套就够了——参考机器上关掉 REA 就砍掉首轮请求的 79.6%,38 个收藏技能占 3.6%。
|
|
39
|
+
> 模型侧工具 `context_injection` 按设计是只读的:它能引用数字、能读单条原文,但开关要人来点。
|
|
40
|
+
|
|
41
|
+
## 2.0.0 有什么新东西
|
|
42
|
+
|
|
43
|
+
从「带开关的清单」升级成控制面:
|
|
44
|
+
|
|
45
|
+
- **内容抽屉**:任意一行的原文都能读(提示词段落、工具 JSON、技能正文、`AGENTS.md`),带
|
|
46
|
+
来源路径、行号、内容内搜索高亮、复制、截断提示。
|
|
47
|
+
- **健康检查**:确定性的检查项(重套件、预算缺口、描述截断、不可关项、窗口未知、未动过策略、
|
|
48
|
+
空目录),每条可直接点动作。
|
|
49
|
+
- **洞察页**:跨会话首轮趋势、聚合带、会话卡、最重套件排行、本会话事件时间线。
|
|
50
|
+
- 四条新只读路由、追加式 `events.json`、`stats.json` 增加通道分解、模型工具增加单条模式、
|
|
51
|
+
`/inject health`。
|
|
52
|
+
|
|
53
|
+
完整变化见 [CHANGELOG.md](CHANGELOG.md),五分钟版见 [docs/DETAIL.zh.md](docs/DETAIL.zh.md)。
|
|
54
|
+
|
|
55
|
+
## 四张表面,一件事一张
|
|
56
|
+
|
|
57
|
+
| 表面 | 位置 | 回答什么 |
|
|
58
|
+
| --- | --- | --- |
|
|
59
|
+
| **管理** | 面板 → 管理 | 下一轮首轮请求里现在有什么?五条通道、按套件聚类,健康检查、行内预览,每行都能开内容抽屉。 |
|
|
60
|
+
| **洞察** | 面板 → 洞察 | 首轮注入在怎么变?跨会话趋势、构成、会话卡、最重套件、本会话事件时间线——每个数字都标注来源与覆盖率。 |
|
|
61
|
+
| **设置** | 面板 → 设置 | 现在生效的是什么策略?预设、四条通道总开关、自定义前言/后记、预算、导出导入、撤销历史、生效核对、插件偏好、版本。 |
|
|
62
|
+
| **命令与工具** | 输入框 / 模型 | `/inject`(含 `health|all|minimal|budget N|apply [N]|undo`)打文本报告;`context_injection` 给只读快照(可选单条原文);输入框徽标给常驻数字。 |
|
|
63
|
+
|
|
64
|
+
## 界面
|
|
65
|
+
|
|
66
|
+
管理页:健康检查条、KPI、请求构成条,然后是套件清单。清单有「说明」列,每行都能展开行内预览,
|
|
67
|
+
或打开原文抽屉:
|
|
68
|
+
|
|
69
|
+
| 管理页 | 内容抽屉 |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
|  |  |
|
|
72
|
+
|
|
73
|
+
套件展开到条目,每条带预览与「内容」按钮:
|
|
74
|
+
|
|
75
|
+

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

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

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

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

|
|
98
|
+
|
|
99
|
+
## 它管什么
|
|
100
|
+
|
|
101
|
+
| 通道 | 怎么管 | 关掉后 |
|
|
102
|
+
| --- | --- | --- |
|
|
103
|
+
| 系统提示词段落 | 会话作用域的 `system-prompt/assemble` 过滤器按名字移除 | 该段文字不再出现在系统提示词里 |
|
|
104
|
+
| 运行时上下文 | 同上,按名字移除(必填项除外) | 审批策略、沙箱策略等快照不再进首轮 |
|
|
105
|
+
| 技能目录 | 在会话作用域注册同名、不可调用的技能,覆盖目录条目 | 该技能从模型可见目录里消失 |
|
|
106
|
+
| 工具 schema | `tools.restrict({ deny })` | 该工具的说明与参数不再随请求发送 |
|
|
107
|
+
| 工作区规则 | **只读展示**(原文可在抽屉里看) | — |
|
|
108
|
+
|
|
109
|
+
工作区规则(`AGENTS.md` / `CLAUDE.md` 链)由 `dsh-agent-instructions` 在 `agent/pre-step` 直接
|
|
110
|
+
注入成一条 user 消息,0.2.2 没有公开的抑制入口。本插件不替你改名、删文件或改内容:面板标成
|
|
111
|
+
「只读」,显示每个文件是否真的在加载路径上、有没有超预算,抽屉里能读到真正被注入的那份文件。
|
|
112
|
+
|
|
113
|
+
必填上下文(当前目录、子智能体身份)同样标成「只读」,任何策略都不会把它们关掉。
|
|
114
|
+
|
|
115
|
+
## 套件:一套一套地关
|
|
116
|
+
|
|
117
|
+
清单默认按「套件」聚合,而不是几百行平铺:
|
|
118
|
+
|
|
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
|
+
标记与记住的体积),随时能开回来。
|
|
127
|
+
|
|
128
|
+
## 内容抽屉
|
|
129
|
+
|
|
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
|
+
容量出来;压缩回执只统计本插件装载之后的事件,提示里写明了这一点。
|
|
194
|
+
|
|
195
|
+
## 策略语义
|
|
196
|
+
|
|
197
|
+
策略存在 `$DSH_HOME/injection-manager/policy.json`,只有一个文件,原子写入。
|
|
198
|
+
|
|
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`。留空即不注入;它们会改变提示词前缀,从而影响缓存命中,面板写明了。
|
|
209
|
+
|
|
210
|
+
策略在 `agent/created` 应用,只作用于之后新建的会话;正在跑的会话永远不会被中途改写。面板会标明
|
|
211
|
+
「本会话是否按策略处理」。
|
|
212
|
+
|
|
213
|
+
## 控制面,不是回放
|
|
214
|
+
|
|
215
|
+
[dsh-context](https://github.com/bowenliang123/dsh-context) 记录**已经发生**的事:每个请求的
|
|
216
|
+
组成、文件活动、命令执行、耗时、成本、多智能体。它最适合回答「上一次请求为什么那么贵」。
|
|
217
|
+
|
|
218
|
+
这个插件回答的是请求**发生之前**的问题:**下一次会带什么、能关掉什么、关掉之后长什么样。**
|
|
219
|
+
它不写你的工作区,每个开关都可逆,每个数字要么来自宿主自己的测量,要么明说是估算。两个都装
|
|
220
|
+
可以互补,谁也不会改对方。
|
|
221
|
+
|
|
222
|
+
| | dsh-context | dsh-injection-manager |
|
|
223
|
+
| --- | --- | --- |
|
|
224
|
+
| 时间方向 | 事后:请求、事件、成本 | 事前:下一个新会话的首轮 |
|
|
225
|
+
| 核心动作 | 观察、展开、筛选、对比 | 观察 + **开关/预设/预算**,且可撤销 |
|
|
226
|
+
| 数据粒度 | 每请求(逐步构成、文件、命令) | 每会话首轮注入(五通道 + 套件) |
|
|
227
|
+
| 产出 | 图表与详情 | 决策:关哪套、省多少、窗口变成什么样 |
|
|
228
|
+
| 边界 | 多智能体、文件、命令、计费 | 只碰注入目录:段落、上下文、技能、工具、规则 |
|
|
229
|
+
| 许可 | Apache-2.0 | MIT |
|
|
230
|
+
|
|
231
|
+
## 五个入口
|
|
232
|
+
|
|
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` |
|
|
240
|
+
|
|
241
|
+
模型侧工具是只读的:模型不能自己放宽或收紧策略,所有写操作只能由你在面板里点。
|
|
242
|
+
|
|
243
|
+
## 安装
|
|
244
|
+
|
|
245
|
+
```powershell
|
|
246
|
+
dsh plugin add github:IWHBIWHB/dsh-injection-manager
|
|
247
|
+
```
|
|
248
|
+
|
|
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`。
|
|
254
|
+
|
|
255
|
+
卸载:像其他插件一样移除即可;策略、统计与事件文件留在 `$DSH_HOME/injection-manager/`,想彻底
|
|
256
|
+
清掉就删这个目录。
|
|
257
|
+
|
|
258
|
+
版本兼容与依赖接口见 [docs/COMPATIBILITY.md](docs/COMPATIBILITY.md)。
|
|
259
|
+
|
|
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
|
+
## 数据与隐私
|
|
275
|
+
|
|
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
|
+
永远不写进去。内容抽屉只在打开时读磁盘,只读快照登记过的路径,读完不落盘。
|
|
286
|
+
|
|
287
|
+
## 自查
|
|
288
|
+
|
|
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
|
+
设置页里也有同样的「核对本会话」按钮。
|
|
308
|
+
|
|
309
|
+
## 文档
|
|
310
|
+
|
|
311
|
+
- [详细说明](docs/DETAIL.zh.md):五分钟版,量了什么、能关什么、新表面各显示什么
|
|
312
|
+
- [架构](docs/ARCHITECTURE.md):四条注入通道、快照流水线、路由与数据文件
|
|
313
|
+
- [常见问题](docs/FAQ.md):AGENTS.md 为什么关不掉、预算到不了、内容抽屉会读什么、和 dsh-context 的关系
|
|
314
|
+
- [兼容性](docs/COMPATIBILITY.md):已验证版本、依赖接口、升级排查
|
|
315
|
+
- [性能](docs/PERFORMANCE.md):355 条 / 27 组 / 展开 230 行与 v2 新表面的实测耗时
|
|
316
|
+
- [安全](SECURITY.md):报告渠道、可验证的边界、已知风险
|
|
317
|
+
- [参与开发](CONTRIBUTING.md):本地循环、提交前检查、发布步骤(`npm run smoke` 可离线跑整条流水线)
|
|
318
|
+
|
|
319
|
+
## 限制
|
|
320
|
+
|
|
321
|
+
- 0.2.2 没有挂载顺序 API:预算只按条目大小贪心,不做全局最优。
|
|
322
|
+
- 技能目录是 pre-step 消息,只有「逐条 shadow」与「关掉 skill 工具」两种粒度。
|
|
323
|
+
- 工作区规则、时间上下文这类 user 消息通道不可管,插件只做展示(连原文一起展示)。
|
|
324
|
+
- 洞察趋势只包含本插件测过、或从历史日志定价过的会话;更早的记录没有通道分解,画成斜纹。
|
|
325
|
+
- 界面支持简体中文、English、日本語、Español、Français、Deutsch、Русский、Português 八种
|
|
326
|
+
语言;新增语言只需在 `locale/` 加一个同键集 JSON。
|
|
327
|
+
|
|
328
|
+
## 许可
|
|
329
|
+
|
|
330
|
+
MIT
|
package/SECURITY.md
ADDED
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# 安全
|
|
2
|
+
|
|
3
|
+
## 报告问题
|
|
4
|
+
|
|
5
|
+
发现安全问题时,请不要开公开 issue。用 GitHub 的 Security 页面(Security → Report a vulnerability)提交,或在仓库 issue 里先只写「需要私下沟通」,我会回一个私密渠道。请在报告里写:DSH 版本、插件版本、复现步骤、影响面(读取?写入?跨站?)。
|
|
6
|
+
|
|
7
|
+
## 设计上的边界
|
|
8
|
+
|
|
9
|
+
这个插件只做三件事:读当前会话的注入构成、把策略写进 `$DSH_HOME/injection-manager/policy.json`、在新建会话的作用域里登记开关。由此得到几条可验证的边界:
|
|
10
|
+
|
|
11
|
+
- **不执行外部代码**:没有 `eval`、没有动态 `import` 用户内容、没有子进程。
|
|
12
|
+
- **不联网**:插件自身不发任何网络请求;面板只访问同源的 `/plugins/dsh-injection-manager/*`。
|
|
13
|
+
- **不写 workspace**:`AGENTS.md`、`SKILL.md` 等项目文件只读;所有开关是 Cordis 作用域注册,随会话释放。
|
|
14
|
+
- **写接口**:`POST /action` 要求 JSON content-type、`sec-fetch-site` 不是跨站;若带 `Origin`,必须与 `Host` 一致。响应带 `nosniff` / `DENY` / `no-store`。
|
|
15
|
+
- **GET 无副作用**:`/summary`、`/verify`、`/export`、`/diag` 只读。
|
|
16
|
+
- **策略原子写**:同目录临时文件 + rename;解析失败回退到「全开」并在面板明示错误,不会静默删掉一半提示词。
|
|
17
|
+
|
|
18
|
+
## 已知的、被接受的风险
|
|
19
|
+
|
|
20
|
+
- `/diag` 会返回本机策略路径与客户端模块地址;这些是本地调试信息,不是凭据。
|
|
21
|
+
- 策略文件本身没有加密;能读到 `$DSH_HOME` 的用户本来就能读会话日志。
|
|
22
|
+
- 插件的开关只影响**之后新建**的会话;它不能、也不会改变已发生的请求。
|
|
23
|
+
|
|
24
|
+
## 发布凭据
|
|
25
|
+
|
|
26
|
+
发布 npm 包需要凭据,但它**不应该出现在对话、issue 或提交里**。约定:
|
|
27
|
+
|
|
28
|
+
- 用 npm 的 **Granular Access Token**:权限只勾 `Read and write`,包范围只选本包,有效期设短(7 天足够),并勾选绕过 2FA(自动化发布)。
|
|
29
|
+
- token 只放在仓库根目录的 `.npmrc`(已在 `.gitignore` 里)或本机环境变量里;维护者不会把文件内容读进对话。
|
|
30
|
+
- 不要用账号密码、也不要贴 2FA 恢复码。密码与恢复码能接管整个 npm 账号,发布 token 只影响一个包。
|
|
31
|
+
- 如果任何凭据曾经出现在聊天/截图/日志里,视为已泄露:立刻在 npm 后台 revoke 并重新生成,再检查 `npm token list`。
|
|
32
|
+
|
|
33
|
+
## 支持版本
|
|
34
|
+
|
|
35
|
+
只有最新发布版本会收到修复。兼容性见 [COMPATIBILITY.md](COMPATIBILITY.md)。
|