dsh-custom-mode 1.9.6 → 1.9.7

package/README.md

@@ -2,11 +2,12 @@
 
 ![dsh-custom-mode — a settings page for dsh agent modes](https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/header.png)
 
-[![npm](https://img.shields.io/npm/v/dsh-custom-mode?label=npm&style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/dsh-custom-mode) [![CI](https://img.shields.io/github/actions/workflow/status/BOWLUNA/dsh-custom-mode/test.yml?label=CI&style=flat-square&logo=githubactions&logoColor=white)](https://github.com/BOWLUNA/dsh-custom-mode/actions/workflows/test.yml) [![license](https://img.shields.io/npm/l/dsh-custom-mode?label=license&style=flat-square&logo=opensourceinitiative&logoColor=white)](LICENSE)
+[![npm](https://img.shields.io/npm/v/dsh-custom-mode?label=npm&style=flat-square&logo=npm&logoColor=white&labelColor=1f2430)](https://www.npmjs.com/package/dsh-custom-mode) [![CI](https://img.shields.io/github/actions/workflow/status/BOWLUNA/dsh-custom-mode/test.yml?label=CI&style=flat-square&logo=githubactions&logoColor=white&labelColor=1f2430)](https://github.com/BOWLUNA/dsh-custom-mode/actions/workflows/test.yml) [![license](https://img.shields.io/badge/license-MIT-97ca00?style=flat-square&logo=opensourceinitiative&logoColor=white&labelColor=1f2430)](LICENSE) [![dsh](https://img.shields.io/badge/dsh-%E2%89%A50.1.5--rc.2-4d6bfe?style=flat-square&logo=deepseek&logoColor=white&labelColor=1f2430)](https://github.com/BOWLUNA/dsh-custom-mode#readme)
 
-<!-- community badge row: required in every new repository (see the storefront template in the operator SOP/DSH Plugins folder) -->
+<!-- badge rows: same two-part structure (dark label + coloured value) in both rows; every new repo copies this block -->
+[![bilibili](https://img.shields.io/badge/bilibili-videos-%2300A1D6?style=flat-square&logo=bilibili&logoColor=white&labelColor=1f2430)](https://b23.tv/qJ4Ev0W) [![Douyin](https://img.shields.io/badge/Douyin-shorts-%23FE2C55?style=flat-square&logo=tiktok&logoColor=white&labelColor=1f2430)](https://v.douyin.com/VWh0M03Fa4Y/) [![RedNote](https://img.shields.io/badge/RedNote-notes-%23FF2442?style=flat-square&logo=xiaohongshu&logoColor=white&labelColor=1f2430)](https://xhslink.cn/o/A7QtXmePBBF) [![Discord](https://img.shields.io/badge/Discord-chat-%235865F2?style=flat-square&logo=discord&logoColor=white&labelColor=1f2430)](https://discord.gg/pz97SfAfSy) [![GitHub](https://img.shields.io/github/discussions/BOWLUNA/dsh-custom-mode?label=GitHub&style=flat-square&logo=github&logoColor=white&labelColor=1f2430)](https://github.com/BOWLUNA/dsh-custom-mode/discussions)
 
-[![bilibili](https://img.shields.io/badge/bilibili-%2300A1D6?style=flat-square&logo=bilibili&logoColor=white)](https://b23.tv/qJ4Ev0W) [![Douyin](https://img.shields.io/badge/Douyin-%23FE2C55?style=flat-square&logo=tiktok&logoColor=white)](https://v.douyin.com/VWh0M03Fa4Y/) [![RedNote](https://img.shields.io/badge/RedNote-%23FF2442?style=flat-square&logo=xiaohongshu&logoColor=white)](https://xhslink.cn/o/A7QtXmePBBF) [![Discord](https://img.shields.io/badge/Discord-%235865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/pz97SfAfSy) [![Discussions](https://img.shields.io/github/discussions/BOWLUNA/dsh-custom-mode?label=Discussions&style=flat-square&logo=github&logoColor=white)](https://github.com/BOWLUNA/dsh-custom-mode/discussions)
+<!-- community badge row: required in every new repository (see the storefront template in the operator SOP/DSH Plugins folder) -->
 
 The **settings-page half** of [dsh-custom-mode](https://github.com/BOWLUNA/dsh-custom-mode) — a Web UI for
 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (dsh) agent modes: choose a mode's base
@@ -15,7 +16,8 @@ agent loop re-reads before every model step — **a save applies on the next ste
 session**. Several modes ("assistants") live side by side, each with its own prompt.
 
 Searched for as: custom mode · custom prompt · system-prompt editor · multi-mode / several assistants ·
-自定义模式 · 自定义提示词 · 多助手／多模式.
+multi-agent · roleplay (RP) / chat personas ·
+自定义模式 · 自定义提示词 · 多助手／多模式 · 角色扮演／聊天人格（RP）.
 
 ![Assistant manager](https://raw.githubusercontent.com/BOWLUNA/dsh-custom-mode/main/docs/images/05-assistant-manager.png)
 

package/assistants.mjs

@@ -28,7 +28,10 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { dshHome, PRESET_DIR } from './paths.mjs'
-import { readPresetMeta, writePresetMeta } from './meta.mjs'
+// `presetMetaPath` 曾被漏掉：reorderAssistant 用它做"快照 → 失败回滚"，于是两处调用都抛
+// ReferenceError 被 try/catch 吞掉，回滚循环 continue 掉每一条 —— 用户看到的"已回滚"从未发生，
+// 磁盘上留下改了一半的 order。少一个导入就能让一整段安全网变成死代码（外部评审复现）。
+import { readPresetMeta, writePresetMeta, presetMetaPath } from './meta.mjs'
 import { writeAtomic } from './atomic.mjs'
 import { unresolvableRows } from './composition.mjs'
 import { seedPreset, seedPresetWithLog } from './seed.mjs'
@@ -256,20 +259,22 @@ export function allocateId(name, taken) {
  * @returns {{ok: true, id: string, dir: string} | {ok: false, error: string}}
  */
 export function createAssistantDir({ root, id, composition, templateDir }) {
+  // 每个用户可见的结果都带 `code`（AGENTS.md 第 13 条）：没有它，页面只能显示下面这串中文，
+  // 英文界面就在这一刻掉回中文。前三条还会被设置页原样显示给用户。
   if (!PRESET_ID.test(String(id ?? ''))) {
-    return { ok: false, error: `助手标识不合法：${String(id)}（只能是 a-z0-9 与连字符）` }
+    return { ok: false, code: 'badAssistantId', params: { id: String(id) }, error: `助手标识不合法：${String(id)}（只能是 a-z0-9 与连字符）` }
   }
   const dir = join(root, id)
-  if (existsSync(dir)) return { ok: false, error: `目录已存在：${dir}` }
+  if (existsSync(dir)) return { ok: false, code: 'dirExists', params: { path: dir }, error: `目录已存在：${dir}` }
 
   const seeded = seedPreset(dir, templateDir)
   if (seeded.errors.length > 0) {
-    return { ok: false, error: '复制模式模板失败：' + seeded.errors.join('；') }
+    return { 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, error: '写入组成文件失败：' + describe(error) }
+    return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入组成文件失败：' + describe(error) }
   }
   return { ok: true, id, dir }
 }

package/client.js

@@ -138,6 +138,13 @@ try {
         "api.promptWriteFailed": "写入提示词失败：{detail}",
         "api.renderFailed": "生成组成文件失败：{detail}",
         "api.selfCheckFailed": "生成结果自检失败，已放弃写入：{detail}",
+        "api.internalError": "宿主内部错误：{detail}",
+        "api.bodyTooLarge": "请求体过大（上限 {max} 字节）",
+        "api.repairNotNeeded": "这个助手在本机没有无法解析的行，无需修复。",
+        "api.repaired": "已按本机这条 dsh 线关闭 {count} 个无法解析的行（{ids}）。现在这个模式能重新出现在选择器里。",
+        "api.badAssistantId": "助手标识不合法：{id}（只能用 a-z、0-9 与连字符）",
+        "api.seedFailed": "复制模式模板失败：{detail}",
+        "api.metaWriteFailed": "写入 preset.yml 失败：{detail}",
         "api.promptReadFailed": "读取提示词失败：{detail}",
         "api.noRemoveApi": "当前 DSH 版本没有 agentPresets.remove()，无法删除。",
         "api.deleteFailed": "删除失败：{detail}",
@@ -338,6 +345,13 @@ try {
         "api.promptWriteFailed": "Writing the prompt failed: {detail}",
         "api.renderFailed": "Rendering the composition failed: {detail}",
         "api.selfCheckFailed": "The generated composition failed its self-check, so nothing was written: {detail}",
+        "api.internalError": "Unexpected host error: {detail}",
+        "api.bodyTooLarge": "Request body too large (limit {max} bytes)",
+        "api.repairNotNeeded": "Nothing to repair — no row of this assistant is unresolvable on this machine.",
+        "api.repaired": "Disabled {count} row(s) this dsh line cannot resolve ({ids}). The mode can appear in the pickers again.",
+        "api.badAssistantId": "Invalid assistant id: {id} (a-z, 0-9 and hyphens only)",
+        "api.seedFailed": "Copying the mode template failed: {detail}",
+        "api.metaWriteFailed": "Writing preset.yml failed: {detail}",
         "api.promptReadFailed": "Reading the prompt failed: {detail}",
         "api.noRemoveApi": "This DSH build has no agentPresets.remove(), so deleting is unavailable.",
         "api.deleteFailed": "Delete failed: {detail}",

package/index.mjs

@@ -196,8 +196,12 @@ export function readPrompt(directory) {
 
 /** The isolation message for an id the roster does not describe as a managed assistant. */
 function unknownAssistant(id) {
+  // 带 `code`：两个标签页同时开着、在 B 里删掉这个助手、回到 A 点保存时走的就是这条 ——
+  // 没有 code 时英文界面会显示下面这串中文，而词典里的 `api.unknownAssistant` 反而永远用不上。
   return {
     ok: false,
+    code: 'unknownAssistant',
+    params: { id: String(id) },
     error:
       '找不到助手「' +
       String(id) +
@@ -414,13 +418,22 @@ export function saveState(rows, input) {
       [compositionFile(directory), composition],
       [promptFile(directory), prompt],
     ])
-    // 改动留痕：三个改动路径（设置页 / 会话内工具 / 手工编辑）里，只有设置页是"当场知道"的。
-    // 另外两条由 readState 对比补记（见 journal.mjs 的单写者说明）。
-    recordPrompt(directory, prompt, HISTORY_SOURCE.settings)
   } catch (error) {
     return { ok: false, code: 'writeFailed', params: { detail: describe(error) }, error: '写入失败：' + describe(error) }
   }
 
+  // 改动留痕：三个改动路径（设置页 / 会话内工具 / 手工编辑）里，只有设置页是"当场知道"的。
+  // 另外两条由 readState 对比补记（见 journal.mjs 的单写者说明）。
+  //
+  // **在写入 try 之外**：这是一条审计记录，它失败不该让一次已经落盘的保存报 writeFailed
+  // ——外部评审复现过：日志文件被 chmod 000 时，prompt.md 已经写成功而页面显示"保存失败"，
+  // 页面又不会重新读取，于是它永远停在旧草稿上。留痕失败只降级为"这一版没记上"。
+  try {
+    recordPrompt(directory, prompt, HISTORY_SOURCE.settings)
+  } catch {
+    /* 审计记录失败不影响保存本身 */
+  }
+
   // 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 !== '') {
@@ -511,7 +524,10 @@ export function createAssistant(rows, input, templateDir = packagedPresetDir())
       ? renderComposition('standard', new Map(), { modeName: name, assistantId: id })
       : renderComposition(source.mode, source.overrides, { modeName: name, assistantId: id })
   } catch (error) {
-    return { ok: false, error: '生成组成文件失败：' + describe(error) }
+    // 与保存路径的 `renderFailed` 同一套：**每个**用户可见的结果都要带 `code`，否则页面无从本地化
+    // —— client.js 的 apiText 在没有 code 时直接退回下面这串中文，英文界面会在这一刻掉回中文
+    // （AGENTS.md 第 13 条）。这条曾经是宿主半唯一漏掉 code 的普通返回。
+    return { ok: false, code: 'renderFailed', params: { detail: describe(error) }, error: '生成组成文件失败：' + describe(error) }
   }
 
   const created = createAssistantDir({ root, id, composition, templateDir })
@@ -819,7 +835,9 @@ export function apply(ctx) {
         const result = await serializedWrite('delete:' + targetId, async () => deleteAssistant(await roster(), parsed, scope.agentPresets))
         return json(result, result.ok === true ? 200 : 400)
       } catch (error) {
-        return json({ ok: false, error: describe(error) }, 500)
+        // 兜底也要带 code：这是**意料之外**的异常，页面拿到的是 Node 的原始错误串，方向反着也一样糟
+        // ——中文界面里会蹦出一句英文。带 code 后页面用自己的词典渲染，原始串只作为 `detail` 参数。
+        return json({ ok: false, code: 'internalError', params: { detail: describe(error) }, error: describe(error) }, 500)
       }
     }
 

package/journal.mjs

@@ -55,8 +55,18 @@ export function historyFile(directory) {
 export function readEntries(directory) {
   const file = historyFile(directory)
   if (!existsSync(file)) return []
+  let raw = ''
+  try {
+    raw = readFileSync(file, 'utf8')
+  } catch {
+    // **坏的是文件本身**（不是某一行）：被 chmod 000（一次 sudo 跑 dsh 就会把 root 属主留在
+    // 日志上）、被改成目录、或读到一半的 EIO。此前这里裸读，于是这一个文件能同时做到两件坏事 ——
+    // 让 GET state（页面打开某个助手的入口）永远 500，以及让一次**已经写成功**的保存报 writeFailed。
+    // 模块自己的承诺是"坏一行不该赔上全部版本"，那么坏一个文件更不该赔上这个助手。
+    return []
+  }
   const entries = []
-  for (const line of readFileSync(file, 'utf8').split('\n')) {
+  for (const line of raw.split('\n')) {
     if (line.trim() === '') continue
     try {
       const parsed = JSON.parse(line)
@@ -82,13 +92,16 @@ export function readEntries(directory) {
  * @param {string} directory - one assistant's preset directory.
  * @param {string} text - the prompt content **after** the change.
  * @param {string} by - {@link HISTORY_SOURCE}.
- * @returns {{ recorded: boolean, at: string, n: number }} whether a line was appended.
+ * @returns {{ recorded: boolean, at: string, n: number }} whether a line was appended. `n` is the
+ *   revision this text already corresponds to when `recorded` is false, and `0` when the input could
+ *   not be recorded at all — never `undefined`, so a caller can feed it straight back to
+ *   {@link readVersion} without a guard that nobody would remember to write.
  */
 export function recordPrompt(directory, text, by = HISTORY_SOURCE.settings) {
-  if (typeof text !== 'string') return { recorded: false, at: '' }
+  if (typeof text !== 'string') return { recorded: false, at: '', n: 0 }
   const entries = readEntries(directory)
   const newest = entries[entries.length - 1]
-  if (newest !== undefined && newest.text === text) return { recorded: false, at: newest.at }
+  if (newest !== undefined && newest.text === text) return { recorded: false, at: newest.at, n: newest.n }
 
   const at = new Date().toISOString()
   const n = entries.length === 0 ? 1 : entries[entries.length - 1].n + 1

package/locales.mjs

@@ -97,6 +97,13 @@ export const zh = {
   'api.promptWriteFailed': '写入提示词失败：{detail}',
   'api.renderFailed': '生成组成文件失败：{detail}',
   'api.selfCheckFailed': '生成结果自检失败，已放弃写入：{detail}',
+  'api.internalError': '宿主内部错误：{detail}',
+  'api.bodyTooLarge': '请求体过大（上限 {max} 字节）',
+  'api.repairNotNeeded': '这个助手在本机没有无法解析的行，无需修复。',
+  'api.repaired': '已按本机这条 dsh 线关闭 {count} 个无法解析的行（{ids}）。现在这个模式能重新出现在选择器里。',
+  'api.badAssistantId': '助手标识不合法：{id}（只能用 a-z、0-9 与连字符）',
+  'api.seedFailed': '复制模式模板失败：{detail}',
+  'api.metaWriteFailed': '写入 preset.yml 失败：{detail}',
   'api.promptReadFailed': '读取提示词失败：{detail}',
   'api.noRemoveApi': '当前 DSH 版本没有 agentPresets.remove()，无法删除。',
   'api.deleteFailed': '删除失败：{detail}',
@@ -313,6 +320,13 @@ export const en = {
   'api.promptWriteFailed': 'Writing the prompt failed: {detail}',
   'api.renderFailed': 'Rendering the composition failed: {detail}',
   'api.selfCheckFailed': 'The generated composition failed its self-check, so nothing was written: {detail}',
+  'api.internalError': 'Unexpected host error: {detail}',
+  'api.bodyTooLarge': 'Request body too large (limit {max} bytes)',
+  'api.repairNotNeeded': 'Nothing to repair — no row of this assistant is unresolvable on this machine.',
+  'api.repaired': 'Disabled {count} row(s) this dsh line cannot resolve ({ids}). The mode can appear in the pickers again.',
+  'api.badAssistantId': 'Invalid assistant id: {id} (a-z, 0-9 and hyphens only)',
+  'api.seedFailed': 'Copying the mode template failed: {detail}',
+  'api.metaWriteFailed': 'Writing preset.yml failed: {detail}',
   'api.promptReadFailed': 'Reading the prompt failed: {detail}',
   'api.noRemoveApi': 'This DSH build has no agentPresets.remove(), so deleting is unavailable.',
   'api.deleteFailed': 'Delete failed: {detail}',

package/meta.mjs

@@ -86,7 +86,12 @@ export function readPresetMeta(directory = PRESET_DIR) {
 /** Quote and flatten a value into a single-line YAML scalar. */
 function yamlScalar(value) {
   const flat = String(value).replace(/\r?\n/g, ' ').trim()
-  return '"' + flat.replace(/\\/g, '\\\\').replace(/"/g, '\\"') + '"'
+  // `JSON.stringify` 恰好就是 YAML 双引号标量需要的转义：除了 `"` 与 `\`，它还会把控制字符写成
+  // `\u0007` 这类转义序列。此前手工只转前两个，于是名字里一个 BEL / VT / NUL 就会写出平台
+  // js-yaml 解析不了的 preset.yml —— 这个模式在**所有选择器**里退化成裸目录 id，description 与
+  // order 一起丢，而本插件自己的页面还显示着那个名字（外部评审实测）。
+  // 对普通名字（含中文）输出与旧实现逐字节相同，所以这次替换不会动任何既有文件。
+  return JSON.stringify(flat)
 }
 
 /**
@@ -104,7 +109,7 @@ function yamlScalar(value) {
  */
 export function writePresetMeta(name, description, directory = PRESET_DIR, options = {}) {
   const cleanName = typeof name === 'string' ? name.replace(/\r?\n/g, ' ').trim() : ''
-  if (cleanName === '') return { ok: false, error: '模式名称不能为空。' }
+  if (cleanName === '') return { ok: false, code: 'nameRequired', error: '模式名称不能为空。' }
   const lines = ['name: ' + yamlScalar(cleanName)]
   if (typeof description === 'string' && description.trim() !== '') {
     lines.push('description: ' + yamlScalar(description))
@@ -118,7 +123,11 @@ export function writePresetMeta(name, description, directory = PRESET_DIR, optio
     // 实测审阅指出这里原先用的是裸 writeFileSync，与设置页的纪律不一致；现在共用同一份实现。
     writeAtomic(presetMetaPath(directory), lines.join('\n') + '\n')
   } catch (error) {
-    return { ok: false, error: '写入 preset.yml 失败：' + String((error && error.message) || error) }
+    // 带 `code`：这条是保存路径上最后一个没有 code 的用户可见失败，英文界面此前会在这里显示中文。
+    // 它发生得尤其难受 —— 组成文件与提示词**已经写成功**了，只有 preset.yml 没写成，所以页面
+    // 说"失败"而磁盘上是新提示词 + 旧名字（外部评审复现）。
+    const detail = String((error && error.message) || error)
+    return { ok: false, code: 'metaWriteFailed', params: { detail }, error: '写入 preset.yml 失败：' + detail }
   }
   return { ok: true, name: cleanName }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-custom-mode",
-  "version": "1.9.6",
-  "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), choose its base mode, switch plugins row by row, and keep several assistants side by side.",
+  "version": "1.9.7",
+  "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",
   "main": "./index.mjs",
@@ -33,7 +33,10 @@
     "custom-prompt",
     "prompt-editor",
     "prompt-engineering",
-    "persona"
+    "persona",
+    "multi-agent",
+    "roleplay",
+    "chat"
   ],
   "dsh": {
     "bundle": {

package/preset/prompt-tool.mjs

@@ -27,7 +27,7 @@
 
 import { dirname, join } from 'node:path'
 import { randomBytes } from 'node:crypto'
-import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 
 /** Absolute path of the prompt file this preset reads. */
@@ -216,6 +216,17 @@ function makeDefinition(modeName) {
         }
       }
 
+      // **显式白名单，不再靠"落到最后就当写入"。** 这段代码到这儿只剩整体替换，此前它对任何
+      // 不认识的 action（`replace` / `Write` / `overwrite` / 空串 / `append ` 末尾多一个空格）
+      // 都静默照做，而审批闸门只认识 write/append —— 一个词的拼写差异就能把用户的提示词整体
+      // 换掉且不弹审批（外部评审实测）。不认识的动词现在一律拒绝并说明，模型据此改对再调。
+      if (action !== 'write') {
+        return (
+          '写入被拒绝：未知的 action「' + action + '」。只接受 read / write / append' +
+          '（未指定 action 按 read 处理）；append 必须精确拼写，末尾多一个空格不算。'
+        )
+      }
+
       if (typeof args.text !== 'string' || args.text.trim() === '') {
         return '写入被拒绝：action 为 "write" 时必须提供非空的 text。'
       }
@@ -263,9 +274,17 @@ function registerApprovalGate(ctx) {
     () => ctx.on('tools/pre-execute', (exec, next) => {
       if (exec === null || typeof exec !== 'object' || exec.name !== TOOL_NAME) return next()
       const args = exec.arguments
-      const action = args !== null && typeof args === 'object' ? args.action : undefined
-      // 拦所有会改文件的动作：write 与 append 都在改系统提示词；未指定 action 时按 read 处理，不拦。
-      if (action !== 'write' && action !== 'append') return next()
+      // **只放行真正的读取。** 未指定 action 与 execute 一样按 read 处理；其余一律发问。
+      //
+      // 此前这里只拦 `write` / `append` 两个字面量，而 execute 把"既不是 read 也不是 append"的
+      // **任何** action 都当成整体替换 —— 于是 `replace` / `Write` / 空串 / 末尾多一个空格都能
+      // 绕过审批面板直接改掉用户的提示词（外部评审实测复现）。闸门要盖住"一切可能改文件的调用"，
+      // 不能只认识它恰好想到的那两个词。execute 那边同时加了显式白名单，两层各自独立。
+      const raw = args !== null && typeof args === 'object' ? args.action : undefined
+      // 只有"没提供 action"才等同 read（execute 也是这样兜的）；**提供了但不认识**（含空串）
+      // 一律发问 —— 闸门的判据是"这次调用会不会改文件"，不是"这个动词我认不认识"。
+      const action = typeof raw === 'string' ? raw : 'read'
+      if (action === 'read') return next()
       const verb = action === 'append' ? '追加到' : '整体替换为'
       const text = typeof args.text === 'string' ? args.text : ''
       const firstLine = text.split('\n').find((line) => line.trim() !== '') ?? ''