dsh-custom-mode 2.2.6 → 2.3.1

package/composition.mjs

@@ -24,6 +24,18 @@
 
 import { readFileSync, existsSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
+import { AsyncLocalStorage } from 'node:async_hooks'
+import { decodeJsExpression, evaluateDisabledPredicate } from './preset-backend/parse-composition.mjs'
+
+// Capabilities belong to the request that observed them, never to a module-global
+// host context. Store only known booleans, not service objects or arbitrary ctx access.
+const predicateCapabilities = new AsyncLocalStorage()
+export function withPredicateCapabilities(snapshot, work) {
+  const capabilities = typeof snapshot?.profileContext === 'boolean'
+    ? Object.freeze({ profileContext: snapshot.profileContext })
+    : Object.freeze({})
+  return predicateCapabilities.run(capabilities, work)
+}
 
 // 出厂组成「从哪来」是两条 dsh 线唯一还没收进后端的一处：旧线是文件，0.1.7 是
 // agentPresets.readDocument()。解析链整个搬到了 base-composition.mjs（含它的理由与实测），
@@ -460,7 +472,7 @@ function setDisabled(segmentText, disabled) {
     const shipped = lines[index].trim().replace(/^disabled:\s*/, '')
     if (disabled) {
       lines[index] = `${' '.repeat(indent)}disabled: true${carriage}`
-    } else if (shipped.startsWith('!!js') && evalDisabledExpression(shipped) !== true) {
+    } else if (shipped.startsWith('!!js') && evalDisabledExpression(shipped) === false) {
       // 显式打开，但出厂那行是平台表达式、且它在本机求值就是"开"：这不是覆盖，而是**撤销覆盖** ——
       // 保持出厂表达式原样，这一行就回到"跟随平台"。（原先这里删掉整行，结果是文件既不是出厂原样、
       // 也不是显式覆盖，页面却显示"未拨过" —— 文件与显示同时失真。）
@@ -496,9 +508,8 @@ function setDisabled(segmentText, disabled) {
 function evalDisabledExpression(expression) {
   if (typeof expression !== 'string' || !expression.startsWith('!!js')) return undefined
   try {
-    // eslint-disable-next-line no-new-func -- evaluating the composition's own predicate is the point
-    const fn = new Function('process', `return (${expression.slice(4).trim()});`)
-    return fn(process) === true
+    const source = decodeJsExpression(expression.slice(4))
+    return evaluateDisabledPredicate(source, predicateCapabilities.getStore())
   } catch {
     // 求值失败与「表达式不存在」都是 undefined。调用方若已经确认这是 `!!js`，
     // 必须把 undefined 当成关闭：挂载侧同样按关闭处理，两边不能一个开一个关。
@@ -1020,13 +1031,19 @@ export function overridesOf(text, modeId) {
     // 某个字面量一致 —— 只看求值结果，会把"表达式被换成字面量"误判成"没动过"。
     const sameForm = baseRow !== undefined
       && baseRow.disabled === row.disabled
-      && baseRow.disabledExpression === row.disabledExpression
+      && predicateForm(baseRow.disabledExpression) === predicateForm(row.disabledExpression)
     if (sameForm) continue
     overrides[id] = row.disabled !== true
   }
   return overrides
 }
 
+/** YAML quoting is transport syntax, while literal versus expression remains significant. */
+function predicateForm(expression) {
+  if (typeof expression !== 'string') return expression
+  try { return decodeJsExpression(expression.slice(4)) } catch { return expression }
+}
+
 /**
  * 按允许名单生成显式开关。
  *

package/index.mjs

@@ -55,7 +55,8 @@ import {
   effectiveRosterRows,
 } from './preset-backend/index.mjs'
 import { existsSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
-import { dirname, join } from 'node:path'
+import { createHash } from 'node:crypto'
+import { basename, dirname, join } from 'node:path'
 import { PROMPT_PATH, COMPOSITION_PATH, ROUTE_PATH, PRESET_DIR, dshHome } from './paths.mjs'
 import { ensureUnsetDefaultPreset } from './defaults.mjs'
 import {
@@ -76,6 +77,7 @@ import {
   setBaseCompositions,
   setShippedPresetsDir,
   unresolvableRows,
+  withPredicateCapabilities,
 } from './composition.mjs'
 import { presetMetaText, readPresetMeta, writePresetMeta, presetMetaPath, PRESET_META_PATH } from './meta.mjs'
 import { listHistory, readVersion, recordExternalChange, recordPrompt, HISTORY_SOURCE } from './journal.mjs'
@@ -373,11 +375,42 @@ export function brokenRowIds(message) {
   return [...new Set(ids)]
 }
 
+/**
+ * An opaque content revision of the complete editable state. Length framing and
+ * an explicit missing marker distinguish absent files from empty ones. History
+ * is deliberately excluded: losing an audit write must not disable conflict checks.
+ */
+export function stateRevision(directory) {
+  return revisionWithEntries(directory)
+}
+
+function revisionWithEntries(directory, entries = []) {
+  const replacements = new Map(entries.map(([file, text]) => [basename(file), Buffer.from(text, 'utf8')]))
+  const hash = createHash('sha256')
+  for (const name of ['prompt.md', 'preset.yml', 'agent.cordis.yml']) {
+    hash.update(name + '\0')
+    let bytes
+    try {
+      bytes = replacements.has(name) ? replacements.get(name) : readFileSync(join(directory, name))
+    } catch (error) {
+      if (error.code !== 'ENOENT') throw error
+      hash.update('missing\0')
+      continue
+    }
+    hash.update('present:' + String(bytes.length) + '\0')
+    hash.update(bytes)
+  }
+  return hash.digest('hex')
+}
+
 export function readState(rows, id, options = {}) {
   const directory = assistantDir(rows, id)
   if (directory === undefined) return unknownAssistant(id)
   const recovery = restoreBackups(directory)
   if (recovery.ok !== true) return { ok: false, code: 'recoveryRequired', params: { path: directory, detail: recovery.detail }, error: '助手文件需要恢复：' + recovery.detail }
+  // Take the token before reading the displayed fields. A later external edit
+  // can then cause a conservative conflict, never bless an older displayed value.
+  const revision = stateRevision(directory)
   const composition = compositionFile(directory)
   if (!existsSync(composition)) return { ok: false, code: 'compositionMissing', params: { path: composition }, error: '找不到组成文件：' + composition }
   const text = readFileSync(composition, 'utf8')
@@ -423,6 +456,7 @@ export function readState(rows, id, options = {}) {
   return {
     ok: true,
     id,
+    revision,
     mode,
     modes: BASE_MODES,
     rows: rowTree,
@@ -468,7 +502,7 @@ export function readState(rows, id, options = {}) {
 }
 
 /**
- * The list payload: every managed assistant, plus the root they live in.
+ * The list payload: managed assistants, their root, and the running plugin version.
  *
  * @param {Array<object>} rows - the current roster.
  */
@@ -478,7 +512,7 @@ export function readList(rows) {
   const list = assistantsFromRoster(rows).map((item) =>
     typeof item.broken === 'string' ? { ...item, brokenRows: brokenRowIds(item.broken) } : item,
   )
-  return { ok: true, assistants: list, postures: publicPostures(), root: userPresetRoot(rows) }
+  return { ok: true, assistants: list, postures: publicPostures(), root: userPresetRoot(rows), version: PLUGIN_VERSION }
 }
 
 /**
@@ -503,33 +537,75 @@ const writeChains = new Map()
 /**
  * 打开页面之后、按下保存之前，`prompt.md` 可能已被会话工具或手工改过。
  *
- * 先把磁盘上的那一版记进历史。页面带了 JSON 数字 `baseN`，且那个版本不是磁盘上这一版时，
- * 拒绝写入：磁盘保持外部文本。不带 `baseN` 的旧客户端仍覆盖，但原文已经在历史里。
- * 数字字符串不算 `baseN`。留痕自己失败时不挡住这次保存。
+ * 新页面用 baseRevision 比较三个编辑文件的原始内容。旧页面的 JSON 数字
+ * baseN 仍比较提示词历史；没有 token 的旧 API 保留覆盖语义。
+ * 冲突判定与审计写入隔离：历史不可写时也不能放行过期草稿。
  *
  * @param {string} directory
  * @param {string} prompt - the text this save wants to write.
  * @param {unknown} baseN
+ * @param {unknown} baseRevision - opaque revision returned when the draft was loaded.
  * @returns {object|null} a `conflict` result, or null when the write may proceed.
  */
-function refuseStalePrompt(directory, prompt, baseN) {
-  try {
-    const diskPrompt = readPrompt(directory)
-    if (diskPrompt.ok !== true || diskPrompt.text === prompt) return null
-    recordExternalChange(directory, diskPrompt.text)
-    if (typeof baseN === 'number' && readVersion(directory, baseN) !== diskPrompt.text) {
-      return {
-        ok: false,
-        code: 'conflict',
-        params: { baseN },
-        error: '磁盘上的提示词已经变了，这次保存没有写入。',
-        note: '磁盘上的提示词已经变了，这次保存没有写入。',
+function refuseStaleState(directory, prompt, baseN, baseRevision) {
+  const diskPrompt = readPrompt(directory)
+  let stale = false
+  if (typeof baseRevision === 'string') {
+    try {
+      stale = stateRevision(directory) !== baseRevision
+    } catch {
+      // An unreadable editable file cannot prove the loaded baseline is current.
+      stale = true
+    }
+  } else if (typeof baseN === 'number') {
+    stale = diskPrompt.ok !== true || (diskPrompt.text !== prompt && readVersion(directory, baseN) !== diskPrompt.text)
+  }
+  if (diskPrompt.ok === true && diskPrompt.text !== prompt) {
+    try {
+      recordExternalChange(directory, diskPrompt.text)
+    } catch {
+      /* 审计留痕失败不改变上面已经完成的冲突判定 */
+    }
+  }
+  return stale ? {
+    ok: false,
+    code: 'conflict',
+    params: typeof baseRevision === 'string' ? {} : { baseN },
+    error: '磁盘上的助手文件已经变了或无法核对，这次保存没有写入。',
+    note: '磁盘上的助手文件已经变了或无法核对，这次保存没有写入。',
+  } : null
+}
+
+/** Reordering writes every assistant's metadata, so validate all held baselines first. */
+function reorderState(rows, input) {
+  const baselines = input?.baseRevisions
+  if (baselines !== null && typeof baselines === 'object') {
+    for (const [id, revision] of Object.entries(baselines)) {
+      const directory = assistantDir(rows, id)
+      if (directory === undefined || typeof revision !== 'string') {
+        return { ok: false, code: 'conflict', params: {}, error: '助手列表或文件已经变了，这次排序没有写入。' }
       }
+      const conflict = refuseStaleState(directory, readPrompt(directory).text ?? '', undefined, revision)
+      if (conflict !== null) return conflict
     }
-  } catch {
-    /* 审计留痕失败不挡住这次保存 */
   }
-  return null
+  const ids = new Map(assistantsFromRoster(rows).map(({ id }) => [assistantDir(rows, id), id]))
+  const revisions = {}
+  const result = reorderAssistant(rows, input, (name, description, directory, options) => {
+    const rendered = presetMetaText(name, description, directory, options)
+    if (rendered.ok !== true) return rendered
+    try {
+      const entries = [[presetMetaPath(directory), rendered.text]]
+      const revision = revisionWithEntries(directory, entries)
+      writeAtomic(presetMetaPath(directory), rendered.text)
+      revisions[ids.get(directory)] = revision
+      return { ok: true, name: rendered.name }
+    } catch (error) {
+      return { ok: false, code: 'metaWriteFailed', params: { detail: describe(error) }, error: '写入 preset.yml 失败：' + describe(error) }
+    }
+  })
+  // Failed reorders can roll back earlier writes; none of their tokens may be adopted.
+  return result.ok === true ? { ...result, revisions } : result
 }
 
 function serializedWrite(key, work) {
@@ -549,13 +625,15 @@ function serializedWrite(key, work) {
  * 的行集合也就不变，这是所有选项里破坏性最小的一个。
  *
  * @param {string} directory - the assistant's preset directory.
- * @param {{id: string, mode: string, prompt: string, name: string, description: string, displayName?: string, baseN?: number}} input
+ * @param {{id: string, mode: string, prompt: string, name: string, description: string, displayName?: string, baseN?: number, baseRevision?: string}} input
  *   - the validated save; `name` decides whether `preset.yml` is written, `displayName` is what the response
  *   reports (the disk name when the request omitted one — issue #9). `baseN` is the same stale-save
  *   token as {@link saveState}: a JSON number only.
  * @returns {object} the shape `saveState` returns, with `code: 'savedPromptOnly'`.
  */
-export function savePromptOnly(directory, { id, mode, prompt, name, description, displayName, baseN }) {
+export function savePromptOnly(directory, { id, mode, prompt, name, description, displayName, baseN, baseRevision }) {
+  const recovery = restoreBackups(directory)
+  if (recovery.ok !== true) return { ok: false, code: 'recoveryRequired', params: { path: directory, detail: recovery.detail }, error: '助手文件需要恢复：' + recovery.detail }
   // 与正常保存同一条纪律：提示词与 preset.yml 一起换名，失败则两个都不动。
   let metaText = null
   if (name !== '') {
@@ -563,13 +641,18 @@ export function savePromptOnly(directory, { id, mode, prompt, name, description,
     if (rendered.ok !== true) return rendered
     metaText = rendered.text
   }
-  const conflict = refuseStalePrompt(directory, prompt, baseN)
+  const conflict = refuseStaleState(directory, prompt, baseN, baseRevision)
   if (conflict !== null) return conflict
+  let revision
   try {
-    writeAtomicPair([
+    const entries = [
       [promptFile(directory), prompt],
       ...metaText === null ? [] : [[presetMetaPath(directory), metaText]],
-    ])
+    ]
+    // Return our exact submitted generation, without a post-commit read that
+    // could fail or accidentally adopt a different writer's subsequent change.
+    revision = revisionWithEntries(directory, entries)
+    writeAtomicPair(entries)
   } catch (error) {
     return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
   }
@@ -583,6 +666,7 @@ export function savePromptOnly(directory, { id, mode, prompt, name, description,
     id,
     mode,
     code: 'savedPromptOnly',
+    revision,
     // 响应里的名字用**磁盘上的那个**（issue #9）：请求省略 name 时不该把 params.name 报成裸目录 id。
     params: { name: (displayName === undefined || displayName === '' ? name : displayName) === '' ? id : (displayName === undefined || displayName === '' ? name : displayName), mode },
     note: '已保存系统提示词（本机取不到基础模式的出厂组成，插件开关与基础模式未改动）。下一步组装时会重读这个文件。',
@@ -669,6 +753,7 @@ export function saveState(rows, input) {
           description,
           displayName: effectiveName,
           baseN: input !== null && typeof input === 'object' ? input.baseN : undefined,
+          baseRevision: input !== null && typeof input === 'object' ? input.baseRevision : undefined,
         })
       }
       return {
@@ -701,14 +786,17 @@ export function saveState(rows, input) {
     if (rendered.ok !== true) return rendered
     metaText = rendered.text
   }
-  const conflict = refuseStalePrompt(directory, prompt, input !== null && typeof input === 'object' ? input.baseN : undefined)
+  const conflict = refuseStaleState(directory, prompt, input?.baseN, input?.baseRevision)
   if (conflict !== null) return conflict
+  let revision
   try {
-    writeAtomicPair([
+    const entries = [
       [compositionFile(directory), composition],
       [promptFile(directory), prompt],
       ...metaText === null ? [] : [[presetMetaPath(directory), metaText]],
-    ])
+    ]
+    revision = revisionWithEntries(directory, entries)
+    writeAtomicPair(entries)
   } catch (error) {
     return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
   }
@@ -732,6 +820,7 @@ export function saveState(rows, input) {
       id,
       mode,
       code: 'savedWithExclusiveRows',
+      revision,
       // `rows` 用行 id：页面自己按 `row.<id>.label` 渲染，英文界面不会因为这条掉回中文。
       params: { name: displayName, mode, rows: autoOff.join(', ') },
       note:
@@ -744,6 +833,7 @@ export function saveState(rows, input) {
     id,
     mode,
     code: 'saved',
+    revision,
     params: { name: displayName, mode },
     note: '已保存（' + displayName + '，基础模式 ' + mode + '）。下一步组装时会重读已保存的提示词。',
   }
@@ -976,6 +1066,8 @@ export function repairComposition(rows, input) {
   const id = input !== null && typeof input === 'object' && typeof input.id === 'string' ? input.id : ''
   const directory = assistantDir(rows, id)
   if (directory === undefined) return unknownAssistant(id)
+  const conflict = refuseStaleState(directory, readPrompt(directory).text ?? '', undefined, input?.baseRevision)
+  if (conflict !== null) return conflict
   const file = compositionFile(directory)
   if (!existsSync(file)) return { ok: false, code: 'compositionMissing', params: { path: file }, error: '找不到组成文件：' + file }
   const text = readFileSync(file, 'utf8')
@@ -1006,7 +1098,9 @@ export function repairComposition(rows, input) {
   }
   // **就地**关闭那几行，不重渲染：重渲染会顺手丢掉 base 之外的自有行，而用户的数据不该被这样动。
   const rendered = disableRowsInPlace(text, bad.map((row) => row.id))
+  let revision
   try {
+    revision = revisionWithEntries(directory, [[file, rendered]])
     writeAtomic(file, rendered)
   } catch (error) {
     return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
@@ -1016,6 +1110,7 @@ export function repairComposition(rows, input) {
     ok: true,
     id,
     code: 'repaired',
+    revision,
     // `ids` 是给人看的一串；`repairedIds` 是给**页面**用的数组 —— 页面必须把这几行写进它自己的
     // 草稿，否则下一次保存会按草稿重渲染，把刚才的修复原样撤销（issue #8 实测：
     // 修复写进了磁盘，但草稿里那几行仍是启用的，于是保存后 ghost 行又回来了）。
@@ -1222,6 +1317,9 @@ export function apply(ctx) {
       backendVerdict.id === BACKEND_DECLARATIVE
         ? createDeclarativeBackend({ scope, log: console.log, warn: console.error })
         : null
+    if (declarative !== null) {
+      scope.effect(() => () => declarative.disposeAll(), 'custom-mode.presets')
+    }
 
     /**
      * 删除入口，按后端选。新线上服务**没有** `remove()`（唯一手段是 `register()` 的 disposer），
@@ -1363,6 +1461,26 @@ export function apply(ctx) {
      * 写操作之后的重同步由 `resyncPresets` 负责，不该让每个请求都等一遍。
      */
     let startupSync = null
+    let latestSync = { ok: true, failures: [] }
+    const synchronize = async () => {
+      const outcome = await doSync()
+      latestSync = outcome
+      return outcome
+    }
+    // Public synchronization evidence contains only bounded preset identifiers and
+    // typed codes. Raw registration errors stay in host logs.
+    const registrationSync = (assistantId) => {
+      const failures = assistantId === undefined ? latestSync.failures
+        : latestSync.failures.filter(({ id }) => typeof id !== 'string' || id === '' || id === assistantId)
+      if (latestSync.ok === true || failures.length === 0) return { ok: true, code: 'synchronized', ids: [] }
+      return {
+        ok: false,
+        code: 'presetRegistrationSyncFailed',
+        ids: [...new Set(failures.map(({ id }) => id)
+          .filter((id) => typeof id === 'string' && /^[A-Za-z0-9_.-]{1,128}$/.test(id)))].slice(0, 32),
+        restartSuggested: failures.some(({ code }) => code === 'registrationConflict' || code === 'registrationCleanupFailed'),
+      }
+    }
     const roster = async () => {
       if (startupSync !== null) await startupSync
       return rawRoster()
@@ -1370,12 +1488,12 @@ export function apply(ctx) {
 
     /** Called inside the write queue; readers also await the current synchronization. */
     const resyncPresets = () => {
-      startupSync = doSync()
+      startupSync = synchronize()
       return startupSync
     }
 
     // 启动即同步：新线不是"写盘即生效"，第一次进来必须先注册。
-    startupSync = doSync()
+    startupSync = synchronize()
 
     /**
      * One Fetch-shaped handler for the whole surface.
@@ -1399,16 +1517,33 @@ export function apply(ctx) {
       detail: outcome.failures.map((failure) => failure.error ?? failure.code ?? 'unknown').join('; '),
     })
 
-    const handle = async (request, pathname) => {
+    const capabilitySnapshot = () => {
+      try {
+        if (typeof scope.get === 'function') return { profileContext: Boolean(scope.get('profileContext')) }
+      } catch {
+        /* Optional host capability is unknown; keep predicate warning/fail-safe. */
+      }
+      return {}
+    }
+    const handle = (request, pathname) => withPredicateCapabilities(capabilitySnapshot(), async () => {
       try {
         const url = new URL(request.url)
         if (request.method === 'GET' && pathname === ROUTE_PATH) {
           await ensureShipped()
-          return json(readList(await roster()))
+          const rows = await roster()
+          return json({ ...readList(rows), registrationSync: registrationSync() })
         }
         if (request.method === 'GET' && pathname === STATE_PATH) {
           await ensureShipped()
-          return json(readState(await roster(), url.searchParams.get('id') ?? '', { factoryPrompt: packagedPrompt() }))
+          const state = readState(await roster(), url.searchParams.get('id') ?? '', { factoryPrompt: packagedPrompt() })
+          const synchronization = registrationSync(state.id)
+          return json({
+            ...state,
+            registrationSync: synchronization,
+            ...(state.ok === true && synchronization.ok === false
+              ? { warnings: [...state.warnings, synchronization.restartSuggested ? 'presetRegistrationRestartSuggested' : 'presetRegistrationSyncFailed'] }
+              : {}),
+          })
         }
 
         if (request.method === 'GET' && pathname === HISTORY_PATH) {
@@ -1456,7 +1591,7 @@ export function apply(ctx) {
           const result = pathname === STATE_PATH ? saveState(rows, parsed)
             : pathname === CREATE_PATH ? createAssistant(rows, parsed)
               : pathname === REPAIR_PATH ? repairComposition(rows, parsed)
-                : pathname === REORDER_PATH ? reorderAssistant(rows, parsed)
+                : pathname === REORDER_PATH ? reorderState(rows, parsed)
                   : await deleteAssistant(rows, parsed, presetRemover())
           if (result.ok !== true) return json(result, 400)
           const synced = await resyncPresets()
@@ -1475,7 +1610,7 @@ export function apply(ctx) {
         // ——中文界面里会蹦出一句英文。带 code 后页面用自己的词典渲染，原始串只作为 `detail` 参数。
         return json({ ok: false, code: 'internalError', params: { detail: describe(error) }, error: describe(error) }, 500)
       }
-    }
+    })
 
     // One registration per exact path — the platform's Fetch registry matches exact paths, not prefixes —
     // each declaring the methods it owns. The method table doubles as the guarantee that a prefetched

package/locales.mjs

@@ -16,11 +16,49 @@
 
 /** Simplified Chinese dictionary — the key source of truth. */
 export const zh = {
+  'update.heading': '插件更新',
+  'update.orphanHint': '以下助手已不在当前列表，但本页仍保留其未保存草稿，因此暂不能离页。',
+  'update.orphanName': '{name}（ID：{id}）',
+  'update.orphanView': '查看并保留草稿',
+  'update.orphanHide': '收起草稿',
+  'update.orphanCopy': '下方包含完整提示词、名称、描述、模式和覆盖项，可选中复制到本地文件保留。放弃仅移除本页内存草稿，不修改磁盘文件。',
+  'update.orphanDiscard': '放弃此草稿…',
+  'update.orphanConfirm': '确认放弃“{name}”（ID：{id}）的未保存草稿？请先复制保留需要的内容。放弃后无法从本页恢复；磁盘文件不会改动。',
+  'update.orphanAcknowledge': '我已保留需要的内容，确认放弃后无法从本页恢复。',
+  'update.orphanChanged': '草稿或助手列表已变化，未放弃任何内容。请重新查看并确认。',
+  'update.orphanDiscarded': '已放弃所确认的本页草稿；磁盘文件未改动。',
+  'update.running': '运行中的插件版本：{version}',
+  'update.unknown': '未知',
+  'update.check': '检查更新',
+  'update.checking': '正在检查…',
+  'update.inPlugins': '在插件管理中更新',
+  'update.details': '打开插件详情',
+  'update.guide': '更新指引',
+  'update.idle': '仅在点击检查时查询宿主配置的包仓库；不会自动安装。',
+  'update.unavailable': '当前连接未提供原生版本检查能力。可打开插件详情或查看更新指引。',
+  'update.permission': '此操作缺少宿主授权，或权限服务暂不可用。',
+  'update.updatePermission': '可以查看版本，但当前连接没有更新权限。',
+  'update.available': '可用更新：{version}。安装由官方插件管理处理。',
+  'update.current': '此次检查未返回更高版本。',
+  'update.filtered': '发现较新版本，但没有符合官方默认条件的稳定兼容版本。',
+  'update.partial': '结果未覆盖全部新版本，暂未找到可推荐的更新。',
+  'update.omitted': '另有 {count} 个较新版本未列出。',
+  'update.disk': '磁盘安装版本：{version}；它可能尚未在运行中加载。',
+  'update.managed': '此安装无法使用原生包仓库更新，请通过原来源或插件详情管理；不会自动切换来源。',
+  'update.notFound': '宿主插件列表中没有找到此插件，无法确认更新。',
+  'update.network': '宿主查询包仓库失败，请稍后重试；尚不能确认更新状态。',
+  'update.refused': '宿主未提供可用的版本列表，尚不能确认更新状态。',
+  'update.failed': '未能完成更新检查，请重试或打开插件详情查看。',
+  'update.finishOperation': '请等待当前操作完成后再离开此页。',
+  'update.finishRecovery': '请先完成重试读取或重试生效，再离开此页。',
+  'update.saveDrafts': '请先保存或主动放弃所有助手草稿及未提交的新建输入，再离开此页。',
+  'update.navigationFailed': '未能打开插件详情；草稿已保留，可稍后重试。',
   'create.nextStep': '创建后可在上方继续编辑并保存；使用时，在新会话的模式菜单选择它。',
   'btn.retryRead': '重试读取',
   'btn.retrySync': '重试生效',
   'api.savedButSyncFailed': '文件已保存，但这些助手尚未生效：{ids}。请点「重试生效」，无需重复原操作。',
   'api.syncFailed': '这些助手仍未生效：{ids}。请重试；仍失败时查看宿主日志。',
+  'api.presetRegistrationSyncFailed': '尚未确认已保存的助手配置在宿主注册表中生效，请处理已有告警或查看宿主日志。',
   'api.synchronized': '配置已生效。新会话请从模式菜单选择助手。',
   'api.recoveryRequired': '助手文件需要恢复：{path}。请保留目录中的备份，并查看宿主日志中的恢复说明。',
   'msg.completedReadFailed': '{result} 页面刷新失败。请点「重试读取」，无需重复原操作。',
@@ -63,6 +101,9 @@ export const zh = {
   'assistant.brokenHint': '此模式在本机无法启动，不会出现在新会话菜单里。点「按本线修复」只关闭那些行。',
   'assistant.switchHint': '切换助手保留各自的未保存草稿；列表中的「未保存」标记即为此。',
   'btn.create': '新增助手',
+  'btn.newAssistant': '新建助手…',
+  'assistant.duplicateSavedConfirm': '复制使用磁盘上已保存的配置，不包含当前未保存的修改。继续复制已保存版本？当前草稿会保留。',
+  'prompt.replaceConfirm': '替换当前提示词草稿？尚未保存的提示词会被替换，无法从保存历史中恢复。请先复制保留需要的内容。',
   'create.heading': '新建助手',
   'btn.creating': '创建中…',
   'btn.duplicate': '复制',
@@ -112,7 +153,7 @@ export const zh = {
   'meta.version': '插件版本',
   'meta.versionHint': '未钉版本时，可能装到较旧的发布。要换版本，按 README 钉版本重装，然后重启。',
   'api.saved': '已保存（{name}，{mode}）。下一步组装时会重读已保存的提示词。',
-  'api.conflict': '磁盘上的提示词已经变了，这次没有写入。先重新读取，再决定要不要覆盖。',
+  'api.conflict': '磁盘上的助手配置已经变了，这次没有写入。请先导出或复制保留草稿，再重新读取并合并修改。',
   'api.savedWithExclusiveRows': '已保存（{name}，{mode}）。已关闭不能同时启用的行：{rows}。',
   'api.created': '已创建「{name}」。可继续编辑；使用时请在新会话的模式菜单选择它。',
   'api.savedPrompt': '已保存系统提示词（{name}）。下一步组装时会重读这个文件。',
@@ -150,6 +191,8 @@ export const zh = {
   'warn.approvalGateMissing': '当前版本没有审批事件。会话内改写提示词不会请求确认。',
   'warn.unresolvableRows': '有的行在本机无法启动，此模式不会出现在新会话菜单里。点「按本线修复」只关闭那些行。',
   'warn.presetBroken': '此模式无法启动，不会出现在新会话菜单里。点「按本线修复」。原因见下一行。',
+  'warn.presetRegistrationSyncFailed': '尚未确认这位助手已保存的配置在宿主注册表中生效。请先处理已有告警或查看宿主日志；无需重复保存。',
+  'warn.presetRegistrationRestartSuggested': '尚未确认这位助手已保存的配置在宿主注册表中生效。如刚更新或恢复插件，建议重启 DeepSeek Harness 后重新检查；无需重复保存。',
   'warn.badPromptVariable': '提示词里有不可用的变量。改掉后再保存，否则此模式的请求会失败。',
   'warn.duplicateRowIds': '组成文件里有重复的行 id。开关只作用于第一处。',
   'warn.predicateFailed': '有一行的平台条件无法计算，已按关闭处理。',
@@ -302,11 +345,49 @@ export const zh = {
 
 /** English dictionary; the parity test keeps its key set equal to {@link zh}. */
 export const en = {
+  'update.heading': 'Plugin updates',
+  'update.orphanHint': 'These assistants left the current list, but this page still holds their unsaved drafts. Resolve them before leaving.',
+  'update.orphanName': '{name} (ID: {id})',
+  'update.orphanView': 'View and keep draft',
+  'update.orphanHide': 'Hide draft',
+  'update.orphanCopy': 'The text below includes the full prompt, name, description, mode and overrides. Select and copy it to a local file to keep it. Discarding only removes this page\'s in-memory draft; files on disk are unchanged.',
+  'update.orphanDiscard': 'Discard this draft…',
+  'update.orphanConfirm': 'Discard the unsaved draft for "{name}" (ID: {id})? First copy any content you need to keep. This page cannot recover it after discarding; files on disk will remain unchanged.',
+  'update.orphanAcknowledge': 'I have kept the content I need and understand this page cannot recover the discarded draft.',
+  'update.orphanChanged': 'The draft or assistant list changed. Nothing was discarded. Review it again before confirming.',
+  'update.orphanDiscarded': 'The confirmed draft was discarded from this page; files on disk are unchanged.',
+  'update.running': 'Running plugin version: {version}',
+  'update.unknown': 'unknown',
+  'update.check': 'Check for updates',
+  'update.checking': 'Checking…',
+  'update.inPlugins': 'Update in Plugins',
+  'update.details': 'Open plugin details',
+  'update.guide': 'Update guide',
+  'update.idle': 'Only a click checks the registries configured by the host; installation is never automatic.',
+  'update.unavailable': 'This connection does not offer native version checks. Open plugin details or the update guide.',
+  'update.permission': 'Host permission is missing for this action, or the access service is unavailable.',
+  'update.updatePermission': 'You can view versions, but this connection does not have update permission.',
+  'update.available': 'Update available: {version}. Official plugin management handles installation.',
+  'update.current': 'This check returned no newer releases.',
+  'update.filtered': 'Newer releases exist, but none meet the official default conditions for a stable compatible version.',
+  'update.partial': 'The result omits some newer releases; no recommended update was found.',
+  'update.omitted': '{count} additional newer releases were omitted.',
+  'update.disk': 'Installed on disk: {version}; this version may not be loaded in the running host yet.',
+  'update.managed': 'Manage this installation through its original source or plugin details; it cannot use this native registry update path. The source will not be changed automatically.',
+  'update.notFound': 'The host did not list this plugin, so its update status could not be determined.',
+  'update.network': 'The host could not query the registry. Try again later; update status is unknown.',
+  'update.refused': 'The host did not provide a usable version list; update status is unknown.',
+  'update.failed': 'The update check could not finish. Retry or open plugin details.',
+  'update.finishOperation': 'Wait for the current operation to finish before leaving this page.',
+  'update.finishRecovery': 'Complete Retry refresh or Retry activation before leaving this page.',
+  'update.saveDrafts': 'Save or explicitly discard all assistant drafts and unsubmitted new-assistant input before leaving this page.',
+  'update.navigationFailed': 'Plugin details could not open. Your drafts are preserved; try again later.',
   'create.nextStep': 'After creating, edit and save above. To use the assistant, choose it in the mode menu for a new session.',
   'btn.retryRead': 'Retry refresh',
   'btn.retrySync': 'Retry activation',
   'api.savedButSyncFailed': 'Files are saved, but these assistants are not active yet: {ids}. Select Retry activation; you do not need to repeat the original action.',
   'api.syncFailed': 'These assistants are still not active: {ids}. Retry, then check the host log if the problem continues.',
+  'api.presetRegistrationSyncFailed': 'The saved assistant configuration has not been confirmed in the host registry. Address existing warnings or check the host log.',
   'api.synchronized': 'Configuration is active. Choose an assistant in the mode menu for a new session.',
   'api.recoveryRequired': 'Assistant files need recovery: {path}. Keep the backups in that directory and check the host log for recovery details.',
   'msg.completedReadFailed': '{result} The page could not refresh. Select Retry refresh; do not repeat the original action.',
@@ -347,6 +428,9 @@ export const en = {
   'assistant.brokenHint': 'This mode cannot start here, so it will not appear for a new session. Fix for this line turns off only those rows.',
   'assistant.switchHint': 'Switching assistants keeps each draft; the "Unsaved" marker in the list is exactly that.',
   'btn.create': 'New assistant',
+  'btn.newAssistant': 'New assistant…',
+  'assistant.duplicateSavedConfirm': 'Copy the saved configuration from disk? Unsaved changes are not included, and your current draft will be kept.',
+  'prompt.replaceConfirm': 'Replace the current prompt draft? Unsaved prompt text will be replaced and cannot be recovered from saved history. Copy any content you need to keep first.',
   'create.heading': 'New assistant',
   'btn.creating': 'Creating…',
   'btn.duplicate': 'Duplicate',
@@ -396,7 +480,7 @@ export const en = {
   'meta.version': 'Plugin version',
   'meta.versionHint': 'Without a pinned version, an older release may be installed. To change it, reinstall with the version pin from the README, then restart.',
   'api.saved': 'Saved ({name}, {mode}). The next model step rereads the saved prompt.',
-  'api.conflict': 'The prompt on disk has changed, so this save was not written. Reload, then decide whether to overwrite.',
+  'api.conflict': 'The assistant configuration on disk has changed. Nothing was written. Export or copy your draft, then reload and merge your changes.',
   'api.savedWithExclusiveRows': 'Saved ({name}, {mode}). Turned off rows that cannot be on together: {rows}.',
   'api.created': 'Created {name}. Continue editing here, then choose it in the mode menu for a new session.',
   'api.savedPrompt': 'System prompt saved ({name}). The next model step rereads this file.',
@@ -437,6 +521,8 @@ export const en = {
   'warn.approvalGateMissing': 'This version has no approval event. In-session prompt edits are not confirmed.',
   'warn.unresolvableRows': 'Some rows cannot start here, so this mode is absent from the new-session menu. Fix for this line turns off only those rows.',
   'warn.presetBroken': 'This mode cannot start, so it will not appear for a new session. Use Fix for this line. The reason is on the next line.',
+  'warn.presetRegistrationSyncFailed': 'This assistant\'s saved configuration has not been confirmed in the host registry. Address existing warnings or check the host log; you do not need to save again.',
+  'warn.presetRegistrationRestartSuggested': 'This assistant\'s saved configuration has not been confirmed in the host registry. If the plugin was just updated or restored, consider restarting DeepSeek Harness, then check again; you do not need to save again.',
   'warn.badPromptVariable': 'The prompt uses a variable that is not available. Fix it before saving.',
   'warn.duplicateRowIds': 'A row id is repeated. A switch applies only to the first one.',
   'warn.predicateFailed': 'A platform condition could not be evaluated. That row is treated as off.',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-custom-mode",
-  "version": "2.2.6",
-  "description": "Edit a DeepSeek Harness (dsh) custom mode: system prompt, base mode, and plugin switches.",
+  "version": "2.3.1",
+  "description": "Customize DeepSeek Harness assistants: edit system prompts, base modes, and plugin switches.",
   "license": "MIT",
   "type": "module",
   "author": "bowluna <ai@bowluna.com>",