AGENT SKILL

14-achieve-storage

暂无简介

License 许可
MIT
所属仓库
devwinsoft/devian
最近更新
2026-04-12
Stars
★ 0
Forks
0

03 SKILL.md 正文

14-achieve-storage

Status: ACTIVE AppliesTo: v10

AchieveStorage 저장 모델 규약 문서다.


Implementation Location

  • framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/Achieve/AchieveStorage.cs
  • framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodecAchieve.cs
  • framework-cs/apps/UnityExample/Assets/Samples/Devian Samples/{version}/MobilePackage/Runtime/SaveData/JsonCodec/SaveDataJsonCodec.cs

Ownership

  • AchieveManager가 AchieveStorage를 소유한다.
  • 정본 접근 경계: AchieveManager.Storage

Storage Model

AchieveStorage 필드:

  • schemaVersion
  • nextAchieveUid
  • runtimes: Dictionary<int, AchieveRuntimeBase>

규칙:

  • runtimes는 업적 진행/claim 상태의 저장 정본이다.
  • progress source는 runtime별 MESSAGE.saveType 규칙을 따른다.
    • TOTAL_*: 외부 저장(GameMessageStorage) projection
    • SESSION_*: runtime 내부 progressValue
  • Clear()는 schema 기본값 + 모든 컬렉션 초기화

SaveData Payload

루트 payload에서 Achieve 섹션은 achieve 키를 사용한다.

{
  "version": 15,
  "achieve": {
    "schemaVersion": 2,
    "nextAchieveUid": 1,
    "runtimes": [
      {
        "achieveType": 1,
        "achieve_id": "...",
        "achieveUid": 1,
        "level": 1,
        "index": 0,
        "progressValue": { "base": 0, "pow": 0 },
        "isWaiting": false,
        "isCompleted": false
      }
    ]
  }
}

핵심 규칙:

  • achieve runtime 저장 위치는 반드시 achieve.runtimes
  • period 개념은 없고 achieve.period 계층을 사용하지 않는다.

Deserialize Rules

  • AchieveStorage.Clear() 후 복원
  • uid <= 0 항목은 무시
  • nextAchieveUid <= 0이면 1로 보정
  • 누락 키는 안전 기본값 사용
  • 구버전 payload에 achieveType이 없으면 table(TB_ACHIEVE_SOCIAL, TB_ACHIEVE_PASS) 기반으로 타입을 추론한다.

04 同仓库更多 Skills