Creator Source Package v1 field reference / 字段参考（English / 简体中文）
This generated reference inventories the current structural source contract for all eight Creator Source Package v1 YAML files. It is generated from the versioned executable source contracts; the current inventory contains 100 models and 385 fields. Do not edit this file by hand.
本文档自动列出 Creator Source Package v1 八个 YAML 文件的当前 source 结构契约。内容由版本化的 executable source contract 自动生成；当前清单包含 100 个 model 和 385 个字段。请勿手动修改。
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 / 重新生成与检查
bash
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 --check1. 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"] | — | — |
sequences | no / 否 | literal["sequences.yaml"] or null | null | — |
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 or InfluenceKindSourceV1> | — | — |
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> | — | — |
InfluenceKindSourceV1
| 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 / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 500 |
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 | — | — |
consequence_return_wake_condition | no / 否 | DeferredConsequenceReturnWakeConditionSourceV1 or null | null | — |
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 为准。
DeferredConsequenceReturnWakeConditionSourceV1
| 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_consequence_return"] | — | — |
consequence_phase_refs | yes / 是 | array<Identifier> | — | — |
Additional runtime validators / 额外运行时校验：consequence_phase_refs → phase_refs_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 | — | — |
aftermath | no / 否 | array<AftermathChainSourceV1> or null | null | — |
Additional runtime validators / 额外运行时校验：initial_character_beliefs → initial_beliefs_are_nonempty_and_unique; aftermath → aftermath_is_absent_or_nonempty_with_distinct_branches. 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] | — | — |
AftermathChainSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
branch_of | yes / 是 | Identifier | — | min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
beats | yes / 是 | array<AftermathBeatSourceV1> | — | — |
Additional runtime validators / 额外运行时校验：beats → beats_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
AftermathBeatSourceV1
| 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 |
narrative_gap | yes / 是 | NonEmptyText | — | min length / 最短长度: 1 |
world_event | no / 否 | AftermathWorldEventSourceV1 or null | null | — |
followup_id | no / 否 | Identifier or null | null | — |
away_projection | yes / 是 | NonEmptyText | — | min length / 最短长度: 1 |
decision_phase | no / 否 | BeatDecisionPhaseSourceV1 or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → beat_kind_is_unambiguous. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
AftermathWorldEventSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
committed_fact_ids | yes / 是 | array<Identifier> | — | — |
npc_cause_ids | no / 否 | array<Identifier> or null | null | — |
Additional runtime validators / 额外运行时校验：committed_fact_ids → committed_facts_are_nonempty_and_unique; npc_cause_ids → npc_causes_are_absent_or_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
BeatDecisionPhaseSourceV1
| 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> | — | — |
input_window | yes / 是 | literal["first_readiness_event", "until_decision_horizon", "since_prior_decision"] | — | — |
no_eligible_guidance | yes / 是 | TerminalNoEligibleGuidanceSourceV1 | — | — |
silence | yes / 是 | SilenceSemanticsSourceV1 | — | — |
Additional runtime validators / 额外运行时校验：candidate_decision_ids → candidates_are_nonempty_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
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 | — | — |
away_composer_placeholder | no / 否 | string or null | null | — |
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", "deferred_message"] 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 | no / 否 | NonEmptyText or null | null | — |
exact_text_ref | no / 否 | literal["character.constructive_refusal.style_anchor"] or null | null | — |
applicability | yes / 是 | array<RecoveryApplicabilitySourceV1> | — | — |
Additional runtime validators / 额外运行时校验：model / 模型 → exact_text_source_is_unambiguous, 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", "meet_u.creator_visual.v2"] | — | — |
visual | yes / 是 | VisualSourceV1 | — | — |
Additional runtime validators / 额外运行时校验：model / 模型 → expression_portraits_require_v2. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
VisualSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
identity | yes / 是 | VisualIdentitySourceV1 | — | — |
portrait | yes / 是 | AssetCandidateSourceV1 | — | — |
discovery | no / 否 | DiscoveryPresentationSourceV1 or null | null | — |
outcomes | yes / 是 | array<OutcomeDepictionSourceV1> | — | — |
expression_portraits | no / 否 | array<ExpressionPortraitSourceV1> or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → expression_portraits_are_bounded_and_unique. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
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 |
DiscoveryPresentationSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
short_hook | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 160 |
gallery_cover | yes / 是 | DiscoveryGalleryCoverSourceV1 | — | — |
public_fact_ids | yes / 是 | array<Identifier> | — | — |
forbidden_fact_ids | yes / 是 | array<Identifier> | — | — |
starter_topics | no / 否 | array<NonEmptyText> or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → starter_topics_are_bounded, fact_guards_are_unique_and_disjoint. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
DiscoveryGalleryCoverSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
content_version | yes / 是 | CanonicalInteger | — | strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991 |
asset | yes / 是 | AssetCandidateSourceV1 | — | — |
alt_text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 500 |
crop | yes / 是 | DiscoveryCoverCropSourceV1 | — | — |
Additional runtime validators / 额外运行时校验：content_version → content_version_is_positive. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
DiscoveryCoverCropSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
aspect_ratio | yes / 是 | literal["3:4"] | — | — |
focal_point | yes / 是 | DiscoveryFocalPointSourceV1 | — | — |
DiscoveryFocalPointSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
x_percent | yes / 是 | CanonicalInteger | — | strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991 |
y_percent | yes / 是 | CanonicalInteger | — | strict scalar / 严格标量; minimum / 最小值: -9007199254740991; maximum / 最大值: 9007199254740991 |
Additional runtime validators / 额外运行时校验：x_percent, y_percent → coordinate_is_a_percent. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
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> | — | — |
ExpressionPortraitSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
expression_id | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 64; pattern / 格式: ^[a-z][a-z0-9]*(_[a-z0-9]+)*$ |
asset | yes / 是 | AssetCandidateSourceV1 | — | — |
alt_text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 500 |
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> | — | — |
8. sequences.yaml
Root model / 根模型：SequencesModuleSourceV1.
SequencesModuleSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
schema_version | yes / 是 | literal["meet_u.creator_sequences.v1"] | — | — |
sequences | yes / 是 | array<IntroSequenceSourceV1 or DecisionOutcomeSequenceSourceV1 or ProactiveReturnSequenceSourceV1> | — | — |
Additional runtime validators / 额外运行时校验：model / 模型 → sequences_are_present_and_unambiguous. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
IntroSequenceSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
trigger | yes / 是 | literal["intro"] | — | — |
steps | yes / 是 | array<SequenceStepSourceV1> | — | min items / 最少项: 1; max items / 最多项: 12 |
resting_backdrop | no / 否 | SequenceBackdropAssetSourceV1 or SequenceBackdropAssetRefSourceV1 or SequenceBackdropGradientSourceV1 or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → steps_are_literal_only. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
SequenceStepSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
backdrop | yes / 是 | SequenceBackdropAssetSourceV1 or SequenceBackdropAssetRefSourceV1 or SequenceBackdropGradientSourceV1 | — | discriminator / 判别字段: kind |
portrait | no / 否 | string or null | null | — |
line | no / 否 | string or null | null | — |
line_from | no / 否 | literal["character_choice", "world_outcome", "user_contribution"] or null | null | — |
speaker | no / 否 | literal["narration", "character"] | "narration" | — |
advance | yes / 是 | SequenceAdvanceClickSourceV1 or SequenceAdvanceAutoSourceV1 | — | discriminator / 判别字段: kind |
overlay | yes / 是 | SequenceOverlayNoneSourceV1 or SequenceOverlayPermanenceSealSourceV1 or SequenceOverlayActTitleSourceV1 | — | discriminator / 判别字段: kind |
voice | no / 否 | AssetCandidateSourceV1 or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → line_source_is_exactly_one, character_speech_requires_a_literal_line. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
SequenceBackdropAssetSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["asset"] | — | — |
asset | yes / 是 | AssetCandidateSourceV1 | — | — |
alt_text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 500 |
SequenceBackdropAssetRefSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["asset_ref"] | — | — |
asset_id | yes / 是 | Identifier | — | min length / 最短长度: 1; max length / 最长长度: 160; pattern / 格式: ^[A-Za-z0-9][A-Za-z0-9._:-]*$ |
alt_text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 500 |
SequenceBackdropGradientSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["gradient"] | — | — |
SequenceAdvanceClickSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["click"] | — | — |
SequenceAdvanceAutoSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["auto"] | — | — |
duration_ms | yes / 是 | integer | — | strict scalar / 严格标量; minimum / 最小值: 500; maximum / 最大值: 30000 |
SequenceOverlayNoneSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["none"] | — | — |
SequenceOverlayPermanenceSealSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["permanence_seal"] | — | — |
text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 60 |
SequenceOverlayActTitleSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
kind | yes / 是 | literal["act_title"] | — | — |
text | yes / 是 | string | — | min length / 最短长度: 1; max length / 最长长度: 60 |
DecisionOutcomeSequenceSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
trigger | yes / 是 | literal["decision_outcome"] | — | — |
beat_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._:-]*$ |
steps | yes / 是 | array<SequenceStepSourceV1> | — | min items / 最少项: 1; max items / 最多项: 12 |
resting_backdrop | no / 否 | SequenceBackdropAssetSourceV1 or SequenceBackdropAssetRefSourceV1 or SequenceBackdropGradientSourceV1 or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → steps_are_never_character_spoken. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。
ProactiveReturnSequenceSourceV1
| Field / 字段 | Required / 必填 | YAML type / YAML 类型 | Default / 默认值 | Structural constraints / 结构约束 |
|---|---|---|---|---|
trigger | yes / 是 | literal["proactive_return"] | — | — |
steps | yes / 是 | array<SequenceStepSourceV1> | — | min items / 最少项: 1; max items / 最多项: 12 |
resting_backdrop | no / 否 | SequenceBackdropAssetSourceV1 or SequenceBackdropAssetRefSourceV1 or SequenceBackdropGradientSourceV1 or null | null | — |
Additional runtime validators / 额外运行时校验：model / 模型 → steps_are_literal_only. See the source contract for their exact semantics. / 具体语义以源码 contract 为准。