1

2026-04-20 09:54:17 +08:00
parent 67c584b4df
commit 50759f3c1e
159 changed files with 16938 additions and 16925 deletions
--- a/packages/shared/src/assets/qwenSprite.ts
+++ b/packages/shared/src/assets/qwenSprite.ts
@@ -1,146 +1 @@
-export type QwenSpriteActionTemplateId =
-  | 'idle'
-  | 'run'
-  | 'attack_slash'
-  | 'hurt'
-  | 'die';
-
-export type QwenSpriteActionTemplate = {
-  id: QwenSpriteActionTemplateId;
-  label: string;
-  loop: boolean;
-  defaultFps: number;
-  bodyTravel: string;
-  weaponRule: string;
-  sequenceLines: [string, string, string, string];
-  ending: string;
-};
-
-export const QWEN_SPRITE_ACTION_TEMPLATES: QwenSpriteActionTemplate[] = [
-  {
-    id: 'idle',
-    label: '待机循环',
-    loop: true,
-    defaultFps: 8,
-    bodyTravel: '原地',
-    weaponRule: '武器始终在主手，位置稳定',
-    sequenceLines: [
-      '1-4 帧：稳定站姿，轻微呼吸起伏',
-      '5-8 帧：胸腔与肩膀轻微抬起，衣摆极轻微变化',
-      '9-12 帧：呼气回落，重心恢复',
-      '13-16 帧：逐渐回到与首帧接近的站姿',
-    ],
-    ending: '第 16 帧自然衔接第 1 帧',
-  },
-  {
-    id: 'run',
-    label: '奔跑循环',
-    loop: true,
-    defaultFps: 12,
-    bodyTravel: '小幅前移但角色中心基本固定',
-    weaponRule: '武器始终在主手，不换手',
-    sequenceLines: [
-      '1-4 帧：右腿前摆，左腿后蹬，身体略前倾',
-      '5-8 帧：双腿交叉经过身体下方，手臂反向摆动',
-      '9-12 帧：左腿前摆，右腿后蹬，继续前倾',
-      '13-16 帧：完成另一半跑步循环并回到可接第 1 帧的状态',
-    ],
-    ending: '第 16 帧能无缝接回第 1 帧',
-  },
-  {
-    id: 'attack_slash',
-    label: '横斩攻击',
-    loop: false,
-    defaultFps: 12,
-    bodyTravel: '中幅前探',
-    weaponRule: '右手持武器，始终右手，不换手',
-    sequenceLines: [
-      '1-4 帧：轻微收身蓄力，武器向后收',
-      '5-8 帧：重心前压，挥击开始',
-      '9-12 帧：斩击达到最大幅度，动作力量最强',
-      '13-16 帧：顺势收招，回到可接下一动作的稳定姿态',
-    ],
-    ending: '第 16 帧停在收招后稳定姿态',
-  },
-  {
-    id: 'hurt',
-    label: '受击后仰',
-    loop: false,
-    defaultFps: 10,
-    bodyTravel: '原地或极小后仰',
-    weaponRule: '武器不要脱手，不要换手',
-    sequenceLines: [
-      '1-4 帧：突然受击，头肩后仰',
-      '5-8 帧：身体失衡最明显',
-      '9-12 帧：手臂和武器随惯性摆动',
-      '13-16 帧：逐渐恢复到勉强站稳的姿态',
-    ],
-    ending: '第 16 帧能接回 idle 或下一个动作',
-  },
-  {
-    id: 'die',
-    label: '倒地死亡',
-    loop: false,
-    defaultFps: 8,
-    bodyTravel: '明显倒地位移',
-    weaponRule: '武器不可瞬间消失',
-    sequenceLines: [
-      '1-4 帧：受创失衡，重心被打断',
-      '5-8 帧：身体明显下坠或后仰',
-      '9-12 帧：倒地过程完成，动作幅度最大',
-      '13-16 帧：停在清晰的终止姿态',
-    ],
-    ending: '第 16 帧停在死亡结束姿态，不需要循环',
-  },
-];
-
-const BODY_RATIO_TEXT =
-  '横版像素动作角色体型，头身比优先控制在 3 到 4 头身，头部只允许略大于写实比例，保留清楚的头、躯干、双臂和双腿轮廓，不要退化成软萌 Q版大头贴或儿童绘本比例。';
-const PIXEL_STYLE_TEXT =
-  '明确的像素动作角色设定稿气质，整体按像素游戏角色设计方向组织，使用深色清楚轮廓、稳定剪影、有限大色块和硬朗边缘，不要柔和厚涂插画感，发型、服装、配饰优先形成醒目可读的像素级识别点，身体始终朝右，适合横版动作 sprite 资产。';
-
-export function getActionTemplateById(id: QwenSpriteActionTemplateId) {
-  return (
-    QWEN_SPRITE_ACTION_TEMPLATES.find((template) => template.id === id) ??
-    QWEN_SPRITE_ACTION_TEMPLATES[0]
-  );
-}
-
-export function buildMasterPrompt(characterBrief: string) {
-  return [
-    '单人，2D 横版游戏角色标准设定图，主体完整可见，底部轮廓完整，身体比例稳定，轮廓清楚，适合后续制作 sprite sheet 动画。',
-    `视角要求：角色采用横版动作素材常用的右向斜侧身站姿，身体整体朝右，但保留少量正面信息，能读到面部轮廓与胸肩结构，不是完全 90 度纯右视图，也不是正面立绘。`,
-    `主体要求：画面中只保留单个角色主体，不要额外人物、动物、召唤物、载具或陪体。`,
-    `画面要求：1:1 正方形画布，画面中心构图，角色主体完整置于画面中央，不要裁切主体顶部和底部，不要镜头透视，不要特写。背景固定为纯绿色绿幕，只作为抠像底色，不出现建筑、室内布景、风景、地面道具、漂浮物、烟雾叙事元素或其他角色以外的场景内容。`,
-    `风格要求：${BODY_RATIO_TEXT} ${PIXEL_STYLE_TEXT} 高可读性游戏角色设定图，形体清晰，服装层次明确，优先体现像素动作角色感而不是软萌 Q版插画感，便于后续连续动作生成。`,
-    '请先拆解设定中的“身份词、主题词、身体结构词”。如果文字设定没有明确要求非人身体结构，默认优先使用参考图对应的人类或类人动作角色骨架，保持清楚的头、躯干、手臂和双腿轮廓，只有当文字设定明确要求非人结构时，才改为对应非人身体。',
-    '主题词默认只作用在角色自身的服装剪裁、材质、纹样、饰品、发光细节上，不要把主题词自动扩写成背景建筑、自然场景、漂浮装饰或额外环境物件。',
-    '视觉优先级应当是：身体结构词第一，身份词第二，主题词第三。没有明确身体结构词时，默认用人形拟人化表现，再把主题词转译成服装和装饰。',
-    characterBrief.trim(),
-  ]
-    .filter(Boolean)
-    .join('\n');
-}
-
-export function buildVideoActionPrompt(options: {
-  actionTemplate: QwenSpriteActionTemplate;
-  actionDetailText: string;
-  useChromaKey: boolean;
-  characterBrief: string;
-}) {
-  return [
-    `单人全身角色动作视频，动作英文名是 ${options.actionTemplate.id}。`,
-    `角色固定为图1同一角色，保持右向斜侧身动作视角，镜头稳定，轮廓清晰，不要退化成完全 90 度纯右视图。`,
-    `视角要求：角色采用横版动作素材常用的右向斜侧身站姿，身体整体朝右，但保留少量正面信息，能读到面部轮廓与胸肩结构，不是完全 90 度纯右视图，也不是正面立绘。`,
-    `主体要求：画面中只保留单个角色主体，不要额外人物、动物、召唤物、载具或陪体。`,
-    `画面要求：1:1 正方形画布，画面中心构图，角色主体完整置于画面中央，不要裁切主体顶部和底部，不要镜头透视，不要特写。背景固定为纯绿色绿幕，只作为抠像底色，不出现建筑、室内布景、风景、地面道具、漂浮物、烟雾叙事元素或其他角色以外的场景内容。`,
-    `风格要求：${BODY_RATIO_TEXT} ${PIXEL_STYLE_TEXT} 高可读性游戏角色设定图，偏像素动画前置设计稿，形体清晰，服装层次明确，道具/权杖/武器如有则存在关系合理，优先保证像素动作角色感，不要退化成只剩 Q 版比例的普通插画，便于后续连续动作生成。`,
-    `动作结构：${options.actionTemplate.sequenceLines.join('；')}。结尾要求：${options.actionTemplate.ending}。`,
-    options.useChromaKey
-      ? '背景为纯绿色绿幕，无其他人物和场景元素，方便后期抽帧与抠像。'
-      : '背景简洁纯净，无复杂场景。',
-    `动作补充细节：${options.actionDetailText.trim() || '保持动作清晰、节奏明确、适合后续抽帧为 sprite sheet。'}`,
-    `角色设定：${options.characterBrief.trim()}`,
-    '目标是后续抽帧为横版动作游戏精灵表，因此不要镜头切换，不要景别变化，不要角色漂移。',
-  ].join(' ');
-}
+export * from '../prompts/qwenSprite.js';
--- a/packages/shared/src/contracts/customWorldAgent.ts
+++ b/packages/shared/src/contracts/customWorldAgent.ts
@@ -68,6 +68,8 @@ export interface CustomWorldWorkSummary {
  subtitle: string;
  summary: string;
  coverImageSrc?: string | null;
+  coverRenderMode?: 'image' | 'scene_with_roles';
+  coverCharacterImageSrcs?: string[];
  updatedAt: string;
  publishedAt?: string | null;
  stage?: string | null;
--- a/packages/shared/src/contracts/story.ts
+++ b/packages/shared/src/contracts/story.ts
@@ -9,8 +9,7 @@ export const QUEST_NARRATIVE_TYPES = [
  'relationship',
  'trial',
 ] as const;
-export type SharedQuestNarrativeType =
-  (typeof QUEST_NARRATIVE_TYPES)[number];
+export type SharedQuestNarrativeType = (typeof QUEST_NARRATIVE_TYPES)[number];

 export const QUEST_OBJECTIVE_KINDS = [
  'defeat_hostile_npc',
@@ -20,8 +19,7 @@ export const QUEST_OBJECTIVE_KINDS = [
  'reach_scene',
  'deliver_item',
 ] as const;
-export type SharedQuestObjectiveKind =
-  (typeof QUEST_OBJECTIVE_KINDS)[number];
+export type SharedQuestObjectiveKind = (typeof QUEST_OBJECTIVE_KINDS)[number];

 export const QUEST_URGENCY_LEVELS = ['low', 'medium', 'high'] as const;
 export type SharedQuestUrgency = (typeof QUEST_URGENCY_LEVELS)[number];
@@ -40,8 +38,7 @@ export const QUEST_REWARD_THEMES = [
  'intel',
  'rare_item',
 ] as const;
-export type SharedQuestRewardTheme =
-  (typeof QUEST_REWARD_THEMES)[number];
+export type SharedQuestRewardTheme = (typeof QUEST_REWARD_THEMES)[number];

 export const RUNTIME_ITEM_FUNCTIONAL_BIAS_VALUES = [
  'heal',
@@ -60,8 +57,7 @@ export const RUNTIME_ITEM_TONE_VALUES = [
  'ritual',
  'survival',
 ] as const;
-export type SharedRuntimeItemTone =
-  (typeof RUNTIME_ITEM_TONE_VALUES)[number];
+export type SharedRuntimeItemTone = (typeof RUNTIME_ITEM_TONE_VALUES)[number];

 export type StoryRequestOptionsPayload = {
  availableOptions?: JsonObject[];
@@ -164,6 +160,8 @@ export type NpcChatTurnRequest<
  TContext = unknown,
  TConversationTurn = unknown,
  TNpcState = unknown,
+  TQuestOfferState = unknown,
+  TQuestOfferEncounter = unknown,
 > = {
  worldType: string;
  character?: TCharacter;
@@ -176,13 +174,24 @@ export type NpcChatTurnRequest<
  dialogue?: TConversationTurn[];
  playerMessage: string;
  npcState: TNpcState;
+  questOfferContext?: {
+    state: TQuestOfferState;
+    encounter: TQuestOfferEncounter;
+    turnCount: number;
+  } | null;
 };

-export type NpcChatTurnResult = {
+export type NpcChatPendingQuestOffer<TQuest = unknown> = {
+  quest: TQuest;
+  introText?: string;
+};
+
+export type NpcChatTurnResult<TQuest = unknown> = {
  npcReply: string;
  affinityDelta: number;
  affinityText: string;
  suggestions: string[];
+  pendingQuestOffer?: NpcChatPendingQuestOffer<TQuest> | null;
 };

 export type NpcRecruitDialogueRequest<
@@ -315,6 +324,28 @@ export type RuntimeStoryChoicePayload = JsonObject & {
  note?: string;
 };

+export type RuntimeStoryOptionInteraction =
+  | {
+      kind: 'npc';
+      npcId: string;
+      action:
+        | 'chat'
+        | 'help'
+        | 'fight'
+        | 'leave'
+        | 'recruit'
+        | 'spar'
+        | 'trade'
+        | 'gift'
+        | 'quest_accept'
+        | 'quest_turn_in';
+      questId?: string;
+    }
+  | {
+      kind: 'treasure';
+      action: 'inspect' | 'leave' | 'secure';
+    };
+
 export type RuntimeStoryChoiceAction = RuntimeAction<
  'story_choice',
  RuntimeStoryChoicePayload
@@ -328,6 +359,7 @@ export type RuntimeStoryOptionView = {
  actionText: string;
  detailText?: string;
  scope: Task5RuntimeOptionScope;
+  interaction?: RuntimeStoryOptionInteraction;
  payload?: RuntimeStoryChoicePayload;
  disabled?: boolean;
  reason?: string;
--- a/packages/shared/src/prompts/qwenSprite.ts
+++ b/packages/shared/src/prompts/qwenSprite.ts
@@ -0,0 +1,146 @@
+export type QwenSpriteActionTemplateId =
+  | 'idle'
+  | 'run'
+  | 'attack_slash'
+  | 'hurt'
+  | 'die';
+
+export type QwenSpriteActionTemplate = {
+  id: QwenSpriteActionTemplateId;
+  label: string;
+  loop: boolean;
+  defaultFps: number;
+  bodyTravel: string;
+  weaponRule: string;
+  sequenceLines: [string, string, string, string];
+  ending: string;
+};
+
+export const QWEN_SPRITE_ACTION_TEMPLATES: QwenSpriteActionTemplate[] = [
+  {
+    id: 'idle',
+    label: '待机循环',
+    loop: true,
+    defaultFps: 8,
+    bodyTravel: '原地',
+    weaponRule: '武器始终在主手，位置稳定',
+    sequenceLines: [
+      '1-4 帧：稳定站姿，轻微呼吸起伏',
+      '5-8 帧：胸腔与肩膀轻微抬起，衣摆极轻微变化',
+      '9-12 帧：呼气回落，重心恢复',
+      '13-16 帧：逐渐回到与首帧接近的站姿',
+    ],
+    ending: '第 16 帧自然衔接第 1 帧',
+  },
+  {
+    id: 'run',
+    label: '奔跑循环',
+    loop: true,
+    defaultFps: 12,
+    bodyTravel: '小幅前移但角色中心基本固定',
+    weaponRule: '武器始终在主手，不换手',
+    sequenceLines: [
+      '1-4 帧：右腿前摆，左腿后蹬，身体略前倾',
+      '5-8 帧：双腿交叉经过身体下方，手臂反向摆动',
+      '9-12 帧：左腿前摆，右腿后蹬，继续前倾',
+      '13-16 帧：完成另一半跑步循环并回到可接第 1 帧的状态',
+    ],
+    ending: '第 16 帧能无缝接回第 1 帧',
+  },
+  {
+    id: 'attack_slash',
+    label: '横斩攻击',
+    loop: false,
+    defaultFps: 12,
+    bodyTravel: '中幅前探',
+    weaponRule: '右手持武器，始终右手，不换手',
+    sequenceLines: [
+      '1-4 帧：轻微收身蓄力，武器向后收',
+      '5-8 帧：重心前压，挥击开始',
+      '9-12 帧：斩击达到最大幅度，动作力量最强',
+      '13-16 帧：顺势收招，回到可接下一动作的稳定姿态',
+    ],
+    ending: '第 16 帧停在收招后稳定姿态',
+  },
+  {
+    id: 'hurt',
+    label: '受击后仰',
+    loop: false,
+    defaultFps: 10,
+    bodyTravel: '原地或极小后仰',
+    weaponRule: '武器不要脱手，不要换手',
+    sequenceLines: [
+      '1-4 帧：突然受击，头肩后仰',
+      '5-8 帧：身体失衡最明显',
+      '9-12 帧：手臂和武器随惯性摆动',
+      '13-16 帧：逐渐恢复到勉强站稳的姿态',
+    ],
+    ending: '第 16 帧能接回 idle 或下一个动作',
+  },
+  {
+    id: 'die',
+    label: '倒地死亡',
+    loop: false,
+    defaultFps: 8,
+    bodyTravel: '明显倒地位移',
+    weaponRule: '武器不可瞬间消失',
+    sequenceLines: [
+      '1-4 帧：受创失衡，重心被打断',
+      '5-8 帧：身体明显下坠或后仰',
+      '9-12 帧：倒地过程完成，动作幅度最大',
+      '13-16 帧：停在清晰的终止姿态',
+    ],
+    ending: '第 16 帧停在死亡结束姿态，不需要循环',
+  },
+];
+
+const BODY_RATIO_TEXT =
+  '横版像素动作角色体型，头身比优先控制在 3 到 4 头身，头部只允许略大于写实比例，保留清楚的头、躯干、双臂和双腿轮廓，不要退化成软萌 Q版大头贴或儿童绘本比例。';
+const PIXEL_STYLE_TEXT =
+  '明确的像素动作角色设定稿气质，整体按像素游戏角色设计方向组织，使用深色清楚轮廓、稳定剪影、有限大色块和硬朗边缘，不要柔和厚涂插画感，发型、服装、配饰优先形成醒目可读的像素级识别点，身体始终朝右，适合横版动作 sprite 资产。';
+
+export function getActionTemplateById(id: QwenSpriteActionTemplateId) {
+  return (
+    QWEN_SPRITE_ACTION_TEMPLATES.find((template) => template.id === id) ??
+    QWEN_SPRITE_ACTION_TEMPLATES[0]
+  );
+}
+
+export function buildMasterPrompt(characterBrief: string) {
+  return [
+    '单人，2D 横版游戏角色标准设定图，主体完整可见，底部轮廓完整，身体比例稳定，轮廓清楚，适合后续制作 sprite sheet 动画。',
+    `视角要求：角色采用横版动作素材常用的右向斜侧身站姿，身体整体朝右，但保留少量正面信息，能读到面部轮廓与胸肩结构，不是完全 90 度纯右视图，也不是正面立绘。`,
+    `主体要求：画面中只保留单个角色主体，不要额外人物、动物、召唤物、载具或陪体。`,
+    `画面要求：1:1 正方形画布，画面中心构图，角色主体完整置于画面中央，不要裁切主体顶部和底部，不要镜头透视，不要特写。背景固定为纯绿色绿幕，只作为抠像底色，不出现建筑、室内布景、风景、地面道具、漂浮物、烟雾叙事元素或其他角色以外的场景内容。`,
+    `风格要求：${BODY_RATIO_TEXT} ${PIXEL_STYLE_TEXT} 高可读性游戏角色设定图，形体清晰，服装层次明确，优先体现像素动作角色感而不是软萌 Q版插画感，便于后续连续动作生成。`,
+    '请先拆解设定中的“身份词、主题词、身体结构词”。如果文字设定没有明确要求非人身体结构，默认优先使用参考图对应的人类或类人动作角色骨架，保持清楚的头、躯干、手臂和双腿轮廓，只有当文字设定明确要求非人结构时，才改为对应非人身体。',
+    '主题词默认只作用在角色自身的服装剪裁、材质、纹样、饰品、发光细节上，不要把主题词自动扩写成背景建筑、自然场景、漂浮装饰或额外环境物件。',
+    '视觉优先级应当是：身体结构词第一，身份词第二，主题词第三。没有明确身体结构词时，默认用人形拟人化表现，再把主题词转译成服装和装饰。',
+    characterBrief.trim(),
+  ]
+    .filter(Boolean)
+    .join('\n');
+}
+
+export function buildVideoActionPrompt(options: {
+  actionTemplate: QwenSpriteActionTemplate;
+  actionDetailText: string;
+  useChromaKey: boolean;
+  characterBrief: string;
+}) {
+  return [
+    `单人全身角色动作视频，动作英文名是 ${options.actionTemplate.id}。`,
+    `角色固定为图1同一角色，保持右向斜侧身动作视角，镜头稳定，轮廓清晰，不要退化成完全 90 度纯右视图。`,
+    `视角要求：角色采用横版动作素材常用的右向斜侧身站姿，身体整体朝右，但保留少量正面信息，能读到面部轮廓与胸肩结构，不是完全 90 度纯右视图，也不是正面立绘。`,
+    `主体要求：画面中只保留单个角色主体，不要额外人物、动物、召唤物、载具或陪体。`,
+    `画面要求：1:1 正方形画布，画面中心构图，角色主体完整置于画面中央，不要裁切主体顶部和底部，不要镜头透视，不要特写。背景固定为纯绿色绿幕，只作为抠像底色，不出现建筑、室内布景、风景、地面道具、漂浮物、烟雾叙事元素或其他角色以外的场景内容。`,
+    `风格要求：${BODY_RATIO_TEXT} ${PIXEL_STYLE_TEXT} 高可读性游戏角色设定图，偏像素动画前置设计稿，形体清晰，服装层次明确，道具/权杖/武器如有则存在关系合理，优先保证像素动作角色感，不要退化成只剩 Q 版比例的普通插画，便于后续连续动作生成。`,
+    `动作结构：${options.actionTemplate.sequenceLines.join('；')}。结尾要求：${options.actionTemplate.ending}。`,
+    options.useChromaKey
+      ? '背景为纯绿色绿幕，无其他人物和场景元素，方便后期抽帧与抠像。'
+      : '背景简洁纯净，无复杂场景。',
+    `动作补充细节：${options.actionDetailText.trim() || '保持动作清晰、节奏明确、适合后续抽帧为 sprite sheet。'}`,
+    `角色设定：${options.characterBrief.trim()}`,
+    '目标是后续抽帧为横版动作游戏精灵表，因此不要镜头切换，不要景别变化，不要角色漂移。',
+  ].join(' ');
+}