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

package/README.md

@@ -15,7 +15,7 @@ DSH（DeepSeek Harness）插件：输入框上方的胶囊 → 全屏融合工
 | 项目 | 值 |
 | --- | --- |
 | 插件包名 | `@xia-sc/dsh-cc-studio` |
-| 当前版本 | `0.3.4` |
+| 当前版本 | `0.3.5` |
 | 宿主 RPC | `/dsh-cc-studio-rpc`（自带路由，适配 dsh ≥ `0.1.5-rc.1`；已在 `0.1.6-alpha.2` 实测） |
 | 客户端挂载点 | `conversation.input.dock`（胶囊）+ `shell.overlay`（工坊）+ `settings.section` |
 | 落盘位置 | `~/.dsh/cc-library/`（角色卡）、`~/.dsh/cc-drafts/`（会话草稿） |
@@ -28,7 +28,7 @@ DSH（DeepSeek Harness）插件：输入框上方的胶囊 → 全屏融合工
 dsh plugin --profile web add @xia-sc/dsh-cc-studio
 
 # 锁定版本
-dsh plugin --profile web add @xia-sc/dsh-cc-studio@0.3.4
+dsh plugin --profile web add @xia-sc/dsh-cc-studio@0.3.5
 ```
 
 **或从 GitHub 源安装**：
@@ -237,7 +237,7 @@ dsh-cc-studio/
 ├── cordis.patch.yml      # 宿主行插入：id dsh-cc-studio
 ├── lib/
 │   ├── index.js          # host: /dsh-cc-studio-rpc（validate, cc_getDraft/cc_setDraft/cc_patchDraft, cc_isCcMode,
-│   │                     #   cc_validateDraft, 已存库 cc_*Library, 容器 cc_importFromPng/cc_exportPng(+imageB64)/
+│   │                     #   cc_validateDraft, 草稿槽 cc_migrateDraft, 已存库 cc_*Library, 容器 cc_importFromPng/cc_exportPng(+imageB64)/
 │   │                     #   cc_importFromCharx/cc_exportCharx, CRC32/ZIP/STORE&DEFLATE）
 │   ├── agent.js          # CC 模式 Tools：6 步共创 + 2 Lorebook 管理 + 6 已存库 CRUD = 14 个，含「先与用户讨论」提示
 │   └── client.js         # client: dock 胶囊 + overlay 工坊 + settings.section（DSW Token 深浅色、品牌紫、
@@ -245,7 +245,7 @@ dsh-cc-studio/
 ├── presets/cc/           # CC 模式预设模板（共创 persona + cc-studio-agent）
 │   ├── preset.yml
 │   └── agent.cordis.yml
-├── tests/                # 4 个测试文件、158 项断言（不随包发布）
+├── tests/                # 5 个测试文件、216 项断言（不随包发布）
 │   ├── rpc-channel.test.mjs       # host 半 RPC 通道回归（假 ctx + 真实 http，23 项断言）
 │   ├── preset-install.test.mjs    # 预设自动安装决策 + 预设行契约，41 项断言
 │   ├── cc-detection.test.mjs      # CC 模式探测的源码级守卫，32 项断言
@@ -260,7 +260,7 @@ dsh-cc-studio/
 ## 开发与测试
 
 ```bash
-npm test                                   # 4 个文件、158 项断言（四个 node 脚本串联）
+npm test                                   # 5 个文件、216 项断言（五个 node 脚本串联）
 node tests/rpc-channel.test.mjs            # 只跑 host 半 RPC 通道回归（23 项断言）
 ```
 
@@ -280,6 +280,7 @@ node tests/rpc-channel.test.mjs            # 只跑 host 半 RPC 通道回归（
 
 完整历史见 [CHANGELOG.md](./CHANGELOG.md)。最近几版：
 
+- `0.3.5` 修 #5「前端与 Tools 读到不同草稿槽」：`useCcPreset` 读的 `useSessions().current` 字段在 dsh `0.1.6-alpha.2` 的 `SessionListState` 里并不存在（恒为 `null`），加上启动时那次无 key 的拉取占掉了全局节流，前端一直用 `default` 槽 —— 而模型经 Tools 写的是 `session-<会话id>` 槽，于是「模型说写好了 / 工坊说没数据」。现在会话 id 只从 slot props 取并发布到 store、拉草稿没有会话 id 就一次都不发、节流按 key、主机回传 key 不一致时不渲染而是告警；另修胶囊闪退（根域实例每秒钟把会话域实例判定的 CC 状态清掉）并新增 `cc_migrateDraft` 与「迁入本会话槽」一键救回。测试 158 → 216 项（新增行为级 `tests/draft-slot-sync.test.mjs`）。
 - `0.3.4` 适配 dsh `0.1.6-alpha.2` 并补回两处预设漏抄：CC 预设缺 `present` 行（CC 模式下模型没有「登记交付物」的工具，且不报错）、`tool-subagent` 行缺 `modelSelectionSettings: true`（子代理的指定模型入口被静默关掉）；顺带补上 alpha.2 新增的 `tool-plugin-manager` 行（`disabled`，与内置 `standard` 对齐到只剩有意的行差）。新增 7 项预设行契约守卫。
 - `0.3.3` 发布流程自动化：打 `v*` tag 即由 GitHub Actions 发布到 npm（OIDC trusted publishing，零密钥）并自动建 GitHub Release；手动触发默认只做安全自检。插件运行时行为未变。
 - `0.3.2` 包名迁移至 `@xia-sc/dsh-cc-studio`（原 `@dsh-plugins` 不是本项目持有的 npm scope），并首次发布到 npm；新增 `publishConfig.access` / `prepublishOnly` 等发布元数据。

package/lib/client.js

@@ -18,6 +18,7 @@ window.__ModuleLoader__.load({
       "capsule.draft":"草稿",
       "capsule.expanded":"已展开",
       "capsule.collapseHint":"点击展开",
+      "capsule.slotWarn":"⚠ 草稿槽不一致",
       "preset.ccLabel":"CC 模式",
       "panel.title":"角色卡工坊",
       "panel.subtitle":"CCv3 · 从点子到可导入卡",
@@ -112,6 +113,11 @@ window.__ModuleLoader__.load({
       "workshop.export.modificationDate":"modification_date（导出自动刷新）",
       "workshop.draft.fresh":"⚠️ 当前会话是全新空白草稿（无历史存档，可能是 host 重启后的新会话）。在工坊或对话中继续编辑前，请确认这是预期中的新建；如需继续旧卡请去右侧“已存角色”载入。",
       "workshop.draft.recovered":"已从磁盘自动恢复草稿（host 重启后恢复），creation_date={date}。可继续编辑，下次写入后此提示消失。",
+      "workshop.slot.mismatch":"⚠ 草稿槽不一致：本次读到的是 `{got}` 槽，而当前会话是 `{want}`。为防止把别的槽画成你的草稿，本次内容未渲染；下一次轮询会按当前会话重新读取。",
+      "workshop.slot.recover":"发现另一份已落盘草稿：{name}（{n} 条 lore，槽 {key}）。如果这就是本会话此前写入的内容，可一键迁入当前会话槽 —— 内容没有丢，只是被写进了另一把 key。",
+      "workshop.slot.migrateOne":"迁入 {key}（{n} 条 lore）",
+      "workshop.slot.migrated":"已把槽 {key} 的内容迁入当前会话（{n} 条 lore）。",
+      "workshop.slot.migrateFailed":"迁移草稿槽失败",
       "workshop.preview.title":"实时 CCv3 预览",
       "workshop.preview.cbsTitle":"CBS 速查",
       "workshop.preview.cbsHint":"大小写不敏感，逗号用 \\, 转义。",
@@ -223,6 +229,7 @@ window.__ModuleLoader__.load({
       "capsule.draft":"draft",
       "capsule.expanded":"expanded",
       "capsule.collapseHint":"Click to expand",
+      "capsule.slotWarn":"⚠ draft slot mismatch",
       "preset.ccLabel":"CC 模式",
       "panel.title":"Character Card Studio",
       "panel.subtitle":"CCv3 · Idea to Importable Card",
@@ -317,6 +324,11 @@ window.__ModuleLoader__.load({
       "workshop.export.modificationDate":"modification_date (auto on export)",
       "workshop.draft.fresh":"⚠️ This session has a fresh blank draft (no saved history, possibly a new session after host restart). Please confirm this is an intended new card before editing; to continue an old card, load it from Saved Characters on the right.",
       "workshop.draft.recovered":"Draft auto-restored from disk (after host restart), creation_date={date}. Keep editing; this notice clears after the next write.",
+      "workshop.slot.mismatch":"⚠ Draft slot mismatch: this read came from slot `{got}` while the current session is `{want}`. To avoid painting another slot's content as your draft, nothing was rendered; the next poll re-reads for the current session.",
+      "workshop.slot.recover":"Another persisted draft was found: {name} ({n} lore entries, slot {key}). If it belongs to this session, migrate it in one click — nothing was lost, it was just written under a different key.",
+      "workshop.slot.migrateOne":"Migrate {key} ({n} lore)",
+      "workshop.slot.migrated":"Migrated slot {key} into this session ({n} lore entries).",
+      "workshop.slot.migrateFailed":"Failed to migrate the draft slot",
       "workshop.preview.title":"Live CCv3 Preview",
       "workshop.preview.cbsTitle":"CBS Cheatsheet",
       "workshop.preview.cbsHint":"Case-insensitive, escape comma with \\,.",
@@ -471,7 +483,7 @@ window.__ModuleLoader__.load({
       var _saved = loadSettings();
       // 兼容旧开关：poll=false 视为 0 秒
       if(_saved.poll===false) _saved.pollInterval = 0;
-      var state={ draft: draft, draftStatus: null, cur:0, panelOpen:false, sideExpanded:false, isCcMode:false, currentSessionId:null, world:{ timeline:"", factions:"", geo:"", power:"", daily:"" }, busy:null, valid:{valid:true,errors:[],warnings:[]}, lastMsg:null, library:[], libraryQuery:"", libraryCollapsed:false, libraryBusy:null, currentLibraryId:null, editingWorld:null, editingWorldRevert:null, editingText:null, pollEnabled:_saved.poll, pollInterval:_saved.pollInterval, autoValidate:_saved.autoValidate, autoSaveOnImport:_saved.autoSaveOnImport };
+      var state={ draft: draft, draftStatus: null, cur:0, panelOpen:false, sideExpanded:false, isCcMode:false, currentSessionId:null, slotWarn:null, alternateSlots:null, world:{ timeline:"", factions:"", geo:"", power:"", daily:"" }, busy:null, valid:{valid:true,errors:[],warnings:[]}, lastMsg:null, library:[], libraryQuery:"", libraryCollapsed:false, libraryBusy:null, currentLibraryId:null, editingWorld:null, editingWorldRevert:null, editingText:null, pollEnabled:_saved.poll, pollInterval:_saved.pollInterval, autoValidate:_saved.autoValidate, autoSaveOnImport:_saved.autoSaveOnImport };
       var listeners=new Set();
       function emit(){ listeners.forEach(function(fn){ try{fn();}catch(e){console.error(e);} }); }
       function getSnapshot(){ return state; }
@@ -484,7 +496,29 @@ window.__ModuleLoader__.load({
       // 写值恒等于 isCcMode，因此渲染条件里的 !s.triggered 是冗余项（删除前后行为完全一致）。
       function setIsCcMode(v){ var on=!!v; if(on!==state.isCcMode) set({isCcMode: on}); }
       function setDraftFromHost(draft, status){ try{ var j=JSON.stringify(draft); var curJ=JSON.stringify(state.draft); var stJ=JSON.stringify(status||null); var curStJ=JSON.stringify(state.draftStatus||null); if(stJ!==curStJ) set({draftStatus: status||null}); if(j!==curJ){ var w=draft&&draft.data&&draft.data.extensions&&draft.data.extensions.cc_world; if(w && typeof w==="object"){ var nw={ timeline:String(w.timeline||""), factions:String(w.factions||""), geo:String(w.geo||""), power:String(w.power||""), daily:String(w.daily||"") }; var curW=state.world; if(JSON.stringify(nw)!==JSON.stringify(curW)) set({draft: draft, world: nw}); else set({draft: draft}); } else set({draft: draft}); } }catch(e){ try{ var ww=draft&&draft.data&&draft.data.extensions&&draft.data.extensions.cc_world; if(ww){ var nn={ timeline:String(ww.timeline||""), factions:String(ww.factions||""), geo:String(ww.geo||""), power:String(ww.power||""), daily:String(ww.daily||"") }; set({draft: draft, world: nn}); } else set({draft: draft}); }catch(e2){ set({draft: draft}); } } }
-      function setSessionId(id){ if(id) set({currentSessionId: String(id)}); }
+      function setSessionId(id){ if(!id) return; var v=String(id); if(v!==state.currentSessionId) set({currentSessionId: v}); }
+      // 草稿槽不一致告警（issue #5）：主机回传的 key 与我们要的不是同一把时，绝不把它当当前草稿画出来。
+      function setSlotWarn(w){ set({slotWarn: w||null}); }
+      function setAlternateSlots(list){ set({alternateSlots: (list && list.length)? list : null}); }
+      // 把另一把槽的内容迁进当前会话槽（用户点「迁入当前会话槽」时调用）
+      async function migrateSlot(from){
+        var to = state.currentSessionId || null;
+        if(!from || !to) return;
+        set({busy:"migrate"});
+        try{
+          var res=await rpc("cc_migrateDraft", {from: from, to: to, sessionId: to});
+          if(res && res.ok && res.value && res.value.draft){
+            setDraftFromHost(res.value.draft, res.value.draftStatus||null);
+            // 迁过一次就不再重复提示「盘上还有一份 default 草稿」——源槽内容不删（不做破坏性操作），
+            // 但每开一个新会话都弹一次同样的横幅只会变成噪音。
+            if(from==="default"){ try{ localStorage.setItem("dsh-cc-studio-legacy-notice","1"); }catch(e){} }
+            set({busy:null, slotWarn:null, alternateSlots:null, currentLibraryId:null,
+              lastMsg: t("workshop.slot.migrated",{key:from, n:String((res.value.moved && res.value.moved.entries)||0)})});
+          } else {
+            set({busy:null, lastMsg: t("workshop.slot.migrateFailed") + (res && res.error ? (" — "+String(res.error.message)) : "")});
+          }
+        }catch(e){ set({busy:null, lastMsg: t("workshop.slot.migrateFailed")+" — "+String(e.message)}); }
+      }
       function saveSettings(){
         try{ localStorage.setItem("dsh-cc-studio-settings", JSON.stringify({ poll: !!state.pollEnabled, pollInterval: Number(state.pollInterval)||0, autoValidate: !!state.autoValidate, autoSaveOnImport: !!state.autoSaveOnImport })); }catch(e){}
       }
@@ -871,7 +905,7 @@ window.__ModuleLoader__.load({
         }catch(e){ set({lastMsg: String(e && e.message || e)}); }
         set({libraryBusy:null});
       }
-      return { getSnapshot:getSnapshot, subscribe:subscribe, setCur:setCur, setPanel:setPanel, setSideExpanded:setSideExpanded, setIsCcMode:setIsCcMode, setDraftFromHost:setDraftFromHost, setSessionId:setSessionId, checkIsCcMode:checkIsCcMode, setPollEnabled:setPollEnabled, setPollInterval:setPollInterval, setAutoValidate:setAutoValidate, setAutoSaveOnImport:setAutoSaveOnImport, updateDraft:updateDraft, validate:validate, exportJSON:exportJSON, exportPNG:exportPNG, embedIntoPng:embedIntoPng, exportCharx:exportCharx, importJSON:importJSON, importAny:importAny, setWorldPatch:setWorldPatch, setEditingWorld:setEditingWorld, cancelEditingWorld:cancelEditingWorld, setEditingText:setEditingText, clearEditingText:clearEditingText, cancelEditingText:cancelEditingText, updateEditingText:updateEditingText, addEntry:addEntry, setLibraryQuery:setLibraryQuery, toggleLibraryCollapsed:toggleLibraryCollapsed, refreshLibrary:refreshLibrary, saveCurrentToLibrary:saveCurrentToLibrary, saveAsNewToLibrary:saveAsNewToLibrary, clearCurrentLibraryId:clearCurrentLibraryId, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, exportLibraryEntry:exportLibraryEntry, renameCurrentInLibrary:renameCurrentInLibrary };
+      return { getSnapshot:getSnapshot, subscribe:subscribe, setCur:setCur, setPanel:setPanel, setSideExpanded:setSideExpanded, setIsCcMode:setIsCcMode, setDraftFromHost:setDraftFromHost, setSessionId:setSessionId, setSlotWarn:setSlotWarn, setAlternateSlots:setAlternateSlots, migrateSlot:migrateSlot, checkIsCcMode:checkIsCcMode, setPollEnabled:setPollEnabled, setPollInterval:setPollInterval, setAutoValidate:setAutoValidate, setAutoSaveOnImport:setAutoSaveOnImport, updateDraft:updateDraft, validate:validate, exportJSON:exportJSON, exportPNG:exportPNG, embedIntoPng:embedIntoPng, exportCharx:exportCharx, importJSON:importJSON, importAny:importAny, setWorldPatch:setWorldPatch, setEditingWorld:setEditingWorld, cancelEditingWorld:cancelEditingWorld, setEditingText:setEditingText, clearEditingText:clearEditingText, cancelEditingText:cancelEditingText, updateEditingText:updateEditingText, addEntry:addEntry, setLibraryQuery:setLibraryQuery, toggleLibraryCollapsed:toggleLibraryCollapsed, refreshLibrary:refreshLibrary, saveCurrentToLibrary:saveCurrentToLibrary, saveAsNewToLibrary:saveAsNewToLibrary, clearCurrentLibraryId:clearCurrentLibraryId, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, exportLibraryEntry:exportLibraryEntry, renameCurrentInLibrary:renameCurrentInLibrary };
     }
 
     var S={
@@ -952,27 +986,67 @@ window.__ModuleLoader__.load({
       var p = presetId ? String(presetId).toLowerCase() : "";
       if(p) return p===CC_PRESET_ID;                 // 会话投影是权威本地来源
       if(domVerdict) return true;                    // 预设芯片显示 CC
-      if(!hasSession) return false;                  // 新会话页：芯片就是权威，没显示 CC 即非 CC
+      // 连会话上下文都没有（既没有会话 id、芯片也没显示 CC）：**无权下否的结论**。
+      // issue #5 的「胶囊闪一下又消失」就出在这里：shell.overlay 是根域挂载点，拿不到会话 id，
+      // 它对同一个 store 每秒 evaluate() 一次，旧代码在这里返回 false，把会话域实例刚判定为
+      // true 的 isCcMode 清掉 → 胶囊被卸载，下一次会话域实例又装回来 = 一闪一闪。
+      // 判定不出「是」时只保持现状，让真正有会话上下文的实例（或 RPC）去改。
+      if(!hasSession) return prevIsCc ? true : false;
       // 已有会话但投影尚未到达：不确定。此时关闭会造成「选 CC → 首次对话」瞬间的胶囊闪烁，
       // 所以只有在当前并非 CC 时才返回 null，让 RPC 去确认。
       return prevIsCc ? true : null;
     }
+    /**
+     * 从 slot 的 props 里取「本组件所属的会话 id」。权威顺序：
+     *   ① session 域 slot 的标准属性 `sessionId`（SessionId）；
+     *   ② `session`（会话域 ownerProps 里的 SessionSnapshot，id 在 .sessionId 上）；
+     *   ③ 异形兜底：props.sessionId 是对象时读它的 .sessionId。
+     * 注意：**不要**再读 useSessions() 的 `current` 字段 —— 0.1.6-alpha.2 的 SessionListState
+     * 只有 ids / byId / phase（dsh-api-session-controller 的 sessions/service.d.ts），没有 current，
+     * 旧代码读它恒为 null，于是「会话投影 = 权威」这条路径从来没生效过（issue #5）。
+     */
+    function ccSessionIdOfProps(props){
+      try{
+        if(!props) return null;
+        var direct=props.sessionId;
+        if(typeof direct==="string" && direct) return direct;
+        var snap=props.session;
+        if(snap && typeof snap.sessionId==="string" && snap.sessionId) return snap.sessionId;
+        if(direct && typeof direct==="object" && typeof direct.sessionId==="string" && direct.sessionId) return direct.sessionId;
+      }catch(e){}
+      return null;
+    }
     /**
      * 探测 CC 模式并写入 store，返回当前会话 id。
      */
     function useCcPreset(store, props, t){
       var useSessions=props.useSessions;
-      var currentId = useSessions ? useSessions(function(s){ return (s && s.current) || null; }) : (props.sessionId || props.session || null);
-      if(!currentId) currentId = props.sessionId || props.session || null;
+      // ownId：本组件自己绑定的会话 id（跨渲染稳定）。shell.overlay 是根域，没有会话绑定 → null，
+      // 这时退到 store.currentSessionId（由带会话绑定的那个实例发布，两端共享同一份映射）。
+      var ownId = ccSessionIdOfProps(props);
+      var currentId = ownId || store.getSnapshot().currentSessionId || null;
+      // 会话投影：必须用上面解析出来的会话 id 去 byId 里查（旧代码用不存在的 s.current 作下标）。
       var presetId = useSessions ? useSessions(function(s){
-        try{ var id=s&&s.current; return ccPresetIdOf(id && s.byId && s.byId[id]); }catch(e){ return null; }
+        try{
+          if(!currentId) return null;
+          return ccPresetIdOf(s && s.byId && s.byId[currentId]);
+        }catch(e){ return null; }
       }) : null;
       var ccLabel=(typeof t==="function" ? t("preset.ccLabel") : "") || "";
       var evaluate=React.useCallback(function(){
         var verdict=decideCcMode(presetId, ccModeFromDom(ccLabel), !!currentId, !!store.getSnapshot().isCcMode);
-        if(verdict!==null) store.setIsCcMode(verdict);
-        return verdict===null ? !!store.getSnapshot().isCcMode : verdict;
-      }, [store, presetId, currentId, ccLabel]);
+        // 没有会话上下文的实例（根域的 shell.overlay）只能把结论改成「是」，不能改成「否」：
+        // 它无从知道当前会话是不是 CC 模式，写 false 就是 issue #5 的胶囊闪退。
+        var canConclude = !!ownId || !!currentId;
+        if(verdict===null) return !!store.getSnapshot().isCcMode;
+        if(verdict || canConclude) store.setIsCcMode(verdict);
+        return verdict || !!store.getSnapshot().isCcMode;
+      }, [store, presetId, currentId, ownId, ccLabel]);
+      // 把「本组件所属会话」发布到 store：这是全局唯一一份「当前会话 → 草稿槽」的映射，
+      // 草稿轮询、根域实例、以及所有 cc_* 调用都读它（issue #5 的两槽并存就是它一直是 null 造成的）。
+      React.useEffect(function(){
+        if(ownId) store.setSessionId(ownId);
+      }, [store, ownId]);
       React.useEffect(function(){
         var isCc=evaluate();
         if(!currentId) return;
@@ -1008,7 +1082,7 @@ window.__ModuleLoader__.load({
       var valid=s.valid && s.valid.valid;
       // 计数文案走词表（沿用既有 replace("{n}") 插值模式，locale 的 t() 不做插值）
       var loreText=t("common.loreCount").replace("{n}", String(loreCount));
-      var text=(t("capsule.open")+" · "+loreText+" · "+ (valid? t("capsule.exported"): t("capsule.draft")));
+      var text=(t("capsule.open")+" · "+loreText+" · "+ (valid? t("capsule.exported"): t("capsule.draft")) + (s.slotWarn? (" · "+t("capsule.slotWarn")): ""));
       return h("div",{style:S.dockWrap, "data-dsh-cc-studio":"dock-row"},
         h("button",{type:"button", style:S.capsule, title: t("hint.capsule"), onClick:function(){ store.setPanel(true); }},
           h("span",{style:{width:7,height:7,borderRadius:50, background: valid? "#2ee6a6":"#7c5cff", boxShadow:"0 0 8px "+(valid?"#2ee6a6":"#7c5cff"), display:"inline-block", flex:"none"}}),
@@ -1294,6 +1368,24 @@ window.__ModuleLoader__.load({
           ),
           (function(){
             var st = s.draftStatus;
+            // 草稿槽不一致 / 发现别的槽有内容时的提示（issue #5）：把「不一致」变成看得见的东西，
+            // 并给一个真的能把内容捞回来的按钮 —— 用户看到空壳时的第一反应是「草稿丢了」。
+            if(s.slotWarn){
+              return h("div",{style:{margin:"10px 16px 0", padding:"8px 12px", borderRadius:10, fontSize:12, lineHeight:1.5, background:"rgba(232,120,120,.12)", border:"1px solid rgba(232,120,120,.5)", color:"var(--dsw-alias-label-primary)", flex:"none"}},
+                t("workshop.slot.mismatch",{got:String(s.slotWarn.got||""), want:String(s.slotWarn.requested||"")}));
+            }
+            if(s.alternateSlots && s.alternateSlots.length){
+              return h("div",{style:{margin:"10px 16px 0", padding:"8px 12px", borderRadius:10, fontSize:12, lineHeight:1.5, background:"rgba(255,170,60,.10)", border:"1px solid rgba(255,170,60,.45)", color:"var(--dsw-alias-label-primary)", flex:"none"}},
+                h("div",null, t("workshop.slot.recover",{name:String(s.alternateSlots[0].name||"—"), n:String(s.alternateSlots[0].entries||0), key:String(s.alternateSlots[0].key||"")})),
+                h("div",{style:{marginTop:8, display:"flex", gap:8, flexWrap:"wrap"}},
+                  s.alternateSlots.map(function(slot){
+                    return h("button",{key:String(slot.key), style:Object.assign({}, S.btn, {padding:"4px 10px", fontSize:11}),
+                      disabled: s.busy==="migrate",
+                      onClick:function(){ store.migrateSlot(String(slot.key)); }},
+                      t("workshop.slot.migrateOne",{key:String(slot.key), n:String(slot.entries||0)}));
+                  })
+                ));
+            }
             if(!st) return null;
             if(st.isNew) return h("div",{style:{margin:"10px 16px 0", padding:"8px 12px", borderRadius:10, fontSize:12, lineHeight:1.5, background:"rgba(255,170,60,.10)", border:"1px solid rgba(255,170,60,.45)", color:"var(--dsw-alias-label-primary)", flex:"none"}}, t("workshop.draft.fresh"));
             if(st.recovered){
@@ -1441,23 +1533,49 @@ window.__ModuleLoader__.load({
     function apply(ctx){
       ctx.effect(function(){ return ctx.locale.register(NS, { zh:zh, en:en }); }, "cc-studio:locale");
       var store=createStore(ctx);
-      // CC 模式检测 + 草稿同步：会话切换触发 + CC 模式下 2.5s 轻量轮询（修复 Tools 写入后胶囊/工坊不同步的 bug）
+      // CC 模式检测 + 草稿同步：会话切换触发 + CC 模式下按设置间隔轻量轮询。
+      // 铁律：拉草稿必须带会话 id（见 pullDraft 注释，issue #5），绝不拿 default 槽顶替。
       ctx.effect(function(){
         var lastHostJson="";
         var lastHostStatusJson="";
+        var lastHostKey=null;
+        // 拉一份草稿。**必须带 key**：没有会话 id 就什么都不拉。
+        // 旧代码在 args={} 时照样发请求，主机在 HTTP 上下文里拿不到 currentInitiator()，
+        // draftKeyFrom 回退成 "default" —— 于是「模型写 session-<id>、工坊画 default」两槽并存，
+        // 用户看到空壳以为草稿丢了（issue #5）。宁可什么都不画，也不画错槽。
         function pullDraft(sessionId){
-          var args = sessionId ? {sessionId: sessionId} : {};
-          if(sessionId) store.setSessionId(sessionId);
-          ctx.connection.rpc.call("/dsh-cc-studio-rpc","cc_getDraft",{args:args}).then(function(res){
+          var key = (typeof sessionId==="string" && sessionId) ? sessionId : null;
+          if(!key) return Promise.resolve();
+          store.setSessionId(key);
+          return ctx.connection.rpc.call("/dsh-cc-studio-rpc","cc_getDraft",{args:{sessionId:key}}).then(function(res){
             if(!res || !res.ok || !res.value || !res.value.draft) return;
+            var gotKey = (typeof res.value.key==="string" && res.value.key) ? res.value.key : null;
+            // 期间用户切了会话：这次响应已经过期，丢掉（否则会把上一个会话的草稿画进新会话）
+            var cur = store.getSnapshot().currentSessionId;
+            if(cur && cur !== key) return;
+            // 主机回的槽和我们点名的槽不是同一把：**不渲染**，只把不一致摆到台面上。
+            // 正常情况下不该发生（我们总是显式传 sessionId）；留着是为了让这类错位几秒内可见。
+            if(gotKey && gotKey !== key){
+              store.setSlotWarn({ requested:key, got:gotKey, source: res.value.keySource||null });
+              return;
+            }
+            store.setSlotWarn(null);
+            var alts = res.value.alternateSlots || null;
+            // 只对「老版本遗留的 default 槽」做一次性提示：迁过一次就别再每开一个新会话弹一遍
+            if(alts && alts.length===1 && alts[0].key==="default"){
+              try{ if(localStorage.getItem("dsh-cc-studio-legacy-notice")==="1") alts = null; }catch(e){}
+            }
+            store.setAlternateSlots(alts);
             var draft=res.value.draft;
             var draftStatus=res.value.draftStatus||null;
             try{
               var j=JSON.stringify(draft);
               var stJ=JSON.stringify(draftStatus);
-              if(j!==lastHostJson || stJ!==lastHostStatusJson){
+              // 换 key 时缓存必须失效，否则「内容恰好相同」的两把槽之间会互相吞掉更新
+              if(j!==lastHostJson || stJ!==lastHostStatusJson || gotKey!==lastHostKey){
                 lastHostJson=j;
                 lastHostStatusJson=stJ;
+                lastHostKey=gotKey;
                 var curJ=JSON.stringify(store.getSnapshot().draft);
                 var curStJ=JSON.stringify(store.getSnapshot().draftStatus||null);
                 if(j!==curJ || stJ!==curStJ) store.setDraftFromHost(draft, draftStatus);
@@ -1466,25 +1584,33 @@ window.__ModuleLoader__.load({
           }).catch(function(){});
         }
         var lastPullAt = 0;
+        var lastPullKey = null;
         function pullDraftThrottled(sid){
+          var key = (typeof sid==="string" && sid) ? sid : null;
+          if(!key) return;                                              // 没有会话 id 就不拉（见 pullDraft 注释）
+          // 只节流「同一把 key」的重复请求：旧代码一把全局时间戳会在启动时把
+          // 「会话就绪后的第一次正式拉取」直接吞掉（apply 里的初始 pullDraft(null) 先占了坑），
+          // 于是 store.currentSessionId 永远没人写 → 轮询永远读 default 槽。
           var now = Date.now();
-          if(now - lastPullAt < 500) return;
+          if(key === lastPullKey && now - lastPullAt < 500) return;
           lastPullAt = now;
-          pullDraft(sid);
+          lastPullKey = key;
+          pullDraft(key);
         }
-        // 初始拉一次（default）
-        pullDraftThrottled(null);
         // 暴露给 Capsule/Workshop 按会话触发（带节流）
         store._pullDraft = pullDraftThrottled;
+        // 注意：这里**不再**做「初始拉一次 default」。启动时还没有会话，拉了只会把 default 槽
+        // 的空壳画进工坊；store 里本来就有一份本地空白草稿，够新会话页用了。
         // CC 模式下轻量轮询，保证 LLM 的 cc_* Tool 写入后胶囊实时同步（切换会话时会自动更新 currentSessionId）
-        // 仅 CC 模式下以 4s 心跳拉取，标准模式/未触发时不请求；去重避免启动时双重请求
+        // 仅 CC 模式下以 4s 心跳拉取，标准模式/未触发时不请求
         var timer = setInterval(function(){
           var s = store.getSnapshot();
           var intervalSec = Number(s.pollInterval)||0;
           if(!s.isCcMode || intervalSec===0) return;
+          var sid = s.currentSessionId || null;
+          if(!sid) return;                                             // 会话 id 未知：不拿 default 顶替
           var elapsed = Date.now() - lastPullAt;
           if(elapsed < intervalSec*1000) return;
-          var sid = s.currentSessionId || null;
           pullDraftThrottled(sid);
         }, 1000);
         return function(){ clearInterval(timer); };

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";
@@ -136,18 +136,88 @@ 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 = [];
+  let names = [];
+  try{ names = readdirSync(draftDir()); }catch{ return out; }
+  for(const f of names){
+    if(!/\.json$/i.test(String(f))) continue;
+    let obj = null;
+    try{ obj = JSON.parse(readFileSync(join(draftDir(), 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;
+    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";
@@ -700,12 +770,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 +1040,7 @@ function apply(ctx, config){
   }), "dsh-cc-studio: POST "+RPC_CHANNEL+"/*");
 }
 
-export { apply, inject, name, planPresetInstall, installCcPreset, presetTargetRoot, presetSourceRoot };
+export { apply, inject, name, planPresetInstall, installCcPreset, presetTargetRoot, presetSourceRoot,
+  draftKeyPartsFrom, draftContentSummary, listDraftSlotsOnDisk, migrateDraftDecision };
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xia-sc/dsh-cc-studio",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "CCv3 角色卡工坊：融合工坊 + CC 模式 + JSON/PNG/CHARX + 中英双语（跟随全局）",
   "keywords": [
     "dsh",
@@ -35,7 +35,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",
+    "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",
     "prepublishOnly": "npm test"
   },
   "dsh": {