dsh-custom-mode 1.9.12 → 1.9.14

package/composition.mjs

@@ -22,51 +22,32 @@
  * output always carries a timestamp comment.
  */
 
-import { readFileSync, existsSync } from 'node:fs'
-import { createRequire } from 'node:module'
-import { dirname } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { readFileSync, existsSync, readdirSync } from 'node:fs'
 import { join } from 'node:path'
-import { dshHome } from './paths.mjs'
+
+// 出厂组成「从哪来」是两条 dsh 线唯一还没收进后端的一处：旧线是文件，0.1.7 是
+// agentPresets.readDocument()。解析链整个搬到了 base-composition.mjs（含它的理由与实测），
+// 本模块只消费它 —— 合成与排版手术仍然全部发生在这里。
+import {
+  baseCompositionPath,
+  readBaseCompositionText,
+  setShippedPresetsDir,
+  shippedPresetsDir,
+} from './base-composition.mjs'
+
+export { baseCompositionPath, setShippedPresetsDir, shippedPresetsDir } from './base-composition.mjs'
+export {
+  BaseCompositionUnavailableError,
+  isBaseCompositionUnavailable,
+  setBaseCompositions,
+} from './base-composition.mjs'
 
 /**
- * Directory holding the shipped preset folders (`standard`, `ptc`, …),
- * discovered once and cached.
- *
- * Resolved from the installed `dsh-agent-presets` package rather than a
- * hard-coded install path, so this works on any machine layout. The chain is:
- *
- *   <harness>/dsh-agent-presets/presets/custom/prompt-reader.mjs   ← this preset
- *   <harness>/dsh-agent-presets/presets/                           ← what we want
+ * 出厂组成的解析在 base-composition.mjs（见那里的解析顺序与实测依据）。
  *
- * The preset directory is the FIRST place `prompt-reader.mjs` exists walking up
- * from here: `preset/` in a source checkout does not carry that file. Discovery
- * is deferred to first use so importing this module never throws.
+ * 这里曾经只有一条路：`require.resolve('@deepseek-ai/dsh-agent-presets')`。0.1.7 起那个包不再发布，
+ * 于是这条路必然抛错，而调用方把它变成了整页 500 —— 设置页在官方桌面端内置的那条线上整体不可用。
  */
-let shippedPresetsCache
-function discoverShippedPresets() {
-  const require = createRequire(import.meta.url)
-  // 1) Node 解析：插件安装在能看见 harness 依赖的位置时直接命中。
-  try {
-    const manifest = require.resolve('@deepseek-ai/dsh-agent-presets/package.json')
-    return join(dirname(manifest), 'presets')
-  } catch {
-    /* fall through */
-  }
-  // 2) profile 的 node_modules：dsh 把 harness 包放在 <dshHome>/profiles/node_modules，
-  //    这里独立于「roster 是否给出 system 行」的形状，是 agentPresets 之外的第二条路。
-  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(
-    '无法定位出厂基础模式。已尝试：agentPresets 的 system 预设路径、Node 解析、profile 的 node_modules。' +
-      '若 DSH 改了包布局，请用 DSH_SHIPPED_PRESETS_DIR 指向 presets 目录。',
-  )
-}
 
 /**
  * Base modes a user may build on.
@@ -136,44 +117,21 @@ export const ROW_META = {
   'persistent-pwsh': { label: '持久 pwsh' },
 }
 
-/** Absolute path of the shipped composition for a base mode. */
-export function baseCompositionPath(modeId) {
-  return join(shippedPresetsDir(), modeId, 'agent.cordis.yml')
-}
+/** 出厂组成的路径与解析链都在 base-composition.mjs（下面按名字再导出，调用点不必分支）。 */
 
 /**
- * Resolve the shipped-preset directory.
+ * Read one base mode's shipped composition text.
  *
- * A test (or a source checkout, where the shipped presets are not beside this
- * module) may override it through `DSH_SHIPPED_PRESETS_DIR`; otherwise it is
- * discovered from the installed `dsh-agent-presets` package.
- */
-/** Directory injected by the host half, which resolves it via the agentPresets service. */
-let injectedShippedDir
-/**
- * Point the compiler at a shipped-preset directory discovered at runtime.
+ * The chain — explicit override → text handed over by the host (`readDocument`) → legacy presets
+ * directory → packaged `dsh-web-app` patch — lives in base-composition.mjs, so every route can be
+ * tested on its own and the failure carries a `code` instead of a bare message.
  *
- * The host half does this from `agentPresets.list()` (system-trust rows carry
- * absolute paths), which is layout-independent. Deriving the directory from this
- * module's own location does NOT work: this module is loaded from the plugin's
- * install directory, not from inside a preset, so no amount of walking up finds
- * the shipped presets.
+ * @param {string} modeId - one of {@link BASE_MODES}.
+ * @returns {string} the entry-list YAML of that base mode.
+ * @throws {BaseCompositionUnavailableError} when no route yields text (callers degrade, see index.mjs).
  */
-export function setShippedPresetsDir(dir) {
-  if (typeof dir === 'string' && dir !== '') injectedShippedDir = dir
-}
-
-export function shippedPresetsDir() {
-  const override = process.env.DSH_SHIPPED_PRESETS_DIR
-  if (override !== undefined && override !== '') return override
-  if (injectedShippedDir !== undefined) return injectedShippedDir
-  if (shippedPresetsCache === undefined) shippedPresetsCache = discoverShippedPresets()
-  return shippedPresetsCache
-}
-
-/** Read one base mode's shipped composition text. */
 export function readBaseComposition(modeId) {
-  return readFileSync(baseCompositionPath(modeId), 'utf8')
+  return readBaseCompositionText(modeId).text
 }
 
 /**
@@ -701,9 +659,11 @@ export function knownModuleNamesInjected() {
 }
 
 export function unresolvableRows(text) {
-  let root
+  /** 可能装着生态包的那些 `node_modules`（等价于根，见下面的嵌套形态）。 */
+  let roots = []
   let fromFilesystem = false
   if (knownModuleNames === null) {
+    let root
     try {
       root = join(shippedPresetsDir(), '..', '..', '..')
       fromFilesystem = true
@@ -713,6 +673,19 @@ export function unresolvableRows(text) {
     // **判断不了就不要报警**：如果这个根下根本没有 node_modules（例如测试用的是一个临时出厂目录），
     // 那么"查不到某个包"只说明我们不知道，不说明那行坏了。误报的代价是用户被引导去关掉本来正常的行。
     if (existsSync(join(root, '@deepseek-ai')) === false) return []
+    roots = [root]
+    // ★ 依赖**嵌套**安装时（实测：npm 装 @deepseek-ai/dsh@0.1.7-rc.2，81 个生态包落在
+    //   `node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/…` 而不是仓库根），只看根会把
+    //   **每一行**都报成"本机装不了" —— 一个把健康预设说成 broken、并引导用户关掉正常行的假警报。
+    //   所以把根下每个包自己的 node_modules 也算进去。
+    try {
+      for (const entry of readdirSync(join(root, '@deepseek-ai'))) {
+        const nested = join(root, '@deepseek-ai', entry, 'node_modules')
+        if (existsSync(join(nested, '@deepseek-ai'))) roots.push(nested)
+      }
+    } catch {
+      /* 读不了目录就只用根，与从前一致 */
+    }
   }
   const out = []
   const lines = text.split('\n')
@@ -752,7 +725,7 @@ export function unresolvableRows(text) {
     // 注入了集合就用集合（新线：来自 compositionInventory 的 moduleName）——
     // 子路径说明符（`@scope/pkg/sub`）与它的包名都算命中，否则会把健康行误报成坏行。
     const present = fromFilesystem
-      ? existsSync(join(root, pkg))
+      ? roots.some((each) => existsSync(join(each, pkg)))
       : knownModuleNames.has(name) || knownModuleNames.has(pkg)
     if (present === false) out.push({ id: row[2], name })
   }

package/index.mjs

@@ -1,11 +1,12 @@
 /**
  * Host half: the 「自定义模式」 settings page — an ASSISTANT MANAGER.
  *
- * It registers five exact routes on the platform's shared `/api` channel; the browser half calls them
- * with `fetch`:
+ * It registers seven exact routes on the platform's shared `/api` channel; the browser half calls
+ * them with `fetch`:
  *
  *   GET  /api/custom-mode              — every assistant this feature manages.
  *   GET  /api/custom-mode/state?id=…   — one assistant: base mode, rows, switches, prompt.
+ *   GET  /api/custom-mode/history?id=…&n=… — one prompt revision (metadata comes with the state).
  *   POST /api/custom-mode/state        — { id, mode, overrides, prompt, name, description }:
  *                                        validate, render a fresh `agent.cordis.yml`, write both files.
  *   POST /api/custom-mode/create       — { name, description }: seed a new assistant from the
@@ -13,6 +14,7 @@
  *   POST /api/custom-mode/delete       — { id }: remove a locally authored assistant.
  *   POST /api/custom-mode/reorder      — { id, direction }: move one assistant up/down in the
  *                                        picker order by writing `order` into each `preset.yml`.
+ *   POST /api/custom-mode/repair       — { id }: turn off the rows this dsh line cannot resolve.
  *
  * **Why `/api` and not the raw `webServer` table**: the carrier that owns the `/api` channel applies the
  * platform's trust and authentication policy — loopback/`trustedHosts` Host check, `Sec-Fetch-Site`,
@@ -24,7 +26,7 @@
  * route answered 401; a plain form post needs no preflight, so CORS would not have helped either). The
  * registered paths are absolute *including* `/api`, which is what the platform's own packages pass.
  *
- * **Why exact routes rather than one prefix**: the Fetch registry matches exact paths. Five registrations
+ * **Why exact routes rather than one prefix**: the Fetch registry matches exact paths. Seven registrations
  * cost nothing and each declares the methods it owns, so the method table doubles as the guarantee that a
  * prefetched `GET …/create` cannot create anything — that method is simply not registered for that path.
  *
@@ -53,15 +55,17 @@ import {
   BASE_MODES,
   collectRows,
   disableRowsInPlace,
+  isBaseCompositionUnavailable,
   modeOf,
   overridesOf,
   readBaseComposition,
   setKnownModuleNames,
   renderComposition,
+  setBaseCompositions,
   setShippedPresetsDir,
   unresolvableRows,
 } from './composition.mjs'
-import { readPresetMeta, writePresetMeta, presetMetaPath, PRESET_META_PATH } from './meta.mjs'
+import { presetMetaText, readPresetMeta, writePresetMeta, presetMetaPath, PRESET_META_PATH } from './meta.mjs'
 import { listHistory, readVersion, recordExternalChange, recordPrompt, HISTORY_SOURCE } from './journal.mjs'
 import { packagedPresetDir, starterComposition } from './seed.mjs'
 import {
@@ -303,13 +307,27 @@ export function readState(rows, id, options = {}) {
       /* 审计留痕失败不影响读取 */
     }
   }
+  // 本机这条线给不给得出「出厂组成」？给不出来时**降级**而不是把整页打成 500：
+  // 提示词与名字照常可读可写，只有基础模式与插件开关不可编辑（0.1.7 上曾经整页不可用）。
+  let rowTree = []
+  let overrides = {}
+  let baseUnavailable = null
+  try {
+    rowTree = collectRows(text)
+    overrides = overridesOf(text, mode)
+  } catch (error) {
+    if (!isBaseCompositionUnavailable(error)) throw error
+    baseUnavailable = { code: error.code, params: { mode, detail: describe(error) } }
+  }
   return {
     ok: true,
     id,
     mode,
     modes: BASE_MODES,
-    rows: collectRows(text),
-    overrides: overridesOf(text, mode),
+    rows: rowTree,
+    overrides,
+    // 页面据此把「基础模式 / 插件开关」两块显示成不可用，并把原因说成人话。
+    ...baseUnavailable === null ? {} : { baseUnavailable },
     prompt: prompt.ok === true ? prompt.text : '',
     ...prompt.ok === true ? {} : { promptError: prompt.error },
     name: meta.name,
@@ -333,6 +351,8 @@ export function readState(rows, id, options = {}) {
       ...(existsSync(join(directory, 'approval-gate-missing')) ? ['approvalGateMissing'] : []),
       // 本线无法解析的启用行 = 平台会把整个预设判为 broken 并从选择器里丢掉（曾经的 P0）。
       ...(unresolvableRows(text).length > 0 ? ['unresolvableRows'] : []),
+      // 出厂组成取不到：提示词能改，基础模式与插件开关不能。
+      ...(baseUnavailable === null ? [] : ['baseCompositionUnavailable']),
     ],
   }
 }
@@ -373,6 +393,52 @@ function serializedWrite(key, work) {
   return next
 }
 
+/**
+ * 降级保存：只写提示词与元数据，组成文件一字不动。
+ *
+ * 什么时候会走到这里：本机这条 dsh 线既没有旧线的 presets 目录，也没有可用的
+ * `readDocument()`（见 base-composition.mjs 的解析链）。此时「基础模式 / 插件开关」在页面上已经
+ * 不可编辑，而用户真正想保存的那段提示词没有任何理由跟着一起失败 —— 组成文件不动，模式在平台上
+ * 的行集合也就不变，这是所有选项里破坏性最小的一个。
+ *
+ * @param {string} directory - the assistant's preset directory.
+ * @param {{id: string, mode: string, prompt: string, name: string, description: string, displayName?: 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).
+ * @returns {object} the shape `saveState` returns, with `code: 'savedPromptOnly'`.
+ */
+export function savePromptOnly(directory, { id, mode, prompt, name, description, displayName }) {
+  // 与正常保存同一条纪律：提示词与 preset.yml 一起换名，失败则两个都不动。
+  let metaText = null
+  if (name !== '') {
+    const rendered = presetMetaText(name, description, directory)
+    if (rendered.ok !== true) return rendered
+    metaText = rendered.text
+  }
+  try {
+    writeAtomicPair([
+      [promptFile(directory), prompt],
+      ...metaText === null ? [] : [[presetMetaPath(directory), metaText]],
+    ])
+  } catch (error) {
+    return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
+  }
+  try {
+    recordPrompt(directory, prompt, HISTORY_SOURCE.settings)
+  } catch {
+    /* 审计记录失败不影响保存本身 */
+  }
+  return {
+    ok: true,
+    id,
+    mode,
+    code: 'savedPromptOnly',
+    // 响应里的名字用**磁盘上的那个**（issue #9）：请求省略 name 时不该把 params.name 报成裸目录 id。
+    params: { name: (displayName === undefined || displayName === '' ? name : displayName) === '' ? id : (displayName === undefined || displayName === '' ? name : displayName), mode },
+    note: '已保存系统提示词（本机取不到基础模式的出厂组成，插件开关与基础模式未改动）。新建会话即生效。',
+  }
+}
+
 export function saveState(rows, input) {
   const id = input !== null && typeof input === 'object' && typeof input.id === 'string' ? input.id : ''
   const directory = assistantDir(rows, id)
@@ -399,6 +465,12 @@ export function saveState(rows, input) {
   }
   // 请求里**没带** description 时保留原值：API 调用方只改提示词，不该顺手把描述清空（外部评审实测）。
   const meta = readPresetMeta(directory)
+  // ★ 请求里没带 name（或页面清空）时，渲染组成仍要用**磁盘上那个名字**（issue #9）。
+  //   组成里 custom-prompt-tool 行的 config.modeName 是"会话内工具知道自己在改哪个助手"的唯一凭据；
+  //   用空串渲染会把它整块删掉，而 preset.yml 又（有意）保留旧名字 —— 两处就此不一致，
+  //   同时成功响应还会把 params.name 报成裸目录 id。请求**没带** name 与"用户把名字清空"在这里
+  //   是同一个语义：保持现状，而不是把它抹掉。
+  const effectiveName = name !== '' ? name : typeof meta.name === 'string' ? meta.name : ''
   const rawDescription =
     input !== null && typeof input === 'object' && typeof input.description === 'string'
       ? input.description
@@ -418,8 +490,23 @@ export function saveState(rows, input) {
 
   let composition
   try {
-    composition = renderComposition(mode, overrides, { modeName: name, assistantId: id })
+    composition = renderComposition(mode, overrides, { modeName: effectiveName, assistantId: id })
   } catch (error) {
+    // 拿不到出厂组成：这一页**降级**但不能全废 —— 提示词仍可单独保存（组成文件原样不动）。
+    // 页面在降级态下把基础模式与开关都设为不可编辑，所以开关集合必为空；HTTP API 直接调用
+    // 还想改开关时明确拒绝，而不是悄悄丢掉用户的意图。
+    if (isBaseCompositionUnavailable(error)) {
+      if (overrides.size === 0 && existsSync(compositionFile(directory))) {
+        return savePromptOnly(directory, { id, mode, prompt, name, description, displayName: effectiveName })
+      }
+      return {
+        ok: false,
+        code: error.code,
+        params: { mode, detail: describe(error) },
+        error:
+          '本机取不到基础模式「' + mode + '」的出厂组成，无法改动插件开关或基础模式（提示词可以单独保存）。',
+      }
+    }
     return { ok: false, code: 'renderFailed', params: { detail: describe(error) }, error: '生成组成文件失败：' + describe(error) }
   }
 
@@ -432,12 +519,21 @@ export function saveState(rows, input) {
     return { ok: false, code: 'selfCheckFailed', params: { detail: describe(error) }, error: '生成结果自检失败，已放弃写入：' + describe(error) }
   }
 
+  // 三个文件必须一起换名（issue #5）：组成、提示词、preset.yml。此前 preset.yml 是**单独**写的，
+  // 它失败时磁盘上已经是"新提示词 + 旧名字"，而页面报"保存失败"—— 页面又不会重读，于是它永远停在
+  // 旧草稿上，用户以为没保存成功。现在三份先各自写进临时文件，再一起 rename；准备阶段失败则一个都不动。
+  // 名字为空时**不动** preset.yml：空的 name 标量会让这个模式在所有选择器里退化成裸目录 id。
+  let metaText = null
+  if (name !== '') {
+    const rendered = presetMetaText(name, description, directory)
+    if (rendered.ok !== true) return rendered
+    metaText = rendered.text
+  }
   try {
-    // 组成文件与提示词必须一起更新：先都写进临时文件再一起换名，失败时不会留下"新组成 + 旧提示词"
-    // 这种混合状态（审阅指出原先两次独立原子写之间存在这个窗口）。
     writeAtomicPair([
       [compositionFile(directory), composition],
       [promptFile(directory), prompt],
+      ...metaText === null ? [] : [[presetMetaPath(directory), metaText]],
     ])
   } catch (error) {
     return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
@@ -455,19 +551,12 @@ export function saveState(rows, input) {
     /* 审计记录失败不影响保存本身 */
   }
 
-  // A name the user cleared is left alone rather than written as an empty scalar:
-  // an empty `preset.yml` name is what makes a mode render as its bare id.
-  if (name !== '') {
-    const metaResult = writePresetMeta(name, description, directory)
-    if (metaResult.ok !== true) return metaResult
-  }
-
   return {
     ok: true,
     id,
     mode,
     code: 'saved',
-    params: { name: name === '' ? id : name, mode },
+    params: { name: effectiveName === '' ? id : effectiveName, mode },
     note: '已保存（' + (name === '' ? id : name) + '，基础模式 ' + mode + '）。新建会话即生效，当前会话保持原配置。',
   }
 }
@@ -555,6 +644,14 @@ export function createAssistant(rows, input, templateDir = packagedPresetDir())
     // 与保存路径的 `renderFailed` 同一套：**每个**用户可见的结果都要带 `code`，否则页面无从本地化
     // —— client.js 的 apiText 在没有 code 时直接退回下面这串中文，英文界面会在这一刻掉回中文
     // （AGENTS.md 第 13 条）。这条曾经是宿主半唯一漏掉 code 的普通返回。
+    if (isBaseCompositionUnavailable(error)) {
+      return {
+        ok: false,
+        code: error.code,
+        params: { mode: 'standard', detail: describe(error) },
+        error: '本机取不到出厂组成，暂时无法新建助手。',
+      }
+    }
     return { ok: false, code: 'renderFailed', params: { detail: describe(error) }, error: '生成组成文件失败：' + describe(error) }
   }
 
@@ -749,6 +846,9 @@ export function apply(ctx) {
       ['connection.fetch.register()', () => typeof scope.connection?.fetch?.register === 'function'],
     ]
     const OPTIONAL_APIS = [
+      // 出厂组成的来源（新线）：由宿主交出声明 YAML。缺了它插件仍能注册/同步，只是设置页里
+      // 「基础模式 / 插件开关」会降级为不可编辑（提示词照常）—— 所以它是可选能力。
+      ['agentPresets.readDocument()', () => typeof scope.agentPresets?.readDocument === 'function'],
       // 旧线的文件系统语义；新线由 preset-backend 的 declarative 后端用 disposer 补上。
       ['agentPresets.remove()', () => typeof scope.agentPresets?.remove === 'function'],
       ['agentPresets.copy()', () => typeof scope.agentPresets?.copy === 'function'],
@@ -785,7 +885,7 @@ export function apply(ctx) {
     let shippedReady = null
     const ensureShipped = () => {
       if (shippedReady === null) {
-        shippedReady = (async () => {
+        const attempt = (async () => {
           try {
             const rows = await scope.agentPresets.list()
             const system = rows.find((row) => row.trust === 'system' && typeof row.path === 'string')
@@ -795,6 +895,10 @@ export function apply(ctx) {
             console.error('custom-mode: 无法从 roster 解析出厂预设目录：' + describe(error))
           }
         })()
+        // 失败不缓存：旧线之外这条路本就可能没有 system 行，但一次**抛错**不该变成
+        // "整个进程生命周期内都不再解析"。
+        attempt.catch(() => { shippedReady = null })
+        shippedReady = attempt
       }
       return shippedReady
     }
@@ -853,6 +957,28 @@ export function apply(ctx) {
           console.error('custom-mode: 读取 compositionInventory 失败（回退文件系统判定）: ' + describe(error))
         }
       }
+      // 出厂组成：新线上唯一的来源是宿主自己（readDocument）。取到就交给 composer；取不到就交给
+      // 降级路径。两种情况都不阻塞下面的注册表同步 —— 模式可用优先于设置页完整。
+      if (declarative !== null) {
+        try {
+          const bases = await declarative.fetchBaseCompositions(BASE_MODES.map((mode) => mode.id))
+          setBaseCompositions(bases.fetched)
+          if (bases.fetched.size > 0) {
+            console.log(
+              'custom-mode: 已取回 ' + String(bases.fetched.size) + ' 个基础模式的出厂组成（' +
+                [...bases.fetched.keys()].join('、') + '）',
+            )
+          }
+          if (bases.problems.length > 0) {
+            console.error(
+              'custom-mode: 取不到这些基础模式的出厂组成 —— ' + bases.problems.join('；') +
+                '。对应模式仍可编辑提示词，基础模式与插件开关会显示为不可用。',
+            )
+          }
+        } catch (error) {
+          console.error('custom-mode: 取回出厂组成时出错（已忽略）: ' + describe(error))
+        }
+      }
       if (declarative === null) return
       try {
         const rows = await rawRoster()

package/locales.mjs

@@ -60,6 +60,8 @@ export const zh = {
   'assistant.short': '每个助手是一个独立模式：自己的系统提示词、基础模式与插件开关。',
   'name.short': '改名只影响显示，内部标识与已有会话不受影响。',
   'mode.short': '底子决定「行集合」与工具能力；persona 行始终由本模式替换。',
+  'mode.unavailable': '本机这条 DSH 线没有可读的出厂组成，基础模式暂时不能切换。',
+  'rows.unavailable': '出厂组成取不到，插件开关暂时不能编辑；磁盘上原有的行状态仍然生效。',
   'mode.pendingRows': '底子已改为「{mode}」：保存后，下面的行列表会按新底子重算。',
   'rows.short': '逐行控制挂载哪些插件；没拨过的行保持官方默认。',
   'prompt.short': '这段文本就是本模式的系统提示词，保存后下一步生效。',
@@ -109,8 +111,11 @@ export const zh = {
   '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 不会被注入 —— 你写的提示词现在不起作用。要么打开这一行，要么清空提示词。',
@@ -286,6 +291,8 @@ export const en = {
   '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.',
@@ -335,6 +342,8 @@ export const en = {
   '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".',
@@ -343,6 +352,7 @@ export const en = {
   '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',

package/meta.mjs

@@ -95,19 +95,21 @@ function yamlScalar(value) {
 }
 
 /**
- * Write `preset.yml` with a display name and optional description.
+ * Render the exact bytes `writePresetMeta` would write, without writing them.
  *
- * The name is required: an empty one would render the mode as its bare directory
- * id everywhere.
+ * Why it is exported: the settings page writes the composition, the prompt **and** this file, and a review
+ * found the third one landing separately — so a failure while writing `preset.yml` left a new prompt with
+ * the old name on disk while the page reported "save failed" (issue #5). All three now go through one
+ * staged atomic write; that requires the text, not a second writer.
  *
- * @param {string} name - display name.
+ * @param {string} name - display name (required).
  * @param {string|undefined} description - optional description.
- * @param {string} [directory] - the preset directory (defaults to the legacy `custom`).
- * @param {{order?: number}} [options] - roster position. Omitted means "keep whatever is on
- *   disk": a rename must never reshuffle the pickers.
- * @returns {{ok: true, name: string} | {ok: false, error: string}} the outcome.
+ * @param {string} directory - the preset directory (for the existing `order`).
+ * @param {{order?: number}} [options] - explicit roster position.
+ * @returns {{ok: true, text: string, name: string} | {ok: false, code: string, error: string}} the bytes and the
+ *   normalized name, or why there are none.
  */
-export function writePresetMeta(name, description, directory = PRESET_DIR, options = {}) {
+export function presetMetaText(name, description, directory = PRESET_DIR, options = {}) {
   const cleanName = typeof name === 'string' ? name.replace(/\r?\n/g, ' ').trim() : ''
   if (cleanName === '') return { ok: false, code: 'nameRequired', error: '模式名称不能为空。' }
   const lines = ['name: ' + yamlScalar(cleanName)]
@@ -118,10 +120,29 @@ export function writePresetMeta(name, description, directory = PRESET_DIR, optio
   const order =
     typeof requested === 'number' && Number.isFinite(requested) ? Math.trunc(requested) : readPresetMeta(directory).order
   if (order !== undefined) lines.push('order: ' + String(order))
+  return { ok: true, text: lines.join('\n') + '\n', name: cleanName }
+}
+
+/**
+ * Write `preset.yml` with a display name and optional description.
+ *
+ * The name is required: an empty one would render the mode as its bare directory
+ * id everywhere.
+ *
+ * @param {string} name - display name.
+ * @param {string|undefined} description - optional description.
+ * @param {string} [directory] - the preset directory (defaults to the legacy `custom`).
+ * @param {{order?: number}} [options] - roster position. Omitted means "keep whatever is on
+ *   disk": a rename must never reshuffle the pickers.
+ * @returns {{ok: true, name: string} | {ok: false, error: string}} the outcome.
+ */
+export function writePresetMeta(name, description, directory = PRESET_DIR, options = {}) {
+  const rendered = presetMetaText(name, description, directory, options)
+  if (rendered.ok !== true) return rendered
   try {
     // **非原子写的最坏后果在这里**：preset.yml 写坏 = 这个模式从所有选择器里消失（见本文件头注释）。
     // 实测审阅指出这里原先用的是裸 writeFileSync，与设置页的纪律不一致；现在共用同一份实现。
-    writeAtomic(presetMetaPath(directory), lines.join('\n') + '\n')
+    writeAtomic(presetMetaPath(directory), rendered.text)
   } catch (error) {
     // 带 `code`：这条是保存路径上最后一个没有 code 的用户可见失败，英文界面此前会在这里显示中文。
     // 它发生得尤其难受 —— 组成文件与提示词**已经写成功**了，只有 preset.yml 没写成，所以页面
@@ -129,5 +150,5 @@ export function writePresetMeta(name, description, directory = PRESET_DIR, optio
     const detail = String((error && error.message) || error)
     return { ok: false, code: 'metaWriteFailed', params: { detail }, error: '写入 preset.yml 失败：' + detail }
   }
-  return { ok: true, name: cleanName }
+  return { ok: true, name: rendered.name }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-custom-mode",
-  "version": "1.9.12",
+  "version": "1.9.14",
   "description": "Custom modes and custom prompts for DeepSeek Harness (dsh): edit a mode's system prompt on the settings page (it takes effect on the next model step), pick its base mode, switch plugin rows one by one, and keep several assistants side by side — coding, chat or roleplay (RP) personas (multi-mode / multi-agent).",
   "license": "MIT",
   "type": "module",
@@ -53,11 +53,13 @@
     "atomic.mjs",
     "client.js",
     "composition.mjs",
+    "base-composition.mjs",
     "meta.mjs",
     "paths.mjs",
     "locales.mjs",
     "journal.mjs",
     "cordis.patch.yml",
+    "LICENSE",
     "preset-backend/",
     "preset/"
   ],

package/preset-backend/declarative.mjs

@@ -163,6 +163,41 @@ export function createDeclarativeBackend({ scope, log = console.log, warn = cons
     for (const id of [...mounted.keys()]) await unmount(id)
   }
 
+  /**
+   * Fetch the shipped base compositions the host declares, as entry-list YAML.
+   *
+   * `readDocument()` is the 0.1.7 replacement for the presets directory the composer used to read:
+   * it returns the declaration **including** the `isolate` groups and `!!js` predicates that
+   * `compositionInventory()` flattens away (measured 2026-09-25 on 0.1.7-rc.2:
+   * `readDocument('standard').content` is the same row list, verbatim YAML).
+   *
+   * Missing API, or a mode that fails to read, is **not** fatal: the host half falls back to the
+   * packaged patch files and, if those are missing too, to a typed "unavailable" state in which the
+   * prompt stays editable. So this never throws — it reports.
+   *
+   * @param {Iterable<string>} modeIds - the base modes to fetch.
+   * @returns {{ok: boolean, fetched: Map<string,string>, problems: string[]}}
+   */
+  async function fetchBaseCompositions(modeIds) {
+    const fetched = new Map()
+    const problems = []
+    if (typeof scope.agentPresets?.readDocument !== 'function') {
+      return { ok: false, fetched, problems: ['agentPresets.readDocument() 不可用'] }
+    }
+    for (const id of modeIds) {
+      try {
+        const document = await scope.agentPresets.readDocument(id)
+        const text = document !== null && typeof document === 'object' ? document.content : undefined
+        if (typeof text !== 'string' || text.trim() === '') problems.push(`${id}: 声明为空`)
+        else fetched.set(id, text)
+      } catch (error) {
+        // 不为某一条基础模式的成功而重试整轮：读不到的交给降级路径，并指名它。
+        problems.push(`${id}: ${describe(error)}`)
+      }
+    }
+    return { ok: problems.length === 0, fetched, problems }
+  }
+
   return {
     id: BACKEND_ID,
     /** 新线不把 preset 落到磁盘，注册表就是唯一真相。 */
@@ -171,6 +206,7 @@ export function createDeclarativeBackend({ scope, log = console.log, warn = cons
     mountOne,
     unmount,
     disposeAll,
+    fetchBaseCompositions,
     mountedIds: () => [...mounted.keys()],
   }
 }