@xia-sc/dsh-cc-studio 0.4.1 → 0.7.1

package/lib/client.js

@@ -216,6 +216,7 @@ window.__ModuleLoader__.load({
       "workshop.greeting.groupHint":"建议 ≥1 条",
       "workshop.field.nickname":"nickname（{{char}} 用）",
       "workshop.field.tags":"tags（逗号分隔）",
+      "workshop.field.creator":"作者（creator）",
       "workshop.field.mesExample":"mes_example（{{user}}/{{char}}）",
       "workshop.edit.title":"{title} · 大框编辑",
       "workshop.edit.fallbackTitle":"编辑",
@@ -428,6 +429,7 @@ window.__ModuleLoader__.load({
       "workshop.greeting.groupHint":"≥1 recommended",
       "workshop.field.nickname":"nickname (used by {{char}})",
       "workshop.field.tags":"tags (comma separated)",
+      "workshop.field.creator":"creator / author",
       "workshop.field.mesExample":"mes_example ({{user}}/{{char}})",
       "workshop.edit.title":"{title} · Large editor",
       "workshop.edit.fallbackTitle":"Edit",
@@ -838,7 +840,11 @@ window.__ModuleLoader__.load({
         }catch(e){ set({lastMsg: String(e && e.message || e)}); }
         set({libraryBusy:null});
       }
-      function clearCurrentLibraryId(){ set({currentLibraryId:null, lastMsg:t("store.switchedNew")}); }
+      function clearCurrentLibraryId(){
+        set({currentLibraryId:null, lastMsg:t("store.switchedNew")});
+        // 同步清掉宿主侧的来源 id（sidecar）：否则下次保存又会按旧来源「更新」那一张
+        try{ rpc("cc_setOrigin", { sessionId: state.currentSessionId||null, id: null }); }catch(e){}
+      }
       // 清空当前角色卡：整份草稿换回空卡（makeDraft），并解除「跟已存角色的关联」——
       // 否则清空后点「保存当前」会把库里那张卡覆盖成空卡（要删卡请用右侧列表的删除）。
       // 落盘与其它写入走同一条路（pushDraftToHost）：刷新页面、模型侧读到的都是空卡。
@@ -852,6 +858,8 @@ window.__ModuleLoader__.load({
           currentLibraryId:null,
           lastMsg: t("store.cleared")
         });
+        // 清空 = 与已存卡脱钩：宿主侧的来源 id（sidecar）也要清，否则下次保存会「更新」原来那张卡（把它覆盖成空卡）
+        try{ rpc("cc_setOrigin", { sessionId: state.currentSessionId||null, id: null }); }catch(e){}
         setTimeout(pushDraftToHost, 80);
       }
       async function loadFromLibrary(id){
@@ -1295,6 +1303,9 @@ window.__ModuleLoader__.load({
               field(t("workshop.field.nickname"),"nickname",{rowKey:"nickname", input:true})
             ),
             field(t("workshop.field.tags"),"tags",{rowKey:"tags", input:true, bigBox:false, value:s.draft.data.tags.join(", "), onChange:function(v){ store.updateDraft(function(d){ d.tags=v.split(",").map(function(x){return x.trim();}).filter(Boolean); }); }}),
+            // N1（0.7.0）：data.creator 此前**没有任何写入路径**（工具侧与工坊都改不了），
+            // 而 cc_validate 每次都警告它为空。这里补上人工入口，工具侧对应 cc_patch_character 的 creator。
+            field(t("workshop.field.creator"),"creator",{rowKey:"creator", input:true, bigBox:false}),
             field("description","description",{rowKey:"desc"}),
             field("personality","personality",{rowKey:"pers"}),
             field("scenario","scenario",{rowKey:"scen"}),
@@ -1439,6 +1450,10 @@ window.__ModuleLoader__.load({
             filteredLibrary.map(function(entry){
               var isBusy = s.libraryBusy && String(s.libraryBusy).indexOf(entry.id)>=0;
               var isCurrent = s.currentLibraryId===entry.id;
+              // 列表展示前 4 个标签，但「还有几个没显示」必须用 meta.tagsTotal 算：meta.tags 本身截断到 6 个，
+              // 拿它的长度当总数会偏小（卡里 7 个、列表只显示 6 个，用户会以为标签没存上 —— LLM 侧回测报的 P1-11）
+              var tagTotal = (typeof entry.tagsTotal==="number") ? entry.tagsTotal : (entry.tags||[]).length;
+              var tagShown = Math.min((entry.tags||[]).length, 4);
               var itemStyle = isCurrent ? Object.assign({}, S.libraryItem, {borderColor:"#7c5cff", background:"color-mix(in srgb, #7c5cff 8%, var(--dsw-alias-bg-layer-2))"}) : S.libraryItem;
               return h("div",{key:entry.id, style:itemStyle},
                 h("div",{style:{display:"flex", alignItems:"center", justifyContent:"space-between", gap:6}},
@@ -1449,7 +1464,7 @@ window.__ModuleLoader__.load({
                 h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", marginTop:2, whiteSpace:"nowrap", overflow:"hidden", textOverflow:"ellipsis"}}, entry.descriptionSnippet || entry.tags.join(" · ") || "—"),
                 h("div",{style:{display:"flex", flexWrap:"wrap", gap:4, marginTop:6}},
                   (entry.tags||[]).slice(0,4).map(function(t){ return h("span",{key:t, style:Object.assign({}, S.badge, {fontSize:10, padding:"1px 5px"})}, t); }),
-                  entry.tags && entry.tags.length>4 ? h("span",{style:{fontSize:10, color:"var(--dsw-alias-label-secondary)"}}, "+"+(entry.tags.length-4)) : null
+                  tagTotal > tagShown ? h("span",{style:{fontSize:10, color:"var(--dsw-alias-label-secondary)"}}, "+"+(tagTotal-tagShown)) : null
                 ),
                 h("div",{style:{fontSize:10, color:"var(--dsw-alias-label-secondary)", marginTop:4}}, new Date(entry.updatedAt*1000).toLocaleString()),
                 h("div",{style:{display:"flex", gap:6, marginTop:8}},
@@ -1702,6 +1717,11 @@ window.__ModuleLoader__.load({
               try{ if(localStorage.getItem("dsh-cc-studio-legacy-notice")==="1") alts = null; }catch(e){}
             }
             store.setAlternateSlots(alts);
+            // 载入来源 id（0.5.0）：宿主把「这份草稿是从哪张已存卡载入的」落在盘上（sidecar），
+            // 刷新页面后据此恢复「已载入 ID」—— 否则内存里的 currentLibraryId 一丢，
+            // 再点保存就会新建一张同名重复卡（LLM 侧回环测试抓到的 P0-4）。
+            var originId = (typeof res.value.originId==="string" && res.value.originId) ? res.value.originId : null;
+            if(originId !== store.getSnapshot().currentLibraryId) set({ currentLibraryId: originId });
             var draft=res.value.draft;
             var draftStatus=res.value.draftStatus||null;
             try{

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, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync } from "node:fs";
 import { createHash } from "node:crypto";
 import { fileURLToPath } from "node:url";
 import { join } from "node:path";
@@ -97,6 +97,38 @@ function makeDefaultDraft(){
     }
   };
 }
+/**
+ * 草稿形状规范化（0.7.1，B1，与 lib/agent.js 同构）。
+ *
+ * DSH 对工具/远端返回值做 lossless-JSON 校验：**任何嵌套 `undefined` 都会让整次调用报错**。
+ * 外部导入的卡（PNG / CHARX）或早期版本写下的草稿可能缺 `spec_version` / `creation_date` 这类字段，
+ * 前端直接读它就会渲染出 `undefined`、导出的卡也缺字段。所以读盘恢复时按空卡模板补齐缺失键：
+ * 只补 `undefined`，不覆盖已有值、不改类型（类型问题交给校验报）。
+ */
+function normalizeCardShape(draft){
+  const tpl = makeDefaultDraft();
+  if(!draft || typeof draft !== "object") return tpl;
+  const out = {
+    spec: (draft.spec !== undefined && draft.spec !== null) ? draft.spec : tpl.spec,
+    spec_version: (draft.spec_version !== undefined && draft.spec_version !== null) ? draft.spec_version : tpl.spec_version,
+    data: {},
+  };
+  const src = (draft.data && typeof draft.data === "object") ? draft.data : {};
+  for(const k of Object.keys(tpl.data)){
+    out.data[k] = (src[k] !== undefined) ? src[k] : tpl.data[k];
+  }
+  for(const k of Object.keys(src)){ if(!(k in out.data)) out.data[k] = src[k]; }
+  const book = (out.data.character_book && typeof out.data.character_book === "object") ? out.data.character_book : {};
+  const bTpl = tpl.data.character_book;
+  const nb = {};
+  for(const k of Object.keys(bTpl)){ nb[k] = (book[k] !== undefined) ? book[k] : bTpl[k]; }
+  for(const k of Object.keys(book)){ if(!(k in nb)) nb[k] = book[k]; }
+  if(!Array.isArray(nb.entries)) nb.entries = [];
+  if(!nb.extensions || typeof nb.extensions !== "object") nb.extensions = {};
+  out.data.character_book = nb;
+  if(!out.data.extensions || typeof out.data.extensions !== "object") out.data.extensions = {};
+  return out;
+}
 if(!globalThis.__CC_DRAFTS__) globalThis.__CC_DRAFTS__ = new Map();
 // —— 落盘根（0.3.6 起统一）：DSH_HOME 优先，homedir()/.dsh 兜底 ——
 // 预设目录一直走这里；草稿与角色库在 0.3.5 及以前写死 homedir()/.dsh，现在统一到同一套根，
@@ -132,6 +164,27 @@ function safeDraftFile(key){
 }
 function draftPath(key){ return join(draftDir(), safeDraftFile(key)); }
 /** 读盘用：主根没有就回退旧根（0.3.6 之前草稿写死的地方）。找不到返回 null。 */
+// —— 草稿的「来源 id」sidecar（0.5.0，与 lib/agent.js 同构）——
+// 记「这份草稿是从哪张已存卡载入的」，让「载入 → 改 → 保存」更新原卡而不是新建一张同名重复卡。
+// 浏览器侧刷新页面会丢掉内存里的 currentLibraryId，所以这份关联必须落盘；存 sidecar 而不是塞进
+// draft.extensions，是因为后者会跟着导出进用户的卡里。
+function originFilePath(key){ return join(draftDir(), safeDraftFile(key).replace(/\.json$/, ".origin.json")); }
+function readDraftOrigin(key){
+  try{
+    const p = originFilePath(key);
+    if(!existsSync(p)) return null;
+    const obj = JSON.parse(readFileSync(p, "utf8"));
+    if(obj && typeof obj.libraryId === "string" && obj.libraryId) return obj;
+  }catch{}
+  return null;
+}
+function writeDraftOrigin(key, libraryId, name){
+  try{
+    if(!libraryId){ try{ unlinkSync(originFilePath(key)); }catch{} return; }
+    mkdirSync(draftDir(), { recursive: true });
+    writeFileSync(originFilePath(key), JSON.stringify({ key: String(key), libraryId: String(libraryId), name: String(name||""), savedAt: nowSec() }, null, 2), "utf8");
+  }catch(e){ try{ console.error("[dsh-cc-studio] persist draft origin failed:", (e && e.message) || e); }catch{} }
+}
 function findDraftPath(key){
   const file = safeDraftFile(key);
   for(const dir of draftDirs()){
@@ -154,17 +207,36 @@ function loadPersistedDraftSync(key){
 function persistDraftSync(key, draft){
   try{
     mkdirSync(draftDir(), { recursive: true });
-    writeFileSync(draftPath(key), JSON.stringify({ key: String(key), updatedAt: nowSec(), draft }, null, 2), "utf8");
-  }catch(e){ try{ console.error("[dsh-cc-studio] persist draft failed:", (e && e.message) || e); }catch{} }
+    // revision（0.6.0，P0-6）：与 lib/agent.js 同构 —— 工具半与宿主半各写各的文件、各持各的内存，
+    // **只有草稿文件里的 rev 是共同真相**。工坊这边每写一次盘就 +1，工具侧下次调用读到新 rev 就知道
+    // 「草稿被外部换过了」，从而重载而不是拿过期前提去写（否则会静默覆盖用户在工坊里的修改）。
+    let rev = 1;
+    try{
+      const prev = JSON.parse(readFileSync(draftPath(key), "utf8"));
+      if(prev && typeof prev.rev === "number" && prev.rev > 0) rev = prev.rev + 1;
+    }catch{}
+    writeFileSync(draftPath(key), JSON.stringify({ key: String(key), updatedAt: nowSec(), rev, draft }, null, 2), "utf8");
+    return rev;
+  }catch(e){ try{ console.error("[dsh-cc-studio] persist draft failed:", (e && e.message) || e); }catch{} return null; }
 }
 function draftMeta(key){
   const k = key || "default";
-  if(!globalThis.__CC_DRAFT_META__.has(k)) globalThis.__CC_DRAFT_META__.set(k, { isNew: false, recovered: false });
+  if(!globalThis.__CC_DRAFT_META__.has(k)) globalThis.__CC_DRAFT_META__.set(k, { isNew: false, recovered: false, newReason: null });
   return globalThis.__CC_DRAFT_META__.get(k);
 }
+/** 卡片内容指纹（忽略 modification_date）：判断「这次写入到底有没有真的改变内容」（N4，与工具半同构）。 */
+function cardFingerprint(draft){
+  try{
+    const d = JSON.parse(JSON.stringify((draft && draft.data) ? draft.data : {}));
+    delete d.modification_date;
+    return JSON.stringify(d);
+  }catch{ return ""; }
+}
 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) };
+  // B1（0.7.1）：缺 `creation_date` 的外部导入卡不能再漏出 `undefined`（工具侧会因此整次调用失败，
+  // 前端也会把 undefined 渲染成字面量）。
+  return { isNew: !!m.isNew, recovered: !!m.recovered, creation_date: (draft && draft.data && draft.data.creation_date !== undefined) ? draft.data.creation_date : null, key: String(key) };
 }
 /**
  * 解析「这次调用读写哪把草稿槽」，并把来源一并带出来（诊断用）。
@@ -261,20 +333,25 @@ function getDraftFor(key){
     // fix #2：内存 miss 时先尝试从磁盘恢复，而非静默建空
     const restored = loadPersistedDraftSync(k);
     if(restored){
-      globalThis.__CC_DRAFTS__.set(k, restored);
-      const m = draftMeta(k); m.isNew = false; m.recovered = true;
+      globalThis.__CC_DRAFTS__.set(k, normalizeCardShape(restored));   // B1：补齐外部导入卡缺失的字段
+      const m = draftMeta(k); m.isNew = false; m.recovered = true; m.newReason = null;
     } else {
       globalThis.__CC_DRAFTS__.set(k, makeDefaultDraft());
-      const m = draftMeta(k); m.isNew = true; m.recovered = false;
+      const m = draftMeta(k); m.isNew = true; m.recovered = false; m.newReason = "welcome";
     }
   }
   return globalThis.__CC_DRAFTS__.get(k);
 }
 function setDraftFor(key, draft){
-  draft.data.modification_date = nowSec();
   const k = key || "default";
+  const prev = globalThis.__CC_DRAFTS__.get(k);
+  // N4（0.7.0，与 lib/agent.js 同构）：内容一字未变时不写盘、不递增 rev。工坊侧每次编辑都调
+  // cc_setDraft，同值覆盖（失焦、重复输入、只动了别的槽）不该白耗一个版本号 —— 否则模型手上的
+  // rev 前提会被「其实没发生的变化」打掉一次，而它只能看到一句「草稿已被外部修改」。
+  if(prev && cardFingerprint(prev) === cardFingerprint(draft)) return draft;
+  draft.data.modification_date = nowSec();
   globalThis.__CC_DRAFTS__.set(k, draft);
-  const m = draftMeta(k); m.isNew = false; m.recovered = false;
+  const m = draftMeta(k); m.isNew = false; m.recovered = false; m.newReason = null;
   persistDraftSync(k, draft);
   return draft;
 }
@@ -524,12 +601,14 @@ function makeLibraryEntryMeta(draft, existingMeta, id){
   const data = draft && draft.data ? draft.data : {};
   const now = nowSec();
   const loreCount = Array.isArray(data.character_book?.entries) ? data.character_book.entries.length : 0;
-  const tags = Array.isArray(data.tags) ? data.tags.slice(0,6).map(String) : [];
+  const allTags = Array.isArray(data.tags) ? data.tags.map(String) : [];
+  const tags = allTags.slice(0, 6);
   return {
     id: String(id),
     name: (data.name && String(data.name).trim()) || (existingMeta && existingMeta.name) || "未命名角色",
     loreCount,
     tags,
+    tagsTotal: allTags.length,
     descriptionSnippet: String(data.description || "").slice(0,80),
     createdAt: existingMeta && existingMeta.createdAt ? existingMeta.createdAt : now,
     updatedAt: now,
@@ -574,13 +653,15 @@ async function saveLibraryEntry(draft, opts){
     id = String(Date.now())+"-"+Math.random().toString(36).slice(2,6);
   }
   const meta = makeLibraryEntryMeta(draft, existing ? existing.meta : null, id);
-  // 若调用方显式传 name，覆盖 meta.name（不改 draft.data.name，保持原样）
-  if(opts && typeof opts.name==="string" && opts.name.trim()){
-    meta.name = String(opts.name).trim().slice(0,60);
+  // 改名 = 单一事实来源：meta.name 与 draft.data.name 一起改（否则「列表名 / 导出名」两套，用户改名看不出效果）
+  if(opts && typeof opts.name === "string" && opts.name.trim()){
+    const n = String(opts.name).trim().slice(0,60);
+    meta.name = n;
+    draft.data.name = n;
   }
   const payload = { id, meta, draft };
   await writeFile(join(dir, id+".json"), JSON.stringify(payload, null, 2), "utf8");
-  return { id, meta, draft };
+  return { id, meta, draft, action: existing ? "updated" : "created" };
 }
 async function loadLibraryEntry(id){
   await ensureLibDir();
@@ -611,6 +692,8 @@ async function renameLibraryEntry(id, newName){
   if(!name) throw new Error("name 不能为空");
   obj.meta.name = name;
   obj.meta.updatedAt = nowSec();
+  // 单一事实来源（0.5.0）：列表名与卡内 data.name 一起改 —— 此前只改 meta，侧边栏改了名、导出的卡里还是旧名
+  if(obj.draft && obj.draft.data) obj.draft.data.name = name;
   await writeFile(found.path, JSON.stringify(obj, null, 2), "utf8");
   return obj.meta;
 }
@@ -871,7 +954,8 @@ function apply(ctx, config){
           const k = parts.key;
           const d = getDraftFor(k);
           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 };
+          const origin = readDraftOrigin(k);
+          const payload = { draft: d, key: k, keySource: parts.source, isCc: isCcPreset(ctx, (parts.source==="arg"||parts.source==="arg-snapshot") ? k : null), draftStatus: status, originId: origin ? origin.libraryId : null };
           // 只在「当前槽是个新空壳」时才去盘上翻别的槽（issue #5 的救回入口）。
           // 而且只翻**这次错位真正会牵涉到的另一把槽**，不是把所有会话的槽都端出来：
           //   · 当前是会话槽（session-<id>）→ 候选只有 default —— 旧前端在没有会话 id 时
@@ -927,6 +1011,7 @@ function apply(ctx, config){
           if(patch.mes_example!==undefined) cur.data.mes_example = String(patch.mes_example).slice(0,4000);
           if(Array.isArray(patch.tags)) cur.data.tags = patch.tags.map(String).slice(0,12);
           if(patch.creator_notes!==undefined) cur.data.creator_notes = String(patch.creator_notes).slice(0,2000);
+          if(patch.creator!==undefined) cur.data.creator = String(patch.creator).slice(0,120);   // N1：作者名此前没有写入路径
           if(patch.world && typeof patch.world==="object"){
             cur.data.extensions = cur.data.extensions || {};
             cur.data.extensions.cc_world = Object.assign({}, cur.data.extensions.cc_world||{}, patch.world);
@@ -981,29 +1066,49 @@ function apply(ctx, config){
         }
         case "cc_saveToLibrary":{
           // args: {draft?, id?, name?, sessionId?}  draft 缺省则取当前会话草稿
+          const k = draftKeyFrom(ctx, args);
           let draft = args.draft;
           if(!draft || typeof draft!=="object"){
-            const k = draftKeyFrom(ctx, args);
             draft = JSON.parse(JSON.stringify(getDraftFor(k)));
           }
+          // 不传 id 时沿用草稿的**来源 id**：工坊里「载入 → 改 → 保存」应当是更新原卡，
+          // 而不是新建一张同名重复卡（刷新页面会丢掉内存里的 currentLibraryId，所以来源落在盘上）。
+          const explicitId = (typeof args.id==="string" && args.id) ? args.id : "";
+          const origin = explicitId ? null : readDraftOrigin(k);
+          const targetId = explicitId || (origin ? origin.libraryId : "");
           // 允许保存未完全校验的草稿，但至少需要 name？不强制，meta 会兜底“未命名角色”
-          const res = await saveLibraryEntry(draft, { id: args.id, name: args.name });
-          return ok(res);
+          const res = await saveLibraryEntry(draft, { id: targetId || undefined, name: args.name });
+          writeDraftOrigin(k, res.id, res.meta.name);
+          return ok({ id: res.id, meta: res.meta, action: targetId ? "updated" : "created" });
         }
         case "cc_loadFromLibrary":{
           const id = args.id;
           if(typeof id!=="string" || !id) return fail("invalid-id","id 必填");
           const obj = await loadLibraryEntry(id);
-          // 载入到当前会话草稿
+          // 载入到当前会话草稿，并记下来源 id（sidecar）：之后不传 id 保存就是更新这一张
           const k = draftKeyFrom(ctx, args);
           setDraftFor(k, JSON.parse(JSON.stringify(obj.draft)));
-          return ok({ draft: obj.draft, meta: obj.meta, key: k, draftStatus: draftStatusFor(k, obj.draft) });
+          writeDraftOrigin(k, obj.id, obj.meta ? obj.meta.name : "");
+          return ok({ draft: obj.draft, meta: obj.meta, key: k, originId: obj.id, draftStatus: draftStatusFor(k, obj.draft) });
         }
         case "cc_deleteFromLibrary":{
           const id = args.id;
           if(typeof id!=="string" || !id) return fail("invalid-id","id 必填");
+          const k = draftKeyFrom(ctx, args);
+          const origin = readDraftOrigin(k);
+          const wasOrigin = !!(origin && origin.libraryId === id);
           await deleteLibraryEntry(id);
-          return ok({ ok:true, id });
+          // 删掉的正是当前草稿的来源卡 → 清掉关联，否则下次保存会「更新」一张已不存在的卡
+          if(wasOrigin) writeDraftOrigin(k, null);
+          const entries = await listLibraryEntries();
+          return ok({ id, remaining: entries.length, originCleared: wasOrigin });
+        }
+        case "cc_setOrigin":{
+          // 前端显式设/清「当前草稿的来源 id」：id 传 null/空 = 清（清空草稿、另存为新时用）
+          const k = draftKeyFrom(ctx, args);
+          const id = (typeof args.id === "string" && args.id) ? args.id : null;
+          writeDraftOrigin(k, id, args.name);
+          return ok({ key: k, originId: id });
         }
         case "cc_renameInLibrary":{
           const id = args.id;
@@ -1011,7 +1116,7 @@ function apply(ctx, config){
           if(typeof id!=="string" || !id) return fail("invalid-id","id 必填");
           if(typeof newName!=="string" || !newName.trim()) return fail("invalid-name","name 必填");
           const meta = await renameLibraryEntry(id, newName);
-          return ok({ meta });
+          return ok({ meta, syncedDraftName: true });
         }
         case "cc_getLibraryEntry":{
           const id = args.id;
@@ -1137,7 +1242,9 @@ export { apply, inject, name, planPresetInstall, installCcPreset, supportsDeclar
   draftKeyPartsFrom, draftContentSummary, listDraftSlotsOnDisk, migrateDraftDecision,
   // 落盘根与 lib 层 CRUD（供回归测试直接断言「DSH_HOME 优先 + 读时回退」）
   dshHomeDir, legacyDshHomeDir, dataRoots, draftDirs, draftDir, draftPath, findDraftPath, safeDraftFile,
-  persistDraftSync, loadPersistedDraftSync, libDirs, libDir,
+  persistDraftSync, loadPersistedDraftSync, libDirs, libDir, getDraftFor, setDraftFor, cardFingerprint, normalizeCardShape,
+  // 草稿来源 id 的 sidecar（0.5.0）：两半同构，测试直接交叉读写验证互通
+  readDraftOrigin, writeDraftOrigin, originFilePath,
   listLibraryEntries, saveLibraryEntry, loadLibraryEntry, deleteLibraryEntry, renameLibraryEntry };
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xia-sc/dsh-cc-studio",
-  "version": "0.4.1",
+  "version": "0.7.1",
   "description": "CCv3 角色卡工坊：融合工坊 + CC 模式 + JSON/PNG/CHARX + 中英双语（跟随全局）",
   "keywords": [
     "dsh",
@@ -38,7 +38,7 @@
     "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 && node tests/draft-slot-sync.test.mjs && node tests/nav-highlight.test.mjs && node tests/clear-card.test.mjs && node tests/export-entry.test.mjs && node tests/close-button.test.mjs && node tests/data-root.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/nav-highlight.test.mjs && node tests/clear-card.test.mjs && node tests/export-entry.test.mjs && node tests/close-button.test.mjs && node tests/tools-contract.test.mjs && node tests/data-root.test.mjs",
     "prepublishOnly": "npm test"
   },
   "dsh": {

package/presets/cc/agent.cordis.yml

@@ -32,12 +32,14 @@
       必须走完强制工作流，不可偷懒跳过 5 维世界观和世界书：
       1) cc_get_card — 先看草稿，告诉用户还缺什么
       2) cc_patch_character — 补 name/nickname/description/personality/scenario/tags（至少 description/personality/scenario 非空，tags 同步胶囊风格标签）
-      3) cc_patch_world — 补五维 timeline/factions/geo/power/daily，至少填 3 项，autoLorebook=true 自动生成带 @@decorator 的基础条目
-      4) cc_add_lorebook_entries — 再补到至少 5 条，覆盖年表/势力/地理/力量/日常各 1，至少 1 条 constant，content 头部写 @@position/@@depth/@@activate 等，支持 CBS 占位符（双花括号的 char / random / roll 形式）
+      3) cc_patch_world — 补五维 timeline/factions/geo/power/daily，至少填 3 项，autoLorebook=true 自动生成带 @@decorator 的基础条目；**同时给 loreKeys**（每一维自报用户真会说的实体名，如 {geo:["旧校舍","广播室","天台"]}）—— 不给的话自动条目的 keys 只有维度名，真实对话永远命中不了
+      4) cc_add_lorebook_entries — 再补到至少 5 条，且**至少 1 条是你与用户共创的**（纯 autoLorebook 自动条目不算完成），覆盖年表/势力/地理/力量/日常各 1，至少 1 条 constant，content 头部写 @@position/@@depth/@@activate 等，支持 CBS 占位符（双花括号的 char / random / roll 形式）；写完用 cc_simulate_trigger 拿一句用户会说的话验一下命中
       5) cc_patch_greetings — 补 first_mes、alternate_greetings(≥2)、group_only_greetings(≥1 必填)、mes_example
-      6) cc_validate — 必须调且 valid=true 才算完成，否则按返回的 errors/warnings 继续补；通过后提醒用户在工坊点“导出 JSON”或“★ 保存到侧边栏”（落盘 ~/.dsh/cc-library）
+      6) cc_validate — 必须调且 valid=true 才算完成，否则按返回的 errors/warnings 继续补；通过后提醒用户在工坊左下角「校验导出」入口打开导出页选 JSON / PNG / CHARX，或点「★ 保存当前」落盘 ~/.dsh/cc-library
 
-      规则：每次对话只追问 1-2 个薄弱点，问完立刻调工具写入；用户说“随便/跳过”也要你合理推断补全，不能留空；严禁跳过 3/4 步直接做问候语；每调一次工具要简要总结“已写入 X，下一步 Y”，并让胶囊实时同步；结束前必须 cc_validate。
+      辅助工具（按需，不必每步都调）：cc_patch_book_meta（世界书命名 / scan_depth / token_budget）、cc_lint_lorebook（世界书静态体检）、cc_simulate_trigger（验触发词命中）、cc_preview_export（导出前干跑）、cc_new_card（重置草稿，**必须先经用户同意**再带 confirm:true）、cc_update_lorebook_entry / cc_delete_lorebook_entries（改删单条）、已存库 cc_list_library / cc_save_to_library / cc_load_from_library / cc_rename_in_library / cc_delete_from_library / cc_get_library_entry（载入后直接保存会更新原卡，不会新建重复卡）。
+
+      规则：每次对话只追问 1-2 个薄弱点，问完立刻调工具写入；用户说“随便/跳过”也要你合理推断补全，不能留空；严禁跳过 3/4 步直接做问候语；每调一次工具要简要总结“已写入 X，下一步 Y”，并让胶囊实时同步；结束前必须 cc_validate。工具返回里只有一份 workflow.next（下一步该做什么）与 workflow.hint（进度摘要），照它走即可；用户还没回答就别抢跑。
 
 - id: agent-instructions
   name: '@deepseek-ai/dsh-agent-instructions'

package/presets/cc.patch.yml

@@ -67,12 +67,14 @@
                 必须走完强制工作流，不可偷懒跳过 5 维世界观和世界书：
                 1) cc_get_card — 先看草稿，告诉用户还缺什么
                 2) cc_patch_character — 补 name/nickname/description/personality/scenario/tags（至少 description/personality/scenario 非空，tags 同步胶囊风格标签）
-                3) cc_patch_world — 补五维 timeline/factions/geo/power/daily，至少填 3 项，autoLorebook=true 自动生成带 @@decorator 的基础条目
-                4) cc_add_lorebook_entries — 再补到至少 5 条，覆盖年表/势力/地理/力量/日常各 1，至少 1 条 constant，content 头部写 @@position/@@depth/@@activate 等，支持 CBS 占位符（双花括号的 char / random / roll 形式）
+                3) cc_patch_world — 补五维 timeline/factions/geo/power/daily，至少填 3 项，autoLorebook=true 自动生成带 @@decorator 的基础条目；**同时给 loreKeys**（每一维自报用户真会说的实体名，如 {geo:["旧校舍","广播室","天台"]}）—— 不给的话自动条目的 keys 只有维度名，真实对话永远命中不了
+                4) cc_add_lorebook_entries — 再补到至少 5 条，且**至少 1 条是你与用户共创的**（纯 autoLorebook 自动条目不算完成），覆盖年表/势力/地理/力量/日常各 1，至少 1 条 constant，content 头部写 @@position/@@depth/@@activate 等，支持 CBS 占位符（双花括号的 char / random / roll 形式）；写完用 cc_simulate_trigger 拿一句用户会说的话验一下命中
                 5) cc_patch_greetings — 补 first_mes、alternate_greetings(≥2)、group_only_greetings(≥1 必填)、mes_example
-                6) cc_validate — 必须调且 valid=true 才算完成，否则按返回的 errors/warnings 继续补；通过后提醒用户在工坊点“导出 JSON”或“★ 保存到侧边栏”（落盘 ~/.dsh/cc-library）
+                6) cc_validate — 必须调且 valid=true 才算完成，否则按返回的 errors/warnings 继续补；通过后提醒用户在工坊左下角「校验导出」入口打开导出页选 JSON / PNG / CHARX，或点「★ 保存当前」落盘 ~/.dsh/cc-library
 
-                规则：每次对话只追问 1-2 个薄弱点，问完立刻调工具写入；用户说“随便/跳过”也要你合理推断补全，不能留空；严禁跳过 3/4 步直接做问候语；每调一次工具要简要总结“已写入 X，下一步 Y”，并让胶囊实时同步；结束前必须 cc_validate。
+                辅助工具（按需，不必每步都调）：cc_patch_book_meta（世界书命名 / scan_depth / token_budget）、cc_lint_lorebook（世界书静态体检）、cc_simulate_trigger（验触发词命中）、cc_preview_export（导出前干跑）、cc_new_card（重置草稿，**必须先经用户同意**再带 confirm:true）、cc_update_lorebook_entry / cc_delete_lorebook_entries（改删单条）、已存库 cc_list_library / cc_save_to_library / cc_load_from_library / cc_rename_in_library / cc_delete_from_library / cc_get_library_entry（载入后直接保存会更新原卡，不会新建重复卡）。
+
+                规则：每次对话只追问 1-2 个薄弱点，问完立刻调工具写入；用户说“随便/跳过”也要你合理推断补全，不能留空；严禁跳过 3/4 步直接做问候语；每调一次工具要简要总结“已写入 X，下一步 Y”，并让胶囊实时同步；结束前必须 cc_validate。工具返回里只有一份 workflow.next（下一步该做什么）与 workflow.hint（进度摘要），照它走即可；用户还没回答就别抢跑。
 
           - id: agent-instructions
             name: '@deepseek-ai/dsh-agent-instructions'