@xia-sc/dsh-cc-studio 0.3.4 → 0.3.6

package/lib/index.js

@@ -3,7 +3,7 @@
  * CCv3 工坊：校验 + 共享草稿（供 CC 模式的 LLM Tools 与浏览器胶囊同步）+ 已存角色侧边栏落盘。
  */
 import { mkdir, readdir, readFile, writeFile, unlink } from "node:fs/promises";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
@@ -98,11 +98,30 @@ function makeDefaultDraft(){
   };
 }
 if(!globalThis.__CC_DRAFTS__) globalThis.__CC_DRAFTS__ = new Map();
-// —— 草稿持久化（fix #2）：~/.dsh/cc-drafts/<session>.json，变更即落盘，重启后按会话 id 恢复 ——
-if(!globalThis.__CC_DRAFT_META__) globalThis.__CC_DRAFT_META__ = new Map();
-function draftDir(){
-  try{ return join(homedir(), ".dsh", "cc-drafts"); }catch{ return join(process.cwd(), ".cc-drafts"); }
+// —— 落盘根（0.3.6 起统一）：DSH_HOME 优先，homedir()/.dsh 兜底 ——
+// 预设目录一直走这里；草稿与角色库在 0.3.5 及以前写死 homedir()/.dsh，现在统一到同一套根，
+// 但**读盘必须回退旧根** —— 否则自定义了 DSH_HOME 的用户升级后会看到「草稿和角色卡全没了」。
+function legacyDshHomeDir(){
+  try{ return join(homedir(), ".dsh"); }catch{ return join(process.cwd(), ".dsh"); }
+}
+function dshHomeDir(){
+  const env = process.env.DSH_HOME;
+  if(typeof env === "string" && env.trim().length > 0) return env.trim();
+  return legacyDshHomeDir();
+}
+/**
+ * 某个子目录的候选根：`[主根, 旧根]`。写盘只写 candidates[0]，读盘依次回退。
+ * `DSH_HOME` 未设置时两个根是同一个目录 → 去重成一条，**默认安装的行为与 0.3.5 完全一致**。
+ */
+function dataRoots(sub){
+  const primary = join(dshHomeDir(), sub);
+  const legacy = join(legacyDshHomeDir(), sub);
+  return primary === legacy ? [primary] : [primary, legacy];
 }
+// —— 草稿持久化（fix #2）：<主根>/cc-drafts/<session>.json，变更即落盘，重启后按会话 id 恢复 ——
+if(!globalThis.__CC_DRAFT_META__) globalThis.__CC_DRAFT_META__ = new Map();
+function draftDirs(){ return dataRoots("cc-drafts"); }
+function draftDir(){ return draftDirs()[0]; }
 function safeDraftFile(key){
   const raw = String(key || "default");
   let h = 0;
@@ -112,9 +131,20 @@ function safeDraftFile(key){
   return safe + "-" + hex + ".json";
 }
 function draftPath(key){ return join(draftDir(), safeDraftFile(key)); }
+/** 读盘用：主根没有就回退旧根（0.3.6 之前草稿写死的地方）。找不到返回 null。 */
+function findDraftPath(key){
+  const file = safeDraftFile(key);
+  for(const dir of draftDirs()){
+    const p = join(dir, file);
+    try{ if(existsSync(p)) return p; }catch{}
+  }
+  return null;
+}
 function loadPersistedDraftSync(key){
   try{
-    const raw = readFileSync(draftPath(key), "utf8");
+    const p = findDraftPath(key);
+    if(!p) return null;
+    const raw = readFileSync(p, "utf8");
     const obj = JSON.parse(raw);
     const d = obj && obj.draft ? obj.draft : null;
     if(d && typeof d === "object" && d.spec === "chara_card_v3" && d.data && typeof d.data === "object") return d;
@@ -136,18 +166,94 @@ function draftStatusFor(key, draft){
   const m = draftMeta(key);
   return { isNew: !!m.isNew, recovered: !!m.recovered, creation_date: (draft && draft.data) ? draft.data.creation_date : null, key: String(key) };
 }
-function draftKeyFrom(ctx, args){
-  if(args && typeof args.sessionId==="string" && args.sessionId) return String(args.sessionId);
+/**
+ * 解析「这次调用读写哪把草稿槽」，并把来源一并带出来（诊断用）。
+ *
+ * 槽 key 的不变量：**同一会话里，Tools 与浏览器必须算出同一个 key**。
+ * Tools 侧（lib/agent.js 的 keyFor）拿的是 `exec.agent.session.id`；浏览器侧要么把会话 id
+ * 明确传过来，要么这里回退到 `agents.currentInitiator()` —— 但 RPC 是 HTTP 处理函数，
+ * 没有 agent 上下文，currentInitiator() 恒为空，于是旧逻辑回退到 "default"。
+ * 结果就是 issue #5：模型写 `session-<id>`、前端读 `default`，两槽并存、互相"看不见"。
+ * 所以这里做两件事：① 把前端可能误传的会话快照对象认出来；② 回传 source 让上层能把
+ * 「这次是回退到 default 了」这件事报给前端，而不是静默建一个空槽。
+ */
+function draftKeyPartsFrom(ctx, args){
+  const raw = args ? args.sessionId : null;
+  if(typeof raw === "string" && raw) return { key: raw, source: "arg" };
+  // 前端历史上可能把整个会话快照对象传进来（SessionSnapshot 的 id 在 .sessionId 上）。
+  // 旧逻辑 `typeof args.sessionId==="string"` 直接把它当「没传」丢弃 → 回退 default 槽；
+  // 若改成 String(object) 又会得到 "[object Object]" 这把假 key。两种都不对，认它的 .sessionId。
+  if(raw && typeof raw === "object" && typeof raw.sessionId === "string" && raw.sessionId)
+    return { key: raw.sessionId, source: "arg-snapshot" };
   try{
     const agents = ctx.get("agents");
     const ag = agents && agents.currentInitiator && agents.currentInitiator();
     if(ag){
-      if(ag.session && ag.session.id) return String(ag.session.id);
-      if(ag.id) return String(ag.id);
-      if(ag.sessionId) return String(ag.sessionId);
+      if(ag.session && ag.session.id) return { key: String(ag.session.id), source: "initiator" };
+      if(ag.id) return { key: String(ag.id), source: "initiator" };
+      if(ag.sessionId) return { key: String(ag.sessionId), source: "initiator" };
     }
   }catch{}
-  return "default";
+  return { key: "default", source: "fallback" };
+}
+function draftKeyFrom(ctx, args){ return draftKeyPartsFrom(ctx, args).key; }
+/**
+ * 草稿「有没有内容」的判定（不追求 validateCard 那么严：迁移是自家两个槽之间搬东西，
+ * name 为空但 lore 写满了的草稿也算有内容，不能因此拒绝迁移）。
+ */
+function draftContentSummary(draft){
+  const d = (draft && draft.data && typeof draft.data === "object") ? draft.data : {};
+  const entries = (d.character_book && Array.isArray(d.character_book.entries)) ? d.character_book.entries.length : 0;
+  let filled = 0;
+  ["name","description","personality","scenario","system_prompt","post_history_instructions","first_mes","mes_example","creator_notes"].forEach(function(k){
+    if(String(d[k]==null ? "" : d[k]).trim()) filled += 1;
+  });
+  if(Array.isArray(d.alternate_greetings) && d.alternate_greetings.length) filled += 1;
+  if(entries) filled += 1;
+  return { name: String(d.name==null ? "" : d.name), entries: entries, filled: filled };
+}
+/**
+ * 盘上还有哪些草稿槽（按写入时间倒序）。只用于「当前槽是空壳」时的救回提示 ——
+ * 这是 issue #5 里用户唯一能自救的入口：内容没丢，只是被写进了另一把 key。
+ * 两个根都扫：主根优先，同一把槽只报一次（主根那份解析失败时才让旧根补位）。
+ */
+function listDraftSlotsOnDisk(){
+  const out = [];
+  const seen = new Set();
+  for(const dir of draftDirs()){
+    let names = [];
+    try{ names = readdirSync(dir); }catch{ continue; }
+    for(const f of names){
+      if(!/\.json$/i.test(String(f))) continue;
+      if(seen.has(String(f))) continue;
+      let obj = null;
+      try{ obj = JSON.parse(readFileSync(join(dir, String(f)), "utf8")); }catch{ continue; }
+      const d = obj && obj.draft;
+      if(!d || typeof d !== "object" || d.spec !== "chara_card_v3" || !d.data || typeof d.data !== "object") continue;
+      const key = obj.key == null ? null : String(obj.key);
+      if(!key) continue;
+      seen.add(String(f));
+      const sum = draftContentSummary(d);
+      out.push({ key: key, updatedAt: Number(obj.updatedAt) || 0, name: sum.name, entries: sum.entries, hasContent: sum.filled > 0 });
+    }
+  }
+  out.sort(function(a,b){ return b.updatedAt - a.updatedAt; });
+  return out;
+}
+/**
+ * 草稿槽迁移的纯决策函数（便于单测，与 planPresetInstall 同一套路子）。
+ * @returns {ok:true, draft, summary} 或 {ok:false, code, message, details}
+ */
+function migrateDraftDecision(source, target, overwrite){
+  if(!source || typeof source!=="object" || source.spec!=="chara_card_v3" || !source.data || typeof source.data!=="object")
+    return { ok:false, code:"empty-source", message:"源槽没有草稿" };
+  const srcSum = draftContentSummary(source);
+  if(srcSum.filled === 0) return { ok:false, code:"empty-source", message:"源槽草稿是空壳，无需迁移" };
+  const tgtSum = target ? draftContentSummary(target) : null;
+  // 绝不静默覆盖：目标槽已有内容时必须显式 overwrite
+  if(!overwrite && tgtSum && tgtSum.filled > 0)
+    return { ok:false, code:"target-not-empty", message:"目标槽已有内容，需 overwrite: true", details:{ target: tgtSum } };
+  return { ok:true, draft: JSON.parse(JSON.stringify(source)), summary: srcSum };
 }
 function getDraftFor(key){
   const k = key || "default";
@@ -200,15 +306,24 @@ function isCcPreset(ctx, sessionId){
   return false;
 }
 
-// —— 已存角色侧边栏：落盘到 ~/.dsh/cc-library/<id>.json ——
-function libDir(){
-  try{ return join(homedir(), ".dsh", "cc-library"); }catch{ return join(process.cwd(), ".cc-library"); }
-}
+// —— 已存角色侧边栏：落盘到 <主根>/cc-library/<id>.json（读盘回退 0.3.6 之前的 homedir()/.dsh）——
+function libDirs(){ return dataRoots("cc-library"); }
+function libDir(){ return libDirs()[0]; }
 async function ensureLibDir(){
   const dir = libDir();
   await mkdir(dir, { recursive: true });
   return dir;
 }
+/** 读盘用：主根没有就回退旧根。返回 `{path, raw}`；两边都没有时抛最后一个错误（与原 readFile 语义一致）。 */
+async function readLibraryRaw(id){
+  let lastErr = null;
+  for(const dir of libDirs()){
+    const p = join(dir, String(id)+".json");
+    try{ return { path: p, raw: await readFile(p, "utf8") }; }
+    catch(e){ lastErr = e; }
+  }
+  throw lastErr || new Error("找不到角色卡: " + String(id));
+}
 // ========== PNG / CHARX 共享 ==========
 function normalizeDraft(d){
   if(!d || typeof d!=="object") throw new Error("draft 必须是对象");
@@ -421,26 +536,29 @@ function makeLibraryEntryMeta(draft, existingMeta, id){
   };
 }
 async function listLibraryEntries(){
-  const dir = await ensureLibDir();
-  let files=[];
-  try{ files = await readdir(dir); }catch{ return []; }
-  const entries=[];
-  for(const f of files){
-    if(!f.endsWith(".json")) continue;
-    const p = join(dir, f);
-    try{
-      const raw = await readFile(p, "utf8");
-      const obj = JSON.parse(raw);
-      if(obj && obj.meta && obj.id){
-        // 兼容：meta.id 与文件名 id 一致
-        entries.push(obj.meta);
-      } else if(obj && obj.draft){
-        // 旧格式兜底：从 draft 重建 meta
-        const id = f.replace(/\.json$/,"");
-        entries.push(makeLibraryEntryMeta(obj.draft, null, id));
-      }
-    }catch{}
+  await ensureLibDir();
+  const seen = new Map();   // id → meta：先到先得，主根排在前 → 同名卡片主根优先
+  for(const dir of libDirs()){
+    let files=[];
+    try{ files = await readdir(dir); }catch{ continue; }
+    for(const f of files){
+      if(!f.endsWith(".json")) continue;
+      const id = f.replace(/\.json$/,"");
+      if(seen.has(id)) continue;
+      try{
+        const raw = await readFile(join(dir, f), "utf8");
+        const obj = JSON.parse(raw);
+        if(obj && obj.meta && obj.id){
+          // 兼容：meta.id 与文件名 id 一致
+          seen.set(id, obj.meta);
+        } else if(obj && obj.draft){
+          // 旧格式兜底：从 draft 重建 meta
+          seen.set(id, makeLibraryEntryMeta(obj.draft, null, id));
+        }
+      }catch{}
+    }
   }
+  const entries = [...seen.values()];
   entries.sort((a,b)=> (b.updatedAt||0)-(a.updatedAt||0));
   return entries;
 }
@@ -449,10 +567,8 @@ async function saveLibraryEntry(draft, opts){
   let id = opts && opts.id ? String(opts.id) : "";
   let existing = null;
   if(id){
-    try{
-      const raw = await readFile(join(dir, id+".json"), "utf8");
-      existing = JSON.parse(raw);
-    }catch{}
+    // 已存在的那份可能在旧根（0.3.6 之前保存的），读过来只为继承 createdAt / 旧 name
+    try{ existing = JSON.parse((await readLibraryRaw(id)).raw); }catch{}
   }
   if(!id){
     id = String(Date.now())+"-"+Math.random().toString(36).slice(2,6);
@@ -467,29 +583,35 @@ async function saveLibraryEntry(draft, opts){
   return { id, meta, draft };
 }
 async function loadLibraryEntry(id){
-  const dir = await ensureLibDir();
-  const p = join(dir, String(id)+".json");
-  const raw = await readFile(p, "utf8");
-  const obj = JSON.parse(raw);
+  await ensureLibDir();
+  const obj = JSON.parse((await readLibraryRaw(id)).raw);
   if(!obj || !obj.draft) throw new Error("文件格式错误");
   return obj;
 }
+/**
+ * 删除：**两个根里的同名副本都要删**，否则读盘回退会把刚删掉的卡「复活」。
+ * 一个都没删到时仍然抛错（保持「删不存在的 id 是失败」的既有语义）。
+ */
 async function deleteLibraryEntry(id){
-  const dir = await ensureLibDir();
-  const p = join(dir, String(id)+".json");
-  await unlink(p);
+  await ensureLibDir();
+  let removed = 0;
+  for(const dir of libDirs()){
+    try{ await unlink(join(dir, String(id)+".json")); removed += 1; }
+    catch(e){ if(e && e.code !== "ENOENT") throw e; }
+  }
+  if(removed === 0) throw Object.assign(new Error("找不到角色卡: " + String(id)), { code: "ENOENT" });
 }
+/** 改名是**就地改** meta.name：写在解析到的那一份上（主根优先），不搬家、不复制。 */
 async function renameLibraryEntry(id, newName){
-  const dir = await ensureLibDir();
-  const p = join(dir, String(id)+".json");
-  const raw = await readFile(p, "utf8");
-  const obj = JSON.parse(raw);
+  await ensureLibDir();
+  const found = await readLibraryRaw(id);
+  const obj = JSON.parse(found.raw);
   if(!obj || !obj.meta) throw new Error("文件格式错误");
   const name = String(newName||"").trim().slice(0,60);
   if(!name) throw new Error("name 不能为空");
   obj.meta.name = name;
   obj.meta.updatedAt = nowSec();
-  await writeFile(p, JSON.stringify(obj, null, 2), "utf8");
+  await writeFile(found.path, JSON.stringify(obj, null, 2), "utf8");
   return obj.meta;
 }
 
@@ -552,11 +674,18 @@ function sendEnvelope(res, status, payload){
 function rpcFull(rpcId, result){ return { type:"server-response", rpcId, result }; }
 function rpcError(rpcId, code, message, details){ return rpcFull(rpcId, { ok:false, error:{ code, message, details } }); }
 
-// ========== CC 预设自动安装 ==========
-// 背景：预设此前必须手工拷到 <DSH_HOME>/.agent-presets/cc。但 dsh 的预设发现只扫三个根
+// ========== CC 预设安装 ==========
+// dsh >= 0.1.7-alpha.1：预设机制换代了。预设不再是「<DSH_HOME>/.agent-presets/<id>/ 目录」，
+// 而是**组合里的一个声明行**（内置 standard/ptc/minimal/cordis 就是这么发的），目录形态在 0.1.7
+// 已经没有任何代码读取 —— 这就是「升级到 0.1.7-alpha.1 后 CC 模式从 roster 里消失」的原因：
+// 文件还在，只是没人再看它。本插件因此把声明写进随包的补丁层 presets/cc.patch.yml
+// （package.json 的 dsh.bundle.patch 第二层）：插件装进哪个 profile，CC 模式就出现在哪个
+// profile 的 roster 里，不再依赖「挂载时往用户目录写文件」。
+//
+// 下面这套目录安装**只为更老的 dsh（<= 0.1.6-alpha.2）保留**：那条路径上预设发现只扫三个根
 // ——shipped 根（dsh-agent-presets 包内）+ 部署 config.roots + 用户根 <DSH_HOME>/.agent-presets
 // （见 dsh-agent-presets lib/index.js:1300-1310）；插件包内的 presets/ 不在其中，
-// 「随包分发」≠「已注册」。所以这里在插件挂载时把模板装进用户根，让「装完插件即有 CC 模式」成立。
+// 「随包分发」≠「已注册」，所以必须挂载时把模板装进用户根，「装完插件即有 CC 模式」才成立。
 //
 // 安全策略（绝不静默覆盖用户改动）：
 //   · 目标文件不存在                    → 写入模板
@@ -565,15 +694,31 @@ function rpcError(rpcId, code, message, details){ return rpcFull(rpcId, { ok:fal
 //   · 其余（用户改过 / 无记录的历史手工拷贝）→ 跳过并告警，交由用户决定
 // 安装记录是目标目录里的 JSON 侧车文件，含每个受管文件写入时的 sha256，
 // 因此不依赖版本号比较也能正确判定「这是不是我们写的、用户有没有动过」。
-// config.presetInstall: "auto"（默认）| "off" | "force"（连用户改动一起覆盖）
+// config.presetInstall: "auto"（默认）| "off" | "force"（连用户改动一起覆盖）。
+// 新版 dsh 上这份目录安装自动让位（status: "native"），开关也无意义 —— 想关 CC 模式就在
+// profile 补丁里按 id 关掉 preset-cc 那一行（presets/cc.patch.yml 顶部有现成的写法）。
 const PRESET_ID = "cc";
 const PRESET_MANAGED_FILES = ["preset.yml", "agent.cordis.yml"];
 const PRESET_MARKER_FILE = ".dsh-cc-studio-preset.json";
-function dshHomeDir(){
-  const env = process.env.DSH_HOME;
-  if(typeof env === "string" && env.trim().length > 0) return env.trim();
-  try{ return join(homedir(), ".dsh"); }catch{ return join(process.cwd(), ".dsh"); }
+/**
+ * 当前 dsh 是否已经用「声明行」发预设（>= 0.1.7-alpha.1）。
+ * 只用来决定「要不要往那份已经没人读的目录里写字」，判错的代价并不对称：
+ *   · 误判 false（在老版上）→ 照旧写一次目录，无害；
+ *   · 误判 true（在真需要目录的老版上）→ 才是真的少一个预设。
+ * 所以要求两个方法**同时**存在，且**不许简化成其中任何一个**：
+ * 0.1.6 的 `dsh-agent-presets` 也有 `compositionInventory`（`async compositionInventory()`），
+ * 单看它会把老版误判成新版；`register(definition)` 才是 0.1.7 新注册表独有的（老服务里
+ * `register` 只出现在 `settings.register` / `sessionProjections.register` 上）。
+ */
+function supportsDeclaredPresets(ctx){
+  try{
+    const presets = ctx && typeof ctx.get === "function" ? ctx.get("agentPresets") : null;
+    return !!(presets && typeof presets.register === "function" && typeof presets.compositionInventory === "function");
+  }catch{ return false; }
 }
+
+// `dshHomeDir()` / `legacyDshHomeDir()` / `dataRoots()` 定义在文件顶部（草稿那一节之前）——
+// 这里**不再重复定义**：两个同名 function 声明会「后者悄悄赢」，是漂移的温床。
 function presetSourceRoot(){
   try{ return fileURLToPath(new URL("../presets/"+PRESET_ID+"/", import.meta.url)); }catch{ return null; }
 }
@@ -605,7 +750,8 @@ function planPresetInstall(targets, templates, marker, force){
   return { write, skip, ok };
 }
 /**
- * 把 presets/cc 安装到 <DSH_HOME>/.agent-presets/cc。同步执行（只有两个小文件），幂等。
+ * 把 presets/cc 安装到 <DSH_HOME>/.agent-presets/cc（**只对 < 0.1.7-alpha.1 有意义**）。
+ * 同步执行（只有两个小文件），幂等。
  * 注意：卸载插件**不会**删除已安装的预设（与 README 的既有说明一致），因此这里不注册删除型 disposer。
  */
 function installCcPreset(ctx, config){
@@ -622,6 +768,18 @@ function installCcPreset(ctx, config){
     if(l && typeof l[level] === "function") l[level]("[dsh-cc-studio] " + msg);
     else if(level === "warn") console.warn("[dsh-cc-studio] " + msg);
   }catch{} };
+  // dsh >= 0.1.7-alpha.1：预设已随包声明（presets/cc.patch.yml），目录形态被彻底忽略。
+  // 这里一个字都不写 —— 否则只会留下一个没人读的目录，下次有人「修预设」时还要多查一层。
+  if(supportsDeclaredPresets(ctx)){
+    out.status = "native";
+    out.reason = "dsh >= 0.1.7-alpha.1：CC 预设由随包补丁层 presets/cc.patch.yml 声明，目录形态已不再被读取，跳过安装";
+    log("info", out.reason);
+    try{
+      const dst = presetTargetRoot();
+      if(existsSync(dst)) log("info", "检测到旧版安装目录 " + dst + "（0.1.6 及更早的形态）：0.1.7 起不再被读取，可以安全删除。");
+    }catch{}
+    return out;
+  }
   try{
     const src = presetSourceRoot();
     const templates = {};
@@ -700,12 +858,43 @@ function apply(ctx, config){
           return ok({ ok:true, time: Date.now() });
         }
         case "cc_isCcMode":{
-          return ok({ isCc: isCcPreset(ctx, args.sessionId) });
+          const parts = draftKeyPartsFrom(ctx, args);
+          return ok({ isCc: isCcPreset(ctx, (parts.source==="arg"||parts.source==="arg-snapshot") ? parts.key : null) });
         }
         case "cc_getDraft":{
-          const k = draftKeyFrom(ctx, args);
+          const parts = draftKeyPartsFrom(ctx, args);
+          const k = parts.key;
           const d = getDraftFor(k);
-          return ok({ draft: d, key: k, isCc: isCcPreset(ctx, args.sessionId), draftStatus: draftStatusFor(k, d) });
+          const status = draftStatusFor(k, d);
+          const payload = { draft: d, key: k, keySource: parts.source, isCc: isCcPreset(ctx, (parts.source==="arg"||parts.source==="arg-snapshot") ? k : null), draftStatus: status };
+          // 只在「当前槽是个新空壳」时才去盘上翻别的槽（issue #5 的救回入口）。
+          // 而且只翻**这次错位真正会牵涉到的另一把槽**，不是把所有会话的槽都端出来：
+          //   · 当前是会话槽（session-<id>）→ 候选只有 default —— 旧前端在没有会话 id 时
+          //     一律读写 default，用户在工坊里的编辑很可能就落在那里；
+          //   · 当前是 default → 候选是各个 session-* 槽 —— 模型经 Tools 写的是会话槽。
+          // 其余情况（比如别的会话的槽）与本会话无关，端出来只会变成噪音。
+          if(status.isNew || k === "default"){
+            try{
+              const all = listDraftSlotsOnDisk().filter(s=> s.key!==k && s.hasContent);
+              const alts = (k === "default") ? all.filter(s=> s.key !== "default") : all.filter(s=> s.key === "default");
+              if(alts.length) payload.alternateSlots = alts.slice(0, 3);
+            }catch{}
+          }
+          return ok(payload);
+        }
+        case "cc_migrateDraft":{
+          // 把别的草稿槽搬进本会话槽：args: { from, to?, overwrite? }
+          // to 缺省 = 当前会话（走同一套 key 解析，前端不必自己拼 key）。
+          const from = (typeof args.from==="string" && args.from) ? args.from : "default";
+          const toParts = draftKeyPartsFrom(ctx, { sessionId: (typeof args.to==="string" && args.to) ? args.to : (args.sessionId||null) });
+          const to = toParts.key;
+          if(from === to) return fail("same-slot", "源槽与目标槽相同（" + from + "），无需迁移");
+          const src = loadPersistedDraftSync(from) || (globalThis.__CC_DRAFTS__.has(from) ? globalThis.__CC_DRAFTS__.get(from) : null);
+          const tgt = loadPersistedDraftSync(to) || (globalThis.__CC_DRAFTS__.has(to) ? globalThis.__CC_DRAFTS__.get(to) : null);
+          const decision = migrateDraftDecision(src, tgt, args.overwrite===true);
+          if(!decision.ok) return fail(decision.code, decision.message, decision.details||{});
+          setDraftFor(to, decision.draft);
+          return ok({ draft: decision.draft, key: to, from: from, moved: decision.summary, draftStatus: draftStatusFor(to, decision.draft) });
         }
         case "cc_setDraft":{
           const k = draftKeyFrom(ctx, args);
@@ -939,6 +1128,11 @@ function apply(ctx, config){
   }), "dsh-cc-studio: POST "+RPC_CHANNEL+"/*");
 }
 
-export { apply, inject, name, planPresetInstall, installCcPreset, presetTargetRoot, presetSourceRoot };
+export { apply, inject, name, planPresetInstall, installCcPreset, supportsDeclaredPresets, presetTargetRoot, presetSourceRoot,
+  draftKeyPartsFrom, draftContentSummary, listDraftSlotsOnDisk, migrateDraftDecision,
+  // 落盘根与 lib 层 CRUD（供回归测试直接断言「DSH_HOME 优先 + 读时回退」）
+  dshHomeDir, legacyDshHomeDir, dataRoots, draftDirs, draftDir, draftPath, findDraftPath, safeDraftFile,
+  persistDraftSync, loadPersistedDraftSync, libDirs, libDir,
+  listLibraryEntries, saveLibraryEntry, loadLibraryEntry, deleteLibraryEntry, renameLibraryEntry };
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xia-sc/dsh-cc-studio",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "CCv3 角色卡工坊：融合工坊 + CC 模式 + JSON/PNG/CHARX + 中英双语（跟随全局）",
   "keywords": [
     "dsh",
@@ -35,12 +35,15 @@
     "presets"
   ],
   "scripts": {
-    "test": "node tests/rpc-channel.test.mjs && node tests/preset-install.test.mjs && node tests/cc-detection.test.mjs && node tests/client-greetings.test.mjs",
+    "test": "node tests/rpc-channel.test.mjs && node tests/preset-install.test.mjs && node tests/cc-detection.test.mjs && node tests/client-greetings.test.mjs && node tests/draft-slot-sync.test.mjs && node tests/data-root.test.mjs",
     "prepublishOnly": "npm test"
   },
   "dsh": {
     "bundle": {
-      "patch": "./cordis.patch.yml"
+      "patch": [
+        "./cordis.patch.yml",
+        "./presets/cc.patch.yml"
+      ]
     },
     "client": {
       "platform": "web",