@zaofan/dsh-qqbot 1.5.6 → 1.5.8

package/settings-host.js

@@ -97,10 +97,180 @@ async function readJsonBody(req) {
 }
 
 /** 读命名空间当前解析值 + revision(redact 防密钥外泄) */
+/**
+ * 兜底：从 profile 的 cordis.patch.yml 里读某个 entry 的 config（2026-09-23 适配 dsh 0.1.7）。
+ *
+ * 背景：0.1.7 把设置机制换成了「从 profile 里插件条目的 config schema 推导」，
+ * 注册入口 `installSection` 已移除 → 插件静默降级后 `describe()` 里不再有本实例的 ns，
+ * 于是 /read 返回 {value:undefined,revision:undefined}（JSON 序列化后正好是 {}），
+ * 前端就显示"读取失败: {}"。
+ *
+ * 这里只做「块级 + 简单标量」提取（不整文件 YAML 解析，因为含 !!js 标签）：
+ * 找 `- id: <entryId>` 块的 `config:` 子树，逐行取标量，跳过 !!js 与嵌套子块；
+ * secret 类字段按宿主 describe(redactSecrets) 的口径打码。
+ */
+function readEntryConfigFromPatch(entryId) {
+  try {
+    if (!existsSync(PATCH_FILE)) return null;
+    const lines = readFileSync(PATCH_FILE, 'utf8').split(/\r\n|\n/);
+    const esc = String(entryId).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const headRe = new RegExp('^\\s*-\\s*id:\\s*[\'"]?' + esc + '[\'"]?\\s*$');
+    const start = lines.findIndex((l) => headRe.test(l));
+    if (start < 0) return null;
+    const headIndent = (lines[start].match(/^\s*/) || [''])[0].length;
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i++) {
+      const ind = (lines[i].match(/^\s*/) || [''])[0].length;
+      if (/- /.test(lines[i]) && ind <= headIndent) { end = i; break; }
+    }
+    const block = lines.slice(start + 1, end);
+    const ci = block.findIndex((l) => /^\s*config:\s*$/.test(l));
+    if (ci < 0) return null;
+    const cfgIndent = (block[ci].match(/^\s*/) || [''])[0].length;
+    const out = {};
+    const parseScalar = (v) => {
+      const s = String(v).trim().replace(/^['"]|['"]$/g, '');
+      if (s === 'true') return true;
+      if (s === 'false') return false;
+      if (s === 'null' || s === '~') return null;
+      if (/^-?\d+$/.test(s)) return Number(s);
+      return s;
+    };
+    // 递归解析（2026-09-24：之前只取一层，groupAdmin 这类嵌套对象的子字段全被跳过 →
+    // 前端读回来是 undefined，勾选后"保存了却跳回去"）
+    const parseBlock = (from, to, indent) => {
+      const obj = {};
+      for (let i = from; i < to; i++) {
+        const raw = block[i];
+        if (!raw.trim() || /^\s*#/.test(raw)) continue;
+        if (((raw.match(/^\s*/) || [''])[0]).length !== indent) continue;
+        const m = /^\s*([A-Za-z0-9_-]+):\s*(.*)$/.exec(raw);
+        if (!m) continue;
+        const key = m[1];
+        const rest = m[2].trim();
+        let subEnd = i + 1;
+        while (subEnd < to) {
+          const l = block[subEnd];
+          if (l.trim() && ((l.match(/^\s*/) || [''])[0]).length <= indent) break;
+          subEnd++;
+        }
+        if (rest === '') {
+          const inner = block.slice(i + 1, subEnd);
+          if (inner.some((l) => /^\s*-\s/.test(l))) {
+            const arr = [];
+            for (const l of inner) {
+              const am = /^\s*-\s*(.*)$/.exec(l);
+              if (am && am[1].trim()) arr.push(parseScalar(am[1]));
+            }
+            obj[key] = arr;
+          } else {
+            obj[key] = parseBlock(i + 1, subEnd, indent + 2);
+          }
+        } else if (rest === '[]') {
+          obj[key] = [];
+        } else if (rest.startsWith('!!js')) {
+          obj[key] = rest;                                  // 表达式：原样返回（前端只读展示）
+        } else {
+          obj[key] = parseScalar(rest);
+        }
+        i = subEnd - 1;
+      }
+      return obj;
+    };
+    const parsed = parseBlock(ci + 1, block.length, cfgIndent + 2);
+    const redact = (o) => {
+      if (!o || typeof o !== 'object') return o;
+      for (const k of Object.keys(o)) {
+        if (/secret|token|password|_key$/i.test(k)) o[k] = '__REDACTED__';
+        else if (o[k] && typeof o[k] === 'object') redact(o[k]);
+      }
+      return o;
+    };
+    redact(parsed);
+    for (const [k, v] of Object.entries(parsed)) out[k] = v;
+    return Object.keys(out).length ? out : null;
+  } catch { return null; }
+}
+/** 读一个实例的配置视图；宿主 describe 拿不到时回落到 profile patch。 */
 function viewOf(settings, ns) {
   const target = ns || NS;
-  const d = settings.describe({ redactSecrets: true }).find((x) => x.ns === target);
-  return d ? { value: d.value, revision: d.revision } : { value: undefined, revision: undefined };
+  let list = [];
+  try { list = settings.describe({ redactSecrets: true }) || []; } catch { list = []; }
+  const d = list.find((x) => x.ns === target);
+  if (d) return { value: d.value, revision: d.revision };
+  const fb = readEntryConfigFromPatch(target);
+  // revision 用 -1 标记"兜底视图、没有乐观锁基线"（/update 见负数就跳过 expectedRevision）
+  if (fb) return { value: fb, revision: -1 };
+  return { value: undefined, revision: undefined };
+}
+
+/**
+ * ── 插件自有设置存储（2026-09-24）──
+ *
+ * 为什么不再写 profile 的 `cordis.patch.yml`：
+ *   ① 0.1.7 下写 patch 会被宿主当**热更新**提交 → 插件重新 apply → 本插件启动时若凭据无效会再写
+ *      → 自反馈闭环（实测把 dsh 启动刷死、无限弹二维码）；
+ *   ② 手拼 YAML 保不住字段类型（实测 appId 写成裸数字、owners 空数组写成空串 → 宿主 schema 校验失败）；
+ *   ③ 不支持"新增键"（groupAdmin.pollJoinRequests 这类写不进去）。
+ *
+ * 改用插件自己的 JSON 存储：不触发任何热更新、JSON 天生有类型、随便加键，
+ * 而且**用户不需要手改任何配置文件**（可视化的初衷）。
+ * 位置：{DSH_HOME}/qqbot-settings/<instanceNs>.json
+ */
+const OWN_SETTINGS_DIR = join(DSH_HOME_DIR, 'qqbot-settings');
+function ownSettingsPath(ns) {
+  const safe = String(ns || NS).replace(/[^A-Za-z0-9_-]/g, '_');
+  return join(OWN_SETTINGS_DIR, safe + '.json');
+}
+function readOwnSettings(ns) {
+  try {
+    const p = ownSettingsPath(ns);
+    if (!existsSync(p)) return {};
+    const o = JSON.parse(readFileSync(p, 'utf8'));
+    return o && typeof o === 'object' ? o : {};
+  } catch { return {}; }
+}
+function writeOwnSettings(ns, obj) {
+  const p = ownSettingsPath(ns);
+  try { mkdirSync(OWN_SETTINGS_DIR, { recursive: true }); } catch { /* ignore */ }
+  try { if (existsSync(p)) writeFileSync(p + '.bak-' + Date.now(), readFileSync(p)); } catch { /* 备份失败不阻塞 */ }
+  writeFileSync(p, JSON.stringify(obj, null, 2), 'utf8');
+  return p;
+}
+/** 深合并一层（够用：本插件嵌套只到 groupAdmin / sticker.gates 这一层）。 */
+function mergeDeepOne(cur, patch) {
+  const out = Object.assign({}, cur);
+  for (const [k, v] of Object.entries(patch || {})) {
+    if (v === undefined) continue;
+    if (v === '__REDACTED__') continue;   // 脱敏占位符绝不写回
+    if (v && typeof v === 'object' && !Array.isArray(v) && out[k] && typeof out[k] === 'object' && !Array.isArray(out[k])) {
+      out[k] = Object.assign({}, out[k], v);
+    } else {
+      out[k] = v;
+    }
+  }
+  return out;
+}
+
+/** 按 (条目, 缩进层级, 键名) 去掉重复键，保留**最后一次**出现（YAML 语义）。
+ *  2026-09-24 兜底：写 patch 前必跑。重复键会让宿主的 YAML 严格解析直接抛错
+ *  （YAMLException: duplicated mapping key）→ dsh 完全启动不了。 */
+function dedupeYamlKeys(text) {
+  const lines = String(text).split(/\r?\n/);
+  const scope = ['']; const seen = new Map(); const keep = new Array(lines.length).fill(true);
+  let cur = '';
+  for (let i = 0; i < lines.length; i++) {
+    const l = lines[i];
+    if (!l.trim() || l.trimStart().startsWith('#')) continue;
+    const mId = /^(\s*)-\s*id:\s*(\S+)\s*$/.exec(l);
+    if (mId) { cur = mId[2]; seen.clear(); continue; }
+    const mK = /^(\s*)([A-Za-z0-9_-]+):/.exec(l);
+    if (!mK) continue;
+    const sig = cur + '|' + mK[1].length + '|' + mK[2];
+    if (seen.has(sig)) keep[seen.get(sig)] = false;
+    seen.set(sig, i);
+  }
+  return lines.filter((_, i) => keep[i]).join('\n');
 }
 
 /** 请求里的目录参数(dataDir 显式传; 空=primary 主账号) */
@@ -172,19 +342,37 @@ export function apply(ctx) {
   // ── 设置面板读写桥(多账号: ?ns= 选实例命名空间; 缺省 im-qqbot 主账号) ──
   route(ctx, 'GET', '/api/qqbot-settings/read', async (req, res) => {
     const u = new URL(req.url ?? '/', 'http://x');
-    writeJson(res, 200, viewOf(ctx.settings, u.searchParams.get('ns') || undefined));
+    const ns = u.searchParams.get('ns') || NS;
+    const base = viewOf(ctx.settings, ns) || {};
+    const own = readOwnSettings(ns);
+    // 自有存储优先：它就是用户在设置页保存的那份
+    const value = Object.assign({}, base.value || {}, own);
+    writeJson(res, 200, { value, revision: base.revision, source: Object.keys(own).length ? 'own' : 'patch' });
   });
   route(ctx, 'POST', '/api/qqbot-settings/update', async (req, res) => {
     const body = await readJsonBody(req);
     if (!body || typeof body !== 'object') return writeJson(res, 400, { error: 'body must be JSON object' });
     const ns = typeof body.ns === 'string' && body.ns ? body.ns : NS;
-    try {
-      await ctx.settings.update(ns, body.patch ?? {}, typeof body.expectedRevision === 'number' ? body.expectedRevision : undefined);
-      writeJson(res, 200, viewOf(ctx.settings, ns));
+    // ⚠️ 2026-09-24 起：保存一律写**插件自有存储**（{DSH_HOME}/qqbot-settings/<ns>.json），
+    //    绝不写 profile 的 cordis.patch.yml —— 写 patch 会被宿主当热更新提交，本插件启动时
+    //    若凭据无效会再写配置，形成自反馈闭环（实测把 dsh 启动刷死、无限弹二维码）。
+    //    自有存储还让「用户不必手改任何配置文件」（可视化的初衷）。
+    try {
+      const cur = readOwnSettings(ns);
+      const merged = mergeDeepOne(cur, body.patch ?? {});
+      const file = writeOwnSettings(ns, merged);
+      // 通知插件实例重新读取（桥与插件同进程；不写宿主配置 → 不触发任何热更新）
+      try { ctx.emit('qqbot/settings-changed', ns); } catch { /* 无监听者也无妨 */ }
+      const base = viewOf(ctx.settings, ns) || {};
+      writeJson(res, 200, {
+        value: Object.assign({}, base.value || {}, merged),
+        revision: base.revision,
+        mode: 'own',
+        file,
+        note: '已保存（插件自有存储，热生效）',
+      });
     } catch (e) {
-      const code = e?.code ?? '';
-      if (code === 'SETTINGS_CONFLICT' || code === 'SettingsConflictError') return writeJson(res, 409, { error: e.message });
-      writeJson(res, 400, { error: String(e?.message ?? e) });
+      writeJson(res, 500, { error: '保存失败：' + String(e?.message ?? e) });
     }
   });
 
@@ -514,11 +702,22 @@ export function apply(ctx) {
 
       if (orig) {
         const kv = {};
-        if (inst.appId !== undefined) kv.appId = yq(String(inst.appId));
-        if (secret) kv.appSecret = ysec(secret);
-        if (inst.preset !== undefined && String(inst.preset) !== '') kv.preset = yq(String(inst.preset));
-        if (inst.cwd !== undefined && String(inst.cwd) !== '') kv.cwd = yq(String(inst.cwd));
+        // ✅ 2026-09-24：已有账号的 appId/appSecret/preset/cwd 只写**自有存储**，不再写 patch。
+        //    原因：patch 里 - insert: 下挂多条目时，updateKeysInBlock 的块边界会跨到隔壁条目，
+        //    实测把 im-qqbot-2 的凭据写进了 mcp-chrome、并给 im-qqbot-3 追加重复键。
+        //    插件启动时自有存储会覆盖 patch 值，所以只写自有存储完全等效，且绝不会写歪。
+        //    disabled 例外：它是宿主的 entry 属性、不在 config 里，必须继续写 patch。
+        const ownKv = {};
+        if (inst.appId !== undefined) ownKv.appId = String(inst.appId);
+        if (secret) ownKv.appSecret = String(secret);
+        if (inst.preset !== undefined && String(inst.preset) !== '') ownKv.preset = String(inst.preset);
+        if (inst.cwd !== undefined && String(inst.cwd) !== '') ownKv.cwd = String(inst.cwd);
+        try {
+          const nsKey = String(inst.settingsNs || inst.id);
+          writeOwnSettings(nsKey, Object.assign(readOwnSettings(nsKey), ownKv));
+        } catch { /* 自有存储失败 → 退化到写 patch（下面仍会处理 disabled） */ }
         if (inst.disabled !== undefined) kv.disabled = inst.disabled ? 'true' : 'false';
+        if (Object.keys(kv).length) updates.push({ id: String(inst.id), kv });
         updates.push({ id: String(inst.id), kv });
       } else {
         appends.push(renderBotBlock({ ...inst, appSecret: secret, dataRoot }));
@@ -540,6 +739,27 @@ export function apply(ctx) {
     let out = lines.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
     if (appends.length) out += (out.trimEnd() ? '\n' : '') + appends.join('\n') + '\n';
     writeFileSync(`${PATCH_FILE}.bak`, raw, 'utf8');
+    // ✅ 2026-09-24 兜底①：写前按 (条目,缩进,键) 去重。
+    //    起因：`- insert:` 下挂多条目时块边界会跨到隔壁条目，曾把凭据写进 mcp-chrome、
+    //    并给 im-qqbot-3 追加重复键；重复键会让宿主 YAML 解析抛错、dsh 完全起不来。
+    out = dedupeYamlKeys(out);
+    // ✅ 2026-09-24 兜底②：把凭据同步写进插件自有存储。
+    //    插件启动时自有存储**覆盖** patch 的值，所以即便 patch 被写歪，机器人照样用正确凭据连上。
+    try {
+      for (const inst of instances) {
+        if (inst.remove) continue;
+        const nsKey = String(inst.settingsNs || inst.id);
+        const cur = readOwnSettings(nsKey);
+        let sec = String(inst.appSecret ?? '');
+        if (!sec || sec === SECRET_MASK) sec = cur.appSecret ? String(cur.appSecret) : '';
+        if (inst.appId !== undefined) cur.appId = inst.appId;
+        if (sec) cur.appSecret = sec;
+        if (inst.preset) cur.preset = String(inst.preset);
+        if (inst.cwd) cur.cwd = String(inst.cwd);
+        if (inst.disabled !== undefined) cur.disabled = !!inst.disabled;
+        writeOwnSettings(nsKey, cur);
+      }
+    } catch { /* 自有存储失败不阻塞 patch 写入 */ }
     writeFileSync(PATCH_FILE, out, 'utf8');
     return { ok: true, file: PATCH_FILE, needRestart: true };
   }
@@ -751,9 +971,30 @@ export function apply(ctx) {
   });
   // 复制并双名: {sourceId, newId, newName}
   route(ctx, 'POST', '/api/qqbot-settings/presets/copy', async (req, res) => {
-    const blocked = presetWriteBlocked();
-    if (blocked) return writeJson(res, 501, { error: blocked });
     const body = await readJsonBody(req);
+    // dsh 0.1.7+：预设是 profile patch 里的声明行 → 复制 = 整段搬运 + 改写 id/name
+    if (getAgentPresets()) {
+      if (!body || typeof body.sourceId !== 'string' || typeof body.newId !== 'string') {
+        return writeJson(res, 400, { error: 'sourceId/newId 必填' });
+      }
+      const nId = body.newId.trim();
+      if (!ID_RE.test(nId)) return writeJson(res, 400, { error: '预设 id 只能字母/数字开头，含 - _' });
+      if (nId === String(body.sourceId).trim()) return writeJson(res, 400, { error: '新预设 id 不能与源相同' });
+      const nName = String(body.newName ?? nId).trim() || nId;
+      try {
+        const arr = await getAgentPresets().list();
+        if (Array.isArray(arr) && arr.some((x) => x && x.id === nId)) {
+          return writeJson(res, 409, { error: '预设 ' + nId + ' 已存在' });
+        }
+      } catch { /* 列表不可用时靠 patch 自身判断 */ }
+      const srcId = String(body.sourceId).trim();
+      // 先按 patch 里的原块整段复制（原汁原味、字节保真）；
+      // patch 里没有（如宿主内置预设 standard）→ 回退用宿主文档读出组成再生成
+      let r = copyPresetDecl(srcId, nId, nName);
+      if (!r.ok) r = await copyPresetViaDocument(srcId, nId, nName);
+      if (!r.ok) return writeJson(res, 404, { error: r.error });
+      return writeJson(res, 200, { ok: true, newId: nId, backup: r.backup, note: '已写入 profile patch，热生效（新会话生效）' });
+    }
     if (!body || typeof body.sourceId !== 'string' || typeof body.newId !== 'string') {
       return writeJson(res, 400, { error: 'sourceId/newId 必填' });
     }
@@ -781,9 +1022,22 @@ export function apply(ctx) {
   // 从内置"标准模式(standard)"新建一个预设(空机器起步用): 复制宿主 standard + 自动补 QQ 通道工具行
   // 复用宿主原生 agentPresets.copy(from,id,name) —— 复制出的正是宿主当前标准版, 保证能跑; 无需自己拼组合。
   route(ctx, 'POST', '/api/qqbot-settings/presets/new', async (req, res) => {
-    const blocked = presetWriteBlocked();
-    if (blocked) return writeJson(res, 501, { error: blocked });
     const body = await readJsonBody(req);
+    // dsh 0.1.7+：从 profile patch 里的 preset-standard 声明整段复制出一个新预设
+    if (getAgentPresets()) {
+      const nId = String(body?.id ?? '').trim();
+      const nName = String(body?.name ?? '').trim() || nId;
+      if (!ID_RE.test(nId)) return writeJson(res, 400, { error: '预设 id 只能字母/数字开头，含 - _' });
+      // standard 是**宿主内置**预设（不在用户 patch 里）→ 用宿主的预设文档读它的组成
+      let r = await copyPresetViaDocument('standard', nId, nName);
+      if (!r.ok) {
+        // 兜底：万一 patch 里正好也有一份 preset-standard，就直接整段复制
+        const local = copyPresetDecl('standard', nId, nName);
+        if (local.ok) r = local;
+      }
+      if (!r.ok) return writeJson(res, 500, { error: r.error });
+      return writeJson(res, 200, { ok: true, newId: nId, backup: r.backup, note: '已从 standard 生成新预设并写入 profile patch，热生效' });
+    }
     const newId = String(body?.id ?? '').trim();
     const newName = String(body?.name ?? '').trim() || undefined;
     if (!ID_RE.test(newId)) return writeJson(res, 400, { error: '预设 id 只能字母/数字开头，含 - _（也是文件夹名）' });
@@ -824,8 +1078,343 @@ export function apply(ctx) {
 
   // ── 预设人格文件浏览/编辑(2026-09-07): "展开改写人格"。安全: 仅 PRESET_ROOT/{id} 内白名单文件;
   //    写权限仅限"复制出来带QQ工具标记"的副本(防误改内置/半成品); 大小上限 200KB。
+  //
+  // ── 2026-09-24 适配 dsh 0.1.7：预设改为 profile patch 里的声明行后，目录没了，
+  //    但「人设正文」仍在 patch 内（persona 插件 config.prefix 的块标量）。
+  //    这里为它提供"虚拟文件"读写：只动那一段块标量，其余内容一个字节都不碰。
   const PRESET_EDIT_EXT = /.(yml|yaml|json|mjs|js|md|txt)$/i;
   const PRESET_EDIT_MAX = 200 * 1024;
+
+  /** 定位 profile patch 里某个预设声明块 `- id: preset-<id>`。 */
+  function locatePresetBlock(lines, presetId) {
+    const esc = String(presetId).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const re = new RegExp('^\\s*-\\s*id:\\s*[\'"]?preset-' + esc + '[\'"]?\\s*$');
+    const head = lines.findIndex((l) => re.test(l));
+    if (head < 0) return null;
+    const headIndent = (lines[head].match(/^\s*/) || [''])[0].length;
+    let end = lines.length;
+    for (let i = head + 1; i < lines.length; i++) {
+      const ind = (lines[i].match(/^\s*/) || [''])[0].length;
+      if (/- /.test(lines[i]) && ind <= headIndent) { end = i; break; }
+    }
+    return { head, headIndent, end };
+  }
+
+  /**
+   * 读预设的人设正文（0.1.7 路径）。
+   * 结构: preset 块 → `- id: persona` → `prefix|text|prompt: |-` → 块标量正文
+   * @returns {{text:string, indent:number, bodyStart:number, bodyEnd:number}|null}
+   */
+  function readPresetPersona(presetId, linesOverride) {
+    try {
+      if (!existsSync(PATCH_FILE)) return null;
+      const lines = linesOverride || readFileSync(PATCH_FILE, 'utf8').split(/\r\n|\n/);
+      const blk = locatePresetBlock(lines, presetId);
+      if (!blk) return null;
+      let pi = -1;
+      for (let i = blk.head + 1; i < blk.end; i++) {
+        if (/^\s*-\s*id:\s*['"]?persona['"]?\s*$/.test(lines[i])) { pi = i; break; }
+      }
+      if (pi < 0) return null;
+      const personaIndent = (lines[pi].match(/^\s*/) || [''])[0].length;
+      let ki = -1;
+      let indent = 0;
+      let inline = false;
+      let inlineVal = '';
+      for (let i = pi + 1; i < blk.end; i++) {
+        const l = lines[i];
+        if (/^\s*#/.test(l)) continue;                                   // 注释行跳过
+        const mB = /^(\s*)(?:prefix|text|prompt):\s*\|-?\s*$/.exec(l);
+        if (mB) { ki = i; indent = mB[1].length; inline = false; break; }
+        const mI = /^(\s*)(?:prefix|text|prompt):\s+(\S.*)$/.exec(l);    // 行内标量写法
+        if (mI) { ki = i; indent = mI[1].length; inline = true; inlineVal = mI[2].trim(); break; }
+        const ind = (l.match(/^\s*/) || [''])[0].length;
+        if (/- /.test(l) && ind <= personaIndent) break;
+      }
+      if (ki < 0) return null;
+      if (inline) {
+        // 行内写法（如 `prefix: 你是一个 xx 助手`）→ 直接返回那一句
+        let v = inlineVal;
+        if ((v.startsWith("'") && v.endsWith("'")) || (v.startsWith('"') && v.endsWith('"'))) v = v.slice(1, -1);
+        return { text: v, indent: indent + 2, bodyStart: ki + 1, bodyEnd: ki + 1, inline: true, lineIndex: ki };
+      }
+      let bEnd = ki + 1;
+      while (bEnd < blk.end) {
+        const raw = lines[bEnd];
+        if (raw.trim() === '') { bEnd++; continue; }
+        if (((raw.match(/^\s*/) || [''])[0]).length <= indent) break;
+        bEnd++;
+      }
+      let last = bEnd;
+      while (last > ki + 1 && lines[last - 1].trim() === '') last--;
+      const body = lines.slice(ki + 1, last);
+      const cuts = body.filter((l) => l.trim()).map((l) => (l.match(/^\s*/) || [''])[0].length);
+      const cut = cuts.length ? Math.min(...cuts) : indent + 2;
+      // 纯空白行原样保留（既不切片也不补缩进），保证「读出 → 原样写回」字节级一致
+      const text = body.map((l) => (l.trim() === '' ? l : l.slice(cut))).join('\n');
+      return { text, indent: cut, bodyStart: ki + 1, bodyEnd: last };
+    } catch { return null; }
+  }
+
+  /**
+   * 复制一个预设声明（dsh 0.1.7 路径）：在 profile patch 里把 `- id: preset-<src>` 整段
+   * 复制一份，只改写三处后追加到顶层数组 —— `- id:` / `config.id` / `config.name`，其余一个字节不动。
+   * 行内换行按原文保真，缩进原样搬运。
+   */
+  function copyPresetDecl(srcId, newId, newName) {
+    try {
+      if (!existsSync(PATCH_FILE)) return { ok: false, error: 'profile patch 不存在' };
+      const raw = readFileSync(PATCH_FILE, 'utf8');
+      const parts = raw.split(/(\r\n|\n)/);
+      const lineTexts = [];
+      const eols = [];
+      for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 0) lineTexts.push(parts[i]);
+        else eols.push(parts[i]);
+      }
+      const blk = locatePresetBlock(lineTexts, srcId);
+      if (!blk) return { ok: false, error: '在 profile patch 里找不到源预设 preset-' + srcId };
+      const escRe = (s) => String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+      const headRe = new RegExp('id:\\s*[\'"]?preset-' + escRe(srcId) + '[\'"]?');
+      const seg = lineTexts.slice(blk.head, blk.end);
+      const out = [];
+      let cfgIndent = -1;
+      for (let i = 0; i < seg.length; i++) {
+        let l = seg[i];
+        const ind = (l.match(/^\s*/) || [''])[0].length;
+        if (i === 0) {
+          l = l.replace(headRe, 'id: preset-' + newId);
+        } else {
+          const mCfg = /^(\s*)config:\s*$/.exec(l);
+          if (mCfg) { cfgIndent = mCfg[1].length; }
+          else if (cfgIndent >= 0 && ind === cfgIndent + 2) {
+            if (/^\s*id:\s/.test(l)) l = l.replace(/id:\s*.*$/, 'id: ' + newId);
+            else if (/^\s*name:\s/.test(l)) l = l.replace(/name:\s*.*$/, 'name: ' + newName);
+          }
+        }
+        out.push(l);
+      }
+      const eol = eols[blk.end - 1] || eols[blk.head] || '\n';
+      let add = '';
+      for (const l of out) add += l + eol;
+      let text = raw;
+      if (!/[\r\n]$/.test(text)) text += eol;
+      text += add;
+      const bak = PATCH_FILE + '.bak-copy-' + Date.now();
+      try { writeFileSync(bak, raw, 'utf8'); } catch { /* 备份失败不阻塞 */ }
+      writeFileSync(PATCH_FILE, text, 'utf8');
+      return { ok: true, backup: bak, newId };
+    } catch (e) { return { ok: false, error: String((e && e.message) || e) }; }
+  }
+
+  /**
+   * 用宿主的 `agentPresets.readDocument(id)` 读来源预设的组成，生成一条新的 preset 声明写进 patch。
+   * 用途：**内置预设**（如 `standard`，它不在用户 patch 里）或任何 patch 中不存在的预设。
+   * readDocument 官方标注"仅用于查看"——我们只把它当模板读出来，写进**自己的** profile patch。
+   */
+  async function copyPresetViaDocument(srcId, newId, newName) {
+    const ap = getAgentPresets();
+    if (!ap || typeof ap.readDocument !== 'function') {
+      return { ok: false, error: '宿主未提供 agentPresets.readDocument（读不了内置预设的组成）' };
+    }
+    let doc;
+    try { doc = await ap.readDocument(srcId); }
+    catch (e) { return { ok: false, error: '读取源预设 ' + srcId + ' 失败：' + String((e && e.message) || e) }; }
+    const content = String((doc && doc.content) || '');
+    if (!content.trim()) return { ok: false, error: '源预设 ' + srcId + ' 的组成为空' };
+    const pad = '          ';
+    const head = [
+      '# ── 复制自 ' + srcId + '（组成由宿主的预设文档读出）──',
+      '- insert:',
+      '    - id: preset-' + newId,
+      "      name: '@deepseek-ai/dsh-agent-preset'",
+      '      config:',
+      '        id: ' + newId,
+      '        name: ' + newName,
+      '        plugins:',
+    ];
+    const bodyLines = content.split(/\r\n|\n/).map((l) => (l.trim() === '' ? '' : pad + l));
+    const raw = readFileSync(PATCH_FILE, 'utf8');
+    const parts = raw.split(/(\r\n|\n)/);
+    const eol = parts[1] ?? '\n';
+    let text = raw;
+    if (!/[\r\n]$/.test(text)) text += eol;
+    text += head.join(eol) + eol + bodyLines.join(eol) + eol;
+    const bak = PATCH_FILE + '.bak-newpreset-' + Date.now();
+    try { writeFileSync(bak, raw, 'utf8'); } catch { /* 备份失败不阻塞 */ }
+    writeFileSync(PATCH_FILE, text, 'utf8');
+    return { ok: true, backup: bak, newId, from: 'document' };
+  }
+
+  /** YAML 标量序列化。forceQuote=true 时强制加引号（保留原字段的字符串类型 —— 例如 appId
+   *  的 schema 是 string，裸写数字会被 YAML 解析成 number → 宿主 schema 校验失败）。 */
+  function yScalar(v, forceQuote) {
+    if (v === null || v === undefined) return "''";
+    if (typeof v === 'boolean') return String(v);
+    const s = String(v);
+    if (typeof v === 'number' && !forceQuote) return s;       // 真正的数字字段（historyLimit 等）保持数字
+    if (forceQuote) return "'" + s.replace(/'/g, "''") + "'";
+    if (typeof v === 'string') {
+      if (s === '' || /[:#'"\[\]{}&*!|>%@`,]/.test(s) || /^\s|\s$/.test(s) || /^(true|false|null|~|-?\d)/i.test(s)) {
+        return "'" + s.replace(/'/g, "''") + "'";
+      }
+    }
+    return s;
+  }
+  /** 把值序列化成"一行 YAML"（数组走流式，避免多行插入）。keepType 提示按原字段类型保真。 */
+  function yValue(v, keepQuoted, origWasArray) {
+    if (Array.isArray(v)) {
+      if (!v.length) return '[]';
+      return '[' + v.map((it) => yScalar(it, typeof it === 'string')).join(', ') + ']';
+    }
+    if (v === '' || v === null || v === undefined) {
+      // ⚠️ 空值必须看原字段类型：原本是数组的（owners）写成 `''` 会让宿主 schema 校验失败
+      return origWasArray ? '[]' : "''";
+    }
+    return yScalar(v, keepQuoted || typeof v === 'string');
+  }
+
+  /**
+   * 把一批字段合并进 profile patch 里某个 entry 的 `config`（dsh 0.1.7 路径，2026-09-24）。
+   *
+   * 为什么需要：0.1.7 的 `settings.update()` 只接受 **schema 里声明为 volatile** 的字段
+   * （源码：`const form = volatileForm(schema); if (!form) throw new Error('Plugin entry "x" has no volatile fields')`），
+   * 本插件用自定义 config、没有 schemastery schema → 保存必被拒。这里改为直接改 profile patch：
+   * **已存在的字段就地替换值**；patch 里没有的字段记入 `missing` 返回给前端（不擅自新增结构）。
+   * 支持一层嵌套对象。写前自动备份，换行逐行保真。
+   */
+  function mergeEntryConfigInPatch(entryId, patch) {
+    try {
+      if (!existsSync(PATCH_FILE)) return { ok: false, error: 'profile patch 不存在' };
+      if (!patch || typeof patch !== 'object') return { ok: false, error: 'patch 必须是对象' };
+      const raw = readFileSync(PATCH_FILE, 'utf8');
+      const parts = raw.split(/(\r\n|\n)/);
+      const lineTexts = [];
+      const eols = [];
+      for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 0) lineTexts.push(parts[i]);
+        else eols.push(parts[i]);
+      }
+      const esc = (s) => String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+      const headRe = new RegExp('^\\s*-\\s*id:\\s*[\'"]?' + esc(entryId) + '[\'"]?\\s*$');
+      const start = lineTexts.findIndex((l) => headRe.test(l));
+      if (start < 0) return { ok: false, error: '在 profile patch 里找不到 entry ' + entryId };
+      const headIndent = (lineTexts[start].match(/^\s*/) || [''])[0].length;
+      let end = lineTexts.length;
+      for (let i = start + 1; i < lineTexts.length; i++) {
+        const ind = (lineTexts[i].match(/^\s*/) || [''])[0].length;
+        if (/- /.test(lineTexts[i]) && ind <= headIndent) { end = i; break; }
+      }
+      let ci = -1;
+      for (let i = start + 1; i < end; i++) {
+        if (/^\s*config:\s*$/.test(lineTexts[i])) { ci = i; break; }
+      }
+      if (ci < 0) return { ok: false, error: 'entry ' + entryId + ' 在 profile patch 里没有 config: 段' };
+      const cfgIndent = (lineTexts[ci].match(/^\s*/) || [''])[0].length;
+      const keyIndent = cfgIndent + 2;
+      let cEnd = ci + 1;
+      for (let i = ci + 1; i < end; i++) {
+        if (lineTexts[i].trim() && ((lineTexts[i].match(/^\s*/) || [''])[0]).length <= cfgIndent) break;
+        cEnd = i + 1;
+      }
+      const missing = [];
+      const setKey = (key, value, from, to, indent) => {
+        // ⚠️ 脱敏占位符绝不写回（2026-09-24 实测事故）：设置页读到的是 viewOf 打码过的
+        //    `__REDACTED__`，若原样写入就会把真密钥覆盖掉。这个值一律视为"未修改"。
+        if (value === '__REDACTED__') return true;
+        const re = new RegExp('^\\s{' + indent + '}' + esc(key) + ':\\s*(.*)$');
+        for (let i = from; i < to; i++) {
+          if (!re.test(lineTexts[i])) continue;
+          if (value && typeof value === 'object' && !Array.isArray(value)) {
+            let subEnd = i + 1;
+            for (let j = i + 1; j < to; j++) {
+              if (lineTexts[j].trim() && ((lineTexts[j].match(/^\s*/) || [''])[0]).length <= indent) break;
+              subEnd = j + 1;
+            }
+            for (const [k, v] of Object.entries(value)) {
+              if (v === undefined) continue;
+              if (!setKey(k, v, i + 1, subEnd, indent + 2)) missing.push(key + '.' + k);
+            }
+            return true;
+          }
+          // 按**原字段类型**保真写入（引号风格 / 数组 / 空值），避免写坏宿主 schema：
+          // 实测踩坑：appId 裸写数字 → "expected string"；owners 空值写成 '' → "expected array"
+          const origRaw = String(lineTexts[i] || '');
+          const origVal = ((origRaw.match(/:\s*(.*)$/) || [])[1] || '').trim();
+          const origWasArray = origVal === '[]' || origVal.startsWith('- ');
+          const keepQuoted = /^['"]/.test(origVal);
+          lineTexts[i] = ' '.repeat(indent) + key + ': ' + yValue(value, keepQuoted, origWasArray);
+          return true;
+        }
+        return false;
+      };
+      for (const [k, v] of Object.entries(patch)) {
+        if (v === undefined) continue;
+        if (!setKey(k, v, ci + 1, cEnd, keyIndent)) missing.push(k);
+      }
+      let out = '';
+      for (let i = 0; i < lineTexts.length; i++) {
+        out += lineTexts[i];
+        if (i < eols.length) out += eols[i];
+      }
+      const bak = PATCH_FILE + '.bak-cfg-' + Date.now();
+      try { writeFileSync(bak, raw, 'utf8'); } catch { /* 备份失败不阻塞 */ }
+      writeFileSync(PATCH_FILE, out, 'utf8');
+      return { ok: true, backup: bak, missing };
+    } catch (e) { return { ok: false, error: String((e && e.message) || e) }; }
+  }
+
+  /** 写回人设正文（只替换那段块标量，写前自动备份整个 patch）。
+   *  ⚠️ 换行符**逐行保真**：patch 可能 LF/CRLF 混用（实测踩过），统一 eol 会改掉别处字节。 */
+  function writePresetPersona(presetId, text) {
+    try {
+      if (!existsSync(PATCH_FILE)) return { ok: false, error: 'profile patch 不存在' };
+      const raw = readFileSync(PATCH_FILE, 'utf8');
+      const parts = raw.split(/(\r\n|\n)/);
+      const lineTexts = [];
+      const eols = [];
+      for (let i = 0; i < parts.length; i++) {
+        if (i % 2 === 0) lineTexts.push(parts[i]);
+        else eols.push(parts[i]);
+      }
+      const found = readPresetPersona(presetId, lineTexts);
+      if (!found) return { ok: false, error: '没找到该预设的人设段落（persona / prefix）' };
+      let pad;
+      let insertAt;
+      let endAt;
+      if (found.inline) {
+        // 行内标量 → 升级成块标量（`prefix: |-` + 缩进正文），这样多行人设也存得下
+        const keyRaw = lineTexts[found.lineIndex];
+        const key = (/(prefix|text|prompt):/.exec(keyRaw) || [])[1] || 'prefix';
+        const keyIndent = (keyRaw.match(/^\s*/) || [''])[0];
+        lineTexts[found.lineIndex] = keyIndent + key + ': |-';
+        pad = keyIndent + '  ';
+        insertAt = found.lineIndex + 1;
+        endAt = found.lineIndex + 1;
+      } else {
+        pad = ' '.repeat(found.indent);
+        insertAt = found.bodyStart;
+        endAt = found.bodyEnd;
+      }
+      const nl = eols[insertAt - 1] || '\n';   // 沿用原段落的换行风格
+      const body = String(text).split(/\r\n|\n|\r/).map((l) => (l.trim() === '' ? l : pad + l));
+      const head = lineTexts.slice(0, insertAt);
+      const tail = lineTexts.slice(endAt);
+      let out = '';
+      for (let i = 0; i < head.length; i++) out += head[i] + (eols[i] ?? '\n');
+      for (const l of body) out += l + nl;
+      for (let i = 0; i < tail.length; i++) {
+        out += tail[i];
+        const ei = endAt + i;
+        if (ei < eols.length) out += eols[ei];
+      }
+      const bak = PATCH_FILE + '.bak-persona-' + Date.now();
+      try { writeFileSync(bak, raw, 'utf8'); } catch { /* 备份失败不阻塞 */ }
+      writeFileSync(PATCH_FILE, out, 'utf8');
+      return { ok: true, backup: bak };
+    } catch (e) { return { ok: false, error: String((e && e.message) || e) }; }
+  }
+
   function presetDirSafe(id) {
     if (!ID_RE.test(String(id || ''))) return null;
     const dir = resolve(PRESET_ROOT, id);
@@ -839,11 +1428,21 @@ export function apply(ctx) {
     return !!(p && p.hasChannelTools);
   }
   route(ctx, 'GET', '/api/qqbot-settings/presets/files', async (req, res) => {
-    // 新版(0.1.7+)没有预设目录了 → 给明确指引, 免得前端只看到"预设不存在"
-    const blockedFiles = presetWriteBlocked();
-    if (blockedFiles) return writeJson(res, 501, { error: blockedFiles });
     const q = new URL(req.url, 'http://x').searchParams;
-    const dir = presetDirSafe(q.get('id') || '');
+    const rid = String(q.get('id') || '').trim();
+    // dsh 0.1.7+：预设声明在 profile patch 里 → 对外虚拟成「人设正文」一个可编辑文件
+    if (getAgentPresets()) {
+      if (!ID_RE.test(rid)) return writeJson(res, 400, { error: '非法的预设 id' });
+      const persona = readPresetPersona(rid);
+      if (!persona) return writeJson(res, 404, { error: '该预设没有内联人设段落（persona / prefix）；人格可能在外部 .mjs 文件里' });
+      return writeJson(res, 200, {
+        id: rid,
+        dir: '(profile patch)',
+        writable: true,
+        files: [{ name: 'persona（人设正文）', size: Buffer.byteLength(persona.text, 'utf8'), mtime: 0 }],
+      });
+    }
+    const dir = presetDirSafe(rid);
     if (!dir) return writeJson(res, 404, { error: '预设不存在' });
     try {
       const files = readdirSync(dir, { withFileTypes: true })
@@ -854,8 +1453,31 @@ export function apply(ctx) {
     } catch (e) { writeJson(res, 500, { error: String(e?.message ?? e) }); }
   });
   route(ctx, ['GET', 'PUT'], '/api/qqbot-settings/presets/file', async (req, res) => {
-    const blockedFile = presetWriteBlocked();
-    if (blockedFile) return writeJson(res, 501, { error: blockedFile });
+    // dsh 0.1.7+：只支持「人设正文」这一个虚拟文件的读写（落在 profile patch 的 persona 块标量里）
+    if (getAgentPresets()) {
+      if (req.method === 'PUT') {
+        const body = await readJsonBody(req);
+        const id = String(body?.id ?? '').trim();
+        if (!ID_RE.test(id)) return writeJson(res, 400, { error: '非法的预设 id' });
+        const content = String(body?.content ?? '');
+        if (Buffer.byteLength(content, 'utf8') > PRESET_EDIT_MAX) return writeJson(res, 400, { error: '内容过大(上限 200KB)' });
+        const w = writePresetPersona(id, content);
+        if (!w.ok) return writeJson(res, 500, { error: w.error });
+        return writeJson(res, 200, {
+          ok: true,
+          name: 'persona（人设正文）',
+          size: Buffer.byteLength(content, 'utf8'),
+          backup: w.backup,
+          note: '已写入 profile patch，patchReload 热生效（新会话生效）',
+        });
+      }
+      const q = new URL(req.url, 'http://x').searchParams;
+      const id = String(q.get('id') || '').trim();
+      if (!ID_RE.test(id)) return writeJson(res, 400, { error: '非法的预设 id' });
+      const persona = readPresetPersona(id);
+      if (!persona) return writeJson(res, 404, { error: '该预设没有内联人设段落（persona / prefix）' });
+      return writeJson(res, 200, { id, name: 'persona（人设正文）', content: persona.text, writable: true });
+    }
     if (req.method === 'PUT') {
       const body = await readJsonBody(req);
       const id = String(body?.id ?? '');