@ash-qw/dsh-theme-prts 0.1.95 → 0.1.97

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ash-qw/dsh-theme-prts",
-  "version": "0.1.95",
+  "version": "0.1.97",
   "private": false,
   "type": "module",
   "description": "Unofficial Arknights P.R.T.S.-inspired UI theme for DeepSeek Harness Web",
@@ -67,7 +67,8 @@
     "prepublishOnly": "npm run check"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=18",
+    "dsh": ">=0.1.2-rc.1 <0.1.3-0 || >=0.1.5-rc.1 <0.1.6-0"
   },
   "devDependencies": {
     "@playwright/test": "1.55.1",

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

@@ -1,5 +1,6 @@
 export const ASSISTANT_SURFACE_ATTRIBUTE = 'data-prts-ai-surface'
 export const ASSISTANT_STATE_ATTRIBUTE = 'data-prts-ai-surface-state'
+export const ASSISTANT_AVATAR_PROPERTY = '--prts-assistant-avatar-image'
 
 const STEP_SELECTOR = '[data-chat-flow-kind="assistant-step"]'
 const CONTENT_HINT_SELECTOR = [
@@ -16,6 +17,7 @@ const EXCLUDED_SELECTOR = [
 ].join(', ')
 const SCAN_CHUNK_LIMIT = 64
 const SCAN_BUDGET_MS = 4
+const INITIAL_LATEST_LIMIT = 12
 
 function isElement(node) {
   return node?.nodeType === 1
@@ -90,13 +92,42 @@ export function resolveAssistantSurface(step) {
   return resolution(step).surface
 }
 
-export function createAssistantGlassAdapter({ document, window }) {
+function cssUrl(value) {
+  if (!value) return ''
+  const escaped = String(value)
+    .replaceAll('\\', '\\\\')
+    .replaceAll('"', '\\"')
+    .replaceAll('\n', '')
+  return `url("${escaped}")`
+}
+
+export function createAssistantGlassAdapter({ document, window, avatarImage = '' }) {
   let observer
   let scanFrame
   const ownedSurfaces = new Set()
   const ownedSteps = new Set()
   const stepSurfaces = new Map()
   const pendingSteps = new Set()
+  let previousAvatarImage
+  let ownsAvatarImage = false
+
+  function mountAvatarImage() {
+    const root = document?.documentElement
+    const value = cssUrl(avatarImage)
+    if (!root?.style || !value || ownsAvatarImage) return
+    previousAvatarImage = root.style.getPropertyValue(ASSISTANT_AVATAR_PROPERTY)
+    root.style.setProperty(ASSISTANT_AVATAR_PROPERTY, value)
+    ownsAvatarImage = true
+  }
+
+  function releaseAvatarImage() {
+    if (!ownsAvatarImage) return
+    const root = document?.documentElement
+    if (previousAvatarImage) root?.style?.setProperty(ASSISTANT_AVATAR_PROPERTY, previousAvatarImage)
+    else root?.style?.removeProperty(ASSISTANT_AVATAR_PROPERTY)
+    previousAvatarImage = undefined
+    ownsAvatarImage = false
+  }
 
   function collectSteps(node, includeParent = true) {
     if (!isElement(node)) return
@@ -108,6 +139,23 @@ export function createAssistantGlassAdapter({ document, window }) {
     }
   }
 
+  function collectInitialSteps(node) {
+    if (!isElement(node)) return
+    const steps = [...(node.querySelectorAll?.(STEP_SELECTOR) ?? [])]
+    if (node.matches?.(STEP_SELECTOR)) steps.unshift(node)
+    const priorityStart = Math.max(0, steps.length - INITIAL_LATEST_LIMIT)
+
+    // The host restores conversations in chronological DOM order. Resolve the
+    // newest screenful synchronously so the startup cover never reveals plain
+    // assistant content while an older history backlog is still being scanned.
+    for (let index = steps.length - 1; index >= priorityStart; index -= 1) {
+      processStep(steps[index])
+    }
+    for (let index = priorityStart - 1; index >= 0; index -= 1) {
+      pendingSteps.add(steps[index])
+    }
+  }
+
   function stableBodyContains(step, node) {
     const surface = stepSurfaces.get(step)
     return step?.getAttribute?.(ASSISTANT_STATE_ATTRIBUTE) === 'body'
@@ -201,12 +249,13 @@ export function createAssistantGlassAdapter({ document, window }) {
   return {
     start() {
       if (!document) return
+      mountAvatarImage()
       const observationRoot = document.querySelector('[data-prts-region="operation"]')
-        ?? document.querySelector('[data-slot="conversation"]')
+        ?? document.querySelector('[data-slot="main.conversation"], [data-slot="conversation"]')
       if (!observationRoot) return
-      collectSteps(observationRoot)
-      scan()
       if (observer) return
+      collectInitialSteps(observationRoot)
+      scan()
       const Observer = window?.MutationObserver
       if (!Observer) return
       observer = new Observer(onMutations)
@@ -226,6 +275,7 @@ export function createAssistantGlassAdapter({ document, window }) {
       }
       scanFrame = undefined
       removeMarkers()
+      releaseAvatarImage()
     },
   }
 }

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

@@ -187,7 +187,7 @@ export function createComposerGlassAdapter({ document, window }) {
       const Observer = window?.MutationObserver
       if (!Observer) return
       const observationRoot = document.querySelector('[data-prts-region="operation"]')
-        ?? document.querySelector('[data-slot="conversation"]')
+        ?? document.querySelector('[data-slot="main.conversation"], [data-slot="conversation"]')
       if (!observationRoot) return
       observer = new Observer(onMutations)
       observer.observe(observationRoot, {

package/src/client/index.js

@@ -46,7 +46,11 @@ export function applyPrtsPlugin(ctx, environment) {
   const themeService = contextService(ctx, 'theme')
   const startup = createPrtsStartupSequence({ document, window, prtsEmblem: assets.prtsEmblem, rhodesEmblem: assets.emblem, timings: startupTimings })
   const composerGlass = createComposerGlassAdapter({ document, window })
-  const assistantGlass = createAssistantGlassAdapter({ document, window })
+  const assistantGlass = createAssistantGlassAdapter({
+    document,
+    window,
+    avatarImage: assets.prtsEmblem,
+  })
   const particleField = createParticleFieldAdapter({
     document,
     window,
@@ -206,7 +210,8 @@ export function applyPrtsPlugin(ctx, environment) {
     }
     particleField.update(preferences)
     composerGlass.start()
-    assistantGlass.start()
+    if (preferences.conversationStyle === 'deck-chat') assistantGlass.start()
+    else assistantGlass.dispose()
     toBottom.start()
     conversationControls.start()
     layoutDiagnostics.start()

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

@@ -1877,7 +1877,7 @@ export function createParticleFieldAdapter({ document, window, emblem = '', embl
           mutationObserver.observe(observationRoot, { childList: true, subtree: true })
         }
       }
-      if (ambient) ambient.hidden = preferences.texture === 'off'
+      if (ambient) ambient.hidden = preferences.texture === 'off' && preferences.conversationStyle !== 'deck-chat'
       scheduleFrame()
     },
     inspect() {

package/src/client/preferences.js

@@ -6,7 +6,7 @@ export const PARTICLE_TRAVERSAL_SPEED_STEP = 0.25
 export const PARTICLE_TRAVERSAL_SPEED_DEFAULT = 1
 
 export const DEFAULT_PREFERENCES = Object.freeze({
-  version: 8,
+  version: 9,
   enabled: false,
   preset: 'standard-tactical',
   texture: 'full',
@@ -18,6 +18,7 @@ export const DEFAULT_PREFERENCES = Object.freeze({
   particleTraversalSpeed: PARTICLE_TRAVERSAL_SPEED_DEFAULT,
   particlePattern: 'orthogonal',
   railDefaultHidden: false,
+  conversationStyle: 'deck-chat',
 })
 
 export const VISUAL_PRESETS = Object.freeze({
@@ -59,6 +60,7 @@ export const PREFERENCE_GROUPS = Object.freeze({
   material: Object.freeze(['glass']),
   accessibility: Object.freeze(['motion', 'bootAnimation']),
   navigation: Object.freeze(['railDefaultHidden']),
+  conversation: Object.freeze(['conversationStyle']),
 })
 
 const TEXTURES = new Set(['off', 'restrained', 'full'])
@@ -66,6 +68,7 @@ const GLASS_STRENGTHS = new Set(['off', 'soft', 'standard', 'clear'])
 const MOTIONS = new Set(['system', 'reduced'])
 const PARTICLE_DENSITIES = new Set(['sparse', 'light', 'standard', 'dense', 'ultra'])
 const PRESETS = new Set([...Object.keys(VISUAL_PRESETS), 'custom'])
+const CONVERSATION_STYLES = new Set(['native', 'deck-chat'])
 const PRESET_LINKED_KEYS = new Set(Object.keys(VISUAL_PRESETS['standard-tactical']))
 
 
@@ -129,7 +132,7 @@ export function normalizePreferences(value) {
   const particlePreset = VISUAL_PRESETS[input.preset] ?? DEFAULT_PREFERENCES
   const legacyDensities = legacyParticleDensities(input)
   const normalized = {
-    version: 8,
+    version: 9,
     enabled: booleanOr(input.enabled, DEFAULT_PREFERENCES.enabled),
     preset: enumOr(migratedPreset, PRESETS, DEFAULT_PREFERENCES.preset),
     texture: enumOr(input.texture, TEXTURES, DEFAULT_PREFERENCES.texture),
@@ -144,6 +147,7 @@ export function normalizePreferences(value) {
     ),
     particlePattern: 'orthogonal',
     railDefaultHidden: booleanOr(input.railDefaultHidden, DEFAULT_PREFERENCES.railDefaultHidden),
+    conversationStyle: enumOr(input.conversationStyle, CONVERSATION_STYLES, DEFAULT_PREFERENCES.conversationStyle),
   }
   normalized.preset = matchedVisualPreset(normalized)
   return normalized
@@ -190,7 +194,7 @@ export function loadPreferences(storage) {
     const raw = storage?.getItem(PRTS_STORAGE_KEY)
     if (raw === null || raw === undefined) return { ...DEFAULT_PREFERENCES }
     const parsed = JSON.parse(raw)
-    if (![1, 2, 3, 4, 5, 6, 7, 8].includes(parsed?.version)) return { ...DEFAULT_PREFERENCES }
+    if (![1, 2, 3, 4, 5, 6, 7, 8, 9].includes(parsed?.version)) return { ...DEFAULT_PREFERENCES }
     return normalizePreferences(parsed)
   } catch {
     return { ...DEFAULT_PREFERENCES }

package/src/client/rc7-adapter.js

@@ -7,36 +7,73 @@ function closestCommonContainer(root, nodes) {
   return root && nodes.every(node => root.contains(node)) ? root : null
 }
 
+const LAYOUT_CONTRACTS = [
+  {
+    version: '0.1.5',
+    center: '[data-slot="main"]',
+    auxiliary: '[data-slot="rightbar"]',
+  },
+  {
+    version: '0.1.2',
+    center: '[data-slot="conversation"]',
+    auxiliary: '[data-slot="details"]',
+  },
+]
+
 export function resolveRc7Regions(document, report = () => {}) {
   const root = document?.querySelector('[data-slot="root"]')
   const sidebarSlot = root?.querySelector('[data-slot="sidebar"]')
-  const conversationSlot = root?.querySelector('[data-slot="conversation"]')
-  const detailsSlot = root?.querySelector('[data-slot="details"]')
-  if (!root || !sidebarSlot || !conversationSlot || !detailsSlot) {
+  const contract = LAYOUT_CONTRACTS
+    .map(candidate => ({
+      ...candidate,
+      centerSlot: root?.querySelector(candidate.center),
+      auxiliarySlot: root?.querySelector(candidate.auxiliary),
+    }))
+    .find(candidate => candidate.centerSlot && candidate.auxiliarySlot)
+  if (!root || !sidebarSlot || !contract) {
     report('required layout slots are unavailable', {
       root: Boolean(root), sidebar: Boolean(sidebarSlot),
-      conversation: Boolean(conversationSlot), details: Boolean(detailsSlot),
+      main: Boolean(root?.querySelector('[data-slot="main"]')),
+      rightbar: Boolean(root?.querySelector('[data-slot="rightbar"]')),
+      conversation: Boolean(root?.querySelector('[data-slot="conversation"]')),
+      details: Boolean(root?.querySelector('[data-slot="details"]')),
     })
     return null
   }
+  const { centerSlot, auxiliarySlot } = contract
   const sidebar = sidebarSlot?.parentElement
-  const center = conversationSlot?.parentElement
-  const details = detailsSlot?.parentElement
+  const center = centerSlot?.parentElement
+  const auxiliary = auxiliarySlot?.parentElement
 
-  if (!sidebar || !center || !details) {
+  if (!sidebar || !center || !auxiliary) {
     report('required layout region containers are unavailable', {
-      sidebar: Boolean(sidebar), conversation: Boolean(center), details: Boolean(details),
+      sidebar: Boolean(sidebar), center: Boolean(center), auxiliary: Boolean(auxiliary),
     })
     return null
   }
 
-  const frame = closestCommonContainer(root, [sidebar, center, details])
+  const frame = closestCommonContainer(root, [sidebar, center, auxiliary])
   if (!frame) {
     report('common layout container is unavailable')
     return null
   }
 
-  return { root, frame, sidebar, center, details, sidebarSlot, conversationSlot, detailsSlot }
+  return {
+    root,
+    frame,
+    sidebar,
+    center,
+    auxiliary,
+    sidebarSlot,
+    centerSlot,
+    auxiliarySlot,
+    layoutVersion: contract.version,
+    // Legacy aliases keep the internal adapter face compatible with callers
+    // built against the 0.1.2 layout vocabulary.
+    conversationSlot: centerSlot,
+    details: auxiliary,
+    detailsSlot: auxiliarySlot,
+  }
 }
 
 export function createRc7Adapter({ document, warn } = {}) {
@@ -64,7 +101,7 @@ export function createRc7Adapter({ document, warn } = {}) {
         [regions.frame, 'frame'],
         [regions.sidebar, 'sessions'],
         [regions.center, 'operation'],
-        [regions.details, 'details'],
+        [regions.auxiliary, 'auxiliary'],
       ]) {
         owned.push([node, node.getAttribute('data-prts-region')])
         node.setAttribute('data-prts-region', value)

package/src/client/theme-controller-v2.js

@@ -7,6 +7,7 @@ const ROOT_ATTRIBUTES = [
   'data-prts-glass',
   'data-prts-motion',
   'data-prts-particle-pattern',
+  'data-prts-conversation-style',
 ]
 
 const TRANSITION_ATTRIBUTE = 'data-prts-scheme-transition'
@@ -715,6 +716,7 @@ export function createThemeController({ document, window, cssText, service, onTr
       root.dataset.prtsGlass = preferences.glass
       root.dataset.prtsMotion = preferences.motion
       root.dataset.prtsParticlePattern = 'orthogonal'
+      root.dataset.prtsConversationStyle = preferences.conversationStyle
       refresh()
     },
     sync,

package/src/client/theme-controller.js

@@ -7,6 +7,7 @@ const ROOT_ATTRIBUTES = [
   'data-prts-glass',
   'data-prts-motion',
   'data-prts-particle-pattern',
+  'data-prts-conversation-style',
 ]
 
 function themeIdentity(value) {
@@ -108,6 +109,7 @@ export function createThemeController({ document, window, cssText, service }) {
       root.dataset.prtsGlass = preferences.glass
       root.dataset.prtsMotion = preferences.motion
       root.dataset.prtsParticlePattern = 'orthogonal'
+      root.dataset.prtsConversationStyle = preferences.conversationStyle
       refresh()
     },
     sync,

package/src/client/theme-settings-workbench.js

@@ -19,6 +19,7 @@ const COMMON_CONTROLS = [
   ['texture', '环境底纹', [['off', '关闭'], ['restrained', '克制'], ['full', '完整']]],
   ['glass', '玻璃材质', [['off', '关闭'], ['soft', '柔和'], ['standard', '标准'], ['clear', '清晰']]],
   ['motion', '动态效果', [['system', '跟随系统'], ['reduced', '减少']]],
+  ['conversationStyle', '会话主题', [['native', '原有'], ['deck-chat', '通讯链路']]],
 ]
 
 const PARTICLE_OPTIONS = [
@@ -34,6 +35,8 @@ function settingButtons(key, label, options) {
       ? '<small data-prts-setting-note data-prts-effective-motion hidden>系统当前要求减少动态</small>'
       : key === 'railDefaultHidden'
         ? '<small data-prts-setting-note>在任意窗口宽度下默认收起 P.R.T.S. 导航，可从左侧按钮临时展开</small>'
+      : key === 'conversationStyle'
+        ? '<small data-prts-setting-note>立即切换会话背景、头像与消息气泡</small>'
       : ''
   const sample = value => key === 'texture' || key === 'glass'
     ? `<i data-prts-option-sample="${key}" data-prts-option-sample-value="${value}" aria-hidden="true"></i>`