@zaofan/dsh-qqbot 1.5.5 → 1.5.7

package/README.md

@@ -194,6 +194,46 @@ pwsh -File scripts/fix-dsh-016-presets.ps1 -Apply
 
 dsh 0.1.6 起默认模型为 `deepseek-official/deepseek-flash`（旧的 `deepseek-v4-flash` 已移出默认模型列表）。插件在「什么都没配」时的兜底也已同步为该值；你在设置里显式指定的 provider/model 优先级更高。
 
+### 升级 dsh 0.1.7 后，恢复会话报「预设缺失」/ 机器人不理人？
+
+dsh **0.1.7** 把 Agent 预设从「目录里的 yml 文件」换成了「**profile 配置里的声明行**」：
+由 `@deepseek-ai/dsh-agent-preset-registry` + 每个预设一行 `@deepseek-ai/dsh-agent-preset` 组成。
+官方明确：**注册表不扫描目录、不接受 preset 路径、没有任何接口接受 YAML 写回** —— 所以旧目录预设**必须迁移**，否则会话日志里记着的 preset ID 找不到定义，**恢复会话会被拒绝**。
+
+**一键迁移**（仓库里 `scripts/migrate-presets-017.ps1`）：
+
+```powershell
+# ① 先看看会迁移哪些预设（不写任何文件）
+pwsh -File scripts/migrate-presets-017.ps1
+
+# ② 生成「原 patch + 迁移片段」的合并版，核对一眼
+pwsh -File scripts/migrate-presets-017.ps1 -Merge -Out "$env:TEMP\cordis.patch.yml.0.1.7-ready"
+
+# ③ 升级 dsh 到 ≥0.1.7 之后启用（⚠️ 顺序不可反！0.1.6 读不了新声明会加载失败）
+cd ~/.dsh/profiles/web
+Copy-Item cordis.patch.yml cordis.patch.yml.bak-0.1.6
+Move-Item "$env:TEMP\cordis.patch.yml.0.1.7-ready" cordis.patch.yml -Force
+# 然后重启 dsh
+```
+
+> ⚠️ 两个坑（脚本已自动处理）：patch 顶层若是空数组 `[]` 要**先删掉**再粘；新增条目必须用 `- insert:`（写成 `- id:` 会报 `entry not found`）。
+> ⚠️ 0.1.7 会把**会话日志升级为 V4（不可回退）**、`settings.yaml` 也只导入一次 —— 升级前记得备份整个 `~/.dsh`。
+
+### 升级 dsh 0.1.7 后，某些插件被「禁用 / 跳过」？
+
+0.1.7 新增了**插件版本兼容检查**（比对各插件的 `peerDependencies`）。钉死在旧次版本的包会被跳过，或整行被禁用：
+
+```
+dsh: disabling profile plugin row "mcp-chrome": Plugin ... is incompatible with dsh 0.1.7-rc.1
+```
+
+常见两例：
+
+- `@deepseek-ai/dsh-mcp-client@0.0.1-rc.1` → 让所有 `mcp-*` 行失效。**注意官方这个包的 `latest` 标签还停在旧版，`next` 才是新版** → 要显式装 `@deepseek-ai/dsh-mcp-client@0.1.7-rc.1`
+- `@dhicoc/dsh-reverse-skill@1.0.5` → 跳过（作者尚未适配 0.1.7）
+
+想强行运行，可用官方提供的**确切版本例外**（`dsh plugin allow-version`，或插件管理页里授予），但官方警告"可能崩溃或数据丢失"，自行权衡。
+
 ## 支持这个项目
 
 如果这个插件帮你省了 token、或者让你家的鲸鱼更活蹦乱跳 —— **给个 ⭐ Star** 就是最实在的支持；有 bug / 想要的功能，欢迎开 [Issue](https://github.com/gcry13067381632-jpg/dsh-qqbot/issues)。

package/client/qqbot-settings.js

@@ -1392,9 +1392,11 @@ window.__ModuleLoader__.load({
         }).then(function (r) { return r.json() }).then(function (d) {
           setBusy('')
           if (d && d.error) { setMsg('复制失败: ' + d.error); return }
-          setMsg('✅ 新预设已生成: ' + d.newId + (copy.fromStandard ? ' (复制自标准模式, 已带 QQ 工具)' : '') + '。去「打开文件夹」改人设吧。')
+          setMsg('✅ 新预设已生成: ' + d.newId + (copy.fromStandard ? ' (复制自标准模式)' : '') + '。稍等片刻即可在列表看到；要改人设点「人格」。')
           setCopy(null); setCopyId(''); setCopyName('')
           load(true)
+          // dsh 0.1.7：预设写在 profile patch 里，由宿主 HMR 重载后才出现在列表中 → 稍后再拉一次
+          setTimeout(function () { load(true) }, 1200)
         }).catch(function (e) { setBusy(''); setMsg('复制异常: ' + e.message) })
       }
       function openPreset(id) {

package/dist/shared/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAoB,GAAG,MAAM,GAAG,IAAI,CAkB1E;AAyCD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtD"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"AAuCA;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAoB,GAAG,MAAM,GAAG,IAAI,CAkB1E;AA2CD;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAKtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAOtD"}

package/dist/shared/utils.js

@@ -76,7 +76,9 @@ export function getProfileDir(baseDir = PLUGIN_ROOT) {
 }
 /** 遍历 ~/.dsh/profiles/<name>，返回装着本插件的 profile 根目录（找不到返回 null） */
 function scanDshProfiles() {
-    const profilesRoot = join(os.homedir(), '.dsh', 'profiles');
+    // 与宿主保持一致: 优先环境变量 DSH_HOME, 否则回落 ~/.dsh
+    const dshHome = ((process.env.DSH_HOME ?? '').trim()) || join(os.homedir(), '.dsh');
+    const profilesRoot = join(dshHome, 'profiles');
     let entries;
     try {
         entries = readdirSync(profilesRoot);

package/dist/shared/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/shared/utils.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaofan/dsh-qqbot",
-  "version": "1.5.5",
+  "version": "1.5.7",
   "description": "QQ Bot IM channel plugin for deepseek-harness (dsh)",
   "type": "module",
   "main": "./dist/index.js",
@@ -75,6 +75,9 @@
     "client": {
       "platform": "web",
       "inject": []
+    },
+    "engines": {
+      "dsh": "0.1.5-rc.2 || 0.1.6-alpha.2 || 0.1.7-rc.1"
     }
   },
   "dependencies": {

package/settings-host.js

@@ -55,8 +55,12 @@ function resolveProfileRoot() {
 const PROFILE_ROOT = resolveProfileRoot();
 /** cordis.patch.yml = 宿主插件装配文件(账号实例声明处; 改它需重启 dsh 生效) */
 const PATCH_FILE = join(PROFILE_ROOT, 'cordis.patch.yml');
-/** agent 预设根目录(用户可写; 每预设一个子目录, 目录名=预设 id) */
-const PRESET_ROOT = join(homedir(), '.dsh', '.agent-presets');
+/** dsh 家目录(与宿主保持一致: 优先环境变量 DSH_HOME, 否则回落 ~/.dsh) */
+const DSH_HOME_DIR = ((process.env.DSH_HOME ?? '').trim()) || join(homedir(), '.dsh');
+/** agent 预设根目录 —— ⚠️ 仅 ≤0.1.6 的**旧机制**(每预设一个子目录, 目录名=预设 id)。
+ *  dsh 0.1.7 起预设改为「profile 配置里的声明行」(@deepseek-ai/dsh-agent-preset),
+ *  既没有目录、也没有写接口, 所以这里只作为旧版回落路径保留。 */
+const PRESET_ROOT = join(DSH_HOME_DIR, '.agent-presets');
 /** 复制预设时排除的备份/压缩类文件(不把主人的隐私压缩包带进新预设) */
 const COPY_SKIP = /\.(rar|zip|7z|bak|tmp|log|diag)$/i;
 /** 预设 id 校验: 文件夹命名规范(字母数字开头, 允许 - _) */
@@ -93,10 +97,70 @@ 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 = {};
+    for (let i = ci + 1; i < block.length; i++) {
+      const raw = block[i];
+      if (!raw.trim()) continue;
+      const ind = (raw.match(/^\s*/) || [''])[0].length;
+      if (ind <= cfgIndent) break;          // config 子树结束
+      if (ind > cfgIndent + 2) continue;    // 嵌套子块/数组项 → 跳过
+      const m = /^\s*([A-Za-z0-9_-]+):\s*(.*)$/.exec(raw);
+      if (!m) continue;
+      let v = m[2].trim();
+      if (v === '' || v.startsWith('!!js')) continue;   // 空值 / 表达式 → 跳过
+      v = v.replace(/^['"]|['"]$/g, '');
+      if (v === 'true') v = true;
+      else if (v === 'false') v = false;
+      else if (/^-?\d+$/.test(v)) v = Number(v);
+      out[m[1]] = v;
+    }
+    for (const k of Object.keys(out)) {
+      if (/secret|token|password|_key$/i.test(k)) out[k] = '__REDACTED__';
+    }
+    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 };
 }
 
 /** 请求里的目录参数(dataDir 显式传; 空=primary 主账号) */
@@ -137,7 +201,9 @@ export function apply(ctx) {
   // ── 桥装载诊断(2026-09-10 排查路由全 404): 落 ~/.dsh/qqbot-bridge-diag.log ──
   // 用途: 宿主重启后可确认 apply 是否真的被 cordis 调用(以及当时 ctx 上有哪些服务)。
   try {
-    const services = ['settings', 'webServer', 'agentPresets'].map((s) => s + '=' + (ctx && ctx[s] ? 'Y' : 'N')).join(' ');
+    // ⚠️ 未在 inject 声明的服务裸访问会抛 "without inject"（0.1.7 实测）→ 逐个 try 探测
+    const probe = (n) => { try { return (ctx && ctx[n]) ? 'Y' : 'N'; } catch { return 'NO-INJECT'; } };
+    const services = ['settings', 'webServer', 'agentPresets'].map((s) => s + '=' + probe(s)).join(' ');
     appendFileSync(
       join(homedir(), '.dsh', 'qqbot-bridge-diag.log'),
       `[${new Date().toISOString()}] bridge apply 被调用 inject=${JSON.stringify(inject)} ${services}\n`,
@@ -173,7 +239,10 @@ export function apply(ctx) {
     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);
+      // revision = -1 是"兜底视图"标记（宿主 describe 里没有本 ns，如 dsh 0.1.7）
+      // → 没有可信基线，跳过乐观锁，否则保存必报 SETTINGS_CONFLICT
+      const exp = typeof body.expectedRevision === 'number' && body.expectedRevision >= 0 ? body.expectedRevision : undefined;
+      await ctx.settings.update(ns, body.patch ?? {}, exp);
       writeJson(res, 200, viewOf(ctx.settings, ns));
     } catch (e) {
       const code = e?.code ?? '';
@@ -670,12 +739,105 @@ export function apply(ctx) {
     }
     return out.sort((a, b) => b.mtime - a.mtime);
   }
+  /**
+   * 列出可用预设（双模式，2026-09-23 适配 dsh 0.1.7）。
+   *  - dsh 0.1.7+：走宿主 `agentPresets.list()` —— 新版预设是 profile 配置里的
+   *    「声明行」(@deepseek-ai/dsh-agent-preset)，**已无目录**，扫目录只会得到空列表；
+   *  - dsh ≤0.1.6：回落 `scanPresets()` 扫 {DSH_HOME}/.agent-presets 目录（旧机制）。
+   *  统一返回 [{id, name, description, source}]，source=registry|dir。
+   */
+  /**
+   * 安全取宿主 agentPresets 服务（2026-09-23 实测修正）。
+   * ⚠️ cordis 对**未在 inject 里声明**的服务, 裸访问 `ctx.xxx` 会直接抛
+   *    "cannot get property \"agentPresets\" without inject"（0.1.7 上实测命中）。
+   *    而桥的 inject 只声明 settings/webServer（多声明会让宿主缺服务时整个 apply 不执行），
+   *    所以这里必须用 **ctx.get()**（不抛）探测，拿不到返回 null 走旧目录回落。
+   */
+  function getAgentPresets() {
+    try {
+      if (ctx && typeof ctx.get === 'function') {
+        const svc = ctx.get('agentPresets');
+        if (svc) return svc;
+      }
+    } catch { /* ignore */ }
+    try { return (ctx && ctx.agentPresets) || null; } catch { return null; }
+  }
+  async function listPresets() {
+    const ap = getAgentPresets();
+    if (ap && typeof ap.list === 'function') {
+      try {
+        const arr = await ap.list();
+        if (Array.isArray(arr) && arr.length) {
+          return arr
+            .map((p) => ({
+              id: String((p && p.id) || ''),
+              name: String((p && (p.name || p.id)) || ''),
+              description: String((p && p.description) || ''),
+              source: 'registry',
+            }))
+            .filter((p) => p.id);
+        }
+      } catch { /* registry 不可用 → 回落旧目录 */ }
+    }
+    return scanPresets().map((p) => ({
+      id: p.id,
+      name: p.name,
+      description: '',
+      source: 'dir',
+      mtime: p.mtime,
+      hasChannelTools: p.hasChannelTools,
+    }));
+  }
+  /**
+   * 写操作在新版下的统一提示（2026-09-23）。
+   * dsh 0.1.7+ 的注册表「不写入任何声明、没有任何接口接受 YAML 写回」，
+   * 新增/覆盖预设只能写 profile 的 bundle 补丁 —— 与其静默失败，不如给出明确指引。
+   * 返回 null 表示走旧版目录流程。
+   */
+  function presetWriteBlocked() {
+    const ap = getAgentPresets();
+    if (ap && typeof ap.list === 'function') {
+      return '当前 dsh 版本的预设是「profile 配置里的声明行」，不再是目录文件（官方注册表不接受任何写回）。'
+        + '请在 profile 的 cordis.patch.yml 里用 `- insert:` 添加/修改 `@deepseek-ai/dsh-agent-preset` 行'
+        + '（或用创造模式生成 bundle），保存后由 patchReload 热生效。';
+    }
+    return null;
+  }
   route(ctx, 'GET', '/api/qqbot-settings/presets', async (_req, res) => {
-    writeJson(res, 200, { root: PRESET_ROOT, presets: scanPresets() });
+    try {
+      const presets = await listPresets();
+      const viaRegistry = presets.some((p) => p.source === 'registry');
+      writeJson(res, 200, { root: viaRegistry ? null : PRESET_ROOT, presets, mode: viaRegistry ? 'registry' : 'dir' });
+    } catch (e) {
+      writeJson(res, 500, { error: String((e && e.message) || e) });
+    }
   });
   // 复制并双名: {sourceId, newId, newName}
   route(ctx, 'POST', '/api/qqbot-settings/presets/copy', async (req, res) => {
     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 必填' });
     }
@@ -704,11 +866,26 @@ export function apply(ctx) {
   // 复用宿主原生 agentPresets.copy(from,id,name) —— 复制出的正是宿主当前标准版, 保证能跑; 无需自己拼组合。
   route(ctx, 'POST', '/api/qqbot-settings/presets/new', async (req, res) => {
     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 只能字母/数字开头，含 - _（也是文件夹名）' });
     try {
-      const ap = (ctx).agentPresets;
+      const ap = getAgentPresets();
       if (!ap || typeof ap.copy !== 'function') {
         return writeJson(res, 500, { error: '宿主未提供 agentPresets 服务, 无法从标准模式新建' });
       }
@@ -725,6 +902,8 @@ export function apply(ctx) {
   });
   // 打开预设文件夹(本机弹资源管理器; 仅限 presetRoot 内白名单路径)
   route(ctx, 'POST', '/api/qqbot-settings/presets/open', async (req, res) => {
+    const blocked = presetWriteBlocked();
+    if (blocked) return writeJson(res, 501, { error: blocked });
     const body = await readJsonBody(req);
     const id = String(body?.id ?? '').trim();
     if (!ID_RE.test(id)) return writeJson(res, 400, { error: '非法的预设 id' });
@@ -742,8 +921,225 @@ 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' };
+  }
+
+  /** 写回人设正文（只替换那段块标量，写前自动备份整个 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);
@@ -758,7 +1154,20 @@ export function apply(ctx) {
   }
   route(ctx, 'GET', '/api/qqbot-settings/presets/files', async (req, res) => {
     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 })
@@ -769,6 +1178,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) => {
+    // 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 ?? '');