@deepblend/dsh-blender-ui 0.3.4 → 0.3.6

package/lib/client.js

@@ -488,6 +488,34 @@ window.__ModuleLoader__.load({
       'recipes.license': '作者与许可',
       'recipes.unavailable': '部分配方无法载入；可继续使用下方可用的配方。',
       'projects.creating': '创建中…',
+      'projects.incomplete': '尚未完成创建',
+      'projects.recovered': '已打开之前创建的 {id}，未重复创建或渲染',
+      'projects.replyMissing': '未能收到创建结果。输入已保留；重试上次创建会检查同一次请求。',
+      'projects.environmentFailed': 'Blender 环境尚未就绪。输入已保留；请先检查安装和路径，修复后再重试。',
+      'projects.creationFailed': '未能确认创建结果。输入已保留；可重试上次创建，或刷新列表检查已保存的项目。',
+      'projects.retryCreation': '重试上次创建',
+      'projects.originalTitle': '上次创建：{title}',
+      'projects.drafts': '继续创建草稿',
+      'projects.draftHint': '创建草稿保存在此浏览器。恢复只填写输入，不会自动创建项目。',
+      'projects.draftSaved': '当前创建草稿已保存到此浏览器。',
+      'projects.draftUnavailable': '此浏览器暂时无法保存草稿。当前输入仍可使用，但重载或关闭页面后可能丢失。',
+      'projects.draftFull': '创建草稿已满。删除不用的浏览器草稿后可继续保存，当前输入仍保留。',
+      'projects.draftTooLarge': '当前创建草稿过大，无法保存到浏览器。当前输入仍保留。',
+      'projects.draftInvalid': '这份浏览器草稿无法读取，原记录没有被更改。',
+      'projects.draftMissingRecipe': '原配方 {id}@{version} 当前不可用。原创建请求仍可重试；新建作品前请选择当前配方。',
+      'projects.draftOldParameters': '原配方参数',
+      'projects.draftRestored': '已恢复创建草稿。检查输入后继续；上次请求需要明确重试。',
+      'projects.draftRestore': '继续这份草稿',
+      'projects.draftDelete': '删除浏览器草稿',
+      'projects.draftClear': '清空当前创建草稿',
+      'projects.draftUncertain': '创建结果尚未确认',
+      'projects.untitledDraft': '未命名创建草稿',
+      'projects.damagedDraft': '无法读取的创建草稿',
+      'projects.refreshList': '刷新项目列表',
+      'projects.creationDetails': '详细诊断',
+      'projects.environmentGuide': '查看环境检查指南',
+      'projects.creationConflict': '上次创建记录需要检查。输入已保留；请刷新列表并查看详细诊断，确认项目状态。',
+      'projects.hostNeedsRestart': '当前运行的 Host 尚不支持创建恢复。请更新 DeepBlend 并重启 DSH，输入仍保留在当前页面。',
       'projects.createButton': '创建',
       'scene.currentRevision': '当前 revision',
       'scene.revisionCount': 'revision 数',
@@ -1025,6 +1053,34 @@ window.__ModuleLoader__.load({
       'recipes.license': 'Author and license',
       'recipes.unavailable': 'Some recipes could not be loaded. Available recipes are shown below.',
       'projects.creating': 'Creating…',
+      'projects.incomplete': 'Creation is not complete',
+      'projects.recovered': 'Opened the previously created {id}; no duplicate creation or render',
+      'projects.replyMissing': 'The creation result could not be received. Your inputs are kept; retry the previous creation to check the same request.',
+      'projects.environmentFailed': 'Blender is not ready. Your inputs are kept; check its installation and path, then retry.',
+      'projects.creationFailed': 'The creation result could not be confirmed. Your inputs are kept; retry the previous creation, or refresh the list to check saved projects.',
+      'projects.retryCreation': 'Retry previous creation',
+      'projects.originalTitle': 'Previous creation: {title}',
+      'projects.drafts': 'Continue a creation draft',
+      'projects.draftHint': 'Creation drafts stay in this browser. Restoring fills the inputs and does not create a project automatically.',
+      'projects.draftSaved': 'The current creation draft is saved in this browser.',
+      'projects.draftUnavailable': 'This browser cannot save the draft right now. Current inputs still work, but reloading or closing the page may lose them.',
+      'projects.draftFull': 'Creation draft storage is full. Delete unused browser drafts to save more; current inputs remain.',
+      'projects.draftTooLarge': 'This creation draft is too large to save in the browser. Current inputs remain.',
+      'projects.draftInvalid': 'This browser draft cannot be read. Its original record has not been changed.',
+      'projects.draftMissingRecipe': 'Recipe {id}@{version} is currently unavailable. You can still retry its original creation request; choose a current recipe before starting a new project.',
+      'projects.draftOldParameters': 'Original recipe parameters',
+      'projects.draftRestored': 'Creation draft restored. Check the inputs before continuing; retry the previous request explicitly.',
+      'projects.draftRestore': 'Continue this draft',
+      'projects.draftDelete': 'Delete browser draft',
+      'projects.draftClear': 'Clear current creation draft',
+      'projects.draftUncertain': 'Creation result unconfirmed',
+      'projects.untitledDraft': 'Untitled creation draft',
+      'projects.damagedDraft': 'Unreadable creation draft',
+      'projects.refreshList': 'Refresh project list',
+      'projects.creationDetails': 'Diagnostic details',
+      'projects.environmentGuide': 'Open the environment check guide',
+      'projects.creationConflict': 'The previous creation record needs inspection. Your inputs are kept; refresh the list and read the diagnostic details to check its state.',
+      'projects.hostNeedsRestart': 'The running Host does not support creation recovery. Update DeepBlend and restart DSH; your inputs remain on this page.',
       'projects.createButton': 'Create',
       'scene.currentRevision': 'current revision',
       'scene.revisionCount': 'revisions',
@@ -1267,6 +1323,7 @@ window.__ModuleLoader__.load({
     const PANEL_LABEL = 'Blender'
     /** The host API this half was written against; a mismatch is a deployment state. */
     const EXPECTED_HOST_API = 6
+    const CREATION_REQUEST_PROTOCOL = 'deepblend.creation-request/v1'
     /** Polling cadence while something is live; M3 writes progress once a second. */
     const POLL_LIVE_MS = 1500
     /** Polling cadence when nothing is running. */
@@ -1329,6 +1386,92 @@ window.__ModuleLoader__.load({
       return `${base}${path}?v=${version}`
     }
 
+    const creationSignature = body => JSON.stringify(body, (_, value) => value && typeof value === 'object' && !Array.isArray(value)
+      ? Object.fromEntries(Object.keys(value).sort().map(key => [key, value[key]])) : value)
+    let creationKeySequence = 0
+    function newCreationKey() {
+      const bytes = new Uint32Array(4)
+      if (globalThis.crypto?.getRandomValues) globalThis.crypto.getRandomValues(bytes)
+      else for (let i = 0; i < bytes.length; i++) bytes[i] = Math.floor(Math.random() * 4294967296)
+      return `create-${Date.now().toString(36)}-${(++creationKeySequence).toString(36)}-${[...bytes].map(n => n.toString(16).padStart(8, '0')).join('')}`
+    }
+    const CREATION_DRAFT_VERSION = 'deepblend.creation-draft/v1'
+    const CREATION_DRAFT_BYTES = 262144
+    const creationDraftPrefix = root => `${CREATION_DRAFT_VERSION}:${encodeURIComponent(root)}:`
+    const creationRecipeReference = recipe => recipe ? { id: recipe.id, version: recipe.version, digest: recipe.digest } : null
+    function creationDraftJson(value) {
+      if (value === null || typeof value === 'string' || typeof value === 'boolean') return
+      if (typeof value === 'number' && Number.isFinite(value)) return
+      if (!value || typeof value !== 'object') throw new Error('Draft input is not JSON')
+      for (const item of Object.values(value)) creationDraftJson(item)
+    }
+    function creationDraftForms(forms) {
+      const snapshot = { title: forms.title, goal: forms.goal,
+        recipe: creationRecipeReference(forms.recipe), recipeParameters: forms.recipeParameters }
+      creationDraftJson(snapshot)
+      return editorClone(snapshot)
+    }
+    const creationRequestBody = forms => editorClone({ title: forms.title.trim(),
+      goal: forms.goal.length > 0 ? forms.goal : undefined, renderPreview: Boolean(forms.recipe),
+      recipe: forms.recipe ? { ...creationRecipeReference(forms.recipe), parameters: forms.recipeParameters } : undefined })
+    function validCreationRecipeReference(recipe) {
+      return recipe === null || Boolean(recipe && typeof recipe === 'object' && !Array.isArray(recipe)
+        && typeof recipe.id === 'string' && recipe.id && typeof recipe.version === 'string' && recipe.version
+        && /^[a-f0-9]{64}$/.test(recipe.digest || ''))
+    }
+    function parseCreationDraft(raw, root, id) {
+      try {
+        if (typeof raw !== 'string' || new Blob([raw]).size > CREATION_DRAFT_BYTES) return null
+        const draft = JSON.parse(raw), forms = draft.forms
+        creationDraftJson(forms)
+        if (draft.schemaVersion !== CREATION_DRAFT_VERSION || draft.projectsRoot !== root || draft.id !== id
+          || (draft.ownerActive !== undefined && typeof draft.ownerActive !== 'boolean')
+          || !Number.isFinite(Date.parse(draft.savedAt)) || !forms || typeof forms.title !== 'string'
+          || typeof forms.goal !== 'string' || !validCreationRecipeReference(forms.recipe)
+          || Object.keys(forms).some(key => !['title', 'goal', 'recipe', 'recipeParameters'].includes(key))
+          || !forms.recipeParameters || typeof forms.recipeParameters !== 'object' || Array.isArray(forms.recipeParameters)) return null
+        const attempt = draft.attempt
+        if (attempt !== null) {
+          const body = attempt?.body
+          creationDraftJson(body)
+          if (!attempt || typeof attempt.key !== 'string' || !attempt.key.trim() || attempt.key.length > 128 || /[\x00-\x1f\x7f]/.test(attempt.key)
+            || !body || typeof body.title !== 'string' || !body.title.trim() || typeof body.renderPreview !== 'boolean'
+            || (body.goal !== undefined && typeof body.goal !== 'string')
+            || (body.recipe !== undefined && (!body.recipe || !validCreationRecipeReference(body.recipe)
+              || !body.recipe.parameters || typeof body.recipe.parameters !== 'object' || Array.isArray(body.recipe.parameters)))
+            || body.renderPreview !== Boolean(body.recipe)
+            || Object.keys(body).some(key => !['title', 'goal', 'recipe', 'renderPreview'].includes(key))
+            || attempt.signature !== creationSignature(body)) return null
+        }
+        return draft
+      } catch { return null }
+    }
+    function creationDraftStorage(settings) {
+      try { return settings.creationDraftStorage ?? globalThis.localStorage } catch { return undefined }
+    }
+    function readCreationDrafts(storage, root) {
+      if (!root) return { entries: [], available: false }
+      try {
+        if (!storage || typeof storage.key !== 'function' || !Number.isSafeInteger(storage.length)) return { entries: [], available: false }
+        const prefix = creationDraftPrefix(root), entries = []
+        for (let index = 0; index < storage.length; index++) {
+          const key = storage.key(index)
+          if (typeof key !== 'string' || !key.startsWith(prefix)) continue
+          const id = key.slice(prefix.length), raw = storage.getItem(key), draft = parseCreationDraft(raw, root, id)
+          entries.push({ id, raw, draft })
+        }
+        entries.sort((a, b) => String(b.draft?.savedAt || '').localeCompare(String(a.draft?.savedAt || '')))
+        return { entries, available: true }
+      } catch { return { entries: [], available: false } }
+    }
+    function creationErrorMessage(code) {
+      if (code === 'UI_FETCH_FAILED' || /^HTTP_/.test(code)) return t('projects.replyMissing')
+      if (code === 'BLENDER_NOT_FOUND' || code === 'RUNTIME_UNAVAILABLE') return t('projects.environmentFailed')
+      if (code === 'CREATION_REQUEST_CONFLICT') return t('projects.creationConflict')
+      if (code === 'UI_HOST_API_STALE') return t('projects.hostNeedsRestart')
+      return t('projects.creationFailed')
+    }
+
     const imageDownloadKey = (projectId, artifact) => JSON.stringify([projectId, artifact?.path, artifact?.sha256])
     function imageDownloadValid(artifact) {
       return Boolean(artifact && typeof artifact.path === 'string' && /\.png$/i.test(artifact.path)
@@ -2436,6 +2579,11 @@ window.__ModuleLoader__.load({
         diffError: null,
         previewBusy: false,
         imageDownloads: {},
+        creationWork: null,
+        creationRequestProtocol: null,
+        creationDrafts: [],
+        creationDraftStorageStatus: null,
+        creationDraftMissingRecipe: null,
         inspectionForms: {},
         inspectionWork: {},
         inspectionRevisions: {},
@@ -2496,6 +2644,12 @@ window.__ModuleLoader__.load({
       let tick = 0
       let live = false
       let loadSequence = 0
+      let creationAttempt = null
+      const draftStorage = creationDraftStorage(settings)
+      let creationDraftId = newCreationKey(), creationDraftRoot = null, persistedCreationSignature = null
+      let restoredCreationSource = null, creationDraftWriting = false
+      let creationDraftClosed = false
+      const draftLifecycle = settings.creationDraftLifecycle ?? globalThis.window
       let fileChoiceSignature = null, fileChoicesStopped = false
       const photographyControllers = new Map()
       const photographyWork = (projectId, changes) => set({ photographyWork: { ...data.photographyWork, [projectId]: { ...data.photographyWork[projectId], ...changes } } })
@@ -2539,6 +2693,7 @@ window.__ModuleLoader__.load({
       const assetWork = (projectId, changes) => set({ assetWork: { ...data.assetWork, [projectId]: { ...data.assetWork[projectId], ...changes } } })
 
       const notify = () => {
+        persistCreationDraft()
         const signature = JSON.stringify([data.activeProjectId, data.selected?.scene?.revision, data.view, ...FILE_FIELDS.map(field => fileChoiceAllowed(data, field))])
         if (signature !== fileChoiceSignature) { data.fileChoiceGeneration += 1; fileChoiceSignature = signature }
         snapshot = { ...data, forms: { ...data.forms }, busy: { ...data.busy }, notices: { ...data.notices } }
@@ -2549,8 +2704,58 @@ window.__ModuleLoader__.load({
       /** Change one nested table. @param {'forms'|'busy'|'notices'} table @param {string} key @param {any} value */
       const setIn = (table, key, value) => { data = { ...data, [table]: { ...data[table], [key]: value } }; notify() }
 
+      function refreshCreationDrafts() {
+        const reading = readCreationDrafts(draftStorage, creationDraftRoot)
+        data.creationDrafts = reading.entries.filter(entry => entry.id !== creationDraftId).map(entry => ({ id: entry.id,
+          title: entry.draft?.forms.title || t('projects.untitledDraft'), savedAt: entry.draft?.savedAt || null,
+          uncertain: Boolean(entry.draft?.attempt), invalid: !entry.draft }))
+        return reading
+      }
+      function persistCreationDraft() {
+        if (creationDraftClosed || creationDraftWriting || !creationDraftRoot || data.projectsRoot !== creationDraftRoot) return
+        creationDraftWriting = true
+        try {
+          const forms = { ...creationDraftForms(data.forms), recipe: creationRecipeReference(data.forms.recipe) || data.creationDraftMissingRecipe }, signature = JSON.stringify([forms, creationAttempt])
+          if (signature === persistedCreationSignature) return
+          const reading = refreshCreationDrafts()
+          if (!reading.available) { data.creationDraftStorageStatus = 'unavailable'; return }
+          const key = creationDraftPrefix(creationDraftRoot) + creationDraftId
+          if (!forms.title && !forms.goal && !forms.recipe && !Object.keys(forms.recipeParameters).length && !creationAttempt) {
+            draftStorage.removeItem(key); data.creationDraftStorageStatus = null
+          } else {
+            if (!reading.entries.some(entry => entry.id === creationDraftId) && reading.entries.length >= 20) {
+              data.creationDraftStorageStatus = 'full'; return
+            }
+            const raw = JSON.stringify({ schemaVersion: CREATION_DRAFT_VERSION, projectsRoot: creationDraftRoot,
+              id: creationDraftId, ownerActive: true, savedAt: new Date().toISOString(), forms, attempt: creationAttempt })
+            if (new Blob([raw]).size > CREATION_DRAFT_BYTES) { data.creationDraftStorageStatus = 'tooLarge'; return }
+            draftStorage.setItem(key, raw)
+            if (draftStorage.getItem(key) !== raw) throw new Error('Draft write did not persist')
+            data.creationDraftStorageStatus = 'saved'
+          }
+          persistedCreationSignature = signature
+          refreshCreationDrafts()
+        } catch { data.creationDraftStorageStatus = 'unavailable' }
+        finally { creationDraftWriting = false }
+      }
+      function closeCreationDraft() {
+        if (creationDraftClosed) return
+        persistCreationDraft()
+        creationDraftClosed = true
+        if (!creationDraftRoot) return
+        try {
+          const key = creationDraftPrefix(creationDraftRoot) + creationDraftId
+          const saved = parseCreationDraft(draftStorage?.getItem(key), creationDraftRoot, creationDraftId)
+          if (saved) draftStorage.setItem(key, JSON.stringify({ ...saved, ownerActive: false }))
+        } catch { /* Current inputs were already saved or visibly reported as unsaved. */ }
+      }
+      function reopenCreationDraft() {
+        creationDraftClosed = false; persistedCreationSignature = null
+        persistCreationDraft()
+      }
+
       /** The project every per-project route is addressed to. */
-      const target = () => data.projectId ?? (data.projects[0] ? data.projects[0].projectId : null)
+      const target = () => data.projectId ?? data.projects.find(project => !project.creationPending)?.projectId ?? null
 
       /** Read everything the panel shows, in one pass. */
       const load = async () => {
@@ -2564,7 +2769,8 @@ window.__ModuleLoader__.load({
           return
         }
         const payload = stateResult.payload
-        const active = projectId !== null ? projectId : (payload.projects && payload.projects[0] ? payload.projects[0].projectId : null)
+        const pending = payload.projects?.some(project => project.projectId === projectId && project.creationPending)
+        const active = pending ? null : projectId ?? payload.projects?.find(project => !project.creationPending)?.projectId ?? null
         const patch = {
           status: 'ok',
           error: null,
@@ -2572,6 +2778,7 @@ window.__ModuleLoader__.load({
           projects: payload.projects || [],
           recipeCatalog: payload.recipeCatalog ?? { recipes: [], errors: [] },
           projectsRoot: payload.projectsRoot ?? null,
+          creationRequestProtocol: payload.creationRequestProtocol ?? null,
           selected: payload.selected ?? null,
           activeProjectId: active,
           currentRevision: payload.selected ? payload.selected.currentRevision : null,
@@ -2621,6 +2828,17 @@ window.__ModuleLoader__.load({
           const next = { ...comparison, afterPreviews: editorClone(afterPreviews) }
           patch.editorComparison = { ...next, ...editorPreviewPair(next), resolved: afterPreviews.length > 0 }
         }
+        if (patch.projectsRoot !== creationDraftRoot) {
+          // Switching stores cannot carry an old store's request identity into a new one.
+          if (creationDraftRoot !== null) {
+            creationAttempt = null; restoredCreationSource = null; creationDraftId = newCreationKey()
+            patch.creationWork = null; patch.creationDraftMissingRecipe = null
+            patch.forms = { ...data.forms, title: '', goal: '', recipe: null, recipeParameters: {} }
+          }
+          creationDraftRoot = typeof patch.projectsRoot === 'string' && patch.projectsRoot ? patch.projectsRoot : null
+          persistedCreationSignature = null
+        }
+        refreshCreationDrafts()
         set(patch)
         arm()
       }
@@ -2637,6 +2855,51 @@ window.__ModuleLoader__.load({
       /** A write just happened: re-run every read, including the view-specific ones. */
       const reload = () => { tick += 1; void load() }
 
+      const creationBody = () => creationRequestBody(data.forms)
+
+      async function submitCreation(attempt) {
+        if (data.creationRequestProtocol !== CREATION_REQUEST_PROTOCOL) {
+          set({ creationWork: { status: 'error', title: attempt.body.title, code: 'UI_HOST_API_STALE' } })
+          setIn('notices', 'projects', { kind: 'creation', ok: false, message: t('projects.hostNeedsRestart') })
+          return
+        }
+        setIn('busy', 'create', true)
+        const attemptRoot = creationDraftRoot
+        set({ creationWork: { status: 'busy', title: attempt.body.title }, previewResult: null })
+        setIn('notices', 'projects', null)
+        setIn('notices', 'preview', null)
+        const outcome = await postJson(fetchImpl, ROUTES.projects, { ...editorClone(attempt.body), creationKey: attempt.key })
+        setIn('busy', 'create', false)
+        if (attemptRoot !== creationDraftRoot) { reload(); return }
+        if (outcome.ok) {
+          const sameInputs = creationSignature(creationBody()) === attempt.signature
+          set({ ...(sameInputs ? { forms: { ...data.forms, title: '', goal: '', recipe: null, recipeParameters: {} } } : {}),
+            creationWork: null, projectId: outcome.payload.project.projectId,
+            ...(attempt.body.renderPreview ? { view: 'preview', compareMode: 'result' } : {}) })
+          if (creationAttempt === attempt) creationAttempt = null
+          if (restoredCreationSource && creationDraftRoot) {
+            try {
+              const sourceKey = creationDraftPrefix(creationDraftRoot) + restoredCreationSource.id
+              const source = parseCreationDraft(restoredCreationSource.raw, creationDraftRoot, restoredCreationSource.id)
+              if (source && creationSignature(creationRequestBody(source.forms)) === attempt.signature
+                && draftStorage?.getItem(sourceKey) === restoredCreationSource.raw) draftStorage.removeItem(sourceKey)
+            } catch { data.creationDraftStorageStatus = 'unavailable' }
+          }
+          restoredCreationSource = null
+          persistedCreationSignature = null
+          setIn('notices', attempt.body.renderPreview ? 'preview' : 'projects', { kind: 'creation', projectId: outcome.payload.project.projectId, ok: true, message: outcome.payload.project.creationReplayed
+            ? t('projects.recovered', { id: outcome.payload.project.projectId })
+            : t('projects.created', { id: outcome.payload.project.projectId }) })
+        } else {
+          set({ creationWork: { status: 'error', title: attempt.body.title, code: outcome.error.code } })
+          setIn('notices', 'projects', { kind: 'creation', ok: false, message: creationErrorMessage(outcome.error.code),
+            technicalDetails: `${outcome.error.code}: ${outcome.error.message}` })
+        }
+        // A failed response may follow a successful Host commit. Refreshing is
+        // read-only; retries remain explicit and reuse the captured request key.
+        reload()
+      }
+
       /** Run one write, report it in this view's notice, then reload. */
       const write = async (view, path, body, describe) => {
         const outcome = await postJson(fetchImpl, path, body)
@@ -2934,7 +3197,7 @@ window.__ModuleLoader__.load({
           } else assetWork(projectId, { error: `${outcome.error.code}: ${outcome.error.message}` })
           reload()
         },
-        selectRecipe: recipe => set({ forms: { ...data.forms, recipe,
+        selectRecipe: recipe => set({ creationDraftMissingRecipe: null, forms: { ...data.forms, recipe,
           recipeParameters: recipe ? Object.fromEntries(recipe.parameters.map(parameter => [parameter.id, parameter.default])) : {},
           title: !data.forms.title || data.forms.title === data.forms.recipe?.title ? recipe?.title || '' : data.forms.title,
         } }),
@@ -3281,25 +3544,49 @@ window.__ModuleLoader__.load({
 
         createProject: async () => {
           if (data.busy.create) return
+          if (data.creationDraftMissingRecipe) return
           if (!recipeSelectionCurrent(data) || !recipeValuesValid(data.forms.recipe, data.forms.recipeParameters)) return
-          const withRecipe = Boolean(data.forms.recipe)
-          setIn('busy', 'create', true)
-          const outcome = await postJson(fetchImpl, ROUTES.projects, {
-            title: data.forms.title,
-            goal: data.forms.goal.length > 0 ? data.forms.goal : undefined,
-            renderPreview: withRecipe,
-            recipe: data.forms.recipe ? { id: data.forms.recipe.id, version: data.forms.recipe.version, digest: data.forms.recipe.digest, parameters: data.forms.recipeParameters } : undefined,
-          })
-          setIn('busy', 'create', false)
-          if (outcome.ok) {
-            set({ forms: { ...data.forms, title: '', goal: '', recipe: null, recipeParameters: {} }, projectId: outcome.payload.project.projectId, ...(withRecipe ? { view: 'preview', compareMode: 'result' } : {}) })
-            setIn('notices', 'projects', { ok: true, message: t('projects.created', { id: outcome.payload.project.projectId }) })
-            reload()
-          } else {
-            setIn('notices', 'projects', { ok: false, message: `${outcome.error.code}: ${outcome.error.message}` })
-            if (outcome.error.code === 'RECIPE_CHANGED' || outcome.error.code === 'RECIPE_NOT_FOUND') reload()
+          const body = creationBody()
+          const signature = creationSignature(body)
+          if (!creationAttempt || creationAttempt.signature !== signature) creationAttempt = { body, signature, key: newCreationKey() }
+          return submitCreation(creationAttempt)
+        },
+        retryCreation: () => data.busy.create || !creationAttempt ? undefined : submitCreation(creationAttempt),
+        restoreCreationDraft: id => {
+          if (data.busy.create || !creationDraftRoot) return
+          const reading = readCreationDrafts(draftStorage, creationDraftRoot), source = reading.entries.find(entry => entry.id === id)
+          if (!source?.draft) { set({ creationDraftStorageStatus: 'invalid' }); return }
+          const saved = source.draft, ref = saved.forms.recipe
+          const recipe = ref ? data.recipeCatalog.recipes.find(recipe => recipe.id === ref.id && recipe.version === ref.version && recipe.digest === ref.digest) : null
+          creationDraftId = newCreationKey(); restoredCreationSource = { id, raw: source.raw }; persistedCreationSignature = null
+          creationAttempt = saved.attempt ? editorClone(saved.attempt) : null
+          set({ view: 'projects', forms: { ...data.forms, ...editorClone(saved.forms), recipe: recipe || null },
+            creationDraftMissingRecipe: ref && !recipe ? ref : null,
+            creationWork: creationAttempt ? { status: 'error', title: creationAttempt.body.title, code: 'UI_FETCH_FAILED' } : null,
+            notices: { ...data.notices, projects: { kind: 'creation', ok: true, message: t('projects.draftRestored') } } })
+          // A closed page's unchanged record can be consumed after the copy
+          // persisted. Live pages retain their independent saved record.
+          if (saved.ownerActive === false && data.creationDraftStorageStatus === 'saved') {
+            try {
+              const sourceKey = creationDraftPrefix(creationDraftRoot) + id
+              if (draftStorage.getItem(sourceKey) === source.raw) draftStorage.removeItem(sourceKey)
+              refreshCreationDrafts(); notify()
+            } catch { set({ creationDraftStorageStatus: 'unavailable' }) }
           }
         },
+        deleteCreationDraft: id => {
+          if (!creationDraftRoot || id === creationDraftId) return
+          const entry = readCreationDrafts(draftStorage, creationDraftRoot).entries.find(entry => entry.id === id)
+          if (!entry) return
+          try { draftStorage.removeItem(creationDraftPrefix(creationDraftRoot) + id); refreshCreationDrafts(); notify() }
+          catch { set({ creationDraftStorageStatus: 'unavailable' }) }
+        },
+        clearCreationDraft: () => {
+          if (data.busy.create) return
+          creationAttempt = null; restoredCreationSource = null; persistedCreationSignature = null
+          set({ forms: { ...data.forms, title: '', goal: '', recipe: null, recipeParameters: {} }, creationWork: null,
+            creationDraftMissingRecipe: null, notices: { ...data.notices, projects: null } })
+        },
 
         applyPatch: async () => {
           const projectId = data.activeProjectId
@@ -3365,6 +3652,7 @@ window.__ModuleLoader__.load({
         },
 
         renderPreview: async () => {
+          setIn('notices', 'preview', null)
           set({ previewBusy: true, previewResult: null })
           const outcome = await postJson(fetchImpl, projectRoute(target(), '/preview'), { revision: data.selected?.scene?.revision })
           set({ previewBusy: false, ...(outcome.ok ? { compareMode: 'renders' } : {}) })
@@ -3442,10 +3730,16 @@ window.__ModuleLoader__.load({
         start() {
           if (running) return
           running = true
+          reopenCreationDraft()
+          draftLifecycle?.addEventListener?.('pagehide', closeCreationDraft)
+          draftLifecycle?.addEventListener?.('pageshow', reopenCreationDraft)
           fileChoicesStopped = false
           void load()
         },
         stop() {
+          closeCreationDraft()
+          draftLifecycle?.removeEventListener?.('pagehide', closeCreationDraft)
+          draftLifecycle?.removeEventListener?.('pageshow', reopenCreationDraft)
           fileChoicesStopped = true
           data = { ...data, fileChoiceGeneration: data.fileChoiceGeneration + 1 }
           running = false
@@ -3475,6 +3769,35 @@ window.__ModuleLoader__.load({
     // touches React, the DOM, or the network.
 
     /** 项目: the list, the create form, and the selected project's summary. */
+    function CreationDraftsView({ state, actions }) {
+      const messages = { saved: t('projects.draftSaved'), unavailable: t('projects.draftUnavailable'), full: t('projects.draftFull'),
+        tooLarge: t('projects.draftTooLarge'), invalid: t('projects.draftInvalid') }
+      const hasInputs = Boolean(state.forms.title || state.forms.goal || state.forms.recipe || state.creationWork || state.creationDraftMissingRecipe || Object.keys(state.forms.recipeParameters).length)
+      return el('div', { 'data-creation-drafts': true },
+        el('p', { className: 'db-muted' }, t('projects.draftHint')),
+        (hasInputs || state.creationDraftStorageStatus !== 'saved') && messages[state.creationDraftStorageStatus] ? el('p', {
+          className: state.creationDraftStorageStatus === 'saved' ? 'db-muted' : 'db-error',
+          'data-creation-draft-status': state.creationDraftStorageStatus,
+        }, messages[state.creationDraftStorageStatus]) : null,
+        state.creationDraftMissingRecipe ? el('div', { 'data-creation-draft-recipe-missing': true },
+          el('p', { className: 'db-error' }, t('projects.draftMissingRecipe', state.creationDraftMissingRecipe)),
+          el('details', null, el('summary', null, t('projects.draftOldParameters')),
+            el('pre', { className: 'db-pre' }, JSON.stringify(state.forms.recipeParameters, null, 2)))) : null,
+        hasInputs ? Button({ action: 'clear-creation-draft', disabled: state.busy.create, onClick: actions.clearCreationDraft, children: t('projects.draftClear') }) : null,
+        state.creationDrafts.length ? el('div', { style: { marginTop: '8px' } },
+          el('h5', null, t('projects.drafts')),
+          ...state.creationDrafts.map(draft => el('div', { className: 'db-card', 'data-creation-draft': draft.id },
+            el('strong', null, draft.invalid ? t('projects.damagedDraft') : draft.title),
+            draft.savedAt ? el('span', { className: 'db-muted', style: { marginLeft: '8px' } }, formatTime(draft.savedAt)) : null,
+            draft.uncertain ? el('p', { className: 'db-muted' }, t('projects.draftUncertain')) : null,
+            el('div', { className: 'db-inline' },
+              Button({ action: `restore-creation-draft:${draft.id}`, disabled: state.busy.create || draft.invalid,
+                onClick: () => actions.restoreCreationDraft(draft.id), children: t('projects.draftRestore') }),
+              Button({ action: `delete-creation-draft:${draft.id}`, onClick: () => actions.deleteCreationDraft(draft.id), children: t('projects.draftDelete') })),
+          ))) : null,
+      )
+    }
+
     function ProjectsView(ctx) {
       const state = ctx.state
       const actions = ctx.actions
@@ -3489,10 +3812,12 @@ window.__ModuleLoader__.load({
                 Button({
                   tone: project.projectId === state.activeProjectId ? 'primary' : undefined,
                   action: `select-project:${project.projectId}`,
+                  disabled: project.creationPending,
                   onClick: () => actions.selectProject(project.projectId),
                   children: project.title || project.projectId,
                 }),
                 el('span', { className: 'db-muted db-mono' }, project.projectId),
+                project.creationPending ? Badge({ tone: 'live', name: 'creation-pending', children: t('projects.incomplete') }) : null,
                 project.unfinishedJobs > 0 ? Badge({ tone: 'live', name: 'unfinished', children: t('projects.unfinishedJobs', { count: project.unfinishedJobs }) }) : null,
                 el('span', { className: 'db-muted' }, t('projects.revisionCount', { count: project.revisionCount })),
               ),
@@ -3503,6 +3828,7 @@ window.__ModuleLoader__.load({
 
         el('div', { className: 'db-card db-project-create' },
           el('h4', null, t('projects.create')),
+          CreationDraftsView(ctx),
           !state.projects.length ? el('p', { className: 'db-muted' }, t('projects.startHint')) : null,
           RecipesView(ctx),
           el('div', { className: 'db-create-footer' },
@@ -3526,12 +3852,24 @@ window.__ModuleLoader__.load({
             Button({
               tone: 'primary',
               action: 'create-project',
-              disabled: state.busy.create || state.forms.title.trim().length === 0 || !recipeSelectionCurrent(state) || !recipeValuesValid(state.forms.recipe, state.forms.recipeParameters),
+              disabled: state.busy.create || Boolean(state.creationDraftMissingRecipe) || state.creationRequestProtocol !== CREATION_REQUEST_PROTOCOL || state.forms.title.trim().length === 0 || !recipeSelectionCurrent(state) || !recipeValuesValid(state.forms.recipe, state.forms.recipeParameters),
               onClick: actions.createProject,
               children: state.busy.create ? (state.forms.recipe ? t('recipes.creatingPreview') : t('projects.creating')) : (state.forms.recipe ? t('recipes.createPreview') : t('projects.createButton')),
             }),
           ),
           state.notices.projects ? Notice(state.notices.projects, { marginTop: '8px' }) : null,
+          state.status === 'ok' && state.creationRequestProtocol !== CREATION_REQUEST_PROTOCOL
+            ? el('p', { className: 'db-muted', 'data-creation-host-stale': true }, t('projects.hostNeedsRestart')) : null,
+          state.creationWork?.status === 'error' ? el('div', { 'data-creation-recovery': true, style: { marginTop: '8px' } },
+            el('p', { className: 'db-muted' }, t('projects.originalTitle', { title: state.creationWork.title })),
+            el('div', { className: 'db-inline' },
+              Button({ action: 'retry-creation', disabled: state.busy.create, onClick: actions.retryCreation, children: t('projects.retryCreation') }),
+              Button({ action: 'refresh-creation-projects', onClick: actions.reload, children: t('projects.refreshList') }),
+              ['BLENDER_NOT_FOUND', 'RUNTIME_UNAVAILABLE'].includes(state.creationWork.code)
+                ? el('a', { href: 'https://github.com/pearjelly/deep-blend/blob/main/deepblend/docs/environment-check.md', target: '_blank', rel: 'noreferrer' }, t('projects.environmentGuide')) : null),
+            state.notices.projects?.technicalDetails ? el('details', { 'data-creation-diagnostics': true },
+              el('summary', null, t('projects.creationDetails')), el('pre', { className: 'db-pre' }, state.notices.projects.technicalDetails)) : null,
+          ) : null,
         ),
         el('details', { className: 'db-storage' }, el('summary', null, t('projects.storage')),
           el('span', { className: 'db-muted db-mono' }, `projectsRoot: ${state.projectsRoot || '—'}`)),
@@ -4546,6 +4884,8 @@ window.__ModuleLoader__.load({
             children: state.previewBusy ? t('preview.rendering') : t('preview.render'),
           }),
           Notice(state.previewResult, { border: 0, padding: '0 6px', marginBottom: 0 }),
+          state.notices.preview?.kind === 'creation' && state.notices.preview.projectId === state.activeProjectId
+            ? Notice(state.notices.preview, { border: 0, padding: '0 6px', marginBottom: 0 }) : null,
         ),
         el('div', { className: 'db-tabs' },
           el('span', { className: 'db-muted' }, t('preview.compare')),

package/lib/index.js

@@ -32,6 +32,7 @@ import {
   BlenderError,
   BlenderErrorCode,
   HOST_API_VERSION,
+  CREATION_REQUEST_VERSION,
   UI_PANEL_ID,
   UI_ROUTES,
   UI_ROUTE_PREFIX,
@@ -419,6 +420,7 @@ export default class BlenderUiHost extends Service {
 export function statusForError(error) {
   if (error?.code === 'UI_HOST_API_STALE') return 503
   const referenceStatuses = { ASSET_REQUEST_INVALID: 400, ASSET_CONTENT_MISMATCH: 415, ASSET_TOO_LARGE: 413,
+    CREATION_REQUEST_INVALID: 400, CREATION_REQUEST_CONFLICT: 409, PROJECT_ID_INVALID: 400,
     ASSET_FORMAT_UNAVAILABLE: 415, SCENE_VALIDATION_FAILED: 422, SCENE_SPEC_INVALID: 422,
     PATH_SEGMENT_INVALID: 400, ASSET_HASH_MISMATCH: 409, ASSET_SOURCE_NOT_FOUND: 404 }
   if (referenceStatuses[error.code]) return referenceStatuses[error.code]
@@ -623,13 +625,15 @@ export function createHandlers(ctx) {
     /** Everything the panel needs to render itself from scratch, in one request. */
     state: async ({ query }) => {
       const listed = await studio().listProjects()
-      const projectId = query.projectId ?? listed.projects[0]?.projectId ?? null
+      const projectId = query.projectId ?? listed.projects.find(project => !project.creationPending)?.projectId ?? null
+      const creationPending = listed.projects.some(project => project.projectId === projectId && project.creationPending)
       return {
         panelId: UI_PANEL_ID,
         recipeCatalog: studio().listRecipes?.() ?? { recipes: [], errors: [] },
         projects: listed.projects.map(record => buildProjectView(record)),
         projectsRoot: listed.projectsRoot,
-        selected: projectId === null
+        creationRequestProtocol: studio().creationRequestProtocol ?? null,
+        selected: projectId === null || creationPending
           ? null
           : await buildProjectState(studio(), projectId, query.revision ?? undefined, approvalThreshold()),
       }
@@ -644,12 +648,16 @@ export function createHandlers(ctx) {
     },
 
     'projects.create': async ({ body }) => {
+      if (body.creationKey !== undefined && studio().creationRequestProtocol !== CREATION_REQUEST_VERSION) {
+        throw new BlenderError('UI_HOST_API_STALE', 'The running Host does not support creation recovery. Restart the profile with the updated DeepBlend packages before retrying.')
+      }
       const created = await studio().createProject({
         title: body.title,
         goal: body.goal,
         sceneSpec: body.sceneSpec,
         recipe: body.recipe,
         projectId: body.projectId,
+        creationKey: body.creationKey,
         saveCheckpoint: true,
         renderPreview: body.renderPreview === true,
       })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deepblend/dsh-blender-ui",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "type": "module",
   "description": "DeepBlend workbench UI: Host half (typed HTTP API) and Web Client half (sidebar, panels, tool cards).",
   "main": "lib/index.js",
@@ -19,7 +19,7 @@
     }
   },
   "dependencies": {
-    "@deepblend/dsh-blender-contracts": "0.3.4"
+    "@deepblend/dsh-blender-contracts": "0.3.6"
   },
   "license": "MIT",
   "repository": {