[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBJEFBYQVJ9R4DN0A028TD":3,"skill-same:01M6CBJEFBYQVJ9R4DN0A028TD":51},{"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},"01M6CBJEFBYQVJ9R4DN0A028TD","20-recovery-codec",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\u002F20-recovery-codec\u002FSKILL.md",[],[18,19],"recovery","20 recovery codec","2026-11-10 10:12:30",false,"# 20-recovery-codec\n\n\nRecoveryCodec는 평문 JSON과 `.dvn` 파일 내용 간의 **인코딩\u002F디코딩 파이프라인**을 구현하는 static utility 클래스다.\n\n- 파이프라인 정의는 [03-ssot](..\u002F03-ssot\u002FSKILL.md) §B를 따른다.\n- HMAC 무결성 검증은 [03-ssot](..\u002F03-ssot\u002FSKILL.md) §E를 따른다.\n- SaveDataManager의 payload 포맷과 동일한 ComplexUtil 난독화를 사용한다.\n\n\n---\n\n\n## Class Design\n\n```csharp\ninternal static class RecoveryCodec\n```\n\n- static utility (인스턴스 불필요).\n- RecoveryManager에서만 호출한다.\n- 외부 매니저가 직접 호출하지 않는다.\n\n\n---\n\n\n## Public API\n\n\n### Encode\n\n```csharp\n\u002F\u002F\u002F \u003Csummary>\n\u002F\u002F\u002F 평문 JSON → .dvn 파일 내용 (v2: version header + obfuscated signed payload)\n\u002F\u002F\u002F json 내부 account.socialUserId를 추출하여 HMAC 키에 사용한다.\n\u002F\u002F\u002F \u003C\u002Fsummary>\ninternal static string Encode(string json)\n```\n\n파이프라인 (v2):\n```\n1. json에서 account.socialUserId 추출\n2. HMAC-SHA256(json, APP_SECRET + socialUserId) → hmac_hex_64\n3. signedPayload = json + \"\\n\" + hmac_hex_64\n4. ComplexUtil.Encrypt_Base64(signedPayload) → obfuscated string\n5. (char)0x02 + obfuscated string → final string\n```\n\n\n### Decode\n\n```csharp\n\u002F\u002F\u002F \u003Csummary>\n\u002F\u002F\u002F .dvn 파일 내용 → 평문 JSON\n\u002F\u002F\u002F v2: HMAC 무결성 검증 포함.\n\u002F\u002F\u002F v1: 하위호환 (HMAC 없이 디코딩).\n\u002F\u002F\u002F 실패 시 CommonResult 에러 반환.\n\u002F\u002F\u002F \u003C\u002Fsummary>\ninternal static CommonResult\u003Cstring> Decode(string dvnContent)\n```\n\n파이프라인 (v2, version = 0x02):\n```\n1. version byte 파싱 (첫 바이트) → 0x02\n2. ComplexUtil.Decrypt_Base64(payload) → signedPayload\n3. signedPayload 분리: json + \"\\n\" + hmac_hex_64\n4. json에서 account.socialUserId 추출\n5. HMAC 재계산 및 검증 → 불일치 시 RECOVERY_HMAC_FAILED\n6. Return json\n```\n\n파이프라인 (v1 하위호환, version = 0x01):\n```\n1. version byte 파싱 → 0x01\n2. ComplexUtil.Decrypt_Base64(payload) → json (HMAC 검증 없음)\n3. Return json\n```\n\n\n---\n\n\n## Version Header\n\n```\noffset  size  description\n──────────────────────────\n0       1     DVN format version (0x01 or 0x02)\n1       N     ComplexUtil obfuscated Base64 payload\n```\n\n- version은 ASCII 문자가 아닌 raw byte다.\n- `0x01`: 레거시 (HMAC 없음). Decode만 허용.\n- `0x02`: 현재 (HMAC 포함). Encode는 항상 0x02.\n- Encode 시 `(char)0x02 + obfuscatedPayload`로 조합한다.\n- Decode 시 `dvnContent[0]`으로 version을 읽고 분기한다.\n\n\n---\n\n\n## Error Types\n\n| 상황 | 에러 |\n|------|------|\n| version 미지원 | `RECOVERY_UNSUPPORTED_VERSION` |\n| ComplexUtil 디코딩 실패 | `RECOVERY_DECODE_FAILED` |\n| HMAC 불일치 (v2) | `RECOVERY_HMAC_FAILED` |\n\n에러 타입의 정확한 이름\u002F위치는 구현 시 `COMMON_ERROR_TYPE` 패턴을 따른다.\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- RecoveryCodec:\n  - UPM (정본): `framework-cs\u002Fupm\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryCodec.cs`\n  - Packages (sync): `framework-cs\u002Fapps\u002FUnityExample\u002FPackages\u002Fcom.devian.foundation\u002FSamples~\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryCodec.cs`\n  - Assets\u002FSamples (import): `framework-cs\u002Fapps\u002FUnityExample\u002FAssets\u002FSamples\u002FDevian Samples\u002F{version}\u002FMobilePackage\u002FRuntime\u002FRecovery\u002FRecoveryCodec.cs`\n\nasmdef:\n- `Devian.Samples.MobilePackage.asmdef`\n\n\n---\n\n\n## Related\n\n- [03-ssot](..\u002F03-ssot\u002FSKILL.md) — DVN 포맷 정본 (§E HMAC Integrity)\n- [10-recovery-manager](..\u002F10-recovery-manager\u002FSKILL.md) — RecoveryManager (호출자)\n- [31-variable-complex](..\u002F..\u002F..\u002F..\u002Fdevian\u002F10-module\u002F20-core\u002F31-variable-complex\u002FSKILL.md) — ComplexUtil 정본\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian-unity\u002F50-mobile-package\u002F25-recovery-system\u002F20-recovery-codec","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 20-recovery-codec",{"tool":37,"command":38},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 20-recovery-codec",{"tool":40,"command":41},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 20-recovery-codec","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian-unity\u002F50-mobile-package\u002F25-recovery-system\u002F20-recovery-codec\u002FSKILL.md",true,[45],{"path":46,"resourceType":47,"resourceTypeDesc":48,"sizeBytes":49,"sourceHtmlUrl":50},"agents\u002Fopenai.yaml","REFERENCE","参考文档",118,"https:\u002F\u002Fgithub.com\u002Fmalinskibeniamin\u002Fskills\u002Fblob\u002Fmain\u002Fcodex-skills\u002Fbetter-interface\u002Fagents\u002Fopenai.yaml",[52,58,66,74,83,90],{"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},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[54],{"skillNo":59,"name":60,"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":61,"categories":62,"keywords":63,"publishedAt":20},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[64,65],"archive","90 project archive",{"skillNo":67,"name":68,"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":69,"categories":70,"keywords":71,"publishedAt":20},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[72,73],"management","30 env management",{"skillNo":75,"name":76,"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":77,"categories":78,"keywords":79,"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",[],[80,81,82],"push","page","19 page push send",{"skillNo":84,"name":85,"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":86,"categories":87,"keywords":88,"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",[],[81,89],"18 page savedata",{"skillNo":91,"name":92,"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":93,"categories":94,"keywords":95,"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",[],[81,96],"17 page deobfuscate"]