dsh-custom-mode 1.9.12 → 1.9.14

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BOWLUNA
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assistants.mjs

@@ -25,7 +25,7 @@
  * file work, so it can be tested without a running harness.
  */
 
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { dshHome, PRESET_DIR } from './paths.mjs'
 // `presetMetaPath` 曾被漏掉：reorderAssistant 用它做"快照 → 失败回滚"，于是两处调用都抛
@@ -267,14 +267,31 @@ export function createAssistantDir({ root, id, composition, templateDir }) {
   const dir = join(root, id)
   if (existsSync(dir)) return { ok: false, code: 'dirExists', params: { path: dir }, error: `目录已存在：${dir}` }
 
+  // ★ 失败必须**撤干净**（issue #4）。上面的 existsSync 已经证明这个目录是本函数刚创建的，所以
+  //   失败时把它整体删掉是安全的。不这么做的话：用户看到"没建成"，磁盘上却留下一个半成品目录，
+  //   重启后它作为助手出现在选择器里，而且这个名字被**永久占用**（再建同名直接报"目录已存在"）。
+  //   删除本身也做失败兜底：删不掉时如实说明"留下了什么"，而不是假装干净。
+  const rollback = (result) => {
+    try {
+      rmSync(dir, { recursive: true, force: true })
+      return result
+    } catch (error) {
+      return {
+        ...result,
+        params: { ...result.params, leftover: dir, cleanupFailed: describe(error) },
+        error: result.error + '；且未能清理半成品目录 ' + dir + '（' + describe(error) + '）',
+      }
+    }
+  }
+
   const seeded = seedPreset(dir, templateDir)
   if (seeded.errors.length > 0) {
-    return { ok: false, code: 'seedFailed', params: { detail: seeded.errors.join('；') }, error: '复制模式模板失败：' + seeded.errors.join('；') }
+    return rollback({ ok: false, code: 'seedFailed', params: { detail: seeded.errors.join('；') }, error: '复制模式模板失败：' + seeded.errors.join('；') })
   }
   try {
     writeFileSync(join(dir, COMPOSITION_FILE), composition, 'utf8')
   } catch (error) {
-    return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入组成文件失败：' + describe(error) }
+    return rollback({ ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入组成文件失败：' + describe(error) })
   }
   return { ok: true, id, dir }
 }

package/base-composition.mjs

@@ -0,0 +1,419 @@
+/**
+ * Where a base mode's composition text comes from — **the third thing the two dsh lines disagree about**.
+ *
+ * The settings page composes a mode by editing a *shipped* base composition (base mode + row switches).
+ * That text has to come from somewhere, and the two dsh lines keep it in different places:
+ *
+ * | line | where the shipped composition lives |
+ * | --- | --- |
+ * | 0.1.2 … 0.1.6 | `@deepseek-ai/dsh-agent-presets/presets/<mode>/agent.cordis.yml` (a package that **no longer exists** from 0.1.7) |
+ * | 0.1.7 + | inside the host: `agentPresets.readDocument(<mode>).content` — the declared entry-list YAML |
+ *
+ * At 1.9.12 only the first route existed, so on 0.1.7 every read of a base composition threw
+ * (`无法定位出厂基础模式`) and the settings page answered **500**: no rows, no switches, and — worse —
+ * the prompt editor never rendered. That is the P0 an adversarial review reproduced on a stock
+ * `0.1.7-rc.2` instance (the exact line the official desktop app bundles).
+ *
+ * ## Resolution order (highest first)
+ *
+ *  1. `DSH_SHIPPED_PRESETS_DIR` — explicit override, **exclusive**: when set, nothing else is consulted.
+ *     Tests use it, and an operator who points it somewhere gets exactly that.
+ *  2. the text the host handed over (`setBaseCompositions`, filled from `agentPresets.readDocument`).
+ *  3. `setShippedPresetsDir`, then Node/profile discovery of the legacy presets package.
+ *  4. `DSH_PRESET_PATCH_DIR`, then discovery of `@deepseek-ai/dsh-web-app/presets/<mode>.patch.yml`
+ *     — the same declaration in its packaged form, for a host whose `readDocument` is unavailable.
+ *  5. nothing left → {@link BaseCompositionUnavailableError}, which callers turn into a **visible,
+ *     typed** state instead of a 500.
+ *
+ * Why `readDocument` and not `compositionInventory()`: the inventory is **flattened**
+ * (`entryId`/`moduleName`/`enabled`/`condition`), so the `isolate` realms a service row must sit inside
+ * are gone (measured 2026-09-25; `parse-composition.mjs` rules the same route out for the same reason).
+ * `readDocument` returns the declaration as YAML **including** those groups and `!!js` expressions.
+ */
+
+import { existsSync, readFileSync } from 'node:fs'
+import { createRequire } from 'node:module'
+import { dirname, join } from 'node:path'
+import { fileURLToPath } from 'node:url'
+
+import { dshHome } from './paths.mjs'
+
+/** Explicit override for the legacy file layout (a directory holding `<mode>/agent.cordis.yml`). */
+export const LEGACY_DIR_ENV = 'DSH_SHIPPED_PRESETS_DIR'
+
+/** Explicit override for the declarative file layout (a directory holding `<mode>.patch.yml`). */
+export const PATCH_DIR_ENV = 'DSH_PRESET_PATCH_DIR'
+
+/** The base modes a user may build on. Kept here so discovery has no opinion about the UI. */
+export const BASE_MODE_IDS = ['standard', 'ptc', 'minimal', 'cordis']
+
+/**
+ * Thrown when no route yields a base composition.
+ *
+ * Carries `code` so the HTTP layer can answer with a typed, localizable result, and `attempts` so the
+ * operator sees *which* places were tried instead of a bare failure.
+ */
+export class BaseCompositionUnavailableError extends Error {
+  /**
+   * @param {string} modeId - the base mode that could not be resolved.
+   * @param {string[]} attempts - one line per route tried, in order.
+   */
+  constructor(modeId, attempts) {
+    super(
+      '无法取得基础模式「' + modeId + '」的出厂组成。已尝试：' +
+        (attempts.length > 0 ? attempts.join('；') : '(无可用途径)'),
+    )
+    this.name = 'BaseCompositionUnavailableError'
+    this.code = 'baseCompositionUnavailable'
+    this.modeId = modeId
+    this.attempts = attempts
+  }
+}
+
+/** Whether a value is the typed "no base composition anywhere" failure. */
+export function isBaseCompositionUnavailable(error) {
+  return error !== null && typeof error === 'object' && error.code === 'baseCompositionUnavailable'
+}
+
+/** Read one candidate file, reporting a miss instead of throwing. */
+function tryReadFile(file, attempts, label) {
+  try {
+    const text = readFileSync(file, 'utf8')
+    if (typeof text === 'string' && text.trim() !== '') return text
+    attempts.push(label + '：文件为空')
+  } catch (error) {
+    const code = error !== null && typeof error === 'object' ? error.code : undefined
+    attempts.push(label + '：' + (code === 'ENOENT' ? '不存在' : String((error && error.message) || error)))
+  }
+  return null
+}
+
+// ── route 1 / 3: the legacy file layout ───────────────────────────────────────
+
+/** Directory injected by the host half (resolved from the roster's system row). */
+let injectedLegacyDir
+
+/** Point the resolver at a legacy presets directory discovered at runtime. */
+export function setShippedPresetsDir(dir) {
+  if (typeof dir === 'string' && dir !== '') injectedLegacyDir = dir
+}
+
+/** Discovery result, cached **only when it succeeded** (a cold miss must stay retryable). */
+let legacyCache
+
+/** Resolve `@deepseek-ai/dsh-agent-presets` the two ways that ever worked on the legacy line. */
+function discoverLegacyPresetsDir() {
+  const require = createRequire(import.meta.url)
+  try {
+    const manifest = require.resolve('@deepseek-ai/dsh-agent-presets/package.json')
+    return join(dirname(manifest), 'presets')
+  } catch {
+    /* fall through */
+  }
+  try {
+    const fromProfile = createRequire(join(dshHome(), 'profiles', 'package.json'))
+    const manifest = fromProfile.resolve('@deepseek-ai/dsh-agent-presets/package.json')
+    return join(dirname(manifest), 'presets')
+  } catch {
+    /* fall through */
+  }
+  throw new Error(
+    '无法定位出厂基础模式（@deepseek-ai/dsh-agent-presets 是否已安装？）。' +
+      '0.1.7 起该包不再发布，那条线由 agentPresets.readDocument() 提供同一份声明。',
+  )
+}
+
+/**
+ * The legacy presets directory.
+ *
+ * `DSH_SHIPPED_PRESETS_DIR` is **exclusive**: an explicit override must not silently fall back to
+ * whatever else happens to be installed on the machine (that is how a test would stop testing).
+ *
+ * @returns {string} absolute directory.
+ */
+export function shippedPresetsDir() {
+  const override = process.env[LEGACY_DIR_ENV]
+  if (typeof override === 'string' && override !== '') return override
+  if (injectedLegacyDir !== undefined) return injectedLegacyDir
+  if (legacyCache === undefined) legacyCache = discoverLegacyPresetsDir()
+  return legacyCache
+}
+
+/** Absolute path of one mode's shipped composition in the legacy layout. */
+export function baseCompositionPath(modeId, directory = shippedPresetsDir()) {
+  return join(directory, modeId, 'agent.cordis.yml')
+}
+
+// ── route 2: the text was handed over by the host (dsh ≥ 0.1.7) ───────────────
+
+/** `id → composition text`, as fetched from `agentPresets.readDocument()`. */
+let injectedCompositions
+
+/**
+ * Hand over the base compositions the host declared.
+ *
+ * Called on every registry sync, so a host that gains or changes a preset is picked up without a restart.
+ * An empty/failed fetch clears the map rather than keeping a stale one — the caller logs the reason.
+ *
+ * @param {Map<string, string>|Record<string, string>|null} [compositions] - `id → entry-list YAML`.
+ */
+export function setBaseCompositions(compositions) {
+  if (compositions === null || compositions === undefined) {
+    injectedCompositions = undefined
+    return
+  }
+  const map = compositions instanceof Map ? compositions : new Map(Object.entries(compositions))
+  const clean = new Map()
+  for (const [id, text] of map) {
+    if (typeof id === 'string' && typeof text === 'string' && text.trim() !== '') clean.set(id, text)
+  }
+  injectedCompositions = clean.size > 0 ? clean : undefined
+}
+
+/** The host-provided text for one mode, when there is one. */
+export function injectedBaseComposition(modeId) {
+  return injectedCompositions === undefined ? undefined : injectedCompositions.get(modeId)
+}
+
+/** Which modes the host handed over — for the startup log and for tests. */
+export function injectedBaseCompositionIds() {
+  return injectedCompositions === undefined ? [] : [...injectedCompositions.keys()]
+}
+
+// ── route 4: the declarative declaration in its packaged form ─────────────────
+
+/** Directory injected for the patch-file layout. */
+let injectedPatchDir
+
+/** Point the resolver at a directory holding `<mode>.patch.yml`. */
+export function setPatchPresetsDir(dir) {
+  if (typeof dir === 'string' && dir !== '') injectedPatchDir = dir
+}
+
+/** Discovery result, cached only on success. */
+let patchCache
+
+/** `{ prefix, kind }` candidates for a global npm install of dsh, from this process' own node. */
+function executablePrefixes() {
+  const out = []
+  const dir = dirname(process.execPath)
+  // POSIX global install: <prefix>/lib/node_modules/@deepseek-ai/dsh
+  out.push(join(dir, '..', 'lib', 'node_modules', '@deepseek-ai', 'dsh'))
+  // Windows global install: <prefix>/node_modules/@deepseek-ai/dsh
+  out.push(join(dir, 'node_modules', '@deepseek-ai', 'dsh'))
+  // A node bundled inside an app (desktop shells): keep the app's own tree reachable.
+  out.push(join(dir, '..', 'node_modules', '@deepseek-ai', 'dsh'))
+  return out
+}
+
+/** `dsh` on PATH → its install root, so a non-standard prefix still resolves. */
+function pathDiscoveredDshRoots() {
+  const out = []
+  const entries = String(process.env.PATH ?? '').split(process.platform === 'win32' ? ';' : ':')
+  for (const entry of entries) {
+    if (entry === '') continue
+    for (const name of process.platform === 'win32' ? ['dsh.cmd', 'dsh.exe', 'dsh'] : ['dsh']) {
+      const candidate = join(entry, name)
+      if (!existsSync(candidate)) continue
+      out.push(join(entry, '..', 'lib', 'node_modules', '@deepseek-ai', 'dsh'))
+      out.push(join(entry, '..', 'node_modules', '@deepseek-ai', 'dsh'))
+    }
+  }
+  return out
+}
+
+/**
+ * Where `@deepseek-ai/dsh-web-app` ships `presets/<mode>.patch.yml`.
+ *
+ * Every candidate is verified by looking for a shipped base patch, so a wrong guess costs a stat call
+ * instead of a wrong answer.
+ *
+ * @returns {string|undefined} the presets directory, or undefined when nothing matched.
+ */
+export function discoverPatchPresetsDir() {
+  const candidates = []
+  // (a) Node resolution from this module: hits when the plugin sits in a tree that can see the host
+  //     (a source checkout with the host installed beside it, a flat profile, CI).
+  for (const spec of ['@deepseek-ai/dsh-web-app/package.json', '@deepseek-ai/dsh/package.json']) {
+    try {
+      candidates.push(dirname(createRequire(import.meta.url).resolve(spec)))
+    } catch {
+      /* fall through */
+    }
+  }
+  // (b) Walk up from this module's own directory — the same shape, for trees Node's resolver skips.
+  {
+    let here = dirname(fileURLToPath(import.meta.url))
+    for (let depth = 0; depth < 8; depth += 1) {
+      candidates.push(join(here, 'node_modules', '@deepseek-ai', 'dsh-web-app'))
+      candidates.push(join(here, 'node_modules', '@deepseek-ai', 'dsh'))
+      here = dirname(here)
+    }
+  }
+  // (c) The host's own module tree, reachable from the DSH home when the profile has real deps.
+  try {
+    const fromProfile = createRequire(join(dshHome(), 'profiles', 'package.json'))
+    candidates.push(dirname(fromProfile.resolve('@deepseek-ai/dsh-web-app/package.json')))
+    candidates.push(dirname(fromProfile.resolve('@deepseek-ai/dsh/package.json')))
+  } catch {
+    /* fall through */
+  }
+  for (const root of [...executablePrefixes(), ...pathDiscoveredDshRoots()]) {
+    candidates.push(join(root, 'node_modules', '@deepseek-ai', 'dsh-web-app'))
+    candidates.push(root)
+  }
+  for (const candidate of candidates) {
+    const presets = candidate.endsWith('dsh-web-app') ? join(candidate, 'presets') : join(candidate, 'node_modules', '@deepseek-ai', 'dsh-web-app', 'presets')
+    if (BASE_MODE_IDS.some((mode) => existsSync(join(presets, mode + '.patch.yml')))) return presets
+  }
+  return undefined
+}
+
+/**
+ * The patch-file presets directory.
+ *
+ * `DSH_PRESET_PATCH_DIR` is exclusive for the same reason as its legacy twin.
+ *
+ * @returns {string|undefined} undefined when no patch layout is present (not an error by itself).
+ */
+export function patchPresetsDir() {
+  const override = process.env[PATCH_DIR_ENV]
+  if (typeof override === 'string' && override !== '') return override
+  if (injectedPatchDir !== undefined) return injectedPatchDir
+  if (patchCache === undefined) {
+    const found = discoverPatchPresetsDir()
+    if (found !== undefined) patchCache = found
+    return found
+  }
+  return patchCache
+}
+
+/**
+ * Lift the `plugins:` sequence out of a declarative preset patch.
+ *
+ * The patch (`@deepseek-ai/dsh-web-app/presets/<mode>.patch.yml`) wraps the same row list this feature
+ * composes against:
+ *
+ *     - insert:
+ *         - id: preset-standard
+ *           name: '@deepseek-ai/dsh-agent-preset'
+ *           config:
+ *             id: standard
+ *             plugins:
+ *               - id: persona
+ *                 ...
+ *
+ * Text surgery, not a YAML round-trip — exactly like the composer it feeds: dedenting the block keeps
+ * comments, quoting and `!!js` byte-for-byte, and the result is already in the shape
+ * `splitSegments()`/`collectRows()` expect (top-level rows at column 0, nested rows at four spaces).
+ *
+ * @param {string} text - the patch file's contents.
+ * @returns {string|null} entry-list YAML, or null when the file carries no `plugins:` block.
+ */
+export function extractPluginsBlock(text) {
+  if (typeof text !== 'string' || text === '') return null
+  const lines = text.split('\n')
+  const start = lines.findIndex((line) => /^\s*plugins:\s*$/.test(line))
+  if (start === -1) return null
+  const base = lines[start].search(/\S/)
+  const out = []
+  for (let index = start + 1; index < lines.length; index += 1) {
+    const line = lines[index]
+    if (line.trim() === '') {
+      out.push('')
+      continue
+    }
+    const indent = line.search(/\S/)
+    if (indent <= base) break
+    out.push(line.slice(Math.min(base + 2, indent)))
+  }
+  while (out.length > 0 && out[0].trim() === '') out.shift()
+  while (out.length > 0 && out[out.length - 1].trim() === '') out.pop()
+  return out.length === 0 ? null : out.join('\n')
+}
+
+/** Absolute path of one mode's shipped patch, in the declarative layout. */
+export function basePatchPath(modeId, directory = patchPresetsDir()) {
+  return directory === undefined ? undefined : join(directory, modeId + '.patch.yml')
+}
+
+// ── the chain ────────────────────────────────────────────────────────────────
+
+/**
+ * Read one base mode's shipped composition, from whichever route this installation has.
+ *
+ * @param {string} modeId - one of {@link BASE_MODE_IDS}.
+ * @returns {{text: string, source: string}} the composition and where it came from (for the log).
+ * @throws {BaseCompositionUnavailableError} when no route yields text.
+ */
+export function readBaseCompositionText(modeId) {
+  const attempts = []
+
+  // 1. explicit legacy override: tried first, and it **suppresses discovery** (the point of an explicit
+  //    override is that the answer cannot wander to whatever else is installed). It does *not* suppress
+  //    step 2: a host that declares the composition knows better than a stale path in the environment.
+  const legacyOverride = process.env[LEGACY_DIR_ENV]
+  const legacyExplicit = typeof legacyOverride === 'string' && legacyOverride !== ''
+  if (legacyExplicit) {
+    const file = join(legacyOverride, modeId, 'agent.cordis.yml')
+    const text = tryReadFile(file, attempts, LEGACY_DIR_ENV + '=' + legacyOverride)
+    if (text !== null) return { text, source: LEGACY_DIR_ENV }
+  }
+
+  // 2. text handed over by the host (dsh ≥ 0.1.7): the authoritative answer on that line.
+  const injected = injectedBaseComposition(modeId)
+  if (injected !== undefined) return { text: injected, source: 'agentPresets.readDocument()' }
+
+  const patchOverride = process.env[PATCH_DIR_ENV]
+  const patchExplicit = typeof patchOverride === 'string' && patchOverride !== ''
+
+  if (legacyExplicit === false) {
+    // 3. injected legacy dir, then discovery
+    if (injectedLegacyDir !== undefined) {
+      const text = tryReadFile(join(injectedLegacyDir, modeId, 'agent.cordis.yml'), attempts, 'setShippedPresetsDir()')
+      if (text !== null) return { text, source: 'agentPresets.list() → presets 目录' }
+    } else {
+      try {
+        const dir = discoverLegacyPresetsDir()
+        const text = tryReadFile(join(dir, modeId, 'agent.cordis.yml'), attempts, '@deepseek-ai/dsh-agent-presets')
+        if (text !== null) return { text, source: '@deepseek-ai/dsh-agent-presets' }
+      } catch (error) {
+        attempts.push('@deepseek-ai/dsh-agent-presets：' + String((error && error.message) || error))
+      }
+    }
+  }
+
+  // 4. the declarative declaration in its packaged form
+  const patchDir = patchExplicit ? patchOverride : patchPresetsDir()
+  if (patchDir !== undefined) {
+    const file = join(patchDir, modeId + '.patch.yml')
+    const raw = tryReadFile(file, attempts, PATCH_DIR_ENV + '/发现 dsh-web-app')
+    if (raw !== null) {
+      const text = extractPluginsBlock(raw)
+      if (text !== null) return { text, source: 'dsh-web-app/presets/' + modeId + '.patch.yml' }
+      attempts.push(file + '：没有 plugins: 区块')
+    }
+  } else {
+    attempts.push('dsh-web-app/presets：未找到（可用 ' + PATCH_DIR_ENV + ' 指定）')
+  }
+
+  throw new BaseCompositionUnavailableError(modeId, attempts)
+}
+
+/** The same chain, one-line description of the outcome — for startup logs. */
+export function describeBaseCompositionSource(modeId) {
+  try {
+    return readBaseCompositionText(modeId).source
+  } catch (error) {
+    return '不可用（' + String((error && error.message) || error) + '）'
+  }
+}
+
+/** Exported for tests: forget every cached discovery result. */
+export function resetBaseCompositionCachesForTests() {
+  legacyCache = undefined
+  patchCache = undefined
+  injectedLegacyDir = undefined
+  injectedPatchDir = undefined
+  injectedCompositions = undefined
+}

package/client.js

@@ -86,7 +86,6 @@ try {
         "msg.createFailed": "创建失败",
         "msg.deleteFailed": "删除失败",
         "msg.nameRequired": "请先给新助手起个名字。",
-        "msg.unsaved": "有未保存的修改",
         "msg.readOnlyHint": "这一页只管理本工具创建的助手；手写的 preset 不在这里，也不会被改写。",
         "msg.reordered": "顺序已保存：新建会话时的模式选择器按这个顺序排列。",
         "msg.reorderFailed": "调整顺序失败",
@@ -101,6 +100,8 @@ try {
         "assistant.short": "每个助手是一个独立模式：自己的系统提示词、基础模式与插件开关。",
         "name.short": "改名只影响显示，内部标识与已有会话不受影响。",
         "mode.short": "底子决定「行集合」与工具能力；persona 行始终由本模式替换。",
+        "mode.unavailable": "本机这条 DSH 线没有可读的出厂组成，基础模式暂时不能切换。",
+        "rows.unavailable": "出厂组成取不到，插件开关暂时不能编辑；磁盘上原有的行状态仍然生效。",
         "mode.pendingRows": "底子已改为「{mode}」：保存后，下面的行列表会按新底子重算。",
         "rows.short": "逐行控制挂载哪些插件；没拨过的行保持官方默认。",
         "prompt.short": "这段文本就是本模式的系统提示词，保存后下一步生效。",
@@ -150,8 +151,11 @@ try {
         "api.deleteFailed": "删除失败：{detail}",
         "api.versionMissing": "找不到这个版本（历史可能已被上限裁剪）。",
         "api.badJson": "请求体不是合法 JSON",
+        "api.savedPromptOnly": "已保存系统提示词（本机取不到基础模式的出厂组成，插件开关与基础模式未改动）。",
+        "api.baseCompositionUnavailable": "本机取不到基础模式「{mode}」的出厂组成，无法改动插件开关或基础模式（系统提示词可以单独保存）。",
         "warn.approvalGateMissing": "审批闸门未启用：本机这个 DSH 版本没有 tools/pre-execute 事件，会话内改写系统提示词不会弹审批。见「详情」。",
         "warn.unresolvableRows": "有行在本机这条 DSH 线上无法解析：平台会把整个模式判为 broken，并从新会话的选择器里**静默丢弃**。点右侧的「按本线修复」即可（只关掉那几行，其它选择不动）。",
+        "warn.baseCompositionUnavailable": "取不到本机这条 DSH 线的出厂组成：基础模式与插件开关暂时不能改（系统提示词不受影响，照常可保存）。已尝试的途径写在宿主日志里。",
         "warn.approvalGateMissing.label": "审批闸门未启用",
         "warn.approvalGateMissing.hint": "这个 DSH 版本没有 tools/pre-execute 事件，会话内改写系统提示词**不会**弹审批。设置页不受影响；要恢复保护请升级 DSH，或把「custom_prompt 工具」那一行关掉。",
         "warn.personaOffWithPrompt": "「身份（系统提示词）」这一行是关的，所以 prompt.md 不会被注入 —— 你写的提示词现在不起作用。要么打开这一行，要么清空提示词。",
@@ -194,6 +198,7 @@ try {
         "btn.saving": "处理中…",
         "btn.reload": "重新读取",
         "btn.reloadDiscard": "放弃修改并重新读取",
+        "msg.unsaved": "有未保存的修改",
         "msg.loading": "正在读取…",
         "msg.notLoaded": "（尚未读取）",
         "msg.reread": "已重新读取",
@@ -294,7 +299,6 @@ try {
         "msg.createFailed": "Could not create",
         "msg.deleteFailed": "Could not delete",
         "msg.nameRequired": "Give the new assistant a name first.",
-        "msg.unsaved": "Unsaved changes",
         "msg.readOnlyHint": "This page manages only the assistants this tool created; a hand-written preset is not listed here and is never rewritten.",
         "msg.reordered": "Order saved: the mode picker for new sessions follows it.",
         "msg.reorderFailed": "Could not reorder",
@@ -309,6 +313,8 @@ try {
         "assistant.short": "Each assistant is its own mode: its own system prompt, base mode and plugin switches.",
         "name.short": "Renaming only changes what is displayed — not the internal id or existing sessions.",
         "mode.short": "The base decides the row set and tool abilities; the persona row is always replaced by this mode.",
+        "mode.unavailable": "This DSH line exposes no readable shipped composition, so the base mode cannot be switched right now.",
+        "rows.unavailable": "No shipped composition is available, so the plugin switches cannot be edited right now; the row states already on disk still apply.",
         "mode.pendingRows": "Base changed to {mode}: the row list below is recomputed from the new base when you save.",
         "rows.short": "Control which plugins this mode mounts, row by row; untouched rows keep the shipped default.",
         "prompt.short": "Saving this text makes it the system prompt of this mode, and it takes effect on the next step.",
@@ -358,6 +364,8 @@ try {
         "api.deleteFailed": "Delete failed: {detail}",
         "api.versionMissing": "That version is gone (the history is capped).",
         "api.badJson": "The request body is not valid JSON",
+        "api.savedPromptOnly": "System prompt saved (this machine exposes no shipped composition, so the plugin switches and the base mode were left untouched).",
+        "api.baseCompositionUnavailable": "No shipped composition for base mode \"{mode}\" on this machine, so its plugin switches and base mode cannot be changed (the system prompt can still be saved on its own).",
         "warn.personaOffWithPrompt": "The \"Identity (system prompt)\" row is off, so prompt.md is never injected — the prompt you wrote has no effect. Turn the row on, or clear the prompt.",
         "warn.toolOff": "The \"custom_prompt tool\" row is off: the agent cannot change the prompt from inside a session, only this page can.",
         "warn.noDescription": "No description: the new-session mode picker will show it as \"no description yet\".",
@@ -366,6 +374,7 @@ try {
         "warn.approvalGateMissing.label": "Approval gate is off",
         "warn.approvalGateMissing.hint": "This DSH build has no tools/pre-execute event, so in-session prompt rewrites do NOT ask for approval. The settings page is unaffected; upgrade DSH or turn the custom_prompt tool row off to restore the gate.",
         "warn.noName": "No name: the mode picker will show the directory id (e.g. custom).",
+        "warn.baseCompositionUnavailable": "This DSH line exposes no shipped composition: the base mode and the plugin switches cannot be changed right now (the system prompt is unaffected and still saves). The routes that were tried are in the host log.",
         "history.label": "Change history",
         "history.pick": "Pick a version to load…",
         "history.load": "Load this version",
@@ -402,6 +411,7 @@ try {
         "btn.saving": "Working…",
         "btn.reload": "Reload",
         "btn.reloadDiscard": "Discard edits and reload",
+        "msg.unsaved": "Unsaved changes",
         "msg.loading": "Loading…",
         "msg.notLoaded": "(not loaded)",
         "msg.reread": "Reloaded",
@@ -770,6 +780,9 @@ try {
         return {
           id: state.id,
           mode: state.mode,
+          // 出厂组成取不到时的降级标记（服务端给，只读）。它不是用户可改的字段，sameDraft 不比较它。
+          baseUnavailable:
+            state.baseUnavailable === undefined || state.baseUnavailable === null ? null : state.baseUnavailable,
           overrides: { ...state.overrides },
           prompt: state.prompt,
           name: typeof state.name === "string" ? state.name : "",
@@ -1673,22 +1686,28 @@ try {
                   onToggleExpand: toggleRowExpanded,
                   t: t,
                 }),
-                react.createElement(
-                  "div",
-                  { className: "cpfe-pills" },
-                  payload.modes.map((mode) =>
-                    react.createElement(
-                      A.Pill,
-                      { key: mode.id, active: draft.mode === mode.id, onClick: () => pickMode(mode.id) },
-                      t("base." + mode.id + ".label", mode.label),
+                // 降级态（本机这条线没有可读的出厂组成）：不给可点的模式药丸，改说一句为什么 ——
+                // 点了也只会拿到一个服务端错误，那比置灰更糟。
+                draft.baseUnavailable !== null
+                  ? react.createElement("p", { className: "cpfe-note" }, t("mode.unavailable"))
+                  : react.createElement(
+                      "div",
+                      { className: "cpfe-pills" },
+                      payload.modes.map((mode) =>
+                        react.createElement(
+                          A.Pill,
+                          { key: mode.id, active: draft.mode === mode.id, onClick: () => pickMode(mode.id) },
+                          t("base." + mode.id + ".label", mode.label),
+                        ),
+                      ),
+                    ),
+                draft.baseUnavailable !== null
+                  ? null
+                  : react.createElement(
+                      "p",
+                      { className: "cpfe-note" },
+                      payload.modes.reduce((note, mode) => (mode.id === draft.mode ? t("base." + mode.id + ".note", mode.note) : note), ""),
                     ),
-                  ),
-                ),
-                react.createElement(
-                  "p",
-                  { className: "cpfe-note" },
-                  payload.modes.reduce((note, mode) => (mode.id === draft.mode ? t("base." + mode.id + ".note", mode.note) : note), ""),
-                ),
                 // 底子改过但还没保存时明说一句：行列表是按**已保存**的组成渲染的，审阅把它记成了"点了没反应"。
                 draft.mode !== savedMode
                   ? react.createElement(
@@ -1710,15 +1729,17 @@ try {
                   onToggleExpand: toggleRowExpanded,
                   t: t,
                 }),
-                react.createElement(RowList, {
-                  expanded: expandedRows,
-                  onToggleExpand: toggleRowExpanded,
-                  rows: payload.rows,
-                  overrides: draft.overrides,
-                  onToggle: (id, next) => update({ overrides: { ...draft.overrides, [id]: next } }),
-                  depth: 0,
-                  t: t,
-                }),
+                draft.baseUnavailable !== null
+                  ? react.createElement("p", { className: "cpfe-note" }, t("rows.unavailable"))
+                  : react.createElement(RowList, {
+                      expanded: expandedRows,
+                      onToggleExpand: toggleRowExpanded,
+                      rows: payload.rows,
+                      overrides: draft.overrides,
+                      onToggle: (id, next) => update({ overrides: { ...draft.overrides, [id]: next } }),
+                      depth: 0,
+                      t: t,
+                    }),
               ),
               react.createElement(
                 "section",