[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBTPM53CFXCQ10GK6K8P92":3,"skill-same:01M6CBTPM53CFXCQ10GK6K8P92":47},{"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":22,"linkOnly":23,"markdownContent":24,"markdownBody":24,"frontMatter":25,"refName":26,"commitSha":27,"skillDirectory":28,"forksCount":13,"repositoryHtmlUrl":29,"repositoryHomepageUrl":6,"ownerHtmlUrl":30,"ownerBlogUrl":6,"ownerDescription":31,"updatedAt":32,"install":33,"resources":46},"01M6CBTPM53CFXCQ10GK6K8P92","75-game-network-client",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\u002F10-module\u002F60-net\u002F75-game-network-client\u002FSKILL.md",[],[18,19,20,21],"network client","network","game","75 game network client","2026-11-10 10:12:30",false,"# 75-game-network-client\n\nStatus: ACTIVE  \nAppliesTo: v10  \nSSOT: skills\u002Fdevian\u002F10-module\u002F03-ssot\u002FSKILL.md\n\n## Purpose\n\nWebSocket 클라이언트 테스트 앱의 설계 원칙과 규칙을 정의한다.  \nGameServer와의 왕복 통신을 통해 Proxy\u002FStub + codec + frame 포맷이 정상인지 검증한다.\n\n---\n\n## Import 정본\n\n**Client 런타임 import 정본은 `@devian\u002Fprotocol-game\u002Fclient-runtime` 이다.**\n\n```typescript\nimport { createClientRuntime, Game2C } from '@devian\u002Fprotocol-game\u002Fclient-runtime';\n```\n\n---\n\n## 핵심 구조\n\nTS GameClient의 기본 codec은 Protobuf이다(인자 미주입).  \nJson은 `@devian\u002Fcore`의 `defaultCodec`를 runtime 생성 시 주입해서 선택한다.\n\n```typescript\nimport { defaultCodec as jsonCodec } from '@devian\u002Fcore';\nimport { createClientRuntime } from '@devian\u002Fprotocol-game\u002Fclient-runtime';\n\n\u002F\u002F 기본(Protobuf)\nconst clientA = createClientRuntime();\n\n\u002F\u002F Json 선택\nconst clientB = createClientRuntime(jsonCodec);\n```\n\n### 전체 예시\n\n```typescript\nimport { NetworkClient } from '@devian\u002Fcore';\nimport { createClientRuntime } from '@devian\u002Fprotocol-game\u002Fclient-runtime';\n\n\u002F\u002F 1. ClientRuntime 생성 (codec 미주입 = protobuf 기본)\nconst { runtime, game2CStub, c2GameProxyFactory } = createClientRuntime();\n\n\u002F\u002F 2. NetworkClient 생성\nconst client = new NetworkClient(runtime, { sessionId: 0 });\n\n\u002F\u002F 3. WebSocket 메시지 위임\nws.on('message', (raw) => client.onWsMessage(raw));\n\n\u002F\u002F 4. Inbound 핸들러 등록 (Game2C)\ngame2CStub.onPong((sid, msg) => { ... });\ngame2CStub.onEchoReply((sid, msg) => { ... });\n\n\u002F\u002F 5. Outbound 전송 (C2Game)\nconst c2GameProxy = c2GameProxyFactory(sendFn);\nc2GameProxy.sendPing(0, { ... });\nc2GameProxy.sendEcho(0, { ... });\n```\n\n---\n\n## 고정 규칙\n\n### 프레임 포맷\n\n```\n[int32 LE opcode][payload bytes]\n```\n\n- opcode: 4바이트 little-endian 정수\n- payload: 가변 길이 바이트\n\n### Codec 정합\n\n- **기본:** Protobuf codec (생성된 Stub\u002FProxy의 기본 codec)\n- **선택:** `createClientRuntime(defaultCodec)`로 Json codec 주입 가능\n- codec 미주입 시 Stub\u002FProxy 각자의 기본 Protobuf codec 사용\n\n### Unknown Opcode 처리\n\n- 수신 opcode가 인식되지 않으면:\n  - **절대 disconnect\u002Fclose 하지 않는다**\n  - 처리 우선순위:\n    1. `NetworkClient` 옵션 핸들러 (`onUnknownInboundOpcode`)\n    2. `runtime.setUnknownInboundOpcode(handler)`\n    3. 기본 warn 로그\n\n---\n\n## 금지 사항\n\n- `generated` 코드 임의 수정 금지 (생성기 변경과 동기화 필수)\n- 앱이 아닌 build system 변경은 별도 phase에서만 수행\n- unknown opcode에서 disconnect\u002Fclose 호출 금지\n\n---\n\n## 디렉토리 구조\n\n```\nframework-ts\u002Fapps\u002FGameClient\u002F\n├── package.json      # 앱 정의\n├── tsconfig.json     # TypeScript 설정\n├── README.md         # 실행 방법\n└── src\u002F\n    └── index.ts      # 메인 엔트리 (NetworkClient + ClientRuntime)\n```\n\n### 파일 역할\n\n| 파일 | 역할 |\n|------|------|\n| `src\u002Findex.ts` | WebSocket 연결, NetworkClient로 메시지 처리, Stub\u002FProxy 사용 |\n\n프레임 파싱 및 메시지 디스패치는 `NetworkClient`가 내부적으로 처리한다.\n\n---\n\n## Reference\n\n- **서버 앱:** `framework-ts\u002Fapps\u002FGameServer\u002F`\n- **네트워크 모듈:** `framework-ts\u002Fmodule\u002Fdevian\u002F`\n- **프로토콜:** `framework-ts\u002Fmodule\u002Fdevian-protocol-game\u002F`\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F10-module\u002F60-net\u002F75-game-network-client","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":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add devwinsoft\u002Fdevian --skill 75-game-network-client",{"tool":39,"command":40},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 75-game-network-client",{"tool":42,"command":43},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 75-game-network-client","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F60-net\u002F75-game-network-client\u002FSKILL.md",true,[],[48,54,62,70,79,86],{"skillNo":49,"name":50,"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":51,"categories":52,"keywords":53,"publishedAt":22},"01M6CBX3K2JJV38ANHVGCAT8A0","devian","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002FSKILL.md",[],[50],{"skillNo":55,"name":56,"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":57,"categories":58,"keywords":59,"publishedAt":22},"01M6CBX210BFMM8AMN770J9WY8","90-project-archive","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F90-project-archive\u002FSKILL.md",[],[60,61],"archive","90 project archive",{"skillNo":63,"name":64,"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":65,"categories":66,"keywords":67,"publishedAt":22},"01M6CBWZSGRR9R3YJZB3177667","30-env-management","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F30-env-management\u002FSKILL.md",[],[68,69],"management","30 env management",{"skillNo":71,"name":72,"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":73,"categories":74,"keywords":75,"publishedAt":22},"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",[],[76,77,78],"push","page","19 page push send",{"skillNo":80,"name":81,"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":82,"categories":83,"keywords":84,"publishedAt":22},"01M6CBWWRQ05A7604GHJKTPJTF","18-page-savedata","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F18-page-savedata\u002FSKILL.md",[],[77,85],"18 page savedata",{"skillNo":87,"name":88,"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":89,"categories":90,"keywords":91,"publishedAt":22},"01M6CBWVH4S2VF1V7B2GBTESCT","17-page-deobfuscate","https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F80-tools\u002F20-operation\u002F17-page-deobfuscate\u002FSKILL.md",[],[77,92],"17 page deobfuscate"]