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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ash-qw/dsh-theme-prts",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "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/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,17 @@ 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
+  // 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/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/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 })
       },
@@ -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/theme-settings-workbench.js

@@ -1,3 +1,4 @@
+import { avatarMarkup, mountAvatarSettings } from './custom-avatar.js'
 import { customEmblemMarkup, mountCustomEmblemEditor } from './custom-emblem.js'
 import { PARTICLE_TRAVERSAL_SPEED_DEFAULT, PARTICLE_TRAVERSAL_SPEED_MAX, PARTICLE_TRAVERSAL_SPEED_MIN, PARTICLE_TRAVERSAL_SPEED_STEP, SESSION_FLOW_SPEED_DEFAULT, SESSION_FLOW_SPEED_MAX, SESSION_FLOW_SPEED_MIN, SESSION_FLOW_SPEED_STEP, resolveParticleDetail } from './preferences.js'
 
@@ -156,9 +157,16 @@ export function themeSettingsMarkup() {
             <header><span><strong>界面外观</strong></span></header>
             <div data-prts-settings-common-grid>
               ${COMMON_CONTROLS.filter(([key]) => ['texture', 'glass'].includes(key)).map(([key, label, options]) => settingButtons(key, label, options)).join('')}
-              ${settingButtons('conversationStyle', '会话主题', [['native', '原有'], ['deck-chat', '通讯链路']])}
             </div>
           </section>
+          <section data-prts-conversation-settings>
+            <header><strong>会话主题</strong><small>选择消息的呈现方式</small></header>
+            <div data-prts-conversation-cards>
+              <button type="button" data-prts-setting-key="conversationStyle" data-prts-setting-value="native" aria-pressed="false"><span data-prts-conversation-sample="classic" aria-hidden="true"><i></i><i></i></span><strong>经典</strong><small>简洁正文，保留熟悉的阅读布局</small></button>
+              <button type="button" data-prts-setting-key="conversationStyle" data-prts-setting-value="deck-chat" aria-pressed="false"><span data-prts-conversation-sample="baker" aria-hidden="true"><i></i><i></i></span><strong>Baker</strong><small>终末地通讯风格，圆形头像与消息气泡</small></button>
+            </div>
+            ${avatarMarkup()}
+          </section>
           </section>
           <section data-prts-settings-common data-prts-settings-section="interaction" role="tabpanel" id="prts-page-interaction" aria-labelledby="prts-tab-interaction" tabindex="0" hidden>
             <header data-prts-section-heading><strong>交互</strong><small>光标、导航栏与动态反馈</small></header>
@@ -207,7 +215,7 @@ export function createThemeSettingsOverlay({
   trigger,
   panel,
   backdrop,
-  customEmblemStore,
+  customEmblemStore, avatarStore,
   onOpen = () => {},
   onPreferenceChange = () => {},
   onPreferencePreview = () => {},
@@ -215,6 +223,7 @@ export function createThemeSettingsOverlay({
   onRetrySave = () => {},
 }) {
   const window = document?.defaultView
+  const avatarEditor = mountAvatarSettings({panel,window,store:avatarStore})
   const customEditor = mountCustomEmblemEditor({ panel, window, store: customEmblemStore })
   const transparencyMedia = window?.matchMedia?.('(prefers-reduced-transparency: reduce)')
   const motionMedia = window?.matchMedia?.('(prefers-reduced-motion: reduce)')
@@ -294,6 +303,7 @@ export function createThemeSettingsOverlay({
       ;(panel.querySelector('[data-prts-theme-settings-close]') ?? focusable()[0] ?? panel).focus?.()
     } else {
       customEditor.close?.()
+      avatarEditor.close?.()
       panel.removeAttribute('data-prts-settings-visible')
       hidePanel()
       setResetConfirmation(false)
@@ -678,6 +688,7 @@ export function createThemeSettingsOverlay({
 
   return {
     update(preferences, status, persistenceState = currentPersistence) {
+      panel.querySelector('[data-prts-avatars]').hidden = preferences?.conversationStyle !== 'deck-chat'
       currentPreferences = preferences
       currentStatus = status
       currentPersistence = persistenceState ?? { phase: 'idle', revision: 0 }
@@ -693,6 +704,7 @@ export function createThemeSettingsOverlay({
     toggle,
     dispose() {
       customEditor.dispose()
+      avatarEditor.dispose()
       isOpen = false
       hidePanel()
       if (savedTimer !== undefined) window?.clearTimeout?.(savedTimer)

package/src/index.js

@@ -1,6 +1,8 @@
+import { createAvatarService, registerAvatarApi } from './server/avatars.js'
 import { join } from 'node:path'
 import { homedir } from 'node:os'
 import { createEmblemService } from './server/emblems.js'
+import { avatarTools } from './server/avatar-tools.js'
 import { emblemTools } from './server/tools.js'
 import { registerEmblemApi } from './server/api.js'
 export const PACKAGE_ID = '@ash-qw/dsh-theme-prts'
@@ -10,7 +12,8 @@ export const inject = ['tools', 'attachments', 'connection', 'webServer']
 export async function apply(ctx) {
   const directory=join(process.env.DSH_HOME?.trim() || join(homedir(),'.dsh'),'plugins','dsh-theme-prts','emblems')
   const service=await createEmblemService(directory)
-  const disposers=emblemTools(service,ctx.attachments).map(tool=>ctx.tools.register(tool))
-  disposers.push(registerEmblemApi(ctx,service))
-  ctx.on('dispose',async()=>{for(const dispose of disposers.reverse())dispose();await service.dispose()})
+  const avatars=await createAvatarService(join(directory,'..','avatars'))
+  const disposers=[...emblemTools(service,ctx.attachments),...avatarTools(avatars,ctx.attachments)].map(tool=>ctx.tools.register(tool))
+  disposers.push(registerEmblemApi(ctx,service),registerAvatarApi(ctx,avatars))
+  ctx.effect(()=>async()=>{for(const dispose of disposers.reverse())dispose();await service.dispose()})
 }

package/src/server/api.js

@@ -1,16 +1,22 @@
 import { API, draftView, fault } from './emblems.js'
 
-async function body(req) {
+// Avoid repeated groups: multi-megabyte images can exhaust V8's regexp stack.
+export function isBase64(value){return typeof value==='string'&&value.length%4===0&&/^[A-Za-z0-9+/]*={0,2}$/.test(value)}
+
+export async function body(req) {
   const chunks=[];let size=0
   for await(const chunk of req){size+=chunk.length;if(size>16*1024*1024)throw fault(413,'请求过大');chunks.push(chunk)}
   try{return JSON.parse(Buffer.concat(chunks).toString('utf8'))}catch{throw fault(400,'请求数据无效')}
 }
-function json(res,status,value){res.writeHead(status,{'content-type':'application/json; charset=utf-8','cache-control':'no-store'});res.end(JSON.stringify(value))}
+export function json(res,status,value){res.writeHead(status,{'content-type':'application/json; charset=utf-8','cache-control':'no-store'});res.end(JSON.stringify(value))}
 export function registerEmblemApi(ctx,service) {
+  const connection=ctx.connection
+  let disposed=false
   const streams=new Set()
   const dispose=ctx.webServer.register({kind:'prefix',path:API,handler:async(req,res)=>{
     try {
-      const admission=ctx.connection.admit(req)
+      if(disposed){json(res,503,{error:'主题服务正在重新加载，请稍后重试'});return}
+      const admission=connection.admit(req)
       if('rejection' in admission){json(res,401,{error:'请先登录 DSH'});return}
       const path=new URL(req.url,'http://localhost').pathname.slice(API.length)
       if(req.method==='GET'&&path==='/events') {
@@ -43,12 +49,12 @@ export function registerEmblemApi(ctx,service) {
         json(res,200,{...draftView(d),value:d.value,previewPoints:d.previewPoints});return
       }
       if(path==='/preview'){
-        if(data.image && (typeof data.image!=='string'||! /^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(data.image)))throw fault(400,'图片编码无效')
+        if(data.image && !isBase64(data.image))throw fault(400,'图片编码无效')
         const d=await service.preview({bytes:data.image?Buffer.from(data.image,'base64'):undefined,baseId:data.draftId,params:data.params,label:data.label},controller.signal)
         json(res,200,{...draftView(d),value:d.value,previewPoints:d.previewPoints});return
       }
       throw fault(404,'接口不存在')
     }catch(error){if(!res.headersSent)json(res,error.status||500,{error:error.message});else res.end()}
   }})
-  return()=>{dispose();for(const res of streams)res.end();streams.clear()}
+  return()=>{disposed=true;dispose();for(const res of streams)res.end();streams.clear()}
 }

package/src/server/avatar-tools.js

@@ -0,0 +1,67 @@
+import sharp from 'sharp'
+import { sessionImages } from './tools.js'
+import { fault } from './emblems.js'
+
+const limit=5*1024*1024
+const cropSchema={type:'object',additionalProperties:false,properties:{
+  zoom:{type:'number',minimum:1,maximum:4},x:{type:'number',minimum:0,maximum:1},y:{type:'number',minimum:0,maximum:1},
+},required:['zoom','x','y']}
+const view=state=>({revision:state.revision,user:{custom:Boolean(state.user)},assistant:{custom:Boolean(state.assistant)}})
+export function avatarTools(service,attachments){
+  const output={schema:{type:'object'},render:(_args,value)=>[{type:'text',text:JSON.stringify(value)}]}
+  return [{
+    name:'prts_avatar_inspect',
+    description:'查看 PRTS 主题 Baker 会话头像的配置版本、用户和 AI 头像的原图尺寸与裁剪参数，以及当前会话上传或工具返回的图片。头像在同一 DSH 实例的所有会话中共享，仅在 Baker 样式下显示；此工具不修改设置。AI 生成或编辑的本地图片先用 read_image 读取，再调用本工具获取 attachmentId。',
+    parameters:{type:'object',properties:{},additionalProperties:false},output,isConcurrencySafe:()=>true,
+    async execute(_args,exec){
+      const images=sessionImages(exec.agent),state=service.snapshot(),result=view(state)
+      // Capture both sources before awaiting so metadata and revision describe one snapshot.
+      const originals=['user','assistant'].map(role=>[role,service.edit(role)])
+      for(const [role,source] of originals){
+        if(!source.image)continue
+        const meta=await sharp(Buffer.from(source.image,'base64'),{limitInputPixels:25000000,animated:false}).metadata()
+        const swapped=[5,6,7,8].includes(meta.orientation)
+        result[role]={custom:true,width:swapped?meta.height:meta.width,height:swapped?meta.width:meta.height,crop:source.crop}
+      }
+      return {...result,images}
+    },
+  },{
+    name:'prts_avatar_apply',
+    description:'按用户要求修改 Baker 头像。role=user 为用户头像，assistant 为 AI 头像。action=replace 使用当前会话的 attachmentId 替换图片；recrop 使用服务器当前原图重新裁剪；reset 恢复默认并删除自定义原图。crop 的 x/y 是相对于按 EXIF 转正后原图宽高的裁剪中心（0..1），zoom=1..4，默认居中且 zoom=1；圆形裁剪直径为原图短边除以 zoom，越界会被限制。先 inspect 获取 revision，冲突时重新检查，勿盲目覆盖。修改立即影响同一实例所有会话；保存替换后旧原图不保留。单图最大 5 MB、2500 万像素。工具不会切换用户本机的会话主题。',
+    parameters:{type:'object',additionalProperties:false,properties:{
+      role:{type:'string',enum:['user','assistant']},action:{type:'string',enum:['replace','recrop','reset']},
+      attachmentId:{type:'string'},crop:cropSchema,revision:{type:'integer',minimum:0},
+    },required:['role','action','revision']},output,isConcurrencySafe:()=>false,
+    async execute(args,exec){
+      const images=sessionImages(exec.agent)
+      if(!['user','assistant'].includes(args.role)||!['replace','recrop','reset'].includes(args.action))throw fault(400,'头像类型或操作无效')
+      if(args.revision!==service.snapshot().revision)throw fault(409,'头像已更新，请重新检查配置')
+      if(args.action!=='replace'&&args.attachmentId)throw fault(400,'仅替换头像时可以指定图片')
+      if(args.action==='reset'&&args.crop)throw fault(400,'恢复默认时不需要裁剪参数')
+      let image=null
+      if(args.action==='replace'){
+        const ref=images.find(image=>image.attachmentId===args.attachmentId)
+        if(!ref)throw fault(404,'当前会话没有这张图片，请先上传或用 read_image 读取图片，再 inspect')
+        if(ref.bytes>limit)throw fault(400,'图片超过 5 MB')
+        const {attachmentKind,origin,toolName,...attachment}=ref
+        let bytes
+        if(attachmentKind==='file'){
+          const chunks=[];let size=0
+          for await(const chunk of attachments.readFileStream(attachment,exec.signal)){
+            size+=chunk.length;if(size>limit)throw fault(400,'图片超过 5 MB');chunks.push(chunk)
+          }
+          bytes=Buffer.concat(chunks)
+        }else bytes=(await attachments.readImage(attachment,exec.signal)).data
+        if(bytes.length>limit)throw fault(400,'图片超过 5 MB')
+        image=Buffer.from(bytes).toString('base64')
+      }else if(args.action==='recrop'){
+        image=service.edit(args.role).image
+        if(!image)throw fault(400,'尚未设置自定义头像，请先替换图片')
+        if(!args.crop)throw fault(400,'请提供新的裁剪参数')
+      }
+      exec.signal?.throwIfAborted()
+      const state=await service.save({role:args.role,image,crop:args.crop,revision:args.revision})
+      return {applied:true,...view(state)}
+    },
+  }]
+}

package/src/server/avatars.js

@@ -0,0 +1,93 @@
+import { mkdir, readFile, writeFile, rename, rm } from 'node:fs/promises'
+import { join } from 'node:path'
+import { randomUUID } from 'node:crypto'
+import sharp from 'sharp'
+import { fault } from './emblems.js'
+import { body, json, isBase64 } from './api.js'
+
+export const AVATAR_API = '/prts-theme-api/avatars'
+export async function createAvatarService(directory) {
+  await mkdir(directory,{recursive:true,mode:0o700})
+  const path=join(directory,'avatars.json')
+  let state={revision:0,user:null,assistant:null}, queue=Promise.resolve()
+  try{state=JSON.parse(await readFile(path,'utf8'))}catch(error){if(error.code!=='ENOENT')throw error}
+  const listeners=new Set()
+  const snapshot=()=>({revision:state.revision,user:state.user,assistant:state.assistant})
+  return {
+    snapshot,
+    edit(role){
+      if(!['user','assistant'].includes(role))throw fault(400,'头像类型无效')
+      return structuredClone({revision:state.revision,image:state.sources?.[role]?.image||state[role]?.split(',')[1]||null,crop:state.sources?.[role]?.crop||{zoom:1,x:.5,y:.5}})
+    },
+    subscribe(fn){listeners.add(fn);return()=>listeners.delete(fn)},
+    save(data){
+      const next=queue.then(async()=>{
+        if(!['user','assistant'].includes(data?.role))throw fault(400,'头像类型无效')
+        if(data.revision!==state.revision)throw fault(409,'头像已在其他页面更新，请重试')
+        let image=null
+        if(data.image!==null){
+          if(typeof data.image!=='string'||data.image.length>8*1024*1024||!isBase64(data.image))throw fault(400,'请上传不超过 5 MB 的图片')
+          const bytes=Buffer.from(data.image,'base64')
+          if(!bytes.length||bytes.length>5*1024*1024)throw fault(400,'请上传不超过 5 MB 的图片')
+          try{
+            const input=sharp(bytes,{limitInputPixels:25000000,animated:false})
+            const meta=await input.metadata()
+            if(!['png','jpeg','webp','gif','avif'].includes(meta.format))throw Error('format')
+            let pipeline=input.rotate()
+            if(data.crop!==undefined){
+              const c=data.crop
+              if(!c||!Number.isFinite(c.zoom)||c.zoom<1||c.zoom>4||!Number.isFinite(c.x)||c.x<0||c.x>1||!Number.isFinite(c.y)||c.y<0||c.y>1)throw Error('crop')
+              const swapped=[5,6,7,8].includes(meta.orientation)
+              const width=swapped?meta.height:meta.width,height=swapped?meta.width:meta.height
+              const size=Math.max(1,Math.round(Math.min(width,height)/c.zoom))
+              const left=Math.max(0,Math.min(width-size,Math.round(c.x*width-size/2)))
+              const top=Math.max(0,Math.min(height-size,Math.round(c.y*height-size/2)))
+              pipeline=pipeline.extract({left,top,width:size,height:size})
+            }
+            const result=await pipeline.resize(256,256,{fit:'cover'}).png().toBuffer()
+            image='data:image/png;base64,'+result.toString('base64')
+          }catch{throw fault(400,'图片无法读取，请使用 PNG、JPEG、WebP、GIF 或 AVIF 图片（不超过 2500 万像素）')}
+        }
+        const updated={...state,revision:state.revision+1,[data.role]:image,sources:{...state.sources,[data.role]:image?{image:data.image,crop:data.crop||{zoom:1,x:.5,y:.5}}:null}}
+        const temp=path+'.'+randomUUID()+'.tmp'
+        // Atomically replace the current records; no source-image history is retained.
+        try{await writeFile(temp,JSON.stringify(updated),{mode:0o600});await rename(temp,path)}
+        finally{await rm(temp,{force:true}).catch(()=>{})}
+        state=updated
+        for(const fn of listeners){try{fn(state.revision)}catch{}}
+        return snapshot()
+      })
+      queue=next.catch(()=>{})
+      return next
+    },
+  }
+}
+
+export function registerAvatarApi(ctx,service){
+  const connection=ctx.connection
+  let disposed=false
+  const streams=new Set()
+  const dispose=ctx.webServer.register({kind:'prefix',path:AVATAR_API,handler:async(req,res)=>{
+    try{
+      if(disposed){json(res,503,{error:'主题服务正在重新加载，请稍后重试'});return}
+      if('rejection' in connection.admit(req)){json(res,401,{error:'请先登录 DSH'});return}
+      const path=new URL(req.url,'http://localhost').pathname.slice(AVATAR_API.length)
+      if(req.method==='GET'&&path==='/events'){
+        res.writeHead(200,{'content-type':'text/event-stream','cache-control':'no-cache','x-accel-buffering':'no'})
+        streams.add(res)
+        const send=revision=>res.write('data: '+JSON.stringify({revision})+'\n\n')
+        const unsubscribe=service.subscribe(send);send(service.snapshot().revision)
+        const timer=setInterval(()=>res.write(': heartbeat\n\n'),25000)
+        res.on('close',()=>{clearInterval(timer);unsubscribe();streams.delete(res)})
+        return
+      }
+      if(req.method==='GET'&&path.startsWith('/edit/')){json(res,200,service.edit(path.slice(6)));return}
+      if(path!=='/configuration')throw fault(404,'接口不存在')
+      if(req.method==='GET'){json(res,200,service.snapshot());return}
+      if(req.method!=='POST')throw fault(404,'接口不存在')
+      if(req.headers['x-prts-request']!=='1')throw fault(403,'缺少请求标识')
+      json(res,200,await service.save(await body(req)))
+    }catch(error){if(!res.headersSent)json(res,error.status||500,{error:error.message});else res.end()}
+  }})
+  return()=>{disposed=true;dispose();for(const res of streams)res.end();streams.clear()}
+}

package/src/server/tools.js

@@ -13,7 +13,7 @@ export function sessionImages(agent) {
     for(const part of message.content ?? []) {
       const ref=part.attachment
       if(!ref || typeof ref.attachmentId!=='string' || !ref.attachmentId)continue
-      if(part.type!=='image' && !(part.type==='file' && (/^image\/(png|jpeg|webp)$/.test(ref.mediaType || '') || /\.(png|jpe?g|webp)$/i.test(ref.name || ''))))continue
+      if(part.type!=='image' && !(part.type==='file' && (/^image\/(png|jpeg|webp|gif|avif)$/.test(ref.mediaType || '') || /\.(png|jpe?g|webp|gif|avif)$/i.test(ref.name || ''))))continue
       if(images.has(ref.attachmentId))continue
       images.set(ref.attachmentId,{...ref,attachmentKind:part.type,origin:uploaded?'upload':'tool',...(toolName?{toolName}:{})})
     }