@ash-qw/dsh-theme-prts 1.2.2 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ash-qw/dsh-theme-prts",
-  "version": "1.2.2",
+  "version": "1.3.1",
   "private": false,
   "type": "module",
   "description": "Unofficial Arknights P.R.T.S.-inspired UI theme for DeepSeek Harness Web and the official desktop client",

package/src/client/assistant-glass-adapter.js

@@ -103,6 +103,52 @@ function cssUrl(value) {
 
 export function createAssistantGlassAdapter({ document, window, avatarImage = '' }) {
   let observer
+  let observationRoot
+  let groupAvatars = true
+  let avatarsDirty = true
+  const avatarSteps = new Set()
+  const emptySteps = new Set()
+  function refreshAvatars() {
+    if (!avatarsDirty || !observationRoot) return
+    avatarsDirty = false
+    for (const step of avatarSteps) {
+      if (!observationRoot.contains(step)) {
+        step.removeAttribute('data-prts-avatar-hidden')
+        avatarSteps.delete(step)
+      }
+    }
+    emptySteps.clear()
+    if (!groupAvatars) {
+      for (const step of avatarSteps) step.removeAttribute('data-prts-avatar-hidden')
+      avatarSteps.clear()
+      return
+    }
+    const groups = new Map()
+    for (const node of observationRoot.querySelectorAll('[data-chat-flow-kind="user"], [data-chat-flow-kind="steering"], ' + STEP_SELECTOR)) {
+      const scope = node.closest('[data-conversation-scroll]') ?? observationRoot
+      let group = groups.get(scope)
+      if (!group) groups.set(scope, group = new Set())
+      if (node.getAttribute('data-chat-flow-kind') !== 'assistant-step') {
+        if (node.closest('[hidden], [data-turn-process-hidden="true"]')) continue
+        group.clear()
+        continue
+      }
+      const surface = stepSurfaces.get(node) ?? resolveAssistantSurface(node)
+      const hasContent = Boolean(surface?.textContent?.trim() || surface?.querySelector('img,video,audio,canvas,svg'))
+      if (!hasContent) emptySteps.add(node)
+      const eligible = hasContent && node.getAttribute('data-chat-group-part') !== 'reasoning'
+        && !node.closest('[hidden], [data-turn-process-hidden="true"]')
+      const turn = node.getAttribute('data-chat-turn') ?? 'unassigned'
+      // The compact-answer flag disappears when expanded; process membership
+      // remains stable, so final responses keep their independent avatars.
+      const process = node.hasAttribute('data-turn-process-member')
+      const show = eligible && (!process || !group.has(turn))
+      if (show && process) group.add(turn)
+      if (show) node.removeAttribute('data-prts-avatar-hidden')
+      else if (!node.hasAttribute('data-prts-avatar-hidden')) node.setAttribute('data-prts-avatar-hidden', '')
+      avatarSteps.add(node)
+    }
+  }
   let scanFrame
   const ownedSurfaces = new Set()
   const ownedSteps = new Set()
@@ -198,6 +244,7 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
   }
 
   function scan() {
+    refreshAvatars()
     const startedAt = window?.performance?.now?.() ?? Date.now()
     let processed = 0
     for (const step of pendingSteps) {
@@ -224,10 +271,16 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
 
   function onMutations(mutations) {
     for (const mutation of mutations) {
+      if (mutation.type === 'characterData') {
+        const step = mutation.target.parentElement?.closest(STEP_SELECTOR)
+        if (emptySteps.has(step)) avatarsDirty = true
+        continue
+      }
       const parentStep = mutation.target?.closest?.(STEP_SELECTOR)
       const stableContentMutation = parentStep
         && stableBodyContains(parentStep, mutation.target)
         && !(mutation.type === 'attributes' && stepSurfaces.get(parentStep) === mutation.target)
+      if (!stableContentMutation || emptySteps.has(parentStep)) avatarsDirty = true
       if (parentStep && !stableContentMutation) {
         pendingSteps.add(parentStep)
       }
@@ -239,7 +292,7 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
         if (surface && (surface === node || node.contains?.(surface))) pendingSteps.add(parentStep)
       }
     }
-    if (pendingSteps.size) queueScan()
+    if (pendingSteps.size || avatarsDirty) queueScan()
   }
 
   function removeMarkers() {
@@ -248,13 +301,19 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
   }
 
   return {
-    start() {
+    start({ groupAvatars: enabled = true } = {}) {
       if (!document) return
+      if (groupAvatars !== enabled) {
+        groupAvatars = enabled
+        avatarsDirty = true
+        refreshAvatars()
+      }
       mountAvatarImage()
-      const observationRoot = document.querySelector('[data-prts-region="operation"]')
+      observationRoot = document.querySelector('[data-prts-region="operation"]')
         ?? document.querySelector('[data-slot="main.conversation"], [data-slot="conversation"]')
       if (!observationRoot) return
       if (observer) return
+      avatarsDirty = true
       collectInitialSteps(observationRoot)
       scan()
       const Observer = window?.MutationObserver
@@ -263,8 +322,9 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
       observer.observe(observationRoot, {
         subtree: true,
         childList: true,
+        characterData: true,
         attributes: true,
-        attributeFilter: ['class', 'data-chat-flow-kind', 'data-chat-group-part', 'data-markdown', 'data-slot'],
+        attributeFilter: ['class', 'data-chat-flow-kind', 'data-chat-group-part', 'data-markdown', 'data-slot', 'data-chat-turn', 'hidden', 'data-turn-process-hidden', 'data-turn-process-member', 'data-turn-process-answer'],
       })
     },
     dispose() {
@@ -276,6 +336,10 @@ export function createAssistantGlassAdapter({ document, window, avatarImage = ''
       }
       scanFrame = undefined
       removeMarkers()
+      for (const step of avatarSteps) step.removeAttribute('data-prts-avatar-hidden')
+      avatarSteps.clear()
+      emptySteps.clear()
+      observationRoot = undefined
       releaseAvatarImage()
     },
   }

package/src/client/avatar-crop.js

@@ -0,0 +1,134 @@
+export function mountAvatarCrop({panel,window,load,onSave}){
+  const dialog=panel.ownerDocument.createElement('dialog')
+  dialog.setAttribute('data-prts-avatar-crop','')
+  dialog.setAttribute('aria-labelledby','prts-avatar-crop-title')
+  dialog.innerHTML=`<header><strong id="prts-avatar-crop-title">头像设置</strong><label data-prts-avatar-upload>更换图片<input type="file" accept="image/png,image/jpeg,image/webp,image/gif,image/avif" data-crop-file aria-label="上传新头像"></label></header>
+    <p>拖动亮区选择头像范围，滚轮或触摸板调整大小。</p>
+    <canvas width="320" height="320" tabindex="0" aria-label="原图与头像裁剪范围，可拖动或用方向键调整亮区"></canvas>
+    <div data-crop-tools><label>缩放 <input type="range" min="1" max="4" step=".01" value="1" aria-label="头像裁剪缩放"></label><button type="button" data-crop-center>重置裁剪</button></div>
+    <p role="status" data-prts-avatar-crop-status></p>
+    <footer><button type="button" data-crop-reset>恢复默认</button><span></span><button type="button" data-crop-cancel>取消</button><button type="button" data-crop-save>保存头像</button></footer>`
+  panel.append(dialog)
+  const canvas=dialog.querySelector('canvas'),zoom=dialog.querySelector('input[type=range]'),status=dialog.querySelector('[role=status]')
+  let bitmap,original,role,crop={zoom:1,x:.5,y:.5},drag,busy=false,disposed=false,generation=0,previousFocus,revision,hasCustom=false,ready=false
+  const clean=()=>{bitmap?.close();bitmap=null;original=null;drag=null}
+  const close=()=>{generation++;dialog.close?.();clean();previousFocus?.focus?.({preventScroll:true})}
+  const draw=()=>{
+    zoom.value=String(crop.zoom)
+    if(!bitmap){canvas.getContext('2d').clearRect(0,0,320,320);return}
+    const side=Math.min(bitmap.width,bitmap.height)/crop.zoom
+    crop.x=Math.max(side/2/bitmap.width,Math.min(1-side/2/bitmap.width,crop.x))
+    crop.y=Math.max(side/2/bitmap.height,Math.min(1-side/2/bitmap.height,crop.y))
+    const ctx=canvas.getContext('2d')
+    ctx.clearRect(0,0,320,320)
+    const scale=288/Math.max(bitmap.width,bitmap.height)
+    const width=bitmap.width*scale,height=bitmap.height*scale,left=(320-width)/2,top=(320-height)/2
+    const x=left+crop.x*width,y=top+crop.y*height,radius=side*scale/2
+    ctx.drawImage(bitmap,left,top,width,height)
+    ctx.beginPath();ctx.rect(0,0,320,320);ctx.arc(x,y,radius,0,Math.PI*2,true)
+    ctx.fillStyle='rgba(0,0,0,.65)';ctx.fill('evenodd')
+    ctx.beginPath();ctx.arc(x,y,radius,0,Math.PI*2)
+    ctx.strokeStyle='rgba(255,255,255,.95)';ctx.lineWidth=1.5;ctx.stroke()
+  }
+  const controls=()=>{
+    for(const el of dialog.querySelectorAll('button,input'))el.disabled=busy
+    for(const el of [zoom,dialog.querySelector('[data-crop-save]'),dialog.querySelector('[data-crop-center]')])el.disabled=busy||!bitmap
+    dialog.querySelector('[data-crop-file]').disabled=busy||!ready
+    dialog.querySelector('[data-crop-reset]').disabled=busy||!hasCustom
+  }
+  const end=()=>{if(drag&&canvas.hasPointerCapture(drag.id))canvas.releasePointerCapture(drag.id);drag=null}
+  canvas.addEventListener('pointerdown',e=>{
+    if(busy||!bitmap||e.button!==0||!e.isPrimary)return
+    drag={id:e.pointerId,x:e.clientX,y:e.clientY,crop:{...crop}}
+    canvas.setPointerCapture(e.pointerId);e.preventDefault()
+  })
+  canvas.addEventListener('pointermove',e=>{
+    if(!drag||e.pointerId!==drag.id)return
+    const scale=Math.max(bitmap.width,bitmap.height)/288*320/canvas.getBoundingClientRect().width
+    crop.x=drag.crop.x+(e.clientX-drag.x)*scale/bitmap.width
+    crop.y=drag.crop.y+(e.clientY-drag.y)*scale/bitmap.height
+    draw();e.preventDefault()
+  })
+  canvas.addEventListener('pointerup',end)
+  canvas.addEventListener('pointercancel',()=>{if(drag)crop=drag.crop;end();draw()})
+  canvas.addEventListener('keydown',e=>{
+    if(busy||!bitmap||!['ArrowLeft','ArrowRight','ArrowUp','ArrowDown'].includes(e.key))return
+    e.preventDefault();const step=(e.shiftKey?10:2)*Math.max(bitmap.width,bitmap.height)/288
+    if(e.key==='ArrowLeft')crop.x-=step/bitmap.width
+    if(e.key==='ArrowRight')crop.x+=step/bitmap.width
+    if(e.key==='ArrowUp')crop.y-=step/bitmap.height
+    if(e.key==='ArrowDown')crop.y+=step/bitmap.height
+    draw()
+  })
+  canvas.addEventListener('wheel',e=>{
+    e.preventDefault()
+    if(busy||!bitmap)return
+    end()
+    const delta=e.deltaY*(e.deltaMode===1?16:e.deltaMode===2?canvas.clientHeight:1)
+    crop.zoom=Math.max(1,Math.min(4,crop.zoom*Math.exp(-delta*(e.ctrlKey ? .01 : .002))))
+    draw()
+  },{passive:false})
+  zoom.addEventListener('input',()=>{end();crop.zoom=Number(zoom.value);draw()})
+  dialog.querySelector('[data-crop-center]').addEventListener('click',()=>{end();crop={zoom:1,x:.5,y:.5};zoom.value='1';draw()})
+  dialog.querySelector('[data-crop-cancel]').addEventListener('click',close)
+  dialog.addEventListener('cancel',e=>{e.preventDefault();e.stopPropagation();if(!busy)close()})
+  dialog.addEventListener('keydown',e=>{if(e.key==='Escape')e.stopPropagation()})
+  dialog.querySelector('[data-crop-save]').addEventListener('click',async()=>{
+    if(busy||!bitmap)return
+    end();busy=true;controls();status.textContent='正在保存…'
+    try{await onSave(role,original,{...crop},revision);if(!disposed)close()}
+    catch(error){if(!disposed)status.textContent=error.message}
+    finally{busy=false;if(!disposed)controls()}
+  })
+  const setImage=async(file,initial={zoom:1,x:.5,y:.5})=>{
+    if(file.size>5*1024*1024)throw Error('请选择不超过 5 MB 的图片')
+    const ticket=generation
+    const next=await window.createImageBitmap(file,{imageOrientation:'from-image'})
+    try{
+      if(next.width*next.height>25000000)throw Error('图片不能超过 2500 万像素')
+      const data=await new Promise((resolve,reject)=>{
+        const reader=new window.FileReader();reader.onload=()=>resolve(String(reader.result).split(',')[1])
+        reader.onerror=()=>reject(Error('无法读取图片'));reader.readAsDataURL(file)
+      })
+      if(disposed||ticket!==generation){next.close();return}
+      clean();bitmap=next;original=data;crop={...initial};draw()
+    }catch(error){next.close();throw error}
+  }
+  dialog.querySelector('[data-crop-file]').addEventListener('change',async e=>{
+    const file=e.target.files?.[0];e.target.value=''
+    if(!file||busy)return
+    busy=true;controls();status.textContent='正在读取图片…'
+    try{await setImage(file);status.textContent=''}
+    catch{status.textContent='图片无法读取，请选择不超过 5 MB、2500 万像素的图片'}
+    finally{busy=false;controls()}
+  })
+  dialog.querySelector('[data-crop-reset]').addEventListener('click',async()=>{
+    if(busy||!hasCustom||!window.confirm('恢复默认头像将移除当前图片及裁剪设置，是否继续？'))return
+    busy=true;controls()
+    try{await onSave(role,null,undefined,revision);if(!disposed)close()}
+    catch(error){status.textContent=error.message}
+    finally{busy=false;controls()}
+  })
+  return{
+    async open(target){
+      const ticket=++generation
+      clean();role=target;ready=false;hasCustom=false;crop={zoom:1,x:.5,y:.5};busy=true
+      previousFocus=panel.ownerDocument.activeElement
+      dialog.querySelector('strong').textContent=target==='user'?'用户头像':'AI 头像'
+      draw();controls();status.textContent='正在读取头像…';dialog.showModal()
+      try{
+        const value=await load(target)
+        if(disposed||ticket!==generation)return
+        revision=value.revision;ready=true;hasCustom=Boolean(value.image)
+        if(value.image){
+          const bytes=Uint8Array.from(window.atob(value.image),c=>c.charCodeAt(0))
+          await setImage(new window.Blob([bytes]),value.crop)
+        }
+        if(ticket===generation)status.textContent=hasCustom?'可直接继续调整裁剪范围':'上传图片以设置头像，支持 PNG、JPEG、WebP、GIF、AVIF，最大 5 MB。'
+      }catch(error){if(ticket===generation)status.textContent=error.message}
+      finally{if(ticket===generation){busy=false;controls();canvas.focus()}}
+    },
+    close,
+    dispose(){disposed=true;close();dialog.remove()},
+  }
+}

package/src/client/conversation-control-adapter.js

@@ -14,9 +14,19 @@ function closestWithClassSuffix(node, suffix) {
 function classify(button, operation) {
   // The host's process disclosure owns its transparent, full-width hit area.
   if (button.hasAttribute('data-turn-process')) return null
+  // Changed-file cards own one outer surface; their header and rows stay native.
+  if (button.closest('[data-changed-files]')) return null
+  // File previews are transparent hit targets; the enclosing card owns its material and outline.
+  if (button.closest('[data-presented-file]') && hasClassSuffix(button, '_cardPreview')) return null
   if (button.tagName !== 'BUTTON' || !operation.contains(button)) return null
   if (hasClassSuffix(button, '_sessionLogButton')) return 'header'
-  if (button.closest('[data-produced-files-row]') || hasClassSuffix(button, '_showFolder')) return 'utility'
+  const tokens=[...(button.classList ?? [])]
+  const fileLink=tokens.some(token=>/(?:^|_)file(?:Link|Mention)(?:_|$)/.test(token))
+  const fileChange=hasClassSuffix(button,'_header')
+    && [...button.children].some(node=>hasClassSuffix(node,'_tile'))
+    && [...button.children].some(node=>hasClassSuffix(node,'_titles'))
+  if (fileLink || fileChange || button.closest('[data-produced-files-row]')) return 'file'
+  if (hasClassSuffix(button, '_showFolder')) return 'utility'
   if (closestWithClassSuffix(button, '_older')) return 'utility'
   if (hasClassSuffix(button, '_inspectButton')) return 'inspect'
 

package/src/client/cursor-adapter.js

@@ -88,8 +88,18 @@ export function createCursorAdapter({ document, window, assets }) {
   let originalCursor
   let originalPriority
   let appliedCursor
+  let appliedPriority
+  function ownsHandCursor() {
+    return handTarget?.style.cursor === appliedCursor
+      && handTarget.style.getPropertyPriority('cursor') === appliedPriority
+  }
+  function stopIfHandChanged() {
+    if (!handTarget || ownsHandCursor()) return false
+    reset()
+    return true
+  }
   function restoreHandTarget() {
-    if (handTarget && handTarget.style.cursor === appliedCursor) {
+    if (handTarget && ownsHandCursor()) {
       if (originalCursor) handTarget.style.setProperty('cursor', originalCursor, originalPriority)
       else handTarget.style.removeProperty('cursor')
     }
@@ -103,6 +113,7 @@ export function createCursorAdapter({ document, window, assets }) {
     return target && target.getElementsByTagName('*').length <= maxAnimatedDescendants
   }
   function followHand(target) {
+    if (stopIfHandChanged()) return
     if (target === handTarget && target !== textTarget) return
     restoreHandTarget()
     if (!canAnimate(target) || !handCursor || target === textTarget) return
@@ -111,13 +122,16 @@ export function createCursorAdapter({ document, window, assets }) {
     handTarget = target
     originalCursor = target.style.getPropertyValue('cursor')
     originalPriority = target.style.getPropertyPriority('cursor')
+    appliedCursor = originalCursor
+    appliedPriority = originalPriority
     target.setAttribute('data-prts-hand-active', '')
     applyHandFrame()
   }
   function applyHandFrame() {
-    if (!handTarget) return
+    if (stopIfHandChanged() || !handTarget) return
     handTarget.style.setProperty('cursor', handCursor)
     appliedCursor = handTarget.style.cursor
+    appliedPriority = handTarget.style.getPropertyPriority('cursor')
   }
   function clearTimer() {
     if (timer !== undefined) window.clearTimeout(timer)
@@ -144,10 +158,12 @@ export function createCursorAdapter({ document, window, assets }) {
     let index = 0
     function next() {
       timer = undefined
+      if (stopIfHandChanged()) return
       // The source ANI ends with a 60-second hold frame. Use the static state instead.
       if (index >= frames.length - 1) { done(); return }
       const frame = frames[index++]
       show(frame.url)
+      if (!handCursor) return
       timer = window.setTimeout(next, frame.duration)
     }
     next()
@@ -179,6 +195,7 @@ export function createCursorAdapter({ document, window, assets }) {
     play(gestureAssets.release, reset)
   }
   function up(event) {
+    if (stopIfHandChanged()) return
     if (pointerId === undefined || event.pointerId !== pointerId || event.button !== 0) return
     pointerId = undefined
     if (reduced()) { reset(); return }

package/src/client/custom-avatar.js

@@ -0,0 +1,91 @@
+import { mountAvatarCrop } from './avatar-crop.js'
+const API='/prts-theme-api/avatars'
+const roles=['user','assistant']
+export function createAvatarStore({window,document}){
+  let state={revision:-1,user:null,assistant:null},disposed=false,events,refreshing
+  const listeners=new Set()
+  const controller=window.AbortController?new window.AbortController():null
+  const apply=value=>{
+    if(disposed||value.revision<state.revision)return
+    state=value
+    for(const role of roles){
+      const image=state[role]
+      const safe=typeof image==='string'&&/^data:image\/png;base64,[A-Za-z0-9+/=]+$/.test(image)
+      const property=`--prts-custom-${role}-avatar`
+      if(safe)document.documentElement.style.setProperty(property,`url("${image}")`)
+      else document.documentElement.style.removeProperty(property)
+    }
+    document.documentElement.style.setProperty('--prts-user-avatar-label',state.user?'""':'"我"')
+    for(const fn of listeners)fn(state)
+  }
+  const request=async(data)=>{
+    const response=await window.fetch(API+'/configuration',{credentials:'same-origin',signal:controller?.signal,
+      ...(data===undefined?{}:{method:'POST',headers:{'content-type':'application/json','x-prts-request':'1'},body:JSON.stringify(data)})})
+    const value=await response.json()
+    if(!response.ok)throw Error(value.error||'头像服务暂不可用')
+    apply(value);return state
+  }
+  const refresh=()=>refreshing??(refreshing=request().finally(()=>{refreshing=null}))
+  if(window.fetch){
+    void refresh().catch(()=>{}).then(()=>{
+      if(disposed||!window.EventSource)return
+      events=new window.EventSource(API+'/events')
+      events.onmessage=event=>{
+        try{
+          const revision=JSON.parse(event.data).revision
+          if(revision>state.revision)void refresh().then(()=>{
+            if(!disposed&&revision>state.revision)return refresh()
+          }).catch(()=>{})
+        }catch{}
+      }
+    })
+  }
+  const focus=()=>{if(window.fetch)void refresh().catch(()=>{})}
+  window.addEventListener('focus',focus)
+  return{
+    snapshot:()=>state,refresh,
+    subscribe(fn){listeners.add(fn);fn(state);return()=>listeners.delete(fn)},
+    async edit(role){
+      const response=await window.fetch(API+'/edit/'+role,{credentials:'same-origin',signal:controller?.signal})
+      const value=await response.json()
+      if(!response.ok)throw Error(value.error||'无法读取头像')
+      return value
+    },
+    async save(role,image,crop,revision=state.revision){
+      try{return await request({role,image,crop,revision})}
+      catch(error){await refresh().catch(()=>{});throw error}
+    },
+    dispose(){
+      disposed=true;controller?.abort();events?.close();listeners.clear();window.removeEventListener('focus',focus)
+      for(const role of roles)document.documentElement.style.removeProperty(`--prts-custom-${role}-avatar`)
+      document.documentElement.style.removeProperty('--prts-user-avatar-label')
+    },
+  }
+}
+
+export function avatarMarkup(){
+  return `<section data-prts-avatars hidden>
+    <header><strong>Baker 头像</strong><small>点击头像调整图片与裁剪范围，所有会话共用。</small></header>
+    <div data-prts-avatar-choices>${roles.map(role=>`<div data-prts-avatar-row="${role}">
+      <button type="button" data-prts-avatar-preview="${role}" aria-label="设置${role==='user'?'用户':'AI'}头像"></button>
+      <span><strong>${role==='user'?'用户头像':'AI 头像'}</strong><small>点击编辑</small></span>
+    </div>`).join('')}</div>
+    <p data-prts-avatar-status role="status">保存在当前 DSH 实例，自动同步至其他设备。</p>
+  </section>`
+}
+export function mountAvatarSettings({panel,window,store}){
+  const section=panel.querySelector('[data-prts-avatars]')
+  if(!section||!store)return{dispose(){}}
+  const status=section.querySelector('[data-prts-avatar-status]')
+  let disposed=false
+  const cropEditor=mountAvatarCrop({panel,window,load:role=>store.edit(role),onSave:async(role,image,crop,revision)=>{
+    await store.save(role,image,crop,revision)
+    if(!disposed)status.textContent='头像已保存，已应用到所有会话'
+  }})
+  const click=event=>{
+    const button=event.target.closest('[data-prts-avatar-preview]')
+    if(button)void cropEditor.open(button.dataset.prtsAvatarPreview)
+  }
+  section.addEventListener('click',click)
+  return{close:()=>cropEditor.close(),dispose(){disposed=true;cropEditor.dispose();section.removeEventListener('click',click)}}
+}

package/src/client/custom-emblem.js

@@ -245,7 +245,7 @@ export function customEmblemMarkup() {
   return `<section data-prts-custom-emblem>
     <header><strong>徽记管理</strong><small>新会话与正文分别设置，可在任意会话中让 AI 调整，设置在当前 DSH 实例共享</small></header>
     <div data-prts-emblem-hero-panel><h4>新会话徽记</h4><div data-prts-emblem-hero-row></div></div>
-    <div><h4>正文轮换徽记</h4><small>按列表顺序随正文滚动轮换，可混合使用内置与上传的图片，最多 12 张。长按徽记选项任意位置拖动排序，松开保存。</small>
+    <div><h4>正文轮换徽记</h4><small data-prts-emblem-baker-note hidden>Baker 会话正文不显示或运行粒子徽记；下列配置保留供经典主题使用，新会话徽记不受影响。</small><small>按列表顺序随正文滚动轮换，可混合使用内置与上传的图片，最多 12 张。长按徽记选项任意位置拖动排序，松开保存。</small>
       <ol data-prts-emblem-list></ol>
       <div data-prts-emblem-actions><button type="button" data-prts-emblem-add>新增徽记</button><button type="button" data-prts-emblem-reset-list>恢复内置列表</button></div>
     </div>

package/src/client/index.js

@@ -1,3 +1,4 @@
+import { createAvatarStore } from './custom-avatar.js'
 import { registerEmblemToolPreview } from './emblem-tool-preview.js'
 import { createCustomEmblemStore } from './custom-emblem.js'
 import { DEFAULT_PREFERENCES, isSafeMode, loadPreferences, persistPreferences, resetPreferenceGroup, updatePreferenceValue } from './preferences.js'
@@ -64,6 +65,7 @@ export function applyPrtsPlugin(ctx, environment) {
       sync()
     },
   })
+  const avatarStore = createAvatarStore({window,document})
   const customEmblemStore = createCustomEmblemStore({ window, emblems: assets.emblems, preview: entry => particleField.previewEmblem?.(entry), onChange: value => particleField.setCustomEmblemConfiguration?.(value) })
   const startup = createPrtsStartupSequence({
     document,
@@ -191,7 +193,7 @@ export function applyPrtsPlugin(ctx, environment) {
     }
     if (!themeAlreadyApplied) theme.apply(preferences)
     operations ||= createOperationsShell({
-      document, window, assets, adapter, hostGeometry, customEmblemStore,
+      document, window, assets, adapter, hostGeometry, customEmblemStore, avatarStore,
       onSchemeToggle(next, interaction) {
         return theme.setTheme(next, { ...interaction, animate: true })
       },
@@ -250,7 +252,7 @@ export function applyPrtsPlugin(ctx, environment) {
     }
     particleField.update(preferences)
     composerGlass.start()
-    if (preferences.conversationStyle === 'deck-chat') assistantGlass.start()
+    if (preferences.conversationStyle === 'deck-chat') assistantGlass.start({ groupAvatars: preferences.bakerGroupAvatars })
     else assistantGlass.dispose()
     toBottom.start()
     conversationControls.start()
@@ -346,6 +348,7 @@ export function applyPrtsPlugin(ctx, environment) {
     if (typeof stopEmblemPreview === 'function') stopEmblemPreview()
     statusSource.dispose()
     customEmblemStore.dispose()
+    avatarStore.dispose()
     particleField.dispose()
     startup.dispose({ restoreFocus: false })
     stopStartupReadyWatch()

package/src/client/operations-shell-v2.js

@@ -45,7 +45,7 @@ export function createOperationsShell({
   onSchemeToggle = () => {},
   onSchemeDragStart = () => undefined,
   onThemeDisable = () => {},
-  customEmblemStore,
+  customEmblemStore, avatarStore,
   onPreferenceChange = () => {},
   onPreferencePreview = () => {},
   onVisualReset = () => {},
@@ -455,7 +455,7 @@ export function createOperationsShell({
       trigger: shell.querySelector('[data-prts-rail-brand]'),
       panel: shell.querySelector('[data-prts-theme-settings]'),
       backdrop: shell.querySelector('[data-prts-settings-backdrop]'),
-      customEmblemStore,
+      customEmblemStore, avatarStore,
       onPreferenceChange,
       onPreferencePreview,
       onResetVisual: onVisualReset,

package/src/client/particle-field-adapter.js

@@ -431,7 +431,8 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
     : preferences.conversationParticleDensity
   const densityProfile = density => PARTICLE_DENSITY_PROFILES[density] ?? PARTICLE_DENSITY_PROFILES.standard
   const particleRadius = density => densityProfile(density ?? activeDensity()).radius
-  const canRenderFrame = () => !disposed && documentVisible && canvasVisible && !hydrationPaused && !startupPaused && !schemeTransitionPaused && !resizing
+  const fieldEnabled = () => heroActive || (preferences.conversationStyle !== 'deck-chat' && preferences.conversationEmblem !== false)
+  const canRenderFrame = () => fieldEnabled() && !disposed && documentVisible && canvasVisible && !hydrationPaused && !startupPaused && !schemeTransitionPaused && !resizing
   const layoutWidth = () => width
   const layoutHeight = () => height
   const layoutShiftX = () => 0
@@ -496,7 +497,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function populationSource(density = activeDensity()) {
-    return heroActive ? targetsForHero(density) : targetsForSegment(segment, density)
+    return !fieldEnabled() ? [] : heroActive ? targetsForHero(density) : targetsForSegment(segment, density)
   }
 
   function targetParticleCount(density = activeDensity()) {
@@ -697,7 +698,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
 
   function scheduleTargetPrewarm() {
     cancelTargetPrewarm()
-    if (typeof window.requestIdleCallback !== 'function' || !particles.length) return
+    if (preferences.conversationEmblem === false || preferences.conversationStyle === 'deck-chat' || !fieldEnabled() || typeof window.requestIdleCallback !== 'function' || !particles.length) return
     targetPrewarmQueue = (customEmblemConfiguration?.conversation ?? emblemSequence).map((_, index) => index)
       .filter(index => index !== sequenceIndexForSegment(segment))
     const warmNext = () => {
@@ -718,6 +719,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function buildParticles() {
+    if (!fieldEnabled()) { particles = []; cancelTargetPrewarm(); return false }
     if (startupPaused) return false
     const selected = populationSource()
     if (!selected.length) {
@@ -796,6 +798,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function startDensityReassembly(nextCount, force = false) {
+    if (!fieldEnabled()) return
     const baseNextTargets = populationSource()
     const targetCount = baseNextTargets.length
     if (!targetCount) {
@@ -921,6 +924,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function commitTransitionTargets(targetSegment, snap = false, density = preferences.conversationParticleDensity) {
+    if (!fieldEnabled()) return
     const selected = targetsForSegment(targetSegment, density)
     if (!selected.length) return
     segment = targetSegment
@@ -1507,7 +1511,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
     heroActive = true
     scroller?.setAttribute('data-prts-hero-active', '')
     resetTraversal()
-    scheduleFrame()
+    updateFrameGate()
   }
 
   function leaveHero() {
@@ -1516,6 +1520,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
     heroMarker = undefined
     heroActive = false
     scroller?.removeAttribute('data-prts-hero-active')
+    if (!fieldEnabled()) { resetTraversal(); updateFrameGate(); return }
     side = -1
     segment = 0
     traversalOffset = -currentScrollTop() * particleTraversalSpeed() / traversalViewport()
@@ -1558,7 +1563,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
     if (heroActive) leaveHero()
   }
   function onScroll() {
-    if (!scroller || phoneStatic()) return
+    if (!fieldEnabled() || !scroller || phoneStatic()) return
     if (heroActive) {
       scheduleFrame()
       return
@@ -1570,7 +1575,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function onPointerMove(event) {
-    if (!operation || transition || motionReduced() || phoneStatic()) return
+    if (!fieldEnabled() || !operation || transition || motionReduced() || phoneStatic()) return
     pointerClientX = event.clientX
     pointerClientY = event.clientY
     pointerActive = true
@@ -1607,7 +1612,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function registerContentMutations(mutations) {
-    if (phoneStatic()) return
+    if (!fieldEnabled() || phoneStatic()) return
     let weight = mutations.length
     for (const mutation of mutations) {
       for (const node of [...mutation.addedNodes, ...mutation.removedNodes]) {
@@ -1652,6 +1657,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
   }
 
   function updateFrameGate() {
+    if (canvas) canvas.hidden = !fieldEnabled()
     const now = Number(window.performance?.now?.()) || 0
     if (!canRenderFrame()) {
       pauseStartedAt ??= now
@@ -1741,7 +1747,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
       if (!phoneStatic()) restoreTraversalFromScroll()
       commitTransitionTargets(segment, true)
     }
-    scheduleFrame()
+    updateFrameGate()
   }
 
   function mount(nextOperation, nextScroller) {
@@ -1768,6 +1774,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
     targetCache.clear()
     initializeFieldSize()
     syncHeroState()
+    canvas.hidden = !fieldEnabled()
     if (!heroActive) restoreTraversalFromScroll()
     if (!particles.length && maskRecords.length) buildParticles()
     if (context && particles.length) {
@@ -1880,6 +1887,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
       }
 
       findMount()
+      if (!fieldEnabled()) resetTraversal()
       const previousActiveDensity = heroActive
         ? previousPreferences.heroParticleDensity
         : previousPreferences.conversationParticleDensity
@@ -1914,10 +1922,11 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
         }
       }
       if (ambient) ambient.hidden = preferences.texture === 'off' && preferences.conversationStyle !== 'deck-chat'
-      scheduleFrame()
+      updateFrameGate()
     },
     inspect() {
       return {
+        enabled: fieldEnabled(),
         mounted: Boolean(ambient?.isConnected && canvas?.isConnected),
         hero: heroActive,
         side,