dsh-cosplay-studio 2.0.4 → 2.1.0

package/lib/client.js

@@ -198,6 +198,119 @@ window.__ModuleLoader__.load({
       return h('span', { style: ui.chip(color) }, STATUS_LABEL[status] ?? status)
     }
 
+    // Slow, staged character research: web search → downloaded pictures →
+    // vision analysis → rough draft. The host writes every stage into
+    // project.research, so this card mainly renders it and offers a retry.
+    const RESEARCH_STAGE_VALUE = { prepare: 0.08, search: 0.3, images: 0.5, analyze: 0.75, draft: 0.9, done: 1, failed: 1 }
+
+    function ResearchCard({ project, actions, busy }) {
+      const research = project?.research ?? null
+      const status = research?.status ?? 'idle'
+      const running = status === 'running'
+      const done = status === 'done'
+      const failed = status === 'failed'
+      const steps = Array.isArray(research?.steps) ? research.steps.slice(-6).reverse() : []
+      const images = Array.isArray(research?.images) ? research.images : []
+      const features = research?.features ?? null
+      const draft = research?.draft ?? null
+      const value = RESEARCH_STAGE_VALUE[research?.stage] ?? (running ? 0.05 : 0)
+      const modeLabel = research?.mode === 'image' ? '参考图分析' : '联网检索'
+      const start = () => {
+        void actions.startResearch(project.id).catch((error) => actions.reportError(errText(error)))
+      }
+      return h('div', { style: ui.card },
+        h('div', { style: ui.row, marginBottom: 6 },
+          h('span', { style: { fontWeight: 600 } }, '角色形象研究'),
+          h('span', { style: { ...ui.hint, marginLeft: 8 } }, modeLabel),
+          h('span', { style: { flex: 1 } }),
+          h('span', {
+            style: {
+              fontSize: 11, padding: '2px 7px', borderRadius: 999,
+              background: running ? 'rgba(255,159,10,0.16)' : done ? 'rgba(48,209,88,0.16)' : failed ? 'rgba(255,69,58,0.16)' : 'rgba(128,128,128,0.14)',
+              color: running ? '#ff9f0a' : done ? '#30d158' : failed ? '#ff6b6b' : 'inherit',
+            },
+          }, running ? '研究中' : done ? '已完成' : failed ? '失败' : '未开始')),
+
+        h('div', { style: { ...ui.hint, lineHeight: 1.6 } },
+          running
+            ? (research.stageLabel || '正在研究角色…')
+            : done
+              ? '研究完成。下面是根据资料/参考图提取的特征，可以直接修改，或点「重新研究」。'
+              : failed
+                ? `研究失败：${research.error || '未知原因'}`
+                : (project.source === 'image'
+                    ? '上传的参考图就是唯一设计依据。点「开始研究」：分析图片特征 → 生成一张粗略草图确认（约 1 分钟）；如果一直不像，点「补充网络参考图」把网上的 cosplay 图加进来再分析一次。'
+                    : '点「开始研究」：联网检索角色资料 → 下载角色图/别人的 cosplay 图 → 分析发型、服装、性格等特征 → 生成一张粗略草图（约 1–3 分钟）。')),
+
+        running ? h('div', { style: { marginTop: 8 } }, h(Progress, { value, label: research.stageLabel || '研究中' })) : null,
+
+        steps.length > 0
+          ? h('div', { style: { marginTop: 8, display: 'grid', gap: 3 } },
+              steps.map((step, index) => h('div', {
+                key: `${index}-${step.at ?? ''}`,
+                style: { ...ui.hint, opacity: step.status === 'error' ? 0.95 : 0.7, color: step.status === 'error' ? '#ff6b6b' : 'inherit' },
+              }, `${step.status === 'error' ? '×' : '·'} ${step.label ?? ''}`)))
+          : null,
+
+        features !== null
+          ? h('div', { style: { marginTop: 10, display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 8 } },
+              features.hair ? h('div', { style: ui.col }, h('span', { style: ui.label }, '发型'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.hair)) : null,
+              features.eyes ? h('div', { style: ui.col }, h('span', { style: ui.label }, '眼睛'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.eyes)) : null,
+              features.costume ? h('div', { style: ui.col }, h('span', { style: ui.label }, '服装'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.costume)) : null,
+              features.props || features.accessories
+                ? h('div', { style: ui.col }, h('span', { style: ui.label }, '道具 / 配饰'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.props || features.accessories))
+                : null,
+              features.personality ? h('div', { style: ui.col }, h('span', { style: ui.label }, '性格'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.personality)) : null,
+              Array.isArray(features.palette) && features.palette.length > 0
+                ? h('div', { style: ui.col }, h('span', { style: ui.label }, '配色'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, features.palette.join(' / ')))
+                : null,
+              features.confidence > 0
+                ? h('div', { style: ui.col }, h('span', { style: ui.label }, '置信度'), h('div', { style: { ...ui.hint, opacity: 0.85 } }, `${Math.round(features.confidence * 100)}%`))
+                : null)
+          : null,
+
+        research?.summary
+          ? h('div', { style: { ...ui.hint, marginTop: 8, opacity: 0.85, lineHeight: 1.6 } }, research.summary)
+          : null,
+
+        images.length > 0
+          ? h('div', { style: { ...ui.grid, marginTop: 10 } },
+              images.map((image) => h('div', { key: image.file, style: ui.col },
+                h(Thumb, {
+                  src: mediaUrl(project.id, `refs/${image.file}`),
+                  style: ui.thumb,
+                  onOpen: () => actions.openFolder(project.id, 'refs'),
+                }),
+                h('span', { style: { ...ui.mono, fontSize: 10.5, opacity: 0.6, wordBreak: 'break-all' } }, `${image.width}×${image.height}`))))
+          : null,
+
+        draft !== null && draft !== ''
+          ? h('div', { style: { marginTop: 10 } },
+              h('div', { style: { ...ui.label, marginBottom: 4 } }, '粗略草图（确认外观用，不是最终质量）'),
+              h(Thumb, {
+                src: mediaUrl(project.id, `research/${draft.file}`),
+                style: { width: '100%', maxWidth: 300, borderRadius: 8, display: 'block' },
+                onOpen: () => actions.openFolder(project.id, 'research'),
+              }))
+          : null,
+
+        h('div', { style: { ...ui.row, marginTop: 10 } },
+          h(Btn, { kind: running || done ? undefined : 'primary', disabled: busy || running, onClick: start }, done || failed ? '重新研究' : '开始研究'),
+          done && project.source === 'image'
+            ? h(Btn, {
+                disabled: busy || running,
+                onClick: () => {
+                  void actions.startResearch(project.id, { supplement: true }).catch((error) => actions.reportError(errText(error)))
+                },
+              }, '补充网络参考图')
+            : null,
+          h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'research') }, '打开研究文件夹'),
+          h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'refs') }, '打开参考图文件夹')),
+        done && project.source === 'image'
+          ? h('div', { style: { ...ui.hint, marginTop: 6, opacity: 0.75 } }, '参考图项目以你上传的图为准；点「补充网络参考图」可把网上的 cosplay 图加进分析，让特征更完整。')
+          : null)
+    }
+
     /* ------------------------------------------------------------ icon */
 
     function SidebarIcon(props) {
@@ -418,6 +531,12 @@ window.__ModuleLoader__.load({
     function ProjectView({ state, project, actions, busy, tab, setTab }) {
       const [details, setDetails] = useState(null)
       const [shots, setShots] = useState(null)
+      const [deoil, setDeoil] = useState(false)
+      const [bodyMakeup, setBodyMakeup] = useState(false)
+      const [baseEdit, setBaseEdit] = useState('')
+      const [shotEditFile, setShotEditFile] = useState('')
+      const [shotEdit, setShotEdit] = useState('')
+      const [editDenoise, setEditDenoise] = useState(0.42)
       const queue = state?.queue ?? {}
       const deployment = state?.deployment ?? {}
       const env = state?.env ?? {}
@@ -427,6 +546,16 @@ window.__ModuleLoader__.load({
         setShots(project?.shots ? project.shots.map((shot) => ({ ...shot })) : null)
       }, [project?.id, project?.updatedAt])
 
+      useEffect(() => {
+        setDeoil(project?.finalizeOptions?.deoil === true)
+        setBodyMakeup(project?.finalizeOptions?.makeup === true)
+      }, [project?.id, project?.finalizeOptions?.deoil, project?.finalizeOptions?.makeup])
+
+      useEffect(() => {
+        const files = project?.pendingFinals ?? []
+        setShotEditFile((current) => (files.includes(current) ? current : (files[0] ?? '')))
+      }, [project?.id, project?.updatedAt])
+
       if (!project) {
         return h('div', { style: { ...ui.scroll, display: 'flex', alignItems: 'center', justifyContent: 'center' } },
           h('div', { style: { textAlign: 'center', opacity: 0.55, maxWidth: 380, lineHeight: 1.8 } },
@@ -442,6 +571,9 @@ window.__ModuleLoader__.load({
       const baseJobId = `base-${project.id}`
       const baseRefJobId = `refbase-${project.id}`
       const baseRunning = queue.running === true && (queue.current === baseJobId || queue.current === baseRefJobId)
+      const editJobId = `edit-${project.id}`
+      const editRunning = queue.running === true && queue.current === editJobId
+      const hasReference = String(project.referenceFile ?? '') !== ''
 
       const saveDetails = () => {
         void actions.updateProject(project.id, { details }).catch((error) => actions.reportError(errText(error)))
@@ -485,11 +617,18 @@ window.__ModuleLoader__.load({
               },
             }, key === 'base' ? '① 基准图' : key === 'script' ? '② 镜头脚本' : '③ 成片导出'))),
           h('div', { style: { ...ui.hint, marginTop: 6 } },
-            baseApproved ? '基准图已确认，后续成片会逐字复用这张角色卡，只替换姿态与手部描述。' : '基准图是整套图的地基：人物、服装、背景、灯光都由它定下来，确认后才继续。'),
+            baseApproved
+              ? (hasReference
+                  ? '基准图已确认，后续成片会以这张基准图为底图做 img2img，保留人物与服装。'
+                  : '基准图已确认，后续成片会逐字复用这张角色卡，只替换姿态与手部描述。')
+              : (hasReference
+                  ? '参考图项目：基准图以你上传的参考图为底（img2img，denoise 0.75），人物、发型、服装、道具都跟着参考图走。确认后才继续。'
+                  : '基准图是整套图的地基：人物、服装、背景、灯光都由它定下来，确认后才继续。')),
           !env.running ? h('div', { style: { ...ui.hint, color: '#ff9f0a', marginTop: 4 } }, 'ComfyUI 当前没有运行，生成前请到「安装」页启动。') : null),
 
         h('div', { style: { ...ui.scroll, paddingTop: 12 } },
           tab === 'base' ? h('div', null,
+            h(ResearchCard, { project, actions, busy }),
             h('div', { style: ui.card },
               h('div', { style: ui.row, marginBottom: 8 },
                 h('span', { style: { fontWeight: 600 } }, '角色特征'),
@@ -511,15 +650,17 @@ window.__ModuleLoader__.load({
             h('div', { style: ui.card },
               h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '基准图 1152×2048'),
               h('div', { style: ui.row },
-                h(Btn, { kind: 'primary', disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 1, false) }, '生成 1 张基准图'),
-                h(Btn, { disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 2, false) }, '生成 2 张（对比）'),
-                project.referenceFile
-                  ? h(Btn, { disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 1, true) }, '按参考图生成')
+                h(Btn, { kind: 'primary', disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 1, hasReference) }, hasReference ? '按参考图生成基准图' : '生成 1 张基准图'),
+                h(Btn, { disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 2, hasReference) }, '生成 2 张（对比）'),
+                hasReference
+                  ? h(Btn, { disabled: busy || queue.running || !env.running, onClick: () => actions.base(project.id, 1, false) }, '不用参考图（按角色卡）')
                   : null,
                 h('span', { style: { flex: 1 } }),
                 h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'base') }, '打开基准图文件夹')),
               h('div', { style: { ...ui.hint, marginTop: 8 } },
-                '生成一张约 75 秒。同一张角色卡换随机种子，多张可选最像的一张。' + (project.referenceFile ? '参考图模式用 img2img（denoise 0.6），会保留参考图的构图与配色倾向。' : '')),
+                hasReference
+                  ? '按参考图生成用 img2img（denoise 0.75）：人物、发型、服装、道具都以参考图为准，约 75–150 秒。角色卡只影响后面的镜头文案，不影响这张基准图。'
+                  : '当前项目没有参考图：直接按角色卡文生图，约 75 秒。像不像取决于角色卡和模型对角色名的了解；想做得像请上传参考图后重新创建项目。'),
               baseRunning
                 ? h('div', { style: { marginTop: 10 } },
                     h(Progress, { value: queueFraction(queue), label: queue.label || '生成基准图' }),
@@ -527,7 +668,7 @@ window.__ModuleLoader__.load({
                 : null,
               (project.baseImages ?? []).length > 0
                 ? h('div', { style: { ...ui.grid, marginTop: 12 } },
-                    (project.baseImages ?? []).map((file) => h('div', { key: file, style: ui.col },
+                    [...(project.baseImages ?? [])].reverse().map((file) => h('div', { key: file, style: ui.col },
                       h(Thumb, {
                         src: mediaUrl(project.id, `base/${file}`),
                         style: ui.thumb,
@@ -538,7 +679,42 @@ window.__ModuleLoader__.load({
               (project.baseImages ?? []).length > 0 && !baseApproved
                 ? h('div', { style: { ...ui.row, marginTop: 12 } },
                     h(Btn, { kind: 'primary', disabled: busy, onClick: confirmBase }, '确认基准图，进入镜头脚本'))
-                : null)) : null,
+                : null),
+
+            (project.baseImages ?? []).length > 0
+              ? h('div', { style: ui.card },
+                  h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '微调基准图（不用重新生成）'),
+                  h(Field, {
+                    label: '想改的地方（留空则让智能修改自己找问题）',
+                    value: baseEdit, onChange: setBaseEdit, textarea: true, rows: 2,
+                  }),
+                  h('div', { style: { ...ui.row, marginTop: 8 } },
+                    h(Btn, {
+                      disabled: busy || queue.running || !env.running || baseEdit.trim() === '',
+                      onClick: () => actions.baseEdit(project.id, { instruction: baseEdit, denoise: editDenoise }).then(() => setBaseEdit('')),
+                    }, '按我的要求微调'),
+                    h(Btn, {
+                      disabled: busy || queue.running || !env.running,
+                      onClick: () => actions.baseEdit(project.id, { smart: true, instruction: baseEdit, denoise: editDenoise }).then(() => setBaseEdit('')),
+                    }, '智能修改（比对参考图）'),
+                    h('select', {
+                      value: String(editDenoise),
+                      onChange: (event) => setEditDenoise(Number(event.target.value)),
+                      style: { ...ui.input, width: 150 },
+                      title: '改动幅度：越大越能改动作，但越容易改变人物/构图',
+                    }, [
+                      { value: 0.38, label: '只修细节' },
+                      { value: 0.42, label: '小改（默认）' },
+                      { value: 0.55, label: '中改' },
+                      { value: 0.7, label: '大改（可能动姿势）' },
+                    ].map((option) => h('option', { key: option.value, value: String(option.value) }, option.label)))),
+                  h('div', { style: { ...ui.hint, marginTop: 8 } },
+                    '微调以最新一张基准图为底、低重绘（denoise 0.42），只改你指定的细节；结果作为新版本追加，旧图保留。智能修改会先让视觉模型比对参考图/角色卡，再针对手、脚、五官、衣边给出修改。'),
+                  editRunning
+                    ? h('div', { style: { marginTop: 10 } },
+                        h(Progress, { value: queueFraction(queue), label: queue.label || '微调基准图' }))
+                    : null)
+              : null) : null,
 
           tab === 'script' ? h('div', null,
             h('div', { style: ui.card },
@@ -546,9 +722,13 @@ window.__ModuleLoader__.load({
               h('div', { style: ui.row },
                 h(Btn, { kind: 'primary', disabled: busy, onClick: () => actions.script(project.id, 6) }, '生成 6 镜脚本'),
                 h(Btn, { disabled: busy, onClick: () => actions.script(project.id, 4) }, '生成 4 镜脚本'),
-                h(Btn, { disabled: busy, onClick: () => { setShots([...(shots ?? []), { type: 'A 情绪特写', title: `镜头 ${(shots ?? []).length + 1}`, situation: '', expression: '', pose: '', hands: '', camera: '', props: 'no props' }]) } }, '手动加一镜')),
+                h(Btn, { disabled: busy, onClick: () => { setShots([...(shots ?? []), { type: 'A 情绪特写', title: `镜头 ${(shots ?? []).length + 1}`, situation: '', expression: '', pose: '', hands: '', camera: '', props: 'no props' }]) } }, '手动加一镜'),
+                h(Btn, {
+                  disabled: busy || (shots ?? []).length === 0 || (shots ?? []).length >= 10,
+                  onClick: () => actions.scriptAdd(project.id, 2),
+                }, '智能补 2 镜（不重复）')),
               h('div', { style: { ...ui.hint, marginTop: 8 } },
-                '脚本规矩：表情不重样、至少一张不看镜头、机位至少两种、手的位置各不相同。一行一镜，确认后才开始出成片（每张约 230 秒）。')),
+                '脚本规矩：表情不重样、至少一张不看镜头、机位至少两种、手的位置各不相同。一行一镜，确认后才开始出成片（每张约 120–150 秒，直接出 1440×2560 原图，不额外锐化/压缩）。' + (hasReference ? '参考图项目：成片以已确认的基准图为底图做 img2img（denoise 0.72），人物与服装保持一致，姿态变化会比纯文生图保守；背景按角色配色换成满幅渐变。' : ''))),
             (shots ?? []).length === 0
               ? h('div', { style: { ...ui.card, opacity: 0.6 } }, '还没有脚本。先生成或手动添加。')
               : (shots ?? []).map((shot, index) => h(ShotCard, {
@@ -561,7 +741,7 @@ window.__ModuleLoader__.load({
               ? h('div', { style: { ...ui.row, marginTop: 4, marginBottom: 12 } },
                   h(Btn, { disabled: busy, onClick: saveShots }, '保存脚本'),
                   h(Btn, { kind: 'primary', disabled: busy || queue.running || !env.running, onClick: confirmShots }, `确认脚本，开始出 ${(shots ?? []).length} 张成片`),
-                  h('span', { style: ui.hint }, `预计 ${Math.round((shots ?? []).length * 3.9)} 分钟`))
+                  h('span', { style: ui.hint }, `预计 ${Math.round((shots ?? []).length * 2.5)} 分钟`))
               : null) : null,
 
           tab === 'final' ? h('div', null,
@@ -569,20 +749,90 @@ window.__ModuleLoader__.load({
               h('div', { style: { ...ui.row, marginBottom: 8 } },
                 h('span', { style: { fontWeight: 600 } }, '成片与导出'),
                 h('span', { style: { flex: 1 } }),
-                h(Btn, { kind: 'primary', disabled: busy || queue.running || !env.running, onClick: () => actions.generate(project.id) }, '重新生成未完成的镜头')),
-              h('div', { style: ui.row },
-                h(Btn, { disabled: busy || queue.running || (project.pendingFinals ?? []).length === 0, onClick: () => actions.finalize(project.id) }, '去油光 / 压 JPEG / 生成预览与文案'),
+                h(Btn, { kind: 'primary', disabled: busy || queue.running || !env.running, onClick: () => actions.generate(project.id) }, '生成成片（按镜头脚本）')),
+              h('div', { style: { ...ui.hint, marginTop: 2 } },
+                '先出原图（无损 PNG 存 raw/，可点「打开原图文件夹」逐张看）；满意后再导出 JPEG。导出时会自动把参考图带来的白色海报边补成角色配色的满幅渐变；去油光 / 身体化妆会压高光、磨皮，默认关闭。'),
+              h('div', { style: { ...ui.row, marginTop: 10, gap: 14 } },
+                h('label', { style: { display: 'flex', alignItems: 'center', gap: 6, fontSize: 12.5, cursor: 'pointer' } },
+                  h('input', { type: 'checkbox', checked: deoil, onChange: (event) => setDeoil(event.target.checked) }), '去油光'),
+                h('label', { style: { display: 'flex', alignItems: 'center', gap: 6, fontSize: 12.5, cursor: 'pointer' } },
+                  h('input', { type: 'checkbox', checked: bodyMakeup, onChange: (event) => setBodyMakeup(event.target.checked) }), '身体化妆'),
                 h('span', { style: { flex: 1 } }),
-                h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'final') }, '打开成片文件夹'),
-                h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'deliver') }, '打开导出文件夹')),
-              h('div', { style: { ...ui.hint, marginTop: 8 } },
-                '导出会按 skill 规矩输出：00_基准角色_角色.jpg、01_动作名.jpg……、00_全套预览.jpg（2×2，单格 720×1280）、文案.txt，并复制到 deliver/。'),
+                h(Btn, { kind: 'primary', disabled: busy || queue.running || (project.pendingFinals ?? []).length === 0, onClick: () => actions.finalize(project.id, { deoil, makeup: bodyMakeup }) }, '导出成片（JPEG＋预览＋文案）')),
+              h('div', { style: { ...ui.row, marginTop: 8 } },
+                h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'raw') }, '打开原图文件夹'),
+                h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'final') }, '打开导出文件夹'),
+                h(Btn, { disabled: busy, onClick: () => actions.openFolder(project.id, 'deliver') }, '打开发布文件夹')),
               queue.running && (queue.current === `shots-${project.id}` || queue.current === `final-${project.id}`)
                 ? h('div', { style: { marginTop: 10 } },
                     h(Progress, { value: queueFraction(queue), label: queue.label }),
                     h('div', { style: { ...ui.row, marginTop: 8 } }, h(Btn, { onClick: () => actions.cancelQueue() }, '取消剩余镜头')))
                 : null),
 
+            (project.pendingFinals ?? []).length > 0
+              ? h('div', { style: ui.card },
+                  h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '微调成片（逐张）'),
+                  h('select', {
+                    value: shotEditFile || (project.pendingFinals ?? [])[0] || '',
+                    onChange: (event) => setShotEditFile(event.target.value),
+                    style: { ...ui.input, width: '100%' },
+                  }, (project.pendingFinals ?? []).map((file) => h('option', { key: file, value: file }, file))),
+                  h('div', { style: { marginTop: 8 } },
+                    h(Field, {
+                      label: '想改的地方（手、脚、五官、衣边、穿模…）',
+                      value: shotEdit, onChange: setShotEdit, textarea: true, rows: 2,
+                    })),
+                  h('div', { style: { ...ui.row, marginTop: 8 } },
+                    h(Btn, {
+                      disabled: busy || queue.running || !env.running || shotEdit.trim() === '',
+                      onClick: () => actions.shotEdit(project.id, {
+                        file: shotEditFile || (project.pendingFinals ?? [])[0],
+                        instruction: shotEdit,
+                        denoise: editDenoise,
+                      }).then(() => setShotEdit('')),
+                    }, '按我的要求微调'),
+                    h(Btn, {
+                      disabled: busy || queue.running || !env.running,
+                      onClick: () => actions.shotEdit(project.id, {
+                        file: shotEditFile || (project.pendingFinals ?? [])[0],
+                        smart: true,
+                        instruction: shotEdit,
+                        denoise: editDenoise,
+                      }).then(() => setShotEdit('')),
+                    }, '智能修改（比对参考图/基准图）'),
+                    h('select', {
+                      value: String(editDenoise),
+                      onChange: (event) => setEditDenoise(Number(event.target.value)),
+                      style: { ...ui.input, width: 150 },
+                      title: '改动幅度：越大越能改动作，但越容易改变人物/构图',
+                    }, [
+                      { value: 0.38, label: '只修细节' },
+                      { value: 0.42, label: '小改（默认）' },
+                      { value: 0.55, label: '中改' },
+                      { value: 0.7, label: '大改（可能动姿势）' },
+                    ].map((option) => h('option', { key: option.value, value: String(option.value) }, option.label))),
+                    h(Btn, {
+                      disabled: busy || queue.running || !(shotEditFile || (project.pendingFinals ?? [])[0]),
+                      onClick: () => actions.restoreShot(project.id, shotEditFile || (project.pendingFinals ?? [])[0]),
+                    }, '撤销上次微调')),
+                  h('div', { style: { ...ui.hint, marginTop: 8 } },
+                    '微调直接覆盖 raw/ 里的这张原图（旧版本备份到 raw/.history/，可撤销），denoise 越小越只动局部；改完再点上面的导出。智能修改会先比对参考图/已确认基准图，再只修最需要改的瑕疵。'),
+                  editRunning
+                    ? h('div', { style: { marginTop: 10 } },
+                        h(Progress, { value: queueFraction(queue), label: queue.label || '微调成片' }))
+                    : null)
+              : null,
+
+            (project.pendingFinals ?? []).length > 0
+              ? h('div', { style: ui.card },
+                  h('div', { style: { fontWeight: 600, marginBottom: 8 } }, '成片原图（未处理，PNG）'),
+                  h('div', { style: { ...ui.grid } },
+                    (project.pendingFinals ?? []).map((file) => h('div', { key: file, style: ui.col },
+                      h('a', { href: mediaUrl(project.id, `raw/${file}`), target: '_blank', rel: 'noreferrer' },
+                        h(Thumb, { src: mediaUrl(project.id, `raw/${file}`), style: ui.thumb, onOpen: () => actions.openFolder(project.id, 'raw') })),
+                      h('span', { style: { ...ui.mono, fontSize: 10.5, opacity: 0.7, wordBreak: 'break-all' } }, file)))))
+              : null,
+
             (project.finals ?? []).length > 0 || project.preview
               ? h('div', null,
                   project.preview
@@ -617,18 +867,51 @@ window.__ModuleLoader__.load({
 
     /* ------------------------------------------------------------- panel */
 
+    // Remember what the user was looking at. The panel unmounts when the user
+    // switches to a chat and mounts again on return, so without this the
+    // workbench always reopened on the empty studio list.
+    const PANEL_STATE_KEY = 'dsh-cosplay-studio:panel-state'
+    const PANEL_TABS = ['base', 'script', 'final']
+
+    function readPanelState() {
+      try {
+        const raw = window.localStorage.getItem(PANEL_STATE_KEY)
+        const parsed = raw === null ? null : JSON.parse(raw)
+        return {
+          view: parsed?.view === 'studio' || parsed?.view === 'install' ? parsed.view : null,
+          selectedId: typeof parsed?.selectedId === 'string' ? parsed.selectedId : '',
+          tab: PANEL_TABS.includes(parsed?.tab) ? parsed.tab : 'base',
+        }
+      } catch {
+        return { view: null, selectedId: '', tab: 'base' }
+      }
+    }
+
+    function writePanelState(next) {
+      try {
+        window.localStorage.setItem(PANEL_STATE_KEY, JSON.stringify(next))
+      } catch {
+        // localStorage can be unavailable (private mode); the panel still works.
+      }
+    }
+
     function Panel() {
       const [state, setState] = useState(null)
       const [project, setProject] = useState(null)
-      const [selectedId, setSelectedId] = useState('')
-      const [tab, setTab] = useState('base')
-      const [view, setView] = useState(null)
+      const [selectedId, setSelectedId] = useState(() => readPanelState().selectedId)
+      const [tab, setTab] = useState(() => readPanelState().tab)
+      const [view, setView] = useState(() => readPanelState().view)
       const [busy, setBusy] = useState(false)
       const [error, setError] = useState('')
       const [form, setForm] = useState({ character: '', series: '', useModel: true, file: null, details: null })
       const [picks, setPicks] = useState([])
       const fileRef = useRef(null)
 
+      // Persist the current screen / project / tab for the next mount.
+      useEffect(() => {
+        writePanelState({ view, selectedId, tab })
+      }, [view, selectedId, tab])
+
       // null = follow the environment: a ready install opens on the workbench,
       // anything else opens on the install page. Picking a tab pins the view.
       const applyState = useCallback((next) => {
@@ -677,6 +960,18 @@ window.__ModuleLoader__.load({
         }
       }, [state?.queue?.running, state?.queue?.done, state?.queue?.lastResult])
 
+      // Research runs in the background: poll the project itself while it is
+      // running so the stage text and step log move without a page refresh.
+      useEffect(() => {
+        if (selectedId === '' || project?.research?.status !== 'running') return undefined
+        const timer = setInterval(() => {
+          api(`/project?id=${encodeURIComponent(selectedId)}`)
+            .then((data) => setProject(data.project))
+            .catch(() => {})
+        }, 1500)
+        return () => clearInterval(timer)
+      }, [selectedId, project?.research?.status])
+
       // Pinning only happens for a known state: before the first /state reply the
       // view stays automatic, so a ready install opens on the workbench.
       useEffect(() => {
@@ -751,6 +1046,13 @@ window.__ModuleLoader__.load({
             })
             await api('/project/reference', { id: created.id, dataUrl })
             created = (await api(`/project?id=${encodeURIComponent(created.id)}`)).project
+            // The reference is on disk now; kick off the picture-analysis pass.
+            try {
+              const started = await api('/project/research', { id: created.id })
+              created = started.project
+            } catch (error_) {
+              setError(errText(error_))
+            }
           }
           setForm({ character: '', series: '', useModel: form.useModel, file: null, details: null })
           if (fileRef.current) fileRef.current.value = ''
@@ -786,17 +1088,58 @@ window.__ModuleLoader__.load({
           setProject(data.project)
           await load()
         }),
+        scriptAdd: (id, count = 2) => run(async () => {
+          const data = await api('/project/script/add', { id, count })
+          setProject(data.project)
+          await load()
+        }),
+        baseEdit: async (id, options = {}) => {
+          await api('/project/base/edit', {
+            id,
+            instruction: options.instruction ?? '',
+            smart: options.smart === true,
+            denoise: Number(options.denoise) || undefined,
+          })
+          await load()
+        },
+        shotEdit: async (id, options = {}) => {
+          await api('/project/shot/edit', {
+            id,
+            file: options.file ?? '',
+            instruction: options.instruction ?? '',
+            smart: options.smart === true,
+            denoise: Number(options.denoise) || undefined,
+          })
+          await load()
+        },
+        restoreShot: async (id, file) => {
+          await api('/project/shot/restore', { id, file })
+          await load()
+        },
         generate: (id) => run(async () => {
           await api('/project/generate', { id })
           await load()
         }),
-        finalize: (id) => run(async () => {
-          await api('/project/finalize', { id })
+        finalize: (id, options = {}) => run(async () => {
+          await api('/project/finalize', { id, deoil: options.deoil === true, makeup: options.makeup === true })
           await load()
         }),
         openFolder: (id, sub) => run(async () => {
           await api('/project/open-folder', { id, sub: sub ?? 'base' })
         }),
+        startResearch: async (id, options = {}) => {
+          const data = await api('/project/research', { id, supplement: options.supplement === true })
+          setProject(data.project)
+          await load()
+        },
+        randomProject: () => run(async () => {
+          const data = await api('/project/random', {})
+          setSelectedId(data.project.id)
+          setProject(data.project)
+          setTab('base')
+          setView('studio')
+          await load()
+        }),
         cancelQueue: () => run(async () => {
           await api('/queue', {})
           await load()
@@ -882,7 +1225,7 @@ window.__ModuleLoader__.load({
                         onChange: (event) => setForm({ ...form, file: event.target.files?.[0] ?? null }),
                       }),
                       form.file
-                        ? h('div', { style: { ...ui.hint, marginTop: 4, wordBreak: 'break-all' } }, `已选：${form.file.name}`)
+                        ? h('div', { style: { ...ui.hint, marginTop: 4, wordBreak: 'break-all' } }, `已选：${form.file.name}（基准图会以这张图为本，角色卡不覆盖它的设计）`)
                         : null,
                       h('label', { style: { display: 'flex', gap: 6, alignItems: 'center', marginTop: 8, fontSize: 11.5, cursor: 'pointer', opacity: state.config?.llm?.hasKey && state.config?.llm?.model ? 1 : 0.55 } },
                         h('input', {
@@ -890,11 +1233,20 @@ window.__ModuleLoader__.load({
                           onChange: (event) => setForm({ ...form, useModel: event.target.checked }),
                         }),
                         '用对话模型补全角色特征'),
+                      h('div', { style: { ...ui.hint, marginTop: 6, lineHeight: 1.55 } },
+                        state.config?.llm?.hasKey && state.config?.llm?.model
+                          ? '写角色名时由对话模型补全角色特征；上传参考图时，人物外观以参考图为准。'
+                          : '还没配置对话模型：只写角色名会得到通用模板，人物可能不像。想做得像，请上传一张参考图（基准图直接以它为本）。'),
                       h(Btn, {
                         kind: 'primary', disabled: busy,
                         style: { width: '100%', marginTop: 8 },
                         onClick: () => run(async () => { await actions.createProject() }),
                       }, '创建项目'),
+                      h(Btn, {
+                        disabled: busy,
+                        style: { width: '100%', marginTop: 6 },
+                        onClick: () => { void actions.randomProject() },
+                      }, '随机热门角色（自动研究）'),
                       h('div', { style: { marginTop: 12, paddingTop: 10, borderTop: '1px dashed rgba(128,128,128,0.25)' } },
                         h('div', { style: { ...ui.hint, marginBottom: 6, lineHeight: 1.5 } },
                           '没有想好做谁？让插件从热门角色里随机挑几个。'),

package/lib/comfy.js

@@ -231,6 +231,10 @@ export function stopComfy(port) {
 
 const snap = (value) => Math.max(16, Math.round(value / 16) * 16)
 
+// Appended to every negative prompt: hands/feet are the local model's weakest
+// area and the positive LIMB_DETAIL line alone does not suppress the failures.
+const EXTRA_NEGATIVE = 'extra fingers, fused fingers, missing fingers, malformed hands, extra toes, missing toes, deformed feet, melted shoes, extra limbs'
+
 export function resolveSize(baseSize, finalSize) {
   const parse = (value) => {
     const match = /^\s*(\d+)\s*[xX*]\s*(\d+)\s*$/.exec(String(value ?? ''))
@@ -259,9 +263,13 @@ function loaders(config) {
 }
 
 function conditioning(prompt, negative, cfg) {
+  // Anatomy failures the local z-image model still makes on its own. Appending
+  // them here keeps the user's config.negative editable without having to
+  // repeat these terms in every project.
+  const combined = [String(negative ?? '').trim(), EXTRA_NEGATIVE].filter((part) => part !== '').join(', ')
   const nodes = { 27: { class_type: 'CLIPTextEncode', inputs: { text: prompt, clip: ['30', 0] } } }
-  if (Number(cfg) > 1.01 && String(negative ?? '').trim() !== '') {
-    nodes[33] = { class_type: 'CLIPTextEncode', inputs: { text: negative, clip: ['30', 0] } }
+  if (Number(cfg) > 1.01 && combined !== '') {
+    nodes[33] = { class_type: 'CLIPTextEncode', inputs: { text: combined, clip: ['30', 0] } }
   } else {
     nodes[33] = { class_type: 'ConditioningZeroOut', inputs: { conditioning: ['27', 0] } }
   }