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

package/lib/client.js

@@ -132,6 +132,50 @@ window.__ModuleLoader__.load({
       "workshop.library.save":"★ 保存当前",
       "workshop.library.saveAs":"＋ 另存为新",
       "workshop.library.rename":"✎ 重命名",
+      // —— 0.8.0 人物关系图谱 / 群聊分组 ——
+      "workshop.group.all":"全部",
+      "workshop.group.none":"未分组",
+      "workshop.group.new":"＋ 组",
+      "workshop.group.summary":"{n} 卡 / {m} 关系",
+      "workshop.group.prompt":"新分组名称（同一世界观的角色放一组）",
+      "workshop.group.assign":"组",
+      "workshop.group.set":"已归组",
+      "workshop.rel.title":"人物关系",
+      "workshop.rel.open":"关系",
+      "workshop.rel.pickGroup":"先在左侧选一个具体分组（「全部 / 未分组」下没有可编辑的关系）。",
+      "workshop.rel.noGroup":"未选分组",
+      "workshop.rel.members":"成员卡",
+      "workshop.rel.noMember":"（还没有卡入组 —— 用卡片行上的「组」按钮把同一世界观的卡拉进来）",
+      "workshop.rel.edges":"关系",
+      "workshop.rel.noEdge":"（还没有关系：用下面的表单加一条，或让模型用 cc_patch_relations 批量建）",
+      "workshop.rel.add":"添加关系",
+      "workshop.rel.addNode":"＋ NPC",
+      "workshop.rel.nodePrompt":"NPC 名字（没有独立角色卡的人物，例如「柳长老」）",
+      "workshop.rel.from":"从",
+      "workshop.rel.to":"到",
+      "workshop.rel.strength":"强度",
+      "workshop.rel.direction":"方向",
+      "workshop.rel.dirMutual":"对等",
+      "workshop.rel.dirOneWay":"单向",
+      "workshop.rel.note":"备注",
+      "workshop.rel.check":"体检",
+      "workshop.rel.render":"渲染到当前卡",
+      "workshop.rel.rendered":"已把 {n} 条关系写进当前卡（记得「保存当前」才会落库）",
+      "workshop.rel.checkResult":"体检：{n} 个问题",
+      "workshop.rel.checkOk":"体检通过：没有结构性问题",
+      "workshop.rel.saved":"关系已更新（rev {rev}）",
+      "workshop.rel.needLoad":"先在左侧「载入」一张卡：渲染要知道写进哪张卡",
+      "workshop.rel.hint":"关系只存在插件侧，不写进 CCv3 字段；「渲染到当前卡」会把它们写进 description 的【关系】段，让分享出去的卡自包含。",
+      "rel.type.family":"亲属",
+      "rel.type.romance":"恋慕",
+      "rel.type.mentor":"师徒",
+      "rel.type.friend":"挚友",
+      "rel.type.colleague":"同门",
+      "rel.type.rival":"竞争",
+      "rel.type.enemy":"敌对",
+      "rel.type.debt":"恩义",
+      "rel.type.superior":"上下级",
+      "rel.type.other":"其他",
       "workshop.library.new":"＋ 新建",
       "workshop.library.searchPlaceholder":"搜索 名称/标签…",
       "workshop.library.empty":"还没有已存角色\n去“世界观/角色细化”填好后点“保存当前”",
@@ -216,6 +260,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":"编辑",
@@ -344,6 +389,50 @@ window.__ModuleLoader__.load({
       "workshop.library.save":"★ Save Current",
       "workshop.library.saveAs":"＋ Save as New",
       "workshop.library.rename":"✎ Rename",
+      // —— 0.8.0 relationship graph / group chat ——
+      "workshop.group.all":"All",
+      "workshop.group.none":"Ungrouped",
+      "workshop.group.new":"+ Group",
+      "workshop.group.summary":"{n} cards / {m} relations",
+      "workshop.group.prompt":"New group name (characters of one world go together)",
+      "workshop.group.assign":"Group",
+      "workshop.group.set":"Grouped",
+      "workshop.rel.title":"Relationships",
+      "workshop.rel.open":"Relations",
+      "workshop.rel.pickGroup":"Pick a specific group on the left (no editable relations under All / Ungrouped).",
+      "workshop.rel.noGroup":"No group",
+      "workshop.rel.members":"Member cards",
+      "workshop.rel.noMember":"(no cards yet — use the “Group” button on a card row to pull in cards of the same world)",
+      "workshop.rel.edges":"Relations",
+      "workshop.rel.noEdge":"(none yet: add one with the form below, or let the model build them with cc_patch_relations)",
+      "workshop.rel.add":"Add relation",
+      "workshop.rel.addNode":"+ NPC",
+      "workshop.rel.nodePrompt":"NPC name (someone without their own card, e.g. an elder)",
+      "workshop.rel.from":"From",
+      "workshop.rel.to":"To",
+      "workshop.rel.strength":"Strength",
+      "workshop.rel.direction":"Direction",
+      "workshop.rel.dirMutual":"Mutual",
+      "workshop.rel.dirOneWay":"One-way",
+      "workshop.rel.note":"Note",
+      "workshop.rel.check":"Check",
+      "workshop.rel.render":"Render into current card",
+      "workshop.rel.rendered":"Wrote {n} relations into the current card (remember to “Save current”)",
+      "workshop.rel.checkResult":"Check: {n} issue(s)",
+      "workshop.rel.checkOk":"Check passed: no structural issues",
+      "workshop.rel.saved":"Relations updated (rev {rev})",
+      "workshop.rel.needLoad":"Load a card on the left first: rendering needs to know which card to write into",
+      "workshop.rel.hint":"Relations live on the plugin side only and are never written into CCv3 fields; “Render into current card” writes them into the 【关系】 block of description so a shared card stays self-contained.",
+      "rel.type.family":"Family",
+      "rel.type.romance":"Romance",
+      "rel.type.mentor":"Mentor",
+      "rel.type.friend":"Close friend",
+      "rel.type.colleague":"Colleague",
+      "rel.type.rival":"Rival",
+      "rel.type.enemy":"Enemy",
+      "rel.type.debt":"Obligation",
+      "rel.type.superior":"Superior",
+      "rel.type.other":"Other",
       "workshop.library.new":"＋ New",
       "workshop.library.searchPlaceholder":"Search name/tags…",
       "workshop.library.empty":"No saved characters\nFill World/Character then ★ Save Current",
@@ -428,6 +517,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",
@@ -485,7 +575,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, 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 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, groups:[], currentGroupId:"", relations:null, relBusy: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; }
@@ -789,6 +879,121 @@ window.__ModuleLoader__.load({
         });
       }
       function setLibraryQuery(v){ set({libraryQuery: String(v).slice(0,40)}); }
+      // ———————————————— 0.8.0 人物关系图谱 / 群聊分组 ————————————————
+      // 关系数据活在宿主侧（<DSH_HOME>/cc-groups/），前端只通过 RPC 读写；「卡属于哪个组」由库条目
+      // 的 meta.groupId 决定（分组文件里不存成员），所以这里每次入组/移组后都要 refreshLibrary。
+      function setCurrentGroupId(id){
+        var gid = String(id || "");
+        set({currentGroupId: gid});
+        // "" = 全部（不过滤）、"__none" = 只看未分组：这两个都不是真分组，没有图谱可载
+        if(gid && gid !== "__none") loadGroup(gid); else set({relations:null});
+      }
+      async function refreshGroups(){
+        try{
+          var res = await rpc("cc_listGroups", {});
+          if(res && res.ok && res.value) set({groups: res.value.groups||[]});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+      }
+      async function loadGroup(id){
+        var gid = String(id || state.currentGroupId || "");
+        if(!gid){ set({relations:null}); return; }
+        set({relBusy:"load"});
+        try{
+          var res = await rpc("cc_getGroup", {id: gid});
+          if(res && res.ok && res.value) set({relations: res.value});
+          else set({relations:null, lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
+      async function createGroup(){
+        var name = "";
+        try{ if(typeof window!=="undefined" && window.prompt) name = String(window.prompt(t("workshop.group.prompt"), "")||"").trim(); }catch(e){}
+        if(!name) return;
+        set({relBusy:"new"});
+        try{
+          var res = await rpc("cc_createGroup", {name: name});
+          if(res && res.ok && res.value){
+            await refreshGroups();
+            set({currentGroupId: res.value.group.id});
+            await loadGroup(res.value.group.id);
+          } else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
+      async function deleteGroup(id){
+        try{ if(typeof window!=="undefined" && window.confirm && !window.confirm(t("store.confirmDelete"))) return; }catch(e){}
+        set({relBusy:"del"});
+        try{
+          var res = await rpc("cc_deleteGroup", {id: id});
+          if(res && res.ok){ set({currentGroupId:"", relations:null}); await refreshGroups(); await refreshLibrary(); }
+          else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
+      async function assignGroup(cardId, groupId){
+        if(!cardId) return;
+        set({libraryBusy:"group:"+cardId});
+        try{
+          var res = await rpc("cc_setCardGroup", {cardId: cardId, groupId: groupId || null});
+          if(res && res.ok){
+            await refreshLibrary();
+            await refreshGroups();
+            if(state.currentGroupId) await loadGroup(state.currentGroupId);
+          } else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({libraryBusy:null});
+      }
+      /** 改图谱：ops 与 cc_patch_relations 同构（addNode/updateNode/removeNode/addEdge/updateEdge/removeEdge）。 */
+      async function patchRelations(ops){
+        var gid = state.currentGroupId;
+        if(!gid){ set({lastMsg:t("workshop.rel.pickGroup")}); return; }
+        set({relBusy:"patch"});
+        try{
+          var args = { id: gid, ops: ops };
+          var rev = state.relations && state.relations.group ? state.relations.group.rev : null;
+          if(typeof rev === "number") args.expectedRev = rev;
+          var res = await rpc("cc_patchGroup", args);
+          if(res && res.ok && res.value){
+            set({lastMsg: t("workshop.rel.saved", {rev: String(res.value.group.rev)})});
+            await loadGroup(gid);
+          } else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
+      async function checkGroupNow(){
+        var gid = state.currentGroupId;
+        if(!gid){ set({lastMsg:t("workshop.rel.pickGroup")}); return; }
+        set({relBusy:"check"});
+        try{
+          var res = await rpc("cc_groupCheck", {id: gid});
+          if(res && res.ok && res.value){
+            var issues = res.value.issues || [];
+            set({lastMsg: issues.length
+              ? t("workshop.rel.checkResult", {n: String(issues.length)}) + " — " + issues.map(function(i){ return i.message; }).join("；")
+              : t("workshop.rel.checkOk")});
+          } else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
+      /** 把图谱里「我对别人的看法」渲染进当前卡的 description（固定标记区，重复渲染是替换）。 */
+      async function renderRelationsToCard(){
+        if(!state.currentLibraryId){ set({lastMsg:t("workshop.rel.needLoad")}); return; }
+        set({relBusy:"render"});
+        try{
+          var sid = state.currentSessionId || null;
+          var args = { cardId: state.currentLibraryId };
+          if(state.currentGroupId) args.groupId = state.currentGroupId;
+          if(sid) args.sessionId = sid;
+          var res = await rpc("cc_renderRelations", args);
+          if(res && res.ok && res.value){
+            // 宿主改了草稿文件 → 重新拉一次，否则工坊里看到的还是旧 description
+            var dres = await rpc("cc_getDraft", sid ? {sessionId: sid} : {});
+            if(dres && dres.ok && dres.value && dres.value.draft) setDraftFromHost(dres.value.draft, dres.value.draftStatus || null);
+            set({lastMsg: t("workshop.rel.rendered", {n: String(res.value.outgoing || 0)})});
+          } else set({lastMsg:String((res && res.error && res.error.message) || "")});
+        }catch(e){ set({lastMsg:String(e && e.message || e)}); }
+        set({relBusy:null});
+      }
       function toggleLibraryCollapsed(){ set({libraryCollapsed: !state.libraryCollapsed}); }
       async function refreshLibrary(){
         set({libraryBusy:"refresh"});
@@ -838,7 +1043,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 +1061,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){
@@ -911,7 +1122,7 @@ window.__ModuleLoader__.load({
       // 0.4.1：这里原本还有一个 exportLibraryEntry —— 直接下载某张已存角色的 JSON。
       // 三个导出入口归一之后，卡片上的「导出」改成切到导出页，导出动作只剩导出页那一套实现，
       // 这条旁路就没有调用者了（留着它等于「同一次导出有两套行为」），故删除。
-      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, clearDraft:clearDraft, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, 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, clearDraft:clearDraft, loadFromLibrary:loadFromLibrary, deleteFromLibrary:deleteFromLibrary, renameCurrentInLibrary:renameCurrentInLibrary, setCurrentGroupId:setCurrentGroupId, refreshGroups:refreshGroups, createGroup:createGroup, loadGroup:loadGroup, assignGroup:assignGroup, deleteGroup:deleteGroup, patchRelations:patchRelations, checkGroupNow:checkGroupNow, renderRelationsToCard:renderRelationsToCard };
     }
 
     var S={
@@ -1150,6 +1361,8 @@ window.__ModuleLoader__.load({
       // 从「已存角色」卡片跳进导出页时的来源卡（几秒后自动清掉）：用来给那枚按钮一个即时反馈，
       // 并在导出页把「导出的仍是工坊里这张、你点的那张还没载入」说清楚。清空后回到常态提示。
       var jumpRef=React.useState(null); var jumpFrom=jumpRef[0], setJumpFrom=jumpRef[1];
+      // 0.8.0 关系视图的「添加关系」表单（局部状态，不进 store：它只是草稿输入）
+      var relFormRef=React.useState({from:"", to:"", type:"friend", strength:3, direction:"one-way", note:""}); var relForm=relFormRef[0], setRelForm=relFormRef[1];
       React.useEffect(function(){ return store.subscribe(function(){ setS(store.getSnapshot()); }); }, [store]);
       React.useEffect(function(){
         if(s.panelOpen) store.refreshLibrary();
@@ -1295,6 +1508,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"}),
@@ -1336,7 +1552,7 @@ window.__ModuleLoader__.load({
             s.lastMsg? h("div",{style:{marginTop:8, fontSize:12, color:"var(--dsw-alias-label-secondary)"}}, s.lastMsg):null
           )
         );
-      } else {
+      } else if(s.cur===3){
         var v=s.valid;
         main=h("div",null,
           h("div",{style:S.readCard},
@@ -1374,6 +1590,83 @@ window.__ModuleLoader__.load({
             s.lastMsg? h("div",{style:{marginTop:8, fontSize:12, color:"var(--dsw-alias-label-secondary)"}}, s.lastMsg):null
           )
         );
+      } else {
+        // ── 关系视图（s.cur === 4）──
+        // 与导出页同属「不在左侧导航里的视图」：入口是右侧分组选择器旁的「关系」按钮。
+        // 这里编辑的是**插件侧图谱**（<DSH_HOME>/cc-groups/）；只有「渲染到当前卡」才会把关系写进 description。
+        var relNodes = (s.relations && s.relations.nodes) || [];
+        var relEdges = (s.relations && s.relations.edges) || [];
+        var relMembers = (s.relations && s.relations.members) || [];
+        var relGroup = s.relations && s.relations.group;
+        var gid = String(s.currentGroupId || "");
+        var canEdit = !!gid && gid !== "__none";
+        var relTypes = ["family","romance","mentor","friend","colleague","rival","enemy","debt","superior","other"];
+        var nodeName = function(id){ var hit = relNodes.filter(function(x){ return x.id === id; })[0]; return hit ? hit.name : id; };
+        var setF = function(patch){ setRelForm(Object.assign({}, relForm, patch)); };
+        var smallSel = {fontSize:11, background:"transparent", border:"1px solid var(--dsw-alias-border-l1)", borderRadius:6, color:"var(--dsw-alias-label-primary)", padding:"1px 4px"};
+        main = h("div",null,
+          h("div",{style:S.readCard},
+            h("h3",{style:S.readTitle}, t("workshop.rel.title"),
+              h("span",{style:{marginLeft:8, fontSize:12, fontWeight:400, color:"var(--dsw-alias-label-secondary)"}}, "· " + ((relGroup && relGroup.name) || t("workshop.rel.noGroup"))),
+              relGroup ? h("span",{style:Object.assign({}, S.badge, {marginLeft:8})}, "rev " + relGroup.rev) : null),
+            h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", marginBottom:10, lineHeight:1.7}}, t("workshop.rel.hint")),
+            !canEdit ? h("div",{style:{fontSize:12, color:"var(--dsw-alias-label-secondary)"}}, t("workshop.rel.pickGroup")) : h("div",null,
+              h("div",{style:{fontSize:12, fontWeight:600, marginBottom:4}}, t("workshop.rel.members") + " · " + relMembers.length),
+              h("div",{style:{display:"flex", flexWrap:"wrap", gap:6, marginBottom:14, alignItems:"center"}},
+                relMembers.map(function(m){ return h("span",{key:m.id, style:S.badge}, m.name); }),
+                relMembers.length===0 ? h("span",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)"}}, t("workshop.rel.noMember")) : null),
+              h("div",{style:{display:"flex", flexWrap:"wrap", gap:6, marginBottom:14, alignItems:"center"}},
+                relNodes.filter(function(n){ return n.kind === "npc"; }).map(function(n){ return h("span",{key:n.id, style:S.badge}, n.name); }),
+                h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid var(--dsw-alias-border-l1)", background:"transparent", color:"var(--dsw-alias-label-secondary)", borderRadius:8, padding:"2px 8px", fontSize:11}), onClick:function(){
+                  var name = "";
+                  try{ if(typeof window!=="undefined" && window.prompt) name = String(window.prompt(t("workshop.rel.nodePrompt"), "")||"").trim(); }catch(e){}
+                  if(name) store.patchRelations([{op:"addNode", kind:"npc", name:name}]);
+                }}, t("workshop.rel.addNode"))),
+              h("div",{style:{fontSize:12, fontWeight:600, marginBottom:4}}, t("workshop.rel.edges") + " · " + relEdges.length),
+              relEdges.length===0 ? h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", marginBottom:10}}, t("workshop.rel.noEdge")) :
+              h("div",null, relEdges.map(function(e){
+                return h("div",{key:e.id, style:{borderBottom:"1px solid var(--dsw-alias-border-l1)", padding:"6px 0"}},
+                  h("div",{style:{display:"flex", alignItems:"center", gap:6, flexWrap:"wrap"}},
+                    h("span",{style:{fontSize:12}}, nodeName(e.from)),
+                    h("span",{style:{color:"#7c5cff"}}, e.direction === "mutual" ? "⇄" : "→"),
+                    h("span",{style:{fontSize:12}}, nodeName(e.to)),
+                    h("select",{style:smallSel, value:e.type, onChange:function(ev){ store.patchRelations([{op:"updateEdge", edgeId:e.id, type:ev.target.value}]); }},
+                      relTypes.map(function(ty){ return h("option",{key:ty, value:ty}, t("rel.type."+ty)); })),
+                    h("select",{style:smallSel, value:String(e.strength), onChange:function(ev){ store.patchRelations([{op:"updateEdge", edgeId:e.id, strength:Number(ev.target.value)}]); }},
+                      [1,2,3,4,5].map(function(n){ return h("option",{key:n, value:String(n)}, n + "/5"); })),
+                    h("select",{style:smallSel, value:e.direction, onChange:function(ev){ store.patchRelations([{op:"updateEdge", edgeId:e.id, direction:ev.target.value}]); }},
+                      h("option",{value:"one-way"}, t("workshop.rel.dirOneWay")),
+                      h("option",{value:"mutual"}, t("workshop.rel.dirMutual"))),
+                    h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid #3a2a2a", background:"transparent", color:"#e8a6a6", borderRadius:6, padding:"1px 6px", fontSize:11}), onClick:function(){ store.patchRelations([{op:"removeEdge", edgeId:e.id}]); }}, "✕")),
+                  e.note ? h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", marginTop:2}}, e.note) : null);
+              })),
+              h("div",{style:{marginTop:14, paddingTop:10, borderTop:"1px dashed var(--dsw-alias-border-l1)"}},
+                h("div",{style:{fontSize:12, fontWeight:600, marginBottom:6}}, t("workshop.rel.add")),
+                h("div",{style:{display:"flex", gap:6, flexWrap:"wrap", alignItems:"center"}},
+                  h("span",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)"}}, t("workshop.rel.from")),
+                  h("select",{style:Object.assign({}, smallSel, {background:"var(--dsw-alias-bg-base)", maxWidth:130}), value:relForm.from, onChange:function(ev){ setF({from:ev.target.value}); }},
+                    h("option",{value:""}, "—"),
+                    relNodes.map(function(n){ return h("option",{key:n.id, value:n.id}, n.name); })),
+                  h("span",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)"}}, t("workshop.rel.to")),
+                  h("select",{style:Object.assign({}, smallSel, {background:"var(--dsw-alias-bg-base)", maxWidth:130}), value:relForm.to, onChange:function(ev){ setF({to:ev.target.value}); }},
+                    h("option",{value:""}, "—"),
+                    relNodes.map(function(n){ return h("option",{key:n.id, value:n.id}, n.name); })),
+                  h("select",{style:Object.assign({}, smallSel, {background:"var(--dsw-alias-bg-base)"}), value:relForm.type, onChange:function(ev){ setF({type:ev.target.value}); }},
+                    relTypes.map(function(ty){ return h("option",{key:ty, value:ty}, t("rel.type."+ty)); })),
+                  h("select",{style:Object.assign({}, smallSel, {background:"var(--dsw-alias-bg-base)"}), value:String(relForm.strength), onChange:function(ev){ setF({strength:Number(ev.target.value)}); }},
+                    [1,2,3,4,5].map(function(n){ return h("option",{key:n, value:String(n)}, t("workshop.rel.strength") + " " + n); })),
+                  h("select",{style:Object.assign({}, smallSel, {background:"var(--dsw-alias-bg-base)"}), value:relForm.direction, onChange:function(ev){ setF({direction:ev.target.value}); }},
+                    h("option",{value:"one-way"}, t("workshop.rel.dirOneWay")),
+                    h("option",{value:"mutual"}, t("workshop.rel.dirMutual"))),
+                  h("button",{type:"button", style:Object.assign({}, S.btn, {padding:"3px 10px", fontSize:11}), onClick:function(){ store.patchRelations([{op:"addEdge", from:relForm.from, to:relForm.to, type:relForm.type, strength:relForm.strength, direction:relForm.direction, note:relForm.note}]); }}, t("workshop.rel.add"))),
+                h("input",{placeholder:t("workshop.rel.note"), style:{width:"100%", boxSizing:"border-box", marginTop:6, background:"var(--dsw-alias-bg-base)", border:"1px solid var(--dsw-alias-border-l1)", borderRadius:8, color:"var(--dsw-alias-label-primary)", padding:"4px 8px", fontSize:12}, value:relForm.note, onChange:function(ev){ setF({note:ev.target.value}); }})),
+              h("div",{style:{display:"flex", gap:8, marginTop:14, flexWrap:"wrap"}},
+                h("button",{type:"button", style:Object.assign({}, S.btn, {padding:"4px 12px", fontSize:12}), onClick:function(){ store.renderRelationsToCard(); }, disabled: s.relBusy==="render"}, s.relBusy==="render" ? "…" : t("workshop.rel.render")),
+                h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid var(--dsw-alias-border-l1)", background:"transparent", color:"var(--dsw-alias-label-primary)", borderRadius:8, padding:"4px 12px", fontSize:12}), onClick:function(){ store.checkGroupNow(); }, disabled: s.relBusy==="check"}, s.relBusy==="check" ? "…" : t("workshop.rel.check")),
+                h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid var(--dsw-alias-border-l1)", background:"transparent", color:"var(--dsw-alias-label-secondary)", borderRadius:8, padding:"4px 12px", fontSize:12}), onClick:function(){ store.loadGroup(gid); }}, t("action.refresh")),
+                h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid #3a2a2a", background:"transparent", color:"#e8a6a6", borderRadius:8, padding:"4px 12px", fontSize:12}), onClick:function(){ store.deleteGroup(gid); }}, t("common.delete")))),
+            s.lastMsg ? h("div",{style:{marginTop:10, fontSize:12, color:"var(--dsw-alias-label-secondary)", lineHeight:1.7}}, s.lastMsg) : null)
+        );
       }
       var stepsEls=steps.map(function(label, i){
         var active=s.cur===i;
@@ -1384,9 +1677,14 @@ window.__ModuleLoader__.load({
           onClick:function(){ store.setCur(i); }}, (i+1)+". "+label);
       });
       var filteredLibrary = (function(){
+        var gid = String(s.currentGroupId||"");
+        var base = s.library;
+        // 0.8.0：分组筛选（"" = 全部；"__none" = 只看未分组）
+        if(gid === "__none") base = base.filter(function(e){ return !e.groupId; });
+        else if(gid) base = base.filter(function(e){ return String(e.groupId||"")===gid; });
         var q = String(s.libraryQuery||"").trim().toLowerCase();
-        if(!q) return s.library;
-        return s.library.filter(function(e){
+        if(!q) return base;
+        return base.filter(function(e){
           var nameMatch = String(e.name||"").toLowerCase().indexOf(q)>=0;
           var tagMatch = Array.isArray(e.tags) && e.tags.some(function(t){ return String(t).toLowerCase().indexOf(q)>=0; });
           var loreMatch = String(e.loreCount||"").indexOf(q)>=0;
@@ -1432,6 +1730,14 @@ window.__ModuleLoader__.load({
               h("span",{style:{fontSize:10, color:"var(--dsw-alias-label-secondary)", alignSelf:"center", overflow:"hidden", textOverflow:"ellipsis", whiteSpace:"nowrap", flex:1, textAlign:"right"}}, s.draft.data.name ? s.draft.data.name.slice(0,8) : t("workshop.library.unnamed"))
             ),
             h("input",{placeholder:t("workshop.library.searchPlaceholder"), style:{width:"100%", boxSizing:"border-box", maxWidth:"100%", background:"var(--dsw-alias-bg-base)", border:"1px solid var(--dsw-alias-border-l1)", borderRadius:8, color:"var(--dsw-alias-label-primary)", padding:"6px 8px", fontSize:12}, value:s.libraryQuery, onChange:function(e){ store.setLibraryQuery(e.target.value); }}),
+            // 0.8.0 分组：同一世界观的角色拉进一组，关系网按组维护（「关系」按钮进关系视图，s.cur===4）
+            h("div",{style:{display:"flex", gap:6, marginTop:6}},
+              h("select",{style:{flex:1, minWidth:0, background:"var(--dsw-alias-bg-base)", border:"1px solid var(--dsw-alias-border-l1)", borderRadius:8, color:"var(--dsw-alias-label-primary)", padding:"4px 6px", fontSize:12}, value:s.currentGroupId||"", onChange:function(e){ store.setCurrentGroupId(e.target.value); }},
+                h("option",{value:""}, t("workshop.group.all")),
+                h("option",{value:"__none"}, t("workshop.group.none")),
+                (s.groups||[]).map(function(g){ return h("option",{key:g.id, value:g.id}, g.name + " · " + t("workshop.group.summary",{n:String(g.memberCount), m:String(g.edgeCount)})); })),
+              h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid var(--dsw-alias-border-l1)", background:"transparent", color:"var(--dsw-alias-label-secondary)", borderRadius:8, padding:"4px 8px", fontSize:11, flexShrink:0}), onClick:function(){ store.createGroup(); }}, t("workshop.group.new")),
+              h("button",{type:"button", style:Object.assign({}, S.btnGhost, {border:"1px solid #7c5cff", background:"transparent", color:"#7c5cff", borderRadius:8, padding:"4px 8px", fontSize:11, flexShrink:0}), disabled: !s.currentGroupId || s.currentGroupId==="__none", onClick:function(){ store.setCur(4); }}, t("workshop.rel.open"))),
             s.lastMsg ? h("div",{style:{fontSize:11, color:"var(--dsw-alias-label-secondary)", whiteSpace:"nowrap", overflow:"hidden", textOverflow:"ellipsis"}}, s.lastMsg) : null
           ),
           h("div",{style:S.libraryList},
@@ -1439,6 +1745,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 +1759,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}},
@@ -1458,7 +1768,11 @@ window.__ModuleLoader__.load({
                   // 想导这张已存角色先点「载入」—— 免得这里悄悄换掉用户正在编辑的草稿。
                   // 点下去按钮自己先变（「已切到 ✓」），不然切页发生在中栏、用户视线却在右侧，会以为没反应。
                   h("button",{style:Object.assign({}, S.btnGhost, {border:"1px solid var(--dsw-alias-border-l1)", background:"transparent", color:(jumpFrom && jumpFrom.id===entry.id)? "#a6e8c8" : "var(--dsw-alias-label-secondary)", borderRadius:8, padding:"4px 8px", fontSize:11}), title:t("workshop.library.exportTip"), onClick:function(){ jumpToExport(entry); }}, (jumpFrom && jumpFrom.id===entry.id)? t("workshop.library.exportJumped"): t("workshop.library.export")),
-                  h("button",{style:Object.assign({}, S.btnGhost, {border:"1px solid #3a2a2a", background:"transparent", color:"#e8a6a6", borderRadius:8, padding:"4px 8px", fontSize:11}), onClick:function(){ store.deleteFromLibrary(entry.id); }, disabled: !!isBusy}, t("common.delete"))
+                  h("button",{style:Object.assign({}, S.btnGhost, {border:"1px solid #3a2a2a", background:"transparent", color:"#e8a6a6", borderRadius:8, padding:"4px 8px", fontSize:11}), onClick:function(){ store.deleteFromLibrary(entry.id); }, disabled: !!isBusy}, t("common.delete")),
+                  // 0.8.0：直接把卡归到某个分组（空 = 未分组）。分组是关系图谱的载体。
+                  h("select",{style:{background:"transparent", border:"1px solid var(--dsw-alias-border-l1)", borderRadius:8, color:(entry.groupId?"#7c5cff":"var(--dsw-alias-label-secondary)"), fontSize:11, padding:"2px 4px", maxWidth:92, flexShrink:0}, value:String(entry.groupId||""), disabled: !!isBusy, title:t("workshop.group.assign"), onChange:function(ev){ store.assignGroup(entry.id, ev.target.value||null); }},
+                    h("option",{value:""}, t("workshop.group.none")),
+                    (s.groups||[]).map(function(g){ return h("option",{key:g.id, value:g.id}, g.name); }))
                 )
               );
             })
@@ -1702,6 +2016,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{