[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CBTT8G12BPM7F3949M0MEY":3,"skill-same:01M6CBTT8G12BPM7F3949M0MEY":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},"01M6CBTT8G12BPM7F3949M0MEY","77-webgl-jslib-memory-rules",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\u002F77-webgl-jslib-memory-rules\u002FSKILL.md",[],[18,19,20,21],"webgl","memory","Rules","77 webgl jslib memory rules","2026-11-10 10:12:30",false,"# 77-webgl-jslib-memory-rules\n\nStatus: ACTIVE\nAppliesTo: v10\nType: Policy \u002F Hard Rules\n\n---\n\n## Purpose\n\nWebGL `.jslib` ↔ C# 간 ptr\u002Flen\u002F문자열 메모리 수명 규칙을 **Hard Rule**로 고정한다.\n\n이 규칙을 위반하면 **메모리 누수 또는 크래시**가 발생한다.\n\n---\n\n## Hard Rules\n\n### 1. `.jslib`가 `_malloc`한 모든 버퍼는 C#이 반드시 Free 호출로 반환해야 함\n\n| 이벤트 | 포인터 | Free 함수 |\n|--------|--------|-----------|\n| MESSAGE | `dataPtr` | `WS_FreeBuffer(dataPtr)` |\n| ERROR\u002FCLOSE | `messagePtr` | `WS_FreeString(messagePtr)` |\n\n**위반 시**: WASM heap 메모리 누수 → 장기 실행 시 OOM 크래시\n\n### 2. C#은 `WS_PollEvent`로 받은 ptr을 즉시 managed(ArrayPool)로 복사하고 ptr을 보존하지 않는다\n\n```csharp\n\u002F\u002F CORRECT\nvar buffer = ArrayPool\u003Cbyte>.Shared.Rent(dataLen);\nMarshal.Copy(dataPtr, buffer, 0, dataLen);\n\u002F\u002F ... 사용 ...\nArrayPool\u003Cbyte>.Shared.Return(buffer);\nWS_FreeBuffer(dataPtr);\n\n\u002F\u002F WRONG - ptr 보존 금지\n_savedPtr = dataPtr; \u002F\u002F 이후 Free 시점 불명확 → 누수\u002FUAF\n```\n\n**위반 시**: Use-After-Free 또는 메모리 누수\n\n### 3. 한 Tick에서 처리 가능한 이벤트 개수 상한이 있어야 한다\n\n```csharp\nconst int MaxEventsPerTick = 64; \u002F\u002F 권장값\n\nfor (int i = 0; i \u003C MaxEventsPerTick; i++)\n{\n    if (WS_PollEvent(...) == 0)\n        break;\n    \u002F\u002F 처리\n}\n```\n\n**위반 시**: 대량 수신 시 프레임 드롭, 메인 스레드 블로킹\n\n### 4. `ToArray()` 금지, `ArrayPool\u003Cbyte>` 사용 강제\n\n```csharp\n\u002F\u002F CORRECT\nvar buffer = ArrayPool\u003Cbyte>.Shared.Rent(dataLen);\nMarshal.Copy(dataPtr, buffer, 0, dataLen);\n\u002F\u002F ... 사용 후 ...\nArrayPool\u003Cbyte>.Shared.Return(buffer);\n\n\u002F\u002F WRONG\nbyte[] buffer = new byte[dataLen]; \u002F\u002F GC 압박\nMarshal.Copy(dataPtr, buffer, 0, dataLen);\n```\n\n**위반 시**: GC 압박으로 프레임 스파이크, 핫 경로 allocation\n\n---\n\n## 권장 구현 패턴\n\n### MESSAGE 처리\n\n```csharp\ncase EventType.MESSAGE:\n    \u002F\u002F 1. ArrayPool에서 버퍼 임대\n    var buffer = ArrayPool\u003Cbyte>.Shared.Rent(dataLen);\n    try\n    {\n        \u002F\u002F 2. Marshal.Copy로 복사\n        Marshal.Copy(dataPtr, buffer, 0, dataLen);\n\n        \u002F\u002F 3. core로 전달\n        _core.OnFrame(_sessionId, buffer.AsSpan(0, dataLen));\n    }\n    finally\n    {\n        \u002F\u002F 4. ArrayPool 반환\n        ArrayPool\u003Cbyte>.Shared.Return(buffer);\n    }\n    \u002F\u002F 5. Free 호출 (반드시)\n    WS_FreeBuffer(dataPtr);\n    break;\n```\n\n### ERROR\u002FCLOSE 처리\n\n```csharp\ncase EventType.CLOSE:\n    string reason = \"\";\n    if (messagePtr != IntPtr.Zero)\n    {\n        reason = Marshal.PtrToStringUTF8(messagePtr);\n        WS_FreeString(messagePtr); \u002F\u002F 반드시\n    }\n    EnqueueDispatch(() => OnClose?.Invoke((ushort)code, reason));\n    break;\n```\n\n---\n\n## FAIL 조건\n\n아래 패턴이 문서\u002F코드에 등장하면 **FAIL**:\n\n1. **Free 누락 가능성이 있는 설계**\n   - 예: `dataPtr`를 필드에 저장하고 나중에 Free하는 구조\n   - 예: 예외 발생 시 Free가 호출되지 않는 코드 경로\n\n2. **`ToArray()` 또는 `new byte[]` 사용**\n   - 핫 경로(수신 루프)에서 allocation\n\n3. **이벤트 처리량 상한 없음**\n   - 무한 루프로 PollEvent 호출\n\n4. **ptr 보존**\n   - `WS_PollEvent`에서 받은 ptr을 복사 없이 보관\n\n---\n\n## Verification Checklist\n\n- [ ] MESSAGE 수신 후 `WS_FreeBuffer(dataPtr)` 호출됨\n- [ ] ERROR\u002FCLOSE 수신 후 messagePtr이 non-null이면 `WS_FreeString(messagePtr)` 호출됨\n- [ ] 예외 발생 시에도 Free가 호출되도록 try-finally 또는 동등한 구조 사용\n- [ ] `ArrayPool\u003Cbyte>.Shared.Rent()`\u002F`.Return()` 사용\n- [ ] `ToArray()` 또는 `new byte[]` 미사용\n- [ ] Tick당 이벤트 처리 상한 존재 (권장: 64)\n\n---\n\n## Reference\n\n- 폴링 계약: [76-webgl-ws-polling-bridge](..\u002F76-webgl-ws-polling-bridge\u002FSKILL.md)\n- WebSocket 클라이언트: [72-network-ws-client](..\u002F72-network-ws-client\u002FSKILL.md)\n",{},"main","8cb5bd877a3a7004867d2f55697cb9e4ff2f1734","skills\u002Fdevian\u002F10-module\u002F60-net\u002F77-webgl-jslib-memory-rules","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 77-webgl-jslib-memory-rules",{"tool":39,"command":40},"bunx","bunx skills add devwinsoft\u002Fdevian --skill 77-webgl-jslib-memory-rules",{"tool":42,"command":43},"pnpm","pnpm dlx skills add devwinsoft\u002Fdevian --skill 77-webgl-jslib-memory-rules","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fdevwinsoft\u002Fdevian\u002Fblob\u002Fmain\u002Fskills\u002Fdevian\u002F10-module\u002F60-net\u002F77-webgl-jslib-memory-rules\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"]