初始化提交

backend/app/schemas/personality.py

@@ -0,0 +1,101 @@
+"""人格 API schema。"""
+
+from typing import Any
+
+from pydantic import BaseModel, ConfigDict, Field
+
+
+class PersonalityResponse(BaseModel):
+    model_config = ConfigDict(
+        json_schema_extra={
+            "examples": [
+                {
+                    "id": "personality_9b5f5b7e413442d0a2f9e61a2f4d7df5",
+                    "character_id": "character_ec83d55746c54e47ab6f98d683032626",
+                    "version": 1,
+                    "identity_profile": "魂镜默认人物，面向本地 MVP 联调。",
+                    "role_destiny": "帮助用户验证对话、记忆和运行时链路。",
+                    "personality_seed": "稳定、简洁、可靠。",
+                    "traits": {"tone": "calm", "helpfulness": 0.9},
+                    "expression_style": "使用简洁中文回答，必要时列出验证步骤。",
+                    "values": {"accuracy": "high", "privacy": "high"},
+                    "relationship_pattern": "以协作者方式与用户互动。",
+                    "emotion_baseline": {"mood": "neutral"},
+                    "reason": "初始化默认人格。",
+                    "evidence_ids": [],
+                    "created_by": "system",
+                    "created_at": "2026-06-19T09:00:00.000000Z",
+                }
+            ]
+        }
+    )
+
+    id: str = Field(description="人格版本 ID。")
+    character_id: str = Field(description="所属人物 ID。")
+    version: int = Field(description="人格版本号。")
+    identity_profile: str = Field(description="身份画像。")
+    role_destiny: str = Field(description="角色定位与使命。")
+    personality_seed: str = Field(description="人格种子。")
+    traits: dict[str, Any] = Field(description="人格特质。")
+    expression_style: str = Field(description="表达风格。")
+    values: dict[str, Any] = Field(description="价值偏好。")
+    relationship_pattern: str = Field(description="关系模式。")
+    emotion_baseline: dict[str, Any] = Field(description="情绪基线。")
+    reason: str = Field(description="版本创建原因。")
+    evidence_ids: list[str] = Field(description="证据 ID 列表。")
+    created_by: str = Field(description="创建者。")
+    created_at: str = Field(description="创建时间，UTC ISO 8601 字符串。")
+
+
+# 允许人工提议覆盖的人格字段（None 表示不改）。dict 字段落库为 JSON 文本。
+_PERSONALITY_STRING_FIELDS = (
+    "identity_profile",
+    "role_destiny",
+    "personality_seed",
+    "expression_style",
+    "relationship_pattern",
+)
+_PERSONALITY_JSON_FIELDS = ("traits", "values", "emotion_baseline")
+
+
+class PersonalityProposalFields(BaseModel):
+    """人格字段覆盖建议；仅列允许编辑字段，未传（None）表示不改。"""
+
+    identity_profile: str | None = None
+    role_destiny: str | None = None
+    personality_seed: str | None = None
+    traits: dict[str, Any] | None = None
+    expression_style: str | None = None
+    values: dict[str, Any] | None = None
+    relationship_pattern: str | None = None
+    emotion_baseline: dict[str, Any] | None = None
+
+    def has_any(self) -> bool:
+        """是否至少覆盖一个字段。"""
+        return any(
+            getattr(self, f) is not None
+            for f in _PERSONALITY_STRING_FIELDS + _PERSONALITY_JSON_FIELDS
+        )
+
+
+class ProposePersonalityUpdateRequest(BaseModel):
+    """提交人格修改建议（api-spec §11）；建议进入 pending 待审核。"""
+
+    character_id: str | None = Field(default=None, description="人物 ID，省略取当前激活人物。")
+    fields: PersonalityProposalFields = Field(description="需变更的人格字段覆盖。")
+    reason: str = Field(min_length=1, description="修改原因，必填留痕。")
+
+
+class PersonalityProposalResponse(BaseModel):
+    """人格修改建议响应（api-spec §11）。"""
+
+    proposal_id: str = Field(description="建议 ID。")
+    character_id: str = Field(description="所属人物 ID。")
+    status: str = Field(description="建议状态，见契约字典 §10.6 candidate.status。")
+    reason: str = Field(description="修改原因。")
+    fields: dict[str, Any] = Field(description="实际覆盖的字段集合。")
+    resulting_version_id: str | None = Field(
+        default=None, description="审核通过后生成的人格版本 ID。"
+    )
+    reviewed_at: str | None = Field(default=None, description="审核时间。")
+    created_at: str = Field(description="创建时间，UTC ISO 8601 字符串。")