@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
|
@@ -0,0 +1,114 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 首请求预演的编排层:条件 → 一份 scope → 装配 → 信封。
|
|
3
|
+
*
|
|
4
|
+
* 这个文件回答的是「一条新会话的第一次请求里,模型到底会收到什么」。
|
|
5
|
+
* 它不创建 Session / Agent,不写 session log,也不改注册表——所有值都是一次
|
|
6
|
+
* 可复现的推导,页面据此把「实测」和「推导」分开标。
|
|
7
|
+
*
|
|
8
|
+
* 「哪些 pre-step 插件会运行」由 `preview-modules.js` 判定:宿主 Loader 行与
|
|
9
|
+
* 目标模式的声明组合任一成立即可,因为 web/desktop profile 的这三条注入都是由
|
|
10
|
+
* preset 挂载的。
|
|
11
|
+
* @module dsh-plugin-console/host/request-preview
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import { acquirePresetScope, previewAssembly } from './assembly-preview.js'
|
|
15
|
+
import { previewEnvelope } from './preview-envelope.js'
|
|
16
|
+
import { resolveConditions } from './preview-conditions.js'
|
|
17
|
+
import { previewMessages } from './preview-messages.js'
|
|
18
|
+
import { resolveModules } from './preview-modules.js'
|
|
19
|
+
import { applyRecipeToAssembly } from './recipe-overlay.js'
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* 用默认模型补上 `assemble()` 里缺失的插值变量。
|
|
23
|
+
*
|
|
24
|
+
* `{{model}}` / `{{provider}}` 由 agent-loop 在真实请求前提供,预演没有 Agent,
|
|
25
|
+
* 所以这里用「默认模型选择」顶替——那正是新建会话会用的模型。
|
|
26
|
+
* @param {object} conditions - 已解析的条件。
|
|
27
|
+
* @returns {object | undefined} 变量覆盖表。
|
|
28
|
+
*/
|
|
29
|
+
function variableOverridesOf(conditions) {
|
|
30
|
+
if (conditions.model === null) return undefined
|
|
31
|
+
return { model: conditions.model.model, provider: conditions.model.provider }
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
/**
|
|
35
|
+
* 预演一次首请求。
|
|
36
|
+
* @param {object} ctx - host 插件上下文。
|
|
37
|
+
* @param {object} options - 客户端上报的条件。
|
|
38
|
+
* @param {string} [options.presetId] - 目标模式。
|
|
39
|
+
* @param {string} [options.workspacePath] - 工作区路径:已注册路径,或任意绝对目录(自定义目录只影响推导)。
|
|
40
|
+
* @param {string} [options.permissionPreset] - 权限预设名。
|
|
41
|
+
* @param {string} [options.clientTimeZone] - 客户端 IANA 时区。
|
|
42
|
+
* @param {string} [options.draft] - 首条消息草稿;决定 user 消息正文与 `/name` 展开。
|
|
43
|
+
* @param {object} [options.recipe] - 提示词模板配方;提供时把覆盖叠加到本次预演。
|
|
44
|
+
* @param {number} [options.now] - 预览时刻(epoch ms),默认当前时间;测试用它固定时间快照。
|
|
45
|
+
* @returns {Promise<object>} 装配结果 + 条件 + 信封 + 消息 + 警告。
|
|
46
|
+
*/
|
|
47
|
+
export async function requestPreview(ctx, options = {}) {
|
|
48
|
+
const conditions = await resolveConditions(ctx, options)
|
|
49
|
+
// 一次预演只挂一份 preset scope:装配与(下一阶段的)skill 快照必须看到同一份链。
|
|
50
|
+
const scope = await acquirePresetScope(ctx, options.presetId)
|
|
51
|
+
try {
|
|
52
|
+
const baseAssembly = await previewAssembly(ctx, {
|
|
53
|
+
presetId: scope.presetId,
|
|
54
|
+
scope,
|
|
55
|
+
variableOverrides: variableOverridesOf(conditions),
|
|
56
|
+
})
|
|
57
|
+
// 模板叠加是纯投影:不注册任何东西,只改这次响应里模型会看到的文字与可见工具。
|
|
58
|
+
const assembly = options.recipe === undefined
|
|
59
|
+
? baseAssembly
|
|
60
|
+
: applyRecipeToAssembly(baseAssembly, options.recipe)
|
|
61
|
+
const { applied: appliedToAssembly = { sections: [], contexts: [], tools: [], appended: false }, ...assemblyView } = assembly
|
|
62
|
+
// 模块可用性必须按「目标模式」判定:agent-instructions / tool-skill / time-context
|
|
63
|
+
// 在 web/desktop profile 里由 preset 挂载,宿主行是 disabled 或不存在。
|
|
64
|
+
const modules = await resolveModules(ctx, scope.presetId)
|
|
65
|
+
const envelope = previewEnvelope(assembly, conditions)
|
|
66
|
+
const messages = await previewMessages(ctx, {
|
|
67
|
+
assembly,
|
|
68
|
+
conditions,
|
|
69
|
+
modules,
|
|
70
|
+
scopeKey: scope.scopeKey,
|
|
71
|
+
now: options.now,
|
|
72
|
+
draft: options.draft,
|
|
73
|
+
recipe: options.recipe,
|
|
74
|
+
})
|
|
75
|
+
const systemTextChars = assembly.systemText.length
|
|
76
|
+
const messageChars = messages.messages.reduce((sum, item) => sum + item.length, 0)
|
|
77
|
+
return {
|
|
78
|
+
...assemblyView,
|
|
79
|
+
conditions: {
|
|
80
|
+
workspace: conditions.workspace,
|
|
81
|
+
permission: conditions.permission,
|
|
82
|
+
model: conditions.model,
|
|
83
|
+
contextWindow: conditions.contextWindow,
|
|
84
|
+
clientTimeZone: conditions.clientTimeZone,
|
|
85
|
+
clientTimeZoneSource: conditions.clientTimeZoneSource,
|
|
86
|
+
},
|
|
87
|
+
envelope,
|
|
88
|
+
messages: messages.messages,
|
|
89
|
+
/** 被条件挡掉、因而没有生成的消息与原因:页面要能回答「为什么没有这一条」。 */
|
|
90
|
+
skippedMessages: messages.skipped,
|
|
91
|
+
/** 模板实际改到了哪些项;预演页与定制页据此显示「已叠加」,不靠猜。 */
|
|
92
|
+
overrides: {
|
|
93
|
+
...appliedToAssembly,
|
|
94
|
+
messages: messages.applied?.messages ?? [],
|
|
95
|
+
catalogEntries: messages.applied?.catalogEntries ?? [],
|
|
96
|
+
skippedMessages: messages.applied?.skipped ?? [],
|
|
97
|
+
},
|
|
98
|
+
// 装配的警告里已经有 scope 的那条;这里追加条件采集与消息采集的。
|
|
99
|
+
warnings: [...assembly.warnings, ...conditions.warnings, ...messages.warnings],
|
|
100
|
+
stats: {
|
|
101
|
+
...assembly.stats,
|
|
102
|
+
// 单列 system 消息的真实长度:`sectionChars` 不含段间 `\n\n`,拿它当合计会低估。
|
|
103
|
+
systemTextChars,
|
|
104
|
+
messageCount: messages.messages.length,
|
|
105
|
+
messageChars,
|
|
106
|
+
// 合计按请求真实的三块算:system 消息 + tools 字段 + 全部 user 消息。
|
|
107
|
+
// runtime-context 已经在 messages 里,所以不加 `contextChars`。
|
|
108
|
+
totalChars: systemTextChars + assembly.stats.toolSchemaChars + messageChars,
|
|
109
|
+
},
|
|
110
|
+
}
|
|
111
|
+
} finally {
|
|
112
|
+
await scope.dispose()
|
|
113
|
+
}
|
|
114
|
+
}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 每会话的启用开关。
|
|
3
|
+
*
|
|
4
|
+
* 设计取自「manifest 不可变,开关独立」:
|
|
5
|
+
* manifest 记「这个会话该应用哪份 recipe」,是创建时的快照;
|
|
6
|
+
* activation 记「现在要不要真的应用它」,是频繁变动的开关。
|
|
7
|
+
*
|
|
8
|
+
* 切换语义(GET 查 / POST 切):
|
|
9
|
+
* 活跃会话关闭 → dispose 当前物化,下一次 assemble 回退到基础组合;
|
|
10
|
+
* 活跃会话开启 → 按 manifest 重新物化;
|
|
11
|
+
* 冷会话 → 只改 activation,等 resume 后由 apply 决定。
|
|
12
|
+
*
|
|
13
|
+
* GET 一次返回全部绑定(会话页要批量渲染开关),POST 只切一个。
|
|
14
|
+
* @module dsh-plugin-console/host/routes/activation
|
|
15
|
+
*/
|
|
16
|
+
|
|
17
|
+
import { jsonError, jsonOk, readJsonBody } from '../http.js'
|
|
18
|
+
import { applyRecipeToSession, clearRecipeForSession } from '../templates/materialize.js'
|
|
19
|
+
import { getManifest, readTemplateBindings, writeActivation } from '../templates/repository.js'
|
|
20
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* @param {object} ctx - host 插件上下文。
|
|
24
|
+
* @param {object} templateState - 模板存储状态。
|
|
25
|
+
* @returns {Function} fetch 处理函数。
|
|
26
|
+
*/
|
|
27
|
+
export function createActivationRoute(ctx, templateState) {
|
|
28
|
+
return async (request) => {
|
|
29
|
+
await ensureTemplateStore(ctx, templateState)
|
|
30
|
+
|
|
31
|
+
if (request.method === 'GET') {
|
|
32
|
+
const bindings = await readTemplateBindings(templateState)
|
|
33
|
+
return jsonOk({ bindings: Object.fromEntries(bindings) })
|
|
34
|
+
}
|
|
35
|
+
|
|
36
|
+
const body = await readJsonBody(request)
|
|
37
|
+
const sessionId = typeof body?.sessionId === 'string' ? body.sessionId : undefined
|
|
38
|
+
if (sessionId === undefined) return jsonError(400, 'missing sessionId')
|
|
39
|
+
// enabled 必须是显式布尔值:省略不等于「关」,那会把写错参数变成静默关闭。
|
|
40
|
+
if (typeof body?.enabled !== 'boolean') return jsonError(400, 'enabled 必须是 true 或 false')
|
|
41
|
+
const enabled = body.enabled
|
|
42
|
+
|
|
43
|
+
const record = await writeActivation(templateState, sessionId, enabled)
|
|
44
|
+
|
|
45
|
+
// 先看这个会话有没有绑定模板——没有的话开关只是个空标记,
|
|
46
|
+
// 不值得去动 agent。仍然写下来,方便用户表达「以后也别应用」。
|
|
47
|
+
const manifest = getManifest(templateState, sessionId)
|
|
48
|
+
if (manifest === undefined) {
|
|
49
|
+
return jsonOk({
|
|
50
|
+
sessionId,
|
|
51
|
+
enabled,
|
|
52
|
+
updatedAt: record.updatedAt,
|
|
53
|
+
applied: false,
|
|
54
|
+
reason: '这个会话没有绑定提示词定制模板,开关已记录但没有可撤销的内容',
|
|
55
|
+
})
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
const live = ctx.get('agents')?.get?.(sessionId)
|
|
59
|
+
if (live === undefined) {
|
|
60
|
+
return jsonOk({
|
|
61
|
+
sessionId,
|
|
62
|
+
enabled,
|
|
63
|
+
updatedAt: record.updatedAt,
|
|
64
|
+
applied: false,
|
|
65
|
+
live: false,
|
|
66
|
+
reason: '会话未激活,开关已记录;resume 时按这个状态决定是否应用',
|
|
67
|
+
})
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
if (!enabled) {
|
|
71
|
+
const cleared = await clearRecipeForSession(sessionId)
|
|
72
|
+
return jsonOk({
|
|
73
|
+
sessionId,
|
|
74
|
+
enabled,
|
|
75
|
+
updatedAt: record.updatedAt,
|
|
76
|
+
applied: false,
|
|
77
|
+
live: true,
|
|
78
|
+
cleared,
|
|
79
|
+
note: '已撤销注册;当前 step 的请求已冻结,从下一步开始回退到基础组合',
|
|
80
|
+
})
|
|
81
|
+
}
|
|
82
|
+
|
|
83
|
+
const presetId = typeof body?.presetId === 'string' ? body.presetId : undefined
|
|
84
|
+
const result = await applyRecipeToSession(ctx, sessionId, manifest.recipe, presetId)
|
|
85
|
+
return jsonOk({
|
|
86
|
+
sessionId,
|
|
87
|
+
enabled,
|
|
88
|
+
updatedAt: record.updatedAt,
|
|
89
|
+
live: true,
|
|
90
|
+
applied: result.applied === true,
|
|
91
|
+
applied0: result.applied0,
|
|
92
|
+
errors: result.errors,
|
|
93
|
+
reason: result.reason,
|
|
94
|
+
})
|
|
95
|
+
}
|
|
96
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 工具活动:GET ?days=7&limit=20。
|
|
3
|
+
*
|
|
4
|
+
* 与 session-influence 一样,读日志的成本随会话数增长,所以单独一条路由、
|
|
5
|
+
* 带时间窗与会话上限;不可读时返回 200 + `{available:false, reason}`。
|
|
6
|
+
* @module dsh-plugin-console/host/routes/activity
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import { readActivity } from '../activity.js'
|
|
10
|
+
import { jsonOk, searchParam } from '../http.js'
|
|
11
|
+
|
|
12
|
+
/**
|
|
13
|
+
* @param {object} ctx - host 插件上下文。
|
|
14
|
+
* @returns {Function} fetch 处理函数。
|
|
15
|
+
*/
|
|
16
|
+
export function createActivityRoute(ctx) {
|
|
17
|
+
return async (request) => {
|
|
18
|
+
const days = searchParam(request, 'days')
|
|
19
|
+
const limit = searchParam(request, 'limit')
|
|
20
|
+
return jsonOk(await readActivity(ctx, { days, limit }))
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 把模板应用到会话。
|
|
3
|
+
*
|
|
4
|
+
* 两种用法:
|
|
5
|
+
* `{ templateId, sessionId }` 物化到一个已经活着的会话;
|
|
6
|
+
* `{ templateId, workspaceId?, cwd?, presetId? }` 先建会话,再在首个 turn 前物化。
|
|
7
|
+
*
|
|
8
|
+
* 后者之所以成立,是因为 agents.create() 在返回前就已经发布了这个 agent
|
|
9
|
+
* (setup 组合完 → announce → create 解决),而 turn 要等 prompt 才开。
|
|
10
|
+
* 所以「建会话后立刻物化」正好落在「首个 turn 之前」这个窗口里。
|
|
11
|
+
* @module dsh-plugin-console/host/routes/apply
|
|
12
|
+
*/
|
|
13
|
+
|
|
14
|
+
import { jsonError, jsonOk, readJsonBody } from '../http.js'
|
|
15
|
+
import { applyRecipeToSession } from '../templates/materialize.js'
|
|
16
|
+
import { getTemplate, latestRecipe, putManifest } from '../templates/repository.js'
|
|
17
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
18
|
+
|
|
19
|
+
/**
|
|
20
|
+
* @param {object} ctx - host 插件上下文。
|
|
21
|
+
* @param {object} templateState - 模板存储状态。
|
|
22
|
+
* @returns {Function} fetch 处理函数。
|
|
23
|
+
*/
|
|
24
|
+
export function createApplyRoute(ctx, templateState) {
|
|
25
|
+
return async (request) => {
|
|
26
|
+
await ensureTemplateStore(ctx, templateState)
|
|
27
|
+
const body = await readJsonBody(request)
|
|
28
|
+
const templateId = typeof body?.templateId === 'string' ? body.templateId : undefined
|
|
29
|
+
let sessionId = typeof body?.sessionId === 'string' ? body.sessionId : undefined
|
|
30
|
+
if (templateId === undefined) return jsonError(400, 'missing templateId')
|
|
31
|
+
|
|
32
|
+
const head = getTemplate(templateState, templateId)
|
|
33
|
+
if (head === undefined) return jsonError(404, 'template not found')
|
|
34
|
+
const latest = latestRecipe(templateState, templateId)
|
|
35
|
+
if (latest === undefined) return jsonError(400, 'template has no revision')
|
|
36
|
+
|
|
37
|
+
const presetId = typeof body?.presetId === 'string' ? body.presetId : undefined
|
|
38
|
+
// manifest 是快照,不只是「指向模板的指针」:recipe 与名字都复制一份。
|
|
39
|
+
// 之后模板改名、改版、甚至删除,都不回写已应用的会话。
|
|
40
|
+
const manifest = {
|
|
41
|
+
schemaVersion: 1,
|
|
42
|
+
sessionId: sessionId ?? '',
|
|
43
|
+
source: { templateId, revision: latest.revision, templateName: head.name },
|
|
44
|
+
recipe: latest.recipe,
|
|
45
|
+
createdAt: Date.now(),
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
// 没有指名会话时现建一个:这样「模板」才有地方生效。
|
|
49
|
+
let created = false
|
|
50
|
+
if (sessionId === undefined) {
|
|
51
|
+
const controller = ctx.get('sessionController')
|
|
52
|
+
if (controller === undefined || typeof controller.create !== 'function') {
|
|
53
|
+
return jsonError(503, 'sessionController 服务缺席,无法新建会话')
|
|
54
|
+
}
|
|
55
|
+
const result = await controller.create({
|
|
56
|
+
...(typeof body?.workspaceId === 'string' ? { workspaceId: body.workspaceId } : {}),
|
|
57
|
+
...(typeof body?.cwd === 'string' ? { cwd: body.cwd } : {}),
|
|
58
|
+
...(presetId === undefined ? {} : { agentPreset: presetId }),
|
|
59
|
+
})
|
|
60
|
+
sessionId = result?.sessionId
|
|
61
|
+
created = true
|
|
62
|
+
if (typeof sessionId !== 'string') {
|
|
63
|
+
return jsonError(500, '新建会话未返回 sessionId')
|
|
64
|
+
}
|
|
65
|
+
manifest.sessionId = sessionId
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
await putManifest(templateState, sessionId, manifest)
|
|
69
|
+
const result = await applyRecipeToSession(ctx, sessionId, manifest.recipe, presetId)
|
|
70
|
+
if (result.applied !== true) {
|
|
71
|
+
return jsonOk({
|
|
72
|
+
applied: false,
|
|
73
|
+
live: false,
|
|
74
|
+
created,
|
|
75
|
+
sessionId,
|
|
76
|
+
reason: result.reason,
|
|
77
|
+
manifest,
|
|
78
|
+
})
|
|
79
|
+
}
|
|
80
|
+
manifest.applied = result.applied0
|
|
81
|
+
manifest.errors = result.errors
|
|
82
|
+
await putManifest(templateState, sessionId, manifest)
|
|
83
|
+
return jsonOk({
|
|
84
|
+
applied: true,
|
|
85
|
+
live: true,
|
|
86
|
+
created,
|
|
87
|
+
sessionId,
|
|
88
|
+
applied0: result.applied0,
|
|
89
|
+
errors: result.errors,
|
|
90
|
+
manifest,
|
|
91
|
+
})
|
|
92
|
+
}
|
|
93
|
+
}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 清理模板数据。
|
|
3
|
+
*
|
|
4
|
+
* POST `{ scope: 'session', sessionId }` → 只清该会话的绑定与开关;
|
|
5
|
+
* POST `{ scope: 'workspace', workspaceId }` → 只清该工作区的绑定与开关;
|
|
6
|
+
* POST `{ scope: 'all' }` → 清空全部并删除存储文件。
|
|
7
|
+
*
|
|
8
|
+
* 三种范围都不撤销正在运行的会话:清理的是持久记录,运行时注册保留到会话结束。
|
|
9
|
+
* @module dsh-plugin-console/host/routes/cleanup
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
import { jsonError, jsonOk, readJsonBody } from '../http.js'
|
|
13
|
+
import { clearAllTemplateData, clearSessionTemplateData, clearWorkspaceTemplateData } from '../templates/cleanup.js'
|
|
14
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @param {object} ctx - host 插件上下文。
|
|
18
|
+
* @param {object} templateState - 模板存储状态。
|
|
19
|
+
* @returns {Function} fetch 处理函数。
|
|
20
|
+
*/
|
|
21
|
+
export function createCleanupRoute(ctx, templateState) {
|
|
22
|
+
return async (request) => {
|
|
23
|
+
const body = await readJsonBody(request)
|
|
24
|
+
const scope = body?.scope
|
|
25
|
+
|
|
26
|
+
if (scope === 'session') {
|
|
27
|
+
await ensureTemplateStore(ctx, templateState)
|
|
28
|
+
const sessionId = typeof body?.sessionId === 'string' ? body.sessionId : undefined
|
|
29
|
+
if (sessionId === undefined) return jsonError(400, 'missing sessionId')
|
|
30
|
+
const result = await clearSessionTemplateData(templateState, sessionId)
|
|
31
|
+
return jsonOk({ scope, ...result, liveSessionsUntouched: true })
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
if (scope === 'workspace') {
|
|
35
|
+
await ensureTemplateStore(ctx, templateState)
|
|
36
|
+
const workspaceId = typeof body?.workspaceId === 'string' ? body.workspaceId : undefined
|
|
37
|
+
if (workspaceId === undefined) return jsonError(400, 'missing workspaceId')
|
|
38
|
+
const result = await clearWorkspaceTemplateData(ctx, templateState, workspaceId)
|
|
39
|
+
if (result === undefined) return jsonError(404, 'workspace not found')
|
|
40
|
+
return jsonOk({ scope, workspaceId, ...result, liveSessionsUntouched: true })
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
if (scope === 'all') {
|
|
44
|
+
// 打开失败也要能清:坏记录不该把「删除存储文件」这个恢复出口一起挡住。
|
|
45
|
+
let storeError
|
|
46
|
+
try {
|
|
47
|
+
await ensureTemplateStore(ctx, templateState)
|
|
48
|
+
} catch (error) {
|
|
49
|
+
storeError = error instanceof Error ? error.message : String(error)
|
|
50
|
+
}
|
|
51
|
+
const result = await clearAllTemplateData(ctx, templateState)
|
|
52
|
+
return jsonOk({
|
|
53
|
+
scope,
|
|
54
|
+
...result,
|
|
55
|
+
...(storeError === undefined ? {} : { storeError }),
|
|
56
|
+
liveSessionsUntouched: true,
|
|
57
|
+
})
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
return jsonError(400, 'scope must be "session", "workspace" or "all"')
|
|
61
|
+
}
|
|
62
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 控制:POST `{ action, rowId, sessionId?, confirmed }`。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/control
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { controlPlugin } from '../control.js'
|
|
7
|
+
import { jsonError, jsonOk, readJsonBody } from '../http.js'
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* @param {object} ctx - host 插件上下文。
|
|
11
|
+
* @param {object} templateState - 模板存储状态。
|
|
12
|
+
* @returns {Function} fetch 处理函数。
|
|
13
|
+
*/
|
|
14
|
+
export function createControlRoute(ctx, templateState) {
|
|
15
|
+
return async (request) => {
|
|
16
|
+
const body = await readJsonBody(request)
|
|
17
|
+
if (typeof body?.action !== 'string') return jsonError(400, 'missing action')
|
|
18
|
+
if (typeof body?.rowId !== 'string') return jsonError(400, 'missing rowId')
|
|
19
|
+
const result = await controlPlugin(ctx, templateState, body)
|
|
20
|
+
return jsonOk(result)
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 禁用效果预演:GET ?id=<rowId|entryId>。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/disable-preview
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { readDisablePreview } from '../disable-preview.js'
|
|
7
|
+
import { jsonError, jsonOk, searchParam } from '../http.js'
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* @param {object} ctx - host 插件上下文。
|
|
11
|
+
* @returns {Function} fetch 处理函数。
|
|
12
|
+
*/
|
|
13
|
+
export function createDisablePreviewRoute(ctx) {
|
|
14
|
+
return async (request) => {
|
|
15
|
+
const id = searchParam(request, 'id')
|
|
16
|
+
if (id === undefined) return jsonError(400, 'missing id')
|
|
17
|
+
return jsonOk(await readDisablePreview(ctx, id))
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 影响预览:GET ?id=<rowId>。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/impact
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { jsonError, jsonOk, searchParam } from '../http.js'
|
|
7
|
+
import { readImpact } from '../impact.js'
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* @param {object} ctx - host 插件上下文。
|
|
11
|
+
* @returns {Function} fetch 处理函数。
|
|
12
|
+
*/
|
|
13
|
+
export function createImpactRoute(ctx) {
|
|
14
|
+
return async (request) => {
|
|
15
|
+
const id = searchParam(request, 'id')
|
|
16
|
+
if (id === undefined) return jsonError(400, 'missing id')
|
|
17
|
+
return jsonOk(await readImpact(ctx, id))
|
|
18
|
+
}
|
|
19
|
+
}
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 控制审计:GET ?limit=20。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/operations
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { jsonOk, searchParam } from '../http.js'
|
|
7
|
+
import { listOperations } from '../templates/repository.js'
|
|
8
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* @param {object} ctx - host 插件上下文。
|
|
12
|
+
* @param {object} templateState - 模板存储状态。
|
|
13
|
+
* @returns {Function} fetch 处理函数。
|
|
14
|
+
*/
|
|
15
|
+
export function createOperationsRoute(ctx, templateState) {
|
|
16
|
+
return async (request) => {
|
|
17
|
+
await ensureTemplateStore(ctx, templateState)
|
|
18
|
+
const raw = Number(searchParam(request, 'limit'))
|
|
19
|
+
const limit = Number.isFinite(raw) ? Math.min(100, Math.max(1, Math.trunc(raw))) : 20
|
|
20
|
+
return jsonOk({ operations: listOperations(templateState, limit) })
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 首请求预演:POST `{ presetId, workspacePath, permissionPreset, clientTimeZone }`
|
|
3
|
+
* → 一次首请求的完整构造。
|
|
4
|
+
*
|
|
5
|
+
* 用 POST 而不是 GET,因为这是一次「按选择求值」的计算,不是资源读取。
|
|
6
|
+
* 本文件只做参数解析与响应序列化:条件如何解析、装配怎么做,见
|
|
7
|
+
* `host/request-preview.js`。
|
|
8
|
+
* @module dsh-plugin-console/host/routes/preview
|
|
9
|
+
*/
|
|
10
|
+
|
|
11
|
+
import { jsonError, jsonOk, readJsonBody } from '../http.js'
|
|
12
|
+
import { requestPreview } from '../request-preview.js'
|
|
13
|
+
|
|
14
|
+
/** 草稿上限:预演要把它原样放进响应,超长文本会把整页响应撑大。 */
|
|
15
|
+
const MAX_DRAFT_LENGTH = 20000
|
|
16
|
+
|
|
17
|
+
/** 模板 recipe 上限:预演只做投影,但不应成为一条任意大的请求体通道。 */
|
|
18
|
+
const MAX_RECIPE_JSON = 512 * 1024
|
|
19
|
+
|
|
20
|
+
/**
|
|
21
|
+
* 只把非空字符串当作条件;缺省、null、数字一律视为「没有提供」,
|
|
22
|
+
* 由宿主按默认值解析并给出警告。空 body 因此仍然可用。
|
|
23
|
+
* @param {unknown} value - 请求体里的字段。
|
|
24
|
+
* @returns {string | undefined} 条件值。
|
|
25
|
+
*/
|
|
26
|
+
function conditionText(value) {
|
|
27
|
+
return typeof value === 'string' && value.length > 0 ? value : undefined
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* @param {object} ctx - host 插件上下文。
|
|
32
|
+
* @returns {Function} fetch 处理函数。
|
|
33
|
+
*/
|
|
34
|
+
export function createPreviewRoute(ctx) {
|
|
35
|
+
return async (request) => {
|
|
36
|
+
const body = await readJsonBody(request)
|
|
37
|
+
const draft = conditionText(body?.draft)
|
|
38
|
+
if (draft !== undefined && draft.length > MAX_DRAFT_LENGTH) {
|
|
39
|
+
return jsonError(400, `草稿超过 ${MAX_DRAFT_LENGTH} 个字符`)
|
|
40
|
+
}
|
|
41
|
+
const recipe = body?.recipe
|
|
42
|
+
if (recipe !== undefined && (recipe === null || typeof recipe !== 'object' || Array.isArray(recipe))) {
|
|
43
|
+
return jsonError(400, 'recipe 必须是对象')
|
|
44
|
+
}
|
|
45
|
+
if (recipe !== undefined && JSON.stringify(recipe).length > MAX_RECIPE_JSON) {
|
|
46
|
+
return jsonError(400, `recipe 超过 ${MAX_RECIPE_JSON} 字节`)
|
|
47
|
+
}
|
|
48
|
+
const result = await requestPreview(ctx, {
|
|
49
|
+
presetId: conditionText(body?.presetId),
|
|
50
|
+
workspacePath: conditionText(body?.workspacePath),
|
|
51
|
+
permissionPreset: conditionText(body?.permissionPreset),
|
|
52
|
+
clientTimeZone: conditionText(body?.clientTimeZone),
|
|
53
|
+
draft,
|
|
54
|
+
recipe,
|
|
55
|
+
})
|
|
56
|
+
return jsonOk(result)
|
|
57
|
+
}
|
|
58
|
+
}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 单会话的实际请求摘要:GET ?id=<sessionId>。
|
|
3
|
+
*
|
|
4
|
+
* 单独一条路由而不是塞进快照:要把日志读全,成本随会话长度增长;只有用户
|
|
5
|
+
* 展开某个会话时才值得付。不可读时仍返回 200 + `{available:false, reason}`,
|
|
6
|
+
* 让界面区分「没有数据」和「请求失败」。
|
|
7
|
+
* @module dsh-plugin-console/host/routes/session-influence
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
import { jsonError, jsonOk, searchParam } from '../http.js'
|
|
11
|
+
import { readSessionInfluence } from '../session-influence.js'
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* @param {object} ctx - host 插件上下文。
|
|
15
|
+
* @returns {Function} fetch 处理函数。
|
|
16
|
+
*/
|
|
17
|
+
export function createSessionInfluenceRoute(ctx) {
|
|
18
|
+
return async (request) => {
|
|
19
|
+
const id = searchParam(request, 'id')
|
|
20
|
+
if (id === undefined) return jsonError(400, 'missing id')
|
|
21
|
+
return jsonOk(await readSessionInfluence(ctx, id))
|
|
22
|
+
}
|
|
23
|
+
}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 快照:GET → 整份插件树投影(含模板绑定)。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/snapshot
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { jsonOk } from '../http.js'
|
|
7
|
+
import { readSnapshot } from '../snapshot.js'
|
|
8
|
+
import { snapshotExtras } from '../templates/repository.js'
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* @param {object} ctx - host 插件上下文。
|
|
12
|
+
* @param {object} templateState - 模板存储状态。
|
|
13
|
+
* @returns {Function} fetch 处理函数。
|
|
14
|
+
*/
|
|
15
|
+
export function createSnapshotRoute(ctx, templateState) {
|
|
16
|
+
return async () => {
|
|
17
|
+
// 模板存储不可用时只丢绑定信息,不连累其余四个视图。
|
|
18
|
+
const extras = await snapshotExtras(ctx, templateState)
|
|
19
|
+
return jsonOk(await readSnapshot(ctx, extras))
|
|
20
|
+
}
|
|
21
|
+
}
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 单模板:GET 详情 + 历史,POST 保存配方或改名,DELETE 连历史一起删。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/template
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { jsonError, jsonOk, readJsonBody, searchParam } from '../http.js'
|
|
7
|
+
import {
|
|
8
|
+
deleteTemplate,
|
|
9
|
+
getTemplate,
|
|
10
|
+
renameTemplate,
|
|
11
|
+
revisionsOf,
|
|
12
|
+
saveRecipe,
|
|
13
|
+
} from '../templates/repository.js'
|
|
14
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* @param {object} ctx - host 插件上下文。
|
|
18
|
+
* @param {object} templateState - 模板存储状态。
|
|
19
|
+
* @returns {Function} fetch 处理函数。
|
|
20
|
+
*/
|
|
21
|
+
export function createTemplateRoute(ctx, templateState) {
|
|
22
|
+
return async (request) => {
|
|
23
|
+
await ensureTemplateStore(ctx, templateState)
|
|
24
|
+
const id = searchParam(request, 'id')
|
|
25
|
+
if (id === undefined) return jsonError(400, 'missing id')
|
|
26
|
+
|
|
27
|
+
if (request.method === 'DELETE') {
|
|
28
|
+
const head = getTemplate(templateState, id)
|
|
29
|
+
if (head === undefined) return jsonError(404, 'template not found')
|
|
30
|
+
const removed = await deleteTemplate(templateState, id)
|
|
31
|
+
return jsonOk({ deleted: id, ...removed })
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
if (request.method === 'POST') {
|
|
35
|
+
const body = await readJsonBody(request)
|
|
36
|
+
const head = getTemplate(templateState, id)
|
|
37
|
+
if (head === undefined) return jsonError(404, 'template not found')
|
|
38
|
+
|
|
39
|
+
// 改名:只动 name,不产生新记录。
|
|
40
|
+
if (typeof body?.name === 'string') {
|
|
41
|
+
const name = body.name.trim()
|
|
42
|
+
if (name.length === 0) return jsonError(400, '提示词模板名称不能为空')
|
|
43
|
+
return jsonOk({ template: await renameTemplate(templateState, id, head, name) })
|
|
44
|
+
}
|
|
45
|
+
|
|
46
|
+
// 保存配方:覆盖当前内容。
|
|
47
|
+
return jsonOk(await saveRecipe(templateState, id, head, body?.recipe))
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
const head = getTemplate(templateState, id)
|
|
51
|
+
if (head === undefined) return jsonError(404, 'template not found')
|
|
52
|
+
return jsonOk({ template: head, revisions: revisionsOf(templateState, id) })
|
|
53
|
+
}
|
|
54
|
+
}
|
|
@@ -0,0 +1,28 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* 模板列表:GET 列出,POST 新建。
|
|
3
|
+
* @module dsh-plugin-console/host/routes/templates
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { jsonOk, readJsonBody } from '../http.js'
|
|
7
|
+
import { createTemplate, listTemplates } from '../templates/repository.js'
|
|
8
|
+
import { ensureTemplateStore } from '../templates/store.js'
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* @param {object} ctx - host 插件上下文。
|
|
12
|
+
* @param {object} templateState - 模板存储状态。
|
|
13
|
+
* @returns {Function} fetch 处理函数。
|
|
14
|
+
*/
|
|
15
|
+
export function createTemplatesRoute(ctx, templateState) {
|
|
16
|
+
return async (request) => {
|
|
17
|
+
await ensureTemplateStore(ctx, templateState)
|
|
18
|
+
if (request.method === 'POST') {
|
|
19
|
+
const body = await readJsonBody(request)
|
|
20
|
+
const template = await createTemplate(templateState, typeof body?.name === 'string' ? body.name : undefined)
|
|
21
|
+
return jsonOk({ template })
|
|
22
|
+
}
|
|
23
|
+
return jsonOk({
|
|
24
|
+
templates: listTemplates(templateState),
|
|
25
|
+
persistent: templateState.domain !== undefined,
|
|
26
|
+
})
|
|
27
|
+
}
|
|
28
|
+
}
|