1

2026-04-18 19:40:33 +08:00
parent 54b3d3c490
commit 8c3fbd9bcf
15 changed files with 904 additions and 65 deletions
--- a/src/tools/QwenSpriteSheetTool.tsx
+++ b/src/tools/QwenSpriteSheetTool.tsx
@@ -27,6 +27,7 @@ import {
 import { SectionCard } from '../editor/shared/SectionCard';
 import { AnimationState } from '../types';
 import {
+  DEFAULT_CHARACTER_BRIEF,
  buildDefaultFrameOrder,
  buildMasterNegativePrompt,
  buildMasterPrompt,
@@ -145,10 +146,9 @@ function DraftStrip({
 }

 export default function QwenSpriteSheetTool() {
+  const initialActionTemplateId: QwenSpriteActionTemplateId = 'idle';
  const [assetKey, setAssetKey] = useState('qwen-sprite-demo');
-  const [characterBrief, setCharacterBrief] = useState(
-    'Q版大头身少女冒险者，头部占比更大，约 2 到 3 头身，金棕色头发，明亮表情，轻甲或冒险服，动作角色轮廓清楚。',
-  );
+  const [characterBrief, setCharacterBrief] = useState(DEFAULT_CHARACTER_BRIEF);
  const [styleReferenceBoardSource, setStyleReferenceBoardSource] = useState('');
  const masterCandidateCount = 2;
  const masterSeed = 1101;
@@ -160,13 +160,13 @@ export default function QwenSpriteSheetTool() {
  const [isGeneratingMaster, setIsGeneratingMaster] = useState(false);

  const [actionTemplateId, setActionTemplateId] =
-    useState<QwenSpriteActionTemplateId>('idle');
-  const [actionKey, setActionKey] = useState('idle');
+    useState<QwenSpriteActionTemplateId>(initialActionTemplateId);
+  const [actionKey, setActionKey] = useState(initialActionTemplateId);
  const [actionGenerationMode, setActionGenerationMode] = useState<
    'direct-sheet' | 'image-to-video'
  >('image-to-video');
  const [actionDetailText, setActionDetailText] = useState(
-    '动作清晰，幅度明确，适合后续抽帧成横版游戏精灵表。',
+    getActionTemplateById(initialActionTemplateId).defaultDetailText ?? '',
  );
  const [sheetCandidateCount, setSheetCandidateCount] = useState(2);
  const [sheetSeed, setSheetSeed] = useState(2101);
@@ -204,6 +204,8 @@ export default function QwenSpriteSheetTool() {

  const [saveStatus, setSaveStatus] = useState<string | null>(null);
  const [isSaving, setIsSaving] = useState(false);
+  const previousAutoActionDetailRef =
+    useRef<QwenSpriteActionTemplateId>(initialActionTemplateId);
  const preserveEditorStateRef = useRef(false);
  const editorStateShapeRef = useRef({
    activeLength: 0,
@@ -274,6 +276,19 @@ export default function QwenSpriteSheetTool() {
  useEffect(() => {
    setActionKey(actionTemplate.id);
    setFps(actionTemplate.defaultFps);
+    setActionDetailText((currentValue) => {
+      const previousTemplate = getActionTemplateById(
+        previousAutoActionDetailRef.current,
+      );
+      previousAutoActionDetailRef.current = actionTemplate.id;
+      if (
+        !currentValue.trim() ||
+        currentValue.trim() === (previousTemplate.defaultDetailText ?? '').trim()
+      ) {
+        return actionTemplate.defaultDetailText ?? currentValue;
+      }
+      return currentValue;
+    });
  }, [actionTemplate]);

  useEffect(() => {
--- a/src/tools/qwenSpriteSheetToolModel.test.ts
+++ b/src/tools/qwenSpriteSheetToolModel.test.ts
@@ -1,5 +1,6 @@
 import {
  buildDefaultFrameOrder,
+  DEFAULT_CHARACTER_BRIEF,
  buildMasterNegativePrompt,
  buildMasterPrompt,
  buildOrderedActiveFrameIndices,
@@ -49,10 +50,21 @@ describe('qwenSpriteSheetToolModel', () => {
    expect(restoreAllFrames(4)).toEqual([0, 1, 2, 3]);
  });

+  it('provides action-specific default detail text for all five action templates', () => {
+    const actionTemplateIds = ['idle', 'run', 'attack_slash', 'hurt', 'die'] as const;
+
+    actionTemplateIds.forEach((actionTemplateId) => {
+      const actionTemplate = getActionTemplateById(actionTemplateId);
+      expect(actionTemplate.defaultDetailText?.length ?? 0).toBeGreaterThan(20);
+      expect(actionTemplate.stagingDirection?.length ?? 0).toBeGreaterThan(8);
+    });
+  });
+
  it('builds a sheet prompt that contains the template structure', () => {
+    const actionTemplate = getActionTemplateById('attack_slash');
    const prompt = buildSheetPrompt({
      characterBrief: '黑发青年剑士，右手持长剑。',
-      actionTemplate: getActionTemplateById('attack_slash'),
+      actionTemplate,
      extraDirection: '每格边界清晰。',
    });

--- a/src/tools/qwenSpriteSheetToolModel.ts
+++ b/src/tools/qwenSpriteSheetToolModel.ts
@@ -12,6 +12,8 @@ export type QwenSpriteActionTemplate = {
  defaultFps: number;
  bodyTravel: string;
  weaponRule: string;
+  stagingDirection?: string;
+  defaultDetailText?: string;
  sequenceLines: [string, string, string, string];
  ending: string;
 };
@@ -48,6 +50,14 @@ const THEME_APPLICATION_BOUNDARY_TEXT =
 const CHIBI_CHARACTER_TEXT =
  '即使角色带有怪物或海洋主题，也优先做成 Q版可爱的人形动作角色，方便读图和后续动画化。';

+const SETTING_AND_ROLE_ALIGNMENT_TEXT =
+  '先从角色设定中提炼世界设定、时代氛围、阵营身份、职业职责、战斗习惯、装备结构、材质配色和情绪气质，再把这些信息落实到发型、服装层次、护具、武器、饰品、轮廓和动作节奏里，不要混入与设定无关的现代服饰、写实摄影镜头、枪械体系或其他世界观元素。';
+const CHARACTER_DETAIL_COVERAGE_TEXT =
+  '角色描述需要尽量落到可视化细节：发型与脸部识别点、年龄层与气质、服装层次、护具与配饰、武器/法器类型、主色与材质、职业姿态与世界观痕迹，避免只有抽象身份词。';
+
+export const DEFAULT_CHARACTER_BRIEF =
+  '魔潮复苏边境城邦中的少女遗迹冒险者，Q版大头身，约 2 到 3 头身，金棕色微卷短发，琥珀色眼睛，额前碎发与侧边发束清晰，表情明亮但带警觉；穿分层轻甲、短披风和旅行短裙，皮革护腕、金属护膝、系带短靴完整可见；腰间挂药剂包、地图筒与小型护符，右手持单手短剑，主色为蜂蜜金、墨绿和旧银，轮廓利落，像长期在遗迹与荒野间行动的年轻探索者。';
+
 export const PLAYABLE_CHARACTER_STYLE_REFERENCE_SOURCES = [
  '/character/Sword Princess/Original/Hero/idle/Idle01.png',
  '/character/Archer Hero/Original/Hero/idle/idle01.png',
@@ -134,11 +144,50 @@ export const QWEN_SPRITE_ACTION_TEMPLATES: QwenSpriteActionTemplate[] = [
  },
 ];

+const ACTION_TEMPLATE_DETAILS: Record<
+  QwenSpriteActionTemplateId,
+  { stagingDirection: string; defaultDetailText: string }
+> = {
+  idle: {
+    stagingDirection:
+      '演出重点是轻呼吸、微幅重心起伏、戒备感和可循环衔接。',
+    defaultDetailText:
+      '保持与角色设定一致的戒备气质和职业站姿，重心稳在脚下，呼吸起伏轻微，披风、衣摆、发梢和小型饰品只有细小摆动，武器安静跟随身体微动，像角色在所属世界里随时准备探索、交涉或开战的待机瞬间。',
+  },
+  run: {
+    stagingDirection:
+      '演出重点是持续推进、步点清楚、上身稳定和装备惯性。',
+    defaultDetailText:
+      '跑动时要体现角色职业和世界设定中的装备重量感，身体略微前压，步幅清晰，手臂与武器顺势摆动，披风、衣摆和挂件跟着惯性后甩，像角色正穿过战场、街巷或遗迹通道迅速移动，节奏连续稳定。',
+  },
+  attack_slash: {
+    stagingDirection:
+      '演出重点是收身蓄力、爆发斩击、武器轨迹和收招稳定。',
+    defaultDetailText:
+      '攻击前先有短暂收身蓄力，再顺着主手武器做干净利落的前踏斩击，爆发点明确，武器轨迹贴合角色职业习惯与世界观武器设定，衣摆和挂件随发力甩动，收招后还能稳住重心，像久经战斗训练的真实角色动作。',
+  },
+  hurt: {
+    stagingDirection:
+      '演出重点是冲击反馈、短暂失衡、惯性摆动和重新稳住。',
+    defaultDetailText:
+      '受击瞬间要有明确冲击反馈，肩背后仰或身体侧偏，表情短促吃痛但不夸张，武器和手臂因惯性发生合理摆动，服装层次和挂件跟着抖动一下，随后努力稳住姿态，像这个角色在其世界观里真实挨到一击后的反应。',
+  },
+  die: {
+    stagingDirection:
+      '演出重点是失衡下坠、动作逐渐停尽和终止姿态清晰。',
+    defaultDetailText:
+      '死亡动作要先表现失衡与力量被抽离，再完成明显倒下或瘫落，武器和四肢随惯性下坠，披风、衣摆和饰品有最后一次明显摆动，最终停在清晰的终止姿态，符合角色身份、装备重量和世界氛围，不要轻飘或喜剧化。',
+  },
+};
+
 export function getActionTemplateById(id: QwenSpriteActionTemplateId) {
-  return (
-    QWEN_SPRITE_ACTION_TEMPLATES.find((template) => template.id === id) ??
-    QWEN_SPRITE_ACTION_TEMPLATES[0]
-  );
+  const template =
+    QWEN_SPRITE_ACTION_TEMPLATES.find((candidate) => candidate.id === id) ??
+    QWEN_SPRITE_ACTION_TEMPLATES[0];
+  return {
+    ...template,
+    ...ACTION_TEMPLATE_DETAILS[template.id],
+  };
 }

 export function readFileAsDataUrl(file: File) {
@@ -423,11 +472,13 @@ export async function buildPlayableCharacterStyleReferenceBoard(

 export function buildMasterPrompt(characterBrief: string) {
  return [
-    '单人，2D 横版游戏角色标准设定图，主体完整可见，底部轮廓完整，身体比例稳定，轮廓清楚，适合后续制作 sprite sheet 动画。',
-    `视角要求：${SIDE_FACING_RIGHT_TEXT}`,
-    `主体要求：${SUBJECT_ONLY_TEXT}`,
-    `画面要求：1:1 正方形画布，画面中心构图，角色主体完整置于画面中央，不要裁切主体顶部和底部，不要镜头透视，不要特写。${CLEAN_BACKGROUND_TEXT}`,
-    `风格要求：${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} 高可读性游戏角色设定图，偏像素动画前置设计稿，形体清晰，服装层次明确，道具/权杖/武器如有则存在关系合理，便于后续连续动作生成。`,
+    '???2D ???????????????????????????????????????????? sprite sheet ???',
+    `?????${SIDE_FACING_RIGHT_TEXT}`,
+    `?????${SUBJECT_ONLY_TEXT}`,
+    `?????1:1 ??????????????????????????????????????????????????${CLEAN_BACKGROUND_TEXT}`,
+    `?????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} ?????????????????????????????????????/??/???????????????????????`,
+    SETTING_AND_ROLE_ALIGNMENT_TEXT,
+    CHARACTER_DETAIL_COVERAGE_TEXT,
    CONCEPT_INTERPRETATION_TEXT,
    HUMANLIKE_PRIORITY_TEXT,
    CONCEPT_HIERARCHY_TEXT,
@@ -444,20 +495,22 @@ export function buildSheetPrompt(options: {
  extraDirection: string;
 }) {
  return [
-    `使用图1作为风格参考。生成一张 4x4 的 sprite sheet，共 16 帧，展示同一个角色的连续动作。角色保持右向斜侧身动作视角，主体完整出现在每一个格子里，底部轮廓稳定，角色在每一格中的尺度基本一致，镜头固定不变，不要切换景别，不要切换视角，不要左右翻转，也不要退化成完全 90 度纯右视图。${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
+    `???1??????????? 4x4 ? sprite sheet?? 16 ????????????????????????????????????????????????????????????????????????????????????????????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
+    SETTING_AND_ROLE_ALIGNMENT_TEXT,
    CONCEPT_INTERPRETATION_TEXT,
    HUMANLIKE_PRIORITY_TEXT,
    CONCEPT_HIERARCHY_TEXT,
    THEME_APPLICATION_BOUNDARY_TEXT,
-    `动作名：${options.actionTemplate.label}`,
-    `是否循环：${options.actionTemplate.loop ? '是' : '否'}`,
-    `身体位移：${options.actionTemplate.bodyTravel}`,
-    `武器规则：${options.actionTemplate.weaponRule}`,
+    `????${options.actionTemplate.label}`,
+    `???????${options.actionTemplate.stagingDirection ?? ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].stagingDirection}`,
+    `?????${options.actionTemplate.loop ? '?' : '?'}`,
+    `?????${options.actionTemplate.bodyTravel}`,
+    `?????${options.actionTemplate.weaponRule}`,
    ...options.actionTemplate.sequenceLines,
-    `结尾要求：${options.actionTemplate.ending}`,
-    '输出要求：每一格都要清晰分开，网格顺序从左到右、从上到下，动作连续，首尾关系明确，轮廓稳定，发型稳定，服装结构稳定，武器始终在正确的手中，背景为纯浅色，适合后续切成 sprite frames。',
+    `?????${options.actionTemplate.ending}`,
+    '?????????????????????????????????????????????????????????????????????????????????? sprite frames?',
    options.characterBrief.trim(),
-    options.extraDirection.trim(),
+    `???????${options.extraDirection.trim() || options.actionTemplate.defaultDetailText || ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].defaultDetailText}`,
  ]
    .filter(Boolean)
    .join('\n');
@@ -465,13 +518,13 @@ export function buildSheetPrompt(options: {

 export function buildRepairPrompt(options: {
  issueText: string;
-  useNeighborLabel: '上一帧' | '下一帧';
+  useNeighborLabel: '???' | '???';
 }) {
  return [
-    `使用图1作为风格参考，参考图2的动作连续性，修复图3这一个单帧。图2代表${options.useNeighborLabel}。`,
-    `要求输出一张单独的动作帧图片，不要网格，不要背景细节。角色保持右向斜侧身动作视角，主体完整，底部结构稳定，保持与图2连续，并且与图1是同一个角色，不要退化成完全 90 度纯右视图。${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} ${CONCEPT_INTERPRETATION_TEXT} ${HUMANLIKE_PRIORITY_TEXT} ${CONCEPT_HIERARCHY_TEXT} ${THEME_APPLICATION_BOUNDARY_TEXT} 修复图3中的错误，使这一帧适合插回原来的 sprite sheet 中。`,
-    '保持不变：发型、服装结构、主配色、武器类型、朝向。',
-    `重点修复：${options.issueText.trim() || '修复手脚畸形、武器错误或朝向不一致问题。'}`,
+    `???1??????????2??????????3???????2??${options.useNeighborLabel}?`,
+    `?????????????????????????????????????????????????????????2???????1?????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT} ${SETTING_AND_ROLE_ALIGNMENT_TEXT} ${CONCEPT_INTERPRETATION_TEXT} ${HUMANLIKE_PRIORITY_TEXT} ${CONCEPT_HIERARCHY_TEXT} ${THEME_APPLICATION_BOUNDARY_TEXT} ???3???????????????? sprite sheet ??`,
+    '?????????????????????????',
+    `?????${options.issueText.trim() || '????????????????????'}`,
  ].join('\n');
 }

@@ -482,19 +535,21 @@ export function buildVideoActionPrompt(options: {
  characterBrief: string;
 }) {
  return [
-    `单人全身角色动作视频，动作主题是 ${options.actionTemplate.label}。`,
-    `角色固定为图1同一角色，保持右向斜侧身动作视角，镜头稳定，轮廓清晰，不要退化成完全 90 度纯右视图。${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
+    `???????????????? ${options.actionTemplate.label}?`,
+    `??????1??????????????????????????????????? 90 ??????${CHIBI_STYLE_TEXT} ${CHIBI_CHARACTER_TEXT} ${PIXEL_STYLE_TEXT} ${STYLE_REFERENCE_SCOPE_TEXT}`,
+    SETTING_AND_ROLE_ALIGNMENT_TEXT,
    CONCEPT_INTERPRETATION_TEXT,
    HUMANLIKE_PRIORITY_TEXT,
    CONCEPT_HIERARCHY_TEXT,
    THEME_APPLICATION_BOUNDARY_TEXT,
-    `动作结构：${options.actionTemplate.sequenceLines.join('；')}。结尾要求：${options.actionTemplate.ending}。`,
+    `???????${options.actionTemplate.stagingDirection ?? ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].stagingDirection}`,
+    `?????${options.actionTemplate.sequenceLines.join('?')}??????${options.actionTemplate.ending}?`,
    options.useChromaKey
-      ? '背景为纯绿色绿幕，无其他人物和场景元素，方便后期抽帧与抠像。'
-      : '背景简洁纯净，无复杂场景。',
-    `动作补充细节：${options.actionDetailText.trim() || '保持动作清晰、节奏明确、适合后续抽帧为 sprite sheet。'}`,
-    `角色设定：${options.characterBrief.trim()}`,
-    '目标是后续抽帧为横版动作游戏精灵表，因此不要镜头切换，不要景别变化，不要角色漂移。',
+      ? '??????????????????????????????'
+      : '?????????????',
+    `???????${options.actionDetailText.trim() || options.actionTemplate.defaultDetailText || ACTION_TEMPLATE_DETAILS[options.actionTemplate.id].defaultDetailText}`,
+    `?????${options.characterBrief.trim()}`,
+    '?????????????????????????????????????????',
  ].join(' ');
 }