@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.
Files changed (101) hide show
  1. package/LICENSE +23 -0
  2. package/README.md +95 -3
  3. package/cordis.patch.yml +5 -0
  4. package/icon.svg +203 -0
  5. package/lib/client.activity.js +222 -0
  6. package/lib/client.apply.js +171 -0
  7. package/lib/client.changes.js +206 -0
  8. package/lib/client.cleanup.js +270 -0
  9. package/lib/client.control.js +247 -0
  10. package/lib/client.dialog.js +77 -0
  11. package/lib/client.disable-preview.js +904 -0
  12. package/lib/client.draft.js +280 -0
  13. package/lib/client.editor-messages.js +421 -0
  14. package/lib/client.editor-store.js +266 -0
  15. package/lib/client.editor.js +433 -0
  16. package/lib/client.effects.js +115 -0
  17. package/lib/client.impact-tree.js +487 -0
  18. package/lib/client.influence.js +361 -0
  19. package/lib/client.js +246 -0
  20. package/lib/client.page.js +646 -0
  21. package/lib/client.plugin-filters.js +62 -0
  22. package/lib/client.plugins.js +506 -0
  23. package/lib/client.preview-messages.js +506 -0
  24. package/lib/client.preview-raw.js +132 -0
  25. package/lib/client.preview-store.js +128 -0
  26. package/lib/client.preview-tools.js +194 -0
  27. package/lib/client.preview.js +448 -0
  28. package/lib/client.relation-graph.js +364 -0
  29. package/lib/client.schema.js +327 -0
  30. package/lib/client.search.js +409 -0
  31. package/lib/client.session-detail.js +503 -0
  32. package/lib/client.sessions.js +495 -0
  33. package/lib/client.shared.js +562 -0
  34. package/lib/client.store.js +452 -0
  35. package/lib/client.styles.js +589 -0
  36. package/lib/client.template-card.js +240 -0
  37. package/lib/client.tools.js +366 -0
  38. package/lib/client.workspace-picker.js +204 -0
  39. package/lib/host/activity.js +252 -0
  40. package/lib/host/assembly-preview.js +244 -0
  41. package/lib/host/attribution.js +341 -0
  42. package/lib/host/catalog.js +133 -0
  43. package/lib/host/categorize.js +40 -0
  44. package/lib/host/config-layers.js +589 -0
  45. package/lib/host/constants.js +69 -0
  46. package/lib/host/control.js +159 -0
  47. package/lib/host/disable-preview.js +651 -0
  48. package/lib/host/entries.js +289 -0
  49. package/lib/host/fiber.js +86 -0
  50. package/lib/host/fs.js +99 -0
  51. package/lib/host/health.js +178 -0
  52. package/lib/host/http.js +65 -0
  53. package/lib/host/impact.js +138 -0
  54. package/lib/host/injection-owners.js +60 -0
  55. package/lib/host/layers.js +132 -0
  56. package/lib/host/masks.js +145 -0
  57. package/lib/host/modes.js +96 -0
  58. package/lib/host/names.js +44 -0
  59. package/lib/host/patch-config.js +554 -0
  60. package/lib/host/patch-scan.js +103 -0
  61. package/lib/host/preview-conditions.js +281 -0
  62. package/lib/host/preview-contexts.js +174 -0
  63. package/lib/host/preview-envelope.js +31 -0
  64. package/lib/host/preview-instructions.js +450 -0
  65. package/lib/host/preview-messages.js +284 -0
  66. package/lib/host/preview-modules.js +233 -0
  67. package/lib/host/preview-skills.js +200 -0
  68. package/lib/host/prompt.js +213 -0
  69. package/lib/host/recipe-overlay.js +209 -0
  70. package/lib/host/request-preview.js +114 -0
  71. package/lib/host/routes/activation.js +96 -0
  72. package/lib/host/routes/activity.js +22 -0
  73. package/lib/host/routes/apply.js +93 -0
  74. package/lib/host/routes/cleanup.js +62 -0
  75. package/lib/host/routes/control.js +22 -0
  76. package/lib/host/routes/disable-preview.js +19 -0
  77. package/lib/host/routes/impact.js +19 -0
  78. package/lib/host/routes/operations.js +22 -0
  79. package/lib/host/routes/preview.js +58 -0
  80. package/lib/host/routes/session-influence.js +23 -0
  81. package/lib/host/routes/snapshot.js +21 -0
  82. package/lib/host/routes/template.js +54 -0
  83. package/lib/host/routes/templates.js +28 -0
  84. package/lib/host/scope-impact.js +125 -0
  85. package/lib/host/session-events.js +39 -0
  86. package/lib/host/session-influence.js +467 -0
  87. package/lib/host/sessions.js +293 -0
  88. package/lib/host/snapshot.js +218 -0
  89. package/lib/host/source-scan.js +225 -0
  90. package/lib/host/templates/cleanup.js +219 -0
  91. package/lib/host/templates/inheritance.js +144 -0
  92. package/lib/host/templates/materialize.js +317 -0
  93. package/lib/host/templates/message-overlay.js +184 -0
  94. package/lib/host/templates/repository.js +323 -0
  95. package/lib/host/templates/store.js +131 -0
  96. package/lib/host/tool-set.js +150 -0
  97. package/lib/host/tools.js +129 -0
  98. package/lib/index.js +106 -0
  99. package/locale/en.json +6 -0
  100. package/locale/zh.json +6 -0
  101. package/package.json +124 -6
@@ -0,0 +1,452 @@
1
+ /**
2
+ * 页面状态:快照 / 提示词模板两块;预演条件在 `client.preview-store.js`,
3
+ * 定制编辑器草稿在 `client.editor-store.js`。
4
+ *
5
+ * 分开的理由是失败语义不同:快照失败整页报错,预演失败只影响预演标签,
6
+ * 提示词模板失败只影响通知行,编辑器基线失败只影响编辑器。
7
+ * 本文件是一个包内 chunk:入口用 `require.async('./client.store.js')` 取它。
8
+ */
9
+
10
+ window.__ModuleLoader__.load({
11
+ id: '@cheemsup/dsh-plugin-console',
12
+ chunk: 'client.store.js',
13
+ factory: (require) => {
14
+ const React = require('react')
15
+ const { useCallback, useEffect, useRef, useState } = React
16
+
17
+ return function create(deps) {
18
+ const { shared, applyChain, cleanup } = deps
19
+ const { fetchJson, fetchSnapshot, samePath, TEMPLATES_ROUTE, TEMPLATE_ROUTE, ACTIVATION_ROUTE } = shared
20
+
21
+ /** 快照:进入面板取一次,之后手动或每 30 秒静默刷新;previous 用于差分。 */
22
+ function useSnapshotStore() {
23
+ const [status, setStatus] = useState('idle')
24
+ const [snapshot, setSnapshot] = useState(null)
25
+ const [previous, setPrevious] = useState(null)
26
+ const [error, setError] = useState(null)
27
+ const [lastLoadedAt, setLastLoadedAt] = useState(null)
28
+ const snapshotRef = useRef(null)
29
+
30
+ const load = useCallback(async (options = {}) => {
31
+ const silent = options.silent === true
32
+ if (!silent) setStatus('loading')
33
+ setError(null)
34
+ try {
35
+ const next = await fetchSnapshot()
36
+ const before = snapshotRef.current
37
+ if (before !== null) setPrevious(before)
38
+ snapshotRef.current = next
39
+ setSnapshot(next)
40
+ setLastLoadedAt(Date.now())
41
+ setStatus('ready')
42
+ } catch (cause) {
43
+ setError(cause instanceof Error ? cause.message : String(cause))
44
+ if (snapshotRef.current === null || !silent) setStatus('error')
45
+ }
46
+ }, [])
47
+
48
+ useEffect(() => {
49
+ void load()
50
+ }, [load])
51
+
52
+ // 自检脚本的 vm 没有 setInterval;浏览器里才有。隐藏页签时不刷。
53
+ useEffect(() => {
54
+ if (typeof setInterval !== 'function') return undefined
55
+ const timer = setInterval(() => {
56
+ if (typeof document !== 'undefined' && document.visibilityState === 'hidden') return
57
+ void load({ silent: true })
58
+ }, 30000)
59
+ return () => clearInterval(timer)
60
+ }, [load])
61
+
62
+ return { status, snapshot, previous, error, lastLoadedAt, load }
63
+ }
64
+
65
+ /**
66
+ * 提示词模板的 CRUD、保存、应用与每会话开关。
67
+ *
68
+ * 草稿与基线由 `useEditorStore` 持有;这里只通过 `editorState` 读写它们,
69
+ * 让「模板列表」和「当前草稿」各自保持自己的失败语义。
70
+ *
71
+ * @param {object} options - 依赖。
72
+ * @param {object | null} options.runtimeCtx - 浏览器插件上下文(按需取宿主服务)。
73
+ * @param {object | null} options.snapshot - 当前快照,用于解析工作区与模式名。
74
+ * @param {Function} options.reloadSnapshot - 开关生效后重取快照。
75
+ * @param {object} options.editorState - `useEditorStore()` 的返回值。
76
+ */
77
+ function useTemplateStore({ runtimeCtx, snapshot, reloadSnapshot, editorState }) {
78
+ // 切换基线条件(模式 / 工作区 / 权限)前待确认的目标:
79
+ // undefined = 没有待确认的;对象里的字段各自可选。
80
+ const [pendingBaselineChange, setPendingBaselineChange] = useState(undefined)
81
+ // 兼容旧视图:只关心模式的确认条继续读这两个名字。
82
+ const pendingPreset = pendingBaselineChange?.presetId
83
+ const setPendingPreset = (presetId) => setPendingBaselineChange(presetId === undefined ? undefined : { presetId })
84
+ // 提示词模板列表与当前选中的提示词模板。
85
+ const [templateList, setTemplateList] = useState([])
86
+ const [templateId, setTemplateId] = useState(null)
87
+ const [templateSaving, setTemplateSaving] = useState(false)
88
+ const [templateNotice, setTemplateNotice] = useState(null)
89
+ // 提示词模板命名:正在编辑的名字(空表示未在编辑)、以及正在等待删除确认的提示词模板 id。
90
+ const [nameDraft, setNameDraft] = useState(null)
91
+ const [deletingId, setDeletingId] = useState(null)
92
+ // 「应用」面板:把当前提示词模板物化到一个新会话,并带上首条消息。
93
+ // 目标模式不再单独选:提示词模板的覆盖按基线模式的段落名算,换模式应用多半落空,
94
+ // 所以应用模式恒等于编辑器的基线模式(editPreset)。工作区也由定制页的条件决定。
95
+ const [applyPrompt, setApplyPrompt] = useState('')
96
+ const [applyPhase, setApplyPhase] = useState('idle')
97
+ const [applyNotice, setApplyNotice] = useState(null)
98
+ // 每会话开关:正在提交的会话 id → 目标值。用 Map 而不是单个 id,
99
+ // 因为用户可能连点几个会话;每个开关各自显状态。
100
+ const [togglingSession, setTogglingSession] = useState(() => new Map())
101
+ const [activationNotice, setActivationNotice] = useState(null)
102
+ // 开关前的二次确认:记整份目标(会话 + 目标状态),确认时直接拿它发请求。
103
+ const [activationPending, setActivationPending] = useState(null)
104
+
105
+ /** 读取提示词模板列表。 */
106
+ const loadTemplates = useCallback(async () => {
107
+ try {
108
+ const data = await fetchJson(TEMPLATES_ROUTE)
109
+ setTemplateList(data.templates ?? [])
110
+ } catch {
111
+ setTemplateList([])
112
+ }
113
+ }, [])
114
+
115
+ /** 全局清理后把编辑器退回纯基线,避免继续显示一个已不存在的提示词模板。 */
116
+ const resetTemplateEditor = useCallback(() => {
117
+ setTemplateId(null)
118
+ setNameDraft(null)
119
+ editorState.resetDraft()
120
+ }, [editorState])
121
+
122
+ // 清理状态独立成一个 chunk;这里只把「刷新快照 / 重取列表 / 重置编辑器」交给它。
123
+ const cleanupState = cleanup({ reloadSnapshot, loadTemplates, onClearedAll: resetTemplateEditor })
124
+
125
+ /**
126
+ * 打开一个提示词模板:取它的 recipe,叠到当前基线之上。
127
+ *
128
+ * 提示词模板只存「与基线不同的项」,所以必须有一份基线才能还原成全文。
129
+ * 当前编辑器的基线优先;没有就先载入默认模式的基线。
130
+ * @param {string} id - 提示词模板 id。
131
+ */
132
+ const openTemplate = useCallback(async (id) => {
133
+ try {
134
+ const data = await fetchJson(TEMPLATE_ROUTE + '?id=' + encodeURIComponent(id))
135
+ const latest = (data.revisions ?? []).at(-1)
136
+ const recipe = latest?.recipe ?? {}
137
+ setTemplateId(id)
138
+ setNameDraft(null)
139
+ await editorState.commitRecipe(recipe)
140
+ // 载入成功不写通知:选中的模板在卡片里已经一目了然,多一行加载提示只是噪音。
141
+ setTemplateNotice(null)
142
+ } catch (cause) {
143
+ setTemplateNotice(cause instanceof Error ? cause.message : String(cause))
144
+ }
145
+ }, [editorState])
146
+
147
+ /**
148
+ * 回到「新模板」:没有任何已保存的覆盖,草稿就是基线全文。
149
+ *
150
+ * `templateId === null` 不是「未选择」,而是「一份还没落库的新模板」——
151
+ * 进入编辑器没选中任何模板时就是这个状态,保存或应用时才生成模板头。
152
+ * @returns {void}
153
+ */
154
+ const startNewTemplate = useCallback(() => {
155
+ setTemplateId(null)
156
+ setNameDraft(null)
157
+ setDeletingId(null)
158
+ setTemplateNotice(null)
159
+ editorState.resetDraft()
160
+ }, [editorState])
161
+
162
+ /**
163
+ * 保证当前草稿有一个模板头:新模板在第一次保存 / 应用时才落库。
164
+ *
165
+ * 点进定制页只是看看也要在列表里留一条空模板,会让模板列表被垃圾填满;
166
+ * 所以模板头的创建推迟到真的要用它的那一刻。
167
+ * @returns {Promise<string>} 模板 id。
168
+ */
169
+ const ensureTemplate = useCallback(async () => {
170
+ if (templateId !== null) return templateId
171
+ const nextIndex = (templateList?.length ?? 0) + 1
172
+ const data = await fetchJson(TEMPLATES_ROUTE, {
173
+ method: 'POST',
174
+ body: JSON.stringify({ name: '提示词模板 ' + nextIndex }),
175
+ })
176
+ setTemplateId(data.template.id)
177
+ await loadTemplates()
178
+ return data.template.id
179
+ }, [templateId, templateList, loadTemplates])
180
+
181
+ /**
182
+ * 给当前提示词模板重命名。
183
+ *
184
+ * 名字只是标签:不回写任何 recipe,也不产生历史记录。
185
+ * @param {string} id - 提示词模板 id。
186
+ * @param {string} name - 新名字;空白名字拒绝提交。
187
+ */
188
+ const renameTemplate = useCallback(async (id, name) => {
189
+ const trimmed = name.trim()
190
+ if (trimmed.length === 0) {
191
+ setTemplateNotice('名字不能为空')
192
+ return
193
+ }
194
+ try {
195
+ await fetchJson(TEMPLATE_ROUTE + '?id=' + encodeURIComponent(id), {
196
+ method: 'POST',
197
+ body: JSON.stringify({ name: trimmed }),
198
+ })
199
+ setNameDraft(null)
200
+ await loadTemplates()
201
+ setTemplateNotice('已重命名为「' + trimmed + '」')
202
+ } catch (cause) {
203
+ // 弹窗挡住卡片里的通知行:失败时先关掉,否则错误信息藏在覆盖层后面。
204
+ setNameDraft(null)
205
+ setTemplateNotice(cause instanceof Error ? cause.message : String(cause))
206
+ }
207
+ }, [loadTemplates])
208
+
209
+ /**
210
+ * 删除一个提示词模板(连同它的历史记录)。
211
+ *
212
+ * 删的是当前提示词模板时,把草稿退回纯基线并清空选中——否则界面会继续显示
213
+ * 一个已经不存在的提示词模板。
214
+ * @param {string} id - 提示词模板 id。
215
+ */
216
+ const deleteTemplate = useCallback(async (id) => {
217
+ try {
218
+ const data = await fetchJson(TEMPLATE_ROUTE + '?id=' + encodeURIComponent(id), { method: 'DELETE' })
219
+ setDeletingId(null)
220
+ await loadTemplates()
221
+ if (templateId === id) {
222
+ setTemplateId(null)
223
+ setNameDraft(null)
224
+ editorState.resetDraft()
225
+ }
226
+ const extra = (data.removedRevisions ?? 0) > 0 ? '(含 ' + data.removedRevisions + ' 条历史记录)' : ''
227
+ setTemplateNotice('已删除提示词模板' + extra)
228
+ } catch (cause) {
229
+ // 删除确认是弹窗:失败时先关掉,错误通知才不会被覆盖层挡住。
230
+ setDeletingId(null)
231
+ setTemplateNotice(cause instanceof Error ? cause.message : String(cause))
232
+ }
233
+ }, [templateId, loadTemplates, editorState])
234
+
235
+ /** 保存草稿为一个新 revision;草稿还是新模板时,先在这里把它真正生成出来。 */
236
+ const saveTemplate = useCallback(async () => {
237
+ if (templateSaving) return
238
+ const wasNew = templateId === null
239
+ setTemplateSaving(true)
240
+ try {
241
+ const id = await ensureTemplate()
242
+ const recipe = editorState.recipeFromDraft()
243
+ await fetchJson(TEMPLATE_ROUTE + '?id=' + encodeURIComponent(id), {
244
+ method: 'POST',
245
+ body: JSON.stringify({ recipe }),
246
+ })
247
+ await loadTemplates()
248
+ editorState.setTemplateRecipe(recipe)
249
+ // 保存后草稿仍是眼前这一份,只是「没有未保存改动」了。
250
+ editorState.markSaved()
251
+ // 摘要直接写进通知:只改新字段、旧字段被静默丢掉时,这里会立刻显示 0。
252
+ setTemplateNotice((wasNew ? '已生成并保存新模板' : '已保存') + ' · ' + editorState.recipeSummary(recipe))
253
+ } catch (cause) {
254
+ setTemplateNotice(cause instanceof Error ? cause.message : String(cause))
255
+ } finally {
256
+ setTemplateSaving(false)
257
+ }
258
+ }, [templateId, templateSaving, ensureTemplate, loadTemplates, editorState])
259
+
260
+ /**
261
+ * 把当前提示词模板真正用起来:存版本 → 建会话 → 物化 → 跳过去 → 填好草稿。
262
+ *
263
+ * 五步链本身在 `client.apply.js` 里,是一个不依赖 React 的纯函数;
264
+ * 这里只做「把状态取出来、把结果写回去」。
265
+ */
266
+ const applyTemplate = useCallback(async () => {
267
+ // 「当前」不是一个真的工作区 id:`sessions.create({})` 不带工作区会用
268
+ // 宿主的 defaultCwd 建在哪儿都不属于,会话就落到「未分组」里,主区只剩
269
+ // 一个选工作区的空白页。所以这里把「当前」解析成用户正待着的那个工作区。
270
+ const resolveWorkspace = () => {
271
+ // 定制页条件给了路径就以它为准;路径映射不到工作区 id 时退回「当前工作区」。
272
+ const path = editorState.effectiveWorkspacePath
273
+ if (typeof path === 'string' && path.length > 0) {
274
+ const selected = (snapshot.workspaces ?? []).find((workspace) => samePath(workspace.path, path))
275
+ if (selected !== undefined) return selected.id
276
+ }
277
+ const uiWorkspace = runtimeCtx?.get?.('uiWorkspace')
278
+ const selectedSessionId = uiWorkspace?.selection?.getSnapshot?.()?.sessionId
279
+ if (typeof selectedSessionId === 'string') {
280
+ const owner = (snapshot.workspaces ?? []).find((workspace) =>
281
+ (workspace.sessions ?? []).some((session) => session.id === selectedSessionId),
282
+ )
283
+ if (owner !== undefined) return owner.id
284
+ }
285
+ return (snapshot.workspaces ?? [])[0]?.id ?? null
286
+ }
287
+
288
+ setApplyPhase('saving')
289
+ setApplyNotice(null)
290
+ // 草稿还是新模板时先把它生成出来:应用链的每一步都要一个真实的模板 id。
291
+ let id
292
+ try {
293
+ id = await ensureTemplate()
294
+ } catch (cause) {
295
+ setApplyPhase('error')
296
+ setApplyNotice(cause instanceof Error ? cause.message : String(cause))
297
+ return
298
+ }
299
+ const result = await applyChain.runApplyChain({
300
+ ctx: runtimeCtx,
301
+ templateId: id,
302
+ recipe: editorState.recipeFromDraft(),
303
+ workspaceId: resolveWorkspace(),
304
+ presetId: editorState.editPreset,
305
+ promptText: applyPrompt,
306
+ autoSend: true,
307
+ onPhase: setApplyPhase,
308
+ })
309
+
310
+ if (result.ok !== true) {
311
+ setApplyPhase('error')
312
+ setApplyNotice(result.message)
313
+ return
314
+ }
315
+ setApplyPhase(result.failed ? 'error' : 'done')
316
+ setApplyNotice(result.notes)
317
+ }, [ensureTemplate, editorState, applyPrompt])
318
+
319
+ // 开关改的是请求体最前面的工具定义与系统提示词,缓存按前缀匹配,前缀一变
320
+ // 后面全部失效——这次操作有直接的账单代价,所以先挂起,等界面确认。
321
+ const requestActivation = (sessionId, enabled, presetId) => setActivationPending({ sessionId, enabled, presetId })
322
+ const cancelActivation = () => setActivationPending(null)
323
+
324
+ /**
325
+ * 切换某个会话的提示词模板启用状态,成功后重拉快照(绑定与运行时工具集都可能变了)。
326
+ * @param {string} sessionId - 目标会话。
327
+ * @param {boolean} enabled - 目标状态。
328
+ * @param {string | null} presetId - 该会话的模式,用于重新物化时的 order 表。
329
+ */
330
+ const toggleActivation = useCallback(async (sessionId, enabled, presetId) => {
331
+ setActivationPending(null)
332
+ setTogglingSession((prev) => new Map(prev).set(sessionId, enabled))
333
+ setActivationNotice(null)
334
+ try {
335
+ const data = await fetchJson(ACTIVATION_ROUTE, {
336
+ method: 'POST',
337
+ body: JSON.stringify({
338
+ sessionId,
339
+ enabled,
340
+ ...(typeof presetId === 'string' ? { presetId } : {}),
341
+ }),
342
+ })
343
+ const notes = [enabled ? '已开启' : '已关闭']
344
+ if (data.cleared === true) notes.push(' · 已撤销上一次的注册')
345
+ if (data.reason !== undefined) notes.push(' · ' + data.reason)
346
+ if ((data.errors ?? []).length > 0) notes.push(' · 失败:' + data.errors.join(';'))
347
+ if (data.note !== undefined) notes.push(' · ' + data.note)
348
+ setActivationNotice(notes.join(''))
349
+ await reloadSnapshot()
350
+ } catch (cause) {
351
+ setActivationNotice(cause instanceof Error ? cause.message : String(cause))
352
+ } finally {
353
+ setTogglingSession((prev) => {
354
+ const next = new Map(prev)
355
+ next.delete(sessionId)
356
+ return next
357
+ })
358
+ }
359
+ }, [reloadSnapshot])
360
+
361
+ /**
362
+ * 真正应用一次基线条件变化。
363
+ *
364
+ * `replay` 省略时用当前提示词模板的 recipe;「先保存再切换」会把刚算出的
365
+ * recipe 直接传进来,避免读到异步状态里的旧值。
366
+ * @param {object} change - `{ presetId?, workspacePath?, permissionPreset? }`。
367
+ * @param {object} [replay] - 要在新基线上重放的 recipe。
368
+ * @returns {void}
369
+ */
370
+ const commitBaselineChange = useCallback((change, replay) => {
371
+ setPendingBaselineChange(undefined)
372
+ editorState.applyConditions(change)
373
+ const presetId = change.presetId === undefined ? editorState.editPreset : change.presetId
374
+ void editorState.loadBaseline(
375
+ presetId,
376
+ replay === undefined ? editorState.templateRecipe : replay,
377
+ change,
378
+ )
379
+ }, [editorState])
380
+
381
+ /**
382
+ * 请求一次基线条件变化:有未保存改动先挂起确认,否则立即重载。
383
+ * @param {object} change - `{ presetId?, workspacePath?, permissionPreset? }`。
384
+ * @returns {void}
385
+ */
386
+ const requestBaselineChange = useCallback((change) => {
387
+ // 模式相同、条件也相同就是一次空操作。
388
+ const samePreset = change.presetId === undefined || change.presetId === editorState.editPreset
389
+ const sameWorkspace = change.workspacePath === undefined || samePath(change.workspacePath, editorState.effectiveWorkspacePath)
390
+ const samePermission = change.permissionPreset === undefined || change.permissionPreset === editorState.editPermissionPreset
391
+ if (samePreset && sameWorkspace && samePermission) return
392
+ if (editorState.dirty) {
393
+ setPendingBaselineChange(change)
394
+ return
395
+ }
396
+ commitBaselineChange(change)
397
+ }, [editorState, commitBaselineChange])
398
+
399
+ /**
400
+ * 切换基线模式。
401
+ *
402
+ * 换模式会把草稿整份重填(段落集合与工具集合都变了),所以有未保存改动
403
+ * 时必须先问一句——不然用户改的东西会无声消失。
404
+ * @param {string | null} presetId - 目标模式。
405
+ * @returns {void}
406
+ */
407
+ const requestPreset = useCallback((presetId) => {
408
+ requestBaselineChange({ presetId })
409
+ }, [requestBaselineChange])
410
+
411
+ return {
412
+ pendingPreset,
413
+ setPendingPreset,
414
+ pendingBaselineChange,
415
+ setPendingBaselineChange,
416
+ commitBaselineChange,
417
+ requestBaselineChange,
418
+ templateList,
419
+ templateId,
420
+ templateSaving,
421
+ templateNotice,
422
+ nameDraft,
423
+ setNameDraft,
424
+ deletingId,
425
+ setDeletingId,
426
+ applyPrompt,
427
+ setApplyPrompt,
428
+ applyPhase,
429
+ applyNotice,
430
+ setApplyNotice,
431
+ togglingSession,
432
+ activationNotice,
433
+ activationPending,
434
+ ...cleanupState,
435
+ loadTemplates,
436
+ openTemplate,
437
+ startNewTemplate,
438
+ renameTemplate,
439
+ deleteTemplate,
440
+ saveTemplate,
441
+ applyTemplate,
442
+ requestActivation,
443
+ cancelActivation,
444
+ toggleActivation,
445
+ requestPreset,
446
+ }
447
+ }
448
+
449
+ return { useSnapshotStore, useTemplateStore }
450
+ }
451
+ },
452
+ })