dsh-prompt-customizer 0.2.7 → 0.3.1

package/src/client/index.ts

@@ -1,19 +1,19 @@
 /**
- * dsh-prompt-customizer — browser half (TypeScript source).
+ * dsh-prompt-customizer — 浏览器端（TypeScript 源码）。
  *
- * Registers a "提示词定制" settings section (sidebar entry) and a plugin
- * settings card. The panel fetches the effective section / tool inventory
- * from the host `/api/prompt-customizer/inventory` and lets the user block,
- * replace, inject prompt sections and hide tools. All writes go through the
- * bound settings scope (`prompt-customizer` namespace) and apply live.
+ * 注册一个「提示词定制」设置分区（侧边栏入口）及插件设置卡片。面板从宿主
+ * 的 `/api/prompt-customizer/inventory` 拉取当前生效的段 / 工具清单，让用户
+ * 屏蔽、替换、注入提示词段并隐藏工具。所有写入都走绑定的设置作用域
+ * （`prompt-customizer` 命名空间），实时生效。
  *
- * Built by tsdown into the __ModuleLoader__ factory bundle at client/client.js;
- * the only external is the loader module table's react entry.
+ * 由 tsdown 打包为 client/client.js（__ModuleLoader__ factory bundle）；
+ * 唯一的外部依赖是 loader 模块表中的 react 入口。
  */
-import { createElement as h, useEffect, useState, type ReactElement } from 'react'
+import { createElement as h, useEffect, useRef, useState, type ReactElement } from 'react'
 import { DICT, type Translate } from './locales.ts'
 import { s } from './styles.ts'
-import type { Config, Inventory, SettingsScope } from './types.ts'
+import type { AgentPresetInfo, Config, Inventory, PhaseViewKey, Preview } from './types.ts'
+import { editView, type ConfigPatch } from './presets.ts'
 import { SectionsTab } from './SectionsTab.tsx'
 import { ToolsTab } from './ToolsTab.tsx'
 import { PresetsTab } from './PresetsTab.tsx'
@@ -21,25 +21,35 @@ import { PreviewTab } from './PreviewTab.tsx'
 
 const NS = 'prompt-customizer'
 const INVENTORY_URL = '/api/prompt-customizer/inventory'
+const AGENT_PRESETS_URL = '/api/prompt-customizer/agent-presets'
+const CONFIG_URL = '/api/prompt-customizer/config'
+const CONFIG_SET_URL = '/api/prompt-customizer/config/set'
+const CONFIG_UNSET_URL = '/api/prompt-customizer/config/unset'
+const CONFIG_APPLY_URL = '/api/prompt-customizer/config/apply'
+const PRESETS_CREATE_URL = '/api/prompt-customizer/presets'
+const PREVIEW_URL = '/api/prompt-customizer/preview'
+
+/** 三阶段预览装配（模型视角）：提示词/工具/预览 Tab 的统一数据源。 */
+type PhaseViews = Record<PhaseViewKey, Preview | null>
+
+/** 三套名义装配的共享布局：顺序固定，refresh 按此并行拉取。 */
+const VIEW_KEYS: PhaseViewKey[] = ['bootstrap', 'compaction', 'active']
 
 export const name = 'prompt-customizer'
 export const inject = ['slots', 'locale']
 
-/** The subset of the client cordis context this plugin touches. */
+/** 本插件用到的客户端 cordis 上下文的最小子集。 */
 interface ClientContext {
   effect(callback: () => unknown, label?: string): void
   locale: {
     register(namespace: string, dicts: { zh: Record<string, string>; en: Record<string, string> }): unknown
     bind(namespace: string): Translate
   }
-  inject(services: string[], callback: (scoped: SettingsScopeHost) => void): void
+  inject(services: string[], callback: (scoped: SlotsHost) => void): void
 }
 
-/** The host surface the settings card needs (settingsScope transport). */
-interface SettingsScopeHost {
-  settingsScope: {
-    bind(options: { namespace: string }): SettingsScope
-  }
+/** 设置分区需要的宿主能力面（插槽注册）。 */
+interface SlotsHost {
   slots: {
     inject(name: string, register: () => unknown): void
     register(meta: Record<string, unknown>, render: () => unknown): unknown
@@ -50,14 +60,10 @@ export function apply(ctx: ClientContext): void {
   ctx.effect(() => ctx.locale.register(NS, DICT), 'prompt-customizer: locale')
   const t = ctx.locale.bind(NS)
 
-  // Register a standalone settings section (sidebar menu entry) so the panel
-  // only appears under "提示词定制", not as a card inside the "插件" settings
-  // list. Goes through a NESTED inject of settingsScope so the panel can
-  // read/write the namespace config; on hosts without the settings transport
-  // it stays hidden instead of unmounting the whole plugin.
-  ctx.inject(['settingsScope'], (scoped) => {
-    const scope = scoped.settingsScope.bind({ namespace: NS })
-
+  // 注册为独立的设置分区（侧边栏菜单项），面板只出现在「提示词定制」下，
+  // 而不是作为卡片塞进「插件」设置列表。配置读写走插件自有路由（宿主端的
+  // config.yaml），不再依赖 settings 传输层。
+  ctx.inject(['slots'], (scoped) => {
     scoped.slots.inject('settings.section', () => scoped.slots.register({
       name: 'settings.section',
       id: 'prompt-customizer',
@@ -65,51 +71,330 @@ export function apply(ctx: ClientContext): void {
       label: () => t('nav'),
       locale: NS,
       inject: () => ({ t }),
-    }, () => h(Panel, { scope, t })))
+    }, () => h(Panel, { t })))
   })
 }
 
-// ── Root panel ──────────────────────────────────────────────────────────────
+// ── 根面板 ────────────────────────────────────────────────────────────────
+
+/**
+ * 面板根组件：拉取配置与清单、维护 Tab 状态，把各 Tab 子视图装配起来。
+ * 配置来自插件自有 /config 路由；清单来自 /inventory，可通过「刷新」按钮
+ * 手动重取。提示词/工具 Tab 的编辑只改内存草稿，由「保存」按钮经
+ * /config/apply 一次写盘（写错的配置不点保存就不会进文件）。
+ */
+
+/** 可编辑的配置字段（含每阶段独立段屏蔽名单）。 */
+type EditField = 'sections' | 'sectionsBootstrap' | 'sectionsCompaction' | 'replace' | 'inject' | 'tools'
+
+/** 编辑域草稿：提示词/工具 Tab 共享的未保存字段 + 脏标记。
+ *  只记录用户实际编辑过的字段（首次编辑只写那一项），保存时也只提交这些
+ *  字段 —— 未编辑的字段继续回落全局 / 继承，避免一次保存冻结全部继承值。 */
+interface EditDraft {
+  sections?: Config['sections']
+  sectionsBootstrap?: Config['sectionsBootstrap']
+  sectionsCompaction?: Config['sectionsCompaction']
+  replace?: Config['replace']
+  inject?: Config['inject']
+  tools?: Config['tools']
+  dirty: boolean
+}
 
-function Panel({ scope, t }: { scope: SettingsScope; t: Translate }): ReactElement {
-  const [snap, setSnap] = useState(() => scope.getSnapshot())
+function Panel({ t }: { t: Translate }): ReactElement {
+  const [cfg, setCfg] = useState<Config | null>(null)
   const [inv, setInv] = useState<Inventory | null>(null)
+  // 三阶段预览装配：模型视角的唯一数据源（加载中为 null）。
+  const [phases, setPhases] = useState<PhaseViews | null>(null)
+  const [agentPresets, setAgentPresets] = useState<AgentPresetInfo[]>([])
   const [tab, setTab] = useState<'sections' | 'tools' | 'presets' | 'preview'>('sections')
   const [error, setError] = useState<string | null>(null)
+  const [refreshId, setRefreshId] = useState(0)
+  // 编辑目标：undefined = 全局默认；字符串 = agent 预设 id（字段级 override）。
+  const [target, setTarget] = useState<string | undefined>(undefined)
+  // 配置写入计数：每次成功写配置后 +1，驱动 PreviewTab 重载。
+  // （以下 hooks 必须在任何提前 return 之前声明 —— hooks 顺序不能随加载状态变化。）
+  const [version, setVersion] = useState(0)
+  // 编辑域草稿：null = 无草稿（Tab 显示磁盘值）。提示词 ↔ 工具切换保留；
+  // 切到预设/预览 Tab 或切换编辑目标时丢弃（脏草稿先经确认）。
+  const [draft, setDraft] = useState<EditDraft | null>(null)
+  const [saving, setSaving] = useState(false)
+  const [flash, setFlash] = useState<string | null>(null)
+  const [flashKind, setFlashKind] = useState<'ok' | 'err'>('ok')
+  const flashTimer = useRef<ReturnType<typeof setTimeout> | null>(null)
 
-  useEffect(() => scope.subscribe(() => setSnap(scope.getSnapshot())), [scope])
+  const load = (): void => {
+    fetch(CONFIG_URL + `?t=${Date.now()}`)
+      .then((r) => r.json())
+      .then((body) => {
+        if (body?.ok !== true) throw new Error(body?.error ?? 'config failed')
+        setCfg(body.config as Config)
+        setError(null)
+      })
+      .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
+  }
+  useEffect(load, [])
 
   const refresh = (): void => {
-    fetch(INVENTORY_URL)
-      .then((r) => r.json())
-      .then((data: Inventory) => { setInv(data); setError(null) })
+    const qs = target ? `?scope=${encodeURIComponent(target)}` : ''
+    // 三阶段预览并行拉取：提示词 / 工具 / 预览三个 Tab 全部以这套装配结果
+    // 为唯一数据源 —— 静态清单只是注册表视角（不含伪 agent 阶段裁剪、
+    // pre-step 注入等运行时规则），与它保持一致才是"所见即模型所见"。
+    // 三个阶段部分恒定显示（预设没有某个阶段时该部分只是空的），
+    // 不再按 (段, 工具) 签名去重折叠。
+    const params = (phase: string): string =>
+      `${qs}${qs ? '&' : '?'}phase=${phase}&t=${Date.now()}`
+    const grab = (phase: string): Promise<Preview | null> =>
+      fetch(PREVIEW_URL + params(phase))
+        .then((r) => r.json())
+        .then((body: Preview) => (body?.ok === false ? null : body))
+        .catch(() => null)
+    // 「本系统全部提示词/工具」面板是全局注册表，永不随编辑目标切换 ——
+    // 清单请求不带 scope，三阶段预览仍带 scope（作为该预设的真实装配）。
+    Promise.all([...VIEW_KEYS.map(grab), fetch(INVENTORY_URL).then((r) => r.json())])
+      .then(([boot, comp, act, inventoryData]) => {
+        setPhases({ bootstrap: boot, compaction: comp, active: act })
+        setInv(inventoryData as Inventory)
+        setError(null)
+        setRefreshId((n) => n + 1)
+      })
       .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
   }
-  useEffect(refresh, [])
+  // 挂载时与切换编辑目标后：清单与三阶段预览切到对应 scope。
+  // version 入依赖：保存/写配置成功后 +1，驱动三阶段预览重新拉取
+  // （PreviewTab 的数据源是 phases，不重拉就会一直显示保存前的装配）。
+  useEffect(refresh, [target, version])
+
+  // 枚举已安装的 agent 预设（roster 实时读取），给目标选择器与预览选择器供货。
+  // 抽成函数：保存预设成功后也要立即刷新目标下拉。
+  const fetchPresets = (): void => {
+    fetch(AGENT_PRESETS_URL + `?t=${Date.now()}`)
+      .then((r) => r.json())
+      .then((body) => setAgentPresets(Array.isArray(body?.presets) ? body.presets as AgentPresetInfo[] : []))
+      .catch(() => setAgentPresets([]))
+  }
+  useEffect(() => { fetchPresets() }, [])
 
-  if (snap.status !== 'ready' && snap.value === undefined) {
+  if (cfg === null) {
     return h('div', { style: s.muted }, t('loading'))
   }
 
-  const cfg: Config = snap.value && typeof snap.value === 'object'
-    ? snap.value as Config
-    : { sections: [], replace: {}, inject: [], tools: { exclude: [], include: [] } }
+  // 保存成功/失败后的短促闪示消息（3 秒自动消失；err 用红色样式）。
+  const showFlash = (text: string, kind: 'ok' | 'err' = 'ok'): void => {
+    if (flashTimer.current !== null) clearTimeout(flashTimer.current)
+    setFlash(text)
+    setFlashKind(kind)
+    flashTimer.current = setTimeout(() => setFlash(null), 3200)
+  }
+
+  // 编辑视图：草稿存在时以草稿覆盖对应字段（提示词/工具 Tab 的共享编辑域）。
+  // 草稿只含用户实际编辑过的字段，未编辑字段回落基线 —— 绝不把继承值
+  // 冻结进 override。
+  const base = editView(cfg, target)
+  const view: Config = draft
+    ? {
+        ...base,
+        sections: draft.sections ?? base.sections,
+        sectionsBootstrap: draft.sectionsBootstrap ?? base.sectionsBootstrap,
+        sectionsCompaction: draft.sectionsCompaction ?? base.sectionsCompaction,
+        replace: draft.replace ?? base.replace,
+        inject: draft.inject ?? base.inject,
+        tools: draft.tools ?? base.tools,
+      }
+    : base
+
+  const writeField = (field: string, value: unknown): void => {
+    const url = value === undefined ? CONFIG_UNSET_URL : CONFIG_SET_URL
+    fetch(url, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ field, value }),
+    })
+      .then((r) => r.json())
+      .then((body) => {
+        if (body?.ok !== true) throw new Error(body?.error ?? 'write failed')
+        setCfg(body.config as Config)
+        setError(null)
+        setVersion((n) => n + 1)
+      })
+      .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
+  }
+
+  // 提示词/工具 Tab 的写入：只改内存草稿，不落盘。草稿只记录被编辑的
+  // 这一个字段（不携带其余字段的继承值）—— 保存时也只会提交编辑过的
+  // 字段，未编辑字段继续回落全局 / 继承。target 缺省时写全局顶层；
+  // 预设目标由 /config/apply 写 overrides[id]（字段级接管语义在保存时生效）。
+  const edit = (field: EditField, value: unknown): void => {
+    setDraft((d) => ({
+      ...(d ?? { dirty: false }),
+      [field]: value,
+      dirty: true,
+    }))
+  }
+
+  // 统一保存：草稿里实际编辑过的字段一次 POST 到 /config/apply，成功后清
+  // 草稿并采纳最新配置。失败时保留草稿（改完可以再试，不会丢）。
+  const save = (): void => {
+    if (draft === null || saving) return
+    const EDITED_FIELDS = ['sections', 'sectionsBootstrap', 'sectionsCompaction', 'replace', 'inject', 'tools'] as const
+    const patch: Record<string, unknown> = {}
+    for (const field of EDITED_FIELDS) {
+      if (Object.hasOwn(draft, field)) patch[field] = draft[field]
+    }
+    setSaving(true)
+    fetch(CONFIG_APPLY_URL, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ target, patch }),
+    })
+      .then((r) => r.json())
+      .then((body) => {
+        if (body?.ok !== true) throw new Error(body?.error ?? 'save failed')
+        setCfg(body.config as Config)
+        setDraft(null)
+        setError(null)
+        setVersion((n) => n + 1)
+        showFlash(t('saveOk'))
+      })
+      .catch((e: unknown) => setError(`${t('saveFail')}: ${e instanceof Error ? e.message : String(e)}`))
+      .finally(() => setSaving(false))
+  }
+
+  // 预设 Tab 的「应用」：显式意图直接落盘（不经草稿），完整补丁一次写入
+  // 当前编辑目标（含每阶段独立名单与阶段工具目录）。调用点已在离开编辑域时
+  // 清空草稿，不会有并发草稿写盘。
+  const writePatch = (patch: ConfigPatch): void => {
+    fetch(CONFIG_APPLY_URL, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ target, patch }),
+    })
+      .then((r) => r.json())
+      .then((body) => {
+        if (body?.ok !== true) throw new Error(body?.error ?? 'apply failed')
+        setCfg(body.config as Config)
+        setError(null)
+        setVersion((n) => n + 1)
+      })
+      .catch((e: unknown) => setError(String(e instanceof Error ? e.message : e)))
+  }
+  // 预设库（presets / activePreset）永远保持在全局字段，不分作用域。
+  const writeGlobal = writeField
+  // 提示词 Tab 解除继承自全局的屏蔽时使用的全局通道（与 writeGlobal 同源，
+  // 收窄了字段类型以匹配 SectionsTab 的 prop 签名）。
+  const writeGlobalField = writeField as (field: 'sections', value: unknown) => void
+
+  // 切换 Tab：提示词 ↔ 工具是同一编辑域，草稿保留；切到预设/预览即离开
+  // 编辑域，脏草稿经确认后丢弃。
+  const switchTab = (next: 'sections' | 'tools' | 'presets' | 'preview'): void => {
+    const leaving = (tab === 'sections' || tab === 'tools') && (next === 'presets' || next === 'preview')
+    if (leaving) {
+      if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
+      setDraft(null)
+    }
+    setTab(next)
+  }
+
+  // 切换编辑目标：草稿基线随目标变化，脏草稿先经确认再丢弃。
+  const switchTarget = (next: string | undefined): void => {
+    if (draft?.dirty && !window.confirm(t('discardConfirm'))) return
+    setDraft(null)
+    setTarget(next)
+  }
+
+  // 「存为预设」：把当前编辑内容（含未保存草稿）fork 成一个新的 agent 预设 ——
+  // 宿主 authoring API 整体复制来源预设目录（组成文件 / 伴生 .mjs / 技能目录），
+  // 同时把当前配置写进 overrides[name]。来源 = 当前编辑目标；全局目标由服务端
+  // 回落到 roster 默认预设。名字非法 / 同名由服务端报错。
+  // 返回是否成功，让配置 Tab 用面板内消息条提示（不再用 window.prompt / 顶部按钮）。
+  const saveAsPreset = (presetName: string): Promise<boolean> => {
+    const name = presetName.trim()
+    if (name.length === 0) return Promise.resolve(false)
+    return fetch(PRESETS_CREATE_URL, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({
+        name,
+        from: target,
+        config: {
+          sections: view.sections ?? [],
+          sectionsBootstrap: view.sectionsBootstrap ?? [],
+          sectionsCompaction: view.sectionsCompaction ?? [],
+          replace: view.replace ?? {},
+          inject: view.inject ?? [],
+          tools: view.tools ?? {},
+        },
+      }),
+    })
+      .then((r) => r.json())
+      .then((body) => {
+        if (body?.ok !== true) throw new Error(body?.error ?? t('saveAsPresetFail'))
+        load()
+        fetchPresets()
+        showFlash(t('saveAsPresetOk'), 'ok')
+        return true
+      })
+      .catch((e: unknown) => {
+        showFlash(`${t('saveAsPresetFail')}：${String(e instanceof Error ? e.message : e)}`, 'err')
+        return false
+      })
+  }
 
   return h('div', { style: s.root }, [
     h('div', { style: s.bar }, [
-      h('button', { style: tab === 'sections' ? s.tabActive : s.tab, onClick: () => setTab('sections') }, t('tabsSections')),
-      h('button', { style: tab === 'tools' ? s.tabActive : s.tab, onClick: () => setTab('tools') }, t('tabsTools')),
-      h('button', { style: tab === 'presets' ? s.tabActive : s.tab, onClick: () => setTab('presets') }, t('tabsPresets')),
-      h('button', { style: tab === 'preview' ? s.tabActive : s.tab, onClick: () => setTab('preview') }, t('tabsPreview')),
+      h('button', { style: tab === 'sections' ? s.tabActive : s.tab, onClick: () => switchTab('sections') }, t('tabsSections')),
+      h('button', { style: tab === 'tools' ? s.tabActive : s.tab, onClick: () => switchTab('tools') }, t('tabsTools')),
+      h('button', { style: tab === 'presets' ? s.tabActive : s.tab, onClick: () => switchTab('presets') }, t('tabsPresets')),
+      h('button', { style: tab === 'preview' ? s.tabActive : s.tab, onClick: () => switchTab('preview') }, t('tabsPreview')),
+      h('select', {
+        style: { ...s.input, marginLeft: 6 },
+        value: target ?? '',
+        onChange: (e: { target: { value: string } }) => switchTarget(e.target.value || undefined),
+        title: t('targetHint'),
+      }, [
+        h('option', { value: '', style: s.option }, t('targetGlobal')),
+        ...agentPresets.map((p) => h('option', { key: p.id, value: p.id, style: s.option },
+          `${p.name}${p.broken ? ` (${t('broken')})` : ''}`)),
+      ]),
+      h('button', {
+        style: draft?.dirty ? s.saveBtnDirty : s.saveBtn,
+        disabled: !draft?.dirty || saving,
+        onClick: save,
+      }, t('save')),
       h('button', { style: s.refresh, onClick: refresh }, t('refresh')),
     ]),
     error ? h('div', { style: s.error }, String(error)) : null,
+    flash ? h('div', { style: flashKind === 'err' ? s.error : s.noticeOk }, flash) : null,
+    target && agentPresets.find((p) => p.id === target)?.broken
+      ? h('div', { style: s.error }, t('brokenPreset'))
+      : null,
+    inv?.scopeResolved === false
+      ? h('div', { style: s.noticeWarn }, t('scopeFallback'))
+      : null,
     tab === 'sections'
-      ? h(SectionsTab, { cfg, inv, scope, t })
+      ? h(SectionsTab, {
+          cfg: view,
+          inv,
+          phases,
+          target,
+          globalSections: cfg.sections,
+          ownedSections: target ? cfg.overrides?.[target]?.sections : undefined,
+          t,
+          write: edit,
+          writeGlobalField,
+        })
       : tab === 'tools'
-        ? h(ToolsTab, { cfg, inv, scope, t })
+        ? h(ToolsTab, { cfg: view, inv, phases, t, write: edit })
         : tab === 'presets'
-          ? h(PresetsTab, { cfg, inv, scope, t })
-          : h(PreviewTab, { scope, t }),
+          ? h(PresetsTab, {
+              cfg: view,
+              inv,
+              phases,
+              t,
+              writePatch,
+              writeGlobal,
+              saveAsPreset,
+              forkSource: target ? (agentPresets.find((p) => p.id === target)?.name ?? target) : undefined,
+            })
+          : h(PreviewTab, { t, active: tab === 'preview', refreshId, target, version, phases }),
   ])
 }

package/src/client/locales.ts

@@ -6,7 +6,7 @@ export const DICT = {
     unavailable: '当前环境未启用本命名空间。',
     tabsSections: '提示词',
     tabsTools: '工具',
-    tabsPresets: '预设',
+    tabsPresets: '配置',
     tabsPreview: '预览',
     refresh: '刷新',
     blockedOff: '未屏蔽',
@@ -16,6 +16,7 @@ export const DICT = {
     system: '系统',
     replace: '编辑',
     clearReplace: '清除',
+    clearInput: '清空',
     injectNew: '注入新段',
     name: '名称',
     order: '顺序',
@@ -35,16 +36,79 @@ export const DICT = {
     previewSections: '段',
     previewTools: '工具预览',
     previewToolCount: '个工具',
-    savePreset: '保存当前为预设',
-    presetName: '预设名称',
+    savePreset: '保存当前配置',
+    presetName: '配置名称',
+    saveAsPresetCard: '存为 agent 预设',
+    saveAsPresetHint: '整体复制「{name}」这个预设的组成为新预设（组成文件与伴生脚本一并带走），再把当前定制写进它的覆盖项 —— 新预设出现在顶部编辑目标里。',
+    agentPresetName: '新预设名',
+    forkSourceDefault: '默认预设',
+    saveAsPresetOk: '预设已创建，可在顶部的编辑目标选择器里选到它',
+    saveAsPresetFail: '保存预设失败',
     save: '保存',
-    importPreset: '导入预设',
+    importPreset: '导入配置',
     import: '导入',
     apply: '应用',
     export: '导出',
     delete: '删除',
+    restore: '还原',
     active: '使用中',
     preset: '预设',
+    ioFailed: '导入/导出失败',
+    importInvalid: '无效的配置文件',
+    targetGlobal: '目标：全局默认',
+    targetHint: '选择编辑目标 —— 选中某个 agent 预设后，改动只对该预设生效（字段级覆盖）。',
+    broken: '损坏',
+    brokenPreset: '该 agent 预设当前无法挂载，仍可编辑其定制（修复预设后自动生效）。',
+    phaseBootstrap: '仅引导阶段',
+    phaseActive: '晋级后',
+    phaseCompaction: '压缩后',
+    // agent 周期三阶段的展示命名（引导期 → 常驻期 → 压缩受控期）。
+    phaseStageGuide: '引导期',
+    phaseStageResident: '常驻期',
+    phaseStageControlled: '压缩受控期',
+    toolsPartGuide: '引导期工具',
+    toolsPartResident: '常驻期工具',
+    toolsPartControlled: '压缩受控期工具',
+    allToolsTitle: '本系统全部工具',
+    sectionsPartGuide: '引导期提示词',
+    sectionsPartResident: '常驻期提示词',
+    sectionsPartControlled: '压缩受控期提示词',
+    allSectionsTitle: '本系统全部提示词',
+    toolsFourHint: '三个阶段各一份名单，互不继承：勾选 = 该阶段是否对模型可见；从「全部」拖入某阶段 = 让这一个工具在该阶段出现（若该阶段默认裁掉了它，就加回去）；在两个阶段之间拖动 = 复制（源阶段不动，目标阶段多一份，隐藏/启用状态一起带过去）；拖回「全部」= 从该阶段拿掉它。每个动作只影响被拖的那一个工具。',
+    sectionsFourHint: '拖拽双向：把「全部」里的段拖入上方阶段 = 加入该阶段并默认开启；从阶段拖回「全部」= 从该阶段移除。屏蔽段与普通段完全一样可拖拽 / 编辑，只是不注入模型。',
+    dragHint: '拖入 = 让该工具在这个阶段出现',
+    phaseShortGuide: '引',
+    phaseShortResident: '常',
+    phaseShortControlled: '压',
+    poolMarksHint: '每个名字后的三个标记 = 该工具在引导期 / 常驻期 / 压缩受控期的状态：绿=该阶段可见（或已加回），灰=该阶段已隐藏，暗=不在该阶段、也没加回。',
+    toolAddedTag: '加回',
+    toolAdded: '已把「{name}」加回{phase}：该阶段默认裁掉了它，保存后它会重新出现在该阶段（当前预设注册表里有它）。',
+    toolNotInRegistry: '「{name}」不在本预设的注册表里（它是别的预设独有的工具），当前预设没有它的定义，加不进来。',
+    toolCopied: '已把「{name}」复制到{to}：{from}那份保持不动，隐藏/启用状态一起带过去。',
+    toolShown: '「{name}」已在{to}显示。',
+    toolHiddenIn: '「{name}」已在{to}隐藏。',
+    sectionsTakenOver: '该目标的最终系统提示词由「{name}」段整段接管：宿主在装配瀑布流之后把 sections 强制还原为那一条段，因此本插件的段级屏蔽 / 替换 / 注入 / 排序都不会进入模型看到的提示词（工具过滤仍然生效）。要让段级定制生效，需在该 agent 预设里关掉 persona 的 complete。',
+    sectionsLost: '本插件在该阶段产出的 {emitted} 个段里，只有 {survived} 个进入最终提示词：其余被下游装配规则丢弃，段级定制不会完全生效（工具过滤不受影响）。',
+    sectionBlockedStrip: '（本阶段已屏蔽，模型不可见）',
+    phaseSuppressed: '被抑制（不在任何阶段的装配中）',
+    sectionDynamicNoAdd: '「{name}」是运行时才生成的动态段，没法预先加进某个阶段（它的内容只有装配时才知道）。',
+    exportOk: '导出成功',
+    exportCancel: '已取消导出',
+    exportFail: '导出失败',
+    importOk: '导入完成',
+    importNone: '没有新增预设（同名已存在或文件为空）',
+    importCancel: '已取消导入',
+    importFail: '导入失败',
+    saveOk: '已保存',
+    saveFail: '保存失败',
+    discardConfirm: '有未保存的更改，离开将丢弃。确定离开吗？',
+    scopeFallback: '该 agent 预设的常驻 scope 未能挂载，以下显示的是全局层内容（并非该预设的原生段与工具）。',
+    previewDegraded: '伪会话触发了某个预设插件的异常，本次预览已降级为无会话装配——预设原生的阶段裁剪规则未参与运行。',
+    previewFail: '该阶段装配失败（scope 挂载失败或预设插件异常），请切换目标或查看服务日志。',
+    phaseVisible: '阶段可见',
+    previewToolsHint: '模型实际可见的工具目录（按所选阶段运行预设的全部装配规则，含原生阶段裁剪）：',
+    previewToolsCount: '注册表',
+    saveAsPreset: '存为预设',
   },
   en: {
     nav: 'Prompt Customizer',
@@ -62,6 +126,7 @@ export const DICT = {
     system: 'System',
     replace: 'Replace',
     clearReplace: 'Clear',
+    clearInput: 'Clear',
     injectNew: 'Inject section',
     name: 'Name',
     order: 'Order',
@@ -81,17 +146,80 @@ export const DICT = {
     previewSections: 'sections',
     previewTools: 'Tools preview',
     previewToolCount: 'tools',
-    savePreset: 'Save current as preset',
-    presetName: 'Preset name',
+    savePreset: 'Save current config',
+    presetName: 'Config name',
+    saveAsPresetCard: 'Save as agent preset',
+    saveAsPresetHint: 'Copy the whole "{name}" preset into a new one (composition plus its companion scripts), then write the current customization into its override — the new preset shows up in the target selector above.',
+    agentPresetName: 'New preset name',
+    forkSourceDefault: 'the default preset',
+    saveAsPresetOk: 'Preset created — pick it in the target selector above',
+    saveAsPresetFail: 'Failed to save preset',
     save: 'Save',
     importPreset: 'Import preset',
     import: 'Import',
     apply: 'Apply',
     export: 'Export',
     delete: 'Delete',
+    restore: 'Restore',
     active: 'Active',
     preset: 'Preset',
+    ioFailed: 'Import/export failed',
+    importInvalid: 'Invalid preset file',
+    targetGlobal: 'Target: global default',
+    targetHint: 'Pick an edit target — changes apply only to the chosen agent preset (field-level override).',
+    broken: 'broken',
+    brokenPreset: 'This agent preset cannot mount right now; its customization is still editable and applies once fixed.',
+    phaseBootstrap: 'Bootstrap only',
+    phaseActive: 'After promotion',
+    phaseCompaction: 'Post-compaction',
+    // agent 周期三阶段的展示命名（引导期 → 常驻期 → 压缩受控期）。
+    phaseStageGuide: 'Guide period',
+    phaseStageResident: 'Resident period',
+    phaseStageControlled: 'Compaction-controlled period',
+    toolsPartGuide: 'Guide-period tools',
+    toolsPartResident: 'Resident-period tools',
+    toolsPartControlled: 'Compaction-controlled tools',
+    allToolsTitle: 'All system tools',
+    sectionsPartGuide: 'Guide-period sections',
+    sectionsPartResident: 'Resident-period sections',
+    sectionsPartControlled: 'Compaction-controlled sections',
+    allSectionsTitle: 'All system sections',
+    toolsFourHint: 'Each of the three periods keeps its own list, with no inheritance: the checkbox = visible to the model in that period; dragging a tool from "All" into a period makes it appear there (if the period trims it by default, it is added back); dragging between two periods copies it (the source is untouched, the target gains one, and the hidden/enabled state carries over); dragging it back to "All" removes it from that period. Every action touches only the tool you dragged.',
+    sectionsFourHint: 'Drag both ways: drop a section from "All" onto a period part to enable it there; drag from a part back to "All" to remove it from that period. Blocked sections stay fully operable — they are just not injected.',
+    dragHint: 'Drag in to make this tool appear in this period',
+    phaseShortGuide: 'G',
+    phaseShortResident: 'R',
+    phaseShortControlled: 'C',
+    poolMarksHint: 'The three marks after each name = this tool’s state in the guide / resident / compaction-controlled periods: green = visible there (or added back), grey = hidden there, dim = not present and not added.',
+    toolAddedTag: 'added',
+    toolAdded: 'Added "{name}" back to {phase}: the period trims it by default, so it will reappear there once saved (it exists in this preset’s registry).',
+    toolNotInRegistry: '"{name}" is not in this preset’s registry (it belongs to another preset). There is no definition for it here, so it cannot be added.',
+    toolCopied: 'Copied "{name}" to {to}: the copy in {from} is left untouched, and its hidden/enabled state carries over.',
+    toolShown: '"{name}" is now visible in {to}.',
+    toolHiddenIn: '"{name}" is now hidden in {to}.',
+    sectionsTakenOver: 'The final system prompt here is taken over wholesale by the "{name}" section: the host restores that single section after the assembly waterfall, so this plugin’s section-level blocking / replacement / injection / ordering never reaches the model (tool filtering still applies). To make section customization effective, turn off the persona’s complete flag in this agent preset.',
+    sectionsLost: 'Only {survived} of the {emitted} sections this plugin emitted for this phase reach the final prompt — the rest are dropped by downstream assembly rules, so section-level customization cannot fully apply (tool filtering is unaffected).',
+    sectionBlockedStrip: ' (blocked in this period; invisible to the model)',
+    phaseSuppressed: 'Suppressed (absent from every phase assembly)',
+    sectionDynamicNoAdd: '"{name}" is generated at runtime — it cannot be added to a phase ahead of time (its content is only known during assembly).',
+    exportOk: 'Exported',
+    exportCancel: 'Export cancelled',
+    exportFail: 'Export failed',
+    importOk: 'Import complete',
+    importNone: 'Nothing imported (duplicate names or empty file)',
+    importCancel: 'Import cancelled',
+    importFail: 'Import failed',
+    saveOk: 'Saved',
+    saveFail: 'Save failed',
+    discardConfirm: 'You have unsaved changes; leaving will discard them. Leave anyway?',
+    scopeFallback: "This agent preset's standing scope could not be mounted; what you see is the global layer (not the preset's native sections/tools).",
+    previewDegraded: 'A preset plugin threw on the synthetic session; this preview fell back to an agent-less assembly — native phase rules did not run.',
+    previewFail: 'Assembly for this phase failed (scope mount error or a preset plugin threw); switch target or check the server log.',
+    phaseVisible: 'visible in phase',
+    previewToolsHint: 'Tool catalog as the model actually sees it (all assembly rules run for the selected phase, including native phase narrowing):',
+    previewToolsCount: 'of registry',
+    saveAsPreset: 'Save as preset',
   },
 } as const
 
-export type Translate = (key: string) => string
+export type Translate = (key: string, params?: Record<string, string | number>) => string