dsh-prompt-customizer 0.4.0 → 0.4.2

package/lib/sectionOps.mjs

@@ -1,134 +1,129 @@
-/**
- * 提示词段面板的纯状态逻辑（无 React / 无 IO）。
- * 与 src/client/SectionsTab.tsx 共享同一份实现（浏览器里随 client bundle
- * 打包；node --test 直接 import 本文件跑单测），保证「测试即上线代码」。
- *
- * 阶段模型：引导期（bootstrap）/ 常驻期（active）/ 压缩受控期（compaction）
- * 恒定全部显示（预设没有某个阶段时该部分就是空的），各自拥有独立的注入
- * 名单与 order 空间；屏蔽按「每阶段独立名单」写回（引导期 →
- * sectionsBootstrap，压缩受控期 → sectionsCompaction，常驻期 → 全局 sections）。
- * 入参统一是名义阶段键，不再有「同形折叠组」这种把引导期当常驻期用的形态。
- */
-
-/** 名义阶段键 → 屏蔽名单写回目标（常驻期用全局 sections）。 */
-export function sectionListOf(key) {
-  return key === 'bootstrap' ? 'bootstrap' : key === 'compaction' ? 'compaction' : 'global'
-}
-
-/** 名义阶段键 → 注入阶段：压缩受控期是独立注入阶段（compaction）。 */
-export function injectPhaseOf(key) {
-  return key === 'bootstrap' ? 'bootstrap' : key === 'active' ? 'active' : 'compaction'
-}
-
-/** 某注入段出现在哪些阶段部分：always 全阶段；bootstrap/compaction/active
- *  仅各自对应的阶段（与服务端 filterInjectByPhase 的三态互相独立一致）。 */
-export function acceptsInjectFor(key, phase) {
-  if (phase === 'always') return true
-  return phase === key
-}
-
-/** 该阶段生效的屏蔽名单（全局 + 阶段独立 的 union）。 */
-export function deniedNames(cfg, key) {
-  const list = sectionListOf(key)
-  const phase = list === 'bootstrap' ? (cfg.sectionsBootstrap ?? []) : list === 'compaction' ? (cfg.sectionsCompaction ?? []) : []
-  return [...(cfg.sections ?? []), ...phase]
-}
-
-/**
- * 某个阶段部分当前的注入身份（含未保存草稿）。
- *
- * `names` = 本部分可见的注入段名（本阶段专属 + 跨阶段的 always）。post 视图来自
- * 「上次保存」的服务端结果，删除只改草稿，所以 post 独有段必须有 names 背书才
- * 能显示 —— 否则刚删掉的自定义段会以「系统段」复活（身份只认 custom 标记，条目
- * 没了就被判成系统），再经一次重排就被写成 custom:false 空文本，用户填的内容被
- * 抹平。`custom` 只收真正的自定义段，`order` 只收本阶段的草稿序。
- *
- * `text` = 本阶段生效的用户文本：自定义段自带的文本，以及**系统段在本阶段被
- * 替换后的文本**（非空即替换）。系统段的文本必须按阶段存 —— 注入条目本来就带
- * `phase`，服务端按阶段筛选，所以三个阶段各改各的文本互不影响；旧的全局
- * `replace` 字典一份文本对三个阶段同时生效，已不承担界面编辑。
- */
-export function injectedAt(cfg, key) {
-  const phase = injectPhaseOf(key)
-  const names = new Set()
-  const custom = new Set()
-  const text = new Map()
-  const order = new Map()
-  for (const item of cfg.inject ?? []) {
-    if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
-    const itemPhase = item.phase ?? 'always'
-    if (itemPhase === phase) order.set(item.name, item.order ?? 0)
-    if (!acceptsInjectFor(key, itemPhase)) continue
-    names.add(item.name)
-    if (item.text && !text.has(item.name)) text.set(item.name, item.text)
-    if (item.custom === true) custom.add(item.name)
-  }
-  return { phase, names, custom, text, order }
-}
-
-/**
- * 屏蔽/恢复一个段（当前阶段语义）：返回需要写盘的字段补丁。
- * - 屏蔽：该阶段名单加入（常驻期直接加入全局 sections）。
- * - 恢复：从该阶段名单与全局名单同时移除（union 语义 —— 否则仍会被另一
- *   份名单挡住，恢复不生效）。
- * 名单无变化时不产出字段（空补丁 = 不写盘），避免把继承值冻结成无意义的
- * 空数组覆盖。
- */
-export function blockPatch(cfg, key, name, blocked) {
-  const list = sectionListOf(key)
-  const g = (cfg.sections ?? []).slice()
-  const gi = g.indexOf(name)
-  const patch = {}
-  if (list === 'global') {
-    if (blocked) { if (gi < 0) { g.push(name); patch.sections = g } }
-    else if (gi >= 0) { g.splice(gi, 1); patch.sections = g }
-    return patch
-  }
-  const field = list === 'bootstrap' ? 'sectionsBootstrap' : 'sectionsCompaction'
-  const phase = (cfg[field] ?? []).slice()
-  const pi = phase.indexOf(name)
-  if (blocked) {
-    if (pi < 0) { phase.push(name); patch[field] = phase }
-  } else {
-    if (pi >= 0) { phase.splice(pi, 1); patch[field] = phase }
-    if (gi >= 0) { g.splice(gi, 1); patch.sections = g }
-  }
-  return patch
-}
-
-/**
- * 重排/插入一个阶段的有序行列表：把 dragName 从列表中移除后，插入到
- * targetName 行之上（pos='above'）或之下（pos='below'）；返回新列表。
- * 拖入的新段由调用方以 newRow 提供，插入后保留在列表中（其余行保持原样）。
- */
-export function reorderInsert(rows, dragName, targetName, pos, newRow = null) {
-  const base = rows.filter((row) => row.name !== dragName)
-  const idx = base.findIndex((row) => row.name === targetName)
-  if (idx < 0) return null
-  const insertAt = Math.max(0, Math.min(pos === 'above' ? idx : idx + 1, base.length))
-  const entry = newRow ?? rows.find((row) => row.name === dragName)
-  if (!entry) return null
-  base.splice(insertAt, 0, entry)
-  return base
-}
-
-/**
- * 持久化一个阶段的有序列表（v1 persistOrder 的逐阶段版）：把 rows（有序行）
- * 写成该阶段的注入条目，order = 连续整数（0,1,2,…）——「虚拟 order 决定注入
- * 顺序」；文本优先级 = 本阶段的用户替换文本（row.override）→ 自定义段自带的
- * 文本（row.text）→ 空文本（= 仅 order 覆盖，服务端保留原文）。三者缺一不可：
- * 重排走的就是这个函数，漏掉 override 会让一次拖动把用户在该阶段改的文本抹平。
- * 其它阶段（含 always）的注入条目原样保留。
- */
-export function phaseInjectEntries(cfg, key, rows) {
-  const phase = injectPhaseOf(key)
-  const others = (cfg.inject ?? []).filter((item) => (item.phase ?? 'always') !== phase)
-  const entries = rows.map((row, i) => ({
-    name: row.name,
-    order: i,
-    text: row.override || (row.custom ? (row.text ?? '') : ''),
-    phase,
-    custom: row.custom,
-  }))
-  return [...others, ...entries]
+/**
+ * 提示词段面板的纯状态逻辑（无 React / 无 IO）。
+ * 与 src/client/SectionsTab.tsx 共享同一份实现（浏览器里随 client bundle
+ * 打包；node --test 直接 import 本文件跑单测），保证「测试即上线代码」。
+ *
+ * 阶段模型：引导期（bootstrap）/ 常驻期（active）/ 压缩受控期（compaction）
+ * 恒定全部显示（预设没有某个阶段时该部分就是空的），各自拥有独立的注入
+ * 名单与 order 空间；屏蔽按「每阶段独立名单」写回（引导期 →
+ * sectionsBootstrap，压缩受控期 → sectionsCompaction，常驻期 → 全局 sections）。
+ * 入参统一是名义阶段键，不再有「同形折叠组」这种把引导期当常驻期用的形态。
+ */
+
+/** 名义阶段键 → 屏蔽名单写回目标（常驻期用全局 sections）。 */
+export function sectionListOf(key) {
+  return key === 'bootstrap' ? 'bootstrap' : key === 'compaction' ? 'compaction' : 'global'
+}
+
+/** 名义阶段键 → 注入阶段：压缩受控期是独立注入阶段（compaction）。 */
+export function injectPhaseOf(key) {
+  return key === 'bootstrap' ? 'bootstrap' : key === 'active' ? 'active' : 'compaction'
+}
+
+/** 某注入段出现在哪些阶段部分：always 全阶段；bootstrap/compaction/active
+ *  仅各自对应的阶段（与服务端 filterInjectByPhase 的三态互相独立一致）。 */
+export function acceptsInjectFor(key, phase) {
+  if (phase === 'always') return true
+  return phase === key
+}
+
+/** 该阶段自己的屏蔽名单（三态互相独立：引导期 sectionsBootstrap /
+ *  压缩受控期 sectionsCompaction / 常驻期 sections，互不继承、互不影响）。 */
+export function deniedNames(cfg, key) {
+  const list = sectionListOf(key)
+  return list === 'bootstrap' ? (cfg.sectionsBootstrap ?? [])
+    : list === 'compaction' ? (cfg.sectionsCompaction ?? [])
+    : (cfg.sections ?? [])
+}
+
+/**
+ * 某个阶段部分当前的注入身份（含未保存草稿）。
+ *
+ * `names` = 本部分可见的注入段名（本阶段专属 + 跨阶段的 always）。post 视图来自
+ * 「上次保存」的服务端结果，删除只改草稿，所以 post 独有段必须有 names 背书才
+ * 能显示 —— 否则刚删掉的自定义段会以「系统段」复活（身份只认 custom 标记，条目
+ * 没了就被判成系统），再经一次重排就被写成 custom:false 空文本，用户填的内容被
+ * 抹平。`custom` 只收真正的自定义段，`order` 只收本阶段的草稿序。
+ *
+ * `text` = 本阶段生效的用户文本：自定义段自带的文本，以及**系统段在本阶段被
+ * 替换后的文本**（非空即替换）。系统段的文本必须按阶段存 —— 注入条目本来就带
+ * `phase`，服务端按阶段筛选，所以三个阶段各改各的文本互不影响；旧的全局
+ * `replace` 字典一份文本对三个阶段同时生效，已不承担界面编辑。
+ */
+export function injectedAt(cfg, key) {
+  const phase = injectPhaseOf(key)
+  const names = new Set()
+  const custom = new Set()
+  const text = new Map()
+  const order = new Map()
+  for (const item of cfg.inject ?? []) {
+    if (item === null || typeof item !== 'object' || typeof item.name !== 'string') continue
+    const itemPhase = item.phase ?? 'always'
+    if (itemPhase === phase) order.set(item.name, item.order ?? 0)
+    if (!acceptsInjectFor(key, itemPhase)) continue
+    names.add(item.name)
+    if (item.text && !text.has(item.name)) text.set(item.name, item.text)
+    if (item.custom === true) custom.add(item.name)
+  }
+  return { phase, names, custom, text, order }
+}
+
+/**
+ * 屏蔽/恢复一个段（当前阶段语义）：返回需要写盘的字段补丁。
+ * 三态名单互相独立：只读写本阶段自己的名单（引导期 → sectionsBootstrap，
+ * 压缩受控期 → sectionsCompaction，常驻期 → sections），屏蔽 / 恢复都绝不
+ * 波及其它阶段的名单 —— 一个阶段的屏蔽不再连带屏蔽另一个阶段。
+ * 名单无变化时不产出字段（空补丁 = 不写盘），避免把继承值冻结成无意义的
+ * 空数组覆盖。
+ */
+export function blockPatch(cfg, key, name, blocked) {
+  const list = sectionListOf(key)
+  const field = list === 'bootstrap' ? 'sectionsBootstrap' : list === 'compaction' ? 'sectionsCompaction' : 'sections'
+  const cur = (cfg[field] ?? []).slice()
+  const i = cur.indexOf(name)
+  if (blocked) {
+    if (i >= 0) return {}
+    cur.push(name)
+  } else {
+    if (i < 0) return {}
+    cur.splice(i, 1)
+  }
+  return { [field]: cur }
+}
+
+/**
+ * 重排/插入一个阶段的有序行列表：把 dragName 从列表中移除后，插入到
+ * targetName 行之上（pos='above'）或之下（pos='below'）；返回新列表。
+ * 拖入的新段由调用方以 newRow 提供，插入后保留在列表中（其余行保持原样）。
+ */
+export function reorderInsert(rows, dragName, targetName, pos, newRow = null) {
+  const base = rows.filter((row) => row.name !== dragName)
+  const idx = base.findIndex((row) => row.name === targetName)
+  if (idx < 0) return null
+  const insertAt = Math.max(0, Math.min(pos === 'above' ? idx : idx + 1, base.length))
+  const entry = newRow ?? rows.find((row) => row.name === dragName)
+  if (!entry) return null
+  base.splice(insertAt, 0, entry)
+  return base
+}
+
+/**
+ * 持久化一个阶段的有序列表（v1 persistOrder 的逐阶段版）：把 rows（有序行）
+ * 写成该阶段的注入条目，order = 连续整数（0,1,2,…）——「虚拟 order 决定注入
+ * 顺序」；文本优先级 = 本阶段的用户替换文本（row.override）→ 自定义段自带的
+ * 文本（row.text）→ 空文本（= 仅 order 覆盖，服务端保留原文）。三者缺一不可：
+ * 重排走的就是这个函数，漏掉 override 会让一次拖动把用户在该阶段改的文本抹平。
+ * 其它阶段（含 always）的注入条目原样保留。
+ */
+export function phaseInjectEntries(cfg, key, rows) {
+  const phase = injectPhaseOf(key)
+  const others = (cfg.inject ?? []).filter((item) => (item.phase ?? 'always') !== phase)
+  const entries = rows.map((row, i) => ({
+    name: row.name,
+    order: i,
+    text: row.override || (row.custom ? (row.text ?? '') : ''),
+    phase,
+    custom: row.custom,
+  }))
+  return [...others, ...entries]
 }

package/lib/store.js

@@ -1,124 +1,124 @@
-/**
- * 插件自有配置存储 —— `~/.dsh/prompt-customizer/config.yaml`。
- *
- * 背景：宿主 SettingsProvider 把所有插件命名空间都存在主文档
- * （settings.yaml）里，插件无法选择存储位置；本插件改为自带文件存储，
- * 让主文档不再被本插件的配置膨胀。
- *
- * 语义：
- *  - 新文件是唯一权威（读写都走这里）。
- *  - 懒加载：每次读取做 stat，mtime 变了才重新解析——外部手工编辑在下次
- *    读取时自然生效，不需要 fs.watch。
- *  - 原子写：先写同目录临时文件再 rename。
- *  - last-good：文件损坏或 schema 校验失败时，沿用上一次合法值并告警一次，
- *    绝不让一个坏文件拖垮装配瀑布流。
- */
-
-import fs from 'node:fs'
-import path from 'node:path'
-import { parse, stringify } from 'yaml'
-
-/** 新 yml 文件的头部注释（让手工编辑者知道这是什么）。 */
-const HEADER = '# dsh-prompt-customizer 配置（唯一权威）。\n' +
-  '# 手工编辑即时生效（下次读取时）；删除本文件后重启会从旧版 settings.yaml 迁移。\n'
-
-/** 读主文档（旧版 settings.yaml）里本插件的旧段；主文档缺失或段不存在返回 undefined。 */
-export function readLegacySection(masterPath, ns) {
-  if (!masterPath) return undefined
-  let doc
-  try {
-    doc = parse(fs.readFileSync(masterPath, 'utf8'))
-  } catch {
-    return undefined
-  }
-  const section = doc?.[ns]
-  return section !== null && typeof section === 'object' && !Array.isArray(section) && Object.keys(section).length > 0
-    ? section
-    : undefined
-}
-
-/** 创建一个配置存储实例。schema 用于在读取时补默认值并校验；header 可覆盖
- *  文件头注释（派生缓存类文件需要说明自己不是配置）。 */
-export function createConfigStore({ file, schema, warn, header = HEADER } = {}) {
-  if (!file) throw new TypeError('createConfigStore: file is required')
-  /** { stamp, raw, resolved, error } — stamp 为 undefined 表示文件不存在。 */
-  let cache
-  let warned = false
-  const warnOnce = (message) => {
-    if (warned) return
-    warned = true
-    try { warn?.(message) } catch { /* logger 缺席只是不再告警 */ }
-  }
-
-  /** 用 schema 解析（补默认值 + 校验）；失败返回 { value: null, error }。 */
-  const resolve = (raw) => {
-    if (schema === undefined) return { value: raw ?? {}, error: undefined }
-    try { return { value: schema(raw ?? {}), error: undefined } } catch (error) { return { value: null, error } }
-  }
-
-  /** stat 驱动的懒加载；返回完整缓存条目。 */
-  const load = () => {
-    let stamp
-    try { stamp = fs.statSync(file).mtimeMs } catch { stamp = undefined }
-    if (cache && cache.stamp === stamp) return cache
-    if (stamp === undefined) {
-      cache = { stamp, raw: undefined, ...resolve(undefined) }
-      return cache
-    }
-    let raw
-    let error
-    try {
-      raw = parse(fs.readFileSync(file, 'utf8'))
-      if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
-        raw = undefined
-        error = new Error('config.yaml 的顶层必须是映射')
-      }
-    } catch (e) {
-      raw = undefined
-      error = e
-    }
-    const r = raw === undefined ? { value: null, error } : resolve(raw)
-    // raw 保留磁盘上的真实解析结果（即使 schema 失败）——写合并不应静默丢字段。
-    cache = { stamp, raw, ...r }
-    // 任何一次成功解析（含写入后的校验）都刷新 last-good。
-    if (r.value !== null) lastGood = r.value
-    return cache
-  }
-
-  /** 上一次 schema 校验通过的解析结果（坏文件时的 last-good 回落）。 */
-  let lastGood
-
-  return {
-    /** 当前存储的原始用户段（未补默认值）；无文件时 undefined。 */
-    raw() {
-      return load().raw
-    },
-
-    /** 解析后的生效配置（默认值已补；坏文件回落 last-good，再回落纯默认值）。 */
-    readResolved() {
-      const entry = load()
-      if (entry.value !== null) return entry.value
-      warnOnce(`prompt-customizer: 配置文件不可用，回落到最近一次合法配置：${String(entry.error && entry.error.message ? entry.error.message : entry.error)}`)
-      return lastGood ?? resolve(undefined).value
-    },
-
-    /** 原子写入一个完整用户段；写入后立刻刷新缓存。 */
-    writeSection(section) {
-      fs.mkdirSync(path.dirname(file), { recursive: true })
-      const tmp = `${file}.${process.pid}.tmp`
-      fs.writeFileSync(tmp, header + stringify(section ?? {}))
-      fs.renameSync(tmp, file)
-      cache = undefined
-      return load()
-    },
-
-    /** 写单个字段（值 undefined 表示删除）；基于当前权威段合并。 */
-    setField(field, value) {
-      const base = this.raw()
-      const section = { ...(base ?? {}) }
-      if (value === undefined) delete section[field]
-      else section[field] = value
-      return this.writeSection(section)
-    },
-  }
-}
+/**
+ * 插件自有配置存储 —— `~/.dsh/prompt-customizer/config.yaml`。
+ *
+ * 背景：宿主 SettingsProvider 把所有插件命名空间都存在主文档
+ * （settings.yaml）里，插件无法选择存储位置；本插件改为自带文件存储，
+ * 让主文档不再被本插件的配置膨胀。
+ *
+ * 语义：
+ *  - 新文件是唯一权威（读写都走这里）。
+ *  - 懒加载：每次读取做 stat，mtime 变了才重新解析——外部手工编辑在下次
+ *    读取时自然生效，不需要 fs.watch。
+ *  - 原子写：先写同目录临时文件再 rename。
+ *  - last-good：文件损坏或 schema 校验失败时，沿用上一次合法值并告警一次，
+ *    绝不让一个坏文件拖垮装配瀑布流。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { parse, stringify } from 'yaml'
+
+/** 新 yml 文件的头部注释（让手工编辑者知道这是什么）。 */
+const HEADER = '# dsh-prompt-customizer 配置（唯一权威）。\n' +
+  '# 手工编辑即时生效（下次读取时）；删除本文件后重启会从旧版 settings.yaml 迁移。\n'
+
+/** 读主文档（旧版 settings.yaml）里本插件的旧段；主文档缺失或段不存在返回 undefined。 */
+export function readLegacySection(masterPath, ns) {
+  if (!masterPath) return undefined
+  let doc
+  try {
+    doc = parse(fs.readFileSync(masterPath, 'utf8'))
+  } catch {
+    return undefined
+  }
+  const section = doc?.[ns]
+  return section !== null && typeof section === 'object' && !Array.isArray(section) && Object.keys(section).length > 0
+    ? section
+    : undefined
+}
+
+/** 创建一个配置存储实例。schema 用于在读取时补默认值并校验；header 可覆盖
+ *  文件头注释（派生缓存类文件需要说明自己不是配置）。 */
+export function createConfigStore({ file, schema, warn, header = HEADER } = {}) {
+  if (!file) throw new TypeError('createConfigStore: file is required')
+  /** { stamp, raw, resolved, error } — stamp 为 undefined 表示文件不存在。 */
+  let cache
+  let warned = false
+  const warnOnce = (message) => {
+    if (warned) return
+    warned = true
+    try { warn?.(message) } catch { /* logger 缺席只是不再告警 */ }
+  }
+
+  /** 用 schema 解析（补默认值 + 校验）；失败返回 { value: null, error }。 */
+  const resolve = (raw) => {
+    if (schema === undefined) return { value: raw ?? {}, error: undefined }
+    try { return { value: schema(raw ?? {}), error: undefined } } catch (error) { return { value: null, error } }
+  }
+
+  /** stat 驱动的懒加载；返回完整缓存条目。 */
+  const load = () => {
+    let stamp
+    try { stamp = fs.statSync(file).mtimeMs } catch { stamp = undefined }
+    if (cache && cache.stamp === stamp) return cache
+    if (stamp === undefined) {
+      cache = { stamp, raw: undefined, ...resolve(undefined) }
+      return cache
+    }
+    let raw
+    let error
+    try {
+      raw = parse(fs.readFileSync(file, 'utf8'))
+      if (raw === null || typeof raw !== 'object' || Array.isArray(raw)) {
+        raw = undefined
+        error = new Error('config.yaml 的顶层必须是映射')
+      }
+    } catch (e) {
+      raw = undefined
+      error = e
+    }
+    const r = raw === undefined ? { value: null, error } : resolve(raw)
+    // raw 保留磁盘上的真实解析结果（即使 schema 失败）——写合并不应静默丢字段。
+    cache = { stamp, raw, ...r }
+    // 任何一次成功解析（含写入后的校验）都刷新 last-good。
+    if (r.value !== null) lastGood = r.value
+    return cache
+  }
+
+  /** 上一次 schema 校验通过的解析结果（坏文件时的 last-good 回落）。 */
+  let lastGood
+
+  return {
+    /** 当前存储的原始用户段（未补默认值）；无文件时 undefined。 */
+    raw() {
+      return load().raw
+    },
+
+    /** 解析后的生效配置（默认值已补；坏文件回落 last-good，再回落纯默认值）。 */
+    readResolved() {
+      const entry = load()
+      if (entry.value !== null) return entry.value
+      warnOnce(`prompt-customizer: 配置文件不可用，回落到最近一次合法配置：${String(entry.error && entry.error.message ? entry.error.message : entry.error)}`)
+      return lastGood ?? resolve(undefined).value
+    },
+
+    /** 原子写入一个完整用户段；写入后立刻刷新缓存。 */
+    writeSection(section) {
+      fs.mkdirSync(path.dirname(file), { recursive: true })
+      const tmp = `${file}.${process.pid}.tmp`
+      fs.writeFileSync(tmp, header + stringify(section ?? {}))
+      fs.renameSync(tmp, file)
+      cache = undefined
+      return load()
+    },
+
+    /** 写单个字段（值 undefined 表示删除）；基于当前权威段合并。 */
+    setField(field, value) {
+      const base = this.raw()
+      const section = { ...(base ?? {}) }
+      if (value === undefined) delete section[field]
+      else section[field] = value
+      return this.writeSection(section)
+    },
+  }
+}