dsh-cuigengji-plugin 0.4.2 → 0.4.4

package/src/domain/planning/index.ts

@@ -1,121 +1,121 @@
-import type { Board, Collection, Change, Decoration, PlanningEntity, PlanningNode, PlanningNovel, PlanningArgs, Operation } from '../../contracts/planning.ts';
+import type { Board, Collection, Change, Decoration, PlanningEntity, PlanningNode, PlanningNovel, PlanningArgs, Operation } from '../../contracts/planning.ts';
 import { ensurePlanning, validatePlanning } from './model.ts';
 import { normalizePlanningOperations } from './operations.ts';
-export { ensurePlanning, validatePlanning } from './model.ts';
-import { randomUUID } from 'node:crypto';
-const fail=(code:string,message:string):never=>{throw Object.assign(new Error(message),{code});};
-const copy=<T>(v:T):T=>structuredClone(v);
-const own=(map:object,id:string)=>Object.prototype.hasOwnProperty.call(map,id);
-const entity=<T>(map:Record<string,T>,id:string|undefined):T=>{if(!id||!own(map,id))fail('NOT_FOUND','规划对象不存在');return map[id!];};
-const check=(item:{revision:number},revision:number|undefined)=>{if(item.revision!==revision)fail('CONFLICT',`规划版本已变化，当前版本 ${item.revision}`);};
-const page=<T>(values:T[],args:PlanningArgs)=>{const offset=args.offset??0,limit=args.limit??50;if(!Number.isSafeInteger(offset)||offset<0||!Number.isSafeInteger(limit)||limit<1||limit>200)fail('INVALID_INPUT','分页参数无效');return {items:values.slice(offset,offset+limit),total:values.length,nextOffset:offset+limit<values.length?offset+limit:null};};
-export function planningAction(novel:PlanningNovel,action:string,args:PlanningArgs,actor:{kind?:string;sessionId?:string}): unknown {
-  const board=ensurePlanning(novel);
-  const inPage=(node:{pageId?:string|null})=>args.pageId===undefined||(node.pageId??null)===args.pageId;
-  if(args.pageId!==undefined&&args.pageId!==null&&(!own(board.pages||{},args.pageId)||board.pages[args.pageId].deleted))fail('NOT_FOUND','规划页面不存在');
-  if(action==='planning.pages')return [{id:null,name:'主线规划',summary:'原有规划与默认页面',revision:0},...Object.values(board.pages||{}).filter(p=>!p.deleted)].map(p=>({...p,nodeCount:Object.values(board.nodes).filter(n=>!n.deleted&&(n.pageId??null)===p.id).length,decorationCount:Object.values(board.decorations||{}).filter(d=>!d.deleted&&d.pageId===p.id).length}));
-  if(action==='planning.decorations')return {...page(Object.values(board.decorations||{}).filter(d=>(args.includeDeleted||!d.deleted)&&inPage(d)),args),sequence:board.sequence};
-  if(action.startsWith('planning.page.')){
-    const op=action.slice('planning.'.length) as 'page.create'|'page.update'|'page.delete';
-    const result=planningAction(novel,'planning.apply',{...args,operations:[{op,id:args.pageId,expectedRevision:args.expectedRevision,confirm:args.confirm,ref:'page',value:{name:args.name,summary:args.summary}} as Operation]},actor) as {mapping:Record<string,string>;sequence:number;transactionId:string};
-    return {...novel.planning!.pages[result.mapping.page||args.pageId||''],sequence:result.sequence,transactionId:result.transactionId};
-  }
+export { ensurePlanning, validatePlanning } from './model.ts';
+import { randomUUID } from 'node:crypto';
+const fail=(code:string,message:string):never=>{throw Object.assign(new Error(message),{code});};
+const copy=<T>(v:T):T=>structuredClone(v);
+const own=(map:object,id:string)=>Object.prototype.hasOwnProperty.call(map,id);
+const entity=<T>(map:Record<string,T>,id:string|undefined):T=>{if(!id||!own(map,id))fail('NOT_FOUND','规划对象不存在');return map[id!];};
+const check=(item:{revision:number},revision:number|undefined)=>{if(item.revision!==revision)fail('CONFLICT',`规划版本已变化，当前版本 ${item.revision}`);};
+const page=<T>(values:T[],args:PlanningArgs)=>{const offset=args.offset??0,limit=args.limit??50;if(!Number.isSafeInteger(offset)||offset<0||!Number.isSafeInteger(limit)||limit<1||limit>200)fail('INVALID_INPUT','分页参数无效');return {items:values.slice(offset,offset+limit),total:values.length,nextOffset:offset+limit<values.length?offset+limit:null};};
+export function planningAction(novel:PlanningNovel,action:string,args:PlanningArgs,actor:{kind?:string;sessionId?:string}): unknown {
+  const board=ensurePlanning(novel);
+  const inPage=(node:{pageId?:string|null})=>args.pageId===undefined||(node.pageId??null)===args.pageId;
+  if(args.pageId!==undefined&&args.pageId!==null&&(!own(board.pages||{},args.pageId)||board.pages[args.pageId].deleted))fail('NOT_FOUND','规划页面不存在');
+  if(action==='planning.pages')return [{id:null,name:'主线规划',summary:'原有规划与默认页面',revision:0},...Object.values(board.pages||{}).filter(p=>!p.deleted)].map(p=>({...p,nodeCount:Object.values(board.nodes).filter(n=>!n.deleted&&(n.pageId??null)===p.id).length,decorationCount:Object.values(board.decorations||{}).filter(d=>!d.deleted&&d.pageId===p.id).length}));
+  if(action==='planning.decorations')return {...page(Object.values(board.decorations||{}).filter(d=>(args.includeDeleted||!d.deleted)&&inPage(d)),args),sequence:board.sequence};
+  if(action.startsWith('planning.page.')){
+    const op=action.slice('planning.'.length) as 'page.create'|'page.update'|'page.delete';
+    const result=planningAction(novel,'planning.apply',{...args,operations:[{op,id:args.pageId,expectedRevision:args.expectedRevision,confirm:args.confirm,ref:'page',value:{name:args.name,summary:args.summary}} as Operation]},actor) as {mapping:Record<string,string>;sequence:number;transactionId:string};
+    return {...novel.planning!.pages[result.mapping.page||args.pageId||''],sequence:result.sequence,transactionId:result.transactionId};
+  }
   if(action==='planning.continue'){
-    const source=entity(board.nodes,args.nodeId);check(source,args.expectedRevision);
+    const source=entity(board.nodes,args.nodeId);check(source,args.expectedRevision);
     if(source.deleted)fail('DELETED','起点已删除');
     if(args.side!==undefined&&!['in','out'].includes(args.side))fail('INVALID_INPUT','连接方向无效');
-    if(typeof args.value?.title!=='string'||!args.value.title.trim())fail('INVALID_INPUT','请填写下一步情节标题');
-    const result=planningAction(novel,'planning.apply',{...args,reason:args.reason||`从「${source.title}」继续推进`,operations:[
-      {op:'node.create',ref:'continuation',value:{...args.value,pageId:source.pageId??null,groupId:args.value?.groupId===undefined?source.groupId??null:args.value.groupId}},
+    if(typeof args.value?.title!=='string'||!args.value.title.trim())fail('INVALID_INPUT','请填写下一步情节标题');
+    const result=planningAction(novel,'planning.apply',{...args,reason:args.reason||`从「${source.title}」继续推进`,operations:[
+      {op:'node.create',ref:'continuation',value:{...args.value,pageId:source.pageId??null,groupId:args.value?.groupId===undefined?source.groupId??null:args.value.groupId}},
       {op:'edge.create',value:{from:args.side==='in'?'continuation':source.id,to:args.side==='in'?source.id:'continuation',type:'next'}},
-    ]},actor) as {mapping:Record<string,string>;transactionId:string;sequence:number};
-    const {content,...node}=novel.planning!.nodes[result.mapping.continuation];
-    return {...result,node,from:source.id};
-  }
-  if(action==='planning.groups') return Object.values(board.groups).filter(g=>!g.deleted);
-  if(action.startsWith('planning.group.')) {
-    const op=action.slice('planning.'.length) as 'group.create'|'group.update'|'group.delete';
-    const result=planningAction(novel,'planning.apply',{...args,operations:[{op,id:args.groupId,expectedRevision:args.expectedRevision,confirm:args.confirm,ref:'group',value:{name:args.name,summary:args.summary}} as Operation]},actor) as {mapping:Record<string,string>;sequence:number;transactionId:string};
-    return {...novel.planning!.groups[result.mapping.group||args.groupId||''],sequence:result.sequence,transactionId:result.transactionId};
-  }
-  if(action==='planning.list'||action==='planning.search'){
-    const q=(args.query||'').toLowerCase();
-    const rows=Object.values(board.nodes).filter(n=>inPage(n)&&(args.includeDeleted||!n.deleted)&&(args.parentId===undefined||n.parentId===args.parentId)&&(args.groupId===undefined||(n.groupId??null)===args.groupId)&&(!args.status||n.status===args.status)&&(!args.thread||n.threads.includes(args.thread))&&(!q||`${n.title}\n${n.summary}`.toLowerCase().includes(q))).map(({content,...n})=>n);
-    return {...page(rows,args),edges:Object.values(board.edges).filter(e=>!e.deleted&&inPage(board.nodes[e.from])),sequence:board.sequence};
-  }
-  if(action==='planning.get'){const node=entity(board.nodes,args.nodeId),edges=Object.values(board.edges).filter(e=>!e.deleted&&(e.from===node.id||e.to===node.id));const neighbors=Object.values(board.nodes).filter(n=>!n.deleted&&n.id!==node.id&&edges.some(e=>e.from===n.id||e.to===n.id)).map(({content,...n})=>n);return {node,edges,neighbors,flow:{previous:neighbors.filter(n=>edges.some(e=>e.from===n.id&&e.to===node.id)),next:neighbors.filter(n=>edges.some(e=>e.from===node.id&&e.to===n.id))},children:Object.values(board.nodes).filter(n=>!n.deleted&&n.parentId===node.id).map(({content,...n})=>n),sequence:board.sequence};}
-  if(action==='planning.changes'||action==='planning.history'){
-    const values=board.transactions.filter(t=>(args.after===undefined||t.sequence>args.after)&&(!args.nodeId||t.changes.some(c=>c.id===args.nodeId)));
-    return {...page(action==='planning.history'?values.reverse():values,args),sequence:board.sequence};
-  }
-  if(!['planning.apply','planning.revert'].includes(action))fail('UNKNOWN_ACTION',action);
-  if(typeof args.requestId!=='string'||!args.requestId)fail('INVALID_INPUT','规划修改必须提供 requestId');
-  if(args.expectedSequence!==undefined&&args.expectedSequence!==board.sequence)fail('CONFLICT','规划结构在确认期间已变化，请重新核对删除范围');
-  const draft=copy(board), touched=new Map<string,Omit<Change,'after'>>(),mapping:Record<string,string>={};
-  draft.pages??={};draft.decorations??={};
-  const remember=(collection:Collection,id:string)=>{const key=`${collection}:${id}`;if(!touched.has(key))touched.set(key,{collection,id,before:copy(draft[collection][id]??null)});};
-  const stamp=()=>({lastSequence:board.sequence+1,updatedAt:new Date().toISOString(),actor:{kind:actor.kind==='human'?'human':'agent',sessionId:actor.sessionId||null}});
-  const update=<K extends Collection>(collection:K,id:string,patch:Partial<Board[K][string]>)=>{remember(collection,id);const previous=draft[collection][id];(draft[collection] as Record<string,PlanningEntity>)[id]={...previous,...patch,id,revision:(previous?.revision||0)+1,...stamp()} as PlanningEntity;};
-  const resolve=(id:string|null|undefined):string=>id&&(own(mapping,id)?mapping[id]:id)||'';
-  if(action==='planning.revert'){
-    const transaction=board.transactions.find(t=>t.id===args.transactionId);if(!transaction)fail('NOT_FOUND','变更记录不存在');
-    for(const change of transaction!.changes){const current=entity<PlanningEntity>(draft[change.collection],change.id);check(current,change.after.revision);update(change.collection,change.id,change.before||{...current,deleted:true});}
-  }else{
+    ]},actor) as {mapping:Record<string,string>;transactionId:string;sequence:number};
+    const {content,...node}=novel.planning!.nodes[result.mapping.continuation];
+    return {...result,node,from:source.id};
+  }
+  if(action==='planning.groups') return Object.values(board.groups).filter(g=>!g.deleted);
+  if(action.startsWith('planning.group.')) {
+    const op=action.slice('planning.'.length) as 'group.create'|'group.update'|'group.delete';
+    const result=planningAction(novel,'planning.apply',{...args,operations:[{op,id:args.groupId,expectedRevision:args.expectedRevision,confirm:args.confirm,ref:'group',value:{name:args.name,summary:args.summary}} as Operation]},actor) as {mapping:Record<string,string>;sequence:number;transactionId:string};
+    return {...novel.planning!.groups[result.mapping.group||args.groupId||''],sequence:result.sequence,transactionId:result.transactionId};
+  }
+  if(action==='planning.list'||action==='planning.search'){
+    const q=(args.query||'').toLowerCase();
+    const rows=Object.values(board.nodes).filter(n=>inPage(n)&&(args.includeDeleted||!n.deleted)&&(args.parentId===undefined||n.parentId===args.parentId)&&(args.groupId===undefined||(n.groupId??null)===args.groupId)&&(!args.status||n.status===args.status)&&(!args.thread||n.threads.includes(args.thread))&&(!q||`${n.title}\n${n.summary}`.toLowerCase().includes(q))).map(({content,...n})=>n);
+    return {...page(rows,args),edges:Object.values(board.edges).filter(e=>!e.deleted&&inPage(board.nodes[e.from])),sequence:board.sequence};
+  }
+  if(action==='planning.get'){const node=entity(board.nodes,args.nodeId),edges=Object.values(board.edges).filter(e=>!e.deleted&&(e.from===node.id||e.to===node.id));const neighbors=Object.values(board.nodes).filter(n=>!n.deleted&&n.id!==node.id&&edges.some(e=>e.from===n.id||e.to===n.id)).map(({content,...n})=>n);return {node,edges,neighbors,flow:{previous:neighbors.filter(n=>edges.some(e=>e.from===n.id&&e.to===node.id)),next:neighbors.filter(n=>edges.some(e=>e.from===node.id&&e.to===n.id))},children:Object.values(board.nodes).filter(n=>!n.deleted&&n.parentId===node.id).map(({content,...n})=>n),sequence:board.sequence};}
+  if(action==='planning.changes'||action==='planning.history'){
+    const values=board.transactions.filter(t=>(args.after===undefined||t.sequence>args.after)&&(!args.nodeId||t.changes.some(c=>c.id===args.nodeId)));
+    return {...page(action==='planning.history'?values.reverse():values,args),sequence:board.sequence};
+  }
+  if(!['planning.apply','planning.revert'].includes(action))fail('UNKNOWN_ACTION',action);
+  if(typeof args.requestId!=='string'||!args.requestId)fail('INVALID_INPUT','规划修改必须提供 requestId');
+  if(args.expectedSequence!==undefined&&args.expectedSequence!==board.sequence)fail('CONFLICT','规划结构在确认期间已变化，请重新核对删除范围');
+  const draft=copy(board), touched=new Map<string,Omit<Change,'after'>>(),mapping:Record<string,string>={};
+  draft.pages??={};draft.decorations??={};
+  const remember=(collection:Collection,id:string)=>{const key=`${collection}:${id}`;if(!touched.has(key))touched.set(key,{collection,id,before:copy(draft[collection][id]??null)});};
+  const stamp=()=>({lastSequence:board.sequence+1,updatedAt:new Date().toISOString(),actor:{kind:actor.kind==='human'?'human':'agent',sessionId:actor.sessionId||null}});
+  const update=<K extends Collection>(collection:K,id:string,patch:Partial<Board[K][string]>)=>{remember(collection,id);const previous=draft[collection][id];(draft[collection] as Record<string,PlanningEntity>)[id]={...previous,...patch,id,revision:(previous?.revision||0)+1,...stamp()} as PlanningEntity;};
+  const resolve=(id:string|null|undefined):string=>id&&(own(mapping,id)?mapping[id]:id)||'';
+  if(action==='planning.revert'){
+    const transaction=board.transactions.find(t=>t.id===args.transactionId);if(!transaction)fail('NOT_FOUND','变更记录不存在');
+    for(const change of transaction!.changes){const current=entity<PlanningEntity>(draft[change.collection],change.id);check(current,change.after.revision);update(change.collection,change.id,change.before||{...current,deleted:true});}
+  }else{
     for(const op of normalizePlanningOperations(args.operations)){
-      if(op.op==='page.create'){
-        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
-        update('pages',id,{name:op.value?.name,summary:op.value?.summary??'',deleted:false});
-      }else if(op.op==='page.update'||op.op==='page.delete'){
-        const id=resolve(op.id),p=entity(draft.pages,id);check(p,op.expectedRevision);if(p.deleted)fail('DELETED','页面已删除');
-        if(op.op==='page.delete'){
-          if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除页面需要确认');
-          if([...Object.values(draft.nodes),...Object.values(draft.decorations)].some(n=>!n.deleted&&n.pageId===id))fail('PAGE_NOT_EMPTY','请先移出情节并移除批注，再删除空页面');
-          update('pages',id,{deleted:true});
-        }else update('pages',id,Object.fromEntries((['name','summary'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,op.value![k]])));
-      }else if(op.op==='decoration.create'){
-        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
-        update('decorations',id,{kind:'note',title:'',content:'',position:{x:40,y:60},width:280,height:160,color:'sand',fontSize:18,fontFamily:'sans',...pickDecoration(op.value),pageId:resolve(op.value?.pageId)||null,deleted:false});
-      }else if(op.op==='decoration.update'||op.op==='decoration.delete'){
-        const id=resolve(op.id),d=entity(draft.decorations,id);check(d,op.expectedRevision);if(d.deleted)fail('DELETED','批注已删除');
-        if(op.op==='decoration.delete'){if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除批注需要确认');update('decorations',id,{deleted:true});}
-        else {const value=pickDecoration(op.value);if(value.pageId)value.pageId=resolve(value.pageId);update('decorations',id,value);}
-      }else if(op.op==='group.create'){
-        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
-        update('groups',id,{name:op.value?.name,summary:op.value?.summary??'',deleted:false});
-      }else if(op.op==='group.update'||op.op==='group.delete'){
-        const id=resolve(op.id),group=entity(draft.groups,id);check(group,op.expectedRevision);if(group.deleted)fail('DELETED','分组已删除');
-        if(op.op==='group.delete'){
-          if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除分组需要确认');
-          for(const node of Object.values(draft.nodes))if(node.groupId===id)update('nodes',node.id,{groupId:null});
-          update('groups',id,{deleted:true});
-        }else update('groups',id,Object.fromEntries((['name','summary'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,op.value![k]])));
-      }else if(op.op==='node.create'){
-        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
-        update('nodes',id,{title:'新规划',summary:'',content:'',scope:'unspecified',status:'idea',threads:[],chapterRefs:[],memoryRefs:[],...pickNode(op.value),pageId:resolve(op.value?.pageId)||null,groupId:resolve(op.value?.groupId)||null,parentId:resolve(op.value?.parentId)||null,deleted:false});
-      }else if(op.op==='node.update'){
-        const id=resolve(op.id),node=entity(draft.nodes,id);check(node,op.expectedRevision);if(node.deleted)fail('DELETED','规划已删除');const value=pickNode(op.value);if(value.parentId)value.parentId=resolve(value.parentId);if(value.groupId)value.groupId=resolve(value.groupId);if(value.pageId)value.pageId=resolve(value.pageId);update('nodes',id,value);
-      }else if(op.op==='node.delete'){
-        const id=resolve(op.id),node=entity(draft.nodes,id);check(node,op.expectedRevision);if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除需要确认');
-        const children=Object.values(draft.nodes).filter(n=>!n.deleted&&n.parentId===id);
-        if(children.length&&!['detach','subtree'].includes(op.childPolicy||''))fail('CONFIRM_REQUIRED','请选择移出子节点或删除子树');
-        const ids=new Set([id]);if(op.childPolicy==='subtree'){let changed=true;while(changed){changed=false;for(const n of Object.values(draft.nodes))if(!n.deleted&&n.parentId!==null&&ids.has(n.parentId)&&!ids.has(n.id)){ids.add(n.id);changed=true;}}}
-        else for(const child of children)update('nodes',child.id,{parentId:node.parentId});
-        for(const target of ids)update('nodes',target,{deleted:true});
-        for(const edge of Object.values(draft.edges))if(!edge.deleted&&(ids.has(edge.from)||ids.has(edge.to)))update('edges',edge.id,{deleted:true});
-      }else if(op.op==='edge.create'){
-        update('edges',randomUUID(),{from:resolve(op.value?.from),to:resolve(op.value?.to),type:op.value?.type||'next',label:op.value?.label||'',deleted:false});
-      }else if(op.op==='edge.update'){
-        const id=resolve(op.id),edge=entity(draft.edges,id);check(edge,op.expectedRevision);if(edge.deleted)fail('DELETED','关系已删除');
-        update('edges',id,Object.fromEntries((['from','to','type','label'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,k==='from'||k==='to'?resolve(op.value![k]):op.value![k]])));
-      }else if(op.op==='edge.delete'){
-        const id=resolve(op.id);check(entity(draft.edges,id),op.expectedRevision);if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除关系需要确认');update('edges',id,{deleted:true});
-      }else fail('INVALID_INPUT',`不支持的规划操作`);
-    }
-  }
-  validatePlanning(draft,novel);
-  const transaction={id:randomUUID(),sequence:board.sequence+1,...stamp(),reason:typeof args.reason==='string'?args.reason:'调整规划',changes:[...touched.values()].map(c=>({...c,after:copy(draft[c.collection][c.id])}))};
-  draft.sequence=transaction.sequence;draft.transactions.push(transaction);novel.planning=draft;
-  return {transactionId:transaction.id,sequence:draft.sequence,mapping,changed:transaction.changes.map(c=>({id:c.id,collection:c.collection,revision:c.after.revision}))};
-}
-function pickNode(value:Partial<PlanningNode>={}):Partial<PlanningNode> {return Object.fromEntries((['title','summary','content','scope','status','parentId','groupId','pageId','position','threads','chapterRefs','memoryRefs'] as const).filter(k=>value[k]!==undefined).map(k=>[k,value[k]]));}
+      if(op.op==='page.create'){
+        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
+        update('pages',id,{name:op.value?.name,summary:op.value?.summary??'',deleted:false});
+      }else if(op.op==='page.update'||op.op==='page.delete'){
+        const id=resolve(op.id),p=entity(draft.pages,id);check(p,op.expectedRevision);if(p.deleted)fail('DELETED','页面已删除');
+        if(op.op==='page.delete'){
+          if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除页面需要确认');
+          if([...Object.values(draft.nodes),...Object.values(draft.decorations)].some(n=>!n.deleted&&n.pageId===id))fail('PAGE_NOT_EMPTY','请先移出情节并移除批注，再删除空页面');
+          update('pages',id,{deleted:true});
+        }else update('pages',id,Object.fromEntries((['name','summary'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,op.value![k]])));
+      }else if(op.op==='decoration.create'){
+        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
+        update('decorations',id,{kind:'note',title:'',content:'',position:{x:40,y:60},width:280,height:160,color:'sand',fontSize:18,fontFamily:'sans',...pickDecoration(op.value),pageId:resolve(op.value?.pageId)||null,deleted:false});
+      }else if(op.op==='decoration.update'||op.op==='decoration.delete'){
+        const id=resolve(op.id),d=entity(draft.decorations,id);check(d,op.expectedRevision);if(d.deleted)fail('DELETED','批注已删除');
+        if(op.op==='decoration.delete'){if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除批注需要确认');update('decorations',id,{deleted:true});}
+        else {const value=pickDecoration(op.value);if(value.pageId)value.pageId=resolve(value.pageId);update('decorations',id,value);}
+      }else if(op.op==='group.create'){
+        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
+        update('groups',id,{name:op.value?.name,summary:op.value?.summary??'',deleted:false});
+      }else if(op.op==='group.update'||op.op==='group.delete'){
+        const id=resolve(op.id),group=entity(draft.groups,id);check(group,op.expectedRevision);if(group.deleted)fail('DELETED','分组已删除');
+        if(op.op==='group.delete'){
+          if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除分组需要确认');
+          for(const node of Object.values(draft.nodes))if(node.groupId===id)update('nodes',node.id,{groupId:null});
+          update('groups',id,{deleted:true});
+        }else update('groups',id,Object.fromEntries((['name','summary'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,op.value![k]])));
+      }else if(op.op==='node.create'){
+        const id=randomUUID();if(op.ref){if(own(mapping,op.ref))fail('INVALID_INPUT','临时引用重复');Object.defineProperty(mapping,op.ref,{value:id,enumerable:true});}
+        update('nodes',id,{title:'新规划',summary:'',content:'',scope:'unspecified',status:'idea',threads:[],chapterRefs:[],memoryRefs:[],...pickNode(op.value),pageId:resolve(op.value?.pageId)||null,groupId:resolve(op.value?.groupId)||null,parentId:resolve(op.value?.parentId)||null,deleted:false});
+      }else if(op.op==='node.update'){
+        const id=resolve(op.id),node=entity(draft.nodes,id);check(node,op.expectedRevision);if(node.deleted)fail('DELETED','规划已删除');const value=pickNode(op.value);if(value.parentId)value.parentId=resolve(value.parentId);if(value.groupId)value.groupId=resolve(value.groupId);if(value.pageId)value.pageId=resolve(value.pageId);update('nodes',id,value);
+      }else if(op.op==='node.delete'){
+        const id=resolve(op.id),node=entity(draft.nodes,id);check(node,op.expectedRevision);if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除需要确认');
+        const children=Object.values(draft.nodes).filter(n=>!n.deleted&&n.parentId===id);
+        if(children.length&&!['detach','subtree'].includes(op.childPolicy||''))fail('CONFIRM_REQUIRED','请选择移出子节点或删除子树');
+        const ids=new Set([id]);if(op.childPolicy==='subtree'){let changed=true;while(changed){changed=false;for(const n of Object.values(draft.nodes))if(!n.deleted&&n.parentId!==null&&ids.has(n.parentId)&&!ids.has(n.id)){ids.add(n.id);changed=true;}}}
+        else for(const child of children)update('nodes',child.id,{parentId:node.parentId});
+        for(const target of ids)update('nodes',target,{deleted:true});
+        for(const edge of Object.values(draft.edges))if(!edge.deleted&&(ids.has(edge.from)||ids.has(edge.to)))update('edges',edge.id,{deleted:true});
+      }else if(op.op==='edge.create'){
+        update('edges',randomUUID(),{from:resolve(op.value?.from),to:resolve(op.value?.to),type:op.value?.type||'next',label:op.value?.label||'',deleted:false});
+      }else if(op.op==='edge.update'){
+        const id=resolve(op.id),edge=entity(draft.edges,id);check(edge,op.expectedRevision);if(edge.deleted)fail('DELETED','关系已删除');
+        update('edges',id,Object.fromEntries((['from','to','type','label'] as const).filter(k=>op.value?.[k]!==undefined).map(k=>[k,k==='from'||k==='to'?resolve(op.value![k]):op.value![k]])));
+      }else if(op.op==='edge.delete'){
+        const id=resolve(op.id);check(entity(draft.edges,id),op.expectedRevision);if(op.confirm!==true)fail('CONFIRM_REQUIRED','删除关系需要确认');update('edges',id,{deleted:true});
+      }else fail('INVALID_INPUT',`不支持的规划操作`);
+    }
+  }
+  validatePlanning(draft,novel);
+  const transaction={id:randomUUID(),sequence:board.sequence+1,...stamp(),reason:typeof args.reason==='string'?args.reason:'调整规划',changes:[...touched.values()].map(c=>({...c,after:copy(draft[c.collection][c.id])}))};
+  draft.sequence=transaction.sequence;draft.transactions.push(transaction);novel.planning=draft;
+  return {transactionId:transaction.id,sequence:draft.sequence,mapping,changed:transaction.changes.map(c=>({id:c.id,collection:c.collection,revision:c.after.revision}))};
+}
+function pickNode(value:Partial<PlanningNode>={}):Partial<PlanningNode> {return Object.fromEntries((['title','summary','content','scope','status','parentId','groupId','pageId','position','threads','chapterRefs','memoryRefs'] as const).filter(k=>value[k]!==undefined).map(k=>[k,value[k]]));}
 function pickDecoration(value:Partial<Decoration>={}):Partial<Decoration>{return Object.fromEntries((['pageId','kind','title','content','position','width','height','color','fontSize','fontFamily','moveContents'] as const).filter(k=>value[k]!==undefined).map(k=>[k,value[k]]));}

package/src/domain/planning/model.ts

@@ -1,61 +1,61 @@
-import type { Board, PlanningNovel } from '../../contracts/planning.ts';
-const fail=(code:string,message:string):never=>{throw Object.assign(new Error(message),{code});};
-const copy=<T>(v:T):T=>structuredClone(v);
-const record=(v:unknown):v is Record<string,unknown>=>v!==null&&typeof v==='object'&&!Array.isArray(v);
-const own=(map:object,id:string)=>Object.prototype.hasOwnProperty.call(map,id);
-export function ensurePlanning(novel:PlanningNovel):Board {
-  if(novel.planning){
-    novel.planning.groups ??= {};
-    return novel.planning;
-  }
-  const board:Board={formatVersion:2,nodes:{},edges:{},groups:{},pages:{},decorations:{},sequence:0,transactions:[]};
-  if(novel.plan){const id=`legacy-plan-${novel.plan.id}`;board.nodes[id]={id,revision:1,title:'原有规划',summary:'从旧规划完整迁移',content:novel.plan.content,scope:'unspecified',status:'idea',parentId:null,threads:[],chapterRefs:[],memoryRefs:[],deleted:false,updatedAt:novel.plan.updatedAt||new Date().toISOString(),actor:{kind:'migration'}};board.legacy=copy(novel.plan);}
-  novel.planning=board;return board;
-}
-function cycle(nodes:{id:string}[],edges:[string,string][]) {
-  const adjacency=new Map<string,string[]>();for(const [from,to] of edges){if(!adjacency.has(from))adjacency.set(from,[]);adjacency.get(from)!.push(to);}
-  const done=new Set(),active=new Set();
-  const visit=(id:string)=>{if(active.has(id))fail('INVALID_PLANNING','层级或关系不能形成循环');if(done.has(id))return;active.add(id);for(const next of adjacency.get(id)||[])visit(next);active.delete(id);done.add(id);};
-  for(const node of nodes)visit(node.id);
-}
-export function validatePlanning(board:Board,novel:PlanningNovel):void {
-  if(!board||![1,2].includes(board.formatVersion)||!record(board.nodes)||!record(board.edges)||!Array.isArray(board.transactions)||(!Number.isSafeInteger(board.sequence)||board.sequence<0))fail('INVALID_PLANNING','规划数据格式无效');
-  board.groups ??= {};
-  const pages=board.pages??{},decorations=board.decorations??{};
-  if(!record(pages)||!record(decorations))fail('INVALID_PLANNING','页面或批注格式无效');
-  const validPage=(id:unknown)=>id===undefined||id===null||(typeof id==='string'&&own(pages,id)&&!pages[id].deleted);
-  for(const [id,p] of Object.entries(pages))if(!record(p)||id!==p.id||typeof p.name!=='string'||!p.name.trim()||typeof p.summary!=='string'||typeof p.deleted!=='boolean'||!Number.isSafeInteger(p.revision)||p.revision<1)fail('INVALID_PLANNING','规划页面无效');
-  for(const [id,d] of Object.entries(decorations)){
-    if(!record(d)||id!==d.id||!Number.isSafeInteger(d.revision)||d.revision<1||typeof d.deleted!=='boolean'||!['note','frame'].includes(d.kind)||typeof d.title!=='string'||typeof d.content!=='string'||(!d.deleted&&!validPage(d.pageId)))fail('INVALID_PLANNING','画布批注无效');
+import type { Board, PlanningNovel } from '../../contracts/planning.ts';
+const fail=(code:string,message:string):never=>{throw Object.assign(new Error(message),{code});};
+const copy=<T>(v:T):T=>structuredClone(v);
+const record=(v:unknown):v is Record<string,unknown>=>v!==null&&typeof v==='object'&&!Array.isArray(v);
+const own=(map:object,id:string)=>Object.prototype.hasOwnProperty.call(map,id);
+export function ensurePlanning(novel:PlanningNovel):Board {
+  if(novel.planning){
+    novel.planning.groups ??= {};
+    return novel.planning;
+  }
+  const board:Board={formatVersion:2,nodes:{},edges:{},groups:{},pages:{},decorations:{},sequence:0,transactions:[]};
+  if(novel.plan){const id=`legacy-plan-${novel.plan.id}`;board.nodes[id]={id,revision:1,title:'原有规划',summary:'从旧规划完整迁移',content:novel.plan.content,scope:'unspecified',status:'idea',parentId:null,threads:[],chapterRefs:[],memoryRefs:[],deleted:false,updatedAt:novel.plan.updatedAt||new Date().toISOString(),actor:{kind:'migration'}};board.legacy=copy(novel.plan);}
+  novel.planning=board;return board;
+}
+function cycle(nodes:{id:string}[],edges:[string,string][]) {
+  const adjacency=new Map<string,string[]>();for(const [from,to] of edges){if(!adjacency.has(from))adjacency.set(from,[]);adjacency.get(from)!.push(to);}
+  const done=new Set(),active=new Set();
+  const visit=(id:string)=>{if(active.has(id))fail('INVALID_PLANNING','层级或关系不能形成循环');if(done.has(id))return;active.add(id);for(const next of adjacency.get(id)||[])visit(next);active.delete(id);done.add(id);};
+  for(const node of nodes)visit(node.id);
+}
+export function validatePlanning(board:Board,novel:PlanningNovel):void {
+  if(!board||![1,2].includes(board.formatVersion)||!record(board.nodes)||!record(board.edges)||!Array.isArray(board.transactions)||(!Number.isSafeInteger(board.sequence)||board.sequence<0))fail('INVALID_PLANNING','规划数据格式无效');
+  board.groups ??= {};
+  const pages=board.pages??{},decorations=board.decorations??{};
+  if(!record(pages)||!record(decorations))fail('INVALID_PLANNING','页面或批注格式无效');
+  const validPage=(id:unknown)=>id===undefined||id===null||(typeof id==='string'&&own(pages,id)&&!pages[id].deleted);
+  for(const [id,p] of Object.entries(pages))if(!record(p)||id!==p.id||typeof p.name!=='string'||!p.name.trim()||typeof p.summary!=='string'||typeof p.deleted!=='boolean'||!Number.isSafeInteger(p.revision)||p.revision<1)fail('INVALID_PLANNING','规划页面无效');
+  for(const [id,d] of Object.entries(decorations)){
+    if(!record(d)||id!==d.id||!Number.isSafeInteger(d.revision)||d.revision<1||typeof d.deleted!=='boolean'||!['note','frame'].includes(d.kind)||typeof d.title!=='string'||typeof d.content!=='string'||(!d.deleted&&!validPage(d.pageId)))fail('INVALID_PLANNING','画布批注无效');
     if(!record(d.position)||!Number.isFinite(d.position.x)||!Number.isFinite(d.position.y)||!Number.isFinite(d.width)||d.width<160||d.width>6000||!Number.isFinite(d.height)||d.height<80||d.height>6000||![14,18,24,32].includes(d.fontSize)||!['sans','serif'].includes(d.fontFamily)||!['neutral','sand','sage','sky','rose'].includes(d.color)||(d.moveContents!==undefined&&typeof d.moveContents!=='boolean'))fail('INVALID_PLANNING','批注样式或位置无效');
-  }
-  if(!record(board.groups))fail('INVALID_PLANNING','规划分组无效');
-  for(const [id,g] of Object.entries(board.groups)) if(!record(g)||id!==g.id||typeof g.name!=='string'||!g.name.trim()||typeof g.summary!=='string'||!Number.isSafeInteger(g.revision)||g.revision<1) fail('INVALID_PLANNING','规划分组无效');
-  if([...Object.values(board.nodes),...Object.values(board.edges)].some(v=>!record(v)))fail('INVALID_PLANNING','规划对象无效');
-  const nodes=Object.values(board.nodes).filter(n=>!n.deleted),edges=Object.values(board.edges).filter(e=>!e.deleted);
-  for(const [id,n] of Object.entries(board.nodes)){
-    if(!n.deleted&&!validPage(n.pageId))fail('INVALID_PLANNING','所属页面不存在或已删除');
+  }
+  if(!record(board.groups))fail('INVALID_PLANNING','规划分组无效');
+  for(const [id,g] of Object.entries(board.groups)) if(!record(g)||id!==g.id||typeof g.name!=='string'||!g.name.trim()||typeof g.summary!=='string'||!Number.isSafeInteger(g.revision)||g.revision<1) fail('INVALID_PLANNING','规划分组无效');
+  if([...Object.values(board.nodes),...Object.values(board.edges)].some(v=>!record(v)))fail('INVALID_PLANNING','规划对象无效');
+  const nodes=Object.values(board.nodes).filter(n=>!n.deleted),edges=Object.values(board.edges).filter(e=>!e.deleted);
+  for(const [id,n] of Object.entries(board.nodes)){
+    if(!n.deleted&&!validPage(n.pageId))fail('INVALID_PLANNING','所属页面不存在或已删除');
     if(n.position!==undefined&&n.position!==null&&(!record(n.position)||!Number.isFinite(n.position.x)||!Number.isFinite(n.position.y)))fail('INVALID_PLANNING','画布位置无效');
-    if(!n.deleted&&n.groupId&&board.groups[n.groupId]?.deleted)fail('INVALID_PLANNING','所属分组已删除');
-    if(typeof n.deleted!=='boolean'||(n.parentId!==null&&typeof n.parentId!=='string')||id!==n.id||!Number.isSafeInteger(n.revision)||n.revision<1||typeof n.title!=='string'||!n.title.trim()||typeof n.content!=='string'||typeof n.summary!=='string'||(n.groupId!==null&&n.groupId!==undefined&&!Object.hasOwn(board.groups,n.groupId)))fail('INVALID_PLANNING','规划标题、内容或版本无效');
-    if(!['long','phase','near','unspecified'].includes(n.scope)||!['idea','selected','written','dropped'].includes(n.status))fail('INVALID_PLANNING','规划范围或状态无效');
-    if(!Array.isArray(n.threads)||n.threads.some(t=>typeof t!=='string')||!Array.isArray(n.chapterRefs)||!Array.isArray(n.memoryRefs))fail('INVALID_PLANNING','关联字段无效');
-    if(!n.deleted&&n.parentId&&(!own(board.nodes,n.parentId)||board.nodes[n.parentId].deleted))fail('INVALID_PLANNING','父规划不存在');
-    if(!n.deleted&&n.parentId&&(n.pageId??null)!==(board.nodes[n.parentId].pageId??null))fail('INVALID_PLANNING','父子规划须在同一页面');
-    for(const ref of n.chapterRefs)if(!record(ref)||!own(novel.chapters,ref.chapterId)||!novel.chapters[ref.chapterId]?.versions.some(v=>v.revision===ref.revision))fail('INVALID_PLANNING','关联的正文版本不存在');
-    for(const id of n.memoryRefs)if(!own(novel.nodes,id))fail('INVALID_PLANNING','关联设定不存在');
-    if(!n.deleted&&n.status==='written'&&!n.chapterRefs.length)fail('INVALID_PLANNING','已写入正文的规划至少需要一个正文版本关联');
-  }
-  const duplicates=new Set();
-  for(const [id,e] of Object.entries(board.edges)){
-    if(typeof e.deleted!=='boolean'||id!==e.id||!Number.isSafeInteger(e.revision)||e.revision<1||!['next','requires','alternative'].includes(e.type)||typeof e.label!=='string')fail('INVALID_PLANNING','关系无效');
-    if(e.deleted)continue;
-    if(e.from===e.to||!own(board.nodes,e.from)||!own(board.nodes,e.to)||board.nodes[e.from].deleted||board.nodes[e.to].deleted)fail('INVALID_PLANNING','关系端点无效');
-    if((board.nodes[e.from].pageId??null)!==(board.nodes[e.to].pageId??null))fail('INVALID_PLANNING','不同页面不能直接连线，请先移动规划或移除跨页连线');
-    const key=JSON.stringify([e.from,e.to,e.type]);if(duplicates.has(key))fail('INVALID_PLANNING','重复关系');duplicates.add(key);
-  }
-  for(const tx of board.transactions){if(typeof tx.id!=='string'||!Number.isSafeInteger(tx.sequence)||!Array.isArray(tx.changes))fail('INVALID_PLANNING','规划历史无效');for(const change of tx.changes)if(!['nodes','edges','groups','pages','decorations'].includes(change.collection)||typeof change.id!=='string'||change.after?.id!==change.id||!Number.isSafeInteger(change.after.revision)||change.after.revision<1||(change.before&&change.before.id!==change.id))fail('INVALID_PLANNING','规划历史快照无效');}
-  cycle(nodes,edges.filter(e=>e.type==='next'||e.type==='alternative').map(e=>[e.from,e.to]));
-  cycle(nodes,nodes.filter(n=>n.parentId).map(n=>[n.parentId!,n.id]));
-  for(const type of ['next','requires','alternative'])cycle(nodes,edges.filter(e=>e.type===type).map(e=>[e.from,e.to]));
-}
+    if(!n.deleted&&n.groupId&&board.groups[n.groupId]?.deleted)fail('INVALID_PLANNING','所属分组已删除');
+    if(typeof n.deleted!=='boolean'||(n.parentId!==null&&typeof n.parentId!=='string')||id!==n.id||!Number.isSafeInteger(n.revision)||n.revision<1||typeof n.title!=='string'||!n.title.trim()||typeof n.content!=='string'||typeof n.summary!=='string'||(n.groupId!==null&&n.groupId!==undefined&&!Object.hasOwn(board.groups,n.groupId)))fail('INVALID_PLANNING','规划标题、内容或版本无效');
+    if(!['long','phase','near','unspecified'].includes(n.scope)||!['idea','selected','written','dropped'].includes(n.status))fail('INVALID_PLANNING','规划范围或状态无效');
+    if(!Array.isArray(n.threads)||n.threads.some(t=>typeof t!=='string')||!Array.isArray(n.chapterRefs)||!Array.isArray(n.memoryRefs))fail('INVALID_PLANNING','关联字段无效');
+    if(!n.deleted&&n.parentId&&(!own(board.nodes,n.parentId)||board.nodes[n.parentId].deleted))fail('INVALID_PLANNING','父规划不存在');
+    if(!n.deleted&&n.parentId&&(n.pageId??null)!==(board.nodes[n.parentId].pageId??null))fail('INVALID_PLANNING','父子规划须在同一页面');
+    for(const ref of n.chapterRefs)if(!record(ref)||!own(novel.chapters,ref.chapterId)||!novel.chapters[ref.chapterId]?.versions.some(v=>v.revision===ref.revision))fail('INVALID_PLANNING','关联的正文版本不存在');
+    for(const id of n.memoryRefs)if(!own(novel.nodes,id))fail('INVALID_PLANNING','关联设定不存在');
+    if(!n.deleted&&n.status==='written'&&!n.chapterRefs.length)fail('INVALID_PLANNING','已写入正文的规划至少需要一个正文版本关联');
+  }
+  const duplicates=new Set();
+  for(const [id,e] of Object.entries(board.edges)){
+    if(typeof e.deleted!=='boolean'||id!==e.id||!Number.isSafeInteger(e.revision)||e.revision<1||!['next','requires','alternative'].includes(e.type)||typeof e.label!=='string')fail('INVALID_PLANNING','关系无效');
+    if(e.deleted)continue;
+    if(e.from===e.to||!own(board.nodes,e.from)||!own(board.nodes,e.to)||board.nodes[e.from].deleted||board.nodes[e.to].deleted)fail('INVALID_PLANNING','关系端点无效');
+    if((board.nodes[e.from].pageId??null)!==(board.nodes[e.to].pageId??null))fail('INVALID_PLANNING','不同页面不能直接连线，请先移动规划或移除跨页连线');
+    const key=JSON.stringify([e.from,e.to,e.type]);if(duplicates.has(key))fail('INVALID_PLANNING','重复关系');duplicates.add(key);
+  }
+  for(const tx of board.transactions){if(typeof tx.id!=='string'||!Number.isSafeInteger(tx.sequence)||!Array.isArray(tx.changes))fail('INVALID_PLANNING','规划历史无效');for(const change of tx.changes)if(!['nodes','edges','groups','pages','decorations'].includes(change.collection)||typeof change.id!=='string'||change.after?.id!==change.id||!Number.isSafeInteger(change.after.revision)||change.after.revision<1||(change.before&&change.before.id!==change.id))fail('INVALID_PLANNING','规划历史快照无效');}
+  cycle(nodes,edges.filter(e=>e.type==='next'||e.type==='alternative').map(e=>[e.from,e.to]));
+  cycle(nodes,nodes.filter(n=>n.parentId).map(n=>[n.parentId!,n.id]));
+  for(const type of ['next','requires','alternative'])cycle(nodes,edges.filter(e=>e.type===type).map(e=>[e.from,e.to]));
+}

package/src/domain/preset/index.js

@@ -1,89 +1,89 @@
-const object = v => v && typeof v === 'object' && !Array.isArray(v);
-const fail = message => { throw Object.assign(new Error(message), {code:'INVALID_PRESET'}); };
-export function presetBlockReason(block) {
-  return block.marker && !block.content?.trim() ? '动态占位条目没有提示词正文，内容由催更姬按自己的方式读取' : '';
-}
-export function presetBlockNotice(block) {
-  if (presetBlockReason(block)) return presetBlockReason(block);
-  return /\{\{|\}\}/.test(block.content) ? '含酒馆宏或占位符：按原文保留，不执行替换；可在下方改成明确的写作要求。' : '';
-}
-function source(input) {
-  if (!object(input) || JSON.stringify(input).length > 2_000_000) fail('预设必须是小于 2 MB 的 JSON 对象');
-  if (Array.isArray(input.prompts)) return {data:input,format:'chat-completion'};
-  if (object(input.data) && Array.isArray(input.data.prompts)) return {data:input.data,format:'prompt-manager'};
-  if (typeof input.content === 'string' || typeof input.system_prompt === 'string') {
-    const fields=[['content','主要提示词'],['system_prompt','系统提示词'],['post_history','补充要求'],['post_history_instructions','补充指令']];
-    for(const [key] of fields)if(input[key]!==undefined&&typeof input[key]!=='string')fail(`${key} 必须是文本`);
-    const prompts=fields.filter(([key])=>typeof input[key]==='string').map(([key,name])=>({identifier:key,name,content:input[key],enabled:true}));
-    return {data:{prompts},format:'system-prompt'};
-  }
-  if ('story_string' in input || 'input_sequence' in input || 'output_sequence' in input) fail('这是上下文装填或 Instruct 分隔模板，没有独立提示词正文。请选择完整 Chat Completion 预设、提示词管理器导出或系统提示词文件。');
-  fail('未找到提示词内容。支持含 prompts 的完整预设、提示词管理器导出，以及含 content 的系统提示词 JSON；仅采样参数的文件不包含提示词。');
-}
-// Shared UI/backend normalization for nested and flat Prompt Manager orders.
-export function presetImportOrders(input) {
-  const {data}=source(input),orders=data.prompt_order;
-  if(orders===undefined||orders===null)return [];
-  if(!Array.isArray(orders))fail('prompt_order 必须是数组');
-  if(!orders.length)return [];
-  if(orders.every(v=>object(v)&&typeof v.identifier==='string'))return [{character_id:'flat',order:orders}];
-  if(!orders.every(v=>object(v)&&v.character_id!==undefined&&Array.isArray(v.order)))fail('提示词排列结构无效');
-  if(new Set(orders.map(v=>String(v.character_id))).size!==orders.length)fail('提示词排列方案标识重复');
-  return orders;
-}
-export function importPreset(input, orderId) {
-  const {data,format}=source(input);
-  if (data.prompts.length > 500) fail('最多支持 500 个提示词条目');
-  const orders=presetImportOrders(input);
-  const order = orderId !== undefined ? orders.find(v=>String(v.character_id)===String(orderId)) : orders.find(v=>String(v.character_id)==='100001') || (orders.length===1?orders[0]:null);
-  if (orders.length && !order) fail('存在多个提示词排列，请先选择排列方案');
-  const map = new Map();
-  for (const p of data.prompts) {
-    if (!object(p) || typeof p.identifier !== 'string' || !p.identifier || map.has(p.identifier)) fail('条目标识缺失或重复');
-    if (p.content !== undefined && typeof p.content !== 'string') fail('提示词 content 必须是文本');
-    if (p.enabled !== undefined && typeof p.enabled !== 'boolean') fail('提示词 enabled 必须是布尔值');
-    map.set(p.identifier,p);
-  }
-  const seen = new Set(); const blocks = [], missing=[];
-  function add(p,enabled) {
-    if (seen.has(p.identifier)) return;
-    seen.add(p.identifier);
-    const block = { identifier:p.identifier, name:typeof p.name==='string'?p.name:p.identifier, content:p.content||'', role:p.role||'system', marker:p.marker===true,
-      injection_position:p.injection_position ?? 0, injection_trigger:p.injection_trigger ?? [], enabled:enabled===true };
-    const reason=presetBlockReason(block);
-    blocks.push({...block,enabled:enabled===true&&!reason,importWarning:presetBlockNotice(block)});
-  }
-  if (order) for (const item of order.order) {
-    if(!object(item)||typeof item.identifier!=='string'||(item.enabled!==undefined&&typeof item.enabled!=='boolean'))fail('提示词排列条目无效');
-    if (!map.has(item.identifier)) {
-      // Prompt Manager exports custom prompts without built-in runtime markers.
-      if(format==='prompt-manager'){missing.push(item.identifier);continue;}
-      fail(`排列引用了不存在的条目：${item.identifier}`);
-    }
-    add(map.get(item.identifier),item.enabled??map.get(item.identifier).enabled??true);
-  }
-  for (const p of data.prompts) add(p,order?false:p.enabled!==false);
-  const warnings=['导入后整体停用，核对后启用并保存。启用条目的正文按当前列表顺序加入写作要求。', '仅使用提示词内容；酒馆消息角色、触发、插入深度及装填规则不执行。模型和采样参数由 DSH 管理，原始文件随备份保留。'];
-  if(blocks.some(b=>/\{\{|\}\}/.test(b.content)))warnings.push('宏与占位符按原文保留，不执行。需要替换角色名或用户称谓时，请直接编辑提示词内容。');
-  if(missing.length)warnings.push(`排列中有 ${missing.length} 项未随文件导出，已跳过这些引用；未编造其提示词内容。`);
-  const result={name:typeof input.name==='string'&&input.name.trim()?input.name:typeof data.name==='string'&&data.name.trim()?data.name:'导入的写作预设',enabled:false,blocks,raw:input,importFormat:format,warnings};
-  validatePreset(result);
-  return result;
-}
-export function validatePreset(value) {
-  if (JSON.stringify(value)?.length > 2_000_000) fail('预设总大小超过 2 MB');
-  if (!object(value) || typeof value.name!=='string' || !value.name.trim() || typeof value.enabled!=='boolean' || !Array.isArray(value.blocks) || value.blocks.length>500) fail('预设格式无效');
-  if(value.importFormat!==undefined&&!['chat-completion','prompt-manager','system-prompt'].includes(value.importFormat))fail('预设导入格式标识无效');
-  const ids=new Set();let length=0;
-  for (const block of value.blocks) {
-    if (!object(block)||typeof block.identifier!=='string'||ids.has(block.identifier)||typeof block.content!=='string'||typeof block.name!=='string'||typeof block.enabled!=='boolean') fail('预设条目无效或标识重复');
-    ids.add(block.identifier);length+=block.content.length;
-  }
-  if(length>100000) fail('提示词总长度不能超过 100000 字符');
-  return value;
-}
-export function compilePreset(preset) {
-  if (!preset?.enabled) return '';
-  validatePreset(preset);
-  return preset.blocks.filter(block=>block.enabled&&block.content.trim()).map(block=>block.content).join('\n\n');
-}
+const object = v => v && typeof v === 'object' && !Array.isArray(v);
+const fail = message => { throw Object.assign(new Error(message), {code:'INVALID_PRESET'}); };
+export function presetBlockReason(block) {
+  return block.marker && !block.content?.trim() ? '动态占位条目没有提示词正文，内容由催更姬按自己的方式读取' : '';
+}
+export function presetBlockNotice(block) {
+  if (presetBlockReason(block)) return presetBlockReason(block);
+  return /\{\{|\}\}/.test(block.content) ? '含酒馆宏或占位符：按原文保留，不执行替换；可在下方改成明确的写作要求。' : '';
+}
+function source(input) {
+  if (!object(input) || JSON.stringify(input).length > 2_000_000) fail('预设必须是小于 2 MB 的 JSON 对象');
+  if (Array.isArray(input.prompts)) return {data:input,format:'chat-completion'};
+  if (object(input.data) && Array.isArray(input.data.prompts)) return {data:input.data,format:'prompt-manager'};
+  if (typeof input.content === 'string' || typeof input.system_prompt === 'string') {
+    const fields=[['content','主要提示词'],['system_prompt','系统提示词'],['post_history','补充要求'],['post_history_instructions','补充指令']];
+    for(const [key] of fields)if(input[key]!==undefined&&typeof input[key]!=='string')fail(`${key} 必须是文本`);
+    const prompts=fields.filter(([key])=>typeof input[key]==='string').map(([key,name])=>({identifier:key,name,content:input[key],enabled:true}));
+    return {data:{prompts},format:'system-prompt'};
+  }
+  if ('story_string' in input || 'input_sequence' in input || 'output_sequence' in input) fail('这是上下文装填或 Instruct 分隔模板，没有独立提示词正文。请选择完整 Chat Completion 预设、提示词管理器导出或系统提示词文件。');
+  fail('未找到提示词内容。支持含 prompts 的完整预设、提示词管理器导出，以及含 content 的系统提示词 JSON；仅采样参数的文件不包含提示词。');
+}
+// Shared UI/backend normalization for nested and flat Prompt Manager orders.
+export function presetImportOrders(input) {
+  const {data}=source(input),orders=data.prompt_order;
+  if(orders===undefined||orders===null)return [];
+  if(!Array.isArray(orders))fail('prompt_order 必须是数组');
+  if(!orders.length)return [];
+  if(orders.every(v=>object(v)&&typeof v.identifier==='string'))return [{character_id:'flat',order:orders}];
+  if(!orders.every(v=>object(v)&&v.character_id!==undefined&&Array.isArray(v.order)))fail('提示词排列结构无效');
+  if(new Set(orders.map(v=>String(v.character_id))).size!==orders.length)fail('提示词排列方案标识重复');
+  return orders;
+}
+export function importPreset(input, orderId) {
+  const {data,format}=source(input);
+  if (data.prompts.length > 500) fail('最多支持 500 个提示词条目');
+  const orders=presetImportOrders(input);
+  const order = orderId !== undefined ? orders.find(v=>String(v.character_id)===String(orderId)) : orders.find(v=>String(v.character_id)==='100001') || (orders.length===1?orders[0]:null);
+  if (orders.length && !order) fail('存在多个提示词排列，请先选择排列方案');
+  const map = new Map();
+  for (const p of data.prompts) {
+    if (!object(p) || typeof p.identifier !== 'string' || !p.identifier || map.has(p.identifier)) fail('条目标识缺失或重复');
+    if (p.content !== undefined && typeof p.content !== 'string') fail('提示词 content 必须是文本');
+    if (p.enabled !== undefined && typeof p.enabled !== 'boolean') fail('提示词 enabled 必须是布尔值');
+    map.set(p.identifier,p);
+  }
+  const seen = new Set(); const blocks = [], missing=[];
+  function add(p,enabled) {
+    if (seen.has(p.identifier)) return;
+    seen.add(p.identifier);
+    const block = { identifier:p.identifier, name:typeof p.name==='string'?p.name:p.identifier, content:p.content||'', role:p.role||'system', marker:p.marker===true,
+      injection_position:p.injection_position ?? 0, injection_trigger:p.injection_trigger ?? [], enabled:enabled===true };
+    const reason=presetBlockReason(block);
+    blocks.push({...block,enabled:enabled===true&&!reason,importWarning:presetBlockNotice(block)});
+  }
+  if (order) for (const item of order.order) {
+    if(!object(item)||typeof item.identifier!=='string'||(item.enabled!==undefined&&typeof item.enabled!=='boolean'))fail('提示词排列条目无效');
+    if (!map.has(item.identifier)) {
+      // Prompt Manager exports custom prompts without built-in runtime markers.
+      if(format==='prompt-manager'){missing.push(item.identifier);continue;}
+      fail(`排列引用了不存在的条目：${item.identifier}`);
+    }
+    add(map.get(item.identifier),item.enabled??map.get(item.identifier).enabled??true);
+  }
+  for (const p of data.prompts) add(p,order?false:p.enabled!==false);
+  const warnings=['导入后整体停用，核对后启用并保存。启用条目的正文按当前列表顺序加入写作要求。', '仅使用提示词内容；酒馆消息角色、触发、插入深度及装填规则不执行。模型和采样参数由 DSH 管理，原始文件随备份保留。'];
+  if(blocks.some(b=>/\{\{|\}\}/.test(b.content)))warnings.push('宏与占位符按原文保留，不执行。需要替换角色名或用户称谓时，请直接编辑提示词内容。');
+  if(missing.length)warnings.push(`排列中有 ${missing.length} 项未随文件导出，已跳过这些引用；未编造其提示词内容。`);
+  const result={name:typeof input.name==='string'&&input.name.trim()?input.name:typeof data.name==='string'&&data.name.trim()?data.name:'导入的写作预设',enabled:false,blocks,raw:input,importFormat:format,warnings};
+  validatePreset(result);
+  return result;
+}
+export function validatePreset(value) {
+  if (JSON.stringify(value)?.length > 2_000_000) fail('预设总大小超过 2 MB');
+  if (!object(value) || typeof value.name!=='string' || !value.name.trim() || typeof value.enabled!=='boolean' || !Array.isArray(value.blocks) || value.blocks.length>500) fail('预设格式无效');
+  if(value.importFormat!==undefined&&!['chat-completion','prompt-manager','system-prompt'].includes(value.importFormat))fail('预设导入格式标识无效');
+  const ids=new Set();let length=0;
+  for (const block of value.blocks) {
+    if (!object(block)||typeof block.identifier!=='string'||ids.has(block.identifier)||typeof block.content!=='string'||typeof block.name!=='string'||typeof block.enabled!=='boolean') fail('预设条目无效或标识重复');
+    ids.add(block.identifier);length+=block.content.length;
+  }
+  if(length>100000) fail('提示词总长度不能超过 100000 字符');
+  return value;
+}
+export function compilePreset(preset) {
+  if (!preset?.enabled) return '';
+  validatePreset(preset);
+  return preset.blocks.filter(block=>block.enabled&&block.content.trim()).map(block=>block.content).join('\n\n');
+}