@ash-qw/dsh-theme-prts 2.1.1 → 2.3.0

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

@@ -976,7 +976,7 @@ export function createSidebarControlAdapter({ document, window, sessions, worksp
 
   return {
     start(preferences = {}) {
-      const keys = ['sessionPreview','previewOngoing','previewWarning','previewDone','previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']
+      const keys = ['sessionPreview','previewOngoing','previewTools','previewWarning','previewDone','previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning', 'previewReplyLimit']
       if (keys.some(key => previewPreferences[key] !== preferences[key])) preview.stop()
       previewPreferences = Object.fromEntries(keys.map(key => [key, preferences[key]]))
       if (!document) return

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

@@ -72,7 +72,7 @@ function resolveScheme(value) {
   return identity.includes('dark') || identity.includes('night') ? 'dark' : 'light'
 }
 
-export function createThemeController({ document, window, cssText, service, cursorAssets, onTransitionStateChange = () => {} }) {
+export function createThemeController({ document, window, cssText, service, cursorAssets, onTransitionStateChange = () => {}, onSchemeChange = () => {} }) {
   if (!document || !window) {
     const gesture = { update() {}, finish() {}, cancel() {} }
     return { apply() {}, sync() {}, refresh() {}, setTheme() {}, beginThemeTransition() { return gesture }, toggle() {}, dispose() {} }
@@ -153,6 +153,7 @@ export function createThemeController({ document, window, cssText, service, curs
     if (disposed) return
     const next = resolveScheme(value)
     root.dataset.prtsScheme = next
+    onSchemeChange(next)
     return next
   }
 

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

@@ -1,3 +1,4 @@
+import { themeTransferMarkup, mountThemeTransfer } from './theme-transfer-panel.js'
 import { backgroundMarkup, mountBackgroundSettings } from './custom-background.js'
 import { avatarMarkup, mountAvatarSettings } from './custom-avatar.js'
 import { customEmblemMarkup, mountCustomEmblemEditor } from './custom-emblem.js'
@@ -38,7 +39,9 @@ function previewSetting(key, label, description) {
 }
 
 function settingButtons(key, label, options) {
-  const note = key === 'composerGlass'
+  const note = key === 'heroContrast'
+      ? '<small data-prts-setting-note>为新会话徽记添加柔光衬底，使它在背景图片上更清晰。</small>'
+      : key === 'composerGlass'
       ? '<small data-prts-setting-note>增强输入框的背景模糊与轻微折射，关闭时使用原有材质</small>'
       : key === 'bakerLoading'
       ? '<small data-prts-setting-note>每轮正文生成时显示三点动画，完成后显示全文；中断时保留已收到的内容</small>'
@@ -59,7 +62,7 @@ function settingButtons(key, label, options) {
       : key === 'sessionFlowPalette'
         ? '<small data-prts-setting-note>同时适配日间与夜间模式</small>'
       : ''
-  if (['composerGlass', 'bakerLoading', 'motion', 'cursor', 'railDefaultHidden', 'sessionFlow', 'sessionGlow', 'bakerGroupAvatars', 'conversationEmblem', 'sessionPreview', 'previewOngoing', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning'].includes(key)) return `<div data-prts-setting-row="${key}">
+  if (['heroContrast', 'composerGlass', 'bakerLoading', 'motion', 'cursor', 'railDefaultHidden', 'sessionFlow', 'sessionGlow', 'bakerGroupAvatars', 'conversationEmblem', 'sessionPreview', 'aiToolsEnabled', 'previewOngoing', 'previewTools', 'previewWarning', 'previewDone', 'previewDoubleClick', 'previewFollowOngoing', 'previewFollowWarning'].includes(key)) return `<div data-prts-setting-row="${key}">
     <span><strong>${label}</strong>${note}</span>
     <button type="button" role="switch" aria-label="${label}" aria-checked="false" data-prts-setting-switch="${key}" ${key === 'cursor' ? 'data-prts-cursor-switch' : ''}><span aria-hidden="true"></span></button>
   </div>`
@@ -127,15 +130,17 @@ export function themeSettingsMarkup() {
           <button type="button" data-prts-settings-jump="flow" role="tab" id="prts-tab-flow" aria-controls="prts-page-flow" aria-selected="false" tabindex="-1">会话流线</button>
           <button type="button" data-prts-settings-jump="particles" role="tab" id="prts-tab-particles" aria-controls="prts-page-particles" aria-selected="false" tabindex="-1">粒子徽记</button>
           <button type="button" data-prts-settings-jump="assistance" role="tab" id="prts-tab-assistance" aria-controls="prts-page-assistance" aria-selected="false" tabindex="-1">辅助功能</button>
+          <button type="button" data-prts-settings-jump="ai-tools" role="tab" id="prts-tab-ai-tools" aria-controls="prts-page-ai-tools" aria-selected="false" tabindex="-1">AI 工具</button>
         </nav>
           <footer data-prts-settings-actions aria-label="全局主题设置操作">
             <div data-prts-persistence-error hidden role="alert">
               <span><strong>设置未保存</strong><small>未能保存到 DSH，可能存在连接中断、配置冲突或当前访问不支持持久保存。重试将重新提交本次修改。</small></span>
               <button type="button" data-prts-retry-save>重试保存</button>
             </div>
+            <button type="button" data-prts-transfer-open data-prts-footer-action aria-haspopup="dialog" aria-expanded="false"><svg viewBox="0 0 20 20" aria-hidden="true"><path d="M6 14V3m-3 3 3-3 3 3M14 6v11m-3-3 3 3 3-3"/></svg><span>导入与导出</span></button>
             <div data-prts-reset-zone>
 
-              <button type="button" data-prts-reset-visual title="恢复全部主题设置" aria-label="恢复全部主题设置">恢复默认</button>
+              <button type="button" data-prts-reset-visual data-prts-footer-action title="恢复全部主题设置" aria-label="恢复全部主题设置"><svg viewBox="0 0 20 20" aria-hidden="true"><path d="M4 7a6.5 6.5 0 1 1-.4 5M4 3v4h4"/></svg><span>恢复默认</span></button>
               <div data-prts-reset-confirm hidden role="group" aria-label="确认恢复全部主题设置">
                 <span>重置全部分类的主题设置，保留主题开关、启动动画和徽记配置。</span>
                 <button type="button" data-prts-reset-confirm-action>确认恢复</button>
@@ -143,6 +148,7 @@ export function themeSettingsMarkup() {
               </div>
             </div>
           </footer>
+          ${themeTransferMarkup()}
         </div>
         <div data-prts-theme-settings-scroll>
           <section data-prts-settings-section="appearance" role="tabpanel" id="prts-page-appearance" aria-labelledby="prts-tab-appearance" tabindex="0">
@@ -158,7 +164,7 @@ export function themeSettingsMarkup() {
           </section>
           </section>
           <section data-prts-settings-section="background" role="tabpanel" id="prts-page-background" aria-labelledby="prts-tab-background" tabindex="0" hidden>
-            ${backgroundMarkup()}
+            ${backgroundMarkup(settingButtons('heroContrast', '新会话徽记增强', []))}
             <div data-prts-composer-glass-setting>${settingButtons('composerGlass', '输入框增强毛玻璃', [])}</div>
             <small data-prts-composer-glass-required hidden>自定义背景下，输入框增强毛玻璃始终开启。</small>
           </section>
@@ -167,6 +173,33 @@ export function themeSettingsMarkup() {
               ${COMMON_CONTROLS.filter(([key]) => ['cursor', 'railDefaultHidden', 'motion'].includes(key)).map(([key, label, options]) => settingButtons(key, label, options)).join('')}
             </div>
           </section>
+          <section data-prts-settings-section="ai-tools" data-prts-ai-tools role="tabpanel" id="prts-page-ai-tools" aria-labelledby="prts-tab-ai-tools" tabindex="0" hidden>
+            <div data-prts-preview-settings><div data-prts-preview-master>
+            ${previewSetting('aiToolsEnabled', '允许 AI 定制主题', '默认开启 · 共 5 个工具 · 影响此 DSH 实例的所有会话')}
+            </div></div>
+            <p>开启后，AI 可以通过工具调整粒子徽记和 Baker 头像。关闭后，后续模型请求不再提供这些工具，手动设置不受影响；已有对话中的工具记录不会删除。</p>
+            <section>
+              <h3>粒子徽记 <small>3 个工具</small></h3>
+              <p>将会话中的图片制作成粒子徽记，用于新会话页面或正文轮换。</p>
+              <ol><li>上传图片，或让 AI 读取已生成的图片。</li><li>让 AI 制作草稿，调整轮廓、位置和缩放，先查看预览。</li><li>满意后明确要求应用到新会话徽记，或加入正文轮换。</li></ol>
+              <blockquote>“把这张图片做成粒子徽记，先给我看看效果。”</blockquote>
+              <details><summary>工具说明与限制</summary><dl>
+                <dt><code>prts_emblem_inspect</code></dt><dd>查看徽记配置、版本与当前会话的可用图片，不修改设置。</dd>
+                <dt><code>prts_emblem_preview</code></dt><dd>制作或调整粒子徽记草稿，只生成预览，不直接应用。</dd>
+                <dt><code>prts_emblem_apply</code></dt><dd>经你确认后，替换新会话徽记，或添加、替换正文轮换徽记。</dd>
+              </dl><p>单张来源图片最大 8 MB。徽记设置跨工作区和会话共享。粒子预览不等同于原图；配置发生变化时，AI 需要重新核对后再应用。</p></details>
+            </section>
+            <section>
+              <h3>Baker 头像 <small>2 个工具</small></h3>
+              <p>为用户和 AI 设置头像，调整圆形裁剪，或恢复默认头像。仅在 Baker 会话样式下显示。</p>
+              <ol><li>上传图片，说明要修改用户头像还是 AI 头像。</li><li>让 AI 查看当前配置，再按你的要求替换、裁剪或恢复默认。</li></ol>
+              <blockquote>“把这张图片设为 AI 头像，居中裁剪。”</blockquote>
+              <details><summary>工具说明与限制</summary><dl>
+                <dt><code>prts_avatar_inspect</code></dt><dd>查看头像配置、原图尺寸、裁剪参数及会话图片，不修改设置。</dd>
+                <dt><code>prts_avatar_apply</code></dt><dd>替换用户或 AI 头像、基于现有原图重新裁剪，或恢复默认头像。</dd>
+              </dl><p>单图最大 5 MB、2500 万像素；裁剪支持 1～4 倍缩放。修改立即影响此实例所有会话，不会自动切换会话样式。替换后不保留旧原图；恢复默认会删除自定义原图。</p></details>
+            </section>
+          </section>
           <section data-prts-settings-section="assistance" role="tabpanel" id="prts-page-assistance" aria-labelledby="prts-tab-assistance" tabindex="0" hidden>
             <section data-prts-preview-settings>
               <div data-prts-preview-master>
@@ -177,6 +210,7 @@ export function themeSettingsMarkup() {
                   <header><strong>悬停预览</strong><small>选择哪些状态显示详细浮窗</small></header>
                   ${previewSetting('previewOngoing', '运行中预览', '逐轮查看已完成的回复，最新内容置顶')}
                   <div data-prts-preview-details="previewOngoing">
+                  ${previewSetting('previewTools', '显示工具调用', '显示工具进度，悬停查看最新正文之后的调用记录')}
                   <label data-prts-setting-row="previewReplyLimit"><span><strong>回复条数</strong><small data-prts-preview-setting-description>仅保留最新回复</small></span><select data-prts-preview-reply-limit aria-label="最多显示回复"><option value="5">最新 5 条</option><option value="10">最新 10 条</option><option value="0">不限制</option></select></label>
                   ${previewSetting('previewFollowOngoing', '运行结束后跟随', '转为待处理或已完成时，自动切换预览')}
                   </div>
@@ -233,7 +267,7 @@ export function createThemeSettingsOverlay({
   trigger,
   panel,
   backdrop,
-  customEmblemStore, avatarStore, backgroundStore,
+  customEmblemStore, avatarStore, backgroundStore, themeTransfer,
   onOpen = () => {},
   onPreferenceChange = () => {},
   onPreferencePreview = () => {},
@@ -241,6 +275,7 @@ export function createThemeSettingsOverlay({
   onRetrySave = () => {},
 }) {
   const window = document?.defaultView
+  const transferEditor = mountThemeTransfer({ panel, window, transfer: themeTransfer })
   const backgroundEditor = mountBackgroundSettings({panel,window,store:backgroundStore,onChange:onPreferenceChange})
   const avatarEditor = mountAvatarSettings({panel,window,store:avatarStore})
   const customEditor = mountCustomEmblemEditor({ panel, window, store: customEmblemStore })
@@ -720,6 +755,7 @@ export function createThemeSettingsOverlay({
       panel.querySelector('[data-prts-baker-options]').hidden = preferences?.conversationStyle !== 'deck-chat'
       panel.querySelector('[data-prts-avatars]').hidden = preferences?.conversationStyle !== 'deck-chat'
       const customBackground = preferences.backgroundMode !== 'off'
+      panel.querySelector('[data-prts-background-hero-setting]').hidden = !customBackground
       panel.querySelector('[data-prts-composer-glass-setting]').hidden = customBackground
       panel.querySelector('[data-prts-composer-glass-required]').hidden = !customBackground
       backgroundEditor.update(preferences)
@@ -737,6 +773,7 @@ export function createThemeSettingsOverlay({
     close: () => setOpen(false),
     toggle,
     dispose() {
+      transferEditor.dispose()
       customEditor.dispose()
       avatarEditor.dispose()
       backgroundEditor.dispose()

package/src/client/theme-transfer-panel.js

@@ -0,0 +1,98 @@
+import { THEME_PACKAGE_LIMIT, validateThemePackage, describeThemePackage } from './theme-transfer.js'
+
+export function themeTransferMarkup() {
+  return `<dialog data-prts-transfer-dialog aria-labelledby="prts-transfer-title">
+    <section data-prts-transfer>
+      <header data-prts-transfer-heading><div><small>P.R.T.S. / 主题文件</small><h2 id="prts-transfer-title">导入与导出</h2></div><button type="button" data-prts-transfer-close aria-label="关闭导入与导出">×</button></header>
+      <div data-prts-transfer-columns>
+        <section data-prts-transfer-card>
+          <h3>导出主题</h3><p>保存一份主题，备份或带到另一台设备。</p>
+          <label data-prts-transfer-option><input type="checkbox" data-prts-transfer-assets checked><span>包含自定义素材<small>背景、头像和徽记，保留编辑参数与排列。</small></span></label>
+          <small>取消勾选，仅导出主题设置。</small>
+          <button type="button" data-prts-transfer-export>导出主题文件 <span aria-hidden="true">↓</span></button>
+        </section>
+        <section data-prts-transfer-card>
+          <h3>导入主题</h3><p>选择已导出的文件，确认内容后应用。</p>
+          <div data-prts-transfer-file-hint><span aria-hidden="true">↑</span><small>.prts-theme.json · 最大 160 MB</small></div>
+          <button type="button" data-prts-transfer-choose>选择主题文件</button>
+          <input type="file" accept=".prts-theme.json,application/json" aria-label="导入主题文件" data-prts-transfer-file hidden>
+        </section>
+      </div>
+      <div data-prts-transfer-preview hidden>
+        <strong>确认导入</strong><p data-prts-transfer-summary></p>
+        <small>应用前会下载当前配置备份，请保留备份文件。</small>
+        <div data-prts-transfer-buttons><button type="button" data-prts-transfer-apply>确认导入</button><button type="button" data-prts-transfer-cancel>取消</button></div>
+      </div>
+      <div data-prts-transfer-recovery hidden><small>恢复将替换最近一次导入后所做的修改。</small><button type="button" data-prts-transfer-restore>恢复导入前配置</button></div>
+      <p data-prts-transfer-status role="status" aria-live="polite"></p>
+    </section>
+  </dialog>`
+}
+
+export function mountThemeTransfer({ panel, window, transfer }) {
+  const section = panel.querySelector('[data-prts-transfer]')
+  if (!section || !transfer) return { dispose() {} }
+  const dialog = panel.querySelector('[data-prts-transfer-dialog]')
+  const trigger = panel.querySelector('[data-prts-transfer-open]')
+  const open = () => { dialog.showModal(); trigger?.setAttribute('aria-expanded', 'true'); get('close').focus() }
+  const close = () => { if (busy) return; dialog.close(); trigger?.setAttribute('aria-expanded', 'false'); trigger?.focus() }
+  const keydown = event => { if (event.key === 'Escape') { event.preventDefault(); event.stopPropagation(); close() } }
+  const cancel = event => { if (event.target === dialog) { event.preventDefault(); event.stopPropagation(); close() } }
+  const get = name => section.querySelector(`[data-prts-transfer-${name}]`)
+  let pending, busy = false, disposed = false, generation = 0
+  const render = () => {
+    if (disposed) return
+    get('preview').hidden = !pending
+    get('recovery').hidden = !transfer.hasBackup
+    for (const control of section.querySelectorAll('button,input')) control.disabled = busy
+    // Prevent local editors from racing a multi-service import; other clients use revision checks.
+    for (const page of panel.querySelectorAll('[data-prts-settings-section]')) if (!page.contains(section)) page.inert = busy
+  }
+  async function run(task) {
+    if (busy) return
+    busy = true; get('status').textContent = '正在处理，请稍候…'; render()
+    try { get('status').textContent = await task() }
+    catch (error) { if (!disposed) get('status').textContent = error.message }
+    finally { busy = false; render() }
+  }
+  const change = event => {
+    if (event.target !== get('file')) return
+    const file = event.target.files?.[0], selected = ++generation
+    pending = undefined; render()
+    if (!file) return
+    void run(async () => {
+      if (file.size > THEME_PACKAGE_LIMIT) throw Error('主题文件不能超过 160 MB')
+      const text = await new Promise((resolve, reject) => {
+        const reader = new window.FileReader()
+        reader.onload = () => resolve(reader.result); reader.onerror = () => reject(Error('无法读取主题文件')); reader.readAsText(file)
+      })
+      let value
+      try { value = JSON.parse(text) } catch { throw Error('主题文件不是有效的 JSON') }
+      validateThemePackage(value)
+      if (disposed || selected !== generation) return ''
+      pending = value
+      get('summary').textContent = describeThemePackage(value)
+      return '已读取文件，请确认导入内容。'
+    })
+  }
+  const click = event => {
+    const button = event.target.closest?.('button')
+    if (button === get('close')) close()
+    if (button === get('choose')) get('file').click()
+    if (button === get('export')) void run(async () => {
+      const value = await transfer.export(get('assets').checked)
+      transfer.download(value)
+      return '已发起下载，请确认主题文件已保存。'
+    })
+    if (button === get('apply') && pending) void run(async () => {
+      await transfer.import(pending); pending = undefined; get('file').value = ''
+      return '主题已导入并保存。'
+    })
+    if (button === get('cancel')) { pending = undefined; get('file').value = ''; get('status').textContent = ''; render() }
+    if (button === get('restore')) void run(async () => { await transfer.restore(); return '已恢复导入前配置。' })
+  }
+  trigger?.addEventListener('click', open)
+  dialog.addEventListener('keydown', keydown); dialog.addEventListener('cancel', cancel)
+  section.addEventListener('change', change); section.addEventListener('click', click); render()
+  return { dispose() { disposed = true; generation++; if (dialog.open) dialog.close(); trigger?.removeEventListener('click', open); dialog.removeEventListener('keydown', keydown); dialog.removeEventListener('cancel', cancel); section.removeEventListener('change', change); section.removeEventListener('click', click) } }
+}

package/src/client/theme-transfer.js

@@ -0,0 +1,167 @@
+import { DEFAULT_PREFERENCES, normalizePreferences } from './preferences.js'
+
+export const THEME_PACKAGE_LIMIT = 160 * 1024 * 1024
+const transferSlots = ['full', 'sidebar', 'conversation']
+const transferRoles = ['user', 'assistant']
+const transferBuiltins = ['rhodes-island', 'lungmen', 'penguin-logistics', 'rhine-lab', 'reunion']
+const record = value => value !== null && typeof value === 'object' && !Array.isArray(value)
+const encodedImage = (value, limit) => typeof value === 'string' && value.length > 0 && value.length <= Math.ceil(limit / 3) * 4 && value.length % 4 === 0 && /^[A-Za-z0-9+/]+={0,2}$/.test(value)
+
+export function validateThemePackage(value) {
+  if (!record(value) || value.format !== 'prts-theme' || value.version !== 1) throw Error('不支持的主题文件格式或版本')
+  if (!record(value.preferences) || !Object.keys(value.preferences).some(key => key !== 'version' && Object.hasOwn(DEFAULT_PREFERENCES, key))) throw Error('主题文件缺少设置')
+  if (!Number.isInteger(value.preferences.version) || value.preferences.version < 1 || value.preferences.version > DEFAULT_PREFERENCES.version) throw Error('不支持此设置版本，请更新主题后重试')
+  const normalized = normalizePreferences(value.preferences)
+  for (const [key, input] of Object.entries(value.preferences)) {
+    if (!Object.hasOwn(DEFAULT_PREFERENCES, key) || key === 'version') continue
+    if (typeof input !== typeof DEFAULT_PREFERENCES[key] || (typeof input === 'number' && !Number.isFinite(input))) throw Error(`设置 ${key} 的类型无效`)
+    // Current-format files must not silently turn malformed settings into defaults.
+    if (value.preferences.version === DEFAULT_PREFERENCES.version && normalized[key] !== input) throw Error(`设置 ${key} 的值无效`)
+  }
+  if (value.assets === undefined) return value
+  const a = value.assets
+  if (!record(a) || !record(a.backgrounds) || !record(a.avatars) || !record(a.emblems)) throw Error('主题素材数据不完整')
+  for (const slot of transferSlots) if (a.backgrounds[slot] !== null && !encodedImage(a.backgrounds[slot], 10 * 1024 * 1024)) throw Error('背景图片数据无效')
+  for (const role of transferRoles) {
+    const avatar = a.avatars[role]
+    if (avatar === null) continue
+    const crop = avatar?.crop
+    if (!record(avatar) || !encodedImage(avatar.image, 5 * 1024 * 1024) || !record(crop)
+      || !Number.isFinite(crop.zoom) || crop.zoom < 1 || crop.zoom > 4
+      || !Number.isFinite(crop.x) || crop.x < 0 || crop.x > 1 || !Number.isFinite(crop.y) || crop.y < 0 || crop.y > 1) throw Error('头像数据或裁剪参数无效')
+  }
+  const { items, hero, conversation } = a.emblems
+  if (!Array.isArray(items) || items.length > 13 || !Array.isArray(conversation) || conversation.length < 1 || conversation.length > 12) throw Error('徽记数量无效')
+  for (const item of items) {
+    if (!record(item) || item.format !== 'prts-emblem' || item.version !== 1 || typeof item.label !== 'string' || !item.label.trim() || item.label.length > 100 || !record(item.params) || !encodedImage(item.image, 8 * 1024 * 1024)) throw Error('徽记素材无效')
+  }
+  const validEntry = entry => record(entry) && (entry.kind === 'builtin' ? transferBuiltins.includes(entry.key) : entry.kind === 'custom' && Number.isInteger(entry.asset) && entry.asset >= 0 && entry.asset < items.length && typeof entry.label === 'string' && entry.label.length <= 100)
+  if ((hero !== null && (!validEntry(hero) || hero.kind !== 'custom')) || !conversation.every(validEntry)) throw Error('徽记引用无效')
+  return value
+}
+
+export function mergeThemePreferences(current, imported) {
+  const normalized = normalizePreferences(imported)
+  const patch = Object.fromEntries(Object.keys(DEFAULT_PREFERENCES).filter(key => key !== 'version' && Object.hasOwn(imported, key)).map(key => [key, normalized[key]]))
+  return normalizePreferences({ ...current, ...patch, version: DEFAULT_PREFERENCES.version })
+}
+
+export function describeThemePackage(value) {
+  const count = Object.keys(value.preferences).filter(key => key !== 'version' && Object.hasOwn(DEFAULT_PREFERENCES, key)).length
+  if (!value.assets) return `${count} 项主题设置；不包含素材，将保留当前背景、头像和徽记。`
+  const a = value.assets
+  return `${count} 项主题设置、${transferSlots.filter(k => a.backgrounds[k]).length} 张背景、${transferRoles.filter(k => a.avatars[k]).length} 个头像、${a.emblems.items.length} 个自定义徽记。将替换当前素材及徽记排列，空项恢复为默认。`
+}
+
+export function createThemeTransfer({ window, getPreferences, savePreferences, checkWritable, checkExport = checkWritable, themeVersion }) {
+  let busy = false, backup
+  const request = async (path, data) => {
+    const response = await window.fetch('/prts-theme-api/' + path, { credentials: 'same-origin',
+      ...(data === undefined ? {} : { method: 'POST', headers: { 'content-type': 'application/json', 'x-prts-request': '1' }, body: JSON.stringify(data) }) })
+    const result = await response.json()
+    if (!response.ok) throw Error(result.error || '无法连接主题素材服务')
+    return result
+  }
+  const readImage = blob => new Promise((resolve, reject) => {
+    const reader = new window.FileReader()
+    reader.onload = () => resolve(String(reader.result).split(',')[1])
+    reader.onerror = () => reject(Error('无法读取背景图片'))
+    reader.readAsDataURL(blob)
+  })
+  async function capture(includeAssets) {
+    const value = { format: 'prts-theme', version: 1, themeVersion, exportedAt: new Date().toISOString(), preferences: { ...getPreferences() } }
+    const states = {}
+    if (includeAssets) {
+      const backgrounds = {}, avatars = {}, items = [], ids = new Map()
+      states.backgrounds = await request('backgrounds/configuration')
+      for (const slot of transferSlots) {
+        const entry = states.backgrounds[slot]
+        backgrounds[slot] = null
+        if (entry) {
+          if (!/^[a-f0-9-]{36}$/.test(entry.id)) throw Error('背景引用无效')
+          const response = await window.fetch('/prts-theme-api/backgrounds/image/' + entry.id, { credentials: 'same-origin' })
+          if (!response.ok) throw Error('无法导出背景图片')
+          backgrounds[slot] = await readImage(await response.blob())
+        }
+      }
+      states.avatars = await request('avatars/configuration')
+      for (const role of transferRoles) {
+        const source = await request('avatars/edit/' + role)
+        if (source.revision !== states.avatars.revision) throw Error('头像已变化，请重新导出')
+        avatars[role] = source.image ? { image: source.image, crop: source.crop } : null
+      }
+      states.emblems = await request('emblems/configuration')
+      async function reference(entry) {
+        if (!entry) return null
+        if (entry.kind === 'builtin') return { kind: 'builtin', key: entry.key, label: entry.label }
+        if (!ids.has(entry.draftId)) {
+          ids.set(entry.draftId, items.length)
+          items.push(await request('emblems/draft/' + encodeURIComponent(entry.draftId) + '/export'))
+        }
+        return { kind: 'custom', asset: ids.get(entry.draftId), label: entry.label }
+      }
+      const hero = await reference(states.emblems.configuration.hero), conversation = []
+      for (const entry of states.emblems.configuration.conversation) conversation.push(await reference(entry))
+      value.assets = { backgrounds, avatars, emblems: { items, hero, conversation } }
+      for (const kind of ['backgrounds', 'avatars', 'emblems']) {
+        if ((await request(kind + '/configuration')).revision !== states[kind].revision) throw Error('素材在导出期间发生变化，请重试')
+      }
+    }
+    if (JSON.stringify(value.preferences) !== JSON.stringify(getPreferences())) throw Error('设置在导出期间发生变化，请重试')
+    validateThemePackage(value)
+    return { value, states }
+  }
+  async function exclusive(fn) {
+    if (busy) throw Error('正在处理主题文件，请稍候')
+    busy = true
+    try { return await fn() } finally { busy = false }
+  }
+  function download(value, name = 'theme') {
+    const blob = new window.Blob([JSON.stringify(value)], { type: 'application/json' })
+    if (blob.size > THEME_PACKAGE_LIMIT) throw Error('主题文件超过 160 MB，请减少素材后重试')
+    const url = window.URL.createObjectURL(blob), link = window.document.createElement('a')
+    link.href = url; link.download = `prts-${name}-${new Date().toISOString().replace(/[:.]/g, '-')}.prts-theme.json`
+    window.document.body.append(link); link.click(); link.remove()
+    window.setTimeout(() => window.URL.revokeObjectURL(url), 1000)
+  }
+  async function apply(value) {
+    validateThemePackage(value)
+    const preferenceRevision = checkWritable()
+    const before = await capture(Boolean(value.assets))
+    backup = before.value
+    download(backup, 'before-import')
+    const undo = [], revisions = Object.fromEntries(Object.entries(before.states).map(([key, state]) => [key, state.revision]))
+    const write = async (kind, data, previous) => {
+      const result = await request(kind + '/configuration', { ...data, revision: revisions[kind] })
+      revisions[kind] = result.revision
+      undo.push(async () => {
+        const restored = await request(kind + '/configuration', { ...previous, revision: revisions[kind] })
+        revisions[kind] = restored.revision
+      })
+    }
+    try {
+      if (value.assets) {
+        const a = value.assets, old = before.value.assets, drafts = []
+        // Generate every custom draft before changing the active configuration.
+        for (const item of a.emblems.items) drafts.push(await request('emblems/import', item))
+        const entry = (ref, index) => ref === null ? null : ref.kind === 'builtin' ? ref : { kind: 'custom', key: 'import-' + index + '-' + drafts[ref.asset].draftId, label: ref.label, draftId: drafts[ref.asset].draftId }
+        const configuration = { version: 2, hero: entry(a.emblems.hero, 'hero'), conversation: a.emblems.conversation.map(entry) }
+        for (const slot of transferSlots) await write('backgrounds', { slot, image: a.backgrounds[slot] }, { slot, image: old.backgrounds[slot] })
+        for (const role of transferRoles) await write('avatars', { role, image: a.avatars[role]?.image ?? null, crop: a.avatars[role]?.crop }, { role, image: old.avatars[role]?.image ?? null, crop: old.avatars[role]?.crop })
+        await write('emblems', { configuration }, { configuration: before.states.emblems.configuration })
+      }
+      await savePreferences(mergeThemePreferences(before.value.preferences, value.preferences), preferenceRevision)
+    } catch (error) {
+      let failures = 0
+      for (const restore of undo.reverse()) { try { await restore() } catch { failures++ } }
+      throw Error(`${error.message}。${failures ? '部分素材未能自动恢复。' : '已回退已确认写入的素材。'}若连接中断，请检查实际状态；导入前备份已发起下载，可重新导入恢复。`)
+    }
+  }
+  return {
+    export: includeAssets => exclusive(async () => { checkExport(); return (await capture(includeAssets)).value }),
+    import: value => exclusive(() => apply(value)),
+    restore: () => exclusive(() => { if (!backup) throw Error('没有可恢复的备份'); return apply(backup) }),
+    get hasBackup() { return Boolean(backup) },
+    download,
+  }
+}

package/src/index.js

@@ -19,7 +19,7 @@ export const Config = Schema.object(Object.fromEntries([
   ['preferencesInitialized', Schema.boolean().default(false).volatile()],
 ]))
 
-export async function apply(ctx) {
+export async function apply(ctx, config = {}) {
   ctx.inject(['settings'], settingsCtx => {
     settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber))
   })
@@ -27,7 +27,24 @@ export async function apply(ctx) {
   const service=await createEmblemService(directory)
   const backgrounds=await createBackgroundService(join(directory,'..','backgrounds'))
   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),registerBackgroundApi(ctx,backgrounds))
-  ctx.effect(()=>async()=>{for(const dispose of disposers.reverse())dispose();await service.dispose();await backgrounds.dispose()})
+  const definitions=[...emblemTools(service,ctx.attachments),...avatarTools(avatars,ctx.attachments)]
+  let toolDisposers=[]
+  const syncTools=()=>{
+    const enabled=(config.aiToolsEnabled?.get?.() ?? config.aiToolsEnabled) !== false
+    if(enabled && !toolDisposers.length) {
+      for(const tool of definitions)toolDisposers.push(ctx.tools.register(tool))
+    } else if(!enabled) {
+      for(const dispose of toolDisposers.splice(0).reverse())dispose()
+    }
+  }
+  syncTools()
+  // Host volatile fields are updated before this notification; they expose get(), not subscribe().
+  const stopConfig=ctx.on('app-boot/config-reload',syncTools)
+  const disposers=[registerEmblemApi(ctx,service),registerAvatarApi(ctx,avatars),registerBackgroundApi(ctx,backgrounds)]
+  ctx.effect(()=>async()=>{
+    stopConfig()
+    for(const dispose of toolDisposers.splice(0).reverse())dispose()
+    for(const dispose of disposers.reverse())dispose()
+    await service.dispose();await backgrounds.dispose()
+  })
 }

package/src/styles/custom-background.css

@@ -329,3 +329,17 @@ animation: prts-baker-typing 1.2s linear infinite;
 33% { background: currentColor; box-shadow: -10px 0 0 color-mix(in srgb,currentColor 30%,transparent), 10px 0 0 color-mix(in srgb,currentColor 30%,transparent); }
 66% { background: color-mix(in srgb,currentColor 30%,transparent); box-shadow: -10px 0 0 color-mix(in srgb,currentColor 30%,transparent), 10px 0 0 currentColor; }
 }
+
+/* Keep the hero treatment beside the background readability controls. */
+html[data-dsh-prts] [data-prts-background-hero-setting] {
+  padding:16px 0 2px; border-top:1px solid var(--prts-line);
+  & [data-prts-setting-row] { display:grid; grid-template-columns:minmax(0,1fr) auto; align-items:center; gap:20px; margin:0; padding:0; border:0; background:none; }
+  & [data-prts-setting-row] > span { display:grid; gap:5px; min-width:0; }
+  & strong { font:500 13px/1.5 var(--prts-body); color:var(--prts-ink); }
+  & small { max-width:36em; font:400 12px/1.6 var(--prts-body); color:var(--prts-muted); }
+  & [data-prts-setting-switch] { justify-self:end; align-self:center; margin:0; }
+}
+html[data-dsh-prts] [data-prts-background-hero-setting][hidden] { display:none; }
+
+/* Windows chrome must not clip a different canvas color into the conversation. */
+html[data-dsh-prts][data-windows-titlebar] [data-prts-region="operation"] { border-radius: 0; }

package/src/styles/facility-vector.css

@@ -776,10 +776,10 @@ html[data-dsh-prts] [data-prts-preview-body] a { color:var(--prts-cyan);text-dec
 html[data-dsh-prts] [data-prts-preview-message] + [data-prts-preview-message] { margin-top:5px; }
 html[data-dsh-prts] [data-prts-preview-message] > small { display:block;margin-bottom:6px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
 
-html[data-dsh-prts] [data-prts-reply-entry] { display:flex;align-items:flex-start;gap:8px;width:100%;padding:6px 8px;text-align:left;border:1px solid var(--prts-line);border-radius:5px;background:transparent;color:var(--prts-ink);cursor:pointer; }
-html[data-dsh-prts] [data-prts-reply-entry]:is(:hover,:focus-visible,[data-prts-reply-active]) { background:color-mix(in srgb,var(--prts-ink) 7%,transparent);border-color:var(--prts-muted); }
-html[data-dsh-prts] [data-prts-reply-entry] small { flex:0 0 auto;white-space:nowrap;padding-top:2px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
-html[data-dsh-prts] [data-prts-reply-entry] span { min-width:0;flex:1;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;font:12px/1.6 var(--prts-body);overflow-wrap:anywhere; }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) { display:flex;align-items:flex-start;gap:8px;width:100%;padding:6px 8px;text-align:left;border:1px solid var(--prts-line);border-radius:5px;background:transparent;color:var(--prts-ink);cursor:pointer; }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]):is(:hover,:focus-visible,[data-prts-reply-active]) { background:color-mix(in srgb,var(--prts-ink) 7%,transparent);border-color:var(--prts-muted); }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) small { flex:0 0 auto;white-space:nowrap;padding-top:2px;color:var(--prts-muted);font:10px/1.5 var(--prts-mono); }
+html[data-dsh-prts] :is([data-prts-reply-entry],[data-prts-tool-entry]) span { min-width:0;flex:1;display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;font:12px/1.6 var(--prts-body);overflow-wrap:anywhere; }
 html[data-dsh-prts] [data-prts-reply-detail]:not([data-prts-preview-question]) > [data-prts-preview-body] { max-height:190px; }
 
 html[data-dsh-prts] [data-prts-preview-marker] { display:none;flex:none;margin-left:auto;color:var(--prts-muted);font:600 9px/1.4 var(--prts-body); }
@@ -864,3 +864,25 @@ html[data-dsh-prts] [data-prts-summary-dismissed] [data-prts-session-summary-pop
   pointer-events: none !important;
   transition: none;
 }
+
+html[data-dsh-prts] [data-prts-preview-tool] { margin-top:8px; }
+html[data-dsh-prts] [data-prts-preview-tool][hidden] { display:none; }
+html[data-dsh-prts] [data-prts-preview-tool] > button { box-sizing:border-box;height:32px;align-items:center;gap:7px;padding:4px 8px;overflow:hidden;border-left:2px solid var(--prts-cyan);background:color-mix(in srgb,var(--prts-cyan) 7%,transparent); }
+html[data-dsh-prts] [data-prts-tool-entry]::before { content:">_";flex:none;color:var(--prts-cyan);font:600 11px var(--prts-mono); }
+html[data-dsh-prts] [data-prts-preview-tool] small { padding:0;color:var(--prts-cyan); }
+html[data-dsh-prts] [data-prts-preview-tool] span { display:block;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;font:11px/1.6 var(--prts-mono); }
+
+html[data-dsh-prts] [data-prts-summary-reply] > [data-prts-preview-body]:empty { display:none;margin:0; }
+
+html[data-dsh-prts] [data-prts-preview-message] > [data-prts-reply-entry] { border-color:transparent;border-radius:3px; }
+html[data-dsh-prts] [data-prts-reply-entry] small { display:flex;align-items:center;gap:4px;color:#8aaee0; }
+html[data-dsh-prts] [data-prts-reply-entry] svg { width:14px;height:14px;flex:none;fill:none;stroke:currentColor;stroke-width:1.2; }
+
+html[data-dsh-prts][data-prts-scheme="light"] [data-prts-reply-entry] small { color:#476b9c; }
+
+html[data-dsh-prts] [data-prts-summary-reply][data-prts-tool-history] > [data-prts-preview-body] { height:190px;max-height:190px; }
+html[data-dsh-prts] [data-prts-tool-record] { padding:8px 0;border-bottom:1px solid var(--prts-line); }
+html[data-dsh-prts] [data-prts-tool-record] > div { display:flex;align-items:baseline;gap:8px; }
+html[data-dsh-prts] [data-prts-tool-record] b { flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;color:var(--prts-cyan);font:11px/1.6 var(--prts-mono); }
+html[data-dsh-prts] [data-prts-tool-record] small { flex:none;color:var(--prts-muted);font-size:10px; }
+html[data-dsh-prts] [data-prts-tool-record] p { display:-webkit-box;-webkit-box-orient:vertical;-webkit-line-clamp:2;overflow:hidden;margin:4px 0 0; }

package/src/styles/refinement.css

@@ -482,3 +482,25 @@ html[data-dsh-prts][data-prts-conversation-style="deck-chat"] :is([class$="_bubb
   padding:2px 7px!important;border-radius:6px!important;
   &:is(:hover,:focus-visible){border-color:var(--prts-cyan)!important}
 }
+
+/* Notification cards own one surface across the disclosure and its content. */
+html[data-dsh-prts] [data-turn-trigger] {
+  background:var(--prts-glass-soft-surface);
+  border:1px solid var(--prts-line);
+  border-radius:var(--dsw-radius-xl,16px);
+  -webkit-backdrop-filter:blur(12px);
+  backdrop-filter:blur(12px);
+  color:var(--prts-ink);
+  & > button {
+    background:transparent;
+    border:0;
+    border-radius:inherit;
+    color:inherit;
+    &:hover { background:color-mix(in srgb,var(--prts-ink) 5%,transparent); }
+    &:focus-visible { outline:2px solid var(--prts-cyan); outline-offset:-3px; }
+    & time { color:var(--prts-muted); }
+  }
+  & > div { border-top:1px solid var(--prts-line); }
+  & > div > p { color:var(--prts-muted); }
+  & [data-context-text] { color:var(--prts-ink); }
+}