@dickpy/dsh-imagegen 1.5.0 → 1.5.2

package/src/client/api.ts

@@ -3,7 +3,7 @@
  * data access path the panel uses — plain fetch, same origin.
  */
 
-import { CONVERSATION_IMAGE_API, GALLERY_API, GENERATE_API, HISTORY_API, PROMPT_ENHANCE_API, TASK_API, TEMPLATES_API, UPDATE_API, type GenerateRequest, type GenerateResult, type GenerationTask, type HistoryEntry, type HistoryEntryInput, type TemplateListResult, type TemplateRefreshResult, type UpdateInfo } from '../protocol.ts'
+import { CONVERSATION_IMAGE_API, GALLERY_API, GENERATE_API, HISTORY_API, PROMPT_ENHANCE_API, TASK_API, TEMPLATE_FAVORITES_API, TEMPLATES_API, UPDATE_API, type GenerateRequest, type GenerateResult, type GenerationTask, type HistoryEntry, type HistoryEntryInput, type TemplateCase, type TemplateFavorite, type TemplateListResult, type TemplateRefreshResult, type TemplateSample, type UpdateInfo } from '../protocol.ts'
 
 /** Error carrying the route's JSON error message. */
 export class ImageGenApiError extends Error {
@@ -181,11 +181,12 @@ export class ImageGenApi {
     return (await readEnvelope<{ ok: true; entries: HistoryEntry[] }>(response)).entries
   }
 
-  /** Fetch the prompt-template library (bundled snapshot or refreshed copy). */
-  async templatesList(): Promise<TemplateListResult> {
-    const response = await fetch(TEMPLATES_API.list, { method: 'POST' })
+  /** Fetch one template source's list (bundled snapshot or refreshed copy). */
+  async templatesList(sourceId: string): Promise<TemplateListResult> {
+    const response = await fetch(TEMPLATES_API.list, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ source: sourceId }) })
     const body = await readEnvelope<TemplateListResult & { ok: true }>(response)
     return {
+      sourceId: body.sourceId,
       cases: body.cases,
       total: body.total,
       origin: body.origin,
@@ -194,10 +195,42 @@ export class ImageGenApi {
     }
   }
 
-  /** Re-download the template library from the upstream mirror (host-side). */
-  async templatesRefresh(): Promise<TemplateRefreshResult> {
-    const response = await fetch(TEMPLATES_API.refresh, { method: 'POST' })
+  /** Re-download one template source's list from its upstream mirror (host-side). */
+  async templatesRefresh(sourceId: string): Promise<TemplateRefreshResult> {
+    const response = await fetch(TEMPLATES_API.refresh, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ source: sourceId }) })
     const body = await readEnvelope<TemplateRefreshResult & { ok: true }>(response)
-    return { total: body.total, fetchedAt: body.fetchedAt }
+    return { sourceId: body.sourceId, total: body.total, fetchedAt: body.fetchedAt }
+  }
+
+  /** Draw random cases across every source (studio inspiration wall). */
+  async templatesSample(count: number): Promise<TemplateSample[]> {
+    const response = await fetch(TEMPLATES_API.sample, { method: 'POST', headers: { 'content-type': 'application/json' }, body: JSON.stringify({ count }) })
+    return (await readEnvelope<{ ok: true; samples: TemplateSample[] }>(response)).samples
+  }
+
+  /** List the host-persisted template favorites. */
+  async favoritesList(): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.list, { method: 'POST' })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
+  }
+
+  /** Star one template (the host keeps a full case snapshot). */
+  async favoritesAdd(sourceId: string, item: TemplateCase): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.add, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ source: sourceId, case: item }),
+    })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
+  }
+
+  /** Unstar one template by its favorites key. */
+  async favoritesRemove(key: string): Promise<TemplateFavorite[]> {
+    const response = await fetch(TEMPLATE_FAVORITES_API.remove, {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ key }),
+    })
+    return (await readEnvelope<{ ok: true; favorites: TemplateFavorite[] }>(response)).favorites
   }
 }

package/src/client/channels-form.ts

@@ -12,7 +12,7 @@
  *  - path ops never navigate *inside* the channels array.
  */
 
-import { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-store'
 import type { ChannelConfig, ModelMapping } from '../protocol.ts'
 import type { ImageGenScope, SettingsOp } from './settings-scope.ts'
 

package/src/client/conversation-sync.ts

@@ -1,6 +1,6 @@
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment'
 import type { ConversationController, IConversation } from '@deepseek-ai/dsh-client-ui-conversation/client'
-import type { SessionId } from '@deepseek-ai/dsh-client-runtime/client'
+import type { SessionId } from '@deepseek-ai/dsh-api-remotes/client'
 
 /** Document event used to bridge chat tool results into the image workspace. */
 export const CHAT_IMAGE_EVENT = 'dsh-imagegen:chat-images'

package/src/client/image-toolview.tsx

@@ -1,7 +1,10 @@
 /** Inline renderer for image-generation tool-result attachments. */
 
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment'
-import type { ClientContext, SessionId, ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { SessionId } from '@deepseek-ai/dsh-api-remotes/client'
+import type { ToolCallBlock } from '@deepseek-ai/dsh-client-ui-conversation/client'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
 import { useEffect, useMemo, useState } from 'react'
 import { AGENT_IMAGE_API } from '../protocol.ts'
 import { CHAT_IMAGE_EVENT } from './conversation-sync.ts'
@@ -31,10 +34,9 @@ function isSettled(block: ToolCallBlock): block is Extract<ToolCallBlock, { kind
   return 'kind' in block
 }
 
-function imageRefsOf(block: ToolCallBlock): ImageAttachmentRef[] {
-  if (!isSettled(block)) return []
-  const resultContent = block.resultView?.card === 'generic' ? block.resultView.content ?? [] : []
-  return [...block.content, ...resultContent]
+function imageRefsOf(block: ToolCallBlock): ImageAttachmentRef[] {
+  if (!isSettled(block)) return []
+  return block.content
     .flatMap(content => content.type === 'image' ? [content.attachment] : [])
 }
 
@@ -169,8 +171,12 @@ export function registerImageToolviews(ctx: ClientContext): void {
   }
 
   ctx.slots.inject('tool.call.toolview', function* () {
-    for (const key of ['generate_image', 'edit_image', 'get_image_generation_task']) {
-      yield ctx.slots.register({ name: 'tool.call.toolview', key }, ImageToolView)
-    }
-  })
-}
+    for (const key of ['generate_image', 'edit_image', 'get_image_generation_task']) {
+      yield ctx.slots.register({
+        name: 'tool.call.toolview',
+        key,
+        inject: (sessionId: string) => ({ sessionId: sessionId as SessionId }),
+      }, ImageToolView)
+    }
+  })
+}

package/src/client/index.ts

@@ -11,12 +11,13 @@
  * whole boot when a plugin apply throws, and an external plugin must not take
  * the GUI down.
  */
-import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
-import type { ISessions } from '@deepseek-ai/dsh-client-runtime/client'
+import type { Context as ClientContext } from '@deepseek-ai/cordis'
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'
 import type { ConnectionHandle } from '@deepseek-ai/dsh-client-connection/client'
 // Type-only: pulls the locale plugin's Context merge (ctx.locale).
-import type {} from '@deepseek-ai/dsh-client-locale/client'
-// Type-only: pulls the LocaleNamespaceMap merge table.
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+import type {} from '@deepseek-ai/dsh-client-ui-renderer/client'
+// Type-only: pulls the LocaleNamespaceMap merge table.
 import type {} from '@deepseek-ai/dsh-client-ui-slots'
 import { ImageGenApi } from './api.ts'
 import { ImageGenController } from './controller.ts'

package/src/client/inspiration.module.css

@@ -0,0 +1,148 @@
+/**
+ * Inspiration-wall styles for the studio's empty canvas. Same conventions as
+ * panel.module.css: dsh --dsw-* tokens, scoped to this component's subtree.
+ */
+
+.wrap {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 16px;
+  width: min(880px, 100%);
+  margin: auto;
+  padding: 24px;
+  font-family: var(--dsw-font-family);
+}
+
+.title {
+  font-size: 15px;
+  font-weight: 650;
+  color: var(--dsw-alias-label-primary);
+}
+
+/* Fallback (sample failed / libraries empty): mirrors the panel's plain
+   canvas empty state so the swap is invisible. */
+.emptyIcon {
+  display: inline-flex;
+  color: var(--dsw-alias-label-dimmed);
+}
+
+.emptyTitle {
+  margin-top: -6px;
+  font-size: 15px;
+  font-weight: 650;
+  color: var(--dsw-alias-label-primary);
+}
+
+.emptyHint {
+  font-size: 12.5px;
+  color: var(--dsw-alias-label-tertiary);
+}
+
+.grid {
+  display: grid;
+  grid-template-columns: repeat(4, 1fr);
+  gap: 12px;
+  width: 100%;
+}
+
+/* Narrow canvases: fold the wall down instead of shrinking tiles into slivers. */
+@media (max-width: 900px) {
+  .grid {
+    grid-template-columns: repeat(3, 1fr);
+  }
+}
+
+@media (max-width: 560px) {
+  .grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
+}
+
+.tile {
+  position: relative;
+  display: block;
+  width: 100%;
+  aspect-ratio: 1 / 1;
+  padding: 0;
+  overflow: hidden;
+  border: 1px solid var(--dsw-alias-border-l1);
+  border-radius: 12px;
+  background: var(--dsw-alias-bg-layer-1);
+  cursor: pointer;
+  transition: transform 0.15s ease, border-color 0.15s ease, box-shadow 0.15s ease;
+}
+
+.tile:hover {
+  border-color: var(--dsw-alias-brand-primary);
+  transform: translateY(-2px);
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.12);
+}
+
+.thumbWrap {
+  position: absolute;
+  inset: 0;
+  display: block;
+}
+
+.thumb {
+  display: block;
+  width: 100%;
+  height: 100%;
+  object-fit: cover;
+}
+
+.thumbFallback {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 100%;
+  height: 100%;
+  padding: 6px;
+  overflow: hidden;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 11px;
+  line-height: 1.4;
+  text-align: center;
+}
+
+.thumbTitle {
+  position: absolute;
+  inset: auto 0 0 0;
+  padding: 14px 8px 6px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  background: linear-gradient(transparent, rgba(0, 0, 0, 0.55));
+  color: #ffffff;
+  font-size: 10.5px;
+  text-align: center;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+  pointer-events: none;
+}
+
+.tile:hover .thumbTitle {
+  opacity: 1;
+}
+
+.spinner {
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--dsw-alias-border-l2);
+  border-top-color: var(--dsw-alias-brand-primary);
+  border-radius: 50%;
+  animation: dsh-imagegen-inspiration-spin 0.9s linear infinite;
+}
+
+@keyframes dsh-imagegen-inspiration-spin {
+  to { transform: rotate(360deg); }
+}
+
+/* Touch shells have no hover: keep titles visible. */
+@media (hover: none) {
+  .thumbTitle {
+    opacity: 1;
+  }
+}

package/src/client/locales.ts

@@ -301,6 +301,7 @@ export const zh = {
   // template library
   'templates.open': '模板库',
   'templates.title': '提示词模板库',
+  'templates.sources': '模板库来源',
   'templates.meta': '共 {count} 个模板 · {origin}',
   'templates.origin.bundled': '内置快照',
   'templates.origin.refreshed': '在线刷新',
@@ -311,21 +312,33 @@ export const zh = {
   'templates.use': '使用此提示词',
   'templates.copy': '复制提示词',
   'templates.copied': '已复制',
-  'templates.refresh': '刷新模板库',
+  'templates.refresh': '刷新本库',
   'templates.refreshing': '刷新中…',
   'templates.refreshed': '已刷新，共 {count} 个模板',
   'templates.refreshFailed': '刷新失败：{error}',
+  'templates.favorites': '收藏',
+  'templates.favoritesHint': '只看已收藏的模板',
+  'templates.favoritesEmpty': '还没有收藏，点击模板卡片右上角的星标即可收藏',
+  'templates.favoriteAdd': '收藏此模板',
+  'templates.favoriteRemove': '取消收藏',
+  'templates.favorite': '收藏',
+  'templates.unfavorite': '已收藏',
   'templates.cacheAll': '缓存全部图片',
-  'templates.cacheAllHint': '通过本机代理把全部参考图缓存到本地磁盘，之后离线也能浏览',
+  'templates.cacheAllHint': '通过本机代理把当前模板库的全部参考图缓存到本地磁盘，之后离线也能浏览',
   'templates.caching': '缓存中 {done}/{total}…',
   'templates.cached': '图片已全部缓存',
   'templates.empty': '没有匹配的模板',
   'templates.loading': '正在加载模板库…',
   'templates.loadFailed': '模板库加载失败：{error}',
   'templates.retry': '重试',
-  'templates.attribution': '模板与图片来自 awesome-gpt-image-2 项目，作者链接见各模板详情',
-  'templates.source': '来源：vibeui.top',
+  'templates.attribution': '模板与图片来自各来源站点，作者链接见模板详情',
+  'templates.source': '来源：{label}',
   'templates.featured': '精选',
+  // inspiration wall (studio empty state)
+  'inspiration.title': '灵感案例',
+  'inspiration.shuffle': '随机',
+  'inspiration.shuffling': '换一批…',
+  'inspiration.useHint': '点击使用该提示词',
   // channel management
   'channels.title': '渠道',
   'channels.hint': '填写各渠道的 API 地址与密钥即可使用对应模型',
@@ -665,6 +678,7 @@ export const en: Record<keyof typeof zh, string> = {
   // template library
   'templates.open': 'Templates',
   'templates.title': 'Prompt Template Library',
+  'templates.sources': 'Template sources',
   'templates.meta': '{count} templates · {origin}',
   'templates.origin.bundled': 'bundled snapshot',
   'templates.origin.refreshed': 'refreshed online',
@@ -675,21 +689,33 @@ export const en: Record<keyof typeof zh, string> = {
   'templates.use': 'Use this prompt',
   'templates.copy': 'Copy prompt',
   'templates.copied': 'Copied',
-  'templates.refresh': 'Refresh library',
+  'templates.refresh': 'Refresh this library',
   'templates.refreshing': 'Refreshing…',
   'templates.refreshed': 'Refreshed — {count} templates',
   'templates.refreshFailed': 'Refresh failed: {error}',
+  'templates.favorites': 'Favorites',
+  'templates.favoritesHint': 'Show favorited templates only',
+  'templates.favoritesEmpty': 'No favorites yet — tap the star in a card\'s top-right corner to save one',
+  'templates.favoriteAdd': 'Favorite this template',
+  'templates.favoriteRemove': 'Remove from favorites',
+  'templates.favorite': 'Favorite',
+  'templates.unfavorite': 'Favorited',
   'templates.cacheAll': 'Cache all images',
-  'templates.cacheAllHint': 'Mirror every reference image to local disk through the host proxy, for offline browsing',
+  'templates.cacheAllHint': 'Mirror every reference image of the current library to local disk through the host proxy, for offline browsing',
   'templates.caching': 'Caching {done}/{total}…',
   'templates.cached': 'All images cached',
   'templates.empty': 'No matching templates',
   'templates.loading': 'Loading the template library…',
   'templates.loadFailed': 'Failed to load the library: {error}',
   'templates.retry': 'Retry',
-  'templates.attribution': 'Templates and images come from the awesome-gpt-image-2 project; author links are on each template',
-  'templates.source': 'Source: vibeui.top',
+  'templates.attribution': 'Templates and images come from each source site; author links are on each template',
+  'templates.source': 'Source: {label}',
   'templates.featured': 'Featured',
+  // inspiration wall (studio empty state)
+  'inspiration.title': 'Inspiration',
+  'inspiration.shuffle': 'Shuffle',
+  'inspiration.shuffling': 'Shuffling…',
+  'inspiration.useHint': 'Click to use this prompt',
   // channel management
   'channels.title': 'Channels',
   'channels.hint': 'Fill in each channel\'s API URL and key to use its models',

package/src/client/mount.tsx

@@ -15,7 +15,7 @@
  * and both get the `position: relative` base in panel.module.css.
  */
 
-import type { ISessions } from '@deepseek-ai/dsh-client-runtime/client'
+import type { ISessions } from '@deepseek-ai/dsh-api-session-controller/client'
 import { createRoot, type Root } from 'react-dom/client'
 import type { ImageGenApi } from './api.ts'
 import type { ImageGenController } from './controller.ts'

package/src/client/settings-form.ts

@@ -7,7 +7,8 @@
  * sibling UI package).
  */
 
-import { createSnapshotStore, type SettingsScope, type SettingsScopeSnapshot, type SnapshotStore } from '@deepseek-ai/dsh-client-runtime/client'
+import { createSnapshotStore, type SnapshotStore } from '@deepseek-ai/dsh-client-store'
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'
 
 /** The write one field's staged text performs when the card is saved. */
 export type FieldWrite =

package/src/client/settings-scope.ts

@@ -10,10 +10,10 @@
 
 import {
   createSnapshotStore,
-  type SettingsScope,
-  type SettingsScopeSnapshot,
   type SnapshotStore,
-} from '@deepseek-ai/dsh-client-runtime/client'
+} from '@deepseek-ai/dsh-client-store'
+import type { SettingsPathOpView } from '@deepseek-ai/dsh-api-remotes/client'
+import type { SettingsScope, SettingsScopeSnapshot } from '@deepseek-ai/dsh-client-ui-settings/client'
 import { SETTINGS_API, type ChannelConfig } from '../protocol.ts'
 
 /** The fields this plugin's settings card edits. */
@@ -158,6 +158,10 @@ class BridgeScopeController<T> implements SettingsScope<T> {
     return this.enqueue(() => this.writeOps([{ op: 'unset', path: [field] }]))
   }
 
+  mutate(ops: readonly SettingsPathOpView[], expectedRevision?: number): Promise<void> {
+    return this.enqueue(() => this.writeOps([...ops] as SettingsOp[], expectedRevision))
+  }
+
   /** Apply several path ops in one revision-fenced mutate call (atomic save).
    *  Path ops may address plain-object fields (e.g. `channelSecrets.<id>`),
    *  but never navigate *inside* arrays — write array fields wholesale. */
@@ -206,8 +210,8 @@ class BridgeScopeController<T> implements SettingsScope<T> {
     this.accept(view, writable)
   }
 
-  private async writeOps(ops: SettingsOp[]): Promise<void> {
-    const revision = this.getSnapshot().revision
+  private async writeOps(ops: SettingsOp[], expectedRevision?: number): Promise<void> {
+    const revision = expectedRevision ?? this.getSnapshot().revision
     let response
     try {
       response = await this.api.mutate({

package/src/client/templates.module.css

@@ -92,6 +92,60 @@
   color: var(--dsw-alias-label-primary);
 }
 
+/* --- source tabs --------------------------------------------------------- */
+
+.sourceTabs {
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 0 18px 10px;
+  border-bottom: 1px solid var(--dsw-alias-border-l1);
+  flex: none;
+}
+
+.sourceTab {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  height: 30px;
+  padding: 0 14px;
+  border: 1px solid transparent;
+  border-radius: 9px 9px 0 0;
+  border-bottom: none;
+  background: transparent;
+  color: var(--dsw-alias-label-secondary);
+  font-size: 13px;
+  font-weight: 600;
+  font-family: inherit;
+  cursor: pointer;
+  white-space: nowrap;
+}
+
+.sourceTab:hover {
+  color: var(--dsw-alias-label-primary);
+  background: var(--dsw-alias-interactive-bg-hover);
+}
+
+.sourceTab[data-active] {
+  border-color: var(--dsw-alias-border-l1);
+  border-radius: 9px;
+  background: var(--dsw-alias-bg-layer-1);
+  color: var(--dsw-alias-brand-primary);
+}
+
+.sourceTabCount {
+  padding: 0 6px;
+  border-radius: 999px;
+  background: var(--dsw-alias-bg-layer-2);
+  color: var(--dsw-alias-label-tertiary);
+  font-size: 11px;
+  font-weight: 500;
+}
+
+.sourceTab[data-active] .sourceTabCount {
+  color: var(--dsw-alias-label-secondary);
+}
+
 /* --- toolbar ----------------------------------------------------------- */
 
 .toolbar {
@@ -263,6 +317,47 @@
   font-weight: 600;
 }
 
+.favStar {
+  position: absolute;
+  top: 6px;
+  right: 6px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+  padding: 0;
+  border: none;
+  border-radius: 8px;
+  background: rgba(0, 0, 0, 0.35);
+  color: rgba(255, 255, 255, 0.85);
+  cursor: pointer;
+  opacity: 0;
+  transition: opacity 0.15s ease;
+}
+
+.card:hover .favStar,
+.favStar:focus-visible,
+.favStar[data-active] {
+  opacity: 1;
+}
+
+.favStar:hover {
+  background: rgba(0, 0, 0, 0.55);
+  color: #ffffff;
+}
+
+.favStar[data-active] {
+  color: #ffb020;
+}
+
+/* Touch shells have no hover: keep the star reachable. */
+@media (hover: none) {
+  .favStar {
+    opacity: 1;
+  }
+}
+
 .cardBody {
   display: flex;
   flex-direction: column;

package/src/index.ts

@@ -8,7 +8,7 @@
  */
 
 import type { Context } from '@deepseek-ai/cordis'
-import { installSettingsSection, settingsNamespace } from '@deepseek-ai/dsh-settings'
+import { installSettingsSectionCompat, settingsNamespaceCompat } from './settings-compat.ts'
 import z from 'schemastery'
 // Type-only: pulls the webServer Context merge (route registration).
 import type {} from '@deepseek-ai/dsh-host-webserver'
@@ -20,6 +20,7 @@ import type {} from '@deepseek-ai/dsh-tools'
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment'
 import { IMAGEGEN_SETTINGS_NAMESPACE, type ChannelConfig, type ModelMapping } from './protocol.ts'
 import { makeRoutes, type SettingsSeam } from './routes.ts'
+import { syncAllTemplates } from './templates-store.ts'
 import { ImageGenerationRuntime, type ChannelsView, type RuntimeChannel } from './generation-runtime.ts'
 import { registerAgentImageTools } from './agent-image-tools.ts'
 import { registerEditImageCommand } from './edit-image-command.ts'
@@ -39,11 +40,12 @@ export { ImageGenerationRuntime } from './generation-runtime.ts'
 export { registerAgentImageTools } from './agent-image-tools.ts'
 export { latestSessionImage, registerEditImageCommand } from './edit-image-command.ts'
 export { appendGallery, clearGallery, listGallery, readGalleryImage, removeGallery, updateGalleryTags } from './gallery-store.ts'
-export { listTemplates, readTemplateImage, refreshTemplates, clearTemplateMemo } from './templates-store.ts'
+export { listTemplates, readTemplateImage, refreshTemplates, sampleTemplates, syncAllTemplates, clearTemplateMemo } from './templates-store.ts'
+export { addTemplateFavorite, clearTemplateFavoritesMemo, listTemplateFavorites, removeTemplateFavorite } from './template-favorites.ts'
 export { checkForUpdate, clearUpdateCache, compareVersions, CURRENT_VERSION, installUpdate, profileFromProcess } from './updater.ts'
 
 /** The branded settings namespace of this plugin (the card edits it). */
-export const ImageGenSettingsNamespace = settingsNamespace(IMAGEGEN_SETTINGS_NAMESPACE)
+export const ImageGenSettingsNamespace = settingsNamespaceCompat(IMAGEGEN_SETTINGS_NAMESPACE)
 
 /**
  * Plugin config, validated by the same-named schemastery schema.
@@ -115,7 +117,7 @@ const DEFAULT_ALLOW_AGENT_IMAGE_GENERATION = true
 const SECTION_ORDER = 150
 
 /** Model-facing announcement: plugin presence, capabilities, and limits. */
-export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：通过「渠道」对接 OpenAI 兼容图像生成 API（每个渠道 = 一个 API 端点 + 各自的模型目录），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送；智谱 `glm-image` 使用官方 `/api/paas/v4/images/generations`，当前仅支持文生图）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用用户在各渠道配置目录中的模型；检测模型时会过滤聊天、Embedding 等非图片模型，但模型出现在 /models 中仍不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选与复用。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。用户也可以使用 `/edit_image <修改描述>`，命令会直接读取当前对话最近图片并调用插件图片模型，不经过对话模型的图片能力检查。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问 vibeui.top。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
+export const IMAGEGEN_GUIDANCE = '本机已安装 dsh-imagegen 插件（DSH AI 生图）：侧边栏「AI 生图」入口。能力：通过「渠道」对接 OpenAI 兼容图像生成 API（每个渠道 = 一个 API 端点 + 各自的模型目录），支持文生图（/images/generations）与图生图（/images/edits，上传参考图，grok-imagine 模型按官方 JSON image_url 协议发送，nanobanana 系列按 aspect_ratio / image_size 参数协议发送；seedream 系列统一走 /images/generations，参考图以 JSON image 数组发送；智谱 `glm-image` 使用官方 `/api/paas/v4/images/generations`，当前仅支持文生图）。API 地址与密钥在 GUI 设置中按渠道配置，密钥仅存于本机设置文档；生成请求由本地宿主代理转发，结果以 base64 返回面板，可预览与下载。模型只能使用用户在各渠道配置目录中的模型；检测模型时会过滤聊天、Embedding 等非图片模型，但模型出现在 /models 中仍不等于其网关原生支持生图协议，遇到 Qwen、Gemini 等非 OpenAI 生图协议时应如实说明上游兼容性。可一键把满意的图片加入「画廊」。内置「提示词模板库」（面板提示词框左下角「模板库」按钮）：多来源标签页（精选案例库 / 沧河案例库，后续可扩展），打包 awesome-gpt-image-2 的数百条提示词案例，可搜索、筛选、收藏（星标，宿主持久化）与复用；各来源列表独立刷新，宿主每 12 小时后台自动同步一次。Agent 可直接调用 `generate_image` 提交文生图，也可用 `edit_image` 图生图；默认保持工具调用等待直到任务完成，完成图片显示在工具调用对应的左侧结果区域，模型收到状态和附件引用，不会额外伪造用户消息。用户也可以使用 `/edit_image <修改描述>`，命令会直接读取当前对话最近图片并调用插件图片模型，不经过对话模型的图片能力检查。若明确需要后台执行，可传 `wait_for_completion: false`，之后再用 `get_image_generation_task` 查询；不要反复轮询。限制：生成消耗上游 API 额度；图片内容由上游模型生成，可能不符合预期或包含不适宜内容；api_key 以明文存储在设置文档中；参考图会发送至所配置的 API 服务；模板库在线刷新与参考图首次加载需要访问对应来源站点（vibeui.top / gpt-image2.canghe.ai）。用户提到「生图 / 绘画 / 生成图片 / 文生图 / 图生图 / 画廊 / 提示词模板」时即指本插件，请据此协作。'
 
 /** Append the live channel × model table so an Agent can honor user choices. */
 function guidanceFor(channels: RuntimeChannel[], defaultChannelId: string): string {
@@ -276,7 +278,25 @@ export function apply(ctx: Context, config?: Config): void {
           runtime,
         })
         const disposers = routes.map(route => ctx.webServer.register(route))
-        return () => { for (const dispose of disposers) dispose() }
+        // Background template sync: the upstream sources update on their own
+        // schedule, so pull every one of them shortly after start and then
+        // twice a day while the plugin stays enabled. Best-effort: failures
+        // keep the last good snapshot (bundled or previously refreshed).
+        const TEMPLATE_SYNC_INITIAL_DELAY_MS = 30_000
+        const TEMPLATE_SYNC_INTERVAL_MS = 12 * 60 * 60 * 1000
+        let syncTimer: NodeJS.Timeout | undefined
+        const runSync = (): void => {
+          if (!resolve().enabled) return
+          void syncAllTemplates().catch(() => { /* keep the last good snapshot */ })
+        }
+        const startTimer = setTimeout(runSync, TEMPLATE_SYNC_INITIAL_DELAY_MS)
+        syncTimer = setInterval(runSync, TEMPLATE_SYNC_INTERVAL_MS)
+        syncTimer.unref?.()
+        return () => {
+          clearTimeout(startTimer)
+          clearInterval(syncTimer)
+          for (const dispose of disposers) dispose()
+        }
       },
       'dsh-imagegen: routes',
     )
@@ -323,7 +343,7 @@ export function apply(ctx: Context, config?: Config): void {
     })
   }
 
-  installSettingsSection(ctx, ImageGenSettingsNamespace, Config, config ?? {}, {
+  installSettingsSectionCompat(ctx, ImageGenSettingsNamespace, Config, config ?? {}, {
     setSource: (source) => {
       current = source
       sync()