@cheemsup/dsh-plugin-console 0.0.0-stage → 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 +23 -0
- package/README.md +95 -3
- package/cordis.patch.yml +5 -0
- package/icon.svg +203 -0
- package/lib/client.activity.js +222 -0
- package/lib/client.apply.js +171 -0
- package/lib/client.changes.js +206 -0
- package/lib/client.cleanup.js +270 -0
- package/lib/client.control.js +247 -0
- package/lib/client.dialog.js +77 -0
- package/lib/client.disable-preview.js +904 -0
- package/lib/client.draft.js +280 -0
- package/lib/client.editor-messages.js +421 -0
- package/lib/client.editor-store.js +266 -0
- package/lib/client.editor.js +433 -0
- package/lib/client.effects.js +115 -0
- package/lib/client.impact-tree.js +487 -0
- package/lib/client.influence.js +361 -0
- package/lib/client.js +246 -0
- package/lib/client.page.js +646 -0
- package/lib/client.plugin-filters.js +62 -0
- package/lib/client.plugins.js +506 -0
- package/lib/client.preview-messages.js +506 -0
- package/lib/client.preview-raw.js +132 -0
- package/lib/client.preview-store.js +128 -0
- package/lib/client.preview-tools.js +194 -0
- package/lib/client.preview.js +448 -0
- package/lib/client.relation-graph.js +364 -0
- package/lib/client.schema.js +327 -0
- package/lib/client.search.js +409 -0
- package/lib/client.session-detail.js +503 -0
- package/lib/client.sessions.js +495 -0
- package/lib/client.shared.js +562 -0
- package/lib/client.store.js +452 -0
- package/lib/client.styles.js +589 -0
- package/lib/client.template-card.js +240 -0
- package/lib/client.tools.js +366 -0
- package/lib/client.workspace-picker.js +204 -0
- package/lib/host/activity.js +252 -0
- package/lib/host/assembly-preview.js +244 -0
- package/lib/host/attribution.js +341 -0
- package/lib/host/catalog.js +133 -0
- package/lib/host/categorize.js +40 -0
- package/lib/host/config-layers.js +589 -0
- package/lib/host/constants.js +69 -0
- package/lib/host/control.js +159 -0
- package/lib/host/disable-preview.js +651 -0
- package/lib/host/entries.js +289 -0
- package/lib/host/fiber.js +86 -0
- package/lib/host/fs.js +99 -0
- package/lib/host/health.js +178 -0
- package/lib/host/http.js +65 -0
- package/lib/host/impact.js +138 -0
- package/lib/host/injection-owners.js +60 -0
- package/lib/host/layers.js +132 -0
- package/lib/host/masks.js +145 -0
- package/lib/host/modes.js +96 -0
- package/lib/host/names.js +44 -0
- package/lib/host/patch-config.js +554 -0
- package/lib/host/patch-scan.js +103 -0
- package/lib/host/preview-conditions.js +281 -0
- package/lib/host/preview-contexts.js +174 -0
- package/lib/host/preview-envelope.js +31 -0
- package/lib/host/preview-instructions.js +450 -0
- package/lib/host/preview-messages.js +284 -0
- package/lib/host/preview-modules.js +233 -0
- package/lib/host/preview-skills.js +200 -0
- package/lib/host/prompt.js +213 -0
- package/lib/host/recipe-overlay.js +209 -0
- package/lib/host/request-preview.js +114 -0
- package/lib/host/routes/activation.js +96 -0
- package/lib/host/routes/activity.js +22 -0
- package/lib/host/routes/apply.js +93 -0
- package/lib/host/routes/cleanup.js +62 -0
- package/lib/host/routes/control.js +22 -0
- package/lib/host/routes/disable-preview.js +19 -0
- package/lib/host/routes/impact.js +19 -0
- package/lib/host/routes/operations.js +22 -0
- package/lib/host/routes/preview.js +58 -0
- package/lib/host/routes/session-influence.js +23 -0
- package/lib/host/routes/snapshot.js +21 -0
- package/lib/host/routes/template.js +54 -0
- package/lib/host/routes/templates.js +28 -0
- package/lib/host/scope-impact.js +125 -0
- package/lib/host/session-events.js +39 -0
- package/lib/host/session-influence.js +467 -0
- package/lib/host/sessions.js +293 -0
- package/lib/host/snapshot.js +218 -0
- package/lib/host/source-scan.js +225 -0
- package/lib/host/templates/cleanup.js +219 -0
- package/lib/host/templates/inheritance.js +144 -0
- package/lib/host/templates/materialize.js +317 -0
- package/lib/host/templates/message-overlay.js +184 -0
- package/lib/host/templates/repository.js +323 -0
- package/lib/host/templates/store.js +131 -0
- package/lib/host/tool-set.js +150 -0
- package/lib/host/tools.js +129 -0
- package/lib/index.js +106 -0
- package/locale/en.json +6 -0
- package/locale/zh.json +6 -0
- package/package.json +124 -6
package/LICENSE
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
SPDX-License-Identifier: MIT
|
|
2
|
+
|
|
3
|
+
MIT License
|
|
4
|
+
|
|
5
|
+
Copyright (c) 2026 dsh-plugin-console contributors
|
|
6
|
+
|
|
7
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
8
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
9
|
+
in the Software without restriction, including without limitation the rights
|
|
10
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
11
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
12
|
+
furnished to do so, subject to the following conditions:
|
|
13
|
+
|
|
14
|
+
The above copyright notice and this permission notice shall be included in all
|
|
15
|
+
copies or substantial portions of the Software.
|
|
16
|
+
|
|
17
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
18
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
19
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
20
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
21
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
22
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
23
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,95 @@
|
|
|
1
|
-
#
|
|
2
|
-
|
|
3
|
-
|
|
1
|
+
# dsh-plugin-console
|
|
2
|
+
|
|
3
|
+
[简体中文](README.md) · [English](README_en.md)
|
|
4
|
+
|
|
5
|
+
[](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
|
+

|
|
36
|
+
|
|
37
|
+
*图 1 · 插件页:说明了DSH内插件的信息、行为、依赖关系等信息*
|
|
38
|
+
|
|
39
|
+
### 会话页
|
|
40
|
+
|
|
41
|
+

|
|
42
|
+
|
|
43
|
+
*图 2 · 会话页:展示了一个会话涉及的插件以及完整的首次请求上下文信息*
|
|
44
|
+
|
|
45
|
+
### 工具页
|
|
46
|
+
|
|
47
|
+

|
|
48
|
+
|
|
49
|
+
*图 3 · 工具页:回答「模型能看到哪些工具、谁给的」。来源来自扫描插件包源码,提供友好阅读方式*
|
|
50
|
+
|
|
51
|
+
### 上下文预演
|
|
52
|
+
|
|
53
|
+

|
|
54
|
+
|
|
55
|
+
*图 4 · 上下文预演页:回答「如果现在开一个新会话,第一条消息发出前模型会收到什么」,通过指定不同的工作区以及模式会带来不同的预演结果*
|
|
56
|
+
|
|
57
|
+
### 提示词定制模板
|
|
58
|
+
|
|
59
|
+

|
|
60
|
+
|
|
61
|
+
*图 5 · 定制编辑器:选定工作区以及模式,则能够在此预演基础上进行提示词的定制以及开启会话*
|
|
62
|
+
|
|
63
|
+
### 插件禁用预演
|
|
64
|
+
|
|
65
|
+

|
|
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/cordis.patch.yml
ADDED
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>
|
|
@@ -0,0 +1,222 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 插件活动:按需读取最近几天的工具调用,并把工具级数字接到插件/工具视图。
|
|
3
|
+
*
|
|
4
|
+
* 活动不是快照的一部分:读 session log 的成本随会话长度增长,所以只在插件
|
|
5
|
+
* 或工具视图可见时懒加载。读取失败只影响活动栏,不影响整页快照。
|
|
6
|
+
*
|
|
7
|
+
* 本文件是一个包内 chunk:入口用 `require.async('./client.activity.js')` 取它。
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
window.__ModuleLoader__.load({
|
|
11
|
+
id: '@cheemsup/dsh-plugin-console',
|
|
12
|
+
chunk: 'client.activity.js',
|
|
13
|
+
factory: (require) => {
|
|
14
|
+
const React = require('react')
|
|
15
|
+
const { createElement: h, useCallback, useState } = React
|
|
16
|
+
|
|
17
|
+
return function create(deps) {
|
|
18
|
+
const { fetchJson, ACTIVITY_ROUTE, formatAge } = deps
|
|
19
|
+
|
|
20
|
+
/** 活动状态:一次读取最近 7 天、最多 20 个会话。 */
|
|
21
|
+
function useActivityStore() {
|
|
22
|
+
const [status, setStatus] = useState('idle')
|
|
23
|
+
const [data, setData] = useState(null)
|
|
24
|
+
const [error, setError] = useState(null)
|
|
25
|
+
|
|
26
|
+
const load = useCallback(async (options = {}) => {
|
|
27
|
+
setStatus('loading')
|
|
28
|
+
setError(null)
|
|
29
|
+
const days = Number.isFinite(options.days) ? options.days : 7
|
|
30
|
+
const limit = Number.isFinite(options.limit) ? options.limit : 20
|
|
31
|
+
try {
|
|
32
|
+
const next = await fetchJson(`${ACTIVITY_ROUTE}?days=${days}&limit=${limit}`)
|
|
33
|
+
setData(next)
|
|
34
|
+
setStatus('ready')
|
|
35
|
+
} catch (cause) {
|
|
36
|
+
setError(cause instanceof Error ? cause.message : String(cause))
|
|
37
|
+
setStatus('error')
|
|
38
|
+
}
|
|
39
|
+
}, [fetchJson])
|
|
40
|
+
|
|
41
|
+
return { status, data, error, load }
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** 错误率:样本为 0 时不显示百分比。 */
|
|
45
|
+
function formatRate(rate) {
|
|
46
|
+
return Number.isFinite(rate) && rate > 0 ? Math.round(rate * 100) + '%' : '0%'
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** 耗时:毫秒级显示 ms,超过一秒显示 s。 */
|
|
50
|
+
function formatDuration(ms) {
|
|
51
|
+
if (!Number.isFinite(ms)) return '—'
|
|
52
|
+
return ms < 1000 ? Math.round(ms) + 'ms' : (ms / 1000).toFixed(1) + 's'
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/** 最后使用时间;没有调用时返回 —。 */
|
|
56
|
+
function formatLastUsed(timestamp) {
|
|
57
|
+
return typeof timestamp === 'number' && timestamp > 0 ? formatAge(timestamp) : '—'
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** 把 host 的一行工具活动归一成视图好用的形状。 */
|
|
61
|
+
function normalizeTool(name, row) {
|
|
62
|
+
return {
|
|
63
|
+
name,
|
|
64
|
+
calls: row?.calls ?? 0,
|
|
65
|
+
results: row?.results ?? 0,
|
|
66
|
+
errors: row?.errors ?? 0,
|
|
67
|
+
errorRate: row?.errorRate ?? 0,
|
|
68
|
+
p50Ms: row?.p50Ms ?? null,
|
|
69
|
+
p95Ms: row?.p95Ms ?? null,
|
|
70
|
+
lastUsed: row?.lastUsed,
|
|
71
|
+
sessions: Array.isArray(row?.sessions) ? row.sessions : [],
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** 单个工具的活动;数据未加载时 undefined,加载了但没有调用时返回 0 值。 */
|
|
76
|
+
function toolUsage(activity, name) {
|
|
77
|
+
if (activity === null || activity === undefined || activity.tools === undefined) return undefined
|
|
78
|
+
return normalizeTool(name, activity.tools[name])
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
* 一个插件的活动:把它的工具行汇总。
|
|
83
|
+
*
|
|
84
|
+
* p95 不能跨工具相加,这里取「最慢工具 p95」并在标签上写明。
|
|
85
|
+
* @param {object} entry - 插件条目。
|
|
86
|
+
* @param {object} activity - 活动响应。
|
|
87
|
+
* @returns {object | undefined} 汇总;活动未加载时 undefined。
|
|
88
|
+
*/
|
|
89
|
+
function pluginUsage(entry, activity) {
|
|
90
|
+
if (activity === null || activity === undefined || activity.tools === undefined) return undefined
|
|
91
|
+
const tools = (entry?.registrations?.tools ?? [])
|
|
92
|
+
.map((name) => toolUsage(activity, name))
|
|
93
|
+
.filter((row) => row !== undefined)
|
|
94
|
+
const sessions = new Set()
|
|
95
|
+
let calls = 0
|
|
96
|
+
let results = 0
|
|
97
|
+
let errors = 0
|
|
98
|
+
let lastUsed
|
|
99
|
+
let maxP95Ms = null
|
|
100
|
+
for (const row of tools) {
|
|
101
|
+
calls += row.calls
|
|
102
|
+
results += row.results
|
|
103
|
+
errors += row.errors
|
|
104
|
+
for (const id of row.sessions) sessions.add(id)
|
|
105
|
+
if (row.lastUsed !== undefined && (lastUsed === undefined || row.lastUsed > lastUsed)) lastUsed = row.lastUsed
|
|
106
|
+
if (Number.isFinite(row.p95Ms) && (maxP95Ms === null || row.p95Ms > maxP95Ms)) maxP95Ms = row.p95Ms
|
|
107
|
+
}
|
|
108
|
+
tools.sort((left, right) => right.calls - left.calls || left.name.localeCompare(right.name))
|
|
109
|
+
return {
|
|
110
|
+
tools,
|
|
111
|
+
calls,
|
|
112
|
+
results,
|
|
113
|
+
errors,
|
|
114
|
+
errorRate: results > 0 ? errors / results : 0,
|
|
115
|
+
p95Ms: maxP95Ms,
|
|
116
|
+
lastUsed,
|
|
117
|
+
sessions: sessions.size,
|
|
118
|
+
}
|
|
119
|
+
}
|
|
120
|
+
|
|
121
|
+
/**
|
|
122
|
+
* 行内的用量读数:只在真有调用/错误时出现,避免 209 行都挂一个 0。
|
|
123
|
+
*
|
|
124
|
+
* 次数是读数而不是状态,所以不给胶囊;错误用正文色标出,位置仍由调用方
|
|
125
|
+
* 统一放进右簇(`.ptEnd`)。
|
|
126
|
+
*/
|
|
127
|
+
function renderUsageTags(usage) {
|
|
128
|
+
if (usage === undefined || usage === null) return null
|
|
129
|
+
const tags = []
|
|
130
|
+
if (usage.calls > 0) {
|
|
131
|
+
tags.push(h('span', {
|
|
132
|
+
key: 'calls',
|
|
133
|
+
className: 'ptCount',
|
|
134
|
+
title: `最近 7 天 ${usage.calls} 次调用,最后 ${formatLastUsed(usage.lastUsed)}`,
|
|
135
|
+
}, '调用 ' + usage.calls))
|
|
136
|
+
}
|
|
137
|
+
if (usage.errors > 0) {
|
|
138
|
+
tags.push(h('span', {
|
|
139
|
+
key: 'errors',
|
|
140
|
+
className: 'ptCount ptError',
|
|
141
|
+
title: `${usage.errors} 次调用错误(包含参数错误)`,
|
|
142
|
+
}, '错误 ' + usage.errors))
|
|
143
|
+
}
|
|
144
|
+
return tags.length ? h(React.Fragment, null, ...tags) : null
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/** 详情里的一行事实;`ptFacts` 是 dt/dd 网格,所以一行必须成对。 */
|
|
148
|
+
function factRow(label, value) {
|
|
149
|
+
return h(React.Fragment, { key: label }, h('dt', null, label), h('dd', null, value))
|
|
150
|
+
}
|
|
151
|
+
|
|
152
|
+
/** 插件详情里的活动段。 */
|
|
153
|
+
function renderPluginActivity(entry, usage, status, error) {
|
|
154
|
+
const title = h('p', { className: 'ptSectionTitle' }, '活动(最近 7 天)')
|
|
155
|
+
if (status === 'loading') {
|
|
156
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptSub', style: { margin: 0 } }, '正在读取会话活动…'))
|
|
157
|
+
}
|
|
158
|
+
if (status === 'error') {
|
|
159
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptError', style: { margin: 0 } }, '活动读取失败:' + (error ?? '未知错误')))
|
|
160
|
+
}
|
|
161
|
+
if (status === 'idle') {
|
|
162
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptSub', style: { margin: 0 } }, '打开插件或工具页时读取活动'))
|
|
163
|
+
}
|
|
164
|
+
if (usage === undefined) {
|
|
165
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptSub', style: { margin: 0 } }, '这个部署没有可读的会话活动'))
|
|
166
|
+
}
|
|
167
|
+
if ((entry?.registrations?.tools ?? []).length === 0) {
|
|
168
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptSub', style: { margin: 0 } }, '这个插件没有工具型贡献,活动不可观测(但这不代表它没有运行)'))
|
|
169
|
+
}
|
|
170
|
+
if (usage.calls === 0) {
|
|
171
|
+
return h('div', { className: 'ptSection' }, title, h('p', { className: 'ptSub', style: { margin: 0 } }, '最近 7 天没有观测到它的工具被调用'))
|
|
172
|
+
}
|
|
173
|
+
|
|
174
|
+
const activeTools = usage.tools.filter((row) => row.calls > 0).slice(0, 12)
|
|
175
|
+
return h(
|
|
176
|
+
'div',
|
|
177
|
+
{ className: 'ptSection' },
|
|
178
|
+
title,
|
|
179
|
+
h(
|
|
180
|
+
'dl',
|
|
181
|
+
{ className: 'ptFacts' },
|
|
182
|
+
factRow('调用', String(usage.calls)),
|
|
183
|
+
factRow('结果', String(usage.results)),
|
|
184
|
+
factRow('错误', `${usage.errors}(${formatRate(usage.errorRate)})`),
|
|
185
|
+
factRow('最慢 p95', formatDuration(usage.p95Ms)),
|
|
186
|
+
factRow('最后使用', formatLastUsed(usage.lastUsed)),
|
|
187
|
+
factRow('会话', String(usage.sessions)),
|
|
188
|
+
),
|
|
189
|
+
activeTools.length
|
|
190
|
+
? h(
|
|
191
|
+
'details',
|
|
192
|
+
{ className: 'ptFold ptFoldable', style: { marginTop: '4px' } },
|
|
193
|
+
h('summary', null, h('span', null, '逐工具'), h('span', { className: 'ptFoldMeta' }, activeTools.length + ' 个有调用')),
|
|
194
|
+
h(
|
|
195
|
+
'ul',
|
|
196
|
+
{ className: 'ptDepList', style: { padding: '8px 12px' } },
|
|
197
|
+
activeTools.map((row) => h(
|
|
198
|
+
'li',
|
|
199
|
+
{ key: row.name },
|
|
200
|
+
h('span', { className: 'ptDepKey' }, row.name),
|
|
201
|
+
h('span', { className: 'ptDepValue' }, `${row.calls} 次 · 错 ${row.errors} · p95 ${formatDuration(row.p95Ms)} · ${formatLastUsed(row.lastUsed)}`),
|
|
202
|
+
)),
|
|
203
|
+
),
|
|
204
|
+
)
|
|
205
|
+
: null,
|
|
206
|
+
h('p', { className: 'ptSub', style: { margin: 0 } }, '调用与错误来自 session log 的 tool/call / tool/result;未观测到活动不代表插件没有运行。'),
|
|
207
|
+
)
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
return {
|
|
211
|
+
useActivityStore,
|
|
212
|
+
toolUsage,
|
|
213
|
+
pluginUsage,
|
|
214
|
+
formatRate,
|
|
215
|
+
formatDuration,
|
|
216
|
+
formatLastUsed,
|
|
217
|
+
renderUsageTags,
|
|
218
|
+
renderPluginActivity,
|
|
219
|
+
}
|
|
220
|
+
}
|
|
221
|
+
},
|
|
222
|
+
})
|