@cheemsup/dsh-plugin-console 0.0.0-stage → 0.1.1
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 +21 -0
- package/README.md +85 -2
- package/cordis.patch.yml +5 -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 +242 -0
- package/lib/client.dialog.js +77 -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.influence.js +361 -0
- package/lib/client.js +216 -0
- package/lib/client.page.js +584 -0
- package/lib/client.plugin-filters.js +62 -0
- package/lib/client.plugins.js +504 -0
- package/lib/client.preview-messages.js +495 -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 +447 -0
- package/lib/client.schema.js +327 -0
- package/lib/client.search.js +408 -0
- package/lib/client.session-detail.js +503 -0
- package/lib/client.sessions.js +495 -0
- package/lib/client.shared.js +559 -0
- package/lib/client.store.js +452 -0
- package/lib/client.styles.js +524 -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 +307 -0
- package/lib/host/catalog.js +133 -0
- package/lib/host/categorize.js +40 -0
- package/lib/host/constants.js +66 -0
- package/lib/host/control.js +159 -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 +132 -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-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/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 +475 -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 +103 -0
- package/package.json +111 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 dsh-plugin-console contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,86 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-plugin-console
|
|
2
2
|
|
|
3
|
-
|
|
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
|
+
|
|
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
|
+

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

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

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

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

|
|
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
|
package/cordis.patch.yml
ADDED
|
@@ -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
|
+
})
|
|
@@ -0,0 +1,171 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 「应用提示词模板到会话」那条五步链,单独成一个纯函数。
|
|
3
|
+
*
|
|
4
|
+
* 顺序不能变,而且每一步的失败语义都不一样:存版本失败就整体失败,建会话失败
|
|
5
|
+
* 就整体失败,物化失败要保留会话并报告原因,首句失败**不该**让整个流程失败。
|
|
6
|
+
* 把这些判断从 React 状态里拿出来,才能单独读、单独测。
|
|
7
|
+
*
|
|
8
|
+
* 链:
|
|
9
|
+
* 1. 保存草稿为新版本(保证「应用到会话的」就是眼前看到的)
|
|
10
|
+
* 2. 建会话(返回时 agent 已发布、首个 turn 尚未开始)
|
|
11
|
+
* 3. 物化提示词模板到这个会话
|
|
12
|
+
* 4. 首句:自动发送,或只填进输入框
|
|
13
|
+
* 5. 决定要不要跳过去
|
|
14
|
+
*
|
|
15
|
+
* 本文件是一个包内 chunk:入口用 `require.async('./client.apply.js')` 取它。
|
|
16
|
+
*/
|
|
17
|
+
|
|
18
|
+
window.__ModuleLoader__.load({
|
|
19
|
+
id: '@cheemsup/dsh-plugin-console',
|
|
20
|
+
chunk: 'client.apply.js',
|
|
21
|
+
factory: () => (deps) => {
|
|
22
|
+
const { fetchJson, TEMPLATE_ROUTE, APPLY_ROUTE } = deps
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* 把首句投递到会话:自动发送,或只填进输入框。
|
|
26
|
+
*
|
|
27
|
+
* 两件事都需要一个「已 retain 的 binding」,而刚 create 出来的会话还没有。
|
|
28
|
+
* 所以这里自己 retain 一次:不导航、只把 scope 建起来拿到 binding,做完再释放。
|
|
29
|
+
* 这样即使后面发现物化有失败、决定不跳走,也已经落好了。
|
|
30
|
+
*
|
|
31
|
+
* 发送走 `binding.session.prompt()` 而不是 `conversation.send()`:
|
|
32
|
+
* 后者要求「调用方 ctx 带 session scope」,而我们是从根 ctx 拿到的
|
|
33
|
+
* conversation,直接调会抛 root-context 错误。binding.session 是那个会话
|
|
34
|
+
* 自己的对象层,不需要再借 scope。
|
|
35
|
+
* @param {object} options - 投递参数。
|
|
36
|
+
* @returns {Promise<{promptSent: boolean, draftFilled: boolean, promptError: string | null}>} 投递结果。
|
|
37
|
+
*/
|
|
38
|
+
async function deliverFirstPrompt({ ctx, sessionsService, sessionId, prompt, autoSend }) {
|
|
39
|
+
let reference
|
|
40
|
+
let promptSent = false
|
|
41
|
+
let draftFilled = false
|
|
42
|
+
let promptError = null
|
|
43
|
+
try {
|
|
44
|
+
reference = sessionsService.retain?.(sessionId, { source: 'pluginTree' })
|
|
45
|
+
const binding = reference === undefined ? sessionsService.binding?.(sessionId) : await reference.ready
|
|
46
|
+
if (binding !== undefined) {
|
|
47
|
+
if (autoSend) {
|
|
48
|
+
const result = await binding.session.prompt([{ type: 'text', text: prompt }], 'queue')
|
|
49
|
+
if (result?.ok === true) promptSent = true
|
|
50
|
+
else promptError = result?.error?.message ?? '发送被拒绝'
|
|
51
|
+
} else {
|
|
52
|
+
const conversation = ctx?.get?.('conversation')
|
|
53
|
+
if (conversation?.input?.requestDraftInitialization !== undefined) {
|
|
54
|
+
conversation.input.requestDraftInitialization(binding, { prompt, whenDraftExists: 'replace' })
|
|
55
|
+
draftFilled = true
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
} catch (cause) {
|
|
60
|
+
// 首句没落好不该让整个流程失败:会话和物化都已经成了
|
|
61
|
+
promptError = cause instanceof Error ? cause.message : String(cause)
|
|
62
|
+
} finally {
|
|
63
|
+
reference?.release?.()
|
|
64
|
+
}
|
|
65
|
+
return { promptSent, draftFilled, promptError }
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
/**
|
|
69
|
+
* 把一条提示行拼出来:成功项与失败项都要说清楚,不能只报一句「完成」。
|
|
70
|
+
* @param {object} state - 本次运行的中间结果。
|
|
71
|
+
* @returns {{notes: string, failed: boolean}} 提示文本与是否算失败。
|
|
72
|
+
*/
|
|
73
|
+
function summarize({ sessionId, applied, prompt, wantPrompt }) {
|
|
74
|
+
const notes = []
|
|
75
|
+
notes.push('已建会话 ' + sessionId.slice(0, 16) + '… 并应用提示词模板')
|
|
76
|
+
if (applied.created === true) notes.push('(新建)')
|
|
77
|
+
const appliedSections = applied.applied0?.sections?.length ?? 0
|
|
78
|
+
const appliedOverrides = applied.applied0?.overrides?.length ?? 0
|
|
79
|
+
const denied = applied.applied0?.deniedTools?.length ?? 0
|
|
80
|
+
const contexts = applied.applied0?.contextOverrides?.length ?? 0
|
|
81
|
+
const messageKinds = applied.applied0?.messageKinds?.length ?? 0
|
|
82
|
+
notes.push(' · 追加段落 ' + appliedSections + ' · 改写 ' + appliedOverrides + ' · 禁用工具 ' + denied)
|
|
83
|
+
if (contexts > 0) notes.push(' · 上下文 ' + contexts)
|
|
84
|
+
if (messageKinds > 0) notes.push(' · 消息 ' + messageKinds)
|
|
85
|
+
const skipped = applied.applied0?.skippedTools ?? []
|
|
86
|
+
if (skipped.length > 0) notes.push(' · ' + skipped.length + ' 个工具名不在当前 scope,跳过(' + skipped.join('、') + ')')
|
|
87
|
+
const failures = applied.errors ?? []
|
|
88
|
+
if (failures.length > 0) notes.push(' · 失败 ' + failures.length + ' 项:' + failures.join(';'))
|
|
89
|
+
if (applied.applied !== true) notes.push(' · 物化没发生:' + (applied.reason ?? '未知原因'))
|
|
90
|
+
if (prompt.promptSent) notes.push(' · 首句已发送')
|
|
91
|
+
else if (prompt.promptError !== null) notes.push(' · 首句发送失败:' + prompt.promptError)
|
|
92
|
+
else if (wantPrompt && !prompt.draftFilled) notes.push(' · 首句没能填进输入框,请手动粘贴')
|
|
93
|
+
const failed = failures.length > 0 || applied.applied !== true
|
|
94
|
+
return { notes: notes.join(''), failed }
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
/**
|
|
98
|
+
* 跑完整条链。
|
|
99
|
+
*
|
|
100
|
+
* @param {object} options - 运行参数。
|
|
101
|
+
* @param {object} options.ctx - 浏览器插件上下文(按需取宿主服务)。
|
|
102
|
+
* @param {string} options.templateId - 目标提示词模板。
|
|
103
|
+
* @param {object} options.recipe - 当前草稿算出的配方。
|
|
104
|
+
* @param {string | null} options.workspaceId - 目标工作区;null 表示让宿主决定。
|
|
105
|
+
* @param {string | null} options.presetId - 会话模式(= 编辑器基线模式)。
|
|
106
|
+
* @param {string} options.promptText - 首句内容。
|
|
107
|
+
* @param {boolean} options.autoSend - true 表示物化后立刻发送。
|
|
108
|
+
* @param {Function} options.onPhase - 阶段回调('saving' | 'creating' | 'applying')。
|
|
109
|
+
* @returns {Promise<{ok: true, sessionId: string, notes: string, failed: boolean} | {ok: false, message: string}>} 结果。
|
|
110
|
+
*/
|
|
111
|
+
async function runApplyChain(options) {
|
|
112
|
+
const { ctx, templateId, recipe, workspaceId, presetId, promptText, autoSend, onPhase } = options
|
|
113
|
+
const sessionsService = ctx?.get?.('sessions')
|
|
114
|
+
const uiWorkspace = ctx?.get?.('uiWorkspace')
|
|
115
|
+
if (sessionsService === undefined) {
|
|
116
|
+
return { ok: false, message: '宿主没有 sessions 服务,无法新建会话' }
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
try {
|
|
120
|
+
// 1. 先把草稿存成新版本,保证「应用到会话的」就是眼前看到的。
|
|
121
|
+
onPhase('saving')
|
|
122
|
+
await fetchJson(TEMPLATE_ROUTE + '?id=' + encodeURIComponent(templateId), {
|
|
123
|
+
method: 'POST',
|
|
124
|
+
body: JSON.stringify({ recipe }),
|
|
125
|
+
})
|
|
126
|
+
|
|
127
|
+
// 2. 建会话:这一步返回时 agent 已经在册、还没开始任何 turn。
|
|
128
|
+
// 模式就用编辑器的基线模式——提示词模板的覆盖是按它的段落名算的。
|
|
129
|
+
onPhase('creating')
|
|
130
|
+
const sessionId = await sessionsService.create({
|
|
131
|
+
...(workspaceId === null ? {} : { workspaceId }),
|
|
132
|
+
...(presetId === null ? {} : { agentPreset: presetId }),
|
|
133
|
+
})
|
|
134
|
+
|
|
135
|
+
// 3. 物化到这个会话上。
|
|
136
|
+
onPhase('applying')
|
|
137
|
+
const applied = await fetchJson(APPLY_ROUTE, {
|
|
138
|
+
method: 'POST',
|
|
139
|
+
body: JSON.stringify({
|
|
140
|
+
templateId,
|
|
141
|
+
sessionId,
|
|
142
|
+
...(presetId === null ? {} : { presetId }),
|
|
143
|
+
}),
|
|
144
|
+
})
|
|
145
|
+
|
|
146
|
+
// 4. 首句。
|
|
147
|
+
const wantPrompt = promptText.trim().length > 0
|
|
148
|
+
const prompt = wantPrompt
|
|
149
|
+
? await deliverFirstPrompt({ ctx, sessionsService, sessionId, prompt: promptText, autoSend })
|
|
150
|
+
: { promptSent: false, draftFilled: false, promptError: null }
|
|
151
|
+
|
|
152
|
+
const { notes, failed } = summarize({ sessionId, applied, prompt, wantPrompt })
|
|
153
|
+
|
|
154
|
+
// 5. 一切正常才跳走。有失败就停在面板上——跳过去面板卸载,
|
|
155
|
+
// 通知跟着消失,用户永远看不到哪几项没成。
|
|
156
|
+
if (!failed && uiWorkspace?.openSession !== undefined) {
|
|
157
|
+
uiWorkspace.openSession(sessionId)
|
|
158
|
+
}
|
|
159
|
+
const suffix = uiWorkspace?.openSession === undefined
|
|
160
|
+
? ' · 宿主没有 uiWorkspace,没能自动打开,请从侧边栏点进去'
|
|
161
|
+
: ''
|
|
162
|
+
|
|
163
|
+
return { ok: true, sessionId, notes: notes + suffix, failed }
|
|
164
|
+
} catch (cause) {
|
|
165
|
+
return { ok: false, message: cause instanceof Error ? cause.message : String(cause) }
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
return { runApplyChain, deliverFirstPrompt, summarize }
|
|
170
|
+
},
|
|
171
|
+
})
|