Creator Source Package v1 field reference / 字段参考（English / 简体中文）

This generated reference inventories the current structural source contract for all seven Creator Source Package v1 YAML files. It is generated from the versioned executable source contracts; the current inventory contains 76 models and 305 fields. Do not edit this file by hand.

本文档自动列出 Creator Source Package v1 七个 YAML 文件的当前 source 结构契约。内容由版本化的 executable source contract 自动生成；当前清单包含 76 个 model 和 305 个字段。请勿手动修改。

This is a structural inventory, not the complete semantic authoring guide. Cross-file reference closure, filesystem safety, and build-target-specific rules are enforced by loader and compiler validation. / 本页是结构清单，不是完整的创作语义指南；跨文件引用、文件系统安全和特定 build target 的规则由 loader 与 compiler 校验。

For authoring semantics and cross-file rules, use the English semantic guide or 简体中文语义创作指南.

Shared type vocabulary / 通用类型

Type / 类型	Structural meaning / 结构含义
Identifier	1–160 characters; pattern ^[A-Za-z0-9][A-Za-z0-9._:-]*$. / 1–160 个字符，并符合该格式。
PackageId	1–120 lowercase letters, digits, or hyphens; must start with a letter or digit. / 1–120 个小写字母、数字或连字符，首字符须为字母或数字。
NonEmptyText	Non-empty text after surrounding whitespace is stripped. UTF-8 English and Chinese text are both valid. / 去除首尾空白后不得为空；可使用 UTF-8 英文或中文。
CanonicalInteger	Strict integer from -9007199254740991 through 9007199254740991. / 该范围内的严格整数。
Scalar	Strict string, CanonicalInteger, or strict boolean; floating-point values are forbidden. / 严格字符串、CanonicalInteger 或严格布尔值；禁止浮点数。

Every source model rejects unknown fields and validates canonical values. Mapping keys must be strings, integers must be JavaScript-safe, and floating-point or unordered-set values are rejected. / 所有 source model 都拒绝未知字段并校验 canonical value：mapping key 必须是字符串，整数必须在 JavaScript 安全范围内，禁止浮点数和无序集合。

Locale-keyed maps such as CreatorPublicProjectionSourceV1.text may contain both en-US and zh-CN. Other NonEmptyText fields accept either language but are a single authored value unless their field type is explicitly a locale map. / CreatorPublicProjectionSourceV1.text 等 locale map 可同时包含 en-US 和 zh-CN；其他 NonEmptyText 字段虽可写英文或中文，但除非类型明确是 locale map，否则只表示一个创作值。

Regenerate and check / 重新生成与检查

uv run --project apps/api --frozen python scripts/export_creator_source_reference.py
uv run --project apps/api --frozen python scripts/export_creator_source_reference.py --check

1. source-package.yaml

Root model / 根模型：CreatorSourcePackageV1.

CreatorSourcePackageV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_source_package.v1"]	—	—
package	yes / 是	PackageIdentitySourceV1	—	—
modules	yes / 是	SourceModuleRefsV1	—	—
provenance	yes / 是	array<ProvenanceRefSourceV1>	—	—
semantic_parity	yes / 是	SemanticParitySourceV1	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → provenance_is_present. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

PackageIdentitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	PackageId	—	min length / 最短长度: 1; max length / 最长长度: 120; pattern / 格式: ^[a-z0-9][a-z0-9-]*$
version	yes / 是	CanonicalInteger	—	strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991
display_name	yes / 是	NonEmptyText	—	min length / 最短长度: 1
ip_title	yes / 是	NonEmptyText	—	min length / 最短长度: 1
default_locale	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
primary_character_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
arc_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$

SourceModuleRefsV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
character	yes / 是	literal["character.yaml"]	—	—
relationship	yes / 是	literal["relationship.yaml"]	—	—
arc	yes / 是	literal["arc.yaml"]	—	—
dialogue	yes / 是	literal["dialogue.yaml"]	—	—
visual	yes / 是	literal["visual.yaml"]	—	—
acceptance	yes / 是	literal["acceptance.yaml"]	—	—

ProvenanceRefSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
role	yes / 是	literal["historical_hybrid", "governing_product_decision", "semantic_normalization_authority", "synthetic_fixture_origin"]	—	—
ref	yes / 是	NonEmptyText	—	min length / 最短长度: 1

SemanticParitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
preserves	yes / 是	array<NonEmptyText>	—	—
excludes	yes / 是	array<NonEmptyText>	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → parity_claim_is_explicit. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

2. character.yaml

Root model / 根模型：CharacterModuleSourceV1.

CharacterModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_character.v1"]	—	—
character	yes / 是	CharacterSourceV1	—	—

CharacterSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
content_version	yes / 是	CanonicalInteger	—	strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991
display_name	yes / 是	NonEmptyText	—	min length / 最短长度: 1
public_identity	yes / 是	map<Identifier, Scalar>	—	—
values	yes / 是	array<ValueSourceV1>	—	—
self_concept	yes / 是	array<NonEmptyText>	—	—
core_contradiction	yes / 是	NonEmptyText	—	min length / 最短长度: 1
identity_threats	yes / 是	array<NonEmptyText>	—	—
goals	yes / 是	array<NamedSemanticSetSourceV1>	—	—
traits	yes / 是	map<Identifier, Scalar>	—	—
boundaries	yes / 是	array<NonEmptyText>	—	—
prohibited_portrayals	yes / 是	array<NonEmptyText>	—	—
decision_tendencies	yes / 是	array<NamedSemanticSetSourceV1>	—	—
constructive_refusal	yes / 是	ConstructiveRefusalSourceV1	—	—
knowledge	yes / 是	KnowledgeBoundarySourceV1	—	—
disclosure	yes / 是	DisclosureSourceV1	—	—
voice	yes / 是	VoiceSourceV1	—	—

ValueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1

NamedSemanticSetSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
meanings	yes / 是	array<NonEmptyText>	—	—

ConstructiveRefusalSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
meanings	yes / 是	array<NonEmptyText>	—	—
style_anchor	yes / 是	NonEmptyText	—	min length / 最短长度: 1

KnowledgeBoundarySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
may_know	yes / 是	array<NonEmptyText>	—	—
may_not_know	yes / 是	array<NonEmptyText>	—	—
never_treat_as_fact	yes / 是	array<NonEmptyText>	—	—

DisclosureSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
default_maximum	yes / 是	NonEmptyText	—	min length / 最短长度: 1
hidden_motives_disclosed_by_default	yes / 是	literal[false]	—	—

VoiceSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
summary	yes / 是	NonEmptyText	—	min length / 最短长度: 1
verbosity	yes / 是	NonEmptyText	—	min length / 最短长度: 1
emotional_explicitness	yes / 是	NonEmptyText	—	min length / 最短长度: 1
explanation_depth	yes / 是	NonEmptyText	—	min length / 最短长度: 1
preferred_acts	yes / 是	array<NonEmptyText>	—	—
avoid	yes / 是	array<NonEmptyText>	—	—
style_anchors	yes / 是	array<NonEmptyText>	—	—

3. relationship.yaml

Root model / 根模型：RelationshipModuleSourceV1.

RelationshipModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_relationship.v1"]	—	—
relationship	yes / 是	RelationshipSourceV1	—	—

RelationshipSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
character_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
user_role	yes / 是	NonEmptyText	—	min length / 最短长度: 1
channel	yes / 是	RemoteChannelSourceV1	—	—
influence_vocabulary	yes / 是	array<Identifier>	—	—
invented_shared_context	no / 否	InventedSharedContextSourceV1 or null	null	—
reciprocal_promise	no / 否	ReciprocalPromiseSourceV1 or null	null	—
durable_episode_meanings	yes / 是	array<RelationshipEpisodeSourceV1>	—	—

Additional runtime validators / 额外运行时校验：influence_vocabulary → influence_kinds_are_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

RemoteChannelSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
medium_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
visibility	yes / 是	NonEmptyText	—	min length / 最短长度: 1
user_has_physical_presence	yes / 是	literal[false]	—	—
npc_may_receive_user_messages	yes / 是	literal[false]	—	—
npc_may_contact_user	yes / 是	literal[false]	—	—
npc_may_verify_user_or_messages	yes / 是	literal[false]	—	—
character_may_forward_raw_messages	yes / 是	literal[false]	—	—
user_capabilities	yes / 是	array<NonEmptyText>	—	—
user_prohibitions	yes / 是	array<NonEmptyText>	—	—

InventedSharedContextSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
candidate_details	yes / 是	array<InventedDetailSourceV1>	—	—

InventedDetailSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
suggested_value	yes / 是	NonEmptyText	—	min length / 最短长度: 1

ReciprocalPromiseSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
mechanics_profile	yes / 是	literal["reciprocal_report_back_v1"]	—	—
presentation_after_activation	yes / 是	array<NonEmptyText>	—	—
promises	yes / 是	array<PromiseMeaningSourceV1>	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → agreement_is_reciprocal. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

PromiseMeaningSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
promisor	yes / 是	literal["user", "character"]	—	—
beneficiary	yes / 是	literal["user", "character"]	—	—
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
narrative_due	yes / 是	NarrativeDueSourceV1	—	—
followup_motive	no / 否	Identifier or null	null	—
deferred_unavailability_influence_kinds	no / 否	array<Identifier>	[]	—

Additional runtime validators / 额外运行时校验：model / 模型 → parties_differ. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

NarrativeDueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
begins	yes / 是	literal["agreement_activation", "world_outcome"]	—	—
ends_local_time	yes / 是	NonEmptyText	—	min length / 最短长度: 1

Additional runtime validators / 额外运行时校验：ends_local_time → due_end_is_local_time. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

RelationshipEpisodeSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
when	yes / 是	EpisodeConditionSourceV1	—	—
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
effects	yes / 是	map<Identifier, Scalar>	—	—

EpisodeConditionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
outcome_id	no / 否	Identifier or null	null	—
any_influence	no / 否	array<Identifier>	[]	—
all_influence	no / 否	array<Identifier>	[]	—
strength_at_least	no / 否	Identifier or null	null	—

4. arc.yaml

Root model / 根模型：ArcModuleSourceV1.

ArcModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_arc.v1"]	—	—
arc	yes / 是	ArcSourceV1	—	—

ArcSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
content_version	yes / 是	CanonicalInteger	—	strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991
title	yes / 是	NonEmptyText	—	min length / 最短长度: 1
memory_artifact_title	yes / 是	NonEmptyText	—	min length / 最短长度: 1
dilemma	yes / 是	NonEmptyText	—	min length / 最短长度: 1
narrative_time	yes / 是	NarrativeTimeSourceV1	—	—
conversation_availability	yes / 是	ConversationAvailabilitySourceV1	—	—
progression	no / 否	ArcProgressionSourceV1 or null	null	—
world	yes / 是	WorldSliceSourceV1	—	—
decisions	yes / 是	array<DecisionSourceV1>	—	—
outcomes	yes / 是	array<OutcomeSourceV1>	—	—
followups	yes / 是	array<FollowupSourceV1>	—	—

NarrativeTimeSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
local_timezone	yes / 是	NonEmptyText	—	min length / 最短长度: 1
anchor_local_time	yes / 是	NonEmptyText	—	min length / 最短长度: 1
fictional_elapsed_time	yes / 是	NonEmptyText	—	min length / 最短长度: 1

Additional runtime validators / 额外运行时校验：anchor_local_time → anchor_is_local_time. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

ConversationAvailabilitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
default	yes / 是	literal["immediate"]	—	—
deferred_followup	no / 否	DeferredFollowupSourceV1 or null	null	—

DeferredFollowupSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
policy_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
unavailable_phase_refs	yes / 是	array<Identifier>	—	—
consolidation	yes / 是	literal["allowed", "forbidden"]	—	—
wake_condition	yes / 是	DeferredWakeConditionSourceV1	—	—
followup_cutoff_policy	yes / 是	literal["through_ordered_wake_event"]	—	—
maximum_narrative_duration_deadline_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
expiry_followup_decision	yes / 是	ExpiryFollowupDecisionSourceV1	—	—
same_position_trigger_precedence	yes / 是	literal["narrative_expiry_first"]	—	—
public_away_projection_ref	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
post_cutoff_policy	yes / 是	literal["queue_behind_proactive_update"]	—	—
provenance_refs	yes / 是	array<NonEmptyText>	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → unavailable_phases_and_provenance_are_explicit. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

DeferredWakeConditionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
type	yes / 是	literal["character_observed_any_outcome_resolution"]	—	—
outcome_ids	yes / 是	array<Identifier>	—	—

Additional runtime validators / 额外运行时校验：outcome_ids → outcomes_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

ExpiryFollowupDecisionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
contact_user	yes / 是	literal[true]	—	—
motives	yes / 是	array<Identifier>	—	—
timing_meanings	yes / 是	array<NonEmptyText>	—	—
no_world_resolution_known	yes / 是	literal[true]	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → actor_choice_has_bounded_meaning. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

ArcProgressionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
initial_character_beliefs	yes / 是	array<InitialCharacterBeliefSourceV1>	—	—
decision_phase	yes / 是	DecisionPhaseSourceV1	—	—

Additional runtime validators / 额外运行时校验：initial_character_beliefs → initial_beliefs_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

InitialCharacterBeliefSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
belief_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
value	yes / 是	Scalar	—	—
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1

DecisionPhaseSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
candidate_decision_ids	yes / 是	array<Identifier>	—	—
readiness_edges	yes / 是	array<DecisionHorizonReachedSourceV1>	—	—
input_window	yes / 是	literal["first_readiness_event", "until_decision_horizon"]	—	—
no_eligible_guidance	yes / 是	TerminalNoEligibleGuidanceSourceV1	—	—
silence	yes / 是	SilenceSemanticsSourceV1	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → phase_is_terminal_horizon_bounded. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

DecisionHorizonReachedSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
type	yes / 是	literal["decision_horizon_reached"]	—	—
deadline_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$

TerminalNoEligibleGuidanceSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
type	yes / 是	literal["close_unresolved"]	—	—
closure_ref	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
public_projection	yes / 是	CreatorPublicProjectionSourceV1	—	—

CreatorPublicProjectionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
semantic_source	yes / 是	literal["creator"]	—	—
ref	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
text	yes / 是	map<Identifier, NonEmptyText>	—	—

Additional runtime validators / 额外运行时校验：text → localized_text_is_present. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

SilenceSemanticsSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
character_may_decide_independently	yes / 是	literal[true]	—	—
must_not_treat_silence_as_consent	yes / 是	literal[true]	—	—

WorldSliceSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
facts	yes / 是	array<WorldFactSourceV1>	—	—
locations	yes / 是	array<LocationSourceV1>	—	—
npcs	yes / 是	array<NPCSourceV1>	—	—
deadline	no / 否	DeadlineSourceV1 or null	null	—

WorldFactSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
value	yes / 是	Scalar	—	—
public_meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
character_observed	yes / 是	boolean	—	strict scalar / 严格标量
user_disclosable	yes / 是	boolean	—	strict scalar / 严格标量

LocationSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
attributes	yes / 是	map<Identifier, Scalar>	—	—

NPCSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
attributes	yes / 是	map<Identifier, Scalar>	—	—
knows	no / 否	array<Identifier>	[]	—
does_not_know	no / 否	array<Identifier>	[]	—

DeadlineSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
narrative_local_time	yes / 是	NonEmptyText	—	min length / 最短长度: 1
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1

Additional runtime validators / 额外运行时校验：narrative_local_time → deadline_is_local_time. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

DecisionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
allowed_stances	yes / 是	array<Identifier>	—	—
serves	yes / 是	array<NonEmptyText>	—	—
influence_fit	yes / 是	InfluenceFitSourceV1	—	—
eligibility	yes / 是	DecisionEligibilitySourceV1	—	—
action	yes / 是	CharacterActionSourceV1	—	—
outcome_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
fidelity	yes / 是	array<NonEmptyText>	—	—

InfluenceFitSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
supports	no / 否	array<Identifier>	[]	—
resists	no / 否	array<Identifier>	[]	—
may_override	no / 否	array<Identifier>	[]	—

DecisionEligibilitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
required	no / 否	array<CharacterBeliefEqualsPredicateSourceV1 or AcceptedInfluenceKindPresentPredicateSourceV1 or NarrativeDeadlinePositionInPredicateSourceV1>	[]	—
forbidden	no / 否	array<CharacterBeliefEqualsPredicateSourceV1 or AcceptedInfluenceKindPresentPredicateSourceV1 or NarrativeDeadlinePositionInPredicateSourceV1>	[]	—

Additional runtime validators / 额外运行时校验：model / 模型 → predicates_are_unique_and_noncontradictory. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

CharacterBeliefEqualsPredicateSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
type	yes / 是	literal["character_belief_equals"]	—	—
belief_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
expected	yes / 是	Scalar	—	—

AcceptedInfluenceKindPresentPredicateSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
type	yes / 是	literal["accepted_influence_kind_present"]	—	—
influence_kind	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$

NarrativeDeadlinePositionInPredicateSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
type	yes / 是	literal["narrative_deadline_position_in"]	—	—
deadline_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
positions	yes / 是	array<literal["before", "at", "after"]>	—	—

Additional runtime validators / 额外运行时校验：positions → positions_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

CharacterActionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
details	yes / 是	map<Identifier, string or CanonicalInteger or boolean or array<Scalar>>	—	—

OutcomeSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
from_decision_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
event_meaning_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
committed_facts	yes / 是	array<CommittedFactSourceV1>	—	—
causes	yes / 是	array<OutcomeCauseSourceV1>	—	—
character_observes	yes / 是	array<Identifier>	—	—

Additional runtime validators / 额外运行时校验：causes → causes_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

CommittedFactSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
externally_visible	yes / 是	boolean	—	strict scalar / 严格标量
public_meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1

OutcomeCauseSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
kind	yes / 是	literal["character_action", "npc_action", "scenario_clock", "environmental_event"]	—	—
meaning_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
actor_id	no / 否	Identifier or null	null	—

Additional runtime validators / 额外运行时校验：model / 模型 → npc_actor_is_scoped. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

FollowupSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
outcome_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
contact_user	yes / 是	boolean	—	strict scalar / 严格标量
requires_observed_fact_ids	yes / 是	array<Identifier>	—	—
motives	yes / 是	array<Identifier>	—	—
timing_meanings	yes / 是	array<Identifier>	—	—
disclosure_options	yes / 是	array<DisclosureOptionSourceV1>	—	—

DisclosureOptionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
reveal_fact_ids	yes / 是	array<Identifier>	—	—
withhold_fact_ids	yes / 是	array<Identifier>	—	—

5. dialogue.yaml

Root model / 根模型：DialogueModuleSourceV1.

DialogueModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_dialogue.v1"]	—	—
dialogue	yes / 是	DialogueSourceV1	—	—

DialogueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
opening	yes / 是	OpeningDialogueSourceV1	—	—
ordinary	yes / 是	OrdinaryDialogueSourceV1	—	—
recovery	yes / 是	ConversationRecoverySourceV1	—	—
followups	yes / 是	array<FollowupDialogueSourceV1>	—	—
deferred_expiry	no / 否	FollowupDialogueSourceV1 or null	null	—
journal	yes / 是	JournalDialogueSourceV1	—	—

OpeningDialogueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
mode	yes / 是	literal["creator_exact"]	—	—
text	yes / 是	NonEmptyText	—	min length / 最短长度: 1
generated_reply_suggestions	yes / 是	boolean	—	strict scalar / 严格标量

OrdinaryDialogueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
mode	yes / 是	literal["guided_generation"]	—	—
must_convey	no / 否	array<SemanticObligationSourceV1>	[]	—
must_not_disclose_fact_ids	no / 否	array<Identifier>	[]	—

Additional runtime validators / 额外运行时校验：model / 模型 → recovery_meaning_is_unconditional. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

SemanticObligationSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
requires_user_attribution_scope	no / 否	literal["arc_influence", "commitment"] or null	null	—
requires_any_influence_kinds	no / 否	array<Identifier>	[]	—

Additional runtime validators / 额外运行时校验：model / 模型 → attribution_requirement_is_coherent. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

ConversationRecoverySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
degraded_chat	yes / 是	DegradedChatRecoveryPresentationSourceV1	—	—
chat_only	yes / 是	array<ChatOnlyRecoveryPresentationSourceV1>	—	—

Additional runtime validators / 额外运行时校验：chat_only → terminal_surfaces_are_present_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

DegradedChatRecoveryPresentationSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
locale	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
mode	yes / 是	literal["guided_generation"]	—	—
reuse_ordinary_dialogue_meaning	yes / 是	literal[true]	—	—

ChatOnlyRecoveryPresentationSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
locale	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
mode	yes / 是	literal["creator_exact"]	—	—
exact_text_ref	yes / 是	literal["character.constructive_refusal.style_anchor"]	—	—
applicability	yes / 是	array<RecoveryApplicabilitySourceV1>	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → applicability_is_finite_and_unambiguous. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

RecoveryApplicabilitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
availability_class	yes / 是	literal["immediate"]	—	—
recovery_obligation_types	yes / 是	array<literal["ordinary_no_effect", "capability_boundary"]>	—	—

Additional runtime validators / 额外运行时校验：recovery_obligation_types → obligation_types_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

FollowupDialogueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
followup_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
mode	yes / 是	literal["semantic_lock"]	—	—
must_convey	yes / 是	array<SemanticObligationSourceV1>	—	—
must_not_disclose_fact_ids	yes / 是	array<Identifier>	—	—

Additional runtime validators / 额外运行时校验：model / 模型 → semantic_lock_has_meaning. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。

JournalDialogueSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
title	yes / 是	NonEmptyText	—	min length / 最短长度: 1
entry_separator	yes / 是	NonEmptyText	—	min length / 最短长度: 1
no_influence_text	yes / 是	NonEmptyText	—	min length / 最短长度: 1
sections	yes / 是	array<JournalSectionSourceV1>	—	—
statements	yes / 是	array<JournalStatementSourceV1>	—	—

JournalSectionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1

JournalStatementSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
section_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
source_kind	yes / 是	literal["influence_kind", "decision_envelope", "outcome"]	—	—
source_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
mode	yes / 是	literal["creator_exact"]	—	—
text	yes / 是	NonEmptyText	—	min length / 最短长度: 1

6. visual.yaml

Root model / 根模型：VisualModuleSourceV1.

VisualModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_visual.v1"]	—	—
visual	yes / 是	VisualSourceV1	—	—

VisualSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
identity	yes / 是	VisualIdentitySourceV1	—	—
portrait	yes / 是	AssetCandidateSourceV1	—	—
outcomes	yes / 是	array<OutcomeDepictionSourceV1>	—	—

VisualIdentitySourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
description	yes / 是	NonEmptyText	—	min length / 最短长度: 1
style	yes / 是	NonEmptyText	—	min length / 最短长度: 1
palette	yes / 是	array<NonEmptyText>	—	—
avoid	yes / 是	array<NonEmptyText>	—	—

AssetCandidateSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
source_path	yes / 是	NonEmptyText	—	min length / 最短长度: 1
provenance_ref	yes / 是	NonEmptyText	—	min length / 最短长度: 1

OutcomeDepictionSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
outcome_id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
content_version	yes / 是	CanonicalInteger	—	strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991
asset	yes / 是	AssetCandidateSourceV1	—	—
alt_text	yes / 是	NonEmptyText	—	min length / 最短长度: 1
visible_fact_ids	yes / 是	array<Identifier>	—	—
forbidden_fact_ids	yes / 是	array<Identifier>	—	—

7. acceptance.yaml

Root model / 根模型：AcceptanceModuleSourceV1.

AcceptanceModuleSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
schema_version	yes / 是	literal["meet_u.creator_acceptance.v1"]	—	—
acceptance	yes / 是	AcceptanceSourceV1	—	—

AcceptanceSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
cases	yes / 是	array<AcceptanceCaseSourceV1>	—	—
paraphrase_ranges	yes / 是	array<ParaphraseRangeSourceV1>	—	—

AcceptanceCaseSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
semantic_position	yes / 是	NonEmptyText	—	min length / 最短长度: 1
expected_influence_kinds	yes / 是	array<Identifier>	—	—
allowed_decision_ids	yes / 是	array<Identifier>	—	—
forbidden_effects	yes / 是	array<NonEmptyText>	—	—

ParaphraseRangeSourceV1

Field / 字段	Required / 必填	YAML type / YAML 类型	Default / 默认值	Structural constraints / 结构约束
id	yes / 是	Identifier	—	min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$
shared_meaning	yes / 是	NonEmptyText	—	min length / 最短长度: 1
allowed_decision_ids	yes / 是	array<Identifier>	—	—
variation_dimensions	yes / 是	array<NonEmptyText>	—	—