AGENT SKILL

00-overview

暂无简介

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

02 资源文件 1

03 SKILL.md 正文

25-recovery-system — Overview

Status: ACTIVE AppliesTo: v10

Save data 손상 시 자동 복구가 불가능할 때, 유저가 이메일로 save data를 개발자에게 전송하고, 개발자가 운영툴로 수정/보상 후 패치된 데이터를 회신하는 이메일 기반 수동 복원 시스템이다.

서버 없이 동작하며, Custom File Type Association(.dvn)을 통해 딥링크와 동일한 UX를 제공한다.


Flow

========= Export (Player → 개발자) =========

SaveDataManager → 평문 JSON (~100KB)
    ↓ RecoveryCodec.Encode
    ↓ ComplexUtil.Encrypt_Base64 → version prefix
.dvn 파일
    ↓ DevianShare → OS 공유 시트 → 이메일 전송

========= 운영 (개발자) =========

.dvn 수신 → 운영툴로 디코딩 → 수정/보상 → 재인코딩 → .dvn 회신

========= Import (Player ← 개발자) =========

경로 A: Custom File Type Association (OS 파일 연결)
이메일에서 .dvn 첨부파일 탭
    ↓ OS가 게임으로 전달 (Custom File Type Association)
    ↓ RecoveryCodec.Decode
    ↓ version parse → ComplexUtil.Decrypt_Base64 → 평문 JSON
    ↓ 검증 → SaveDataManager로 복원

경로 B: 앱 내 File Picker
설정 화면에서 "데이터 복원" 버튼 탭
    ↓ OS 파일 선택 다이얼로그 (SAF / UIDocumentPicker)
    ↓ .dvn 파일 선택 → 임시 경로로 복사
    ↓ RecoveryCodec.Decode → 검증 → SaveDataManager로 복원

Start Here

Document Description
01-policy 하드룰 (암호화, 파일 포맷, 보안, 모듈 경계)
03-ssot DVN 파일 포맷 스펙, 인코딩 파이프라인
10-recovery-manager RecoveryManager 오케스트레이터 (Export + Import)
20-recovery-codec RecoveryCodec (encode/decode 파이프라인)
30-recovery-platform iOS/Android 파일 타입 등록 및 네이티브 수신부

Dependencies

  • 21-savedata-system — SaveDataManager (평문 JSON 획득/복원)
  • DevianShare 네이티브 플러그인 — OS 공유 시트 호출 (Export), 파일 선택 다이얼로그 (Import 경로 B) (30-recovery-platform 참조)

운영툴:


Related

04 同仓库更多 Skills