[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBJC43TCM1MV7BGH8SH5GY":3,"skill-same:01M6CBJC43TCM1MV7BGH8SH5GY":45},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":20,"linkOnly":21,"markdownContent":22,"markdownBody":22,"frontMatter":23,"refName":24,"commitSha":25,"skillDirectory":26,"forksCount":13,"repositoryHtmlUrl":27,"repositoryHomepageUrl":6,"ownerHtmlUrl":28,"ownerBlogUrl":6,"ownerDescription":29,"updatedAt":30,"install":31,"resources":44},"01M6CBJC43TCM1MV7BGH8SH5GY","10-recovery-manager",null,"devwinsoft\u002Fdevian","devwinsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F22570160?v=4","01M6C6RR8W05NH8NPKQNCE3Q72","maoshy","01M6C6RRDJ5TJJCZXRTY801YDH",0,"MIT","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F25-recovery-system\u002F10-recovery-manager\u002FSKILL.md",[],[18,19],"recovery","10 recovery manager","2026-11-10 10:12:30",false,"# 10-recovery-manager\n\n\nRecoveryManager는 save data의 **Export(전송)** 와 **Import(복원)** 를 오케스트레이션한다.\n\nRecoveryManager는 **독립 클래스**이다.\n- SaveDataManager의 public API만 사용한다 (internal 접근 금지).\n- 인코딩\u002F디코딩은 RecoveryCodec에 위임한다.\n- 서버\u002F네트워크에 의존하지 않는다.\n\n\n---\n\n\n## Singleton\n\n```csharp\nCompoSingleton\u003CRecoveryManager>.Instance\n```\n\n- Registry key: `RecoveryManager`\n- 다른 매니저에서 접근: `Singleton.Get\u003CRecoveryManager>()`\n\n\n---\n\n\n## Responsibilities (정본)\n\n- Export: 현재 save data → .dvn 파일 생성 → DevianShare로 공유\n- Import (경로 A): OS 파일 연결로 .dvn 수신 → 디코딩 → 검증 → SaveDataManager로 복원\n- Import (경로 B): 앱 내 File Picker로 .dvn 선택 → 디코딩 → 검증 → SaveDataManager로 복원\n\n비책임(금지):\n- 자동 복구\n- 클라우드 동기화\n- 서버\u002F네트워크 호출\n- 복원 이력(ledger) 관리\n\n\n---\n\n\n## Dependencies (개념)\n\n- SaveDataManager — 평문 JSON 획득 및 복원 위임\n- RecoveryCodec — .dvn 인코딩\u002F디코딩 + HMAC 무결성 검증\n- AccountManager — 현재 로그인된 socialUserId 획득 (Import 시 계정 검증)\n- DevianShare 네이티브 플러그인 — OS 공유 시트 호출 (Export), 파일 선택 다이얼로그 (Import 경로 B) ([30-recovery-platform](..\u002F30-recovery-platform\u002FSKILL.md) 참조)\n- Platform Native Layer — .dvn 파일 수신 (Import 경로 A, [30-recovery-platform](..\u002F30-recovery-platform\u002FSKILL.md) 참조)\n\n\n---\n\n\n## Public API\n\n\n### Export (공유 시트)\n\n- `Task\u003CCommonResult\u003Cbool>> ExportDvnAsync(CancellationToken ct)`\n\n```\n1. SaveDataManager.Instance.ToJson() → 평문 JSON 획득\n2. RecoveryCodec.Encode(json) → .dvn string (v2: HMAC 포함)\n3. 임시 파일 저장 (Application.temporaryCachePath)\n   파일명: recovery_{timestamp}.dvn\n4. DevianShare.ShareFile로 OS 공유 시트 열기\n   - Subject: 앱 이름 + \"Save Data Recovery\"\n   - 첨부: .dvn 파일\n```\n\n\n### Export (이메일 전용)\n\n- `Task\u003CCommonResult\u003Cbool>> ExportDvnViaEmailAsync(string recipient, CancellationToken ct)`\n\n```\n1~3. ExportDvnAsync와 동일 (PrepareDvnFileAsync 공유, v2 HMAC 포함)\n4. DevianShare.SendEmail로 이메일 앱 열기\n   - 수신자: recipient (프리셋)\n   - Subject: 앱 이름 + \"Save Data Recovery\"\n   - 첨부: .dvn 파일\n```\n\n- 이메일 앱만 표시된다 (범용 공유 시트 아님).\n- iOS: `MFMailComposeViewController`, Android: `message\u002Frfc822` + `EXTRA_EMAIL`\n\n\n### Import (경로 A: OS 파일 연결)\n\n- `Task\u003CCommonResult\u003Cbool>> ImportDvnAsync(string filePath, CancellationToken ct)`\n\n```\n1. filePath에서 .dvn 파일 읽기\n2. RecoveryCodec.Decode(content) → CommonResult\u003Cstring> 평문 JSON\n   - v2: HMAC 무결성 검증 포함 (RecoveryCodec 내부)\n   - v1: 하위호환 (HMAC 없이 디코딩)\n3. JSON 기본 검증 (파싱 가능 여부)\n4. socialUserId 일치 검증:\n   json 내부 account.socialUserId vs AccountManager.Instance.Storage.socialUserId\n   - 불일치 → 에러 반환 (다른 계정의 데이터)\n5. SaveDataManager.Instance.RestoreFromPlainJsonAsync(json, true, ct)\n   → 런타임 적용 + local\u002Fcloud 영속화\n6. 임시 .dvn 파일 삭제\n```\n\n\n### Import (경로 B: 앱 내 File Picker)\n\n- `Task\u003CCommonResult\u003Cbool>> PickAndImportDvnAsync(CancellationToken ct)`\n\n```\n1. 네이티브 파일 선택 다이얼로그 열기 (DevianShare.PickFile)\n   - Android: ACTION_OPEN_DOCUMENT (application\u002Foctet-stream, 기본 폴더: Downloads)\n   - iOS: UIDocumentPickerViewController (public.data UTI, 기본 폴더: Downloads)\n   - TaskCompletionSource로 네이티브 콜백을 async\u002Fawait 변환\n   - iOS\u002FAndroid 디바이스 빌드에서만 동작. Editor\u002F기타 플랫폼에서는 skip + 성공 반환.\n2. 사용자가 파일 선택 → 네이티브가 임시 경로로 복사 → OnFilePickerResult 콜백\n   - 취소 시: 에러 반환 (사용자 취소, 정상 플로우)\n3. ImportDvnAsync(filePath, ct) 호출 (기존 로직 재사용)\n```\n\n- 기존 `ImportDvnAsync`를 재사용하므로, 디코딩\u002F검증\u002F복원 로직은 동일하다.\n- File Picker에서 .dvn 이외 파일을 선택해도, Decode 단계에서 실패로 처리된다.\n- 네이티브 구현: [30-recovery-platform](..\u002F30-recovery-platform\u002FSKILL.md) §Import — DevianFilePicker 참조\n\n\n---\n\n\n## SaveDataManager API 연결\n\nRecoveryManager는 SaveDataManager의 아래 public API를 사용한다:\n\n- **Export**: `string ToJson()` — 현재 런타임 게임 상태를 평문 JSON으로 직렬화\n- **Import**: `Task\u003CCommonResult\u003Cbool>> RestoreFromPlainJsonAsync(string json, bool saveCloud, CancellationToken ct)` — 평문 JSON 복원 + 영속화\n\n정본: [10-savedata-manager](..\u002F..\u002F21-savedata-system\u002F10-savedata-manager\u002FSKILL.md) §Public API\n\n\n---\n\n\n## Error Cases\n\n| 상황 | 처리 |\n|------|------|\n| 공유 시트 호출 실패 | `COMMON_ERROR_TYPE` 에러 반환 |\n| 파일 선택 취소 (File Picker) | 에러 반환 (사용자 취소, 정상 플로우) |\n| .dvn 파일 읽기 실패 | 에러 반환 + 유저에게 안내 |\n| RecoveryCodec.Decode 실패 (손상\u002F위조) | 에러 반환 + \"복원 실패\" 안내 |\n| HMAC 불일치 (v2, RecoveryCodec 내부) | `RECOVERY_HMAC_FAILED` 에러 반환 |\n| socialUserId 불일치 (다른 계정) | 에러 반환 + \"다른 계정의 데이터\" 안내 |\n| JSON version 불일치 | 에러 반환 + 버전 안내 |\n| SaveDataManager 복원 실패 | 에러 반환, 기존 데이터 유지 |\n\n\n---\n\n\n## Sequence Example\n\n### Export (공유 시트)\n1. 유저가 설정 화면에서 \"데이터 전송\" 버튼 탭\n2. `RecoveryManager.ExportDvnAsync(ct)` 호출\n3. 평문 JSON 획득 → RecoveryCodec.Encode → .dvn 파일 생성 → DevianShare.ShareFile\n4. 유저가 이메일 앱 선택 → 개발자에게 전송\n\n### Export (이메일 전용)\n1. 유저가 설정 화면에서 \"이메일로 전송\" 버튼 탭\n2. `RecoveryManager.ExportDvnViaEmailAsync(recipient, ct)` 호출\n3. 평문 JSON 획득 → RecoveryCodec.Encode → .dvn 파일 생성 → DevianShare.SendEmail\n4. 이메일 앱이 수신자 프리셋 상태로 열림 → 유저가 전송\n\n### Import (경로 A: OS 파일 연결)\n1. 유저가 이메일에서 .dvn 첨부파일 탭\n2. OS가 게임으로 파일 전달 (Custom File Type Association)\n3. 네이티브 레이어 → `RecoveryManager.ImportDvnAsync(filePath, ct)` 호출\n4. 디코딩 (v2: HMAC 검증) → socialUserId 일치 확인 → 복원 → 유저에게 \"복원 완료\" 안내\n\n### Import (경로 B: 앱 내 File Picker)\n1. 유저가 설정 화면에서 \"데이터 복원\" 버튼 탭\n2. `RecoveryManager.PickAndImportDvnAsync(ct)` 호출\n3. 네이티브 파일 선택 다이얼로그 표시 (SAF \u002F UIDocumentPicker)\n4. 유저가 .dvn 파일 선택\n5. 네이티브 → 임시 경로 복사 → `OnFilePickerResult(filePath)` 콜백\n6. `ImportDvnAsync(filePath, ct)` → 디코딩 → 검증 → 복원 → 유저에게 \"복원 완료\" 안내\n\n\n---\n\n\n## Implementation Location (3-path mirror)\n\n> 3-path mirror 정책: [devian-unity\u002F04-package-policy](..\u002F..\u002F..\u002F04-package-policy\u002FSKILL.md), [devian-unity\u002F01-policy](..\u002F..\u002F..\u002F01-policy\u002FSKILL.md) §SSOT 원칙\n\n- RecoveryManager:\n  - UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryManager.cs`\n  - Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryManager.cs`\n  - Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryManager.cs`\n\nasmdef:\n- `Devian.Samples.MobilePackage.asmdef`\n\n\n---\n\n\n## Related\n\n- [25-recovery-system\u002F03-ssot](..\u002F03-ssot\u002FSKILL.md) — DVN 포맷 정본\n- [20-recovery-codec](..\u002F20-recovery-codec\u002FSKILL.md) — RecoveryCodec (인코딩\u002F디코딩)\n- [30-recovery-platform](..\u002F30-recovery-platform\u002FSKILL.md) — 플랫폼 파일 수신부 + 공유 시트 + 파일 선택\n- [10-savedata-manager](..\u002F..\u002F21-savedata-system\u002F10-savedata-manager\u002FSKILL.md) — SaveDataManager 진입점\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F25-recovery-system\u002F10-recovery-manager","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft","Kim Hyong Joon","2026-04-12 18:44:10",{"source":7,"skillName":5,"commands":32,"prompt":42,"zipAvailable":43},[33,36,39],{"tool":34,"command":35},"npx","npx skills add devwinsoft\u002Fdevian --skill 10-recovery-manager",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 10-recovery-manager",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 10-recovery-manager","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F25-recovery-system\u002F10-recovery-manager\u002FSKILL.md",true,[],[46,52,60,68,77,84],{"skillNo":47,"name":48,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":49,"categories":50,"keywords":51,"publishedAt":20},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[48],{"skillNo":53,"name":54,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":55,"categories":56,"keywords":57,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[58,59],"archive","90 project archive",{"skillNo":61,"name":62,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[66,67],"management","30 env management",{"skillNo":69,"name":70,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":20},"01M6CBWYD3TGWBQV7V35551THF","19-page-push-send","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F19-page-push-send\u002FSKILL.md",[],[74,75,76],"push","page","19 page push send",{"skillNo":78,"name":79,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":20},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[75,83],"18 page savedata",{"skillNo":85,"name":86,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":11,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":87,"categories":88,"keywords":89,"publishedAt":20},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[75,90],"17 page deobfuscate"]