@cheemsup/dsh-plugin-console 0.1.1 → 0.2.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/LICENSE CHANGED
@@ -1,3 +1,5 @@
1
+ SPDX-License-Identifier: MIT
2
+
1
3
  MIT License
2
4
 
3
5
  Copyright (c) 2026 dsh-plugin-console contributors
package/README.md CHANGED
@@ -1,86 +1,95 @@
1
- # dsh-plugin-console
2
-
3
- [简体中文](README.md) · [English](README_en.md)
4
-
5
- [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/license/mit)
6
-
7
- DeepSeek Harness(DSH)的侧边栏插件控制台:通过运行时对象分析以及原始文件扫描处理的方式获取关于插件、会话、工具等信息并通过页面向用户展示;同时还提供首次请求的模型上下文预演以及相应的上下文定制功能
8
-
9
- ## 功能
10
-
11
- - **插件** — 浏览这台机器装了哪些插件,查看启用状态、组合链、服务依赖、登记的行为、贡献的工具与提示词段等,帮助掌控DSH内的插件行为和关系
12
- - **会话** — 追踪「全局插件 → 模式要求的插件 → 本会话」的来源链,可读首次请求的系统提示词、工具 schema 与消息注入等内容
13
- - **工具** — 可按注册的插件分组查看工具,也可以看每个模式的预设工具集,帮助观察DSH中每个工具的来源以及详细信息
14
- - **首请求预演** — 指定模式、工作区与权限预设,查看新会话第一条消息发出前模型会收到的完整上下文构造
15
- - **提示词定制模板** — 通过插件自管理规则文件的方式支撑起基于DSH标准模型上下文的定制改造;同时配套了对于模板的开关、继承、清理等完整生命周期控制手段
16
-
17
- ## 安装
18
-
19
- ```sh
20
- # 从 npm 安装
21
- dsh plugin --profile <profile> add @cheemsup/dsh-plugin-console
22
-
23
- # 从 GitHub 安装
24
- dsh plugin --profile <profile> add github:Cheemsup/dsh-plugin-console
25
-
26
- # 从本地目录安装(开发)
27
- dsh plugin --profile <profile> add file:<本目录绝对路径>
28
- ```
29
-
30
- ## 界面
31
-
32
- ### 插件页
33
-
34
- ![插件页](docs/images/01-plugins.png)
35
-
36
- *图 1 · 插件页:说明了DSH内插件的信息、行为、依赖关系等信息*
37
-
38
- ### 会话页
39
-
40
- ![会话页](docs/images/02-sessions.png)
41
-
42
- *图 2 · 会话页:展示了一个会话涉及的插件以及完整的首次请求上下文信息*
43
-
44
- ### 工具页
45
-
46
- ![工具页](docs/images/03-tools.png)
47
-
48
- *图 3 · 工具页:回答「模型能看到哪些工具、谁给的」。来源来自扫描插件包源码,提供友好阅读方式*
49
-
50
- ### 首请求预演
51
-
52
- ![预演](docs/images/04-preview.png)
53
-
54
- *图 4 · 预演页:回答「如果现在开一个新会话,第一条消息发出前模型会收到什么」,通过指定不同的工作区以及模式会带来不同的预演结果*
55
-
56
- ### 提示词定制模板
57
-
58
- ![定制编辑器](docs/images/05-editor.png)
59
-
60
- *图 5 · 定制编辑器:选定工作区以及模式,则能够在此预演基础上进行提示词的定制以及开启会话*
61
-
62
- ## 数据可信度
63
-
64
- - **运行时事实**:插件条目与状态、工具与提示词注册、会话日志,直接读宿主。
65
- - **推导**:工作区、权限、指令文件、skill 目录与时间快照,用同一份配置和文件重算。
66
- - **源码归属**:注册表不记录工具与提示词段是谁注册的,因此扫描插件包源码补齐。
67
- - **未知 / 不可用**:缺少输入或宿主没有暴露这项能力时如实标注,推导不会被写成实测。
68
-
69
- ## 已知边界
70
-
71
- - 需要宿主提供 `connection` 服务,否则只加载插件、不注册路由。
72
- - 冷会话没有 fiber:只显示记录与模式要求的插件,无法判断本进程实际挂载了什么。
73
- - 首请求预演是预测,不是记录;附件 / 图片、后续轮次与 goal / plan / schedule 等动态注入不在
74
- 范围内,子 Agent 的首请求也不纳入。
75
- - 活动只统计工具型贡献,默认最近 7 天、最多 20 个会话(实验性功能);只提供服务或只监听事件的插件没有调用数。
76
- - 提示词定制**只影响模型上下文,不改变实际权限**,工具禁用除外。
77
- - 清理模板数据只删持久记录,运行中的会话会一直保留已注册内容,直到结束或 DSH 重启。
78
-
79
- ## 开发
80
-
81
- 架构与修改约束见 [CLAUDE.md](CLAUDE.md),界面规范见
82
- [docs/design-ui.md](docs/design-ui.md),可能的下一步方向见 [docs/next-direction.md](docs/next-direction.md)。
83
-
84
- ## 许可
85
-
86
- MIT
1
+ # dsh-plugin-console
2
+
3
+ [简体中文](README.md) · [English](README_en.md)
4
+
5
+ [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/license/mit)
6
+
7
+ DeepSeek Harness(DSH)的侧边栏插件控制台:通过运行时对象分析以及原始文件扫描处理的方式获取关于插件、会话、工具等信息并通过页面向用户展示;同时提供模型上下文预演、插件禁用影响与配置覆盖关系的预演,以及相应的上下文定制功能
8
+
9
+ ## 功能
10
+
11
+ - **插件** — 浏览这台机器装了哪些插件,查看启用状态、组合链、服务依赖、登记的行为、贡献的工具与提示词段等,帮助掌控DSH内的插件行为和关系
12
+ - **会话** — 追踪「全局插件 → 模式要求的插件 → 本会话」的来源链,可读首次请求的系统提示词、工具 schema 与消息注入等内容
13
+ - **工具** — 可按注册的插件分组查看工具,也可以看每个模式的预设工具集,帮助观察DSH中每个工具的来源以及详细信息
14
+ - **上下文预演** — 指定模式、工作区与权限预设,查看新会话第一条消息发出前模型会收到的完整上下文构造
15
+ - **提示词定制模板** — 通过插件自管理规则文件的方式支撑起基于DSH标准模型上下文的定制改造;同时配套了对于模板的开关、继承、清理等完整生命周期控制手段
16
+ - **插件禁用预演** — 选择任一插件,预演禁用它会失去哪些工具、提示词段与运行时注入、展示 config 声明与生效值的差异,以及上下游插件的依赖树
17
+
18
+ ## 安装
19
+
20
+ ```sh
21
+ # 从 npm 安装
22
+ dsh plugin --profile <profile> add @cheemsup/dsh-plugin-console
23
+
24
+ # 从 GitHub 安装
25
+ dsh plugin --profile <profile> add github:Cheemsup/dsh-plugin-console
26
+
27
+ # 从本地目录安装(开发)
28
+ dsh plugin --profile <profile> add file:<本目录绝对路径>
29
+ ```
30
+
31
+ ## 界面
32
+
33
+ ### 插件页
34
+
35
+ ![插件页](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/01-plugins.png)
36
+
37
+ *图 1 · 插件页:说明了DSH内插件的信息、行为、依赖关系等信息*
38
+
39
+ ### 会话页
40
+
41
+ ![会话页](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/02-sessions.png)
42
+
43
+ *图 2 · 会话页:展示了一个会话涉及的插件以及完整的首次请求上下文信息*
44
+
45
+ ### 工具页
46
+
47
+ ![工具页](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/03-tools.png)
48
+
49
+ *图 3 · 工具页:回答「模型能看到哪些工具、谁给的」。来源来自扫描插件包源码,提供友好阅读方式*
50
+
51
+ ### 上下文预演
52
+
53
+ ![上下文预演](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/04-preview.png)
54
+
55
+ *图 4 · 上下文预演页:回答「如果现在开一个新会话,第一条消息发出前模型会收到什么」,通过指定不同的工作区以及模式会带来不同的预演结果*
56
+
57
+ ### 提示词定制模板
58
+
59
+ ![定制编辑器](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/05-editor.png)
60
+
61
+ *图 5 · 定制编辑器:选定工作区以及模式,则能够在此预演基础上进行提示词的定制以及开启会话*
62
+
63
+ ### 插件禁用预演
64
+
65
+ ![插件禁用预演](https://raw.githubusercontent.com/Cheemsup/dsh-plugin-console/main/docs/images/06-disable-preview.png)
66
+
67
+ *图 6 · 插件禁用预演页的依赖关系图*
68
+
69
+ ## 数据可信度
70
+
71
+ - **运行时事实**:插件条目与状态、工具与提示词注册、会话日志,直接读宿主。
72
+ - **推导**:工作区、权限、指令文件、skill 目录与时间快照,用同一份配置和文件重算。
73
+ - **源码归属**:注册表不记录工具与提示词段是谁注册的,因此扫描插件包源码补齐。
74
+ - **文件事实**:bundle / profile / home 的 patch 文件与其中的 config 子树;文件读不到或写法不受支持时标注原因。
75
+ - **未知 / 不可用**:缺少输入或宿主没有暴露这项能力时如实标注,推导不会被写成实测。
76
+
77
+ ## 已知边界
78
+
79
+ - 需要宿主提供 `connection` 服务,否则只加载插件、不注册路由。
80
+ - 冷会话没有 fiber:只显示记录与模式要求的插件,无法判断本进程实际挂载了什么。
81
+ - 上下文预演是预测,不是记录;附件 / 图片、后续轮次与 goal / plan / schedule 等动态注入不在
82
+ 范围内,子 Agent 的首请求也不纳入。
83
+ - 活动只统计工具型贡献,默认最近 7 天、最多 20 个会话(实验性功能);只提供服务或只监听事件的插件没有调用数。
84
+ - 插件禁用预演是派生计算,不执行禁用、也不模拟运行时卸载;「失去」只表示没有其他所有者。依赖链按 inject 声明推导到不动点,语义是禁用并重载/重启后,已激活的插件可能在下一次重载前仍保留注册与工具。配置分层只展示 patch 文件声明与生效值,patch 的合并语义未公开,诊断不推断原因;内置组合包或缺少 `pluginPackages` 时 bundle patch 不可读,会如实标注。
85
+ - 提示词定制**只影响模型上下文,不改变实际权限**,工具禁用除外。
86
+ - 清理模板数据只删持久记录,运行中的会话会一直保留已注册内容,直到结束或 DSH 重启。
87
+
88
+ ## 开发
89
+
90
+ 架构与修改约束见 [CLAUDE.md](CLAUDE.md),界面规范见
91
+ [docs/design-ui.md](docs/design-ui.md),可能的下一步方向见 [docs/next-direction.md](docs/next-direction.md)。
92
+
93
+ ## 许可
94
+
95
+ MIT
package/icon.svg ADDED
@@ -0,0 +1,203 @@
1
+ <svg xmlns="http://www.w3.org/2000/svg" width="512" height="512" viewBox="0 0 1254 1254">
2
+ <!-- 配色取自控制台色板:accent blue / teal / amber,三组色相分别对应
3
+ 螺母与连接臂/卡扣、下方机械臂、右侧触点。 -->
4
+ <defs>
5
+ <linearGradient id="pc-blue" x1="0" y1="0" x2="1" y2="1">
6
+ <stop offset="0%" stop-color="#0066CC"/>
7
+ <stop offset="100%" stop-color="#3F6FD8"/>
8
+ </linearGradient>
9
+ <linearGradient id="pc-blue-light" x1="0" y1="0" x2="1" y2="1">
10
+ <stop offset="0%" stop-color="#3F6FD8"/>
11
+ <stop offset="100%" stop-color="#5B8DEF"/>
12
+ </linearGradient>
13
+ <linearGradient id="pc-teal" x1="0" y1="0" x2="1" y2="1">
14
+ <stop offset="0%" stop-color="#0F9184"/>
15
+ <stop offset="100%" stop-color="#27AE9F"/>
16
+ </linearGradient>
17
+ <linearGradient id="pc-amber" x1="0" y1="0" x2="1" y2="1">
18
+ <stop offset="0%" stop-color="#A86B12"/>
19
+ <stop offset="100%" stop-color="#C98A26"/>
20
+ </linearGradient>
21
+ </defs>
22
+
23
+ <g>
24
+ <!-- 右侧两个独立插头触点 -->
25
+ <path fill="url(#pc-amber)" d="
26
+ M 971 967
27
+ Q 969 970 969 987
28
+ Q 969 1004 971 1007
29
+ Q 973 1012 978 1012
30
+ L 1058 1012
31
+ Q 1075 1012 1075 986
32
+ Q 1075 976 1073 973
33
+ Q 1070 962 1021 962
34
+ L 978 962
35
+ Q 973 964 971 967 Z"/>
36
+
37
+ <path fill="url(#pc-amber)" d="
38
+ M 972 866
39
+ Q 969 870 969 888
40
+ Q 969 906 970 908
41
+ Q 971 913 1018 913
42
+ L 1061 913
43
+ Q 1075 913 1075 888
44
+ Q 1075 876 1073 873
45
+ Q 1070 863 1019 863
46
+ L 976 863 Z"/>
47
+
48
+ <!-- 下方机械臂及插头:整体连续结构 -->
49
+ <path fill="url(#pc-teal)" d="
50
+ M 285 812
51
+ Q 283 815 283 829
52
+ Q 283 843 285 847
53
+ L 468 1027
54
+ Q 473 1030 483 1033
55
+ L 785 1033
56
+ Q 786 1046 788 1051
57
+ Q 794 1067 868 1067
58
+ Q 928 1067 934 1065
59
+ Q 950 1060 951 944
60
+ L 951 841
61
+ Q 950 826 944 823
62
+ Q 936 812 865 812
63
+ Q 809 813 803 816
64
+ Q 790 823 788 834
65
+ Q 784 863 695 863
66
+ L 602 863
67
+ L 501 763
68
+ Q 497 760 480 772
69
+ L 462 782
70
+ Q 456 787 461 793
71
+ L 584 913
72
+ Q 590 915 664 915
73
+ L 738 915
74
+ Q 740 919 740 939
75
+ L 740 959
76
+ Q 736 963 654 963
77
+ L 570 963
78
+ Q 568 962 558 952
79
+ L 415 811
80
+ Q 411 810 394 820
81
+ Q 377 829 369 832
82
+ Q 361 834 354 834
83
+ Q 346 834 339 832
84
+ Q 331 830 313 820
85
+ L 291 810
86
+ Q 287 810 285 812 Z"/>
87
+
88
+ <!-- 六边形螺母主体 -->
89
+ <path fill="url(#pc-blue)" fill-rule="evenodd" d="
90
+ M 355 447
91
+ Q 349 447 343 450
92
+ L 202 529
93
+ Q 195 535 193 540
94
+ Q 191 544 191 625
95
+ Q 191 705 193 710
96
+ Q 195 714 199 718
97
+ L 340 799
98
+ Q 352 803 355 803
99
+ Q 357 803 363 802
100
+ L 510 717
101
+ Q 517 713 519 709
102
+ Q 521 704 521 625
103
+ Q 521 545 518 539
104
+ Q 515 533 510 529
105
+ L 367 450
106
+ Q 361 447 355 447 Z
107
+
108
+ M 355 545
109
+ A 79.5 79.5 0 1 0 355 704
110
+ A 79.5 79.5 0 1 0 355 545 Z"/>
111
+
112
+ <!-- 上方第二条连接臂 -->
113
+ <path fill="url(#pc-blue-light)" d="
114
+ M 450 457
115
+ Q 449 460 451 462
116
+ L 484 481
117
+ Q 488 483 492 480
118
+ L 544 432
119
+ L 590 382
120
+ Q 596 381 696 381
121
+ L 796 381
122
+ Q 804 378 805 374
123
+ Q 805 371 798 359
124
+ L 788 340
125
+ Q 785 333 781 330
126
+ Q 777 328 678 328
127
+ L 579 328
128
+ Q 574 329 512 393
129
+ L 450 454
130
+ Q 449 455 450 457 Z"/>
131
+
132
+ <!-- 上方第一条连接臂 -->
133
+ <path fill="url(#pc-blue)" d="
134
+ M 302 419
135
+ Q 302 434 303 435
136
+ Q 307 438 325 429
137
+ Q 339 421 349 420
138
+ Q 358 418 367 420
139
+ Q 375 422 387 429
140
+ Q 399 435 403 435
141
+ Q 407 435 481 362
142
+ L 558 287
143
+ Q 562 285 670 285
144
+ L 782 285
145
+ Q 786 282 788 270
146
+ Q 790 261 798 246
147
+ Q 805 231 805 228
148
+ Q 805 225 803 223
149
+ Q 801 220 799 219
150
+ L 646 219
151
+ L 494 219
152
+ Q 488 221 483 224
153
+ L 392 312
154
+ L 304 400
155
+ Q 302 404 302 419 Z"/>
156
+
157
+ <!-- 右上角 C 形机械卡扣:围绕自身中心放大;改这个系数即可单独调大小。 -->
158
+ <g transform="translate(923.5 298.5) scale(1.15) translate(-923.5 -298.5)">
159
+ <path fill="url(#pc-blue)" d="
160
+ M 892 180
161
+ Q 888 181 882 185
162
+ Q 875 188 855 208
163
+ Q 835 227 827 240
164
+ Q 819 253 816 261
165
+ Q 809 280 809 300
166
+ Q 809 310 812 322
167
+ Q 814 334 819 344
168
+ Q 823 354 829 363
169
+ Q 835 372 854 390
170
+ L 876 411
171
+ Q 879 413 886 416
172
+ Q 892 418 928 418
173
+ L 963 418
174
+ Q 971 416 977 413
175
+ Q 983 409 1008 385
176
+ Q 1033 360 1036 355
177
+ Q 1038 349 1038 347
178
+ Q 1038 344 1037 342
179
+ Q 1036 340 1033 339
180
+ Q 1029 337 1005 334
181
+ Q 980 330 978 331
182
+ Q 975 332 968 338
183
+ Q 954 350 944 350
184
+ Q 922 352 917 350
185
+ Q 896 344 889 331
186
+ Q 877 316 877 301
187
+ Q 877 285 882 279
188
+ Q 890 261 903 257
189
+ Q 916 249 932 249
190
+ Q 947 249 959 256
191
+ Q 969 262 979 269
192
+ Q 984 270 1009 266
193
+ Q 1033 262 1035 261
194
+ Q 1038 258 1038 256
195
+ Q 1038 247 1033 241
196
+ Q 1029 234 1008 213
197
+ L 981 188
198
+ Q 976 184 969 182
199
+ Q 962 179 929 179
200
+ Q 895 179 892 180 Z"/>
201
+ </g>
202
+ </g>
203
+ </svg>
@@ -44,14 +44,14 @@ window.__ModuleLoader__.load({
44
44
  /**
45
45
  * 插件详情里的控制段。
46
46
  * @param {object} entry - 目标插件。
47
- * @param {object} options - `{ control, sessions, reload }`。
47
+ * @param {object} options - `{ control, sessions, reload, onPreviewDisable }`。
48
48
  * @returns {object} React 节点。
49
49
  */
50
50
  function renderControlSection(entry, options) {
51
51
  return h(ControlPanel, { entry, ...options })
52
52
  }
53
53
 
54
- function ControlPanel({ entry, control, sessions, reload }) {
54
+ function ControlPanel({ entry, control, sessions, reload, onPreviewDisable }) {
55
55
  const sessionList = Array.isArray(sessions) ? sessions : []
56
56
  const [sessionId, setSessionId] = useState(sessionList[0]?.id ?? '')
57
57
  const [pending, setPending] = useState(null)
@@ -122,6 +122,11 @@ window.__ModuleLoader__.load({
122
122
  h(
123
123
  'div',
124
124
  { className: 'ptCardRow' },
125
+ typeof onPreviewDisable === 'function'
126
+ ? textButton('预演禁用', () => onPreviewDisable(entry.rowId), {
127
+ title: '在「插件禁用预演」页查看失去的工具、提示词段与上下游关系(只读)',
128
+ })
129
+ : null,
125
130
  h(
126
131
  'button',
127
132
  {