@dickpy/dsh-imagegen 1.0.0

package/src/client/locales.ts

@@ -0,0 +1,204 @@
+/**
+ * dsh-imagegen surface copy: zh is the key source, en mirrors every key.
+ */
+
+export const zh = {
+  'entry.label': 'AI 生图',
+  'entry.tooltip': 'AI 生图面板（gpt-image-2）',
+  'panel.title': 'AI 生图',
+  'panel.subtitle': 'gpt-image-2 图像生成',
+  // mode
+  'mode.text': '文生图',
+  'mode.edit': '图生图',
+  // prompt
+  'prompt.placeholder': '描述你想要的画面，例如：一只戴着宇航员头盔的橘猫，在月球上举起望远镜，水彩风格，柔和光线…',
+  'prompt.required': '请输入提示词',
+  'prompt.count': '{count}/2000',
+  // parameters
+  'params.size': '尺寸',
+  'params.quality': '清晰度',
+  'params.count': '生成数量',
+  'params.detail': '细节',
+  'size.auto': '自动',
+  'size.square': '1024×1024',
+  'size.landscape': '1536×1024',
+  'size.portrait': '1024×1536',
+  'size.small': '512×512',
+  'size.wide': '1792×1024',
+  'size.tall': '1024×1792',
+  'quality.auto': '自动',
+  'quality.low': '低',
+  'quality.medium': '中',
+  'quality.high': '高',
+  'count.one': '1 张',
+  'count.two': '2 张',
+  'count.three': '3 张',
+  'count.four': '4 张',
+  'detail.auto': '自动',
+  'detail.standard': '标准',
+  'detail.high': '高清',
+  'detail.hint': '透传参数，部分 gpt-image-2 网关支持；官方接口请保持「自动」',
+  // footer
+  'model.label': '模型',
+  'generate': '开始生成',
+  'generating': '生成中…',
+  // edit reference image
+  'edit.upload': '点击或拖拽上传参考图片',
+  'edit.uploadHint': 'PNG / JPG / WEBP，不超过 10MB',
+  'edit.change': '更换图片',
+  'edit.remove': '移除',
+  'edit.required': '请先上传参考图片',
+  // canvas
+  'canvas.emptyTitle': '开始你的创作',
+  'canvas.emptyHint': '在左侧输入提示词并点击「开始生成」，结果将显示在这里',
+  'canvas.error': '生成失败：{error}',
+  'canvas.generating': '正在生成图片…',
+  'canvas.elapsed': '已用时 {seconds}s',
+  'canvas.images': '本次生成 {count} 张',
+  'download': '下载',
+  'revisedPrompt': '优化提示词：{prompt}',
+  // history
+  'history.title': '历史记录',
+  'history.empty': '暂无历史记录，生成图片后会保存在这里',
+  'history.clear': '清空',
+  'history.restore': '恢复',
+  'history.delete': '删除',
+  'history.images': '张',
+  'history.viewing': '历史 · {time}',
+  // preview
+  'preview.title': '图片预览',
+  'preview.open': '点击预览',
+  'preview.close': '关闭',
+  'preview.prev': '上一张',
+  'preview.next': '下一张',
+  'preview.index': '{index} / {total}',
+  // config banner
+  'config.missing': '尚未配置 API：请前往「设置 → 插件 → 可配置」为 AI 生图填写 api_url 与 api_key。',
+  'config.configured': '已连接 {url}',
+  'config.disabled': '插件已停用，请在设置中重新启用。',
+  // settings card
+  'settings.title': 'AI 生图（dsh-imagegen）',
+  'settings.description': '配置图像生成 API 地址与密钥',
+  'settings.apiUrl': 'API 地址（api_url）',
+  'settings.apiUrlHint': 'OpenAI 兼容接口基址，如 https://api.openai.com/v1；将自动拼接 /images/generations 与 /images/edits',
+  'settings.apiKey': 'API 密钥（api_key）',
+  'settings.apiKeyHint': 'Bearer 密钥，明文存于本机设置文档；界面只显示是否已设置',
+  'settings.apiKeySet': '已保存密钥；输入新值可更换，点击「清除」可删除',
+  'settings.apiKeyClear': '清除',
+  'settings.announceToAgent': '向 Agent 播报本插件',
+  'settings.announceToAgentHint': '开启后，本插件的存在与能力会写入每个 Agent 的系统提示词',
+  'settings.enabled': '启用插件',
+  'settings.enabledHint': '关闭后生图面板不可用（设置卡片始终可用）',
+  'settings.save': '保存',
+  'settings.saving': '保存中…',
+  'settings.discard': '放弃修改',
+  'settings.unsaved': '有未保存的修改',
+  'settings.saveFailed': '保存失败，请重试',
+  'settings.readOnly': '当前设置文档为只读，无法保存。',
+  'settings.notExposed': '设置命名空间不可用：本部署未提供该插件的设置服务。',
+  'settings.expand': '展开',
+  'settings.collapse': '收起',
+  'settings.inherit': '继承',
+  'settings.on': '开',
+  'settings.off': '关',
+  'settings.overridden': '已覆盖',
+  'settings.reset': '重置',
+  'settings.invalidNumber': '请输入有效数字',
+} as const
+
+export const en: Record<keyof typeof zh, string> = {
+  'entry.label': 'AI Image',
+  'entry.tooltip': 'AI image generation studio (gpt-image-2)',
+  'panel.title': 'AI Image',
+  'panel.subtitle': 'gpt-image-2 image generation',
+  'mode.text': 'Text to Image',
+  'mode.edit': 'Image to Image',
+  'prompt.placeholder': 'Describe the picture you want, e.g. an orange cat in an astronaut helmet raising a telescope on the moon, watercolor style, soft light…',
+  'prompt.required': 'Enter a prompt first',
+  'prompt.count': '{count}/2000',
+  'params.size': 'Size',
+  'params.quality': 'Quality',
+  'params.count': 'Count',
+  'params.detail': 'Detail',
+  'size.auto': 'Auto',
+  'size.square': '1024×1024',
+  'size.landscape': '1536×1024',
+  'size.portrait': '1024×1536',
+  'size.small': '512×512',
+  'size.wide': '1792×1024',
+  'size.tall': '1024×1792',
+  'quality.auto': 'Auto',
+  'quality.low': 'Low',
+  'quality.medium': 'Medium',
+  'quality.high': 'High',
+  'count.one': '1',
+  'count.two': '2',
+  'count.three': '3',
+  'count.four': '4',
+  'detail.auto': 'Auto',
+  'detail.standard': 'Standard',
+  'detail.high': 'High',
+  'detail.hint': 'Passthrough parameter supported by some gpt-image-2 gateways; keep "Auto" for official endpoints',
+  'model.label': 'Model',
+  'generate': 'Generate',
+  'generating': 'Generating…',
+  'edit.upload': 'Click or drag to upload a reference image',
+  'edit.uploadHint': 'PNG / JPG / WEBP, up to 10MB',
+  'edit.change': 'Change image',
+  'edit.remove': 'Remove',
+  'edit.required': 'Upload a reference image first',
+  'canvas.emptyTitle': 'Start creating',
+  'canvas.emptyHint': 'Enter a prompt on the left and click "Generate"; results appear here',
+  'canvas.error': 'Generation failed: {error}',
+  'canvas.generating': 'Generating images…',
+  'canvas.elapsed': 'Elapsed {seconds}s',
+  'canvas.images': '{count} image(s) generated',
+  'download': 'Download',
+  'revisedPrompt': 'Refined prompt: {prompt}',
+  'history.title': 'History',
+  'history.empty': 'No history yet — generations will be saved here',
+  'history.clear': 'Clear',
+  'history.restore': 'Restore',
+  'history.delete': 'Delete',
+  'history.images': 'images',
+  'history.viewing': 'History · {time}',
+  'preview.title': 'Image preview',
+  'preview.open': 'Click to preview',
+  'preview.close': 'Close',
+  'preview.prev': 'Previous',
+  'preview.next': 'Next',
+  'preview.index': '{index} / {total}',
+  'config.missing': 'API not configured: open "Settings → Web UI Plugins" and fill in api_url and api_key for AI Image.',
+  'config.configured': 'Connected to {url}',
+  'config.disabled': 'The plugin is disabled — re-enable it in Settings.',
+  'settings.title': 'AI Image (dsh-imagegen)',
+  'settings.description': 'Configure the image generation API endpoint and key',
+  'settings.apiUrl': 'API URL (api_url)',
+  'settings.apiUrlHint': 'OpenAI-compatible base URL, e.g. https://api.openai.com/v1; /images/generations and /images/edits are appended',
+  'settings.apiKey': 'API Key (api_key)',
+  'settings.apiKeyHint': 'Bearer key, stored in plaintext in the local settings document; the UI only shows whether it is set',
+  'settings.apiKeySet': 'A key is stored; type a new value to replace it, or click "Clear" to remove it',
+  'settings.apiKeyClear': 'Clear',
+  'settings.announceToAgent': 'Announce this plugin to agents',
+  'settings.announceToAgentHint': 'When on, the plugin presence and capabilities are written into every agent system prompt',
+  'settings.enabled': 'Enable plugin',
+  'settings.enabledHint': 'When off, the generation studio is unavailable (this card stays available)',
+  'settings.save': 'Save',
+  'settings.saving': 'Saving…',
+  'settings.discard': 'Discard',
+  'settings.unsaved': 'Unsaved changes',
+  'settings.saveFailed': 'Save failed, please retry',
+  'settings.readOnly': 'The settings document is read-only; saving is disabled.',
+  'settings.notExposed': 'Settings namespace unavailable: this deployment does not serve this plugin\'s settings.',
+  'settings.expand': 'Expand',
+  'settings.collapse': 'Collapse',
+  'settings.inherit': 'Inherit',
+  'settings.on': 'On',
+  'settings.off': 'Off',
+  'settings.overridden': 'Overridden',
+  'settings.reset': 'Reset',
+  'settings.invalidNumber': 'Enter a valid number',
+}
+
+/** Locale key union. */
+export type ImageGenKey = keyof typeof zh

package/src/client/mount.tsx

@@ -0,0 +1,119 @@
+/**
+ * Panel view mounting.
+ *
+ * The `conversation` slot is single-occupant (ui-conversation) and external
+ * plugins cannot declare slots, so the panel takes over the center column at
+ * the DOM level: a container is appended inside the `[data-pane="conversation"]`
+ * grid item (an extra trailing child React never manages), and a stylesheet
+ * rule hides the conversation content while the panel is active. Toggling is
+ * a data attribute on <html> — no React involvement, so the conversation
+ * subtree underneath stays mounted and stateful.
+ */
+
+import { createRoot, type Root } from 'react-dom/client'
+import type { ImageGenApi } from './api.ts'
+import type { ImageGenController } from './controller.ts'
+import { ImageGenPanel } from './ImageGenPanel.tsx'
+import type { ImageGenScope } from './settings-scope.ts'
+import css from './panel.module.css'
+
+/** The injected panel container (kept in the DOM, hidden when inactive). */
+export const PANEL_VIEW_SELECTOR = '[data-dsh-imagegen-view]'
+
+const CONVERSATION_COLUMN_SELECTOR = '[data-pane="conversation"]'
+const ACTIVE_ATTR = 'data-dsh-imagegen-active'
+/** Sibling panels' activation attributes, removed when this panel opens. */
+const OTHER_ACTIVE_ATTRS = ['data-dsh-taskboard-active', 'data-dsh-ssh-active']
+/** Cross-plugin activation event; detail is the activating panel name. */
+const ACTIVATE_EVENT = 'dsh-panel-activate'
+const PANEL_NAME = 'imagegen'
+
+/** Find the center column, or undefined while the frame is not mounted. */
+function conversationColumn(): HTMLElement | undefined {
+  return document.querySelector<HTMLElement>(CONVERSATION_COLUMN_SELECTOR) ?? undefined
+}
+
+/**
+ * Mount the panel React tree into the center column and bind its visibility
+ * to the controller's panelOpen state.
+ * @param controller - the panel controller driving the view.
+ * @param api - the image-generation API client the panel operates through.
+ * @param scope - the settings scope (config status banner).
+ * @returns disposer unmounting the tree and restoring the column.
+ */
+export function mountPanel(
+  controller: ImageGenController,
+  api: ImageGenApi,
+  scope: ImageGenScope,
+): () => void {
+  let root: Root | undefined
+  let container: HTMLDivElement | undefined
+
+  const ensure = (): void => {
+    if (container !== undefined) {
+      if (container.isConnected) return
+      // The conversation pane was replaced; drop the stale tree and remount.
+      root?.unmount()
+      root = undefined
+      container.remove()
+      container = undefined
+    }
+    const column = conversationColumn()
+    if (column === undefined) return
+    container = document.createElement('div')
+    container.dataset.dshImagegenView = ''
+    container.className = css.view
+    column.appendChild(container)
+    root = createRoot(container)
+    root.render(<ImageGenPanel api={api} scope={scope} />)
+  }
+
+  // The frame mounts after boot settlement; watch for the column's arrival.
+  const waitObserver = new MutationObserver(() => { ensure() })
+  waitObserver.observe(document.body, { childList: true, subtree: true })
+
+  const applyActive = (): void => {
+    if (controller.getSnapshot().panelOpen) {
+      // Single-occupant center column: opening this panel must evict sibling
+      // panels (task board / ssh), both their html attributes and their
+      // controller states, otherwise the visibility rules fight.
+      for (const attr of OTHER_ACTIVE_ATTRS) document.documentElement.removeAttribute(attr)
+      document.documentElement.setAttribute(ACTIVE_ATTR, '')
+      document.dispatchEvent(new CustomEvent(ACTIVATE_EVENT, { detail: PANEL_NAME }))
+    } else {
+      document.documentElement.removeAttribute(ACTIVE_ATTR)
+    }
+  }
+  const onOtherActivate = (event: Event): void => {
+    const detail = (event as CustomEvent).detail
+    if ((detail === 'ssh' || detail === 'taskboard') && controller.getSnapshot().panelOpen) {
+      controller.close()
+    }
+  }
+  // Jump out on sidebar context clicks: clicking a session/workspace row
+  // hands the center column back to the conversation. Capture phase.
+  const SIDEBAR_ROW_SELECTOR = '[class*="sessionRow"], [class*="projectRow"], [class*="searchResultRow"], [class*="searchResultWorkspace"], [class*="newSession"]'
+  const onClickSidebarRow = (event: MouseEvent): void => {
+    if (!controller.getSnapshot().panelOpen) return
+    const target = event.target as HTMLElement | null
+    if (target === null) return
+    if (target.closest(SIDEBAR_ROW_SELECTOR) !== null) controller.close()
+  }
+  document.addEventListener('click', onClickSidebarRow, true)
+  document.addEventListener(ACTIVATE_EVENT, onOtherActivate)
+  const unsubscribe = controller.subscribe(applyActive)
+  applyActive()
+  ensure()
+
+  return () => {
+    document.removeEventListener('click', onClickSidebarRow, true)
+    document.removeEventListener(ACTIVATE_EVENT, onOtherActivate)
+    waitObserver.disconnect()
+    unsubscribe()
+    document.documentElement.removeAttribute(ACTIVE_ATTR)
+    root?.unmount()
+    root = undefined
+    container?.remove()
+    container = undefined
+  }
+}