dsh-prompt-customizer 0.4.0 → 0.4.2

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.
@@ -1,423 +1,434 @@
1
- /**
2
- * dsh-prompt-customizer — 浏览器端(TypeScript 源码)。
3
- *
4
- * 注册一个「提示词定制」设置分区(侧边栏入口)及插件设置卡片。面板从宿主
5
- * 的 `/api/prompt-customizer/inventory` 拉取当前生效的段 / 工具清单,让用户
6
- * 屏蔽、替换、注入提示词段并隐藏工具。所有写入都走绑定的设置作用域
7
- * (`prompt-customizer` 命名空间),实时生效。
8
- *
9
- * 由 tsdown 打包为 client/client.js(__ModuleLoader__ factory bundle);
10
- * 唯一的外部依赖是 loader 模块表中的 react 入口。
11
- */
12
- import { createElement as h, useEffect, useRef, useState, type ReactElement } from 'react'
13
- import { DICT, type Translate } from './locales.ts'
14
- import { s } from './styles.ts'
15
- import type { AgentPresetInfo, Config, Inventory, PhaseViewKey, Preview } from './types.ts'
16
- import { editView, type ConfigPatch } from './presets.ts'
17
- import { SectionsTab } from './SectionsTab.tsx'
18
- import { ToolsTab } from './ToolsTab.tsx'
19
- import { PresetsTab } from './PresetsTab.tsx'
20
- import { PreviewTab } from './PreviewTab.tsx'
21
-
22
- const NS = 'prompt-customizer'
23
- const INVENTORY_URL = '/api/prompt-customizer/inventory'
24
- const AGENT_PRESETS_URL = '/api/prompt-customizer/agent-presets'
25
- const CONFIG_URL = '/api/prompt-customizer/config'
26
- const CONFIG_SET_URL = '/api/prompt-customizer/config/set'
27
- const CONFIG_UNSET_URL = '/api/prompt-customizer/config/unset'
28
- const CONFIG_APPLY_URL = '/api/prompt-customizer/config/apply'
29
- const CONFIG_RESET_URL = '/api/prompt-customizer/config/reset'
30
- const PRESETS_CREATE_URL = '/api/prompt-customizer/presets'
31
- const PREVIEW_URL = '/api/prompt-customizer/preview'
32
-
33
- /** 三阶段预览装配(模型视角):提示词/工具/预览 Tab 的统一数据源。 */
34
- type PhaseViews = Record<PhaseViewKey, Preview | null>
35
-
36
- /** 三套名义装配的共享布局:顺序固定,refresh 按此并行拉取。 */
37
- const VIEW_KEYS: PhaseViewKey[] = ['bootstrap', 'compaction', 'active']
38
-
39
- export const name = 'prompt-customizer'
40
- export const inject = ['slots', 'locale']
41
-
42
- /** 本插件用到的客户端 cordis 上下文的最小子集。 */
43
- interface ClientContext {
44
- effect(callback: () => unknown, label?: string): void
45
- locale: {
46
- register(namespace: string, dicts: { zh: Record<string, string>; en: Record<string, string> }): unknown
47
- bind(namespace: string): Translate
48
- }
49
- inject(services: string[], callback: (scoped: SlotsHost) => void): void
50
- }
51
-
52
- /** 设置分区需要的宿主能力面(插槽注册)。 */
53
- interface SlotsHost {
54
- slots: {
55
- inject(name: string, register: () => unknown): void
56
- register(meta: Record<string, unknown>, render: () => unknown): unknown
57
- }
58
- }
59
-
60
- export function apply(ctx: ClientContext): void {
61
- ctx.effect(() => ctx.locale.register(NS, DICT), 'prompt-customizer: locale')
62
- const t = ctx.locale.bind(NS)
63
-
64
- // 注册为独立的设置分区(侧边栏菜单项),面板只出现在「提示词定制」下,
65
- // 而不是作为卡片塞进「插件」设置列表。配置读写走插件自有路由(宿主端的
66
- // config.yaml),不再依赖 settings 传输层。
67
- ctx.inject(['slots'], (scoped) => {
68
- scoped.slots.inject('settings.section', () => scoped.slots.register({
69
- name: 'settings.section',
70
- id: 'prompt-customizer',
71
- order: 50,
72
- label: () => t('nav'),
73
- locale: NS,
74
- inject: () => ({ t }),
75
- }, () => h(Panel, { t })))
76
- })
77
- }
78
-
79
- // ── 根面板 ────────────────────────────────────────────────────────────────
80
-
81
- /**
82
- * 面板根组件:拉取配置与清单、维护 Tab 状态,把各 Tab 子视图装配起来。
83
- * 配置来自插件自有 /config 路由;清单来自 /inventory,可通过「刷新」按钮
84
- * 手动重取。提示词/工具 Tab 的编辑只改内存草稿,由「保存」按钮经
85
- * /config/apply 一次写盘(写错的配置不点保存就不会进文件)。
86
- */
87
-
88
- /** 可编辑的配置字段(含每阶段独立段屏蔽名单)。 */
89
- type EditField = 'sections' | 'sectionsBootstrap' | 'sectionsCompaction' | 'replace' | 'inject' | 'tools'
90
-
91
- /** 编辑域草稿:提示词/工具 Tab 共享的未保存字段 + 脏标记。
92
- * 只记录用户实际编辑过的字段(首次编辑只写那一项),保存时也只提交这些
93
- * 字段 —— 未编辑的字段继续回落全局 / 继承,避免一次保存冻结全部继承值。 */
94
- interface EditDraft {
95
- sections?: Config['sections']
96
- sectionsBootstrap?: Config['sectionsBootstrap']
97
- sectionsCompaction?: Config['sectionsCompaction']
98
- replace?: Config['replace']
99
- inject?: Config['inject']
100
- tools?: Config['tools']
101
- dirty: boolean
102
- }
103
-
104
- function Panel({ t }: { t: Translate }): ReactElement {
105
- const [cfg, setCfg] = useState<Config | null>(null)
106
- const [inv, setInv] = useState<Inventory | null>(null)
107
- // 三阶段预览装配:模型视角的唯一数据源(加载中为 null)。
108
- const [phases, setPhases] = useState<PhaseViews | null>(null)
109
- const [agentPresets, setAgentPresets] = useState<AgentPresetInfo[]>([])
110
- const [tab, setTab] = useState<'sections' | 'tools' | 'presets' | 'preview'>('sections')
111
- const [error, setError] = useState<string | null>(null)
112
- const [refreshId, setRefreshId] = useState(0)
113
- // 编辑目标:undefined = 全局默认;字符串 = agent 预设 id(字段级 override)。
1
+ /**
2
+ * dsh-prompt-customizer — 浏览器端(TypeScript 源码)。
3
+ *
4
+ * 注册一个「提示词定制」设置分区(侧边栏入口)及插件设置卡片。面板从宿主
5
+ * 的 `/api/prompt-customizer/inventory` 拉取当前生效的段 / 工具清单,让用户
6
+ * 屏蔽、替换、注入提示词段并隐藏工具。所有写入都走绑定的设置作用域
7
+ * (`prompt-customizer` 命名空间),实时生效。
8
+ *
9
+ * 由 tsdown 打包为 client/client.js(__ModuleLoader__ factory bundle);
10
+ * 唯一的外部依赖是 loader 模块表中的 react 入口。
11
+ */
12
+ import { createElement as h, useEffect, useRef, useState, type ReactElement } from 'react'
13
+ import { DICT, type Translate } from './locales.ts'
14
+ import { s } from './styles.ts'
15
+ import type { AgentPresetInfo, Config, Inventory, PhaseViewKey, Preview } from './types.ts'
16
+ import { editView, type ConfigPatch } from './presets.ts'
17
+ import { SectionsTab } from './SectionsTab.tsx'
18
+ import { ToolsTab } from './ToolsTab.tsx'
19
+ import { PresetsTab } from './PresetsTab.tsx'
20
+ import { PreviewTab } from './PreviewTab.tsx'
21
+
22
+ const NS = 'prompt-customizer'
23
+ const INVENTORY_URL = '/api/prompt-customizer/inventory'
24
+ const AGENT_PRESETS_URL = '/api/prompt-customizer/agent-presets'
25
+ const CONFIG_URL = '/api/prompt-customizer/config'
26
+ const CONFIG_SET_URL = '/api/prompt-customizer/config/set'
27
+ const CONFIG_UNSET_URL = '/api/prompt-customizer/config/unset'
28
+ const CONFIG_APPLY_URL = '/api/prompt-customizer/config/apply'
29
+ const CONFIG_RESET_URL = '/api/prompt-customizer/config/reset'
30
+ const PRESETS_CREATE_URL = '/api/prompt-customizer/presets'
31
+ const PREVIEW_URL = '/api/prompt-customizer/preview'
32
+
33
+ /** 三阶段预览装配(模型视角):提示词/工具/预览 Tab 的统一数据源。 */
34
+ type PhaseViews = Record<PhaseViewKey, Preview | null>
35
+
36
+ /** 三套名义装配的共享布局:顺序固定,refresh 按此并行拉取。 */
37
+ const VIEW_KEYS: PhaseViewKey[] = ['bootstrap', 'compaction', 'active']
38
+
39
+ export const name = 'prompt-customizer'
40
+ export const inject = ['slots', 'locale']
41
+
42
+ /** 本插件用到的客户端 cordis 上下文的最小子集。 */
43
+ interface ClientContext {
44
+ effect(callback: () => unknown, label?: string): void
45
+ locale: {
46
+ register(namespace: string, dicts: { zh: Record<string, string>; en: Record<string, string> }): unknown
47
+ bind(namespace: string): Translate
48
+ }
49
+ inject(services: string[], callback: (scoped: SlotsHost) => void): void
50
+ }
51
+
52
+ /** 设置分区需要的宿主能力面(插槽注册)。 */
53
+ interface SlotsHost {
54
+ slots: {
55
+ inject(name: string, register: () => unknown): void
56
+ register(meta: Record<string, unknown>, render: () => unknown): unknown
57
+ }
58
+ }
59
+
60
+ export function apply(ctx: ClientContext): void {
61
+ ctx.effect(() => ctx.locale.register(NS, DICT), 'prompt-customizer: locale')
62
+ const t = ctx.locale.bind(NS)
63
+
64
+ // 注册为独立的设置分区(侧边栏菜单项),面板只出现在「提示词定制」下,
65
+ // 而不是作为卡片塞进「插件」设置列表。配置读写走插件自有路由(宿主端的
66
+ // config.yaml),不再依赖 settings 传输层。
67
+ ctx.inject(['slots'], (scoped) => {
68
+ scoped.slots.inject('settings.section', () => scoped.slots.register({
69
+ name: 'settings.section',
70
+ id: 'prompt-customizer',
71
+ order: 50,
72
+ label: () => t('nav'),
73
+ locale: NS,
74
+ inject: () => ({ t }),
75
+ }, () => h(Panel, { t })))
76
+ })
77
+ }
78
+
79
+ // ── 根面板 ────────────────────────────────────────────────────────────────
80
+
81
+ /**
82
+ * 面板根组件:拉取配置与清单、维护 Tab 状态,把各 Tab 子视图装配起来。
83
+ * 配置来自插件自有 /config 路由;清单来自 /inventory,可通过「刷新」按钮
84
+ * 手动重取。提示词/工具 Tab 的编辑只改内存草稿,由「保存」按钮经
85
+ * /config/apply 一次写盘(写错的配置不点保存就不会进文件)。
86
+ */
87
+
88
+ /** 可编辑的配置字段(含每阶段独立段屏蔽名单)。 */
89
+ type EditField = 'sections' | 'sectionsBootstrap' | 'sectionsCompaction' | 'replace' | 'inject' | 'tools'
90
+
91
+ /** 编辑域草稿:提示词/工具 Tab 共享的未保存字段 + 脏标记。
92
+ * 只记录用户实际编辑过的字段(首次编辑只写那一项),保存时也只提交这些
93
+ * 字段 —— 未编辑的字段继续回落全局 / 继承,避免一次保存冻结全部继承值。 */
94
+ interface EditDraft {
95
+ sections?: Config['sections']
96
+ sectionsBootstrap?: Config['sectionsBootstrap']
97
+ sectionsCompaction?: Config['sectionsCompaction']
98
+ replace?: Config['replace']
99
+ inject?: Config['inject']
100
+ tools?: Config['tools']
101
+ dirty: boolean
102
+ }
103
+
104
+ function Panel({ t }: { t: Translate }): ReactElement {
105
+ const [cfg, setCfg] = useState<Config | null>(null)
106
+ const [inv, setInv] = useState<Inventory | null>(null)
107
+ // 三阶段预览装配:模型视角的唯一数据源(加载中为 null)。
108
+ const [phases, setPhases] = useState<PhaseViews | null>(null)
109
+ const [agentPresets, setAgentPresets] = useState<AgentPresetInfo[]>([])
110
+ const [tab, setTab] = useState<'sections' | 'tools' | 'presets' | 'preview'>('sections')
111
+ const [error, setError] = useState<string | null>(null)
112
+ const [refreshId, setRefreshId] = useState(0)
113
+ // 编辑目标:undefined = 全局默认;字符串 = agent 预设 id(字段级覆盖)。
114
114
  const [target, setTarget] = useState<string | undefined>(undefined)
115
- // 配置写入计数:每次成功写配置后 +1,驱动 PreviewTab 重载。
116
- // (以下 hooks 必须在任何提前 return 之前声明 —— hooks 顺序不能随加载状态变化。)
117
- const [version, setVersion] = useState(0)
118
- // 编辑域草稿:null = 无草稿(Tab 显示磁盘值)。提示词 ↔ 工具切换保留;
119
- // 切到预设/预览 Tab 或切换编辑目标时丢弃(脏草稿先经确认)。
120
- const [draft, setDraft] = useState<EditDraft | null>(null)
121
- const [saving, setSaving] = useState(false)
122
- const [flash, setFlash] = useState<string | null>(null)
123
- const [flashKind, setFlashKind] = useState<'ok' | 'err'>('ok')
124
- const flashTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
125
-
126
- const load = (): void => {
127
- fetch(CONFIG_URL + `?t=${Date.now()}`)
128
- .then((r) => r.json())
129
- .then((body) => {
130
- if (body?.ok !== true) throw new Error(body?.error ?? 'config failed')
131
- setCfg(body.config as Config)
132
- setError(null)
133
- })
134
- .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
135
- }
136
- useEffect(load, [])
137
-
138
- const refresh = (): void => {
139
- const qs = target ? `?scope=${encodeURIComponent(target)}` : ''
140
- // 三阶段预览并行拉取:提示词 / 工具 / 预览三个 Tab 全部以这套装配结果
141
- // 为唯一数据源 —— 静态清单只是注册表视角(不含伪 agent 阶段裁剪、
142
- // pre-step 注入等运行时规则),与它保持一致才是"所见即模型所见"。
143
- // 三个阶段部分恒定显示(预设没有某个阶段时该部分只是空的),
144
- // 不再按 (段, 工具) 签名去重折叠。
145
- const params = (phase: string): string =>
146
- `${qs}${qs ? '&' : '?'}phase=${phase}&t=${Date.now()}`
147
- const grab = (phase: string): Promise<Preview | null> =>
148
- fetch(PREVIEW_URL + params(phase))
149
- .then((r) => r.json())
150
- .then((body: Preview) => (body?.ok === false ? null : body))
151
- .catch(() => null)
152
- // 「本系统全部提示词/工具」面板是全局注册表,永不随编辑目标切换 ——
153
- // 清单请求不带 scope,三阶段预览仍带 scope(作为该预设的真实装配)。
154
- Promise.all([...VIEW_KEYS.map(grab), fetch(INVENTORY_URL).then((r) => r.json())])
155
- .then(([boot, comp, act, inventoryData]) => {
156
- setPhases({ bootstrap: boot, compaction: comp, active: act })
157
- setInv(inventoryData as Inventory)
158
- setError(null)
159
- setRefreshId((n) => n + 1)
160
- })
161
- .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
162
- }
163
- // 挂载时与切换编辑目标后:清单与三阶段预览切到对应 scope。
164
- // version 入依赖:保存/写配置成功后 +1,驱动三阶段预览重新拉取
165
- // (PreviewTab 的数据源是 phases,不重拉就会一直显示保存前的装配)。
166
- useEffect(refresh, [target, version])
167
-
168
- // 枚举已安装的 agent 预设(roster 实时读取),给目标选择器与预览选择器供货。
169
- // 抽成函数:保存预设成功后也要立即刷新目标下拉。
170
- const fetchPresets = (): void => {
171
- fetch(AGENT_PRESETS_URL + `?t=${Date.now()}`)
172
- .then((r) => r.json())
173
- .then((body) => setAgentPresets(Array.isArray(body?.presets) ? body.presets as AgentPresetInfo[] : []))
174
- .catch(() => setAgentPresets([]))
175
- }
176
- useEffect(() => { fetchPresets() }, [])
177
-
178
- if (cfg === null) {
179
- return h('div', { style: s.muted }, t('loading'))
180
- }
181
-
182
- // 保存成功/失败后的短促闪示消息(3 秒自动消失;err 用红色样式)。
183
- const showFlash = (text: string, kind: 'ok' | 'err' = 'ok'): void => {
184
- if (flashTimer.current !== null) clearTimeout(flashTimer.current)
185
- setFlash(text)
186
- setFlashKind(kind)
187
- flashTimer.current = setTimeout(() => setFlash(null), 3200)
188
- }
189
-
190
- // 编辑视图:草稿存在时以草稿覆盖对应字段(提示词/工具 Tab 的共享编辑域)。
191
- // 草稿只含用户实际编辑过的字段,未编辑字段回落基线 —— 绝不把继承值
192
- // 冻结进 override。
193
- const base = editView(cfg, target)
194
- const view: Config = draft
195
- ? {
196
- ...base,
197
- sections: draft.sections ?? base.sections,
198
- sectionsBootstrap: draft.sectionsBootstrap ?? base.sectionsBootstrap,
199
- sectionsCompaction: draft.sectionsCompaction ?? base.sectionsCompaction,
200
- replace: draft.replace ?? base.replace,
201
- inject: draft.inject ?? base.inject,
202
- tools: draft.tools ?? base.tools,
203
- }
204
- : base
205
-
206
- const writeField = (field: string, value: unknown): void => {
207
- const url = value === undefined ? CONFIG_UNSET_URL : CONFIG_SET_URL
208
- fetch(url, {
209
- method: 'POST',
210
- headers: { 'content-type': 'application/json' },
211
- body: JSON.stringify({ field, value }),
212
- })
213
- .then((r) => r.json())
214
- .then((body) => {
215
- if (body?.ok !== true) throw new Error(body?.error ?? 'write failed')
216
- setCfg(body.config as Config)
217
- setError(null)
218
- setVersion((n) => n + 1)
219
- })
220
- .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
221
- }
222
-
223
- // 提示词/工具 Tab 的写入:只改内存草稿,不落盘。草稿只记录被编辑的
224
- // 这一个字段(不携带其余字段的继承值)—— 保存时也只会提交编辑过的
225
- // 字段,未编辑字段继续回落全局 / 继承。target 缺省时写全局顶层;
226
- // 预设目标由 /config/apply 写 overrides[id](字段级接管语义在保存时生效)。
227
- const edit = (field: EditField, value: unknown): void => {
228
- setDraft((d) => ({
229
- ...(d ?? { dirty: false }),
230
- [field]: value,
231
- dirty: true,
232
- }))
233
- }
234
-
235
- // 统一保存:草稿里实际编辑过的字段一次 POST 到 /config/apply,成功后清
236
- // 草稿并采纳最新配置。失败时保留草稿(改完可以再试,不会丢)。
237
- const save = (): void => {
238
- if (draft === null || saving) return
239
- const EDITED_FIELDS = ['sections', 'sectionsBootstrap', 'sectionsCompaction', 'replace', 'inject', 'tools'] as const
240
- const patch: Record<string, unknown> = {}
241
- for (const field of EDITED_FIELDS) {
242
- if (Object.hasOwn(draft, field)) patch[field] = draft[field]
243
- }
244
- setSaving(true)
245
- fetch(CONFIG_APPLY_URL, {
246
- method: 'POST',
247
- headers: { 'content-type': 'application/json' },
248
- body: JSON.stringify({ target, patch }),
249
- })
250
- .then((r) => r.json())
251
- .then((body) => {
252
- if (body?.ok !== true) throw new Error(body?.error ?? 'save failed')
253
- setCfg(body.config as Config)
254
- setDraft(null)
255
- setError(null)
256
- setVersion((n) => n + 1)
257
- showFlash(t('saveOk'))
258
- })
259
- .catch((e: unknown) => setError(`${t('saveFail')}: ${e instanceof Error ? e.message : String(e)}`))
260
- .finally(() => setSaving(false))
261
- }
262
-
263
- // 预设 Tab 的「应用」:显式意图直接落盘(不经草稿),完整补丁一次写入
264
- // 当前编辑目标(含每阶段独立名单与阶段工具目录)。调用点已在离开编辑域时
265
- // 清空草稿,不会有并发草稿写盘。
266
- const writePatch = (patch: ConfigPatch): void => {
267
- fetch(CONFIG_APPLY_URL, {
268
- method: 'POST',
269
- headers: { 'content-type': 'application/json' },
270
- body: JSON.stringify({ target, patch }),
271
- })
272
- .then((r) => r.json())
273
- .then((body) => {
274
- if (body?.ok !== true) throw new Error(body?.error ?? 'apply failed')
275
- setCfg(body.config as Config)
276
- setError(null)
277
- setVersion((n) => n + 1)
278
- })
279
- .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
280
- }
281
- // 预设库(presets / activePreset)永远保持在全局字段,不分作用域。
282
- const writeGlobal = writeField
283
- // 提示词 Tab 解除继承自全局的屏蔽时使用的全局通道(与 writeGlobal 同源,
284
- // 收窄了字段类型以匹配 SectionsTab 的 prop 签名)。
285
- const writeGlobalField = writeField as (field: 'sections', value: unknown) => void
286
-
287
- // 恢复初始状态:服务端清空全部定制并关闭 forceSections(与不装插件等效)。
288
- // 二次确认由配置 Tab 的调用点负责;成功后清草稿、重拉全部视图。
289
- const resetAll = (): void => {
290
- fetch(CONFIG_RESET_URL, {
291
- method: 'POST',
292
- headers: { 'content-type': 'application/json' },
293
- })
294
- .then((r) => r.json())
295
- .then((body) => {
296
- if (body?.ok !== true) throw new Error(body?.error ?? 'reset failed')
297
- setCfg(body.config as Config)
298
- setDraft(null)
299
- setError(null)
300
- setVersion((n) => n + 1)
301
- showFlash(t('resetOk'))
302
- })
303
- .catch((e: unknown) => setError(`${t('resetFail')}: ${e instanceof Error ? e.message : String(e)}`))
304
- }
305
-
306
- // 切换 Tab:提示词 ↔ 工具是同一编辑域,草稿保留;切到预设/预览即离开
307
- // 编辑域,脏草稿经确认后丢弃。
308
- const switchTab = (next: 'sections' | 'tools' | 'presets' | 'preview'): void => {
309
- const leaving = (tab === 'sections' || tab === 'tools') && (next === 'presets' || next === 'preview')
310
- if (leaving) {
311
- if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
312
- setDraft(null)
313
- }
314
- setTab(next)
315
- }
316
-
317
- // 切换编辑目标:草稿基线随目标变化,脏草稿先经确认再丢弃。
318
- const switchTarget = (next: string | undefined): void => {
319
- if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
320
- setDraft(null)
321
- setTarget(next)
322
- }
323
-
324
- // 「存为预设」:把当前编辑内容(含未保存草稿)fork 成一个新的 agent 预设 ——
325
- // 宿主 authoring API 整体复制来源预设目录(组成文件 / 伴生 .mjs / 技能目录),
326
- // 同时把当前配置写进 overrides[name]。来源 = 当前编辑目标;全局目标由服务端
327
- // 回落到 roster 默认预设。名字非法 / 同名由服务端报错。
328
- // 返回是否成功,让配置 Tab 用面板内消息条提示(不再用 window.prompt / 顶部按钮)。
329
- const saveAsPreset = (presetName: string): Promise<boolean> => {
330
- const name = presetName.trim()
331
- if (name.length === 0) return Promise.resolve(false)
332
- return fetch(PRESETS_CREATE_URL, {
333
- method: 'POST',
334
- headers: { 'content-type': 'application/json' },
335
- body: JSON.stringify({
336
- name,
337
- from: target,
338
- config: {
339
- sections: view.sections ?? [],
340
- sectionsBootstrap: view.sectionsBootstrap ?? [],
341
- sectionsCompaction: view.sectionsCompaction ?? [],
342
- replace: view.replace ?? {},
343
- inject: view.inject ?? [],
344
- tools: view.tools ?? {},
345
- },
346
- }),
347
- })
348
- .then((r) => r.json())
349
- .then((body) => {
350
- if (body?.ok !== true) throw new Error(body?.error ?? t('saveAsPresetFail'))
351
- load()
352
- fetchPresets()
353
- showFlash(t('saveAsPresetOk'), 'ok')
354
- return true
355
- })
356
- .catch((e: unknown) => {
357
- showFlash(`${t('saveAsPresetFail')}:${String(e instanceof Error ? e.message : e)}`, 'err')
358
- return false
359
- })
360
- }
361
-
362
- return h('div', { style: s.root }, [
363
- h('div', { style: s.bar }, [
364
- h('button', { style: tab === 'sections' ? s.tabActive : s.tab, onClick: () => switchTab('sections') }, t('tabsSections')),
365
- h('button', { style: tab === 'tools' ? s.tabActive : s.tab, onClick: () => switchTab('tools') }, t('tabsTools')),
366
- h('button', { style: tab === 'presets' ? s.tabActive : s.tab, onClick: () => switchTab('presets') }, t('tabsPresets')),
367
- h('button', { style: tab === 'preview' ? s.tabActive : s.tab, onClick: () => switchTab('preview') }, t('tabsPreview')),
368
- h('select', {
369
- style: { ...s.input, marginLeft: 6 },
370
- value: target ?? '',
371
- onChange: (e: { target: { value: string } }) => switchTarget(e.target.value || undefined),
372
- title: t('targetHint'),
373
- }, [
374
- h('option', { value: '', style: s.option }, t('targetGlobal')),
375
- ...agentPresets.map((p) => h('option', { key: p.id, value: p.id, style: s.option },
376
- `${p.name}${p.broken ? ` (${t('broken')})` : ''}`)),
377
- ]),
378
- h('button', {
379
- style: draft?.dirty ? s.saveBtnDirty : s.saveBtn,
380
- disabled: !draft?.dirty || saving,
381
- onClick: save,
382
- }, t('save')),
383
- h('button', { style: s.refresh, onClick: refresh }, t('refresh')),
384
- ]),
385
- error ? h('div', { style: s.error }, String(error)) : null,
386
- flash ? h('div', { style: flashKind === 'err' ? s.error : s.noticeOk }, flash) : null,
387
- target && agentPresets.find((p) => p.id === target)?.broken
388
- ? h('div', { style: s.error }, t('brokenPreset'))
389
- : null,
390
- inv?.scopeResolved === false
391
- ? h('div', { style: s.noticeWarn }, t('scopeFallback'))
392
- : null,
393
- tab === 'sections'
394
- ? h(SectionsTab, {
395
- cfg: view,
396
- inv,
397
- phases,
398
- target,
399
- globalSections: cfg.sections,
400
- ownedSections: target ? cfg.overrides?.[target]?.sections : undefined,
401
- t,
402
- write: edit,
403
- writeGlobalField,
404
- })
405
- : tab === 'tools'
406
- ? h(ToolsTab, { cfg: view, inv, phases, t, write: edit })
407
- : tab === 'presets'
408
- ? h(PresetsTab, {
409
- cfg: view,
410
- inv,
411
- phases,
412
- t,
413
- writePatch,
414
- writeGlobal,
415
- saveAsPreset,
416
- forkSource: target ? (agentPresets.find((p) => p.id === target)?.name ?? target) : undefined,
417
- onReset: resetAll,
418
- // 黑名单永远是全局字段:取原始配置(不经 editView 的目标叠加)。
419
- envBlocklist: cfg.envBlocklist ?? [],
420
- })
421
- : h(PreviewTab, { t, active: tab === 'preview', refreshId, target, version, phases }),
422
- ])
423
- }
115
+ // 三态同步(默认关):勾选后提示词 / 工具 Tab 的屏蔽与解除屏蔽对三个阶段
116
+ // 一起生效(只作用于同名的那一项)。仅在提示词 / 工具两个 Tab 显示。
117
+ const [syncAll, setSyncAll] = useState(false)
118
+ // 配置写入计数:每次成功写配置后 +1,驱动 PreviewTab 重载。
119
+ // (以下 hooks 必须在任何提前 return 之前声明 —— hooks 顺序不能随加载状态变化。)
120
+ const [version, setVersion] = useState(0)
121
+ // 编辑域草稿:null = 无草稿(Tab 显示磁盘值)。提示词 ↔ 工具切换保留;
122
+ // 切到预设/预览 Tab 或切换编辑目标时丢弃(脏草稿先经确认)。
123
+ const [draft, setDraft] = useState<EditDraft | null>(null)
124
+ const [saving, setSaving] = useState(false)
125
+ const [flash, setFlash] = useState<string | null>(null)
126
+ const [flashKind, setFlashKind] = useState<'ok' | 'err'>('ok')
127
+ const flashTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
128
+
129
+ const load = (): void => {
130
+ fetch(CONFIG_URL + `?t=${Date.now()}`)
131
+ .then((r) => r.json())
132
+ .then((body) => {
133
+ if (body?.ok !== true) throw new Error(body?.error ?? 'config failed')
134
+ setCfg(body.config as Config)
135
+ setError(null)
136
+ })
137
+ .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
138
+ }
139
+ useEffect(load, [])
140
+
141
+ const refresh = (): void => {
142
+ const qs = target ? `?scope=${encodeURIComponent(target)}` : ''
143
+ // 三阶段预览并行拉取:提示词 / 工具 / 预览三个 Tab 全部以这套装配结果
144
+ // 为唯一数据源 —— 静态清单只是注册表视角(不含伪 agent 阶段裁剪、
145
+ // pre-step 注入等运行时规则),与它保持一致才是"所见即模型所见"。
146
+ // 三个阶段部分恒定显示(预设没有某个阶段时该部分只是空的),
147
+ // 不再按 (段, 工具) 签名去重折叠。
148
+ const params = (phase: string): string =>
149
+ `${qs}${qs ? '&' : '?'}phase=${phase}&t=${Date.now()}`
150
+ const grab = (phase: string): Promise<Preview | null> =>
151
+ fetch(PREVIEW_URL + params(phase))
152
+ .then((r) => r.json())
153
+ .then((body: Preview) => (body?.ok === false ? null : body))
154
+ .catch(() => null)
155
+ // 「本系统全部提示词/工具」面板是全局注册表,永不随编辑目标切换 ——
156
+ // 清单请求不带 scope,三阶段预览仍带 scope(作为该预设的真实装配)。
157
+ Promise.all([...VIEW_KEYS.map(grab), fetch(INVENTORY_URL).then((r) => r.json())])
158
+ .then(([boot, comp, act, inventoryData]) => {
159
+ setPhases({ bootstrap: boot, compaction: comp, active: act })
160
+ setInv(inventoryData as Inventory)
161
+ setError(null)
162
+ setRefreshId((n) => n + 1)
163
+ })
164
+ .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
165
+ }
166
+ // 挂载时与切换编辑目标后:清单与三阶段预览切到对应 scope。
167
+ // version 入依赖:保存/写配置成功后 +1,驱动三阶段预览重新拉取
168
+ // (PreviewTab 的数据源是 phases,不重拉就会一直显示保存前的装配)。
169
+ useEffect(refresh, [target, version])
170
+
171
+ // 枚举已安装的 agent 预设(roster 实时读取),给目标选择器与预览选择器供货。
172
+ // 抽成函数:保存预设成功后也要立即刷新目标下拉。
173
+ const fetchPresets = (): void => {
174
+ fetch(AGENT_PRESETS_URL + `?t=${Date.now()}`)
175
+ .then((r) => r.json())
176
+ .then((body) => setAgentPresets(Array.isArray(body?.presets) ? body.presets as AgentPresetInfo[] : []))
177
+ .catch(() => setAgentPresets([]))
178
+ }
179
+ useEffect(() => { fetchPresets() }, [])
180
+
181
+ if (cfg === null) {
182
+ return h('div', { style: s.muted }, t('loading'))
183
+ }
184
+
185
+ // 保存成功/失败后的短促闪示消息(3 秒自动消失;err 用红色样式)。
186
+ const showFlash = (text: string, kind: 'ok' | 'err' = 'ok'): void => {
187
+ if (flashTimer.current !== null) clearTimeout(flashTimer.current)
188
+ setFlash(text)
189
+ setFlashKind(kind)
190
+ flashTimer.current = setTimeout(() => setFlash(null), 3200)
191
+ }
192
+
193
+ // 编辑视图:草稿存在时以草稿覆盖对应字段(提示词/工具 Tab 的共享编辑域)。
194
+ // 草稿只含用户实际编辑过的字段,未编辑字段回落基线 —— 绝不把继承值
195
+ // 冻结进 override。
196
+ const base = editView(cfg, target)
197
+ const view: Config = draft
198
+ ? {
199
+ ...base,
200
+ sections: draft.sections ?? base.sections,
201
+ sectionsBootstrap: draft.sectionsBootstrap ?? base.sectionsBootstrap,
202
+ sectionsCompaction: draft.sectionsCompaction ?? base.sectionsCompaction,
203
+ replace: draft.replace ?? base.replace,
204
+ inject: draft.inject ?? base.inject,
205
+ tools: draft.tools ?? base.tools,
206
+ }
207
+ : base
208
+
209
+ const writeField = (field: string, value: unknown): void => {
210
+ const url = value === undefined ? CONFIG_UNSET_URL : CONFIG_SET_URL
211
+ fetch(url, {
212
+ method: 'POST',
213
+ headers: { 'content-type': 'application/json' },
214
+ body: JSON.stringify({ field, value }),
215
+ })
216
+ .then((r) => r.json())
217
+ .then((body) => {
218
+ if (body?.ok !== true) throw new Error(body?.error ?? 'write failed')
219
+ setCfg(body.config as Config)
220
+ setError(null)
221
+ setVersion((n) => n + 1)
222
+ })
223
+ .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
224
+ }
225
+
226
+ // 提示词/工具 Tab 的写入:只改内存草稿,不落盘。草稿只记录被编辑的
227
+ // 这一个字段(不携带其余字段的继承值)—— 保存时也只会提交编辑过的
228
+ // 字段,未编辑字段继续回落全局 / 继承。target 缺省时写全局顶层;
229
+ // 预设目标由 /config/apply 写 overrides[id](字段级接管语义在保存时生效)。
230
+ const edit = (field: EditField, value: unknown): void => {
231
+ setDraft((d) => ({
232
+ ...(d ?? { dirty: false }),
233
+ [field]: value,
234
+ dirty: true,
235
+ }))
236
+ }
237
+
238
+ // 统一保存:草稿里实际编辑过的字段一次 POST 到 /config/apply,成功后清
239
+ // 草稿并采纳最新配置。失败时保留草稿(改完可以再试,不会丢)。
240
+ const save = (): void => {
241
+ if (draft === null || saving) return
242
+ const EDITED_FIELDS = ['sections', 'sectionsBootstrap', 'sectionsCompaction', 'replace', 'inject', 'tools'] as const
243
+ const patch: Record<string, unknown> = {}
244
+ for (const field of EDITED_FIELDS) {
245
+ if (Object.hasOwn(draft, field)) patch[field] = draft[field]
246
+ }
247
+ setSaving(true)
248
+ fetch(CONFIG_APPLY_URL, {
249
+ method: 'POST',
250
+ headers: { 'content-type': 'application/json' },
251
+ body: JSON.stringify({ target, patch }),
252
+ })
253
+ .then((r) => r.json())
254
+ .then((body) => {
255
+ if (body?.ok !== true) throw new Error(body?.error ?? 'save failed')
256
+ setCfg(body.config as Config)
257
+ setDraft(null)
258
+ setError(null)
259
+ setVersion((n) => n + 1)
260
+ showFlash(t('saveOk'))
261
+ })
262
+ .catch((e: unknown) => setError(`${t('saveFail')}: ${e instanceof Error ? e.message : String(e)}`))
263
+ .finally(() => setSaving(false))
264
+ }
265
+
266
+ // 预设 Tab 的「应用」:显式意图直接落盘(不经草稿),完整补丁一次写入
267
+ // 当前编辑目标(含每阶段独立名单与阶段工具目录)。调用点已在离开编辑域时
268
+ // 清空草稿,不会有并发草稿写盘。
269
+ const writePatch = (patch: ConfigPatch): void => {
270
+ fetch(CONFIG_APPLY_URL, {
271
+ method: 'POST',
272
+ headers: { 'content-type': 'application/json' },
273
+ body: JSON.stringify({ target, patch }),
274
+ })
275
+ .then((r) => r.json())
276
+ .then((body) => {
277
+ if (body?.ok !== true) throw new Error(body?.error ?? 'apply failed')
278
+ setCfg(body.config as Config)
279
+ setError(null)
280
+ setVersion((n) => n + 1)
281
+ })
282
+ .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
283
+ }
284
+ // 预设库(presets / activePreset)永远保持在全局字段,不分作用域。
285
+ const writeGlobal = writeField
286
+
287
+ // 恢复初始状态:服务端清空全部定制并关闭 forceSections(与不装插件等效)。
288
+ // 二次确认由配置 Tab 的调用点负责;成功后清草稿、重拉全部视图。
289
+ const resetAll = (): void => {
290
+ fetch(CONFIG_RESET_URL, {
291
+ method: 'POST',
292
+ headers: { 'content-type': 'application/json' },
293
+ })
294
+ .then((r) => r.json())
295
+ .then((body) => {
296
+ if (body?.ok !== true) throw new Error(body?.error ?? 'reset failed')
297
+ setCfg(body.config as Config)
298
+ setDraft(null)
299
+ setError(null)
300
+ setVersion((n) => n + 1)
301
+ showFlash(t('resetOk'))
302
+ })
303
+ .catch((e: unknown) => setError(`${t('resetFail')}: ${e instanceof Error ? e.message : String(e)}`))
304
+ }
305
+
306
+ // 切换 Tab:提示词 ↔ 工具是同一编辑域,草稿保留;切到预设/预览即离开
307
+ // 编辑域,脏草稿经确认后丢弃。
308
+ const switchTab = (next: 'sections' | 'tools' | 'presets' | 'preview'): void => {
309
+ const leaving = (tab === 'sections' || tab === 'tools') && (next === 'presets' || next === 'preview')
310
+ if (leaving) {
311
+ if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
312
+ setDraft(null)
313
+ }
314
+ setTab(next)
315
+ }
316
+
317
+ // 切换编辑目标:草稿基线随目标变化,脏草稿先经确认再丢弃。
318
+ const switchTarget = (next: string | undefined): void => {
319
+ if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
320
+ setDraft(null)
321
+ setTarget(next)
322
+ }
323
+
324
+ // 「存为预设」:把当前编辑内容(含未保存草稿)fork 成一个新的 agent 预设 ——
325
+ // 宿主 authoring API 整体复制来源预设目录(组成文件 / 伴生 .mjs / 技能目录),
326
+ // 同时把当前配置写进 overrides[name]。来源 = 当前编辑目标;全局目标由服务端
327
+ // 回落到 roster 默认预设。名字非法 / 同名由服务端报错。
328
+ // 返回是否成功,让配置 Tab 用面板内消息条提示(不再用 window.prompt / 顶部按钮)。
329
+ const saveAsPreset = (presetName: string): Promise<boolean> => {
330
+ const name = presetName.trim()
331
+ if (name.length === 0) return Promise.resolve(false)
332
+ return fetch(PRESETS_CREATE_URL, {
333
+ method: 'POST',
334
+ headers: { 'content-type': 'application/json' },
335
+ body: JSON.stringify({
336
+ name,
337
+ from: target,
338
+ config: {
339
+ sections: view.sections ?? [],
340
+ sectionsBootstrap: view.sectionsBootstrap ?? [],
341
+ sectionsCompaction: view.sectionsCompaction ?? [],
342
+ replace: view.replace ?? {},
343
+ inject: view.inject ?? [],
344
+ tools: view.tools ?? {},
345
+ },
346
+ }),
347
+ })
348
+ .then((r) => r.json())
349
+ .then((body) => {
350
+ if (body?.ok !== true) throw new Error(body?.error ?? t('saveAsPresetFail'))
351
+ load()
352
+ fetchPresets()
353
+ showFlash(t('saveAsPresetOk'), 'ok')
354
+ return true
355
+ })
356
+ .catch((e: unknown) => {
357
+ showFlash(`${t('saveAsPresetFail')}:${String(e instanceof Error ? e.message : e)}`, 'err')
358
+ return false
359
+ })
360
+ }
361
+
362
+ return h('div', { style: s.root }, [
363
+ h('div', { style: s.bar }, [
364
+ h('button', { style: tab === 'sections' ? s.tabActive : s.tab, onClick: () => switchTab('sections') }, t('tabsSections')),
365
+ h('button', { style: tab === 'tools' ? s.tabActive : s.tab, onClick: () => switchTab('tools') }, t('tabsTools')),
366
+ h('button', { style: tab === 'presets' ? s.tabActive : s.tab, onClick: () => switchTab('presets') }, t('tabsPresets')),
367
+ h('button', { style: tab === 'preview' ? s.tabActive : s.tab, onClick: () => switchTab('preview') }, t('tabsPreview')),
368
+ h('select', {
369
+ style: { ...s.input, marginLeft: 6 },
370
+ value: target ?? '',
371
+ onChange: (e: { target: { value: string } }) => switchTarget(e.target.value || undefined),
372
+ title: t('targetHint'),
373
+ }, [
374
+ h('option', { value: '', style: s.option }, t('targetGlobal')),
375
+ ...agentPresets.map((p) => h('option', { key: p.id, value: p.id, style: s.option },
376
+ `${p.name}${p.broken ? ` (${t('broken')})` : ''}`)),
377
+ ]),
378
+ tab === 'sections' || tab === 'tools'
379
+ ? h('label', {
380
+ style: { ...s.muted, marginLeft: 6, display: 'inline-flex', alignItems: 'center', gap: 4, cursor: 'pointer', whiteSpace: 'nowrap' },
381
+ title: t('syncAllPhasesHint'),
382
+ }, [
383
+ h('input', {
384
+ type: 'checkbox',
385
+ checked: syncAll,
386
+ onChange: (e: { target: { checked: boolean } }) => setSyncAll(e.target.checked),
387
+ style: { margin: 0, cursor: 'pointer' },
388
+ }),
389
+ t('syncAllPhases'),
390
+ ])
391
+ : null,
392
+ h('button', {
393
+ style: draft?.dirty ? s.saveBtnDirty : s.saveBtn,
394
+ disabled: !draft?.dirty || saving,
395
+ onClick: save,
396
+ }, t('save')),
397
+ h('button', { style: s.refresh, onClick: refresh }, t('refresh')),
398
+ ]),
399
+ error ? h('div', { style: s.error }, String(error)) : null,
400
+ flash ? h('div', { style: flashKind === 'err' ? s.error : s.noticeOk }, flash) : null,
401
+ target && agentPresets.find((p) => p.id === target)?.broken
402
+ ? h('div', { style: s.error }, t('brokenPreset'))
403
+ : null,
404
+ inv?.scopeResolved === false
405
+ ? h('div', { style: s.noticeWarn }, t('scopeFallback'))
406
+ : null,
407
+ tab === 'sections'
408
+ ? h(SectionsTab, {
409
+ cfg: view,
410
+ inv,
411
+ phases,
412
+ syncAll,
413
+ t,
414
+ write: edit,
415
+ })
416
+ : tab === 'tools'
417
+ ? h(ToolsTab, { cfg: view, inv, phases, t, write: edit, syncAll })
418
+ : tab === 'presets'
419
+ ? h(PresetsTab, {
420
+ cfg: view,
421
+ inv,
422
+ phases,
423
+ t,
424
+ writePatch,
425
+ writeGlobal,
426
+ saveAsPreset,
427
+ forkSource: target ? (agentPresets.find((p) => p.id === target)?.name ?? target) : undefined,
428
+ onReset: resetAll,
429
+ // 黑名单永远是全局字段:取原始配置(不经 editView 的目标叠加)。
430
+ envBlocklist: cfg.envBlocklist ?? [],
431
+ })
432
+ : h(PreviewTab, { t, active: tab === 'preview', refreshId, target, version, phases }),
433
+ ])
434
+ }