Rebuild the object in a reference image as a code-only, procedural, quality-gated, animation-ready Three.js model. Token-efficient image-to-3D.
Python 3dai-agentsclaude-codecomputer-graphicsgenerativeimage-to-3dprocedural-generationthreejstypescriptwebgl
feat!: pull the CS2 domain from an installed plugin instead of this checkout
kokorolxe92bac5d08a3
diff --git a/SKILL.md b/SKILL.mdindex 2997478..253535c 100644--- a/SKILL.md+++ b/SKILL.md@@ -69,7 +69,9 @@ python3 forge/state.py mark <step-id> --state .img2threejs/state.json --evidence- Every completed step needs evidence; mark a non-applicable step `skipped` only with `--reason` —silent omission is forbidden. Loop counts derive from `reviewHistory` actions(`refine-spec`/`refine-code`), not agent memory. Defaults: 3 corrections per pass, 6 total.-- Profiles add mandatory gates without changing the core order: `cs2` requires classification,+- A domain profile's steps, gates and reference material come from its **installed plugin**, not+ from this checkout; with no plugin installed only `generic` is available and `forge/state.py init`+ names what is. Profiles add mandatory gates without changing the core order: `cs2` requires classification,manifest, and a machine-readable CS2 review before AI review; `character` requires the charactercontracts and landmark evidence. Every profile records suitability, projection applicability, andmaterial-evidence applicability. The state file is a resumability index, not visual evidence:@@ -106,7 +108,7 @@ Full flags: `grimoire/scripts.md`. Never let a script *score* visuals — that idomain-specific query.1b. **CS2 intake manifest** — for a CS2 request, create and validate `cs2-intake.json` beforepre-spec authoring (admission, heuristic signal, classification, family/route resolution).- MUST read `grimoire/intake/cs2_intake_contract.md` completely before creating the manifest or+ MUST read the CS2 plugin's `cs2_intake_contract.md` completely before creating the manifest orrunning pre-spec assessment.1c. **Optional fidelity evidence adapters** — only when they improve an observed weak point; thestdlib core remains authoritative. Thin/complex masks → local SAM2; character face/pose →@@ -124,8 +126,8 @@ Full flags: `grimoire/scripts.md`. Never let a script *score* visuals — that i(`targetMinDetails` 16, floor 9) — the finish/wear/hardware is the item, so CS2 is held to thetop fidelity bar. Author procedural GEOMETRY but route the FINISH through the projection path instep 2c — a procedural finish for a patterned skin (Doppler/Gamma/Marble/Fade) reads visibly- wrong against the reference. Finish routes + rulebook: `grimoire/build/cs2_finishes.md`;- optional exact-texture acquisition: `grimoire/intake/cs2_texture_acquisition.md`.+ wrong against the reference. Finish routes + rulebook: the CS2 plugin's `grimoire/build/cs2_finishes.md`;+ optional exact-texture acquisition: its `grimoire/intake/cs2_texture_acquisition.md`.2b. **Detail inventory** (do not skip for detailed subjects) — scan zones and enumerate everyidentity-defining small detail (gloss, bevel, fasteners, linework, contours, stains):`forge/stage1_intake/build_detail_inventory.py <image> --mode grid-3x3 --out-dir <dir> --out di.json`.@@ -225,10 +227,10 @@ Full flags: `grimoire/scripts.md`. Never let a script *score* visuals — that i10. Record the review (overall + per-layer + per-feature scores + decision):`forge/stage4_review/append_review.py object-sculpt-spec.json --pass-id <pass> --fidelity <0-1> --action <continue|refine-spec|refine-code|request-input|stop> --summary "..." --render-screenshot <shot> --comparison-image cmp.png --ai-vision-score <0-1> --layer-scores-json '{...}' --feature-reviews-json <f.json> --in-place`.For the CS2 family path, produce the versioned report first with- `forge/stage4_review/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json --scene forge/tests/fixtures/knife_review_scene.json --out cs2-review.json`+ the CS2 plugin's `tools/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json --scene forge/tests/fixtures/knife_review_scene.json --out cs2-review.json`and attach it with `--cs2-review-json cs2-review.json --review-scene-json forge/tests/fixtures/knife_review_scene.json`.A failed family, painted-region, projection-coverage, critical-detail, or orbit gate blocks- `continue` even when the global score passes. See `docs/cs2/review-gates.md`.+ `continue` even when the global score passes. See the CS2 plugin's `docs/cs2/review-gates.md`.11. Sync pipeline state after manual review edits, record checklist evidence, then re-run the localstate gate before another correction or pass:`forge/stage3_build/orchestrate_passes.py sync object-sculpt-spec.json --in-place`@@ -359,7 +361,7 @@ with `unsupported-family` or `unsupported-subtype`; they must not receive anothetree as a generic fallback.The full layer contract (what each layer owns, must emit, and must never decide alone), the CS2-intake order, and the surface/review rule live in `grimoire/intake/cs2_intake_contract.md` — step+intake order, and the surface/review rule live in the CS2 plugin's `cs2_intake_contract.md` — step1b already requires reading it completely before intake state can advance. The canonical hand-offis `cs2-intake.json` (`schemaVersion: 1`, states `proceed | request-input | fallback | rejected |unsupported-family | unsupported-subtype`); write it atomically, preserve unknown provider fieldsdiff --git a/_img2_local.py b/_img2_local.pynew file mode 100644index 0000000..643620f--- /dev/null+++ b/_img2_local.py@@ -0,0 +1 @@+CORE = "/var/folders/1g/p8cr1jz96xd483mz315j6d580000gn/T/tmp.DWITAft9Zt/fh/.img2/harness"diff --git a/docs/cs2-anatomy/gloves.md b/docs/cs2-anatomy/gloves.mddeleted file mode 100644index b7196f1..0000000--- a/docs/cs2-anatomy/gloves.md+++ /dev/null@@ -1,132 +0,0 @@-# CS2 Item Anatomy Vocabulary — Gloves (Găng tay)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của găng tay** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 4).-> Lưu ý bối cảnh CS2: găng tay **chỉ tồn tại dạng skin** (không có "súng" gốc như dao/súng) — chúng phủ lên bàn tay/cẳng tay người chơi ở góc nhìn thứ nhất. Vùng nhìn thấy nhiều nhất là **mu bàn tay, khớp ngón, ngón tay và cổ găng**; lòng bàn tay gần như không thấy.->-> Nguồn: research NotebookLM (fast mode, 9 nguồn ready) — cs2floatchecker.com (CS2 Gloves Guide: types + float caps), steamanalyst.com (danh mục glove), csboard.com (Moto Gloves), steamcommunity.com (Cobalt Skulls), 2× reddit r/GlobalOffensive (real-life glove refs); alpinestars/adbmag.com.au, bigbiketours.com, walkervn.com (giải phẫu găng mô tô/bảo hộ). Chỗ thiếu đánh dấu [kiến thức chung].-> Notebook: `CS2 Item Anatomy Vocabulary — Gloves (VN+EN)` (`d353b31a`).-> _Lưu ý: 1 nguồn (studocu.vn) fail khi index; phần anatomy được nguồn găng mô tô + CS2 guide cover đủ._-------## 1. Giải phẫu găng tay tổng quát — General glove anatomy--Áp dụng cho các kiểu găng "có ngón" (Sport, Driver, Moto, Specialist, Bloodhound, Hydra, Broken Fang). Hand Wraps (băng quấn hở ngón) — xem mục 2.--### A. CỔ GĂNG & CỔ TAY (Cuff & Wrist)--| English | VN | Định nghĩa |-|---|---|---|-| **Cuff** / wristband, gauntlet edge | Cổ găng tay | Phần mở của găng từ cổ tay trùm xuống cổ tay/cẳng tay dưới. |-| **Wrist strap** / closure, wrist fastener | Đai khóa cổ tay | Dây siết quanh cổ tay để găng ôm khít, không tuột. |-| **Hook-and-loop strap** / Velcro strap, touch fastener | Khóa dán Velcro | Khóa dán vi-móc + vòng, chỉnh độ ôm chính xác — điểm nhận diện rõ ở cổ găng. |-| **Gauntlet** / long cuff, forearm shroud | Găng cổ dài | Kiểu găng kéo dài quá cổ tay, che cả cẳng tay dưới. |--### B. MU BÀN TAY & KHỚP NGÓN (Back of hand & Knuckles)--| English | VN | Định nghĩa |-|---|---|---|-| **Back of hand** / dorsal side, top hand | Mu bàn tay | Mặt trên đối diện lòng bàn tay — **vùng nhìn thấy chính** trong CS2, thường mang họa tiết/logo skin. |-| **Knuckles** / knuckle ridge, finger joints | Khớp ngón tay | Các khớp nối ngón vào bàn tay, gờ nhô chịu va đập nhiều nhất. |-| **Knuckle padding** / foam backing, impact cushion | Đệm lót khớp | Lớp đệm mềm (foam) sau lớp cứng để hấp thụ & phân tán lực. |-| **Knuckle guard** / hard-shell armor, knuckle plate | Gù bảo vệ khớp | Tấm cứng (TPU/carbon/da cứng) chụp lên khớp — dấu hiệu chính của Moto/Bloodhound. |--### C. NGÓN TAY & LÒNG BÀN TAY (Fingers & Palm)--| English | VN | Định nghĩa |-|---|---|---|-| **Fingers** / digits, finger stalls | Ngón tay | Các ống găng bọc từng ngón. |-| **Fingertips** / finger ends, tactile tips | Đầu ngón tay | Chóp ngón găng, hay được gia cố hoặc cắt hở. |-| **Finger gussets** / fourchettes, sidewalls | Vách giữa ngón tay | Dải vải/lưới nối hai bên ngón, tăng cử động & thoáng khí. |-| **Thumb** / first digit, pollex | Ngón cái | Ngón cái, thường gia cố vì tì vào súng liên tục. |-| **Palm** / thenar surface, grip | Lòng bàn tay | Mặt trong để cầm nắm (da dê/kangaroo) — gần như không thấy ở góc FPS. |-| **Palm patch** / palm reinforcement, palm slider | Miếng gia cố lòng bàn tay | Lớp/tấm phụ ở gót lòng bàn tay, chống trượt & mài mòn. |--### D. KẾT CẤU (Construction)--| English | VN | Định nghĩa |-|---|---|---|-| **Seams** / joins, stitch lines | Đường nối / đường may ráp | Đường ghép giữa các mảng vật liệu (ngoài để êm, trong để đẹp). |-| **Stitching** / topstitching, thread lines | Đường chỉ may | Các mũi chỉ giữ mảng vật liệu & phần gia cố. |-| **Perforations** / ventilation holes, air holes | Lỗ thông khí / lỗ đục | Lỗ đục nhỏ cho thoát nhiệt & lưu thông khí — đặc trưng bề mặt da Sport. |-| **Pull tab** / pull loop, donning loop | Tab kéo / vòng kéo | Tab/vòng nhỏ ở cổ găng giúp kéo găng vào tay. [kiến thức chung] |-| **Lining** / inner liner, interior fabric | Lớp lót trong | Vật liệu mềm mặt trong, êm da & hút ẩm. |-------## 2. Băng quấn tay — Hand Wraps (kiểu đặc biệt)--Không phải "găng có ngón": là **dải vải quấn** quanh bàn tay & cổ tay, **hở ngón**.--| English | VN | Định nghĩa |-|---|---|---|-| **Wrapped cloth strips** / bandage wrap, handwraps | Băng vải quấn tay | Dải vải dài quấn quanh bàn tay & cổ tay để đỡ & ổn định. |-| **Exposed fingers** / fingerless, open fingertips | Ngón tay hở | Thiết kế cắt ngắn để lộ đầu ngón thật của người chơi. |-| **Crossing wrap over knuckles** / X-pattern wrap | Quấn vải chéo khớp tay | Kỹ thuật quấn chéo hình chữ X đè lên gờ khớp để tập trung lực đỡ. |-| **Thumb loop** / starter loop | Vòng móc ngón cái | Vòng ở đầu dải băng móc vào ngón cái để cố định điểm bắt đầu quấn. |--_(Cổ tay, mu bàn tay, khớp ngón — dùng tên ở mục 1.)_-------## 3. Nhận diện 8 loại găng tay CS2--Mỗi dòng: **tên** — [VN] — hình khối/vật liệu nhận biết ở góc nhìn thứ nhất (mu bàn tay, ngón, cổ găng).--- **Bloodhound Gloves** — Găng Bloodhound — da tactical với **gù/tấm cứng bọc khớp ngón** (hardened knuckle) + đinh tán tròn dọc gờ khớp + logo chiến dịch trên mu bàn tay.-- **Sport Gloves** — Găng thể thao — **da đục lỗ (perforated) kiểu găng lái xe thể thao**, mảng trơn tương phản trên mu bàn tay, dáng gọn ôm — profile rất dễ thấy ở FPS.-- **Driver Gloves** — Găng lái xe — **da trơn nguyên bản (smooth leather)**, silhouette tối giản mượt, thường có **lỗ tròn khoét ở khớp**, vân da rắn/dệt.-- **Hand Wraps** — Băng quấn tay — **dải vải/bạt quấn quanh tay & cổ tay, hở hoàn toàn các ngón** (kiểu võ sĩ).-- **Moto Gloves** — Găng mô tô — **gù cứng bảo vệ khớp (hardshell knuckle guard)** nổi bật + cổ găng cuộn + họa tiết tam giác trên tấm bảo vệ.-- **Specialist Gloves** — Găng tactical cổ dài — lai **lòng bàn tay da + mu bàn tay vải (textile)** + gân cao su gia cố khớp + **cổ găng kéo dài (cuffed)**.-- **Hydra Gloves** — Găng Hydra — kiểu hở ngón, nhận ra qua **4 đinh tán kim loại nhỏ ở khớp** + huy hiệu/medallion tròn giữa mu bàn tay.-- **Broken Fang Gloves** — Găng Broken Fang — da tactical hở ngón, **đinh tán kim loại ở khớp** + emblem "broken fang" trên mu bàn tay.-------## 4. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận găng tay--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phần được phủ skin & Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Painted area** / skinned surface, texture zone | Vùng phủ skin | Các mảng nhận họa tiết/màu — **mu bàn tay, ngón, cổ găng**. |-| **Bare area** / unskinned, default material | Vùng vật liệu gốc | Phần giữ vật liệu nền (da đen/vải xám) không phủ pattern — lớp lót trong, một số mảng lòng bàn tay. |-| **Pattern seed** / pattern index, paint seed | Chỉ số hoa văn | Số 0–999 dịch vị trí & căn chỉnh texture trên model — quyết định chỗ đặt họa tiết trên **mu bàn tay & khớp**. |-| **Centered pattern** / god-tier centering | Hoa văn căn giữa | Trường hợp hiếm: chi tiết chính căn hoàn hảo ở phần dễ thấy nhất — **mu bàn tay (dorsal)**. |--### Kiểu finish / vật liệu-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Leather** / hide, goatskin, kangaroo | Da | Finish da bền, trơn hoặc có vân — lòng bàn tay, ngón cái, ống ngón. |-| **Fabric** / textile, mesh | Vải / lưới | Vật liệu thoáng, hay dùng cho Specialist/Moto — rõ nhất trên **mu bàn tay & vách giữa ngón**. |-| **Cloth wrap** / tarp, bandage | Băng vải quấn | Finish vải nhiều lớp riêng của Hand Wraps — phủ cả tay & cổ tay trừ ngón hở. |-| **Printed pattern** / geometric, pinstripe | Hoa văn in | Lớp phủ trang trí (tam giác, sọc mảnh) trên nền — trên **tấm khớp & mu bàn tay**. |-| **Camo** / digital camo, polycam | Hoa văn rằn ri | Camo kiểu quân sự — rõ trên nền vải & vùng gia cố của Specialist. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float value** / wear rating, condition index | Chỉ số Float | Mức mòn thị giác của găng, dải ~0.06–0.80. |-| **Glove float cap** / wear limit | Giới hạn Float găng | Chặn cứng riêng cho găng (min ~0.06, max ~0.80) — găng **không bao giờ đạt 0.00** hoàn hảo. |-| **Factory New (FN)** | Mới xuất xưởng | ~0.06–0.07, màu no & không hư hại — sắc nét ở điểm cao & cạnh. |-| **Minimal Wear (MW)** | Ít trầy xước | ~0.07–0.15, xước nhỏ bắt đầu ở **cạnh cổ găng & gù khớp**. |-| **Field-Tested (FT)** | Đã qua sử dụng | ~0.15–0.38, mòn/phai rõ ở **cạnh lòng bàn tay, khớp & đầu ngón**. |-| **Well-Worn (WW)** | Mòn nhiều | ~0.38–0.45, pattern phai mạnh — mảng mất màu lớn trên **mu bàn tay & lòng bàn tay**. |-| **Battle-Scarred (BS)** | Trầy xước nặng | ~0.45–0.80, texture "bùn", pattern gần như mất — nặng nhất ở **đường may & phần gù/armor nhô**. |-| **Abrasion** / scuffs, scratches | Vết trầy xước | Hư hại texture do float cao — rõ nhất ở **gù khớp, palm slider, đầu ngón**. |-| **Browning** / fraying to base fabric | Hiện tượng lộ vải nền | Lớp màu trên sờn đi lộ vải nền nâu/tối — thường ở **khớp của Hand Wraps**. |-| **Fading** / washing out | Bạc màu / phai màu | Mất độ đậm màu khi float tăng — phủ toàn bộ, làm pattern trông "bụi"/xỉn. |-| **Wear high points** | Điểm dễ mòn | Chịu mòn trước: **gù/khớp ngón, đầu ngón, cạnh lòng bàn tay, cạnh cổ găng, đường may**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–3: vd "Moto/Bloodhound thiếu gù cứng ở khớp", "Hand Wraps đang bọc kín ngón thay vì hở ngón", "Specialist thiếu cổ găng kéo dài", "Sport thiếu lỗ đục (perforation) trên da".-- **Sai texture/màu** → mục 4: vd "pattern seed lệch làm họa tiết trên mu bàn tay sai vị trí (không centered)", "wear đặt ở lòng bàn tay thay vì gù khớp / đầu ngón / high points", "float dưới 0.06 là sai vì găng có float cap".-- **Vùng nhìn thấy ở CS2**: mu bàn tay + khớp + ngón + cổ găng là nơi lỗi dễ lộ nhất; lòng bàn tay hầu như khuất — ưu tiên fidelity mặt lưng (dorsal).--_Đã xong: [dao](knives.md), [pistol](pistols.md), gloves. Các loại còn lại (SMG / rifle / sniper) — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/heavy.md b/docs/cs2-anatomy/heavy.mddeleted file mode 100644index 0a9845c..0000000--- a/docs/cs2-anatomy/heavy.md+++ /dev/null@@ -1,172 +0,0 @@-# CS2 Item Anatomy Vocabulary — Heavy: Shotguns & MGs (Súng hạng nặng)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của shotgun & súng máy** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 4).->-> Nguồn: research NotebookLM (fast mode, 8/10 nguồn ready) — englishan.com (Parts of a Shotgun + diagram), portal.ct.gov (Parts & Features of Firearms), dokumen.pub *Streetsweepers* (combat shotgun), steamcommunity (CS:GO guns in real life), breakingdefense.com (IWI/Negev), vi.wikipedia (Săn — thuật ngữ VN), white.market (pattern seed), skinvault.gg (wear levels) + kiến thức chuẩn về súng cho phần bị thiếu.-> Notebook: `CS2 Item Anatomy Vocabulary — Heavy: Shotguns & MGs (VN+EN)` (`8430ab72`).-> _Lưu ý: 2 nguồn (cs.money finish catalog, scribd M249 assembly guide) fail khi index; phần anatomy được englishan + CT.gov + Streetsweepers + steamcommunity cover đủ, chỗ thiếu đánh dấu [kiến thức chung]._-------## 1. Giải phẫu shotgun — Combat shotgun anatomy--Áp dụng cho shotgun bơm (pump-action: Nova, Sawed-Off, MAG-7) và bán tự động (semi-auto: XM1014).--### A. THÂN & NÒNG (Receiver & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Receiver** / body | Hộp khóa nòng | Khung vỏ kim loại trung tâm kết nối các bộ phận chính và chứa cụm phát hỏa. |-| **Barrel** / tube | Nòng súng | Ống kim loại dài dẫn viên đạn/chùm đạn khi khai hỏa. |-| **Muzzle** / front end | Miệng nòng | Đầu hở phía trước nòng, nơi chùm đạn thoát ra. |-| **Choke** / choke tube | Ống bóp nòng | Bộ phận ở đầu nòng kiểm soát độ chụm & hình dạng tán xạ của chùm đạn. |-| **Ventilated rib** / rib | Gờ thông gió | Dải kim loại nhô cao chạy dọc lưng nòng, thoát nhiệt & làm mặt phẳng ngắm. |-| **Bolt** / breech bolt | Khóa nòng | Bộ phận di động nạp đạn vào buồng, khóa kín và hất vỏ đạn sau khi bắn. |-| **Bolt carrier** / carrier assembly | Bệ khóa nòng | Bộ phận giữ & dẫn hướng khóa nòng di chuyển để thực hiện chu trình nạp đạn. |-| **Ejection port** / ejector port | Cửa hất vỏ đạn | Khe hở trên hộp khóa nòng, nơi vỏ đạn đã bắn văng ra. |--### B. TIẾP ĐẠN & NẠP ĐẠN (Magazine & Loading)--| English | VN | Định nghĩa |-|---|---|---|-| **Tubular magazine** / under-barrel tube, tube magazine | Ống chứa đạn (dưới nòng) | Ống dự trữ đạn nằm dưới nòng, chứa các viên xếp nối tiếp nhau. |-| **Box magazine** / detachable magazine | Hộp tiếp đạn | Hộp đạn tháo rời (MAG-7 dùng loại này thay ống dưới nòng). |-| **Loading port** / loading gate, loading tray | Cửa nạp đạn | Khe dưới gầm súng nơi người bắn đẩy viên đạn mới vào ống chứa. |-| **Forend** / fore-end, pump, slide handle, forearm | Ốp lót tay trượt / tay bơm | Tay cầm trước trượt tới-lui để nạp đạn trên shotgun bơm. |-| **Action bars** / operating rods | Thanh truyền động | Thanh kim loại nối ốp lót tay với khóa nòng, biến lực kéo thành chu trình nạp. |-| **Follower** / magazine follower | Con đẩy đạn | Bệ có lò xo trong ống/hộp đạn, đẩy đạn về phía buồng nòng. |--### C. BÁNG & TAY CẦM (Stock & Grip)--| English | VN | Định nghĩa |-|---|---|---|-| **Buttstock** / shoulder stock, stock | Báng súng | Phần đuôi tì vào vai để ổn định & giảm giật. |-| **Pistol grip** / handgrip | Tay nắm chính | Tay cầm kiểu súng ngắn nằm ngay sau cò. |-| **Trigger** / firing lever | Cò súng | Lẫy bóp để kích hoạt cơ chế điểm hỏa. |-| **Trigger guard** / safety loop | Vành bảo vệ cò | Vòng bao quanh cò, chống cướp cò ngoài ý muốn. |-| **Safety** / manual safety | Khóa an toàn | Cơ cấu cơ khí ngăn súng khai hỏa ngoài ý muốn. |-| **Recoil pad** / butt pad | Đế báng giảm giật | Đệm cao su cuối báng, hấp thụ lực giật lên vai. |--### D. NGẮM (Sights)--| English | VN | Định nghĩa |-|---|---|---|-| **Front bead** / bead sight, front bead sight | Đầu ngắm hạt | Điểm ngắm nhỏ hình hạt ở đầu nòng, lấy mục tiêu nhanh. |-| **Rear sight** / aperture, notch, ghost ring | Thước ngắm | Bộ ngắm sau; XM1014 dùng vòng "ghost ring". |-| **Ventilated rib as sighting plane** | Mặt phẳng ngắm | Bề mặt phẳng trên gờ thông gió dẫn hướng mắt (Nova). |-------## 2. Giải phẫu súng máy hạng nhẹ — Light Machine Gun (LMG / SAW)--Áp dụng cho súng máy bắn băng đạn mắt xích (belt-fed): M249, Negev.--### A. THÂN & NÒNG (Receiver & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Receiver** | Hộp khóa nòng | Khung vỏ kim loại trung tâm nối nòng, báng và chứa cụm phát hỏa. |-| **Barrel** | Nòng súng | Ống kim loại dài dẫn đầu đạn; tháo nhanh (quick-change) để thay khi quá nhiệt. |-| **Barrel shroud** / barrel jacket, handguard | Ốp bao nòng / ốp lót tay | Bộ phận bao quanh nòng, bảo vệ tay khỏi nhiệt khi bắn liên tục. |-| **Flash hider** / muzzle device | Loa che lửa | Thiết bị đầu nòng giảm ánh chớp, tránh lộ vị trí xạ thủ. [kiến thức chung] |-| **Gas system** / gas tube, gas piston | Hệ thống trích khí | Tận dụng khí thuốc đẩy bệ khóa nòng lùi để thực hiện chu kỳ nạp đạn. [kiến thức chung] |-| **Charging handle** / cocking handle | Tay kéo khóa nòng | Bộ phận kéo khóa nòng về sau để lên đạn hoặc xử lý kẹt đạn. |--### B. TIẾP ĐẠN (Feeding)--| English | VN | Định nghĩa |-|---|---|---|-| **Belt** / linked ammunition | Dây băng đạn | Dải đạn nối bằng mắt xích kim loại, nạp liên tục vào súng. |-| **Feed tray** | Khay nạp đạn | Bề mặt kim loại đặt dây băng đạn để cơ cấu tiếp đạn bắt lấy. |-| **Feed cover** / top cover | Nắp trên hộp khóa nòng | Nắp đậy trên khay nạp, giữ dây băng đạn cố định & bảo vệ cơ cấu. |-| **Belt box** / ammo box, ammunition pouch, assault pack | Hộp băng đạn / túi đạn | Thùng/túi gắn vào súng chứa dây băng đạn gọn gàng khi di chuyển. |-| **Drum** | Hộp tiếp đạn hình trống | Hộp tròn sức chứa lớn, một số súng máy dùng. [kiến thức chung] |-| **Feed mechanism** | Cơ cấu nạp đạn | Hệ bộ phận chuyển động kéo dây băng đạn vào buồng nòng theo chu kỳ bắn. |--### C. HỖ TRỢ & BÁNG (Support & Stock)--| English | VN | Định nghĩa |-|---|---|---|-| **Bipod** | Giá hai chân | Bộ chân đỡ gập gọn gắn phía trước, tăng ổn định khi bắn nằm. |-| **Carrying handle** | Tay xách | Quai cầm để vận chuyển súng / cầm nắm khi thay nòng nóng. |-| **Buttstock** | Báng súng | Phần đuôi tì vào vai tạo điểm tựa & giảm giật. |-| **Pistol grip** | Tay nắm chính | Tay cầm kiểu súng ngắn để điều khiển súng. |-| **Trigger** | Cò súng | Lẫy bóp kích hoạt cơ chế điểm hỏa. |-| **Trigger guard** | Vành bảo vệ cò | Vòng kim loại bao quanh cò, chống cướp cò ngoài ý muốn. |--### D. NGẮM & RAY (Sights & Rails)--| English | VN | Định nghĩa |-|---|---|---|-| **Front sight** | Đầu ngắm | Điểm ngắm ở đầu nòng để căn đường ngắm vào mục tiêu. |-| **Rear sight** | Thước ngắm | Bộ ngắm sau hộp khóa nòng, thường chỉnh được tầm & hướng gió. |-| **Picatinny rail** / rail | Ray Picatinny | Rãnh răng cưa tiêu chuẩn để gắn kính ngắm, đèn, phụ kiện. |-------## 3. Nhận diện 6 khẩu heavy CS2--Mỗi dòng: **tên** — [VN] — súng thật + đặc điểm nhận biết.--### Shotguns-- **Nova** — [Shotgun bơm] — dựa trên **Benelli Nova**; thân (receiver) & báng đúc liền khối polymer gia cố thép, **nòng dài**, nạp đạn qua **ống chứa dưới nòng**, đầu ngắm hạt trên gờ thông gió.-- **XM1014** — [Shotgun bán tự động] — dựa trên **Benelli M4 Super 90**; nòng dài, **hệ thống trích khí (ARGO)** bắn liên tục, báng thu gọn được, **ngắm vòng "ghost ring"**.-- **Sawed-Off** — [Shotgun cưa nòng] — dựa trên **Remington Model 870** (biến thể nòng ngắn); **nòng & báng cắt cụt tối đa**, hình bóng cực ngắn, thô sơ, dáng "double-barrel".-- **MAG-7** — [Shotgun bullpup] — dựa trên **Techno Arms MAG-7M1**; thiết kế **bullpup**, **hộp tiếp đạn hộp (box magazine) nằm trong tay cầm chính** (trước cò), tổng thể cực ngắn.--### Machine guns-- **M249** — [Súng máy chi viện / SAW] — dựa trên **FN Herstal M249 SAW**; **nòng thay nhanh**, **giá hai chân (bipod) gập trước**, dùng **dây băng đạn mắt xích** (hoặc hộp STANAG), hộp/túi đạn gắn dưới thân.-- **Negev** — [Súng máy hạng nhẹ] — dựa trên **IMI/IWI Negev LMG**; ngoại hình gần M249 nhưng **gọn hơn**, **tay xách lớn**, dùng **hộp băng đạn vải/nhựa gắn dưới thân**.-------## 4. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận heavy--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla / stock** | Mặc định / nguyên bản | Súng không skin — đen mờ hoặc xám thép/polymer — toàn bộ súng. |-| **Painted parts** | Bộ phận được sơn | Bề mặt lớn nhận họa tiết — **thân (receiver), báng, ốp lót tay/ốp bao nòng**. |-| **Bare metal parts** | Kim loại trần | Chi tiết chức năng giữ màu gốc — **khóa nòng, mắt xích băng đạn, nòng, cần điều khiển, cò**. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Pattern seed** / pattern index | Chỉ số hoa văn / seed | Số (~1–999) định vị bản đồ vân — mỗi seed cho một diện mạo cố định — thân & ốp lót tay. |--### Kiểu finish-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** / custom paint job | Sơn màu đơn sắc | Lớp màu đồng nhất phủ kín — thường trên **receiver**. |-| **Hydrographic** / water transfer | In chuyển nước / thủy ấn | Phim họa tiết nhúng nước quấn quanh bề mặt cong; **lộ wear rất nhanh** khi float tăng — thân & ốp lót tay. |-| **Anodized** / chemical finish | Sơn mạ anode | Lớp phủ kim loại (dùng cho phần nhôm, vd XM1014), chống ăn mòn & giảm bóng. |-| **Patina** / chemical reaction | Lên màu hóa học | Đổi màu kim loại qua phản ứng hóa học, **không lộ rõ vết xước vật lý** — bề mặt thép. |-| **Gunsmith** / mixed finish | Chế tác thủ công | Lai sơn tùy chỉnh + patina; độ mòn rất khó nhận ra bằng mắt — thân kim loại + phần polymer. |-| **Spray-Paint** / stenciled | Sơn xịt | Hiệu ứng khuôn tô thô, thường camo (vd Safari Mesh) — thân & ốp lót tay. |-| **Fade** / gradient | Chuyển màu / fade | Dải màu (vàng/hồng/xanh) chuyển dần — phủ trên **nòng hoặc receiver**. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float Value** | Chỉ số mài mòn | 0.00–1.00, mức hư hại thị giác trên toàn súng. |-| **Factory New (FN)** | Mới xuất xưởng | 0.00–0.07, sạch nhất, gần như không xước. |-| **Minimal Wear (MW)** | Ít trầy xước | 0.07–0.15, vết mòn rất nhỏ, khó nhận ra. |-| **Field-Tested (FT)** | Đã qua sử dụng | 0.15–0.38, tình trạng phổ biến nhất, xước & xỉn rõ. |-| **Well-Worn (WW)** | Mòn nhiều | 0.38–0.45, xước & bong sơn hiện rõ, vẻ cũ kỹ. |-| **Battle-Scarred (BS)** | Trầy xước nặng | 0.45–1.00, độ mòn tối đa, sơn bong gần hết. |-| **Shotgun wear high points** | Điểm dễ mòn (shotgun) | **miệng nòng, cạnh hộp khóa nòng, ốp lót tay trượt, ống chứa đạn dưới nòng, báng**. |-| **LMG wear high points** | Điểm dễ mòn (súng máy) | **nắp hộp khóa nòng (feed cover), tay xách, chân chống (bipod), gờ receiver, nòng & ốp bao nòng**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–3: vd "Nova thiếu ống chứa đạn dưới nòng", "MAG-7 chưa ra dáng bullpup / hộp đạn sai vị trí (phải nằm trước cò)", "Sawed-Off nòng chưa đủ cụt", "M249 thiếu bipod / feed cover", "Negev thiếu tay xách lớn", "XM1014 thiếu ghost ring".-- **Sai texture/màu** → mục 4: vd "pattern seed lệch làm vân trên receiver sai vị trí", "wear đặt ở giữa thân thay vì cạnh receiver / feed cover / miệng nòng / high points", "Fade chạy sai chiều trên nòng".-- **Bare metal accents**: khóa nòng, mắt xích băng đạn, nòng, cần điều khiển, cò thường KHÔNG sơn — nếu model sơn cả lên đó là sai.-- **Phân biệt tiếp đạn** (dấu hiệu nhận diện mạnh nhất): Nova/XM1014 = **ống dưới nòng**; MAG-7 = **hộp đạn trong tay cầm**; M249/Negev = **dây băng đạn + hộp/túi đạn treo dưới thân**.--_Đã xong: [dao](knives.md), [pistol](pistols.md), heavy (shotgun + súng máy). Loại tiếp theo: SMG / rifle / sniper / gloves — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/knives.md b/docs/cs2-anatomy/knives.mddeleted file mode 100644index 3c3bb53..0000000--- a/docs/cs2-anatomy/knives.md+++ /dev/null@@ -1,216 +0,0 @@-# CS2 Item Anatomy Vocabulary — Knives (Dao)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của dao** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 5).->-> Nguồn: research NotebookLM (fast mode, 9 nguồn) — jayfisher.com, nobliecustomknives.com, sulang.org (anatomy); Balisong Wikipedia; shengtools.com (Bowie); shadowpay / steamanalyst / csboard / hellcase (CS2 skin & finish).-> Notebook: `CS2 Item Anatomy Vocabulary — Knives (VN+EN)` (`3302413b`).-------## 1. Giải phẫu dao tổng quát — General knife anatomy--### A. Bộ phận LƯỠI (Blade)--| English | VN | Định nghĩa |-|---|---|---|-| **Point** / tip | Mũi dao | Điểm cực trước, nơi sống và lưỡi gặp nhau. |-| **Edge** / cutting edge, primary edge | Lưỡi cắt / cạnh sắc | Đường sắc dùng để cắt, chạy từ gót đến mũi. |-| **Belly** | Bụng dao | Phần cong lồi của lưỡi cắt, dùng để cắt lát / lột. |-| **Spine** / back | Sống dao | Lưng lưỡi không mài, đối diện lưỡi cắt; tạo độ cứng. |-| **False edge** / swage, swedge | Lưỡi giả | Mặt vát trên sống gần mũi, tăng khả năng đâm xuyên. |-| **Fuller** / cannelure, "blood groove" | Rãnh máu / rãnh trợ lực | Rãnh xẻ dọc thân lưỡi để giảm trọng lượng, chống cong ngang. |-| **Ricasso** | Đốc lưỡi / ricasso | Đoạn phẳng không mài giữa lưỡi cắt và cán/chắn tay. |-| **Choil** | Hốc dao / khuyết ngón tay | Khấc nhỏ gần gót — điểm bắt đầu mài hoặc đặt ngón tay. |-| **Heel** | Gót lưỡi | Phần cuối của lưỡi cắt, gần cán nhất. |-| **Grind** | Kiểu mài | Hình cắt ngang của lưỡi (cách vát mỏng thép). |-| **Bevel** | Mặt vát | Bề mặt nghiêng dẫn xuống lưỡi cắt (primary = tạo hình, secondary = tạo cạnh sắc). |-| **Flat grind** / primary grind | Mài phẳng | Lưỡi vát thẳng từ sống xuống cạnh. |-| **Serrations** / rip teeth | Răng cưa | Các khấc kiểu cưa trên lưỡi, thường gần cán, để cắt vật liệu dai. |-| **Serration teeth / scallops** | Răng cưa đơn / rãnh răng cưa | Từng chiếc răng nhọn và rãnh lõm tạo nên đoạn răng cưa. |-| **Jimping** | Răng cưa bám tay | Khấc nhỏ trên sống/cán để tăng độ bám cho ngón cái. |-| **Plunge line** / grind termination | Đường plunge | Đường chuyển tiếp nơi kiểu mài bắt đầu/kết thúc gần ricasso. |-| **Tang junction** | Điểm nối chuôi | Nơi thép lưỡi gặp phần cán. |--### B. Bộ phận CÁN (Handle)--| English | VN | Định nghĩa |-|---|---|---|-| **Handle** / grip, haft, hilt | Cán dao | Toàn bộ phần cầm để điều khiển lưỡi. |-| **Scales** / slabs | Ốp cán | Hai tấm vật liệu ốp hai bên chuôi tạo phần nắm. |-| **Bolster** | Đệm cán / khâu dao | Miếng (thường kim loại) gia cố chỗ nối cán–lưỡi hoặc đuôi cán. |-| **Guard** / crossguard, quillon | Miếng chắn / vệ tay | Phần nhô giữa lưỡi và cán, chặn tay trượt lên lưỡi. |-| **Full tang** | Chuôi xuyên / full tang | Thép lưỡi chạy hết chiều dài & rộng của cán, nhìn thấy ở rìa. |-| **Hidden tang** / rat-tail tang | Chuôi ẩn / chuôi chuột | Chuôi hẹp luồn trong cán, bị vật liệu cán bọc kín. |-| **Butt** | Đuôi cán | Đầu cuối của cán, xa lưỡi nhất. |-| **Pommel** | Núm chuôi | Nắp/núm kim loại ở đuôi cán, khóa cụm chuôi ẩn. |-| **Lanyard hole** / thong hole | Lỗ xỏ dây | Lỗ ở đuôi để luồn dây đeo/giữ. |-| **Finger grooves** | Rãnh ngón tay | Chỗ lõm trên cán để cầm chắc & tiện tay. |-| **Backspacer** / standoffs | Thanh đệm lưng | Bộ phận ngăn cách & đỡ ốp/liner dọc sống dao gập. |-| **Liner** | Tấm lót cán | Tấm kim loại bên trong dao gập, đỡ ốp, trục và khóa. |--### Bộ phận DAO GẬP (Folding-knife)--| English | VN | Định nghĩa |-|---|---|---|-| **Pivot** | Trục xoay | Trục/bu-lông để lưỡi dao gập xoay quanh khi mở/đóng. |-| **Thumb stud** / thumb bob | Chốt ngón cái | Chốt nhỏ trên sống lưỡi để mở một tay. |-| **Flipper tab** | Lẫy bật / flipper | Phần nhô ở chuôi lưỡi để búng mở bằng một ngón. |-| **Lock** / lockbar, liner lock | Khóa lưỡi | Cơ cấu giữ lưỡi ở vị trí mở để dùng an toàn. |-| **Backspring** | Lò xo lưng | Lò xo dọc lưng dao slipjoint giữ lưỡi đúng vị trí. |-| **Detent** / detent ball | Chốt bi / bi định vị | Bi + lỗ giữ lưỡi đóng cho tới khi cố ý mở. |-| **Stop pin** | Chốt dừng | Chốt cứng giới hạn hành trình lưỡi khi mở/đóng hết. |-------## 2. Dao bướm / Balisong — Butterfly Knife--Dao gập kiểu Filipino, **hai cán** xoay 180° quanh chuôi để giấu/lộ lưỡi.--| English | VN | Định nghĩa |-|---|---|---|-| **Safe handle** | Cán an toàn | Cán đóng về phía **sống** — cầm khi múa thì không bị cắt. |-| **Bite handle** | Cán nguy hiểm | Cán đóng về phía **lưỡi sắc** — cầm nhầm khi đóng sẽ bị cắt. |-| **Blade** | Lưỡi dao | Phần lưỡi trung tâm, nằm gọn trong hai cán khi đóng. |-| **Tang** | Chuôi lưỡi | Gốc lưỡi nơi hai cán gắn qua trục xoay. |-| **Tang pin** | Chốt chuôi | Chốt trên chuôi giữ hai cán không đập vào nhau/vào lưỡi. |-| **Kicker** / kicker pin | Điểm dừng lưỡi | Phần chuôi lưỡi chạm mặt trong cán để lưỡi không chạm đáy cán. |-| **Latch** / locking pin | Chốt khóa | Chốt ở đầu cán giữ hai cán khép lại (mở hoặc đóng). |-| **Batangas latch** | Khóa Batangas | Latch gắn ở **cán nguy hiểm** (kiểu Filipino truyền thống). |-| **Manila latch** | Khóa Manila | Latch gắn ở **cán an toàn**. |-| **Latch gate** | Chốt chặn khóa | Khối trong cán chặn latch thụt vào làm hư lưỡi. |-| **Latch bite** | Rãnh chốt | Khấc trên cán đối diện, nơi latch cài để khóa hai cán. |-| **Pivot pins** / axle pins | Trục xoay | Hai chốt làm trục cho hai cán quay quanh lưỡi. |-| **Zen pins** | Chốt Zen | Chốt bên trong cán chặn hành trình lưỡi (thay cho tang pin). |-| **Choil** | Hốc dao | Vùng không mài giữa lưỡi cắt và chuôi. |-| **Handle channel** | Cán rãnh đơn | Cán phay từ một khối duy nhất (không phải hai ốp rời). |-| **Skeletonized handle** | Cán đục lỗ | Cán có lỗ/khoét để giảm nặng & bám tay. |-| **Flipping** | Múa dao | Kỹ thuật mở/đóng bằng cổ tay. |-------## 3. Dao găm Karambit — Karambit--Nhận ra ngay nhờ **đường cong ngược (reverse curve)** + **vòng ngón (finger ring)**.--| English | VN | Định nghĩa |-|---|---|---|-| **Hawkbill blade** / curved talon | Lưỡi mỏ diều hâu | Lưỡi cong sâu như móng hổ / móng vuốt chim. |-| **Safety ring** / finger ring, retention ring | Vòng giữ ngón | Lỗ ở núm chuôi để xỏ ngón, giữ & kiểm soát dao. |-| **Inner edge** / concave edge | Lưỡi trong | Cạnh sắc chính, nằm ở mặt lõm bên trong đường cong. |-| **Outer spine** / convex spine | Sống ngoài | Lưng lưỡi chạy theo cung lồi bên ngoài. |-| **Belly** | Bụng dao | Đỉnh nhô nhất của cung, tạo lực chém mạnh. |-| **Point** / tip | Mũi dao | Đầu lưỡi, dùng đâm & thao tác chính xác. |-| **Spine** | Sống dao | Lưng lưỡi không mài, đỡ kết cấu đường cong. |-| **Second edge** / top edge | Lưỡi phụ | Cạnh sắc trên cung ngoài (một số bản tactical) để cắt đa hướng. |-| **Reverse grip** | Cầm ngược | Kiểu cầm chuẩn: lưỡi chĩa xuống, ngón trỏ xỏ qua vòng. |-------## 4. Nhận diện 20 loại dao CS2 — CS2 knife shapes--Mỗi dòng: **tên** — [VN] — hình lưỡi + đặc điểm cán + dấu hiệu nhận biết.--- **Bayonet** — Dao lê — lưỡi clip-point thẳng, một cạnh sắc + cán rãnh có vòng nòng súng + dáng quân đội dài cổ điển.-- **M9 Bayonet** — Dao lê M9 — lưỡi lớn một cạnh, **sống răng cưa (sawback)** + chắn tay đầy đủ + to & hầm hố hơn Bayonet thường.-- **Bowie Knife** — Dao Bowie — lưỡi clip-point cực lớn, **bụng sâu**, full tang + chắn tay chắc (thường đồng thau) + dáng "miền viễn tây" khổng lồ.-- **Butterfly Knife** — Dao bướm / Balisong — lưỡi mảnh một cạnh + hai cán đục lỗ xoay 180° + nhận ra qua động tác múa mở.-- **Falchion Knife** — Dao Falchion — lưỡi cong một cạnh (kiểu kiếm châu Âu) + cán gập ôm theo cung lưỡi + cán lớn, animation "xoay giữ thăng bằng".-- **Flip Knife** — Dao gập / Flip — lưỡi cong dài một cạnh, **mũi nhọn như kim** + cán gập gọn + lưỡi to bất thường so với cán.-- **Gut Knife** — Dao mổ / Gut — lưỡi bản rộng có **móc mổ bụng (gut hook)** trên sống + cán nhám + nhận ra qua cái móc để xẻ thịt.-- **Huntsman Knife** — Dao săn / Huntsman — lưỡi dày góc cạnh, sống kiểu cưa, **mũi tanto** + cán tactical nặng + dáng gồ ghề, răng cưa.-- **Karambit** — Dao găm Karambit — lưỡi hawkbill/talon cong sâu + cán có **vòng ngón** ở núm chuôi (cầm ngược) + dáng "móng hổ" ĐNÁ, động tác xoay.-- **Navaja Knife** — Dao Navaja — lưỡi gập nhỏ cong mượt một cạnh + khung cán thon gọn + kiểu Tây Ban Nha truyền thống, tối giản.-- **Nomad Knife** — Dao du mục / Nomad — lưỡi dày cong một cạnh + cán cân bằng chắc chắn + animation rút dao "nhăn mặt như bị cắt".-- **Paracord Knife** — Dao Paracord — lưỡi cố định mảnh, drop-point + **cán full tang bọc dây paracord** + dáng sinh tồn nhẹ, quấn dây.-- **Shadow Daggers** — Dao đôi / Shadow Daggers — **hai** lưỡi ngắn bản rộng, hai cạnh sắc + cán push-dagger chữ T kẹp giữa ngón + cầm đôi, đâm kiểu đấm.-- **Skeleton Knife** — Dao khung xương / Skeleton — lưỡi dài hai cạnh sắc, **lỗ lớn gần chuôi** + cán đục lỗ quấn băng + nhận ra qua lỗ ngón to ở chỗ nối lưỡi–cán.-- **Stiletto Knife** — Dao bấm Stiletto — lưỡi cực mảnh, **mũi kim** + cán mỏng kiểu bấm lò xo (switchblade) + dáng Ý hẹp, bung nhanh.-- **Survival Knife** — Dao sinh tồn / Survival — lưỡi cố định thô, có gut hook + răng cưa trên sống + cán bắt **bu-lông lục giác lộ ra** + dáng ngoài trời nặng.-- **Talon Knife** — Dao Talon — lưỡi cong kiểu Karambit + **ba lỗ gần chuôi** & răng cưa trên sống + cán ngà có vòng ngón + phân biệt với Karambit nhờ răng sống + lỗ.-- **Ursus Knife** — Dao Ursus — lưỡi tanto cắt mặt (faceted), sống thẳng, mũi nhọn + cán vuông đơn giản full tang + dáng công nghiệp gọn.-- **Classic Knife** — Dao cổ điển — lưỡi mảnh một cạnh hơi cong, **có fuller dọc sống** + cán ôm tay truyền thống + gợi nhớ CS bản gốc.-- **Kukri Knife** — Dao Kukri — lưỡi recurve to nặng, cạnh cong vào trong + cán có đuôi loe + dáng chặt "Gurkha" dốc xuống đặc trưng.-------## 5. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla** / bare metal | Nguyên bản | Thép mặc định, không pattern — toàn bộ dao. |-| **Painted surface** / skinned | Bề mặt sơn | Vùng engine áp texture finish — mặt lưỡi, sống, đôi khi cán. |-| **Bare metal accents** | Kim loại trần | Bộ phận để trần dù đã skin — **cạnh sắc, trục, bu-lông**. |--### Kiểu finish / loại skin-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** | Màu đơn sắc | Một lớp màu đều — mặt lưỡi & sống. |-| **Hydrographic** | In chuyển nước | Pattern in đè lên lớp nền (Crimson Web, Forest DDPAT) — mặt lưỡi. |-| **Anodized Multicolored** / airbrushed | Anode đa sắc | Sơn trong mờ trên nền kim loại → gradient (Fade) hoặc vằn (Slaughter) — mặt lưỡi & sống. |-| **Patina** | Lớp gỉ / patina | Xử lý hóa học đổi màu thép, đậm dần theo mòn (Blue Steel, Case Hardened) — mặt lưỡi. |-| **Gunsmith** | Gunsmith | Lai texture chi tiết cao + hiệu ứng patina — mặt lưỡi & cán. |-| **Spray-Paint** | Sơn xịt | Vẻ khuôn tô thô, thường camo (Safari Mesh, Night) — mặt lưỡi & sống. |-| **Doppler** | Doppler | Pattern sóng trong mờ, các phase P1–P4, Ruby, Sapphire, Black Pearl — mặt lưỡi. |-| **Gamma Doppler** | Gamma Doppler | Biến thể Doppler tông xanh lục/ngọc lục — mặt lưỡi. |-| **Fade** | Chuyển sắc / Fade | Gradient màu trong mờ trên nền chrome — mặt lưỡi & mũi. |-| **Marble Fade** | Fade cẩm thạch | Vân cẩm thạch nhiều màu, có biến thể "Fire and Ice" — mặt lưỡi & mũi. |-| **Tiger Tooth** | Răng hổ | Lưỡi vàng-cam với vằn ngang lởm chởm — mặt lưỡi. |-| **Ultraviolet** | Ultraviolet | Lưỡi đen mờ + điểm nhấn tím đặc trên cán — mặt lưỡi & cán. |-| **Case Hardened** | Nhiệt luyện / Case Hardened | Pha vàng-tím-"Blue Gem" do nung than — mặt lưỡi. |-| **Crimson Web** | Mạng nhện | Mạng nhện in hydrographic trên nền đỏ — mặt lưỡi. |-| **Slaughter** | Tàn sát | Vằn ngựa vằn bằng sơn nhôm & chrome — mặt lưỡi. |-| **Damascus Steel** | Thép Damascus | Vân sóng phân tầng của thép ghép — mặt lưỡi. |-| **Freehand** | Vẽ tay | Nét vẽ kiểu phấn trên nền tím/đen — mặt lưỡi. |-| **Lore** | Lore | Lưỡi vàng + hoa văn thắt nút Celtic xanh, cán bọc da — lưỡi, sống & cán. |-| **Autotronic** | Autotronic | Mảng đỏ + thép súng + lưới trắng — mặt lưỡi & fuller. |-| **Bright Water** | Nước trong | Camo hàng hải tông xanh — mặt lưỡi. |-| **Black Laminate** | Gỗ ép đen | Vân gỗ tối, mờ — mặt lưỡi & ốp cán. |-| **Rust Coat** | Lớp gỉ sét | Gỉ nặng, càng mòn càng cam & sần — mặt lưỡi. |-| **Scorched** | Cháy sém | Xám than với đốm đen như vết cháy — mặt lưỡi & sống. |-| **Stained** | Vết ố | Loang xám mờ kiểu rửa acid — mặt lưỡi. |-| **Boreal Forest / Forest DDPAT** | Ngụy trang rừng | Camo số/truyền thống tông xanh lá — mặt lưỡi. |-| **Blue Steel** | Thép xanh | Xanh nguội, nhạt khi mới, đậm tím theo mòn — mặt lưỡi. |-| **Night** | Đêm | Xanh đêm đặc, tối — mặt lưỡi & sống. |-| **Safari Mesh / Urban Masked** | Safari Mesh / Urban Masked | Lưới khuôn tô / camo đô thị xám bê tông — mặt lưỡi & sống. |--### Fade-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Fade Percentage** | Tỷ lệ Fade | Giá trị (~80–100%) = mức phủ gradient trên lưỡi — mặt lưỡi. |-| **Full Fade (100%)** | Fade hoàn toàn | Hiếm nhất: đủ 3 màu ở cường độ tối đa — mặt lưỡi. |-| **Fade Color Order** | Thứ tự màu Fade | Vàng → Cam → Hồng → Tím, chạy từ mũi đến gót — dọc lưỡi. |-| **Acid Fade** | Acid Fade | Biến thể gradient tông xám & vàng/xanh — mặt lưỡi. |-| **Fade Measurement** | Đo Fade | Đo bằng mức tím "lấn" ở gót lưỡi hoặc độ đậm màu ở mũi — mặt lưỡi. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Pattern Seed** / pattern index, template | Pattern Seed | Số (0–1000) dịch ngẫu nhiên bản đồ texture trên model — mặt lưỡi. |-| **Fire and Ice** | Băng và Lửa | Marble Fade chỉ đỏ & xanh, không vàng ở mũi — mặt lưỡi & mũi. |-| **Doppler Phase** | Giai đoạn Doppler | Khoảng pattern index cho cân bằng màu khác nhau (P1–P4, Ruby…) — mặt lưỡi. |-| **Blue Gem** | Blue Gem | Case Hardened phủ xanh tối đa — mặt lưỡi. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float Value** | Chỉ số mòn / Float | Số 0.00–1.00 định độ mòn — cạnh, sống, mũi, điểm cao. |-| **Factory New (FN)** | Mới xuất xưởng | 0.00–0.07, sáng nhất, gần như không xước — mặt lưỡi & sống. |-| **Minimal Wear (MW)** | Mòn tối thiểu | 0.07–0.15, chi tiết hơi mềm đi — cạnh & mũi. |-| **Field-Tested (FT)** | Đã qua sử dụng | 0.15–0.38, xước & xỉn rõ — cạnh, mũi, điểm cao. |-| **Well-Worn (WW)** | Mòn nhiều | 0.38–0.45, mất finish & xỉn nặng — mặt lưỡi & sống. |-| **Battle-Scarred (BS)** | Tàn phá | 0.45–1.00, mất finish/oxy hóa tối đa — mọi bề mặt sơn. |-| **Wear locations** | Vị trí mòn | Xước xuất hiện trước ở **cạnh sắc, sống, mũi, điểm cao (high points)** và chỗ nối lưỡi–cán. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–4: vd "belly (bụng dao) của Bowie chưa đủ sâu", "safety ring (vòng ngón) của Karambit đặt sai vị trí", "sống dao M9 thiếu sawback".-- **Sai texture/màu** → mục 5: vd "fade color order ngược (tím ở mũi thay vì gót)", "pattern seed lệch làm Blue Gem không phủ đủ", "wear đặt ở mặt lưỡi thay vì high points".-- **Bare metal accents**: cạnh sắc, trục, bu-lông thường KHÔNG sơn — nếu model sơn cả lên đó là sai.--_Các loại item tiếp theo (súng ngắn, súng trường, súng ngắm, găng tay…) sẽ được research riêng, mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/pistols.md b/docs/cs2-anatomy/pistols.mddeleted file mode 100644index acc6ed0..0000000--- a/docs/cs2-anatomy/pistols.md+++ /dev/null@@ -1,164 +0,0 @@-# CS2 Item Anatomy Vocabulary — Pistols (Súng ngắn)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của súng ngắn** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 4).->-> Nguồn: research NotebookLM (fast mode) — targetbarn.com (Parts of a Pistol + diagram), Magnum Research (manual Desert Eagle), bo3.gg (R8 Revolver), Liquipedia (P250), cs.money (weapon names), + kiến thức chuẩn về súng cho phần bị thiếu.-> Notebook: `CS2 Item Anatomy Vocabulary — Pistols (VN+EN)` (`7b0376c6`).-> _Lưu ý: 3 nguồn (cs.money, az.gov, usconcealedcarry) fail khi index; phần anatomy được targetbarn + Magnum Research cover đủ, chỗ thiếu đánh dấu [kiến thức chung]._-------## 1. Giải phẫu súng lục bán tự động — Semi-auto pistol anatomy--Áp dụng cho hầu hết pistol CS2 (trừ R8 Revolver — xem mục 2).--### A. KHÓA NÒNG & NÒNG (Slide & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Slide** | Khóa nòng | Phần trên trượt lùi theo giật để nạp đạn kế tiếp (bán tự động). |-| **Rear cocking serrations** | Rãnh kéo khóa nòng (sau) | Rãnh khía phía sau slide để bám tay khi lên đạn. |-| **Front cocking serrations** | Rãnh kéo khóa nòng (trước) | Rãnh khía phía trước slide, dùng press-check. |-| **Ejection port** | Cửa hất vỏ đạn | Khe trên slide để văng vỏ đạn đã bắn ra ngoài. |-| **Breech face** | Mặt khóa nòng | Bề mặt trong của slide tì vào đáy vỏ đạn khi lên nòng. |-| **Barrel** | Nòng súng | Ống thép dẫn viên đạn sau khi kích nổ. |-| **Muzzle** | Miệng nòng | Đầu trước nòng, nơi đạn thoát ra. |-| **Crown** | Loa nòng | Đầu miệng nòng được vát/thụt để bảo vệ khương tuyến. |-| **Chamber** | Buồng đạn | Khoang cuối nòng nơi viên đạn nằm trước khi bắn. |-| **Feed ramp** | Đường dẫn đạn | Mặt dốc dẫn viên đạn từ hộp tiếp đạn vào buồng đạn. |-| **Recoil spring guide rod** | Thanh dẫn lò xo hồi lực | Thanh đỡ lò xo hồi, chống kẹt khi slide di chuyển. |-| **Extractor** | Móng văng / móc đạn | Móc kéo vỏ đạn đã bắn ra khỏi buồng đạn. |--### B. KHUNG & TAY CẦM (Frame & Grip)--| English | VN | Định nghĩa |-|---|---|---|-| **Frame** / receiver | Khung súng / thân súng | Thân chính chứa nòng, slide và cụm cò. |-| **Dust cover** | Ốp che bụi | Phần khung phía trước, nằm dưới nòng. |-| **Accessory rail** / Picatinny, under-barrel rail | Rãnh phụ kiện / ray Picatinny | Ray chuẩn dưới nòng để gắn đèn/laser. |-| **Takedown lever** / disassembly latch | Chốt tháo súng | Chốt trên khung để mở slide khi tháo súng. |-| **Grip** | Tay cầm | Phần khung cầm bằng tay, chứa hộp tiếp đạn. |-| **Grip panels** / grip scales | Ốp tay cầm | Tấm ốp hai bên tay cầm tăng bám & êm tay. |-| **Backstrap** | Phần sau tay cầm | Mặt đứng sau tay cầm, tì vào lòng bàn tay. |-| **Front strap** | Phần trước tay cầm | Mặt đứng trước tay cầm, nơi các ngón quấn quanh. |-| **Beavertail** / grip tang | Đuôi nheo | Phần nhô trên đỉnh backstrap, chống "hammer bite" & slide cứa tay. |-| **Checkering / stippling** | Vân nhám / họa tiết bám | Vân/nhám trên bề mặt tay cầm chống trượt. |--### C. ĐIỀU KHIỂN & CƠ CẤU (Controls & Mechanism)--| English | VN | Định nghĩa |-|---|---|---|-| **Trigger** | Cò súng | Bộ phận bóp để khởi động chuỗi bắn. |-| **Trigger guard** | Vành bảo vệ cò | Vòng bao quanh cò, chống cướp cò ngoài ý muốn. |-| **Hammer** (spurred vs bobbed) | Búa đập | Đập vào kim hỏa; spurred có mấu ngón cái, bobbed bo tròn. |-| **Striker** | Kim hỏa | Kim hỏa lò xo bên trong, thay cho búa ở súng striker-fired. |-| **Slide stop** / slide release | Cần giữ khóa nòng | Cần khóa slide mở khi hết đạn / thả slide về. |-| **Thumb safety** / manual safety | Khóa an toàn | Cần gạt tay vô hiệu hóa cơ cấu bắn. |-| **Decocker** | Cần hạ búa an toàn | Cần hạ búa đã lên mà không kích nổ đạn trong buồng. |-| **Grip safety** | Khóa an toàn tay cầm | Thanh an toàn ở backstrap, phải nắm đúng mới bắn được. |-| **Magazine release button** | Nút tháo hộp tiếp đạn | Nút trên khung để nhả hộp tiếp đạn khỏi tay cầm. |--### D. NGẮM (Sights)--| English | VN | Định nghĩa |-|---|---|---|-| **Front sight** (post/blade) | Đầu ngắm | Điểm ngắm gần miệng nòng, đầu slide. |-| **Rear sight** (notch) | Thước ngắm | Bộ ngắm sau slide, thường có khe chữ U/V. |-| **Sight dovetail** | Rãnh đuôi én gắn ngắm | Rãnh hình nêm cắt trên slide để cố định bộ ngắm. |-| **Three-dot sight** | Điểm ngắm ba chấm | Hệ ngắm 1 chấm trước + 2 chấm sau để căn nhanh. |--### E. HỘP TIẾP ĐẠN (Magazine)--| English | VN | Định nghĩa |-|---|---|---|-| **Magazine** | Hộp tiếp đạn / băng đạn | Hộp rời chứa đạn, đẩy đạn vào cơ cấu. |-| **Magazine well** | Hốc chứa hộp tiếp đạn | Khe dưới tay cầm để lắp hộp tiếp đạn. |-| **Magazine baseplate** / floorplate | Đế hộp tiếp đạn | Miếng đáy bịt kín hộp tiếp đạn. |-| **Follower** | Miếng đẩy đạn | Bệ lò xo trong hộp đẩy đạn lên. |-| **Threaded barrel / suppressor mount** | Nòng ren / giá gắn giảm thanh | Nòng có ren ở miệng để gắn ống giảm thanh (USP-S). |-------## 2. Súng ổ xoay R8 — R8 Revolver--| English | VN | Định nghĩa |-|---|---|---|-| **Cylinder** / drum | Ổ xoay | Trụ chứa 8 khoang đạn, xoay quanh trục để đưa đạn vào vị trí bắn. |-| **Cylinder release / latch** | Chốt mở ổ xoay | Nút gạt trên khung để lật ổ xoay ra nạp đạn. |-| **Crane / yoke** | Trục bản lề ổ xoay | Cánh đòn gắn ổ xoay vào khung, cho ổ vung ra ngoài. |-| **Ejector rod** | Thanh đẩy vỏ đạn | Thanh ở tâm ổ xoay để đẩy vỏ đạn đã bắn ra. |-| **Extractor star** | Sao trích vỏ đạn | Bộ phận hình sao mặt sau ổ xoay, bám vành đạn để đẩy ra. |-| **Forcing cone** | Côn nòng | Đầu nòng hình phễu tiếp giáp ổ xoay, dẫn hướng viên đạn. |-| **Top strap** | Khung trên | Phần khung chạy dọc phía trên ổ xoay, nối thân với nòng. |-| **Frame** | Khung súng | Thân chính chứa cơ cấu kích hỏa (in logo "Precision & Accuracy"). |-| **Hammer** | Búa đập | Búa ngoài, quạt bằng tay hoặc bằng cò để đập kim hỏa. |-| **Barrel underlug / shroud** | Phần dưới nòng | Vỏ thép dưới nòng, bảo vệ thanh đẩy vỏ đạn. |-| **Barrel + rail** | Nòng + ray | Nòng R8 tích hợp ray Picatinny trên và dưới. |--_(Cò, vành cò, đầu/thước ngắm, backstrap, ốp tay cầm, miệng nòng — giống mục 1.)_-------## 3. Nhận diện 10 khẩu pistol CS2--- **USP-S** — Súng lục có nòng giảm thanh — khung polymer, striker-fired, **ống giảm thanh dài tháo rời** là dấu hiệu chính.-- **P2000** — Súng lục compact tiêu chuẩn — khung polymer, striker-fired, ngắn gọn, **không có giảm thanh**.-- **Glock-18** — Súng lục polymer bắn loạt — khung polymer, striker-fired, **thân hình khối vuông**, có nấc chọn chế độ bắn loạt.-- **P250** — Súng lục mô-đun — khung polymer lõi thép, **có búa đập ngoài**, cỡ vừa.-- **Five-SeveN** — Súng lục FN cơ số đạn lớn — thân bọc polymer, búa kín, **tay cầm dài** chứa hộp 20 viên.-- **Tec-9** — Súng lục khung thép dập — phần trên thép hình ống, khung dưới polymer, **nòng có vỏ tản nhiệt, hộp đạn dài**.-- **CZ75-Auto** — Súng lục full-auto toàn thép — **búa đập ngoài**, hộp đạn phụ gắn trước làm điểm nhận diện.-- **Dual Berettas** (Elites) — Cặp súng lục — **hai khẩu đối xứng** (một khẩu văng vỏ trái), nòng hở trên slide, búa ngoài, vành cò lớn.-- **Desert Eagle** — Súng lục hạng nặng — **khung thép khổng lồ, nòng hình tam giác lớn**, slide chiếm phần lớn chiều dài súng.-- **R8 Revolver** — Súng ổ xoay 8 viên — **ổ xoay lớn**, búa ngoài lộ rõ, có ray Picatinny trên nòng.-------## 4. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận pistol--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla / stock** | Mặc định / nguyên bản | Súng không skin — slide & nòng màu đen/bạc trơn — toàn bộ súng. |-| **Painted parts** | Bộ phận được sơn | Bề mặt lớn nhận họa tiết skin — **slide, khung (frame), ốp tay cầm**. |-| **Bare metal parts** | Kim loại trần | Chi tiết chức năng giữ màu gốc — **thước/đầu ngắm, cần điều khiển, cò**. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Pattern seed** / pattern index | Chỉ số hoa văn | Số định vị ngẫu nhiên bản đồ vân — **slide & khung**. |--### Kiểu finish-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** / custom paint job | Sơn màu đơn | Lớp sơn đồng nhất phủ kín — slide & khung. |-| **Hydrographic** / dipping | Sơn nhúng / thủy ấn | Phim họa tiết quấn quanh bề mặt cong — rõ nhất trên **ống giảm thanh & slide**. |-| **Anodized** | Sơn mạ / anode | Lớp phủ màu bóng kim loại — slide hoặc nòng, giữ ánh thép. |-| **Patina** | Lên màu thời gian | Đổi màu kim loại theo mòn (không bong tróc) — slide. |-| **Gunsmith** | Chế tác thủ công | Patina trên **slide kim loại** + sơn tùy chỉnh trên **khung/tay cầm polymer**. |-| **Spray-Paint** | Sơn xịt | Chi tiết thấp, bong sớm ở **cạnh slide & miệng nòng**. |-| **Fade** | Chuyển màu / fade | Gradient chạy dọc chiều dài **slide & ống giảm thanh**. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float Value** | Chỉ số mài mòn | 0.00–1.00, mức hư hại thị giác trên toàn súng. |-| **Factory New (FN)** | Mới xuất xưởng | Sắc nét tối đa trên slide & suppressor, không xước. |-| **Minimal Wear (MW)** | Ít trầy xước | Xước cực nhỏ ở **góc cạnh sắc của slide**. |-| **Field-Tested (FT)** | Đã qua sử dụng | Mờ/bong rõ ở **miệng nòng, cạnh slide, nút điều khiển**. |-| **Well-Worn (WW)** | Mòn nhiều | Lộ kim loại trần ở **front strap & điểm gờ cao trên slide**. |-| **Battle-Scarred (BS)** | Trầy xước nặng | Bong/xỉn nặng ở **cạnh slide, controls, vùng ma sát cao trên tay cầm**. |-| **Wear high points** | Điểm dễ mòn | Chịu tác động trước: **cạnh slide, miệng nòng, cần an toàn, rãnh serrations**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–3: vd "nòng Desert Eagle chưa đủ dáng tam giác", "USP-S thiếu ống giảm thanh", "ổ xoay R8 sai số khoang", "Glock thiếu dáng khối vuông".-- **Sai texture/màu** → mục 4: vd "pattern seed lệch làm vân trên slide sai vị trí", "wear đặt ở giữa slide thay vì cạnh/miệng nòng/high points".-- **Bare metal accents**: đầu/thước ngắm, cần điều khiển, cò thường KHÔNG sơn — nếu model sơn cả lên đó là sai.--_Đã xong: [dao](knives.md), pistol. Loại tiếp theo: SMG (súng ngắn liên thanh) / rifle / sniper / gloves — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/rifles.md b/docs/cs2-anatomy/rifles.mddeleted file mode 100644index cba1f3a..0000000--- a/docs/cs2-anatomy/rifles.md+++ /dev/null@@ -1,148 +0,0 @@-# CS2 Item Anatomy Vocabulary — Rifles (Súng trường)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của súng trường tấn công** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 4).->-> Nguồn: research NotebookLM (fast mode, 10 nguồn) — M16 Wikipedia (tiếng Việt) + ARMY TM 9-1005-319 (M16 manual); TM 8370-50007 (AK-47 maintenance manual); Glosbe (từ điển EN↔VI); Steyr AUG Wikipedia + cheaperthandirt.com (bullpup vs conventional); pewpewtactical.com (flash hider / muzzle brake / compensator); profilerr.net (M4A4 vs M4A1-S); cs2floatchecker.com (float/wear); white.market (pattern seed). Chỗ thiếu đánh dấu [kiến thức chung].-> Notebook: `CS2 Item Anatomy Vocabulary — Rifles (VN+EN)` (`ed67e020`).-------## 1. Giải phẫu súng trường tấn công — Assault-rifle anatomy--Áp dụng cho cả 7 rifle CS2. Layout **bullpup** (FAMAS/AUG) xem mục 2.--### A. THÂN SÚNG & NÒNG (Receiver & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Upper receiver** / top receiver | Thân trên | Phần trên thân súng, chứa cụm bệ khóa nòng và là nơi lắp nòng. |-| **Lower receiver** | Thân dưới | Phần dưới thân, chứa cụm cò, bộ chọn chế độ bắn và khe cắm hộp tiếp đạn. |-| **Receiver cover** / dust cover, top cover | Nắp thân súng / nắp chắn bụi | Nắp bảo vệ bộ phận chuyển động bên trong (AK có top cover hình vòm rõ). |-| **Ejection port** | Cửa hắt vỏ đạn | Khe hở trên thân nơi vỏ đạn đã bắn văng ra ngoài. |-| **Forward assist** | Nút đẩy khóa nòng | Nút nhấn để đẩy khóa nòng về vị trí đóng hoàn toàn (đặc trưng dòng M4/M16). |-| **Brass deflector** | Gờ hắt vỏ đạn | Gờ nhô sau cửa hắt vỏ, hướng vỏ đạn văng ra xa mặt người bắn. |-| **Barrel** | Nòng súng | Ống thép có rãnh xoắn định hướng & tạo xoáy cho đầu đạn. |-| **Muzzle** | Miệng nòng | Đầu mút nòng nơi đầu đạn thoát ra. |-| **Flash hider** / flash suppressor | Loa che lửa | Đầu nòng phân tán khí thuốc để giảm ánh lửa đầu nòng khi bắn. |-| **Muzzle brake** | Bộ phận bù giật | Đầu nòng chuyển khí thuốc sang hai bên để giảm lực giật về sau. |-| **Compensator** | Bộ phận giảm nảy | Đầu nòng hướng khí thuốc lên trên để chống nòng nảy lên khi bắn loạt. |-| **Threaded barrel / suppressor mount** | Đầu nòng có ren | Miệng nòng tiện ren để lắp ống giảm thanh (M4A1-S). |-| **Gas block** | Khối trích khí | Bộ phận trên nòng, trích một phần khí thuốc vào hệ vận hành. |-| **Gas tube** | Ống dẫn khí | Ống dẫn khí thuốc từ khối trích khí về bệ khóa nòng (AK: nằm rõ trên nòng). |-| **Gas piston** / short-stroke piston | Pít-tông khí | Nhận áp lực khí thuốc đẩy bệ khóa nòng về sau (hệ piston, khác direct-impingement). |-| **Front sight base** | Bệ đầu ruồi | Đế gắn trên nòng để giữ đầu ruồi. |--### B. PHỤ KIỆN THÂN (Furniture: báng + tay cầm + ốp lót tay)--| English | VN | Định nghĩa |-|---|---|---|-| **Buttstock** / stock | Báng súng | Phần sau súng tựa vào vai khi ngắm bắn. |-| **Fixed stock** | Báng cố định | Báng liền, không gập/kéo rút. |-| **Collapsible stock** / telescoping | Báng kéo rút | Báng trượt điều chỉnh chiều dài (dòng M4). |-| **Folding stock** | Báng gập | Báng gập sang bên để rút gọn súng (SG 553 gập ngang). |-| **Skeletonized stock** | Báng khung xương | Báng khoét rỗng để giảm nặng (Galil AR gập về phải). |-| **Cheek riser** / cheek rest | Ốp má | Phần đệm nhô lên báng cho vị trí tì má tối ưu khi dùng kính ngắm. |-| **Recoil pad** / buttplate | Đế báng súng | Đệm cuối báng giảm chấn & chống trượt khi tì vai. |-| **Pistol grip** | Tay cầm khai hỏa | Tay cầm sau cụm cò để giữ & điều khiển súng. |-| **Handguard** / foregrip | Ốp lót tay / tay cầm trước | Ốp bao quanh nòng, bảo vệ tay khỏi nhiệt & cho điểm cầm nắm. |-| **Vertical foregrip** | Tay cầm dọc trước | Tay cầm đứng dưới ốp lót tay (AUG có loại gập được). |-| **Rail system** (Picatinny / M-LOK / KeyMod) | Hệ thống ray | Rãnh chuẩn trên thân/ốp tay để gắn đèn, laser, kính ngắm. |--### C. NẠP ĐẠN & VẬN HÀNH (Feeding & Action)--| English | VN | Định nghĩa |-|---|---|---|-| **Magazine** (straight / curved / banana) | Hộp tiếp đạn (thẳng / cong / quả chuối) | Hộp chứa đạn, lò xo đẩy đạn lên; AK là "quả chuối" cong dài. |-| **Magazine well** | Khe cắm hộp tiếp đạn | Khoang trên thân dưới nơi lắp hộp tiếp đạn. |-| **Magazine release** / magazine catch | Chốt giữ hộp tiếp đạn | Nút/lẫy để nhả hộp tiếp đạn ra khỏi súng. |-| **Bolt** | Khóa nòng | Đẩy đạn vào buồng, đóng kín buồng đạn & khai hỏa. |-| **Bolt carrier group** (BCG) | Cụm bệ khóa nòng | Bệ + khóa nòng + kim hỏa, vận hành chu kỳ nạp/bắn. |-| **Charging handle** / cocking handle | Cần kéo nạp đạn | Kéo bệ khóa nòng về sau để lên đạn đầu / xử lý kẹt (AK ở bên phải, Galil hướng lên). |-| **Safety / fire selector** | Khóa an toàn kiêm cần chọn chế độ bắn | Lẫy khóa súng hoặc chọn phát một / loạt / tự động. |-| **Trigger** | Cò súng | Bóp để giải phóng búa đập, thực hiện phát bắn. |-| **Trigger guard** | Vành bảo vệ cò | Vòng bao quanh cò, chống cướp cò ngoài ý muốn. |--### D. NGẮM & RAY (Sights & Rails)--| English | VN | Định nghĩa |-|---|---|---|-| **Front sight post** | Đầu ruồi | Điểm ngắm trước, cột thép nhỏ trên bệ đầu ruồi. |-| **Rear sight** (aperture / peep sight) | Thước ngắm / khe ngắm | Bộ ngắm sau, căn với đầu ruồi để xác định mục tiêu. |-| **Carry handle** | Tay xách | Bộ phận trên lưng súng để xách, thường tích hợp thước ngắm (M16/M4A1-S, FAMAS lớn). |-| **Integrated optic** | Kính ngắm tích hợp | Hệ ngắm quang học gắn cố định theo thiết kế súng (AUG). |-| **Optic rail** / top rail | Ray gắn kính ngắm | Ray trên thân để lắp kính ngắm quang học. |-| **Iron sights** | Thước ngắm cơ khí | Hệ ngắm kim loại truyền thống (đầu ruồi + thước ngắm). |-| **Flip-up sights** / backup sights | Thước ngắm gập | Thước ngắm gập xuống khi không dùng / khi lắp kính. |-------## 2. Layout Bullpup — FAMAS & AUG--Kiểu **bullpup**: **hộp tiếp đạn và bệ máy (action) nằm PHÍA SAU cò súng**, ngay trong phần báng. Ưu điểm: **giảm mạnh chiều dài tổng thể** mà vẫn giữ nguyên chiều dài nòng (gọn trong không gian hẹp, không mất tầm bắn). Dấu hiệu nhận diện: **không có báng riêng phía sau tay cầm** — thân súng chạy thẳng ra vai, hộp tiếp đạn cắm sau cò.--- **FAMAS** — bullpup Pháp, **tay xách (carry handle) rất lớn kéo dài gần hết lưng súng** che thước ngắm.-- **AUG** — bullpup Áo, thân polymer "hữu cơ", **kính ngắm quang học tích hợp** + tay cầm dọc trước gập được.-------## 3. Nhận diện 7 khẩu rifle CS2--- **Galil AR** — Súng trường truyền thống — thân (receiver) góc cạnh, **báng khung xương gập về phải**, cần kéo nạp đạn hướng thẳng lên, ốp lót tay & furniture kiểu AK-family.-- **FAMAS** — **Bullpup** Pháp — bệ máy sau cò, **tay xách rất lớn** phủ gần hết lưng súng, dáng hộp gọn.-- **AK-47** — Súng trường truyền thống — **hộp tiếp đạn "quả chuối" cong dài**, nắp thân (top cover) hình vòm, **ống dẫn khí nằm rõ trên nòng**, cần kéo nạp bên phải.-- **M4A4** — Carbine hiện đại — nòng ngắn, **báng kéo rút (collapsible)**, hệ ray Picatinny bao quanh ốp lót tay, có forward assist & brass deflector.-- **M4A1-S** — M4A1-Silencer — nòng dài mảnh, **ống giảm thanh trụ tháo rời** là dấu hiệu chính, tay xách/thân trên kiểu M4.-- **SG 553** — SIG SG 553 — truyền thống — ốp lót tay hẹp, **báng gập ngang**, hộp tiếp đạn nhựa trong có thể kẹp đôi.-- **AUG** — Steyr AUG — **Bullpup** Áo — thân polymer "hữu cơ" tương lai, **kính ngắm quang học tích hợp**, tay cầm dọc trước gập được.-------## 4. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận rifle--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla / stock** | Mặc định / nguyên bản | Súng không skin — màu gốc trên toàn bộ từ nòng đến báng. |-| **Painted parts** | Bộ phận được sơn | Bề mặt lớn nhận họa tiết — **thân (receiver), ốp lót tay (handguard), báng súng (stock)**. |-| **Bare-metal parts** | Kim loại trần | Chi tiết chức năng giữ màu gốc — **thước/đầu ngắm, cần chọn chế độ bắn, cò, khóa nòng, cần kéo nạp đạn**. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Pattern seed** / pattern index | Chỉ số hoa văn / seed | Số 0–1000 định vị + góc xoay + cách xếp họa tiết trên model — rõ nhất với Fade & Case Hardened, trên **thân & ốp tay**. |--### Kiểu finish-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** / Custom Paint Job | Sơn màu đơn / họa tiết riêng | Mảng màu đồng nhất hoặc hình vẽ nghệ thuật — thân, ốp tay, báng. |-| **Hydrographic** / dipping | In chuyển nước / sơn nhúng | Họa tiết lặp phủ quanh bề mặt cong — rõ trên phụ kiện nhựa/gỗ & thân. |-| **Anodized** | Mạ anode | Lớp phủ màu bóng ánh kim — bộ phận nhôm như thân/nòng. |-| **Patina** | Lên màu thời gian | Oxy hóa/đổi màu kim loại theo mòn — thân & nòng. |-| **Gunsmith** | Chế tác thủ công | Lai: hình vẽ tùy chỉnh + hiệu ứng patina — khác nhau trên **thân kim loại** vs **báng gỗ/polymer**. |-| **Spray-Paint** | Sơn xịt | Giả khuôn tô + sơn xịt, vẻ thô, phủ toàn bề mặt; bong sớm ở **cạnh thân & miệng nòng**. |-| **Fade** | Chuyển màu / fade | Gradient nhiều sắc chạy dọc phần kim loại — thân & nòng. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float Value** / wear value | Chỉ số mài mòn / float | 0.00–1.00, mức hư hại thị giác trên toàn súng. |-| **Factory New (FN)** | Mới xuất xưởng | 0.00–0.07, sắc nét tối đa; thân, nòng & hộp tiếp đạn gần như không xước. |-| **Minimal Wear (MW)** | Ít trầy xước | 0.07–0.15, xước nhỏ bắt đầu ở **góc cạnh: cửa hắt vỏ, miệng nòng**. |-| **Field-Tested (FT)** | Đã qua sử dụng | 0.15–0.38, bong sơn rõ trên **ốp lót tay & hộp tiếp đạn**. |-| **Well-Worn (WW)** | Mòn nhiều | 0.38–0.45, xước nặng lộ kim loại trần dưới **thân & nòng**. |-| **Battle-Scarred (BS)** | Trầy xước nặng | 0.45–1.00, mất phần lớn sơn / xỉn tối trên **mọi bề mặt**. |-| **Wear high points** | Điểm dễ mòn | Chịu mòn trước: **miệng nòng, nòng, cạnh thân (receiver), hộp tiếp đạn, cạnh báng, đỉnh thước ngắm / ray**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–3: vd "AK thiếu hộp tiếp đạn cong quả chuối", "AK thiếu ống dẫn khí trên nòng", "M4A1-S thiếu ống giảm thanh tháo rời", "FAMAS/AUG chưa ra dáng bullpup (báng liền thân, mag sau cò)", "Galil thiếu báng khung xương gập phải", "SG 553 thiếu báng gập ngang".-- **Sai texture/màu** → mục 4: vd "pattern seed lệch làm vân trên thân/ốp tay sai vị trí", "wear đặt ở giữa thân thay vì cạnh/miệng nòng/high points", "Fade gradient chạy sai chiều".-- **Bare metal accents**: thước/đầu ngắm, cần chọn chế độ bắn, cò, khóa nòng, cần kéo nạp đạn thường KHÔNG sơn — nếu model sơn cả lên đó là sai.-- **Bullpup lưu ý**: FAMAS & AUG KHÔNG có báng riêng sau tay cầm — hộp tiếp đạn cắm phía sau cò; nếu model dựng chúng như súng conventional (mag trước cò + báng riêng) là sai layout.--_Đã xong: [dao](knives.md), [pistol](pistols.md), rifle. Loại tiếp theo: SMG (súng ngắn liên thanh) / sniper (súng ngắm) / gloves (găng tay) — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/smgs.md b/docs/cs2-anatomy/smgs.mddeleted file mode 100644index 757ce52..0000000--- a/docs/cs2-anatomy/smgs.md+++ /dev/null@@ -1,147 +0,0 @@-# CS2 Item Anatomy Vocabulary — SMGs (Súng ngắn liên thanh)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của súng ngắn liên thanh (SMG)** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–2). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 3).->-> Nguồn: research NotebookLM (fast mode, 10 nguồn) — tecom.marines.mil (Field Medical handbook), scribd/studocu.vn (GDQP súng tiểu liên — thuật ngữ VN), heckler-koch.com (MP5), lums.edu.pk (FN P90 loading), sadefensejournal.com (PP-Bizon), pickem (MP7 vs MP9 CS2) cho anatomy & nhận diện; counter-strike.net (Workshop Finishes), cs.trade (float & pattern), steamcommunity "Redline for Nerds" cho skin/finish.-> Notebook: `CS2 Item Anatomy Vocabulary — SMGs (VN+EN)` (`f783b110`).-> _Lưu ý: một số bộ phận chuẩn không có trong nguồn được bổ sung & đánh dấu [kiến thức chung]._-------## 1. Giải phẫu súng ngắn liên thanh tổng quát — General SMG anatomy--Áp dụng cho cả 7 khẩu SMG CS2 (MAC-10, MP9, MP7, MP5-SD, UMP-45, P90, PP-Bizon). Đa số SMG dùng cơ chế **blowback** (phản lực trực tiếp) và bắn từ bolt kín/hở.--### A. THÂN SÚNG & NÒNG (Receiver & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Receiver** / housing | Hộp khóa nòng / thân súng | Thân chính chứa bolt, cụm cò và giá nòng; khung tham chiếu của cả súng. |-| **Upper receiver** | Thân trên | Phần thân trên chứa bolt và đỡ nòng. |-| **Lower receiver** / grip frame | Thân dưới | Phần thân dưới chứa cụm cò và hốc cắm hộp tiếp đạn. |-| **Barrel** | Nòng súng | Ống thép dẫn viên đạn sau khi kích nổ. |-| **Muzzle** | Miệng nòng | Đầu trước nòng, nơi đạn thoát ra. |-| **Muzzle device** / flash hider, compensator | Thiết bị đầu nòng | Phụ kiện đầu nòng giảm chớp lửa hoặc ghì giật. |-| **Barrel shroud / jacket** (cooling holes/vents) | Áo nòng / ốp nòng (lỗ tản nhiệt) | Vỏ bọc quanh nòng, thường khoét lỗ để tản nhiệt & chống bỏng tay (rõ trên MAC-10, UMP-45). |-| **Suppressor** / integral silencer | Ống giảm thanh | Ống trụ bọc/nối miệng nòng để giảm tiếng — MP5-SD có **giảm thanh tích hợp** bao trọn nòng. |-| **Bolt / bolt carrier** | Khối khóa nòng / bệ khóa nòng | Cụm cơ khí lên đạn & chứa kim hỏa, trượt tới lui khi bắn. |-| **Blowback action** | Cơ chế phản lực (blowback) | Kiểu vận hành dùng áp suất khí đẩy bolt lùi để lên đạn kế tiếp. |-| **Charging handle** / cocking handle | Tay kéo khóa nòng / tay lên đạn | Tay cầm kéo bolt về sau để lên viên đầu hoặc thông kẹt. |-| **Ejection port** | Cửa hất vỏ đạn | Khe trên thân để văng vỏ đạn đã bắn (P90 hất **xuống dưới**). |-| **Extractor** | Móng văng / móc đạn | Móc trên mặt bolt kéo vỏ đạn ra khỏi buồng đạn. |--### B. BÁNG & TAY CẦM (Stock & Grip)--| English | VN | Định nghĩa |-|---|---|---|-| **Fixed stock** | Báng cố định | Báng không chỉnh, tối đa độ ổn định khi bắn. |-| **Folding stock** (side-folding, under-folding) | Báng gấp | Báng gấp sang bên/xuống dưới để gọn khi mang (MP9, UMP-45, PP-Bizon). |-| **Collapsible stock** / telescoping, retractable | Báng rút / báng kéo dài | Báng chỉnh chiều dài, trượt vào-ra (MP7, MAC-10). |-| **Wire stock** | Báng khung dây thép | Báng tối giản làm bằng thanh/dây kim loại (MAC-10). |-| **Buttplate** / buttpad | Đế báng | Mặt sau báng tì vào vai. |-| **Cheek rest** / cheek weld | Điểm tựa má | Phần trên báng để áp má căn ngắm. |-| **Pistol grip** | Tay cầm khai hỏa | Tay cầm chính của tay bóp cò. |-| **Grip stippling / texture** | Nhám tay cầm | Vân/nhám trên tay cầm chống trượt. |-| **Handguard** | Ốp lót tay | Vỏ che quanh nòng để cầm phần trước súng không bỏng tay. |-| **Foregrip** / vertical grip, forward grip | Tay cầm phụ / tay cầm trước | Tay cầm thêm phía trước tăng ổn định (MP9 tích hợp sẵn). |-| **Forend** / forearm | Phần đầu thân súng | Phần trước thân/khung nằm dưới nòng. |-| **Thumbhole** | Lỗ luồn ngón cái | Lỗ khoét trên thân bullpup để luồn ngón cái (P90). |--### C. TIẾP ĐẠN (Feeding)--| English | VN | Định nghĩa |-|---|---|---|-| **Box / stick magazine** | Băng đạn hộp / băng thẳng | Hộp rời chứa đạn, đẩy đạn bằng lò xo; thẳng hoặc hơi cong. |-| **Curved magazine** | Băng đạn cong | Băng cong theo độ côn của đạn (MP5-SD). |-| **Magazine well** | Hốc / khe cắm băng đạn | Khe trên thân/tay cầm để lắp băng đạn. |-| **P90 top-mounted horizontal magazine** | Băng đạn nằm ngang phía trên (P90) | Băng nhựa **nằm ngang, phẳng dọc nóc súng**, song song nòng; đạn xoay 90° trước khi vào buồng. |-| **PP-Bizon helical magazine** / drum | Băng đạn xoắn ốc (PP-Bizon) | Băng trụ dài **lắp dưới nòng**, cấp đạn kiểu xoắn ốc; kiêm điểm tì tay. |-| **Magazine release** / mag catch | Nút / lẫy tháo băng đạn | Cần/nút nhả băng đạn khỏi súng. |-| **Magazine baseplate** / floorplate | Đế băng đạn | Miếng đáy bịt & giữ lò xo trong băng. |-| **Follower** | Bản nâng đạn | Bệ trong băng đẩy đạn lên vị trí tiếp. |--### D. ĐIỀU KHIỂN & NGẮM (Controls & Sights)--| English | VN | Định nghĩa |-|---|---|---|-| **Trigger** | Cò súng | Lẫy bóp để khởi động chuỗi bắn. |-| **Trigger guard** | Vành bảo vệ cò | Vòng bao quanh cò, chống cướp cò ngoài ý muốn. |-| **Fire selector** / selector switch | Cần chọn chế độ bắn | Cần gạt chọn safe / bán tự động / liên thanh. |-| **Safety** | Khóa an toàn | Cơ cấu chặn súng bắn ngoài ý muốn. |-| **Front sight** (post/blade) | Đầu ngắm | Điểm ngắm gần miệng nòng. |-| **Rear sight** (notch/aperture) | Thước ngắm | Bộ ngắm phía sau thân, khe chữ U/V hoặc lỗ tròn. |-| **Iron sights** | Hệ ngắm cơ khí | Bộ ngắm không quang học gồm đầu + thước ngắm. |-| **Optic rail** / Picatinny, accessory rail | Ray gắn phụ kiện | Ray chuẩn để gắn ống ngắm/đèn/laser (P90 & MP7 có ray dọc nóc). |-| **Sling mount** / swivel, sling loop | Điểm gắn dây đeo | Móc/khuyên gắn dây đeo súng. |-------## 2. Nhận diện 7 khẩu SMG CS2 — CS2 SMG identification--Mỗi dòng: **tên** — silhouette + vị trí băng đạn + kiểu báng + dấu hiệu nhận biết.--- **MAC-10** — Súng tiểu liên thép dập — **khối thân hình hộp vuông vức**, băng đạn hộp thẳng **cắm thẳng vào tay cầm chính**, báng khung dây thép rút gọn, thường có dây đai vải phía trước — dáng thô, ngắn, vuông.-- **MP9** — SMG polymer nhỏ gọn (kiểu B&T/Steyr) — **băng đạn nghiêng ra trước, nằm trước tay cầm chính**, báng gấp sang bên, tay cầm phụ tích hợp sẵn phía trước — dáng hiện đại, gọn.-- **MP7** — PDW siêu nhỏ gọn — **băng đạn cắm trong tay cầm chính** (như súng lục), báng thanh trượt rút gọn, **ray Picatinny kéo dài dọc nóc súng** — nhỏ nhất, dáng "súng lục to".-- **MP5-SD** — SMG có giảm thanh tích hợp — **ống giảm thanh trụ lớn bao trùm toàn bộ nòng**, băng đạn cong đặc trưng gắn trước vòng cò, báng rút — nhận ra ngay qua ống giảm thanh mập.-- **UMP-45** — SMG polymer .45 to bản — **băng đạn thẳng/thanh dài** to (cỡ .45), báng polymer đặc gấp sang bên, khe tản nhiệt lớn trên ốp lót tay — dáng gồ ghề, nặng nề.-- **P90** — SMG bullpup FN — **thiết kế bullpup** (cụm khai hỏa sau tay cầm), **băng đạn nhựa trong suốt nằm ngang dọc nóc súng**, thân liền khối có lỗ luồn ngón cái (thumbhole), cửa hất vỏ hướng xuống — silhouette độc nhất, không lẫn với súng nào.-- **PP-Bizon** — SMG nền AK — nắp hộp khóa nòng kiểu AK, **băng đạn hình trụ xoắn ốc (helical) lớn lắp dưới nòng** (kiêm điểm tì tay), báng khung tam giác gấp sang bên — nhận ra qua ống băng đạn trụ dài dưới nòng.--**Lưu ý hình khối then chốt (dễ sai nhất):**-- P90 = băng đạn **nằm ngang trên nóc** (KHÔNG phải băng cắm dưới như súng thường).-- PP-Bizon = ống **trụ xoắn dưới nòng** (KHÔNG phải băng hộp cong).-- MP7 & MAC-10 = băng đạn **trong tay cầm**; MP9 = băng **trước tay cầm**.-- MP5-SD = **giảm thanh liền** bao trọn nòng (không tháo rời như USP-S).-------## 3. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận SMG--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla / stock** | Mặc định / nguyên bản | Súng chưa áp skin — vật liệu nhà máy gốc — toàn bộ súng. |-| **Paintable parts** / refinishable areas | Vùng có thể sơn | Bề mặt lớn nhận texture skin — **thân súng (receiver), báng (stock), ốp lót tay (handguard)**, và băng đạn. |-| **Bare metal parts** / substrate, unfinishable areas | Kim loại trần / bề mặt phôi | Chi tiết chức năng giữ màu gốc — **đầu/thước ngắm, cần chọn chế độ, cò, ốc vít, trong nòng**. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Paint seed** / pattern seed, pattern index | Mã hạt / số seed | Giá trị ngẫu nhiên (1–1000) quyết định vị trí, độ xoay & độ lệch của họa tiết trên model — **thân súng & băng đạn**. |--### Kiểu finish-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** | Màu đơn sắc | Từng bộ phận sơn tối đa 4 màu riêng trước khi lắp ráp — thân, báng, ốp lót tay. |-| **Spray-Paint** | Sơn xịt | Sơn nhiều lớp qua khuôn chắn (stencil), hiệu ứng chồng lớp; bong sớm ở **cạnh thân & miệng nòng**. |-| **Hydrographic** / dipping | Sơn nhúng / thủy ấn | Nhúng bộ phận qua màng phim họa tiết nổi trên nước — rõ trên bề mặt cong (**ống giảm thanh MP5-SD, thân súng**). |-| **Anodized** / airbrushed, multicolored | Sơn mạ / anode | Lớp màu mỏng (candy coat) trên nền chrome bóng — giữ ánh kim loại trên thân/nòng. |-| **Patina** | Lên màu thời gian / rỉ kim loại | Đổi màu kim loại kiểu phản ứng hóa học (xanh hóa, tôi thép) — thân kim loại. |-| **Custom Paint Job** | Sơn tùy chỉnh | Tranh vẽ cố định áp thẳng lên UV map, **không đổi theo seed** — toàn thân. |-| **Gunsmith** | Chế tác thủ công | Lai Patina + Custom Paint Job trên cùng khẩu — thân kim loại + báng/ốp polymer. |-| **Fade** | Chuyển màu / fade | Biến thể Anodized, các màu hòa & chuyển dần dọc **thân súng & báng**. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float Value** / wear value | Chỉ số Float / độ mòn | Số 0.00–1.00 định mức trầy xước & xuống cấp lớp sơn — toàn súng. |-| **Factory New (FN)** | Mới xuất xưởng | 0.00–0.07, hoàn hảo nhất, gần như không xước — thân & băng đạn. |-| **Minimal Wear (MW)** | Ít trầy xước | 0.07–0.15, vài xước nhỏ ở cạnh, màu hơi tối — **cạnh thân & góc sắc**. |-| **Field-Tested (FT)** | Đã qua sử dụng | 0.15–0.37, phổ biến nhất, xước & bụi bẩn rõ — cạnh thân, miệng nòng, controls. |-| **Well-Worn (WW)** | Mòn nhiều | 0.37–0.44, bong tróc đáng kể, lộ kim loại trần — high points & cạnh băng đạn. |-| **Battle-Scarred (BS)** | Tàn phá / vết sẹo chiến tranh | 0.44–1.00, mất phần lớn lớp sơn, xỉn & bẩn — mọi bề mặt sơn. |-| **Wear high points** | Điểm dễ mòn | Chịu tác động trước: **cạnh & góc sắc của thân, miệng nòng, các điểm nhô cao, cần điều khiển, cạnh băng đạn**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–2: vd "P90 để băng đạn cắm dưới thay vì nằm ngang trên nóc", "PP-Bizon thiếu ống băng đạn xoắn dưới nòng", "MP5-SD thiếu giảm thanh tích hợp bao nòng", "MAC-10 chưa đủ dáng khối hộp vuông", "MP7 để băng ngoài tay cầm".-- **Sai texture/màu** → mục 3: vd "pattern seed lệch làm họa tiết trên thân sai vị trí", "wear đặt ở giữa thân thay vì cạnh/miệng nòng/high points", "Fade chuyển màu sai hướng dọc thân".-- **Bare metal accents**: đầu/thước ngắm, cần chọn chế độ, cò, ốc vít thường KHÔNG sơn — nếu model sơn cả lên đó là sai.--_Đã xong: [dao](knives.md), [pistol](pistols.md), SMG. Loại tiếp theo: rifle / sniper / gloves — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2-anatomy/snipers.md b/docs/cs2-anatomy/snipers.mddeleted file mode 100644index 45b2f32..0000000--- a/docs/cs2-anatomy/snipers.md+++ /dev/null@@ -1,152 +0,0 @@-# CS2 Item Anatomy Vocabulary — Snipers (Súng ngắm / Súng bắn tỉa)--> Bộ từ vựng song ngữ để **gọi đúng tên từng bộ phận của súng ngắm** khi mô tả lỗi fidelity trong pipeline img2threejs.-> Quy tắc dùng: **geometry/hình khối sai** → dùng tên bộ phận vật lý (mục 1–3). **Texture/màu/pattern sai** → dùng thuật ngữ skin CS2 (mục 4).-> Đặc điểm định danh của dòng này là **ống ngắm (scope/optic)** — nên nó có mục riêng (mục 2).->-> Nguồn: research NotebookLM (fast mode, 10 nguồn) — Liquipedia (SSG 08), strafe.com (AWP deep dive), Leupold Tactical Riflescope Manual + Rugged Suppressors (anatomy nòng/ngắm); Shephard Infantry Equipment Handbook, H&K G3 Wikipedia, vi.wikipedia (cơ cấu lên đạn thủ công), GunSkins (bolt-action vs semi-auto); counter-strike.net Workshop Finishes + ProSettings (skin & finish CS2), + kiến thức chuẩn về súng cho phần bị thiếu.-> Notebook: `CS2 Item Anatomy Vocabulary — Snipers (VN+EN)` (`e20b3968`).-> _Lưu ý: cả 10 nguồn import thành công; chỗ không có nguồn phủ được đánh dấu [kiến thức chung]._-------## 1. Giải phẫu súng ngắm tổng quát — Sniper / precision-rifle anatomy--### A. CƠ CẤU & NÒNG (Action & Barrel)--| English | VN | Định nghĩa |-|---|---|---|-| **Receiver** (frame) | Hộp khóa nòng | Thân trung tâm chứa các bộ phận vận hành bên trong của súng. |-| **Action** (operating system) | Cơ cấu lên đạn | Hệ cơ khí lo việc nạp, bắn và tống vỏ đạn. |-| **Bolt** (breechblock) | Khối khóa nòng | Bộ phận trượt trong hộp khóa nòng để lên đạn và bịt kín buồng đạn. |-| **Bolt handle** (cocking handle) | Cần kéo khóa nòng | Cần kim loại gắn vào khối khóa nòng để lên đạn thủ công. |-| **Bolt knob** (handle tip) | Núm kéo khóa nòng | Núm ở đầu cần kéo khóa nòng để tay bám khi giật. |-| **Charging handle** (cocking lever) | Cần lên đạn | Cần kéo lùi khối khóa nòng / bệ khóa nòng trên súng bán tự động. |-| **Bolt-action** (manual action) | Cơ cấu lên đạn thủ công | Hệ phải kéo khóa nòng thủ công cho từng phát bắn (SSG 08, AWP). |-| **Semi-automatic** (self-loading) | Súng bán tự động | Hệ dùng năng lượng giật/khí thuốc tự lên đạn sau mỗi phát (SCAR-20, G3SG1). |-| **Barrel** (tube) | Nòng súng | Ống thép dẫn viên đạn khi bắn. |-| **Fluted barrel** (grooved barrel) | Nòng xẻ rãnh | Nòng có rãnh xẻ dọc để giảm nặng và tăng diện tích tản nhiệt. |-| **Free-floating barrel** | Nòng treo tự do | Nòng không chạm ốp/báng, tránh nhiễu để tăng độ chính xác. |-| **Heavy barrel** (bull barrel) | Nòng hạng nặng | Nòng dày, cứng, giảm rung và chịu nhiệt khi bắn liên tục. |-| **Muzzle** (bore exit) | Đầu nòng / miệng nòng | Đầu trước nòng, nơi đạn thoát ra. |-| **Muzzle brake** (compensator) | Bộ hãm giật đầu nòng | Chuyển hướng khí thuốc để giảm giật cảm nhận. |-| **Flash hider** (flash suppressor) | Bộ che lửa đầu nòng | Gắn ở miệng nòng, giảm tia lửa nhìn thấy khi bắn. |-| **Threaded muzzle** (threaded tip) | Đầu nòng có ren | Miệng nòng có ren để gắn giảm thanh / phụ kiện đầu nòng. |--### B. BÁNG & TAY CẦM (Stock & Grip)--| English | VN | Định nghĩa |-|---|---|---|-| **Buttstock** (shoulder stock) | Báng súng | Phần sau súng tì vào vai để đỡ. |-| **Adjustable stock** (modular stock) | Báng điều chỉnh được | Báng có phần chỉnh kích thước theo cơ thể người bắn. |-| **Folding stock** (collapsible stock) | Báng gấp | Báng gấp/thu lại để súng gọn khi mang (SSG 08). |-| **Skeletonized stock** (hollow stock) | Báng dạng khung xương | Báng khoét bớt vật liệu cho nhẹ mà vẫn cứng (SSG 08). |-| **Cheek riser** (cheek piece) | Ốp má | Phần nâng trên báng đỡ đầu người bắn để căn mắt vào ngắm. |-| **Adjustable comb** (riser plate) | Ốp má chỉnh được | Ốp má chỉnh cao/thấp để căn mắt với ống ngắm gắn cao. |-| **Recoil pad** (buttpad) | Đệm báng súng | Đệm mềm ở đuôi báng để hấp thụ lực giật. |-| **Pistol grip** (main grip) | Tay nắm chính | Tay cầm dọc cho tay thuận đỡ súng và bóp cò (SCAR-20, G3SG1). |-| **Trigger** (firing lever) | Cò súng | Cần bóp để nhả cơ cấu kích hỏa. |-| **Trigger guard** (safety loop) | Vành bảo vệ cò | Vòng bao quanh cò, chống cướp cò ngoài ý muốn. |-| **Two-stage trigger** (precision trigger) | Cò hai giai đoạn | Cò có đoạn "take-up" đầu rồi mới tới điểm nhả dứt khoát. |--### C. TIẾP ĐẠN & RAY (Feeding & Rails)--| English | VN | Định nghĩa |-|---|---|---|-| **Magazine** (clip) | Hộp tiếp đạn / băng đạn | Hộp chứa đạn, đẩy đạn vào cơ cấu. |-| **Magazine well** (magwell) | Hốc cắm hộp tiếp đạn | Khe trên hộp khóa nòng để lắp và khóa hộp tiếp đạn. |-| **Box magazine** (detachable magazine) | Hộp tiếp đạn dạng khối | Hộp đạn hình chữ nhật, tháo rời (SCAR-20, G3SG1). |-| **Handguard** (forend) | Ốp lót tay | Phần bọc trước súng, bảo vệ tay khỏi nòng nóng. |-| **Picatinny rail** (tactical rail) | Ray Picatinny | Ray chuẩn để gắn ống ngắm, đèn/laser, phụ kiện. |-| **Bipod** (support stand) | Chân chống hai chân | Chân hai càng để tì súng lên mặt phẳng cho ổn định (G3SG1). |-| **Sling swivel** (sling mount) | Vòng khoen dây đeo | Điểm gắn dây đeo để mang súng. |-| **Ejection port** (shell window) | Cửa hất vỏ đạn | Khe trên hộp khóa nòng để văng vỏ đạn đã bắn (súng bán tự động). |-| **Dust cover** (action cover) | Nắp che bụi | Nắp/vạt che chống bụi lọt vào cơ cấu bên trong. |-------## 2. Ống ngắm — Riflescope / Optic (đặc điểm định danh của dòng sniper)--Đây là bộ phận nổi bật nhất; sai hình khối ống ngắm thường là lỗi fidelity dễ thấy nhất.--| English | VN | Định nghĩa |-|---|---|---|-| **Objective lens** (front lens) | Vật kính | Thấu kính đầu ống, gom sáng và tạo ảnh ban đầu của mục tiêu. |-| **Objective bell** (front housing) | Đầu loe vật kính | Phần loe trước của thân ống, chứa vật kính. |-| **Ocular lens / eyepiece** (eyepiece lens) | Thị kính | Cụm thấu kính sau ống, gần mắt, phóng đại ảnh. |-| **Scope tube / main tube** (body tube) | Thân ống chính | Ống trụ giữa, chứa cụm thấu kính đảo ảnh và cơ cấu bên trong. |-| **Elevation turret** (elevation adjustment) | Núm chỉnh cao độ | Núm trên đỉnh, chỉnh dọc tâm ngắm để bù độ rơi đạn. |-| **Windage turret** (windage adjustment) | Núm chỉnh hướng gió | Núm bên hông, chỉnh ngang tâm ngắm để bù gió tạt. |-| **Parallax adjustment / side focus** (side parallax dial) | Núm chỉnh thị sai | Chỉnh cho ảnh mục tiêu và tâm ngắm về cùng mặt phẳng tiêu cự. |-| **Magnification ring / power ring / zoom ring** (power selector) | Vòng chỉnh độ phóng đại | Vòng xoay đổi mức phóng đại (ống ngắm biến đổi). |-| **Reticle / crosshair** (aiming point) | Tâm ngắm / vạch chữ thập | Hoa văn/đường giao bên trong để căn súng với mục tiêu. |-| **Scope mount** (base) | Gá ống ngắm / chân đế | Bộ gá cố định ống ngắm lên hộp khóa nòng hoặc ray. |-| **Scope rings** (mounting rings) | Vòng khuyên giữ ống ngắm | Kẹp tròn ôm thân ống, siết ống vào gá/ray. |-| **One-piece mount** (uni-mount) | Chân đế nguyên khối | Một khối gá liền tích hợp cả hai vòng, tăng độ đồng trục & vững. |-| **Sunshade / lens hood** (glare shield) | Ống che nắng | Ống nối dài trước vật kính, giảm lóa và bảo vệ thấu kính. |-| **Eye relief** (eye distance) | Khoảng đặt mắt | Khoảng cách từ thị kính tới mắt để thấy trọn ảnh ngắm rõ. |-| **Diopter / eyepiece focus ring** (diopter lock ring) | Vòng lấy nét thị kính | Chỉnh trên thị kính để lấy nét tâm ngắm theo mắt người bắn. |-| **Illumination control / brightness knob** (illumination dial) | Núm chỉnh đèn tâm ngắm | Núm/nút bật và chỉnh độ sáng của tâm ngắm phát sáng. |-------## 3. Nhận diện 4 khẩu sniper CS2--- **SSG 08** (Scout) — Súng ngắm bolt-action hạng nhẹ — **cơ cấu lên đạn thủ công**, dáng mảnh, **báng khung xương/gấp**, ống ngắm gọn gắn ray Picatinny. Nhẹ nhất trong nhóm.-- **AWP** — Arctic Warfare bolt-action hạng nặng — **cơ cấu lên đạn thủ công**, nặng và cồng kềnh, **thân xanh olive** đặc trưng, **ống ngắm to độ phóng đại cao**, cần kéo khóa nòng bên phải, nòng dày.-- **SCAR-20** — Súng ngắm bán tự động (nền FN SCAR-H) — **không có cần kéo khóa nòng**, nặng, **hộp khóa nòng dáng khối**, tay nắm chính (pistol grip), hộp tiếp đạn khối, ray gắn ống ngắm, báng cố định.-- **G3SG1** — Súng ngắm bán tự động (nền H&K G3) — **không có cần kéo khóa nòng**, dài & nặng, **ốp lót tay dài có chân chống (bipod) tích hợp**, hộp tiếp đạn khối, ống ngắm chuyên dụng (Hensoldt/Zeiss).--_Phân biệt cốt lõi: **có cần kéo khóa nòng (bolt handle) = bolt-action** (SSG 08, AWP); **không có, có cửa hất vỏ = bán tự động** (SCAR-20, G3SG1)._-------## 4. Thuật ngữ SKIN / FINISH CS2 → map lên bộ phận sniper--Dùng khi **texture/màu/pattern** sai (không phải hình khối).--### Phân biệt phần được sơn-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Vanilla / stock** (default) | Mặc định / nguyên bản | Súng không skin, giữ diện mạo gốc — toàn bộ súng. |-| **Painted parts** (paintable areas) | Bộ phận được sơn | Vùng nhận màu/họa tiết skin — **hộp khóa nòng, nòng, báng, ốp lót tay**. |-| **Bare-metal parts** (unpainted regions) | Kim loại trần | Chi tiết giữ màu gốc — **khối khóa nòng, cò**; và **ống ngắm thường KHÔNG được skin sơn**. |--### Pattern-| English | VN | Nghĩa & vị trí |-|---|---|---|-| **Pattern seed** (pattern index) | Chỉ số hoa văn | Số ngẫu nhiên định vị/xoay/căn bản đồ vân trên súng — receiver, nòng, báng. |--### Kiểu finish-| English | VN | Đặc trưng & vị trí |-|---|---|---|-| **Solid Color** (paint by number) | Màu đơn | Tối đa 4 màu áp lên các vùng định sẵn của súng. |-| **Hydrographic** (hydro-dipping) | Sơn nhúng nước | Phim họa tiết quấn quanh bề mặt cong — rõ nhất trên nòng & báng. |-| **Anodized** (candy coat) | Mạ anode | Lớp "candy coat" màu phủ trên nền chrome, giữ ánh kim. |-| **Spray-Paint** (stencil) | Sơn xịt | Áp qua khuôn tô, triplanar mapping — chi tiết thô. |-| **Patina** (forced aging) | Lên màu/oxy hóa | Đổi màu kim loại theo phản ứng hóa học (case-harden, bluing) — receiver & nòng. |-| **Gunsmith** (mixed media) | Chế tác thủ công | Patina trên **phần kim loại** + sơn tùy chỉnh trên **báng/ốp** furniture. |-| **Fade** (gradient) | Chuyển màu / fade | Gradient trên nền anode/chrome chạy dọc nòng & receiver. |-| **Custom Paint Job** (graphic art) | Sơn tùy chỉnh | Đồ họa chi tiết cao áp thẳng lên bản đồ UV của súng. |--### Wear / Float-| English | VN | Nghĩa & vị trí mòn |-|---|---|---|-| **Float value** (wear index) | Chỉ số mài mòn | 0.00–1.00, mức hư hại thị giác trên toàn súng. |-| **Factory New (FN)** | Mới xuất xưởng | 0.00–0.07, gần như không xước, sắc nét nhất. |-| **Minimal Wear (MW)** | Ít trầy xước | 0.07–0.15, vài xước cực nhỏ, gần như mới. |-| **Field-Tested (FT)** | Đã qua sử dụng | 0.15–0.38, xước & bong sơn vừa phải. |-| **Well-Worn (WW)** | Mòn nhiều | 0.38–0.45, mất sơn & xỉn nặng khắp súng. |-| **Battle-Scarred (BS)** | Trầy xước nặng | 0.45–1.00, mất finish gốc gần hết, oxy hóa tối đa. |-| **Wear high points** | Điểm dễ mòn | Chịu tác động trước: **đầu nòng, cạnh nòng, cạnh báng, hộp tiếp đạn, gờ cao receiver, cần kéo khóa nòng**. |-------## Ghi chú dùng cho debug fidelity--- **Sai hình khối** → mục 1–3: vd "ống ngắm AWP chưa đủ to / thiếu đầu loe vật kính", "SSG 08 thiếu báng khung xương", "SCAR-20 vẽ nhầm cần kéo khóa nòng (phải bỏ vì là bán tự động)", "G3SG1 thiếu bipod tích hợp dưới ốp lót tay", "nòng AWP chưa đủ dày".-- **Sai ống ngắm** → mục 2: vd "sai tỉ lệ vật kính/thị kính", "thiếu núm chỉnh cao độ/hướng gió (turret)", "vòng chỉnh độ phóng đại đặt sai chỗ", "gá/vòng khuyên giữ ống ngắm sai".-- **Sai texture/màu** → mục 4: vd "pattern seed lệch làm vân trên receiver/báng sai vị trí", "wear đặt giữa nòng thay vì đầu nòng/cạnh/high points".-- **Bare metal & ống ngắm**: khối khóa nòng, cò — và **ống ngắm** — thường KHÔNG được skin sơn; nếu model sơn cả họa tiết skin lên ống ngắm là sai.--_Đã xong: [dao](knives.md), [pistol](pistols.md), sniper. Loại tiếp theo: SMG / rifle / gloves — mỗi loại một file trong `docs/cs2-anatomy/`._diff --git a/docs/cs2/3D_Technical_Mapping.json b/docs/cs2/3D_Technical_Mapping.jsondeleted file mode 100644index 2ccb1fd..0000000--- a/docs/cs2/3D_Technical_Mapping.json+++ /dev/null@@ -1,207 +0,0 @@-{- "metadata": {- "title": "3D Technical Mapping - CS2 to Three.js",- "version": "1.0.0",- "created": "2026-07-24",- "notebook_id": "30ec3dba-5a20-4980-8886-ce89b506b634",- "sources": [- "Three.js Docs",- "Valve Developer Community",- "CSFloat Blog",- "Steam Community",- "Three.js Forum"- ]- },- "pbr_properties": {- "core": {- "color": {"type": "Color", "default": "0xffffff", "range": null, "effect": "Base surface color", "perf": "low"},- "metalness": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "0=dielectric, 1=metal", "perf": "low"},- "roughness": {"type": "Float", "default": 1.0, "range": [0.0, 1.0], "effect": "0=mirror, 1=matte", "perf": "low"},- "envMapIntensity": {"type": "Float", "default": 1.0, "range": [0.0, null], "effect": "Reflection strength", "perf": "low"},- "flatShading": {"type": "Boolean", "default": false, "effect": "Faceted vs smooth", "perf": "low"},- "side": {"type": "Enum", "default": "FRONT", "effect": "Rendered face(s)", "perf": "low"}- },- "advanced": {- "clearcoat": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Extra glossy layer", "perf": "medium"},- "clearcoatRoughness": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Clearcoat roughness", "perf": "medium"},- "transmission": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Light transmission", "perf": "very_high"},- "thickness": {"type": "Float", "default": 0.0, "range": [0.0, null], "effect": "Absorption thickness", "perf": "high"},- "ior": {"type": "Float", "default": 1.5, "range": [1.0, 2.33], "effect": "Refraction index", "perf": "medium"},- "sheen": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Velvet/fabric effect", "perf": "medium"},- "sheenRoughness": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Sheen roughness", "perf": "medium"},- "sheenColor": {"type": "Color", "default": "0x000000", "effect": "Sheen color tint", "perf": "medium"},- "iridescence": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Thin-film interference", "perf": "high"},- "iridescenceIOR": {"type": "Float", "default": 1.3, "range": [1.0, 3.0], "effect": "Iridescent layer IOR", "perf": "high"},- "iridescenceThicknessRange": {"type": "[min,max]", "default": [100, 400], "effect": "Iridescence thickness", "perf": "high"},- "anisotropy": {"type": "Float", "default": 0.0, "range": [0.0, 1.0], "effect": "Stretched highlights", "perf": "high"},- "anisotropyRotation": {"type": "Float", "default": 0.0, "range": [0, 6.28], "effect": "Anisotropic direction", "perf": "high"},- "attenuationColor": {"type": "Color", "default": "0xffffff", "effect": "Transmission absorption color", "perf": "high"},- "attenuationDistance": {"type": "Float", "default": 0.5, "range": [0.0, null], "effect": "Absorption distance", "perf": "high"}- }- },- "material_presets": {- "polished_metal": {"color": "0xaaaaaa", "metalness": 1.0, "roughness": 0.05, "envMapIntensity": 1.5},- "brushed_steel": {"color": "0x888888", "metalness": 1.0, "roughness": 0.3, "anisotropy": 0.8},- "matte_plastic": {"color": "0x1a1a1a", "metalness": 0.0, "roughness": 0.75, "ior": 1.45},- "gunmetal": {"color": "0x3a3a3a", "metalness": 1.0, "roughness": 0.45, "envMapIntensity": 1.2},- "glass": {"color": "0xffffff", "metalness": 0.0, "roughness": 0.0, "transmission": 1.0, "thickness": 0.5, "ior": 1.5},- "wood": {"color": "0x6f4e37", "metalness": 0.0, "roughness": 0.6, "clearcoat": 0.2},- "fabric": {"color": "0x2d2d2d", "metalness": 0.0, "roughness": 0.9, "sheen": 1.0, "sheenColor": "0xffffff"},- "rubber": {"color": "0x111111", "metalness": 0.0, "roughness": 0.85, "clearcoat": 0.1}- },- "cs2_finish_styles": {- "anodized": {- "metalness": [1.0, 1.0],- "roughness": [0.05, 0.15],- "clearcoat": [0.3, 0.5],- "iridescence": [0.0, 0.2],- "wear_behavior": "Color peels from edges, reveals base metal",- "examples": ["Fade", "Blue Steel"]- },- "anodized_multicolored": {- "metalness": [1.0, 1.0],- "roughness": [0.05, 0.10],- "iridescence": [0.3, 0.5],- "iridescenceIOR": [1.5, 2.0],- "wear_behavior": "Gloss fades, color gradient shifts",- "examples": ["Fade 100%", "Doppler"]- },- "custom_paint_job": {- "metalness": [0.0, 0.0],- "roughness": [0.3, 0.5],- "clearcoat": [0.2, 0.4],- "wear_behavior": "Paint scratches from edges, reveals metal",- "examples": ["Slaughter", "Crimson Web", "Asiimov"]- },- "gunsmith": {- "metalness": [0.7, 0.9],- "roughness": [0.2, 0.4],- "clearcoat": [0.0, 0.1],- "wear_behavior": "Combined paint fading + metal exposure",- "examples": ["Night", "Corticera"]- },- "hydrographic": {- "metalness": [0.0, 0.0],- "roughness": [0.5, 0.7],- "clearcoat": [0.1, 0.2],- "wear_behavior": "Large patches peel, exposes base",- "examples": ["Boreal Forest", "Safari Mesh"]- },- "patina": {- "metalness": [0.9, 1.0],- "roughness": [0.2, 0.4],- "iridescence": [0.3, 0.6],- "wear_behavior": "Color shifts/darkens, oxidation",- "examples": ["Case Hardened", "Blue Steel"]- },- "solid_color": {- "metalness": [0.0, 0.0],- "roughness": [0.3, 0.5],- "clearcoat": [0.2, 0.3],- "wear_behavior": "Scratches reveal metal at edges",- "examples": ["Urban Masked", "Jungle Spray"]- },- "sprayed": {- "metalness": [0.0, 0.0],- "roughness": [0.6, 0.8],- "clearcoat": [0.0, 0.0],- "wear_behavior": "Heavy scratching, base metal visible",- "examples": ["Scorched", "Sand Dune"]- }- },- "wear_tiers": {- "factory_new": {"min": 0.00, "max": 0.07, "abbr": "FN"},- "minimal_wear": {"min": 0.07, "max": 0.15, "abbr": "MW"},- "field_tested": {"min": 0.15, "max": 0.38, "abbr": "FT"},- "well_worn": {"min": 0.38, "max": 0.45, "abbr": "WW"},- "battle_scarred": {"min": 0.45, "max": 1.00, "abbr": "BS"}- },- "knife_components": {- "blade_types": {- "clip_point": {"geometry": "ExtrudeGeometry", "ratio": "1:3.5", "metalness": 1.0, "roughness": 0.15},- "drop_point": {"geometry": "ExtrudeGeometry", "ratio": "1:3", "metalness": 0.9, "roughness": 0.2},- "tanto": {"geometry": "ExtrudeGeometry", "ratio": "1:3", "metalness": 1.0, "roughness": 0.1},- "karambit": {"geometry": "ExtrudeGeometry", "ratio": "1:2", "metalness": 1.0, "roughness": 0.05},- "falchion": {"geometry": "LatheGeometry", "ratio": "1:4", "metalness": 1.0, "roughness": 0.15},- "gut_hook": {"geometry": "ExtrudeGeometry+CSG", "ratio": "1:2.5", "metalness": 1.0, "roughness": 0.3}- },- "handle": {- "tang": {"geometry": "BoxGeometry", "metalness": 1.0, "roughness": 0.4},- "scales": {"geometry": "ExtrudeGeometry", "metalness": 0.0, "roughness": 0.75},- "screws": {"geometry": "CylinderGeometry", "metalness": 1.0, "roughness": 0.35},- "guard": {"geometry": "BoxGeometry", "metalness": 1.0, "roughness": 0.3},- "pommel": {"geometry": "CylinderGeometry", "metalness": 1.0, "roughness": 0.35},- "lanyard": {"geometry": "TorusGeometry", "metalness": 0.0, "roughness": 0.9}- }- },- "pistol_components": {- "slide": {"geometry": "BoxGeometry", "boolean": ["ejection_port", "rail"]},- "frame": {"geometry": "ExtrudeGeometry+Box", "boolean": ["mag_well"]},- "barrel": {"geometry": "CylinderGeometry", "boolean": ["bore"]},- "trigger_guard": {"geometry": "ExtrudeGeometry", "boolean": []},- "magazine": {"geometry": "BoxGeometry", "boolean": ["feed_lips"]},- "sights": {"geometry": "BoxGeometry", "boolean": []},- "grip": {"geometry": "ExtrudeGeometry", "boolean": [], "note": "Use normalMap for texture"}- },- "rifle_components": {- "receiver_upper": {"geometry": "BoxGeometry"},- "receiver_lower": {"geometry": "BoxGeometry"},- "barrel": {"geometry": "CylinderGeometry"},- "handguard": {"geometry": "BoxGeometry/CylinderGeometry"},- "stock": {"geometry": "BoxGeometry"},- "magazine": {"geometry": "BoxGeometry"},- "pistol_grip": {"geometry": "ExtrudeGeometry"},- "scope": {"geometry": "TubeGeometry+SphereGeometry"},- "muzzle": {"geometry": "CylinderGeometry"}- },- "spatial_wear_glossary": {- "core_industry_terms": {- "surface_imperfections": {"en": "Surface Imperfections", "def": "Microscopic variations (fingerprints, micro-scratches) that break uniform reflections."},- "weathering_aging": {"en": "Weathering / Aging", "def": "Surface degradation from environmental exposure over time."},- "wear_and_tear": {"en": "Wear and Tear", "def": "Physical damage from active use or friction."},- "edge_wear": {"en": "Edge Wear", "def": "Damage concentrated along sharp corners or high-exposure edges."},- "procedural_grunge": {"en": "Procedural Grunge", "def": "Algorithmically generated dirt distributed via AO or curvature masks."}- },- "damage_types_pbr_impact": {- "oxidation_rust_patina": {- "en": "Oxidation / Rust / Patina",-- "albedo": "Orange-brown or dark-green shift",- "roughness": {"range": [0.8, 1.0], "impact": "Increases significantly"},- "metalness": {"range": [0.0, 0.0], "impact": "Drops to 0 (Dielectric oxide)"},- "normal_height": "Adds high-frequency pitting and scaling"- },- "scratches_dents": {- "en": "Scratches / Dents",-- "albedo": "Exposes base silver/grey metal",- "roughness": {"range": [0.1, 0.2], "impact": "Decreases at center (shiny base)"},- "metalness": {"range": [1.0, 1.0], "impact": "Increases if paint is scraped"},- "normal_height": "Sharp linear indentations"- },- "smudges_fingerprints": {- "en": "Smudges / Fingerprints",-- "albedo": "Negligible change",- "roughness": {"range": [0.4, 0.6], "impact": "Localized increase (oily layer)"},- "metalness": {"range": [null, null], "impact": "Unchanged"},- "normal_height": "Unchanged"- },- "dust_dirt_mud": {- "en": "Dust / Dirt / Mud",-- "albedo": "Matches environment (tan/brown/grey)",- "roughness": {"range": [0.9, 1.0], "impact": "Becomes completely rough"},- "metalness": {"range": [0.0, 0.0], "impact": "Drops to 0 (Non-metallic soil)"},- "normal_height": "Smooths micro-structures or adds thick volume"- }- },- "spatial_modifiers": {- "tip_to_spine_gradient": {"en": "Tip-to-spine gradient"},- "edge_heavy": {"en": "Edge-heavy wear"},- "friction_point": {"en": "Friction-point wear"},- "speckled": {"en": "Speckled"},- "exposed_core": {"en": "Exposed core"}- }- }-}diff --git a/docs/cs2/3D_Technical_Reference.md b/docs/cs2/3D_Technical_Reference.mddeleted file mode 100644index 6208164..0000000--- a/docs/cs2/3D_Technical_Reference.md+++ /dev/null@@ -1,685 +0,0 @@-# 3D Technical Reference — CS2 to Three.js Mapping-# Từ điển Kỹ thuật 3D — Mapping CS2 sang Three.js--> NotebookLM Research ID: `30ec3dba-5a20-4980-8886-ce89b506b634`-> Last updated: July 2026-------## Table of Contents--1. [PBR Property Map](#1-pbr-property-map)-2. [Material Preset Recipes](#2-material-preset-recipes)-3. [CS2 Finish Styles → PBR Profiles](#3-cs2-finish-styles--pbr-profiles)-4. [Wear System Bridge](#4-wear-system-bridge)-5. [Component Recipe Database](#5-component-recipe-database)-6. [Vocabulary Glossary](#6-vocabulary-glossary)-------## 1. PBR Property Map--MeshPhysicalMaterial properties with Three.js bindings, value ranges, and performance cost.--### Core Properties--| Property | Type | Default | Range | Visual Effect | Perf Cost |-|----------|------|---------|-------|---------------|-----------|-| `color` | Color | `0xffffff` | — | Base surface color (Albedo) | Low |-| `metalness` | Float | `0.0` | 0.0–1.0 | 0=dielectric (plastic, wood), 1=metal | Low |-| `roughness` | Float | `1.0` | 0.0–1.0 | 0=mirror-smooth, 1=completely rough/matte | Low |-| `envMapIntensity` | Float | `1.0` | 0.0–∞ | Strength of environment map reflections | Low |-| `flatShading` | Boolean | `false` | — | Faceted vs smooth shading | Low |-| `side` | Enum | `FRONT` | — | FRONT, BACK, DOUBLE sided rendering | Low |--### Advanced Properties--| Property | Type | Default | Range | Visual Effect | Perf Cost |-|----------|------|---------|-------|---------------|-----------|-| `clearcoat` | Float | `0.0` | 0.0–1.0 | Extra glossy layer on top (car paint effect) | Medium |-| `clearcoatRoughness` | Float | `0.0` | 0.0–1.0 | Roughness of the clearcoat layer | Medium |-| `transmission` | Float | `0.0` | 0.0–1.0 | Physical light transmission (NOT opacity) | **Very High** |-| `thickness` | Float | `0.0` | 0.0–∞ | Thickness for transmission absorption | High |-| `ior` | Float | `1.5` | 1.0–2.33 | Index of Refraction — light bending angle | Medium |-| `sheen` | Float | `0.0` | 0.0–1.0 | Soft back-scatter (velvet/fabric effect) | Medium |-| `sheenRoughness` | Float | `0.0` | 0.0–1.0 | Roughness of sheen layer | Medium |-| `sheenColor` | Color | `0x000000` | — | Color tint of sheen effect | Medium |-| `iridescence` | Float | `0.0` | 0.0–1.0 | Thin-film interference (oil slick, soap bubble) | High |-| `iridescenceIOR` | Float | `1.3` | 1.0–3.0 | IOR of the iridescent layer | High |-| `iridescenceThicknessRange` | [min,max] | `[100,400]` | nm | Thickness range for iridescence | High |-| `anisotropy` | Float | `0.0` | 0.0–1.0 | Stretched highlights (brushed metal, CD) | High |-| `anisotropyRotation` | Float | `0.0` | 0–2π | Direction of anisotropic highlights (radians) | High |-| `attenuationColor` | Color | `0xffffff` | — | Color absorption in transmission | High |-| `attenuationDistance` | Float | `0.5` | 0.0–∞ | Distance for color absorption | High |--### Code: Property Reference--```typescript-// Basic PBR-const basic = new THREE.MeshPhysicalMaterial({- color: 0xaaaaaa,- metalness: 1.0,- roughness: 0.05,-});--// Clearcoat (car paint, lacquered wood)-const clearcoat = new THREE.MeshPhysicalMaterial({- color: 0x222222,- metalness: 0.9,- roughness: 0.3,- clearcoat: 1.0,- clearcoatRoughness: 0.1,-});--// Transmission (glass, crystal)-const glass = new THREE.MeshPhysicalMaterial({- color: 0xffffff,- metalness: 0.0,- roughness: 0.0,- transmission: 1.0,- thickness: 0.5,- ior: 1.5,-});--// Sheen (fabric, velvet)-const fabric = new THREE.MeshPhysicalMaterial({- color: 0x334455,- metalness: 0.0,- roughness: 0.9,- sheen: 1.0,- sheenRoughness: 0.3,- sheenColor: 0xffffff,-});--// Iridescence (patina, oil slick)-const iridescent = new THREE.MeshPhysicalMaterial({- color: 0x445566,- metalness: 1.0,- roughness: 0.2,- iridescence: 0.5,- iridescenceIOR: 1.3,- iridescenceThicknessRange: [100, 400],-});--// Anisotropy (brushed steel)-const brushed = new THREE.MeshPhysicalMaterial({- color: 0x888888,- metalness: 1.0,- roughness: 0.3,- anisotropy: 0.8,- anisotropyRotation: Math.PI / 4,-});-```-------## 2. Material Preset Recipes--Quick-copy recipes for common materials in CS2 items.--### Polished Metal (Chrome, New Steel)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0xaaaaaa,- metalness: 1.0,- roughness: 0.05,- envMapIntensity: 1.5,-});-```--### Brushed Steel (Satin Finish)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x888888,- metalness: 1.0,- roughness: 0.3,- anisotropy: 0.8,- anisotropyRotation: Math.PI / 4,-});-```--### Matte Plastic (G10 Handle, Polymer)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x1a1a1a,- metalness: 0.0,- roughness: 0.75,- ior: 1.45,-});-```--### Gunmetal (Dark Steel, Blued)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x3a3a3a,- metalness: 1.0,- roughness: 0.45,- envMapIntensity: 1.2,-});-```--### Glass (Scope Lens, Sight)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0xffffff,- metalness: 0.0,- roughness: 0.0,- transmission: 1.0,- thickness: 0.5,- ior: 1.5,-});-```--### Wood (Rifle Stock, Handle Scale)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x6f4e37,- metalness: 0.0,- roughness: 0.6,- clearcoat: 0.2, // Light varnish- clearcoatRoughness: 0.3,-});-```--### Fabric (Paracord, Lanyard, Grip Tape)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x2d2d2d,- metalness: 0.0,- roughness: 0.9,- sheen: 1.0,- sheenRoughness: 0.3,- sheenColor: 0xffffff,-});-```--### Rubber (Grip, Bumper)--```typescript-new THREE.MeshPhysicalMaterial({- color: 0x111111,- metalness: 0.0,- roughness: 0.85,- clearcoat: 0.1,-});-```-------## 3. CS2 Finish Styles → PBR Profiles--How each CS2 finish style maps to Three.js material properties.--### Anodized--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 1.0 | Full metallic |-| roughness | 0.05–0.15 | Very smooth, mirror-like |-| clearcoat | 0.3–0.5 | Protective glossy layer |-| iridescence | 0.0–0.2 | Slight color shift at angles |-| color | Tinted (varies) | Blue, gold, red, etc. |--**Wear behavior**: Color coating peels from edges, revealing base metal underneath.-**Examples**: Fade, Blue Steel, Case Hardened (anodized variant)--```typescript-// Anodized Blue-new THREE.MeshPhysicalMaterial({- color: 0x2244aa,- metalness: 1.0,- roughness: 0.08,- clearcoat: 0.4,- clearcoatRoughness: 0.05,-});-```--### Anodized Multicolored--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 1.0 | Full metallic |-| roughness | 0.05–0.10 | Ultra smooth |-| iridescence | 0.3–0.5 | Strong multi-color shift |-| iridescenceIOR | 1.5–2.0 | Higher IOR = more color |--**Wear behavior**: Gloss fades before base metal shows. Color gradient shifts with wear.-**Examples**: Fade (100%), Doppler (all phases)--```typescript-// Anodized Multicolored (Fade)-new THREE.MeshPhysicalMaterial({- color: 0xff6600,- metalness: 1.0,- roughness: 0.05,- iridescence: 0.4,- iridescenceIOR: 1.8,- iridescenceThicknessRange: [100, 500],-});-```--### Custom Paint Job--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.0 | Non-metallic (painted over) |-| roughness | 0.3–0.5 | Semi-gloss paint |-| clearcoat | 0.2–0.4 | Protective clear coat |-| clearcoatRoughness | 0.1–0.2 | Smooth clear coat |--**Wear behavior**: Paint scratches from edges and high-friction areas, revealing metal.-**Examples**: Slaughter, Crimson Web, Asiimov, Hyper Beast--```typescript-// Custom Paint Job (Asiimov)-new THREE.MeshPhysicalMaterial({- map: asiimovTexture, // Custom paint texture- metalness: 0.0,- roughness: 0.4,- clearcoat: 0.3,- clearcoatRoughness: 0.15,-});-```--### Gunsmith--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.7–0.9 | Mostly metallic |-| roughness | 0.2–0.4 | Moderate roughness |-| clearcoat | 0.0–0.1 | Minimal clear coat |--**Wear behavior**: Combined paint fading + metal exposure. Chemical treatment look.-**Examples**: Night, Corticera, Guardian--```typescript-// Gunsmith-new THREE.MeshPhysicalMaterial({- color: 0x333344,- metalness: 0.8,- roughness: 0.3,- envMapIntensity: 1.0,-});-```--### Hydrographic--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.0 | Non-metallic (film transfer) |-| roughness | 0.5–0.7 | Matte to semi-gloss |-| clearcoat | 0.1–0.2 | Light protective layer |--**Wear behavior**: Large patches peel off, exposing base material.-**Examples**: Boreal Forest, Safari Mesh, Arctic Wolf--```typescript-// Hydrographic (Boreal Forest)-new THREE.MeshPhysicalMaterial({- map: borealTexture, // Camo pattern texture- metalness: 0.0,- roughness: 0.6,- clearcoat: 0.15,-});-```--### Patina--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.9–1.0 | Full metallic |-| roughness | 0.2–0.4 | Moderate |-| iridescence | 0.3–0.6 | Color-shifting oxidation |-| iridescenceIOR | 1.3–1.5 | Subtle color |--**Wear behavior**: Color changes (darkens/shifts) rather than peeling. Oxidation effect.-**Examples**: Case Hardened, Blue Steel, Damascus Steel--```typescript-// Patina (Case Hardened / Blue Gem)-new THREE.MeshPhysicalMaterial({- color: 0x667788,- metalness: 1.0,- roughness: 0.25,- iridescence: 0.5,- iridescenceIOR: 1.4,- envMapIntensity: 1.3,-});-```--### Solid Color--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.0 | Non-metallic |-| roughness | 0.3–0.5 | Semi-gloss |-| clearcoat | 0.2–0.3 | Protective layer |--**Wear behavior**: Scratches reveal underlying metal at edges.-**Examples**: Urban Masked, Jungle Spray--```typescript-// Solid Color-new THREE.MeshPhysicalMaterial({- color: 0x556633,- metalness: 0.0,- roughness: 0.4,- clearcoat: 0.25,-});-```--### Sprayed--| Property | Value | Notes |-|----------|-------|-------|-| metalness | 0.0 | Non-metallic |-| roughness | 0.6–0.8 | Rough, uneven |-| clearcoat | 0.0 | No clear coat |--**Wear behavior**: Heavy scratching, base metal clearly visible at edges.-**Examples**: Scorched, Sand Dune, Dragon Lore (Spray variant)--```typescript-// Sprayed-new THREE.MeshPhysicalMaterial({- map: sprayTexture,- metalness: 0.0,- roughness: 0.7,- clearcoat: 0.0,-});-```-------## 4. Wear System Bridge--How CS2 Float Value translates to Three.js shader parameters.--### Float Value → Visual Effect Mapping--| Wear Tier | Float Range | Visual Characteristics |-|-----------|-------------|----------------------|-| Factory New (FN) | 0.00–0.07 | Pristine. Almost no visible wear. |-| Minimal Wear (MW) | 0.07–0.15 | Minor scratches at edges. Very clean. |-| Field-Tested (FT) | 0.15–0.38 | Noticeable scratches, fading at edges. |-| Well-Worn (WW) | 0.38–0.45 | Significant wear, paint loss. |-| Battle-Scarred (BS) | 0.45–1.00 | Heavy damage, deep scratches, large blemishes. |--### Per-Skin Float Clipping--CS2 restricts float ranges per skin via `wear_remap_min` / `wear_remap_max` in `items_game.txt`:--```json-{- "wear_remap_min": 0.00,- "wear_remap_max": 0.80-}-```--This means a skin with `wear_remap_max: 0.80` can NEVER reach Battle-Scarred (0.45+).--### Three.js Wear Implementation--#### Approach 1: Texture Layer Blending (Recommended)--```typescript-// Wear as uniform parameter-const material = new THREE.ShaderMaterial({- uniforms: {- baseColorMap: { value: baseTexture },- wearMap: { value: wearTexture },- normalMap: { value: normalTexture },- wearNormalMap: { value: wearNormalTexture },- float: { value: 0.223 }, // The item's float value- roughnessClean: { value: 0.3 },- roughnessWorn: { value: 0.7 },- },- vertexShader: `...`,- fragmentShader: `- uniform sampler2D baseColorMap;- uniform sampler2D wearMap;- uniform float float;- varying vec2 vUv;-- void main() {- vec4 clean = texture2D(baseColorMap, vUv);- vec4 worn = texture2D(wearMap, vUv);-- // Wear alpha: 0 at edges, 1 in center- // Float value controls blend- float wearAlpha = smoothstep(0.0, 0.5, float);-- vec4 color = mix(clean, worn, wearAlpha);- gl_FragColor = color;- }- `,-});-```--#### Approach 2: Vertex-Based Wear Zones--```typescript-// Store wear sensitivity per vertex-const wearAttribute = new THREE.BufferAttribute(- new Float32Array(vertexCount),- 1-);--// 0.0 = protected (won't wear), 1.0 = high wear (edges, corners)-geometry.setAttribute('wearSensitivity', wearAttribute);--// In shader: multiply wear sensitivity with float value-```--#### Approach 3: Three.js Built-in Blending--```typescript-// For simple wear without custom shaders-const material = new THREE.MeshPhysicalMaterial({- map: baseColorTexture,- roughnessMap: wearRoughnessTexture, // Rougher where worn- metalnessMap: wearMetalnessTexture, // More metallic where paint removed- normalMap: combinedNormalTexture, // Scratch normals- metalness: 0.0, // Base: non-metallic (painted)- roughness: 0.4, // Base: semi-gloss-});-```--### Paint Channels (RGB Masks)--CS2 uses RGB channels to control different wear behaviors:--| Channel | Controls | Three.js Mapping |-|---------|----------|------------------|-| Red | Wear position (edges first) | Alpha mask for base→worn blend |-| Green | Roughness variation | RoughnessMap intensity |-| Blue | Color tint / pattern offset | Color modulation |--### Spatial Wear & Damage Glossary--#### 1. Core Industry Terms (Thuật Ngữ Cốt Lõi)--| EN Term | VI Term | Definition & 3D Application | Practical Example |-| :--- | :--- | :--- | :--- |-| **Surface Imperfections** | **Khuyết điểm bề mặt** | Microscopic surface variations that break up uniform specular reflections. Essential for photorealism. | Fingerprints on glass, dust layers on screens, micro-scratches on polished metal. |-| **Weathering / Aging** | **Phong hóa / Lão hóa** | Surface degradation caused by environmental exposure (rain, temperature, sunlight) over time. | Oxidation on metals (rust/patina), sun-fading on paint, moss growth on damp grips. |-| **Wear and Tear** | **Hao mòn sử dụng** | Physical damage from human handling or operational friction. | Blunted knife tips, hand-worn glossy grips, paint peeling on high-friction weapon parts. |-| **Edge Wear** | **Mòn cạnh viền** | Damage concentrated along the sharp boundaries, corners, or protrusions of a model. | Paint scraping off along the slide edges of a Glock or the guard corners of a Bowie knife. |-| **Procedural Grunge** | **Cáu bẩn thuật toán** | Procedurally generated grime or dirt, often mask-blended using Ambient Occlusion (AO) or curvature. | Dust settling in recessed grooves, gun grease building up in hard-to-clean weapon crevices. |--#### 2. Detailed Classification & PBR Map Impact--| Damage Type | Albedo (Color) Impact | Roughness Map Impact | Metalness Map Impact | Normal/Height Map Impact |-| :--- | :--- | :--- | :--- | :--- |-| **Oxidation / Rust / Patina** | Shifts to orange-brown (rust) or dark-green (patina). | Increases significantly (0.8 - 1.0) due to dry, rough microfacets. | Drops to 0.0 (conductive metal turns into non-conductive oxide). | Adds high-frequency noise, pitting, and scaling surface volume. |-| **Scratches / Dents** | Exposes base metal underneath (usually light grey/silver). | Decreases at scratch center (reveals shiny substrate); increases at scratch lip. | Increases to 1.0 at scratch center if painted coating is scraped off. | Creates sharp, linear indentations or local coordinate normals. |-| **Smudges / Fingerprints** | Negligible change. | Localized increases (0.4 - 0.6) where natural body oils distort reflections. | Unchanged. | Unchanged. |-| **Dust / Dirt / Mud** | Matches environmental soil colors (tan, brown, grey). | Becomes completely rough and diffuse (0.9 - 1.0). | Drops to 0.0 (non-metallic soil coating). | Smooths out micro-structures (dust) or adds thick volumes (caked mud). |--#### 3. Spatial Modifiers--| EN Term | VI Term | Definition |-| :--- | :--- | :--- |-| **Tip-to-spine gradient** | **Gradient từ mũi đến sống dao** | Damage concentration decreases gradually from the tip towards the mid-body. |-| **Edge-heavy wear** | **Mòn tập trung ở cạnh** | Scratches or paint loss occurring exclusively along high-exposure outer edges. |-| **Friction-point wear** | **Mòn điểm ma sát** | Concentrated wear at mechanical contact points (magazine slides, knife locks). |-| **Speckled / Spotted** | **Dạng đốm** | Scattered, point-like occurrences of rust or paint chipping. |-| **Exposed core** | **Lộ lõi** | Complete removal of an outer layer, showing the raw underlying material. |--#### 4. Technical Shader Representation (Three.js TSL)--To describe complex damage distributions (e.g. "Rust covering 50% from tip to spine"), use spatial coordinates and noise mixers in your shader logic:--```javascript-import { Fn, uv, smoothstep, mix, color, float, noise } from 'three/tsl';--const wearLogic = Fn(({ baseColor, rustColor, uvCoord, floatVal }) => {- // 1. Gradient Mask: Rust 50% from tip (uv.y = 0.0) to spine (uv.y = 0.5)- const gradientMask = smoothstep(float(0.0), float(0.5), uv().y);-- // 2. Add Stochastic Noise to prevent flat gradients- const noiseMask = noise(uv().multiply(10.0));- const finalMask = mix(gradientMask, noiseMask, float(0.2));-- // 3. Blend PBR parameters based on mask- const finalAlbedo = mix(baseColor, rustColor, finalMask);- const finalRoughness = mix(float(0.2), float(0.9), finalMask); // Polish to Rust- const finalMetalness = mix(float(1.0), float(0.0), finalMask); // Metal to Oxide-- return { finalAlbedo, finalRoughness, finalMetalness };-});-```---### CS2 → Three.js Wear Pipeline--```-Float Value (0.000-1.000)- │- ├─→ wear_remap_min/max (per-skin clamp)- │ │- │ └─→ Clamped float for this item- │- ├─→ RGB Wear Mask- │ ├─→ Red: Base→Worn alpha blend- │ ├─→ Green: Roughness modulation- │ └─→ Blue: Color desaturation- │- └─→ Shader Uniforms- ├─→ float: Wear amount (0-1)- ├─→ roughnessClean: Starting roughness- ├─→ roughnessWorn: Ending roughness- └─→ metalnessWorn: Exposed metal metalness-```-------## 5. Component Recipe Database--### Knife Components--#### Blade Types--| Type | Three.js Geometry | Proportions (W:L) | PBR (Metal/Rough) | Notes |-|------|-------------------|-------------------|-------------------|-------|-| Clip-point | `ExtrudeGeometry` | 1:3.5 | 1.0 / 0.15 | Notch cutout at tip |-| Drop-point | `ExtrudeGeometry` | 1:3 | 0.9 / 0.2 | Smooth spine curve |-| Tanto | `ExtrudeGeometry` | 1:3 | 1.0 / 0.1 | Angular chisel tip |-| Karambit | `ExtrudeGeometry` | 1:2 (curved) | 1.0 / 0.05 | Extreme curve |-| Falchion | `LatheGeometry` / `Extrude` | 1:4 | 1.0 / 0.15 | Wide, slightly curved |-| Gut Hook | `Extrude` + CSG `Subtract` | 1:2.5 | 1.0 / 0.3 | Hook via boolean |--#### Handle Construction--| Part | Geometry | PBR | Notes |-|------|----------|-----|-------|-| Tang Frame | `BoxGeometry` | Metal 1.0 / 0.4 | Structural core |-| Scales (×2) | `ExtrudeGeometry` | Non-metal 0.0 / 0.75 | G10, Micarta, Wood |-| Screws (×4) | `CylinderGeometry` | Metal 1.0 / 0.35 | Phillips head |-| Guard | `BoxGeometry` | Metal 1.0 / 0.3 | Cross guard or none |-| Pommel | `CylinderGeometry` | Metal 1.0 / 0.35 | End cap |-| Lanyard | `TorusGeometry` | Non-metal 0.0 / 0.9 | Paracord loop |--### Pistol Components--| Part | Geometry | Proportions | Boolean Ops |-|------|----------|-------------|-------------|-| Slide | `BoxGeometry` | 1:0.3:4 | Subtract: ejection port, rail |-| Frame | `ExtrudeGeometry` + `Box` | Complex | Union: grip; Subtract: mag well |-| Barrel | `CylinderGeometry` | r:0.05, L:5 | Subtract: inner bore |-| Trigger Guard | `ExtrudeGeometry` | Thin arc | Union: to frame |-| Magazine | `BoxGeometry` | 0.8:0.2:2.5 | Subtract: feed lips |-| Sights (×2) | `BoxGeometry` | Small | Union: to slide |-| Grip Texture | Normal map | — | NOT geometry |--### Rifle Components (AK-47, M4, AWP)--| Part | Geometry | Notes |-|------|----------|-------|-| Receiver (Upper) | `BoxGeometry` | Main body, rails on top |-| Receiver (Lower) | `BoxGeometry` | Trigger group, mag well |-| Barrel | `CylinderGeometry` | Long cylinder, fluting optional |-| Handguard | `BoxGeometry` / `CylinderGeometry` | Rail system, M-LOK slots |-| Stock | `BoxGeometry` | Fixed, folding, or collapsible |-| Magazine | `BoxGeometry` | Curved (AK) or straight (M4) |-| Pistol Grip | `ExtrudeGeometry` | Ergonomic profile |-| Scope (AWP) | `TubeGeometry` + `SphereGeometry` | Cylinder + lens halves |-| Muzzle Device | `CylinderGeometry` | Flash hider or suppressor |-| Bolt Carrier | `BoxGeometry` | Visible in ejection port |--### Boolean Operations Guide--| Operation | Library | Use Case |-|-----------|---------|----------|-| Subtract | `three-bvh-csg` | Holes, cutouts, slots, ejection ports |-| Union | `three-bvh-csg` | Merging components (frame + grip) |-| Intersect | `three-bvh-csg` | Complex shape intersections |--### Edge Treatment--| Zone | Treatment | How |-|------|-----------|-----|-| Cutting edge | Hard crease | `geometry.computeVertexNormals()` + manual normal adjustment |-| Spine-to-plate | Hard edge | Split vertices at seam |-| Sawback teeth | All hard | No smoothing groups |-| Guard corners | Hard | BoxGeometry naturally hard |-| Handle scales | Smooth | Subdivision or smooth normals |-| Grip checkering | Normal map | NOT geometry |-------## 6. Vocabulary Glossary--See `3D_Vocabulary_CS2_Dictionary.md` for the full bilingual (EN/VI) glossary covering:--1. **Core 3D Modeling** — Vertex, Edge, Face, Mesh, Topology, Primitives-2. **UV Mapping & Texturing** — UV Coordinates, Texture Maps, Mipmapping-3. **PBR Materials** — PBR Workflow, Metalness, Roughness, Fresnel-4. **CS2 Specific** — Skin System, Wear System, Pattern System, Economy-5. **3D File Formats** — OBJ, FBX, glTF, MDL, VTF, VMT-6. **Animation & Rigging** — Skeleton, Bones, IK/FK, Morph Targets-7. **Rendering & Optimization** — Draw Calls, LOD, Batching-8. **Three.js / Web 3D** — Scene, Camera, Materials, Geometry-9. **CS2 Workshop** — Submission pipeline, QC requirements-------## Sources--- Three.js MeshPhysicalMaterial documentation-- CS2 Workshop Tools (Valve Developer Community)-- CSFloat Blog: Float Values Technical Deep Dive-- Steam Community Workshop guides-- Three.js community discussions-- CS2 skin finish style documentation-------*Generated via NotebookLM research — notebook ID: `30ec3dba-5a20-4980-8886-ce89b506b634`*diff --git a/docs/cs2/3D_Vocabulary_CS2.json b/docs/cs2/3D_Vocabulary_CS2.jsondeleted file mode 100644index c3dcf45..0000000--- a/docs/cs2/3D_Vocabulary_CS2.json+++ /dev/null@@ -1,170 +0,0 @@-{- "metadata": {- "title": "3D Technical Vocabulary - CS2 Items Dictionary",- "version": "1.0.0",- "created": "2026-07-24",- "sources": ["Valve Developer Community", "CS2 Workshop Docs", "Three.js Docs", "Blender Manual", "Meshy Docs"]- },- "categories": {- "core_3d_modeling": {- "name": "Core 3D Modeling",- "terms": {- "vertex": {"en": "Vertex", "def": "A point in 3D space with X, Y, Z coordinates"},- "edge": {"en": "Edge", "def": "A line connecting two vertices"},- "face": {"en": "Face", "def": "A flat surface enclosed by 3+ edges"},- "polygon": {"en": "Polygon", "def": "Generic term for a face (triangles, quads)"},- "triangle": {"en": "Triangle (Tris)", "def": "A 3-sided polygon"},- "quad": {"en": "Quad", "def": "A 4-sided polygon, preferred for clean topology"},- "n_gon": {"en": "N-gon", "def": "Polygon with 5+ sides, generally avoided"},- "mesh": {"en": "Mesh", "def": "Complete geometric structure of a 3D object"},- "topology": {"en": "Topology", "def": "Arrangement and flow of polygons on mesh surface"},- "edge_loop": {"en": "Edge Loop", "def": "Continuous ring of edges flowing around mesh"},- "retopology": {"en": "Retopology", "def": "Redrawing mesh with cleaner topology"},- "high_poly": {"en": "High-Poly", "def": "Mesh with many polygons for detail"},- "low_poly": {"en": "Low-Poly", "def": "Mesh with few polygons, optimized for real-time"},- "buffer_geometry": {"en": "BufferGeometry", "def": "Three.js class for custom geometry"}- }- },- "uv_mapping": {- "name": "UV Mapping & Texturing",- "terms": {- "uv_mapping": {"en": "UV Mapping", "def": "Unwrapping 3D surface onto 2D plane for textures"},- "uv_coordinates": {"en": "UV Coordinates", "def": "2D coordinates mapping texture to surface"},- "uv_seam": {"en": "UV Seam", "def": "Edges where UV map is cut for flattening"},- "diffuse_map": {"en": "Diffuse/Albedo Map", "def": "Base color texture without lighting"},- "normal_map": {"en": "Normal Map", "def": "RGB texture simulating surface bumps"},- "roughness_map": {"en": "Roughness Map", "def": "Controls surface smoothness (0=smooth, 1=rough)"},- "metallic_map": {"en": "Metallic Map", "def": "Defines metallic vs non-metallic areas"},- "ao_map": {"en": "Ambient Occlusion", "def": "Shows areas where ambient light is blocked"},- "displacement_map": {"en": "Displacement Map", "def": "Actually moves vertices for real detail"},- "emission_map": {"en": "Emission Map", "def": "Defines which parts emit light"},- "mipmapping": {"en": "Mipmapping", "def": "Pre-calculated lower-res texture copies"}- }- },- "pbr_materials": {- "name": "PBR Materials",- "terms": {- "pbr": {"en": "PBR (Physically Based Rendering)", "def": "Rendering simulating real-world light interaction"},- "metallic_roughness": {"en": "Metallic/Roughness Workflow", "def": "PBR workflow using Base Color + Metallic + Roughness"},- "specular_glossiness": {"en": "Specular/Glossiness Workflow", "def": "Alternative PBR workflow"},- "base_color": {"en": "Base Color", "def": "Fundamental surface color without lighting"},- "metalness": {"en": "Metalness", "def": "0=dielectric, 1=metal"},- "roughness": {"en": "Roughness", "def": "0=mirror-smooth, 1=completely rough"},- "fresnel": {"en": "Fresnel", "def": "Reflectivity increases at grazing angles"},- "energy_conservation": {"en": "Energy Conservation", "def": "Reflected light cannot exceed incoming light"}- }- },- "cs2_specific": {- "name": "CS2 Specific Terminology",- "terms": {- "skin": {"en": "Skin", "def": "Cosmetic finish changing weapon appearance"},- "paint_kit": {"en": "Paint Kit", "def": "Complete texture set defining skin appearance"},- "float_value": {"en": "Float Value", "def": "Decimal 0.000-1.000 determining wear"},- "factory_new": {"en": "Factory New (FN)", "def": "Float 0.00-0.07, pristine condition"},- "minimal_wear": {"en": "Minimal Wear (MW)", "def": "Float 0.07-0.15, minor scratches"},- "field_tested": {"en": "Field-Tested (FT)", "def": "Float 0.15-0.38, noticeable wear"},- "well_worn": {"en": "Well-Worn (WW)", "def": "Float 0.38-0.45, significant wear"},- "battle_scarred": {"en": "Battle-Scarred (BS)", "def": "Float 0.45-1.00, heavy damage"},- "pattern_index": {"en": "Pattern Index", "def": "Integer 0-1000 controlling texture slice"},- "blue_gem": {"en": "Blue Gem", "def": "Rare Case Hardened pattern, mostly blue"},- "fade_percentage": {"en": "Fade Percentage", "def": "Color gradient visibility on Fade skins"},- "doppler_phase": {"en": "Doppler Phase", "def": "Color variations in Doppler skins"},- "stattrak": {"en": "StatTrak™", "def": "Kill counter variant, ~10% drop rate"},- "souvenir": {"en": "Souvenir", "def": "Major tournament exclusive with stickers"},- "sticker": {"en": "Sticker", "def": "Cosmetic item applied to weapons"},- "sticker_craft": {"en": "Sticker Craft", "def": "Combination of skin with applied stickers"},- "wear_remap": {"en": "Float Clipping", "def": "Per-skin float range restriction"}- }- },- "file_formats": {- "name": "3D File Formats",- "terms": {- "obj": {"en": "OBJ", "def": "Simple text format for geometry, no animation"},- "fbx": {"en": "FBX", "def": "Autodesk format, primary game engine exchange"},- "gltf_glb": {"en": "glTF/GLB", "def": "Open web standard, GLB is binary version"},- "stl": {"en": "STL", "def": "Geometry-only, standard for 3D printing"},- "mdl": {"en": "MDL", "def": "Valve's model format for Source engine"},- "vtf": {"en": "VTF", "def": "Valve Texture Format"},- "vmt": {"en": "VMT", "def": "Valve Material Type definition"},- "items_game": {"en": "items_game.txt", "def": "CS2 config defining all item properties"}- }- },- "animation_rigging": {- "name": "Animation & Rigging",- "terms": {- "skeleton": {"en": "Skeleton", "def": "Hierarchical bone structure for deformation"},- "bone": {"en": "Bone", "def": "Individual element in skeleton hierarchy"},- "rigging": {"en": "Rigging", "def": "Creating and binding skeleton to mesh"},- "weight_painting": {"en": "Weight Painting", "def": "Defining bone influence on vertices"},- "keyframe": {"en": "Keyframe Animation", "def": "Animation defined by specific poses at times"},- "ik": {"en": "Inverse Kinematics (IK)", "def": "Calculate joints from end position"},- "fk": {"en": "Forward Kinematics (FK)", "def": "Set rotations from root to tip"},- "morph_targets": {"en": "Morph Targets", "def": "Pre-defined vertex positions for blending"},- "skinned_mesh": {"en": "SkinnedMesh", "def": "Three.js mesh deformable by skeleton"}- }- },- "rendering_optimization": {- "name": "Rendering & Optimization",- "terms": {- "draw_call": {"en": "Draw Call", "def": "Single CPU→GPU command to render"},- "batching": {"en": "Batching", "def": "Combining objects into fewer draw calls"},- "instancing": {"en": "Instancing", "def": "Rendering many copies with one draw call"},- "lod": {"en": "Level of Detail (LOD)", "def": "Lower-poly models at distance"},- "polygon_budget": {"en": "Polygon Budget", "def": "Max polygons allowed for object/scene"},- "occlusion_culling": {"en": "Occlusion Culling", "def": "Not rendering hidden objects"},- "frustum_culling": {"en": "Frustum Culling", "def": "Not rendering objects outside view"}- }- },- "threejs_web3d": {- "name": "Three.js / Web 3D",- "terms": {- "webgl": {"en": "WebGL", "def": "JavaScript API for hardware-accelerated 3D"},- "scene": {"en": "Scene", "def": "Container for all 3D objects"},- "camera": {"en": "Camera", "def": "Defines the viewpoint"},- "renderer": {"en": "Renderer", "def": "Converts scene to pixels"},- "mesh_standard": {"en": "MeshStandardMaterial", "def": "PBR material, most realistic"},- "mesh_phong": {"en": "MeshPhongMaterial", "def": "Simpler, faster for mobile"},- "gltf_loader": {"en": "GLTFLoader", "def": "Loads glTF/GLB files"},- "instanced_mesh": {"en": "InstancedMesh", "def": "Many copies with one draw call"}- }- },- "cs2_workshop": {- "name": "CS2 Workshop Workflow",- "terms": {- "workshop_submission": {"en": "Workshop Submission", "def": "Submitting custom skins to CS2"},- "substance_painter": {"en": "Substance Painter", "def": "Industry-standard texture painting tool"},- "source_2": {"en": "Source 2", "def": "Valve's game engine for CS2"},- "tri_count": {"en": "Tri Count", "def": "Total triangle count of weapon model"},- "paint_pattern": {"en": "Paint Pattern", "def": "2D texture projected onto 3D via UV"},- "wear_overlay": {"en": "Wear Overlay", "def": "Texture adding damage based on float"},- "material_proxy": {"en": "Material Proxy", "def": "Dynamic parameter changes based on state"}- }- }- },- "cs2_wear_ranges": {- "factory_new": {"min": 0.00, "max": 0.07, "abbreviation": "FN"},- "minimal_wear": {"min": 0.07, "max": 0.15, "abbreviation": "MW"},- "field_tested": {"min": 0.15, "max": 0.38, "abbreviation": "FT"},- "well_worn": {"min": 0.38, "max": 0.45, "abbreviation": "WW"},- "battle_scarred": {"min": 0.45, "max": 1.00, "abbreviation": "BS"}- },- "cs2_rarity_grades": [- {"grade": "Consumer Grade", "color": "white"},- {"grade": "Industrial Grade", "color": "light blue"},- {"grade": "Mil-Spec", "color": "blue"},- {"grade": "Restricted", "color": "purple"},- {"grade": "Classified", "color": "pink"},- {"grade": "Covert", "color": "red"},- {"grade": "Contraband", "color": "gold"}- ],- "cs2_finish_styles": [- "Anodized",- "Anodized Multicolored",- "Custom Paint Job",- "Gunsmith",- "Hydrographic",- "Patina",- "Solid Color",- "Sprayed"- ]-}diff --git a/docs/cs2/3D_Vocabulary_CS2_Dictionary.md b/docs/cs2/3D_Vocabulary_CS2_Dictionary.mddeleted file mode 100644index b5770f5..0000000--- a/docs/cs2/3D_Vocabulary_CS2_Dictionary.md+++ /dev/null@@ -1,438 +0,0 @@-# 3D Technical Vocabulary Dictionary - CS2 Items Focus-# Từ điển Thuật ngữ Kỹ thuật 3D - Tập trung vào CS2 Items-------## Table of Contents / Mục lục-1. [Core 3D Modeling](#1-core-3d-modeling)-2. [UV Mapping & Texturing](#2-uv-mapping--texturing)-3. [PBR Materials](#3-pbr-materials)-4. [CS2 Specific Terminology](#4-cs2-specific-terminology)-5. [3D File Formats](#5-3d-file-formats)-6. [Animation & Rigging](#6-animation--rigging)-7. [Rendering & Optimization](#7-rendering--optimization)-8. [Three.js / Web 3D](#8-threejs--web-3d)-9. [CS2 Workshop Workflow](#9-cs2-workshop-workflow)-------## 1. Core 3D Modeling--### Geometry & Mesh--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Vertex (Vertices)** | Đỉnh | A point in 3D space with X, Y, Z coordinates. The fundamental building block of all 3D geometry. |-| **Edge** | Cạnh | A line connecting two vertices. Defines the boundaries of faces. |-| **Face** | Mặt | A flat surface enclosed by 3 or more edges. Can be triangles, quads, or n-gons. |-| **Polygon** | Đa giác | Generic term for a face. Usually refers to triangles (tris) or quads in modeling. |-| **Triangle (Tris)** | Tam giác | A 3-sided polygon. GPU renders everything as triangles ultimately. |-| **Quad** | Tứ giác | A 4-sided polygon. Preferred for clean topology and subdivision. |-| **N-gon** | N-cạnh | A polygon with 5+ sides. Generally avoided in animation meshes. |-| **Mesh** | Lưới | The complete geometric structure of a 3D object, consisting of vertices, edges, and faces. |-| **Geometry** | Hình học | The mathematical representation of shape and form in 3D space. |-| **Wireframe** | Khung dây | Display mode showing only edges and vertices without filled faces. |--### Topology & Structure--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Topology** | Cấu trúc | The arrangement and flow of polygons on a mesh surface. Clean topology = even quads following surface contours. |-| **Edge Loop** | Vòng cạnh | A continuous ring of edges that flows around a mesh. Critical for deformation and animation. |-| **Edge Flow** | Dòng cạnh | The directional pattern of edges across a surface. Guides how mesh deforms. |-| **Retopology** | Tái cấu trúc | Redrawing a mesh with cleaner, lower-poly topology. Often done on sculpted high-poly models. |-| **Subdivision Surface** | Mặt phụ division | Algorithm that smooths a mesh by recursively subdividing faces. Used to create smooth surfaces from low-poly control cages. |-| **High-Poly** | Đa giác cao | A mesh with many polygons, used for detail sculpting or baking. |-| **Low-Poly** | Đa giác thấp | A mesh with few polygons, optimized for real-time rendering. |-| **Base Mesh** | Mesh cơ bản | Low-resolution starting mesh for sculpting or modeling. |-| **NURBS** | NURBS | Non-Uniform Rational B-Splines. Mathematical surface representation used in CAD/product design for smooth curves. |-| **Watertight Mesh** | Mesh kín | A closed mesh with no holes. Required for 3D printing and some physics simulations. |--### Primitives--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Primitive** | Khối cơ bản | Basic geometric shapes: Cube, Sphere, Cylinder, Cone, Plane, Torus. Starting points for modeling. |-| **BufferGeometry** | BufferGeometry | Three.js class for defining custom geometry with vertex attributes (positions, normals, UVs). |-------## 2. UV Mapping & Texturing--### UV Concepts--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **UV Mapping** | Ánh xạ UV | The process of unwrapping a 3D surface onto a 2D plane for texture application. |-| **UV Coordinates** | Tọa độ UV | 2D coordinates (U horizontal, V vertical) that map texture pixels to 3D surface points. |-| **UV Unwrap** | Mở phẳng UV | The act of flattening a 3D mesh surface into 2D space. |-| **UV Seam** | Đường may UV | Edges where the UV map is cut to allow flattening. Visible as texture seams if not placed carefully. |-| **UV Layout** | Bố cục UV | The arrangement of UV islands in texture space. |-| **Texel Density** | Mật độ texel | The amount of texture resolution per unit of 3D surface area. |--### Texture Maps--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Diffuse/Albedo Map** | Bản đồ màu cơ sở | Base color texture without lighting information. The "paint" of the surface. |-| **Normal Map** | Bản đồ normal | RGB texture that simulates surface bumps by altering surface normals. Adds detail without geometry. |-| **Bump Map** | Bản đồ gồ ghề | Grayscale texture that simulates height variation. Less precise than normal maps. |-| **Displacement Map** | Bản đồ dịch chuyển | Grayscale texture that actually moves vertices to create real geometry detail. |-| **Specular Map** | Bản đồ phản chiếu | Defines intensity and color of specular highlights on a surface. |-| **Roughness Map** | Bản đồ thô | Grayscale map controlling surface smoothness. Black = smooth/glossy, White = rough/matte. |-| **Metallic Map** | Bản đồ kim loại | Defines which parts are metallic (white) vs dielectric/non-metallic (black). |-| **Ambient Occlusion (AO)** | Che sáng môi trường | Grayscale map showing areas where ambient light is blocked by geometry. Adds depth. |-| **Emission Map** | Bản đồ phát sáng | Texture defining which parts of a surface emit light/glow. |-| **Opacity/Alpha Map** | Bản đồ trong suốt | Grayscale map controlling transparency. White = opaque, Black = transparent. |-| **Height Map** | Bản đồ chiều cao | Grayscale map representing surface elevation for displacement. |-| **Cavity Map** | Bản đồ hang | Highlights small surface crevices and edges for added detail. |--### Texture Settings--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Texture Resolution** | Độ phân giải texture | Pixel dimensions of a texture (e.g., 1024x1024, 2048x2048). Usually power-of-two. |-| **Power-of-Two** | Lũy thừa của 2 | Texture dimensions that are powers of 2 (256, 512, 1024, 2048, 4096). Required for mipmapping. |-| **Mipmapping** | Mipmap | Pre-calculated lower-resolution copies of a texture. Improves quality and performance at distance. |-| **Texture Filtering** | Lọc texture | How textures are sampled: Nearest (pixelated), Bilinear, Trilinear, Anisotropic. |-| **Tiling** | Lặp | Repeating a texture across a surface. |-| **Texture Atlas** | Bảng texture | Combining multiple textures into one image for efficiency. |-------## 3. PBR Materials--### PBR Workflows--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **PBR (Physically Based Rendering)** | Render dựa trên vật lý | Rendering approach that simulates real-world light interaction for realistic materials. |-| **Metallic/Roughness Workflow** | Quy trình Kim loại/Thô | PBR workflow using Base Color + Metallic + Roughness maps. Most common in games. |-| **Specular/Glossiness Workflow** | Quy trình Phản chiếu/Bóng | PBR workflow using Diffuse + Specular + Glossiness maps. Alternative to Metallic/Roughness. |-| **Base Color** | Màu cơ bản | The fundamental color of a surface without lighting effects. |-| **Metalness** | Độ kim loại | 0-1 value: 0 = dielectric (plastic, wood), 1 = metal (gold, iron). |-| **Roughness** | Độ thô | 0-1 value: 0 = mirror-smooth, 1 = completely rough/matte. |-| **Fresnel** | Fresnel | Effect where reflectivity increases at grazing angles. Essential for realistic materials. |-| **Microfacet** | Vi mặt | Tiny surface irregularities that determine roughness and reflection behavior. |-| **Energy Conservation** | Bảo toàn năng lượng | Principle that reflected light cannot exceed incoming light. Core PBR concept. |--### PBR in Games--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Material** | Vật liệu | A set of texture maps and parameters defining how a surface looks and responds to light. |-| **Shader** | Trình xử lýshader | Program that runs on GPU to calculate final pixel color based on material properties. |-| **Albedo** | Albedo | Base color without any lighting contribution. The pure "color" of the surface. |-| **Dielectric** | Chất điện môi | Non-metallic material. Has specular reflections but no colored reflections. |-------## 4. CS2 Specific Terminology--### Skin System--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Skin** | Da súng / Skin | A cosmetic finish applied to a weapon, changing its appearance without affecting gameplay. |-| **Paint Kit** | Bộ sơn | The complete texture set defining a skin's visual appearance. Contains multiple texture layers. |-| **Finish** | Hoàn thiện / Finish | The final visual style of a skin (e.g., Anodized, Gunsmith, Hydrographic). |-| **Finish Style** | Kiểu finish | Categories of paint application: Anodized, Anodized Multicolored, Custom Paint Job, Gunsmith, Hydrographic, Patina, Solid Color, Sprayed. |--### Wear System--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Float Value** | Giá trị float | A 32-bit decimal (0.000-1.000) assigned at drop time. Determines wear appearance. Lower = cleaner. |-| **Wear Rating** | Đánh giá mòn | The visible condition category based on float ranges. |-| **Factory New (FN)** | Mới từ nhà máy | Float 0.00-0.07. Pristine condition with almost no visible wear. |-| **Minimal Wear (MW)** | Mòn tối thiểu | Float 0.07-0.15. Minor scratches, very clean appearance. |-| **Field-Tested (FT)** | Đã thử nghiệm | Float 0.15-0.38. Noticeable scratches and blemishes. Mid-range condition. |-| **Well-Worn (WW)** | Mòn nhiều | Float 0.38-0.45. Significant wear, fading, scratches. |-| **Battle-Scarred (BS)** | Chiến tích | Float 0.45-1.00. Heavy damage, deep scratches, large blemishes. |-| **Float Clipping** | Cắt float | Per-skin restriction on which float values are possible. Defined by wear_remap_min/max in items_game.txt. |--### Pattern System--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Pattern Index (Paint Seed)** | Chỉ mẫu (Màu sơn) | Integer (0-1000) assigned at drop. Controls which slice of texture atlas is visible. |-| **Pattern Seed** | Hạt giống mẫu | Same as Pattern Index. Determines texture placement variation. |-| **Template ID** | ID mẫu | Identifier for specific pattern variations in certain finishes. |-| **Blue Gem** | Đá xanh | Rare Case Hardened pattern with predominantly blue color on playside. Extremely valuable. |-| **Fade Percentage** | Phần trăm Fade | Percentage of color gradient visible on Fade skins. Higher % = more colors = more valuable. |-| **Doppler Phase** | Giai đoạn Doppler | Different color variations in Doppler skins (Phase 1-4, Ruby, Sapphire, Black Pearl, etc.). |-| **Playside** | Mặt nhìn | The side of the weapon visible to the player in first-person view. Most important for value. |-| **Backside** | Mặt sau | The opposite side of the weapon from playside. |--### Special Items--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **StatTrak™** | StatTrak™ | Special variant with kill counter. Drops at ~10% rate. Premium 20-100% over normal. |-| **Souvenir** | Hàng lưu niệm | Exclusive drops from Major tournaments with pre-applied tournament stickers. Supply permanently capped. |-| **Sticker** | Tem / Sticker | Cosmetic item applied to weapons. Types: Paper, Holo, Foil, Gold. |-| **Sticker Craft** | Bộ tem | The combination of a skin with applied stickers. Position and condition matter for value. |-| **Sticker Slot** | Khe tem | Fixed positions on weapons where stickers can be applied (typically 4 slots). |-| **Scrape Level** | Mức cào | Sticker degradation: 100% → 75% → 50% → 25%. Affects value significantly. |-| **Name Tag** | Thẻ tên | Item that lets you rename a weapon. Cosmetic only. |-| **Charm** | Charms | Decorative items that hang from weapons. |-| **Collection** | Bộ sưu tập | Groups of skins that drop together. Some collections are discontinued, increasing rarity. |--### CS2 Economy Terms--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Market Hash Name** | Tên hash thị trường | Exact name Steam uses for listing (e.g., "StatTrak™ AK-47 | Redline (Field-Tested)"). |-| **Paint Index** | Chỉ số sơn | Numeric ID for a specific finish + variant (e.g., 415 = Doppler Ruby). |-| **Rarity Grade** | Phân loại hiếm | Item rarity: Consumer Grade → Industrial Grade → Mil-Spec → Restricted → Classified → Covert → Contraband. |-| **Exterior** | Ngoại quan | The wear tier label shown in inventory (FN, MW, FT, WW, BS). |-| **Inspect Link** | Liên kết kiểm tra | Steam URL that reveals float, pattern, and sticker details for an item. |-| **Game Coordinator (GC)** | Điều phối trò chơi | CS2's internal item server that provides item data to trading sites. |-| **Trade-Up Contract** | Hợp đồng nâng cấp | Combining 10 items of same rarity to receive 1 item of next higher rarity. Float is averaged. |-------## 5. 3D File Formats--### Exchange Formats--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **OBJ** | OBJ | Wavefront OBJ. Simple text-based format for geometry + normals + UVs. No animation. |-| **FBX** | FBX | Autodesk Filmbox. Primary exchange format for game engines. Supports geometry, animation, materials. |-| **glTF/GLB** | glTF/GLB | Graphics Language Transmission Format. Open standard for 3D on web. GLB = binary version. |-| **STL** | STL | Stereolithography. Geometry-only format. Standard for 3D printing. |-| **PLY** | PLY | Stanford Polygon File Format. Often used for scanned point cloud data. |-| **USDZ** | USDZ | Apple's AR format for Quick Look and Reality Composer. |--### Game-Specific Formats--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **MDL** | MDL | Valve's model format for Source/Source 2 engine. |-| **VTF** | VTF | Valve Texture Format. Native texture format for Source engine. |-| **VMT** | VMT | Valve Material Type. Defines material properties in Source engine. |-| **VMF** | VMF | Valve Map Format. Source engine map editor format. |-| ** items_game.txt** | items_game.txt | CS2 configuration file defining all item properties, paint kits, wear ranges. |--### Format Comparison--| Format | Geometry | Animation | Materials | Web | Games | 3D Print |-|--------|----------|-----------|-----------|-----|-------|----------|-| OBJ | ✅ | ❌ | Limited | ✅ | ⚠️ | ✅ |-| FBX | ✅ | ✅ | ✅ | ⚠️ | ✅ | ❌ |-| glTF/GLB | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |-| STL | ✅ | ❌ | ❌ | ⚠️ | ❌ | ✅ |-| MDL | ✅ | ✅ | ✅ | ❌ | ✅ (Source) | ❌ |-------## 6. Animation & Rigging--### Skeletal Animation--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Skeleton** | Bộ xương | Hierarchical structure of bones that deforms a mesh. |-| **Bone** | Xương | Individual element in a skeleton hierarchy. Has position, rotation, and parent-child relationships. |-| **Joint** | Khớp | Connection point between bones. Defines pivot points for rotation. |-| **Rigging** | Rigging / Cấp xương | The process of creating and binding a skeleton to a mesh for animation. |-| **Weight Painting** | Vẽ trọng số | Defining how much each bone influences surrounding vertices. Controls deformation quality. |-| **Skinning** | Phủ da | Binding mesh vertices to skeleton bones with weighted influences. |--### Animation Types--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Keyframe Animation** | Hoạt hình khoá khung | Animation defined by specific poses at specific times, interpolated in between. |-| **Procedural Animation** | Hoạt hình theo thủ tục | Animation generated by code/algorithms rather than manual keyframes. |-| **Motion Capture (Mocap)** | Bắt chuyển động | Recording real-world movement to drive digital skeleton. |-| **Inverse Kinematics (IK)** | Động học nghịch đảo | Calculating joint rotations from end-effector position. Used for feet/ground contact. |-| **Forward Kinematics (FK)** | Động học thuận | Setting joint rotations from root to tip. Standard bone manipulation. |-| **Blend Shapes / Morph Targets** | Hình dạng lai / Mục tiêu biến đổi | Pre-defined vertex positions that can be blended between. Used for facial expressions, damage states. |--### Three.js Animation--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **AnimationClip** | AnimationClip | A reusable animation containing keyframe tracks for multiple properties. |-| **AnimationMixer** | AnimationMixer | Controls playback and blending of AnimationClips on a model. |-| **SkinnedMesh** | SkinnedMesh | Three.js mesh that can be deformed by a skeleton. |-------## 7. Rendering & Optimization--### Rendering Concepts--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Draw Call** | Lệnh vẽ | A single command from CPU to GPU to render something. Too many draw calls = performance hit. |-| **Batching** | Gộp | Combining multiple objects into fewer draw calls for efficiency. |-| **Instancing** | Thực thể hóa | Rendering many copies of same mesh with one draw call. Each instance can have unique transforms/colors. |-| **GPU** | GPU | Graphics Processing Unit. Hardware that executes rendering calculations in parallel. |-| **Shader** | Shader | Program that runs on GPU to calculate vertex positions and pixel colors. |-| **Vertex Shader** | Vertex Shader | Runs per-vertex. Transforms positions from model space to screen space. |-| **Fragment/Pixel Shader** | Fragment/Pixel Shader | Runs per-pixel. Calculates final color based on materials, lights, textures. |-| **Render Pipeline** | Pipeline render | The sequence of steps from 3D scene to 2D screen output. |--### Optimization--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **LOD (Level of Detail)** | Chi tiết cấp độ | Using lower-poly models at distance. Reduces GPU load without visible quality loss. |-| **Polygon Budget** | Ngân sách đa giác | Maximum number of polygons allowed for an object/scene. |-| **Occlusion Culling** | Loại trừ che khuất | Not rendering objects hidden behind other objects. |-| **Frustum Culling** | Loại trừ ngoài khung hình | Not rendering objects outside camera's view frustum. |-| **Draw Call Batching** | Gộp lệnh vẽ | Merging static objects into fewer draw calls. |-| **Texture Atlasing** | Đóng gói texture atlas | Combining textures to reduce material switches and draw calls. |-------## 8. Three.js / Web 3D--### Core Concepts--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **WebGL** | WebGL | Web Graphics Library. JavaScript API for hardware-accelerated 3D rendering in browsers. |-| **Scene** | Cảnh | Container for all 3D objects, lights, and cameras in Three.js. |-| **Camera** | Máy ảnh | Defines the viewpoint. Types: PerspectiveCamera (realistic), OrthographicCamera (2D-style). |-| **Renderer** | Bộ kết xuất | Converts Three.js scene to pixels on screen. WebGLRenderer is most common. |-| **Mesh** | Mesh | A 3D object combining geometry (shape) and material (appearance). |-| **Group** | Nhóm | Container for organizing multiple meshes/objects with shared transforms. |-| **Light** | Ánh sáng | Illumination sources. Types: AmbientLight, DirectionalLight, PointLight, SpotLight. |--### Three.js Materials--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **MeshStandardMaterial** | MeshStandardMaterial | PBR material using Metallic/Roughness workflow. Most realistic. |-| **MeshPhongMaterial** | MeshPhongMaterial | Simpler, faster material. Good for mobile/low-end devices. |-| **MeshBasicMaterial** | MeshBasicMaterial | Unlit material. No light interaction. Fastest rendering. |-| **ShaderMaterial** | ShaderMaterial | Custom material using GLSL vertex/fragment shaders. Full control. |-| **RawShaderMaterial** | RawShaderMaterial | ShaderMaterial with no built-in uniforms/attributes. Complete shader authoring. |-| **MeshLambertMaterial** | MeshLambertMaterial | Simple diffuse material. Faster than Phong but less realistic. |--### Three.js Geometry--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **BufferGeometry** | BufferGeometry | Core geometry class. Stores vertex data in typed arrays (positions, normals, UVs). |-| **BoxGeometry** | BoxGeometry | Creates a box/cube shape. |-| **SphereGeometry** | SphereGeometry | Creates a sphere shape. |-| **CylinderGeometry** | CylinderGeometry | Creates a cylinder shape. |-| **PlaneGeometry** | PlaneGeometry | Creates a flat 2D plane in 3D space. |-| **TorusGeometry** | TorusGeometry | Creates a donut/torus shape. |-| **ExtrudeGeometry** | ExtrudeGeometry | Creates 3D shape by extruding a 2D path. |-| **LatheGeometry** | LatheGeometry | Creates shape by rotating a profile around an axis. |--### Loaders & Export--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **GLTFLoader** | GLTFLoader | Loads glTF/GLB files into Three.js scenes. |-| **FBXLoader** | FBXLoader | Loads FBX files. |-| **OBJLoader** | OBJLoader | Loads OBJ files. |-| **TextureLoader** | TextureLoader | Loads image files as textures. |-| **GLTFExporter** | GLTFExporter | Exports Three.js scene to glTF/GLB format. |--### Performance--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **InstancedMesh** | InstancedMesh | Renders many copies of same geometry with one draw call. |-| **Frustum Culling** | Frustum Culling | Automatic Three.js optimization to skip objects outside camera view. |-| **Level of Detail (LOD)** | LOD | Three.js class that shows different detail levels based on camera distance. |-| **Morph Targets** | Morph Targets | Vertex-based animation stored in geometry. Used for facial expressions. |-------## 9. CS2 Workshop Workflow--### Creation Pipeline--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Workshop Submission** | Gửi lên Workshop | Process of submitting custom skins to CS2 for community voting. |-| **Substance Painter** | Substance Painter | Industry-standard texture painting tool. Primary tool for CS2 skin creation. |-| **Substance Designer** | Substance Designer | Node-based material creation tool. Used for procedural textures. |-| **Source 2** | Source 2 | Valve's game engine powering CS2. |-| **Source 2 Hammer** | Hammer | Level/asset editor for Source 2 engine. |-| **Workshop Tools** | Công cụ Workshop | Official Valve tools for creating CS2 workshop content. |-| **Workshop Preview** | Xem trước Workshop | How your skin appears in the workshop voting interface. |--### Material System--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **VMT (Valve Material Type)** | VMT | Material definition file in Source engine. Defines shaders, textures, and parameters. |-| **VTF (Valve Texture Format)** | VTF | Native texture format for Source engine. Converted from PNG/TGA. |-| **Material Proxy** | Proxy vật liệu | Dynamic material parameter changes based on game state (e.g., wear animation). |-| **Phong Shading** | Shading Phong | Legacy shading model in Source engine. Still used for some CS2 materials. |-| **PBR Material (Source 2)** | Vật liệu PBR | Modern material system in Source 2. Uses metallic/roughness workflow. |--### Workshop Requirements--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **Tri Count** | Số tam giác | Total triangle count of weapon model. Must meet Valve's limits. |-| **Texture Resolution** | Độ phân giải texture | Required texture sizes (typically 2048x2048 or 1024x1024). |-| **Normal Map** | Bản đồ Normal | Required for surface detail without extra geometry. |-| **AO Map** | Bản đồ AO | Ambient Occlusion map for added depth. |-| **Material Parameters** | Tham số vật liệu | Configurable values in VMT/shader (color, wear amount, pattern offset, etc.). |-| **Paint Pattern** | Mẫu sơn | The 2D texture pattern that gets projected onto the 3D model via UV mapping. |-| **Wear Overlay** | Lớp phủ mòn | Texture layer that adds scratches, fading, and damage based on float value. |--### File Structure--| English Term | Vietnamese | Definition |-|--------------|------------|------------|-| **QC File** | File QC | Model compilation script defining mesh, skeleton, sequences. |-| **DMX** | DMX | Data Model eXchange format. Source 2 model format. |-| **VCS** | VCS | Version Control System integration for Workshop tools. |-| **Workshop ID** | ID Workshop | Unique identifier for your submitted item. |-| **Tags** | Thẻ | Category labels for workshop items (e.g., Weapon, Knife, gloves). |-------## Quick Reference: CS2 Item Identification--A CS2 skin is uniquely identified by:-1. **Skin Name** - e.g., "AK-47 Asiimov"-2. **Exterior/Wear Tier** - FN, MW, FT, WW, BS-3. **StatTrak/Souvenir Flag** - Normal, StatTrak, or Souvenir-4. **Float Value** - Exact decimal (e.g., 0.2234)-5. **Pattern Index** - Integer seed (e.g., 661 for blue gem)--Two items with the same name can have different values based on float, pattern, stickers, and StatTrak status.-------## Glossary of Acronyms--| Acronym | Full Form | Vietnamese |-|---------|-----------|------------|-| PBR | Physically Based Rendering | Render dựa trên vật lý |-| UV | Ultraviolet (texture coordinates) | Tọa độ kết cấu |-| LOD | Level of Detail | Chi tiết cấp độ |-| AO | Ambient Occlusion | Che sáng môi trường |-| FN | Factory New | Mới từ nhà máy |-| MW | Minimal Wear | Mòn tối thiểu |-| FT | Field-Tested | Đã thử nghiệm |-| WW | Well-Worn | Mòn nhiều |-| BS | Battle-Scarred | Chiến tích |-| GLB/glTF | Graphics Language Transmission Format | Định dạng truyền ngôn ngữ đồ họa |-| FBX | Filmbox | Filmbox |-| OBJ | Wavefront OBJ | Wavefront OBJ |-| STL | Stereolithography | Mô hình hóa cứng |-| VMT | Valve Material Type | Loại vật liệu Valve |-| VTF | Valve Texture Format | Định dạng kết cấu Valve |-| IK | Inverse Kinematics | Động học nghịch đảo |-| FK | Forward Kinematics | Động học thuận |-| GPU | Graphics Processing Unit | Đồ họa đơn vị xử lý |-------*Last updated: July 2026*-*Sources: Valve Developer Community, CS2 Workshop Documentation, Three.js Documentation, Blender Manual, Meshy Docs*diff --git a/docs/cs2/distill.md b/docs/cs2/distill.mddeleted file mode 100644index 477d7f9..0000000--- a/docs/cs2/distill.md+++ /dev/null@@ -1,210 +0,0 @@-# CS2 Research Distill — Consolidated Findings from 13 NotebookLM Sessions--> Sources: 13 notebooks, ~130 sources total-> Generated: 2026-07-24-> Notebook IDs: 3302413b, 7b0376c6, ed67e020, 8430ab72, e20b3968, f783b110, 7b0376c6, 3302413b, 3a1c3eb9, 3957b5dc, e9c7dbee, 370faecc, ee512cf3-------## 1. Knife Anatomy — Actionable Geometry Rules--| Knife Type | Signature Geometry | Three.js Primitive | Critical Detail |-|---|---|---|---|-| **Karambit** | Concave Hawkbill blade + Safety Ring at pommel | `ExtrudeGeometry` (curved profile) | Ring diameter ≈ 20mm, finger hole |-| **Bowie** | Massive Clip-point + brass crossguard | `ExtrudeGeometry` + `BoxGeometry` (guard) | Clip notch depth ≈ 15% blade length |-| **Skeleton Knife** | Full tang with large index finger hole, tape wrap | `ExtrudeGeometry` (perforated) | Hole diameter ≈ 18mm |-| **Balisong** | Two handles + pivot pins + stop pin + latch | `CylinderGeometry` (pins) | Pivot pin is rotation axis; detent ball holds blade closed |-| **M9 Bayonet** | Clip-point + sawback serrations (11 teeth) | `ExtrudeGeometry` + `BoxGeometry` ×11 | Tooth spacing ≈ 14mm, depth ≈ 15mm |--### Universal Knife Details (from all anatomy notebooks)-- **Jimping**: Notches on spine for thumb traction → Normal map, NOT geometry-- **Choil**: Notch near heel for sharpening → Small boolean subtract-- **Handle Belly**: Swell curving outward from centerline for palm grip-- **Tang types**: Full tang (visible at handle edges), Hidden tang (rat-tail), Skeletonized tang-- **Handle materials**: G10 (roughness 0.75), Micarta (0.7), Wood (0.6, clearcoat 0.2), Paracord wrap (roughness 0.9)-------## 2. Pistol Anatomy — Key Technical Findings--### Mechanism Differences (Critical for animation)-| Pistol | Mechanism | Key Components |-|---|---|---|-| **Desert Eagle** | Gas-operated, rotating bolt | Piston, 3-lug bolt, polygonal rifling |-| **Tec-9** | Blowback | Tubular bolt inside steel-stamped upper receiver |-| **Glock/USP** | Striker-fired | No external hammer, polymer frame |-| **R8 Revolver** | Double-action | 8-shot cylinder, ejector rod, cylinder release latch |--### Material Mapping-- **Polymer frames** (Glock, P250, Tec-9): `metalness: 0.0, roughness: 0.75`-- **Steel slides/barrels**: `metalness: 1.0, roughness: 0.3`-- **Picatinny rails**: Standard 7/8" spacing → Box geometry with boolean slots-- **Threaded barrels**: For suppressor attachment → Cylinder with helical thread normal-------## 3. Rifle/SMG/Sniper Key Details--### AK-47 vs M4A4 vs AWP-| Component | AK-47 | M4A4 | AWP |-|---|---|---|---|-| Receiver | Stamped steel, curved magazine | Forged aluminum, straight mag | Bolt-action, massive receiver |-| Handguard | Wooden/polymer, ventilated holes | M-LOK rail system | Minimal, barrel exposed |-| Stock | Fixed wood/polymer | Collapsible (6 positions) | Adjustable cheek rest |-| Magazine | 30-rd curved | 30-rd straight | 5-rd box |--### SMG Specifics-- **MP5**: Roller-delayed blowback, slim handguard, drum mag option-- **P90**: Bullpup, top-mounted magazine, 50-rd capacity-- **PP-Bizon**: Helical magazine under barrel-------## 4. PBR Properties — Strict CS2 Ranges--### Binary Metalness Rule (CRITICAL)-> **CS2 uses a strict two-bit metalness model**: surfaces are either `0.0` (dielectric: wood, polymer, fabric) or `1.0` (conductive: steel, gold, chrome). Intermediate values cause lighting artifacts.--### Albedo Ranges-| Material | Albedo RGB Range | Metalness | Roughness |-|---|---|---|---|-| **Dielectric (polymer)** | [30, 240] per channel | 0.0 | 0.4–0.8 |-| **Conductive (steel)** | [180, 255] per channel | 1.0 | 0.2–0.5 |-| **Chrome/Anodized** | [180, 255] | 1.0 | 0.05–0.15 |-| **Patina (Case Hardened)** | [100, 200] | 0.80–0.95 | 0.20–0.35 |--### Environment Requirements-- **HDR cubemap** mandatory for anodized/chrome finishes-- `renderer.toneMapping = THREE.ACESFilmicToneMapping`-- `.colorSpace = THREE.SRGBColorSpace` for albedo/emissive maps-- `NoColorSpace` for normalMap, roughnessMap, metalnessMap-------## 5. Finish Styles — Technical Recipes--| Finish | Metalness | Roughness | Key Property | Wear Behavior |-|---|---|---|---|---|-| **Anodized** | 0.90–1.00 | 0.05–0.15 | `envMapIntensity: 1.5–2.5` | Color peels from edges |-| **Anodized Multicolored** | 0.90–1.00 | 0.03–0.10 | Iridescence + noise ramp | Gloss fades, gradient shifts |-| **Custom Paint Job** | 0.0 | 0.3–0.5 | `clearcoat: 0.2–0.4` | Paint scratches from edges |-| **Hydrographic** | 0.0 | 0.5–0.7 | Dip-film swirl print | Large patches peel |-| **Patina** | 0.80–0.95 | 0.20–0.35 | Iridescence 0.3–0.6 | Color shifts, not peeling |-| **Gunsmith** | 0.7–0.9 | 0.2–0.4 | Patina + paint blend | Combined fading |-| **Solid Color** | 0.0 | 0.3–0.5 | `clearcoat: 0.2–0.3` | Scratches at edges |-| **Sprayed** | 0.0 | 0.6–0.8 | No clearcoat | Heavy base metal exposure |-------## 6. Wear System — Shader Implementation--### Float Value → Visual Mapping-| Tier | Range | Roughness Delta | Metalness Delta | Albedo Shift |-|---|---|---|---|---|-| FN | 0.00–0.07 | +0.0 | +0.0 | None |-| MW | 0.07–0.15 | +0.1 | +0.05 | Slight darkening at edges |-| FT | 0.15–0.38 | +0.2 | +0.15 | Noticeable fading |-| WW | 0.38–0.45 | +0.3 | +0.3 | Significant desaturation |-| BS | 0.45–1.00 | +0.5 | +0.5 | Heavy oxidation appearance |--### Geometric-Driven Wear Masks-- **Convex curvature map** → concentrates scratches on sharp outer edges-- **Ambient Occlusion (AO)** → protects recesses from peeling; accumulates grime/dark oxidation-- **Paint Seed deterministic transform**: `A = T₂ × R × S × T₁` (centered translation → base scale → rotation → correction translation)-------## 7. Pattern System — Technical Details--### Paint Seed / Pattern Index-- Integer 0–999, initialized at drop time-- Controls UV offset via deterministic affine matrix-- **Fade**: Gradient sequence Yellow → Orange → Pink → Purple; percentage = how much gradient visible from tip-- **Doppler**: Fixed indices (#415 Ruby, #416 Sapphire, #417 Black Pearl); iridescent reflections via 3D noise color-ramp lookup-- **Case Hardened**: Randomized charcoal-heated look; Blue Gem = mostly blue on playside (rare patterns exist in database)--### UV Mapping Rules for CS2-- Asymmetrical UV: playside gets larger UV island for higher detail-- LOD0 mesh required for inspect/viewmodel (maximum polygon density)-- UV scale formula: for Hydrographic/Anodized Multicolored → `s = weapon_length × 0.027777778`-------## 8. Attachments & Special Items--### StatTrak™-- **On firearms**: Independent mesh module (ST_counter) with **orange LED emissive** (`#FF4500`)-- **On knives**: Dynamic tangent-space bump map procedurally engraves kill count into blade-- Drop rate: ~10% of normal drops--### Stickers-- Max 5 slots per weapon-- Parameters: `offset_x`, `offset_y` (float32), `rotation` (0–360°), `scale`-- Wear formula: `Base_Wear × (1.0 - (α_channel × UnWearStrength))`-- Scrape levels: 100% → 75% → 50% → 25%--### Charms-- Independent 3D mesh, attached via skeletal spring-joint-- Physics: spring-damper `τ = -kθ - cω` for swing motion-- Clasp bone attachment point-------## 9. 3D Reconstruction Pipeline Insights--### Channel Packing (Source 2 → Three.js)-- Roughness + Metalness packed in single texture (R + G channels)-- Must unpack in shader: `roughness = texture2D(rmMap, uv).g; metalness = texture2D(rmMap, uv).b;`--### Structured Image Description Protocol (from 370faecc)-1. **Observation before inference** — state observable facts separately from inferences-2. **Controlled vocabulary** — use 3D terms, never "nice/sleek/aggressive"-3. **3D object-space, not 2D image-space** — describe by front/back/lateral/proximal-4. **Structural decomposition**: Macro → Meso → Micro-5. **Visual Triplets**: Subject-Predicate-Object for spatial relationships-6. **Single-image limits** — explicitly state what's occluded/hidden/uncertain--### 3D Types Taxonomy (from ee512cf3)-- **PBR workflow**: Albedo + Normal + Roughness + Metallic + AO-- **UV efficiency target**: 85–95%-- **Texel density**: 512–1024 px/m for hero assets-- **Web optimization**: glTF/GLB format, Draco compression (90–95% reduction), KTX2 for textures-- **LOD chains**: 50% reduction per level-- **Collision mesh**: Simplified primitives (`cdt_` prefix)-------## 10. Texture Extraction Pipeline (from 3a1c3eb9)--### CSGO-API Metadata-- `weapon_id`, `paint_index`, `min_float`, `max_float` from ByMykel/CSGO-API-- CDN image URL for reference screenshots--### Valve Texture Format-- VTF → PNG conversion via Source2Viewer-CLI-- Channel packing: Roughness (R) + Metalness (G) in single file-- Must tangle channels for Three.js MeshPhysicalMaterial--### Legal Note-- Extracted textures are Valve IP — stay in local `cs2_textures/` workspace-- Never commit or redistribute-- "Extractive use" doctrine may apply for personal/research use-------## 11. CS2 Detection Signals (for detect_cs2.py)--Visual markers that identify a CS2 weapon/item from a 2D image:--| Signal | Weight | Detection Method |-|---|---|---|-| **Weapon silhouette** (blade, rifle, pistol shape) | High | Aspect ratio + contour analysis |-| **CS2 skin patterns** (Doppler gradient, Fade, Crimson Web) | High | Color distribution + pattern recognition |-| **Steam Workshop aesthetics** (clean render, white/grey background) | Medium | Background color histogram |-| **StatTrak™ module** (orange LED counter) | High | Small emissive orange rectangle |-| **CS2-specific wear patterns** (edge wear on blade, patina on receiver) | Medium | Edge contrast analysis |-| **Knife guard/handle construction** (crossguard, tang, pommel) | Medium | Component decomposition |-------*Distilled from 13 NotebookLM sessions covering: knives (3302413b), pistols (7b0376c6), rifles (ed67e020), heavy (8430ab72), snipers (e20b3968), SMGs (f783b110), gloves (d353b31a), texture extraction (3a1c3eb9), item attributes (3957b5dc), skin specs (e9c7dbee), image description (370faecc), 3D taxonomy (ee512cf3), and current session (30ec3dba).*diff --git a/docs/cs2/review-gates.md b/docs/cs2/review-gates.mddeleted file mode 100644index 6d6765d..0000000--- a/docs/cs2/review-gates.md+++ /dev/null@@ -1,49 +0,0 @@-# CS2 knife review gates--The review contract is owned by `forge/stage4_review/cs2_review.py`. It consumes a-validated manifest, render metrics, painted-region results, projection coverage,-critical-feature scores, and two orbit results. It emits a machine-readable report-with family, route, exactness tier, scene metadata, per-region confidence,-approximation notes, and failed gates.--The versioned fixture is `forge/tests/fixtures/knife_review_scene.json`. It records-the camera, object transform, environment hash, exposure, tone mapping, resolution, background,-renderer version, visible regions, critical features, and frozen initial thresholds:--- silhouette IoU: at least `0.85`-- aspect-ratio delta: at most `0.05`-- scale delta: at most `0.08`-- projection coverage: at least `0.85` when projection is required-- finish/material response and identity detail: at least `0.80`-- painted-region score: at least `0.80`-- orbit collapse ratio: `0.15` maximum--These thresholds are fixture data, not caller-supplied prose. They are blocking for-the knife route. A wrong family, missing adapter, missing projection evidence,-insufficient coverage, critical-feature failure, or degenerate orbit cannot be-overridden by a global visual score.--The fixture freezes the initial targets but records calibration as pending until the-browser runtime supplies labeled positive and negative renders. `calibrate_eye.py`-must be run on both classes before these targets are treated as empirically calibrated.--Attach a report to the normal review record with:--```sh-python3 forge/stage4_review/append_review.py object-sculpt-spec.json \- --pass-id material-pass --fidelity 0.9 --action continue --summary "knife review passed" \- --cs2-review-json cs2-review.json \- --review-scene-json forge/tests/fixtures/knife_review_scene.json --in-place-```--`append_review.py` rejects `action=continue` when the attached report is not a-passing knife review or when its scene fixture does not match. The report retains-single-view limitations: hidden-region confidence and approximation notes are-required evidence, not an exactness claim.--The fixture metadata labels the image as `user-supplied-review-required`. Do not-mark it rights-safe or commit extracted Valve pixels until provenance is verified.-Local extraction remains outside the repository under the existing `cs2_textures/`-IP boundary. Browser capture remains the responsibility of `runtime/cs2-preview`;-the Python review gate accepts its metrics and screenshots but does not pretend to-render them.diff --git a/docs/specs/vocabulary/cs2.jsonl b/docs/specs/vocabulary/cs2.jsonldeleted file mode 100644index 060a459..0000000--- a/docs/specs/vocabulary/cs2.jsonl+++ /dev/null@@ -1,8 +0,0 @@-{"record_id":"cs2.karambit.safety-ring","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"karambit safety ring","title":"Karambit safety ring / Vòng ngón Karambit","aliases":["safety ring","finger ring","vòng ngón","karambit"],"content":"A Karambit has a concave hawkbill blade and a safety ring at the pommel; the source identifies the ring as a critical finger-hole detail.","constraints":["Preserve the safety-ring opening as a distinct anatomical feature."],"measurements":[{"name":"ring diameter","value":"≈ 20","unit":"mm","context":"local research distill"}],"source_refs":[{"path":"docs/cs2/distill.md","heading":"1. Knife Anatomy — Actionable Geometry Rules"},{"path":"docs/cs2-anatomy/knives.md","heading":"3. Dao găm Karambit — Karambit"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/distill.md","note":"Notebook IDs are retained only in the local source header."},{"kind":"source","ref":"docs/cs2-anatomy/knives.md"}],"observation_status":"observed","confidence":0.85,"assumptions":[]}-{"record_id":"cs2.knife.pommel","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife pommel","title":"Knife pommel / Chuôi cuối dao","aliases":["pommel","chuôi cuối","knife handle","cán dao"],"content":"The technical mapping lists pommel as a knife-handle component with CylinderGeometry, metalness 1.0, and roughness 0.35.","constraints":["Treat the pommel as a distinct handle component when the reference shows it."],"measurements":[{"name":"roughness","value":"0.35","context":"technical mapping"}],"source_refs":[{"path":"docs/cs2/3D_Technical_Mapping.json","key_path":"knife_components.handle.pommel"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/3D_Technical_Mapping.json"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}-{"record_id":"cs2.balisong.pivot","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"balisong pivot pin","title":"Balisong pivot pin / Chốt xoay Balisong","aliases":["pivot","điểm xoay","pivot pin","chốt xoay","balisong"],"content":"A Balisong uses two handles with pivot pins, stop pin, and latch; the pivot pin is the rotation axis.","constraints":["Model the pivot as the rotation axis rather than a decorative centered pin."],"measurements":[],"source_refs":[{"path":"docs/cs2/distill.md","heading":"1. Knife Anatomy — Actionable Geometry Rules"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/distill.md"}],"observation_status":"observed","confidence":0.85,"assumptions":[]}-{"record_id":"cs2.attachment-socket","collection":"cs2","domain":"runtime","kind":"constraint","entity":"weapon attachment socket","title":"Weapon attachment socket / Ổ cắm gắn kết vũ khí","aliases":["socket","ổ cắm","attachment","gắn kết","suppressor attachment","gắn giảm thanh"],"content":"Use a named socket or contact region to describe a child attachment; the CS2 distill identifies threaded barrels as a suppressor-attachment case.","constraints":["Record the parent socket and contact type for an attached child part."],"measurements":[],"source_refs":[{"path":"grimoire/readiness/joint_attachment.md","heading":"Attachment Contract"},{"path":"docs/cs2/distill.md","heading":"2. Pistol Anatomy — Key Technical Findings"}],"evidence_refs":[{"kind":"source","ref":"grimoire/readiness/joint_attachment.md"},{"kind":"source","ref":"docs/cs2/distill.md"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}-{"record_id":"cs2.finish.roughness","collection":"cs2","domain":"finish","kind":"material","entity":"CS2 finish roughness","title":"CS2 finish roughness / Độ thô bề mặt CS2","aliases":["roughness","độ thô","độ nhám","anodized","anodized multicolored","anodized nhiều màu"],"content":"The mapping gives anodized finish roughness 0.05–0.15 and anodized-multicolored roughness 0.05–0.10.","constraints":["Use the documented finish range instead of inventing a scalar."],"measurements":[{"name":"anodized roughness","value":"0.05–0.15"},{"name":"anodized multicolored roughness","value":"0.05–0.10"}],"source_refs":[{"path":"docs/cs2/3D_Technical_Mapping.json","key_path":"cs2_finish_styles.anodized"},{"path":"docs/cs2/3D_Technical_Mapping.json","key_path":"cs2_finish_styles.anodized_multicolored"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/3D_Technical_Mapping.json"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}-{"record_id":"cs2.wear-edge-wear","collection":"cs2","domain":"wear","kind":"concept","entity":"edge wear","title":"Edge wear / Mòn cạnh viền","aliases":["wear","hao mòn","wear and tear","hao mòn sử dụng","edge wear","mòn cạnh viền"],"content":"Edge wear is damage concentrated along sharp corners or high-exposure edges; the mapping distinguishes it from general wear and tear.","constraints":["Place wear by its described spatial distribution rather than uniformly."],"measurements":[],"source_refs":[{"path":"docs/cs2/3D_Technical_Mapping.json","key_path":"spatial_wear_glossary.core_industry_terms.edge_wear"},{"path":"docs/cs2/3D_Technical_Mapping.json","key_path":"spatial_wear_glossary.core_industry_terms.wear_and_tear"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/3D_Technical_Mapping.json"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}-{"record_id":"cs2.wear-float-ranges","collection":"cs2","domain":"wear","kind":"measurement","entity":"CS2 float wear range","title":"CS2 float wear ranges / Dải float mài mòn CS2","aliases":["float value","giá trị float","factory new","mới từ nhà máy","minimal wear","mòn tối thiểu","battle-scarred","chiến tích"],"content":"The local CS2 vocabulary defines float ranges from Factory New 0.00–0.07 through Battle-Scarred 0.45–1.00.","constraints":["Use the recorded ranges as terminology support, not as a claim about an unseen item's exact wear."],"measurements":[{"name":"Factory New","value":"0.00–0.07"},{"name":"Battle-Scarred","value":"0.45–1.00"}],"source_refs":[{"path":"docs/cs2/3D_Vocabulary_CS2.json","key_path":"cs2_wear_ranges.factory_new"},{"path":"docs/cs2/3D_Vocabulary_CS2.json","key_path":"cs2_wear_ranges.battle_scarred"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/3D_Vocabulary_CS2.json"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}-{"record_id":"cs2.uv-paint-pattern","collection":"cs2","domain":"uv","kind":"concept","entity":"CS2 paint pattern UV projection","title":"CS2 paint pattern UV projection / Chiếu UV mẫu sơn CS2","aliases":["UV mapping","ánh xạ UV","paint pattern","mẫu sơn","wear overlay","lớp phủ mòn"],"content":"The CS2 vocabulary defines a paint pattern as a 2D texture projected onto 3D via UV and a wear overlay as texture adding damage based on float.","constraints":["Keep paint-pattern placement and wear-overlay behavior tied to UV-backed source terminology."],"measurements":[],"source_refs":[{"path":"docs/cs2/3D_Vocabulary_CS2.json","key_path":"categories.cs2_workshop.terms.paint_pattern"},{"path":"docs/cs2/3D_Vocabulary_CS2.json","key_path":"categories.cs2_workshop.terms.wear_overlay"}],"evidence_refs":[{"kind":"source","ref":"docs/cs2/3D_Vocabulary_CS2.json"}],"observation_status":"observed","confidence":0.9,"assumptions":[]}diff --git a/docs/specs/vocabulary/cs2_reconstruction.jsonl b/docs/specs/vocabulary/cs2_reconstruction.jsonldeleted file mode 100644index 79c88d6..0000000--- a/docs/specs/vocabulary/cs2_reconstruction.jsonl+++ /dev/null@@ -1,62 +0,0 @@-{"record_id":"cs2.attachment.sticker-placement-layering","collection":"cs2","domain":"attachment","kind":"finish","entity":"Sticker Placement & Layering","title":"Sticker Placement & Layering / Vị trí và Phân lớp Sticker","aliases":["Vị trí và Phân lớp Sticker"],"content":"Free-placement decal system using relative offset/rotation/scale within preset UV slots, with apply-order-based (not slot-order) layering.\n\nHệ thống decal đặt tự do dùng offset/xoay/tỷ lệ tương đối trong các slot UV cài sẵn, phân lớp theo thứ tự áp dụng (không phải thứ tự slot).\n\nRecognition cues: Decal-like flat graphic sitting on top of the base weapon skin, offset/rotated freely rather than fixed to a single spot; Newer stickers always render on top of older ones regardless of slot number — layering order = application order; Most weapons support 5 sticker slots (MP5-SD supports 8)\nDấu hiệu nhận diện: Đồ họa phẳng dạng decal nằm trên skin súng gốc, có thể lệch/xoay tự do thay vì cố định một vị trí; Sticker dán sau luôn hiển thị đè lên sticker cũ hơn bất kể số thứ tự slot — thứ tự lớp = thứ tự áp dụng; Hầu hết súng hỗ trợ 5 slot sticker (MP5-SD hỗ trợ 8)\n\nThree.js target: Multiple decal planes (PlaneGeometry or projected decal texture) parented to weapon UV reference nodes, z-offset ordered by application timestamp, transform driven by offset_x/offset_y/rotation/scale parameters","constraints":["Do not apply to knife, gloves — documented only for rifle, pistol, smg, sniper, heavy in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.attachment.weapon-charm-attachment","collection":"cs2","domain":"attachment","kind":"finish","entity":"Weapon Charm Attachment","title":"Weapon Charm Attachment / Gắn kết Weapon Charm","aliases":["Gắn kết Weapon Charm"],"content":"Independent decorative 3D meshes hung from a weapon via a skeletal spring-joint constraint, reacting dynamically to player movement and recoil.\n\nLưới 3D trang trí độc lập treo trên vũ khí qua ràng buộc khớp lò xo xương, phản ứng động theo chuyển động người chơi và độ giật.\n\nRecognition cues: A small independent 3D object hanging off the gun body, swinging/bouncing with recoil or movement rather than staying rigid; Cast soft contact shadows onto the weapon surface at its anchor socket; One charm per weapon max; sockets number in the dozens (e.g. ~17 on AWP, ~20 on AK-47) but avoid the grip/hand-contact zone\nDấu hiệu nhận diện: Vật thể 3D độc lập nhỏ treo trên thân súng, đung đưa/nảy theo độ giật hoặc chuyển động thay vì đứng yên cứng nhắc; Đổ bóng tiếp xúc mềm lên bề mặt vũ khí tại điểm neo; Tối đa một charm mỗi vũ khí; số điểm neo lên đến hàng chục (vd. ~17 ở AWP, ~20 ở AK-47) nhưng tránh vùng tay cầm/tiếp xúc tay\n\nThree.js target: Independent mesh with a spring-joint (soft constraint) parented to a named attachment socket on the weapon skeleton, simulated via a simple physics/spring update each frame","constraints":["Do not apply to knife, gloves — documented only for rifle, pistol, smg, sniper, heavy in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[7]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.finish.case-hardened-blue-gem-pattern","collection":"cs2","domain":"finish","kind":"finish","entity":"Case Hardened Blue Gem Pattern","title":"Case Hardened Blue Gem Pattern / Mẫu Case Hardened Blue Gem","aliases":["Mẫu Case Hardened Blue Gem"],"content":"A metallic oxidation pattern on Case Hardened skins where paint_seed determines the position/density of blue oxide clusters on the blade/gun surface; tiered by percentage of blue coverage on the playside.\n\nMẫu oxy hóa kim loại trên skin Case Hardened, trong đó paint_seed quyết định vị trí/mật độ cụm oxit xanh trên bề mặt lưỡi dao/súng; phân tầng theo phần trăm độ phủ xanh ở mặt playside.\n\nRecognition cues: Blend of blue (high-oxidation), purple (transition), and yellow/gold (base alloy steel) blotches; Tier 1 'God Tier': one large continuous blue cluster covering most of the playside (examples reach 94-99% coverage); Tier 2-3: blue coverage interrupted by yellow/gold patches or concentrated more on the backside than playside; Gold Gems are the visual inverse — near-total gold coverage with minimal blue\nDấu hiệu nhận diện: Pha trộn các vệt xanh dương (oxy hóa cao), tím (chuyển tiếp) và vàng/vàng kim (thép hợp kim nền); Tier 1 'God Tier': một cụm xanh lớn liên tục che phủ gần hết mặt playside (một số ví dụ đạt 94-99% độ phủ); Tier 2-3: độ phủ xanh bị gián đoạn bởi mảng vàng/vàng kim hoặc tập trung nhiều ở mặt sau hơn mặt playside; Gold Gems là hình ảnh đảo ngược — gần như toàn bộ phủ vàng kim, rất ít xanh\n\nThree.js target: Procedural gradient/noise-driven vertex color or texture blend across the blade UV, parameterized by a seed value driving cluster position and blue/purple/gold color ramp","constraints":["Do not apply to pistol, smg, sniper, heavy, gloves — documented only for knife, rifle in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.finish.cs2-weapon-finish-styles","collection":"cs2","domain":"finish","kind":"finish","entity":"CS2 Weapon Finish Styles","title":"CS2 Weapon Finish Styles / Các kiểu Finish vũ khí CS2","aliases":["Các kiểu Finish vũ khí CS2"],"content":"Nine distinct paint_style render architectures (Solid, Spray-Paint, Hydrographic, three Anodized variants, Patina, Custom Paint Job, Gunsmith) each with a different wear-erosion behavior.\n\nChín kiến trúc render paint_style riêng biệt (Solid, Spray-Paint, Hydrographic, ba biến thể Anodized, Patina, Custom Paint Job, Gunsmith), mỗi loại có hành vi bào mòn khác nhau.\n\nRecognition cues: Solid Color: flat uniform color, no pattern texture, wears straight to substrate; Spray-Paint: tiling pattern via triplanar mapping, wears through layers sequentially; Hydrographic: pattern tiled over native UVs simulating hydro-dipping, wears to substrate; Anodized (chrome base + single color) / Anodized Multicolored (custom roughness in alpha) / Anodized Airbrushed (soft radial gradients, used for Fade) — all wear TO CHROME first, exposing bright chrome before bare substrate; Patina: full-color image + normal map, iridescent view-angle sheen, never peels — instead darkens/desaturates/accumulates oxide with wear; Custom Paint Job: non-tiled illustrative texture, peels/flakes to dark metal substrate via a Wearness Mask; Gunsmith: hybrid Custom-Paint + Patina, grayscale mask splits regions into peeling-paint zones vs darkening-metal zones\nDấu hiệu nhận diện: Solid Color: màu phẳng đồng nhất, không có texture pattern, mòn thẳng xuống chất nền; Spray-Paint: pattern lặp qua triplanar mapping, mòn tuần tự qua từng lớp; Hydrographic: pattern lặp trên UV gốc mô phỏng hydro-dipping, mòn xuống chất nền; Anodized (nền chrome + một màu) / Anodized Multicolored (roughness tùy chỉnh trong alpha) / Anodized Airbrushed (gradient tỏa tròn mềm, dùng cho Fade) — tất cả đều mòn RA CHROME trước, lộ chrome sáng trước khi lộ chất nền; Patina: ảnh đầy màu + normal map, ánh ngũ sắc theo góc nhìn, không bong tróc — thay vào đó tối màu/mất bão hòa/tích oxit khi mòn; Custom Paint Job: texture minh họa không lặp, bong tróc lộ chất nền kim loại tối qua Wearness Mask; Gunsmith: lai giữa Custom-Paint và Patina, mặt nạ grayscale chia vùng bong tróc sơn và vùng kim loại tối màu\n\nThree.js target: Distinct shader path per paint_style value: triplanar UV projection for spray/anodized-airbrushed, native-UV tiling for hydrographic/patina/custom, each feeding a style-specific wear mix() function","constraints":["Do not apply to knife, gloves — documented only for rifle, pistol, smg, sniper, heavy in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[9]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.finish.doppler-phases-gem-variants","collection":"cs2","domain":"finish","kind":"finish","entity":"Doppler Phases & Gem Variants","title":"Doppler Phases & Gem Variants / Các Phase Doppler và biến thể đá quý","aliases":["Các Phase Doppler và biến thể đá quý"],"content":"A family of Doppler knife finishes (Phase 1-4, Ruby, Sapphire, Black Pearl) distinguished by dominant color combination and the presence/absence of an iridescent color-shift effect.\n\nNhóm các finish dao Doppler (Phase 1-4, Ruby, Sapphire, Black Pearl) phân biệt qua tổ hợp màu chủ đạo và có/không có hiệu ứng đổi màu ngũ sắc.\n\nRecognition cues: Phase 1: black-dominant with sparse pink/purple streaks; Phase 2: vivid pink+purple covering nearly the whole surface, most colorful phase; Phase 3: black/deep-blue/green mix — green presence is the unique tell for this phase; Phase 4: bright blue dominant with small black patches; Ruby: 100% uniform red, no black patches; Sapphire: 100% uniform blue, no black patches; Black Pearl: dark purple/black base with a view-angle-dependent iridescent purple-to-green shift — unique among all phases\nDấu hiệu nhận diện: Phase 1: đen chiếm ưu thế với vệt hồng/tím thưa thớt; Phase 2: hồng+tím rực rỡ phủ gần toàn bộ bề mặt, phase nhiều màu nhất; Phase 3: pha trộn đen/xanh dương đậm/xanh lá — sự xuất hiện của xanh lá là dấu hiệu riêng của phase này; Phase 4: xanh dương sáng chiếm ưu thế với vài mảng đen nhỏ; Ruby: đỏ đồng nhất 100%, không có mảng đen; Sapphire: xanh dương đồng nhất 100%, không có mảng đen; Black Pearl: nền tím đậm/đen với hiệu ứng đổi màu tím-sang-xanh lá ngũ sắc tùy góc nhìn — độc nhất trong các phase\n\nThree.js target: Binary metalness (1.0) + dynamic color-ramp lookup driven by 3D noise coordinates and view-angle (fresnel-like) term for the iridescent shift; implement as a custom shader/TSL node reading a color-ramp texture keyed by noise + viewDir·normal","constraints":["Do not apply to rifle, pistol, smg, sniper, heavy, gloves — documented only for knife in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.finish.fade-pattern-percentage","collection":"cs2","domain":"finish","kind":"finish","entity":"Fade Pattern Percentage","title":"Fade Pattern Percentage / Tỷ lệ mẫu Fade","aliases":["Tỷ lệ mẫu Fade"],"content":"A gradient finish (purple→pink/magenta→yellow/gold) whose 'fade %' is estimated from how much yellow coverage reaches the tip vs. how much unpainted gray substrate remains.\n\nFinish dạng gradient (tím→hồng/magenta→vàng/vàng kim), tỷ lệ '% fade' được ước lượng qua độ phủ vàng đến mũi so với phần chất nền xám chưa sơn còn lại.\n\nRecognition cues: Purple/blue always at the base, magenta/pink in the middle, yellow/gold at the tip — yellow coverage is the key percentage indicator; 100% (Full Fade): yellow fully covers the tip, gradient runs its full length, no gray substrate visible; 80% (Minimum Fade): little to no yellow, dominated by pink/purple with visible gray patches; Karambit/Talon knives are graded by ratio (e.g. 90/10 pink/purple) rather than gray-substrate percentage; Some knives (Falchion) can exceed 100% when the gradient spills onto the handle\nDấu hiệu nhận diện: Tím/xanh dương luôn ở gốc, hồng/magenta ở giữa, vàng/vàng kim ở mũi — độ phủ vàng là chỉ số phần trăm chính; 100% (Full Fade): vàng phủ kín mũi, gradient chạy hết chiều dài, không còn thấy nền xám; 80% (Fade tối thiểu): rất ít hoặc không có vàng, chủ yếu hồng/tím với các mảng xám còn thấy rõ; Dao Karambit/Talon được đánh giá theo tỷ lệ (vd. 90/10 hồng/tím) thay vì phần trăm nền xám; Một số dao (Falchion) có thể vượt quá 100% khi gradient tràn sang cả cán dao\n\nThree.js target: Anodized Airbrushed rendering path (Style 5): triplanar-mapped radial gradient, parameterized by a rotation angle theta derived from paint_seed feeding a purple→pink→yellow color ramp","constraints":["Do not apply to heavy, gloves — documented only for knife, rifle, pistol, smg, sniper in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.gloves.cuff","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"gloves cuff","title":"Cuff / Cổ găng tay","aliases":["Cổ găng tay"],"content":"Wrist-covering section of the glove; short cuff ends at/below the wrist, gauntlet extends up the forearm.\n\nPhần che cổ tay của găng tay; cổ ngắn kết thúc tại/dưới cổ tay, gauntlet kéo dài lên cẳng tay.\n\nRecognition cues: Short cuff: fabric ends right at the wrist line; Gauntlet: extended fabric/leather panel covering part of the forearm, often with its own strap\nDấu hiệu nhận diện: Cổ ngắn: vải kết thúc ngay tại đường cổ tay; Gauntlet: tấm vải/da kéo dài che một phần cẳng tay, thường có dây đai riêng\n\nThree.js target: ExtrudeGeometry cuff sleeve, length parameter distinguishes short-cuff vs gauntlet variants","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.gloves[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.gloves.finger-segments-gussets","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"gloves finger segments & gussets","title":"Finger Segments & Gussets / Đốt ngón tay và Vách ngăn","aliases":["Đốt ngón tay và Vách ngăn"],"content":"Pre-curved individual finger sections joined by stretch-fabric or mesh gussets for flexibility and ventilation.\n\nCác đốt ngón tay cong sẵn riêng lẻ, nối với nhau bằng vách ngăn vải co giãn hoặc lưới để tăng độ linh hoạt và thoáng khí.\n\nRecognition cues: Fingers show a natural pre-curved rest pose rather than lying flat; Thin, differently-textured strips (mesh/stretch fabric) visible between adjacent fingers\nDấu hiệu nhận diện: Ngón tay có tư thế nghỉ cong sẵn tự nhiên thay vì nằm thẳng; Các dải mỏng, kết cấu khác biệt (lưới/vải co giãn) thấy được giữa các ngón tay liền kề\n\nThree.js target: Slightly pre-curved CapsuleGeometry/tube segments per finger joint, thin plane-strip gusset geometry between finger meshes","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.gloves[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.gloves.knuckle-guard","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"gloves knuckle guard","title":"Knuckle Guard / Gù bảo vệ khớp","aliases":["Gù bảo vệ khớp"],"content":"Rigid TPU or carbon-fiber plate over the main finger knuckles, dispersing impact and resisting abrasion.\n\nTấm cứng TPU hoặc sợi carbon trên các khớp ngón tay chính, phân tán lực va chạm và chống mài mòn.\n\nRecognition cues: Raised, segmented hard plates across the back of the hand at knuckle positions, visually distinct (matte/textured) from the surrounding soft material\nDấu hiệu nhận diện: Các tấm cứng nhô lên, phân đoạn trên mu bàn tay tại vị trí khớp, khác biệt rõ (mờ/có kết cấu) so với vật liệu mềm xung quanh\n\nThree.js target: Segmented ExtrudeGeometry plates (one per knuckle) overlaid on the back-of-hand mesh, separate material with higher roughness/lower sheen","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.gloves[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.gloves.palm-palm-slider","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"gloves palm & palm slider","title":"Palm & Palm Slider / Lòng bàn tay và Miếng trượt lòng bàn tay","aliases":["Lòng bàn tay và Miếng trượt lòng bàn tay"],"content":"Grip surface (often goat/kangaroo leather) with a rigid TPU slider puck at the heel to reduce impact injury.\n\nBề mặt cầm nắm (thường bằng da dê/da chuột túi) với miếng trượt TPU cứng ở gót bàn tay để giảm chấn thương khi va chạm.\n\nRecognition cues: Textured leather-like surface on the inner hand; A distinct hard, smooth puck/patch at the base of the palm (heel), differing in material sheen from the surrounding leather\nDấu hiệu nhận diện: Bề mặt trong lòng bàn tay có kết cấu giống da; Có một miếng cứng, nhẵn, riêng biệt ở gốc lòng bàn tay (gót), khác độ bóng vật liệu so với da xung quanh\n\nThree.js target: Palm mesh with a separate small BoxGeometry/rounded-plate submesh (different material slot: harder roughness, distinct color) at the heel","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.gloves[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.gloves.wrist-strap-closure","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"gloves wrist strap / closure","title":"Wrist Strap / Closure / Đai khóa cổ tay","aliases":["Đai khóa cổ tay"],"content":"Hook-and-loop (Velcro) strap combined with neoprene to secure the glove firmly at the wrist.\n\nDây đai khóa dán (Velcro) kết hợp với neoprene để cố định chắc chắn găng tay tại cổ tay.\n\nRecognition cues: Overlapping strap with a visible rough/looped fastener patch at the cuff, distinct stitched seam\nDấu hiệu nhận diện: Dây đai chồng lên nhau có miếng khóa dán nhám/có móc thấy rõ ở cổ tay, đường may rõ rệt\n\nThree.js target: Flat ExtrudeGeometry strap band wrapped around the cuff cylinder, with a small rectangular fastener-patch submesh","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.gloves[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.action-bars","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy action bars","title":"Action Bars / Thanh truyền động","aliases":["Thanh truyền động"],"content":"Metal rods linking the pump forend to the bolt, converting hand motion into the cycling action.\n\nThanh kim loại nối ốp lót tay trượt với khóa nòng, chuyển động tác tay thành chu trình nạp đạn.\n\nRecognition cues: Thin parallel rods visible in the gap between forend and receiver when the action is racked open\nDấu hiệu nhận diện: Thanh mảnh song song thấy được ở khe hở giữa ốp lót tay và thân súng khi kéo mở\n\nThree.js target: Thin paired CylinderGeometry rods linking forend and bolt-carrier nodes, mostly hidden when closed","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.ammo-belt-linked-ammunition","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy ammo belt (linked ammunition)","title":"Ammo Belt (Linked Ammunition) / Dây băng đạn","aliases":["Dây băng đạn"],"content":"Chain of cartridges linked by metal links, feeding a machine gun continuously.\n\nChuỗi đạn liên kết bằng các mắt xích kim loại, tiếp đạn liên tục cho súng máy.\n\nRecognition cues: Segmented chain visible feeding into the top or side of the receiver, often draping from an ammo box or drum\nDấu hiệu nhận diện: Chuỗi phân đoạn thấy được đang tiếp vào phía trên hoặc bên hông thân súng, thường thõng từ hộp đạn hoặc trống đạn\n\nThree.js target: TubeGeometry following a curved path from a drum/box node into the feed-cover socket, with segment repetition for the link pattern","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.barrel-shroud","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy barrel shroud","title":"Barrel Shroud / Ốp bao nòng","aliases":["Ốp bao nòng"],"content":"Perforated protective jacket around a heavy-fire barrel (shotgun or MG), dissipating heat and shielding the shooter's hand.\n\nVỏ bảo vệ có lỗ thông quanh nòng súng bắn nhanh (shotgun hoặc súng máy), tản nhiệt và bảo vệ tay xạ thủ.\n\nRecognition cues: Perforated/vented outer sleeve visibly separate from the inner barrel, common on sustained-fire weapons\nDấu hiệu nhận diện: Vỏ ngoài có lỗ/thông gió, thấy rõ tách biệt với nòng bên trong, phổ biến ở vũ khí bắn liên tục\n\nThree.js target: Hollow CylinderGeometry outer shell with an array of small CSG-subtracted vent holes, barrel visible inside via a see-through gap","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.bipod-heavy","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy bipod (heavy)","title":"Bipod (Heavy) / Giá hai chân","aliases":["Giá hai chân"],"content":"Folding two-legged support for stable prone or bench firing of heavy automatic weapons.\n\nChân đỡ hai chân gấp được để bắn ổn định ở tư thế nằm hoặc trên bệ tì cho vũ khí tự động cỡ lớn.\n\nRecognition cues: Folding legs attached near the front of the barrel shroud/handguard\nDấu hiệu nhận diện: Chân gấp gắn gần phía trước ốp bao nòng/ốp lót tay\n\nThree.js target: Two hinged thin CylinderGeometry legs, child node with a fold joint near the front handguard","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.carrying-handle-heavy","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy carrying handle (heavy)","title":"Carrying Handle (Heavy) / Tay xách","aliases":["Tay xách"],"content":"Handle mounted atop the receiver for transport or rapid barrel changes.\n\nTay cầm gắn phía trên thân súng để vận chuyển hoặc thay nòng nhanh.\n\nRecognition cues: Small looped handle protruding from the top of the receiver, often near the barrel-change latch\nDấu hiệu nhận diện: Tay cầm hình vòng nhỏ nhô ra từ phía trên thân súng, thường gần chốt thay nòng\n\nThree.js target: TorusGeometry (partial loop) or thin ExtrudeGeometry handle child node on top of the receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[8]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.drum-magazine","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy drum magazine","title":"Drum Magazine / Hộp tiếp đạn hình trống","aliases":["Hộp tiếp đạn hình trống"],"content":"High-capacity circular magazine holding coiled belted ammunition.\n\nHộp tiếp đạn hình tròn dung lượng lớn chứa dây đạn cuộn tròn bên trong.\n\nRecognition cues: Large flat circular drum mounted at the feed point, distinctly rounder/flatter than a box or curved magazine\nDấu hiệu nhận diện: Trống tròn phẳng lớn gắn tại điểm tiếp đạn, rõ ràng tròn/phẳng hơn hộp đạn thẳng hoặc cong\n\nThree.js target: CylinderGeometry (short height, large radius) mounted at the receiver's feed socket","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.feed-cover-top-cover","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy feed cover (top cover)","title":"Feed Cover (Top Cover) / Nắp hộp khóa nòng","aliases":["Nắp hộp khóa nòng"],"content":"Hinged lid over the ammunition feed tray, keeping the belt aligned and shielding the loading mechanism.\n\nNắp có bản lề trên khay tiếp đạn, giữ dây đạn thẳng hàng và che chắn cơ cấu nạp đạn.\n\nRecognition cues: Flat hinged panel on top of the receiver, distinct seam line where it can flip open\nDấu hiệu nhận diện: Tấm phẳng có bản lề phía trên thân súng, có đường nối rõ rệt nơi có thể lật mở\n\nThree.js target: Flat BoxGeometry panel with a hinge joint at the rear edge of the receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[7]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.magazine-tube-shotgun","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy magazine tube (shotgun)","title":"Magazine Tube (Shotgun) / Ống chứa đạn (Shotgun)","aliases":["Ống chứa đạn (Shotgun)"],"content":"Tubular ammunition reservoir running beneath and parallel to the barrel.\n\nKho chứa đạn dạng ống chạy dưới và song song với nòng súng.\n\nRecognition cues: Thin cylindrical tube directly under the barrel, terminating near the muzzle end\nDấu hiệu nhận diện: Ống trụ mảnh ngay dưới nòng súng, kết thúc gần đầu nòng\n\nThree.js target: Thin CylinderGeometry parallel to and below the main barrel node","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.heavy.pump-action-forend","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"heavy pump action forend","title":"Pump Action Forend / Ốp lót tay trượt","aliases":["Ốp lót tay trượt"],"content":"Sliding handguard beneath a shotgun barrel, racked back-and-forth to eject and chamber shells.\n\nỐp lót tay có thể trượt dưới nòng shotgun, kéo tới lui để hất vỏ đạn cũ và nạp đạn mới.\n\nRecognition cues: Grooved handguard with a visible forward/backward slide gap along the magazine tube\nDấu hiệu nhận diện: Ốp lót tay có rãnh, thấy rõ khe trượt tới/lui dọc theo ống chứa đạn\n\nThree.js target: CylinderGeometry sleeve constrained to slide along the magazine-tube axis (translate-only joint)","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.heavy[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.balisong-bitesafe-handle-latch","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife balisong bite/safe handle & latch","title":"Balisong Bite/Safe Handle & Latch / Cán nguy hiểm/Cán an toàn và Chốt khóa (Balisong)","aliases":["Cán nguy hiểm/Cán an toàn và Chốt khóa (Balisong)"],"content":"Butterfly-knife-specific split handle: the bite handle swings on the edge side, the safe handle on the spine side, locked shut by a latch pin.\n\nCán dao bướm đặc thù chia đôi: cán nguy hiểm ở phía cạnh sắc, cán an toàn ở phía sống dao, được khóa lại bởi chốt latch.\n\nRecognition cues: Two hinged handle halves that fold flat against the blade; Bite handle closes against the sharp edge (dangerous to grip closed); safe handle closes against the spine; Small rotating latch pin at the tail end locking the halves together\nDấu hiệu nhận diện: Hai nửa cán có bản lề gấp phẳng áp vào lưỡi dao; Cán nguy hiểm đóng về phía cạnh sắc (nguy hiểm khi cầm lúc đóng); cán an toàn đóng về phía sống dao; Chốt xoay nhỏ ở đuôi cán khóa hai nửa lại với nhau\n\nThree.js target: Two hinged handle-half meshes with pivot joints at the bolster, plus a small CylinderGeometry latch pin child node","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[8]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.blade","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife blade","title":"Blade / Lưỡi dao","aliases":["Lưỡi dao"],"content":"The entire working portion of the knife, encompassing both the cutting edge and the spine.\n\nToàn bộ phần làm việc của con dao, bao gồm cả cạnh sắc và sống dao.\n\nRecognition cues: Main metal body extending from the handle/bolster to the tip\nDấu hiệu nhận diện: Khối kim loại chính kéo dài từ cán/đệm cán đến mũi dao\n\nThree.js target: ExtrudeGeometry from a custom 2D THREE.Shape blade silhouette, beveled at the edge side","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.bolster","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife bolster","title":"Bolster / Đệm cán / Khâu dao","aliases":["Đệm cán / Khâu dao"],"content":"Thick metal collar at the junction between blade and handle.\n\nMiếng đệm kim loại dày nằm ở điểm tiếp giáp giữa lưỡi dao và cán dao.\n\nRecognition cues: Distinct metal band/thickening right where the blade meets the handle, often a different material/finish than both\nDấu hiệu nhận diện: Dải kim loại/chỗ dày lên rõ rệt ngay tại điểm lưỡi dao gặp cán dao, thường khác vật liệu/finish với cả hai\n\nThree.js target: Short CylinderGeometry or BoxGeometry collar node between blade and handle meshes","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.edge","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife edge","title":"Edge / Cạnh sắc / Lưỡi cắt","aliases":["Cạnh sắc / Lưỡi cắt"],"content":"The sharpened line running from heel to tip used for cutting.\n\nĐường mài sắc chạy từ gót dao đến mũi dao dùng để cắt.\n\nRecognition cues: Thinnest, beveled, and typically brightest/most reflective line on the blade\nDấu hiệu nhận diện: Đường mỏng nhất, được vát và thường sáng bóng/phản chiếu nhất trên lưỡi dao\n\nThree.js target: Beveled edge geometry on the ExtrudeGeometry blade shape (narrow bevel angle on one side of the profile curve)","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.handle-scales","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife handle scales","title":"Handle Scales / Ốp cán","aliases":["Ốp cán"],"content":"Two side panels (wood, G-10, stone, etc.) fastened to the tang to form the grip.\n\nHai miếng vật liệu (gỗ, nhựa G-10, đá,...) gắn vào hai bên chuôi dao để tạo thành tay cầm.\n\nRecognition cues: Paired flat panels on either side of the handle, visible fasteners (rivets/pins), distinct material texture from the blade\nDấu hiệu nhận diện: Hai tấm phẳng đối xứng hai bên cán dao, thấy rõ đinh tán/chốt, kết cấu vật liệu khác biệt so với lưỡi dao\n\nThree.js target: Two mirrored BoxGeometry/ExtrudeGeometry panels flanking the tang, with small CylinderGeometry rivets","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.pommel-butt-cap","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife pommel (butt cap)","title":"Pommel (Butt Cap) / Núm chuôi / Đuôi cán","aliases":["Núm chuôi / Đuôi cán"],"content":"End cap at the terminus of the handle, decorative or functional (striking/counterweight).\n\nNắp chặn ở đầu cuối của cán dao, mang tính trang trí hoặc chức năng (đập/đối trọng).\n\nRecognition cues: Rounded or flat metal cap terminating the handle, often used to secure a hidden tang\nDấu hiệu nhận diện: Nắp kim loại tròn hoặc phẳng kết thúc cán dao, thường dùng để cố định chuôi ẩn\n\nThree.js target: SphereGeometry (flattened) or short CylinderGeometry cap child node at the rear of the handle","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[7]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.spine-back","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife spine (back)","title":"Spine (Back) / Sống dao","aliases":["Sống dao"],"content":"Thick, unsharpened back edge opposite the cutting edge, providing rigidity.\n\nPhần lưng dày, không mài sắc, đối diện với cạnh sắc, tạo độ cứng cho lưỡi dao.\n\nRecognition cues: The thickest part of the blade cross-section, flat or gently curved, opposite the sharp edge\nDấu hiệu nhận diện: Phần dày nhất trong tiết diện lưỡi dao, phẳng hoặc hơi cong, đối diện với cạnh sắc\n\nThree.js target: CapsuleGeometry or thick unbeveled strip along the back of the ExtrudeGeometry blade profile","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.tang","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife tang","title":"Tang / Chuôi lưỡi / Tang","aliases":["Chuôi lưỡi / Tang"],"content":"Steel extension of the blade running into the handle.\n\nPhần thép của lưỡi dao kéo dài vào bên trong cán dao.\n\nRecognition cues: Full tang: visible steel strip running the length of the handle between the scales; Hidden tang: no visible steel, fully enclosed by handle material\nDấu hiệu nhận diện: Full tang: dải thép lộ rõ chạy dọc cán dao giữa hai ốp cán; Hidden tang: không thấy thép, được bọc hoàn toàn bởi vật liệu cán\n\nThree.js target: Full tang: thin BoxGeometry strip visible between handle-scale meshes; Hidden tang: internal-only geometry, invisible child node","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.knife.tip-point","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"knife tip / point","title":"Tip / Point / Mũi dao","aliases":["Mũi dao"],"content":"Convergence point of edge and spine at the front of the blade.\n\nĐiểm hội tụ giữa cạnh sắc và sống dao ở phía trước lưỡi dao.\n\nRecognition cues: Sharpest point of the whole knife; profile shape (drop point, clip point, karambit hook, tanto) is a strong sub-type identifier\nDấu hiệu nhận diện: Điểm nhọn nhất của toàn bộ con dao; hình dạng mũi (drop point, clip point, móc karambit, tanto) là dấu hiệu phân loại quan trọng\n\nThree.js target: Terminal vertex of the ExtrudeGeometry 2D silhouette path — shape of this path segment encodes knife sub-type (e.g. Karambit hook curve)","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.knife[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.barrel-pistol","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol barrel (pistol)","title":"Barrel (Pistol) / Nòng súng","aliases":["Nòng súng"],"content":"Tube through which the bullet travels on firing; largely enclosed by the slide in most pistols.\n\nỐng mà viên đạn di chuyển qua khi bắn; phần lớn được bao bọc bởi khóa nòng ở hầu hết súng lục.\n\nRecognition cues: Visible mainly at the muzzle opening in the slide; on revolvers it's exposed and fixed, sometimes railed for accessories\nDấu hiệu nhận diện: Chủ yếu thấy ở lỗ miệng nòng trên khóa nòng; ở súng ổ xoay thì lộ rõ và cố định, đôi khi có rail để gắn phụ kiện\n\nThree.js target: CylinderGeometry nested inside the slide's CSG-subtracted bore channel","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.cocking-mechanism","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol cocking mechanism","title":"Cocking Mechanism / Cơ chế lên đạn / Lên búa","aliases":["Cơ chế lên đạn / Lên búa"],"content":"Action of preparing the weapon to fire: racking the slide (pistol) or thumbing/fanning the hammer (revolver).\n\nThao tác chuẩn bị súng sẵn sàng bắn: kéo khóa nòng (súng lục) hoặc lên búa bằng ngón cái/kỹ thuật quạt búa (súng ổ xoay).\n\nRecognition cues: Pistol: serrated slide-grip grooves indicate the racking surface; Revolver: exposed hammer spur sized for thumb cocking; some pistols (Tec-9) use a knob-style charging handle instead\nDấu hiệu nhận diện: Súng lục: rãnh răng cưa trên khóa nòng cho biết bề mặt để kéo; Súng ổ xoay: đuôi búa lộ ra đủ lớn để lên cò bằng ngón cái; một số súng lục (Tec-9) dùng cần kéo dạng núm thay thế\n\nThree.js target: Not a distinct mesh — an animation/interaction state (slide travel distance or hammer rotation) rather than geometry","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.cylinder-revolver","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol cylinder (revolver)","title":"Cylinder (Revolver) / Ổ xoay / Ổ đạn","aliases":["Ổ xoay / Ổ đạn"],"content":"Rotating drum housing multiple ammunition chambers, characteristic of revolvers.\n\nTrống xoay chứa nhiều buồng đạn, đặc trưng của súng ổ xoay.\n\nRecognition cues: Large round block at the mid-body of the weapon, visibly segmented into chamber holes (e.g. 8 for the R8 Revolver)\nDấu hiệu nhận diện: Khối tròn lớn ở giữa thân súng, thấy rõ được chia thành các lỗ buồng đạn (vd. 8 lỗ ở R8 Revolver)\n\nThree.js target: CylinderGeometry with radial array of small cylindrical CSG-subtracted chamber holes","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.grip","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol grip","title":"Grip / Tay cầm / Báng súng","aliases":["Tay cầm / Báng súng"],"content":"Frame section gripped by the shooter, with front strap, backstrap, and (on semi-autos) the magazine well running through it.\n\nPhần khung mà xạ thủ nắm, gồm mặt trước, mặt sau, và (ở súng bán tự động) ổ tiếp đạn chạy xuyên qua.\n\nRecognition cues: Textured lower frame section below the trigger guard; on semi-autos the magazine inserts from its base\nDấu hiệu nhận diện: Phần khung dưới có vân nằm dưới vành bảo vệ cò; ở súng bán tự động, hộp tiếp đạn lắp vào từ đáy tay cầm\n\nThree.js target: BoxGeometry angled child of frame, with a CSG-subtracted magazine-well cavity for semi-autos","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.hammer","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol hammer","title":"Hammer / Búa đập","aliases":["Búa đập"],"content":"Component that strikes the firing pin or primer directly to discharge the round.\n\nBộ phận đập vào kim hỏa hoặc trực tiếp vào hạt nổ để khai hỏa viên đạn.\n\nRecognition cues: Small protruding lever at the rear-top of the frame, often manually cockable (pulled back) before firing\nDấu hiệu nhận diện: Cần nhỏ nhô ra ở phía sau-trên khung súng, thường có thể lên cò thủ công (kéo ra sau) trước khi bắn\n\nThree.js target: Small hinged BoxGeometry/CylinderGeometry pivot node at the rear of the frame","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.slide","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol slide","title":"Slide / Khóa nòng","aliases":["Khóa nòng"],"content":"Top moving assembly of a semi-auto pistol that reciprocates rearward on firing to cycle the action.\n\nCụm di động phía trên của súng lục bán tự động, giật lùi khi bắn để thực hiện chu trình nạp đạn.\n\nRecognition cues: Large metal block wrapping the barrel with serrated grip grooves at the rear for manual racking, houses the rear sight\nDấu hiệu nhận diện: Khối kim loại lớn bao quanh nòng súng, có rãnh răng cưa phía sau để kéo tay, chứa thước ngắm phía sau\n\nThree.js target: BoxGeometry (rounded top edges) sliding along a rail axis relative to the frame, parent node for rear sight","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.pistol.trigger-guard","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"pistol trigger guard","title":"Trigger Guard / Vành bảo vệ cò","aliases":["Vành bảo vệ cò"],"content":"Loop encircling the trigger to prevent accidental discharge.\n\nVòng bao quanh cò súng để ngăn cò bị bóp vô ý.\n\nRecognition cues: Round or rectangular metal/polymer loop directly beneath the frame, encircling the trigger\nDấu hiệu nhận diện: Vòng kim loại/nhựa hình tròn hoặc chữ nhật ngay dưới khung súng, bao quanh cò\n\nThree.js target: TorusGeometry (partial) or ExtrudeGeometry loop child of the frame","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.pistol[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rarity.cs2-quality-types","collection":"cs2","domain":"rarity","kind":"finish","entity":"CS2 Quality Types","title":"CS2 Quality Types / Các loại chất lượng CS2","aliases":["Các loại chất lượng CS2"],"content":"Item-quality prefixes (Normal, Genuine, Vintage, Unusual, StatTrak, Souvenir) that can alter the 3D model itself, not just rarity color.\n\nTiền tố chất lượng vật phẩm (Normal, Genuine, Vintage, Unusual, StatTrak, Souvenir) có thể thay đổi chính mô hình 3D, không chỉ màu độ hiếm.\n\nRecognition cues: StatTrak: an added orange-glow LED counter submesh on guns, or a kill-count number etched into the main color channel on knives; Souvenir: always paired with 4 fixed gold-plated stickers representing tournament/team/MVP; Unusual (gloves): triggers a custom inspect loop and swaps in a distinct glove model\nDấu hiệu nhận diện: StatTrak: có thêm submesh bộ đếm LED phát sáng cam trên súng, hoặc số lần hạ gục khắc vào kênh màu chính trên dao; Souvenir: luôn đi kèm 4 sticker mạ vàng cố định đại diện giải đấu/đội tuyển/MVP; Unusual (găng tay): kích hoạt vòng lặp inspect tùy chỉnh và thay thế bằng mô hình găng tay riêng biệt\n\nThree.js target: Conditional child-mesh injection in the asset graph (e.g. add ST_counter submesh with emissive #FF4500) driven by a quality metadata flag","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rarity.cs2-rarity-tier-system","collection":"cs2","domain":"rarity","kind":"finish","entity":"CS2 Rarity Tier System","title":"CS2 Rarity Tier System / Hệ thống cấp độ hiếm CS2","aliases":["Hệ thống cấp độ hiếm CS2"],"content":"Color-coded rarity ladder (Consumer Grade through Contraband/Extraordinary) shown as a UI border color, also loosely correlating with unbox probability.\n\nThang phân cấp độ hiếm có mã màu (từ Consumer Grade đến Contraband/Extraordinary) hiển thị dưới dạng màu viền UI, cũng tương quan lỏng lẻo với xác suất mở hòm.\n\nRecognition cues: Consumer Grade: light blue-gray #B0C3D9; Industrial Grade: light blue #5E98D9; Mil-Spec: blue #4B69FF; Restricted: purple #8847FF; Classified: pink/magenta #D32CE6; Covert: red #EB4B4B; Contraband / ★ Extraordinary: gold #E4AE39 or #FFD700\nDấu hiệu nhận diện: Consumer Grade: xanh xám nhạt #B0C3D9; Industrial Grade: xanh dương nhạt #5E98D9; Mil-Spec: xanh dương #4B69FF; Restricted: tím #8847FF; Classified: hồng/magenta #D32CE6; Covert: đỏ #EB4B4B; Contraband / ★ Extraordinary: vàng kim #E4AE39 hoặc #FFD700\n\nThree.js target: UI-only metadata field (rarity color) attached to the reconstruction metadata schema — not a shader input, but useful for labeling/QA of generated assets","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.barrel","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle barrel","title":"Barrel / Nòng súng","aliases":["Nòng súng"],"content":"Steel tube that chambers the cartridge and directs the projectile down its bore.\n\nỐng thép chứa buồng đạn và định hướng viên đạn dọc theo lòng nòng.\n\nRecognition cues: Long cylindrical tube protruding from the front of the receiver, tapering slightly, ending at the muzzle\nDấu hiệu nhận diện: Ống trụ dài nhô ra phía trước thân súng, hơi thon dần, kết thúc ở miệng nòng\n\nThree.js target: CylinderGeometry(radiusTop≈radiusBottom, height=barrel length)","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.bolt-carrier-group-bcg-charging-handle","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle bolt carrier group (bcg) & charging handle","title":"Bolt Carrier Group (BCG) & Charging Handle / Cụm bệ khóa nòng và Cần kéo nạp đạn","aliases":["Cụm bệ khóa nòng và Cần kéo nạp đạn"],"content":"Internal mechanism performing chambering/locking/firing/extraction, manually cycled via an external handle.\n\nCơ cấu bên trong thực hiện nạp đạn/khóa nòng/khai hỏa/hất vỏ đạn, được lên đạn thủ công qua cần kéo bên ngoài.\n\nRecognition cues: Mostly hidden internally; visible externally only as the charging handle protrusion (top or side of receiver, AK top cover)\nDấu hiệu nhận diện: Chủ yếu ẩn bên trong; chỉ thấy được bên ngoài qua cần kéo nạp đạn nhô ra (trên hoặc bên hông thân súng, nắp trên với AK)\n\nThree.js target: Internal geometry usually omitted/low-detail for closed-bolt weapons; charging handle modeled as small BoxGeometry/CylinderGeometry knob","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[9]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.buttstock","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle buttstock","title":"Buttstock / Báng súng","aliases":["Báng súng"],"content":"Rear section resting against the shooter's shoulder; may be fixed, folding, or collapsible.\n\nPhần đuôi tì vào vai xạ thủ; có thể cố định, gấp được hoặc thu gọn được.\n\nRecognition cues: Rearmost component, either a solid contoured shoulder piece (fixed) or a skeletal/folding frame (collapsible)\nDấu hiệu nhận diện: Bộ phận cuối cùng, hoặc là khối tì vai đặc có đường cong (cố định) hoặc khung xương/gấp được (thu gọn)\n\nThree.js target: BoxGeometry/ExtrudeGeometry child node parented to rear of lower receiver, with a hinge pivot if foldable","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[7]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.gas-tube","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle gas tube","title":"Gas Tube / Ống dẫn khí","aliases":["Ống dẫn khí"],"content":"Thin tube channeling propellant gas from the barrel to cycle the action.\n\nỐng nhỏ dẫn khí thuốc súng từ nòng để vận hành chu trình nạp đạn.\n\nRecognition cues: Thin parallel rod running above/alongside the barrel under the handguard, often barely visible externally\nDấu hiệu nhận diện: Thanh mảnh song song chạy phía trên/dọc nòng súng dưới ốp lót tay, thường khó thấy từ bên ngoài\n\nThree.js target: Thin CylinderGeometry hidden mostly inside the handguard mesh","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.handguard","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle handguard","title":"Handguard / Ốp lót tay","aliases":["Ốp lót tay"],"content":"Protective sleeve around the barrel preventing burns and providing a forward gripping surface.\n\nVỏ bảo vệ quanh nòng súng ngăn bỏng tay và tạo bề mặt cầm nắm phía trước.\n\nRecognition cues: Ribbed or railed sleeve surrounding the barrel between the receiver and muzzle, often with visible vents or rail slots\nDấu hiệu nhận diện: Vỏ có gân hoặc rãnh rail bao quanh nòng súng giữa thân súng và đầu nòng, thường có khe thông gió hoặc rail lộ rõ\n\nThree.js target: Hollow CylinderGeometry or BoxGeometry shell surrounding the barrel (CSG subtract for hollow interior)","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.lower-receiver","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle lower receiver","title":"Lower Receiver / Thân dưới","aliases":["Thân dưới"],"content":"Bottom housing containing the trigger assembly, magazine well, and fire-selector.\n\nPhần vỏ dưới chứa cụm cò, ổ tiếp đạn (magazine well) và cần chọn chế độ bắn.\n\nRecognition cues: Contains the trigger guard opening and the magazine insertion slot; grip attaches to its rear\nDấu hiệu nhận diện: Chứa lỗ vành bảo vệ cò và khe lắp hộp tiếp đạn; tay cầm gắn ở phía sau\n\nThree.js target: BoxGeometry parent hosting trigger, magazine-well cavity (CSG subtract), and grip attachment socket","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.magazine","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle magazine","title":"Magazine / Hộp tiếp đạn / Băng đạn","aliases":["Hộp tiếp đạn / Băng đạn"],"content":"Detachable ammunition container; shape varies by platform (curved 'banana' for AK-type, straight/translucent for AUG).\n\nHộp chứa đạn tháo rời được; hình dạng khác nhau theo dòng súng (cong hình chuối với AK, thẳng/trong suốt với AUG).\n\nRecognition cues: Protrudes downward from the magazine well, curved profile signals AK-pattern rifle, straight signals M4/AR-pattern\nDấu hiệu nhận diện: Nhô xuống dưới từ ổ tiếp đạn, hình cong báo hiệu súng dòng AK, hình thẳng báo hiệu dòng M4/AR\n\nThree.js target: ExtrudeGeometry (curved 2D profile extruded) for banana magazines; BoxGeometry for straight magazines","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[8]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.muzzle-device-flash-hider-compensator-suppressor","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle muzzle device (flash hider / compensator / suppressor)","title":"Muzzle Device (Flash Hider / Compensator / Suppressor) / Đầu nòng (Loa che lửa / Bù giật / Giảm thanh)","aliases":["Đầu nòng (Loa che lửa / Bù giật / Giảm thanh)"],"content":"End-of-barrel attachment reducing muzzle flash, redirecting gas to counter recoil, or suppressing sound.\n\nPhụ kiện gắn ở đầu nòng để giảm lóe lửa, dẫn hướng khí để chống giật, hoặc giảm thanh.\n\nRecognition cues: Distinct slotted or perforated cylindrical/conical cap at the very tip of the barrel, wider than the bore\nDấu hiệu nhận diện: Nắp hình trụ/nón có rãnh hoặc lỗ thủng rõ rệt ở đầu nòng, rộng hơn lòng nòng\n\nThree.js target: Small CylinderGeometry or ConeGeometry child node parented to the barrel tip socket","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.pistol-grip","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle pistol grip","title":"Pistol Grip / Tay cầm khai hỏa","aliases":["Tay cầm khai hỏa"],"content":"Handle behind the trigger used to hold and control the rifle.\n\nTay cầm phía sau cò dùng để giữ và điều khiển súng.\n\nRecognition cues: Angled handle protruding downward directly behind/below the trigger guard, textured for grip\nDấu hiệu nhận diện: Tay cầm nghiêng nhô xuống ngay phía sau/dưới vành bảo vệ cò, có vân tăng ma sát\n\nThree.js target: BoxGeometry, angled ~15-20° from vertical, child of lower receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.rifle.upper-receiver","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"rifle upper receiver","title":"Upper Receiver / Thân trên","aliases":["Thân trên"],"content":"Top housing of the rifle containing the bolt carrier group and providing the barrel mounting point.\n\nPhần vỏ trên của súng trường chứa cụm bệ khóa nòng và là điểm gắn nòng súng.\n\nRecognition cues: Long central body spanning from the rear sight area to the barrel root, sits above the trigger/lower assembly\nDấu hiệu nhận diện: Thân dài trung tâm kéo dài từ khu vực thước ngắm đến gốc nòng súng, nằm phía trên cụm cò/thân dưới\n\nThree.js target: BoxGeometry-based blocked-out shell as the parent node for barrel, sight, and handguard child meshes","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.rifle[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.smg.curved-magazine-mp5-style","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"smg curved magazine (mp5-style)","title":"Curved Magazine (MP5-style) / Băng đạn cong (kiểu MP5)","aliases":["Băng đạn cong (kiểu MP5)"],"content":"Classic slightly-curved 30-round magazine seated forward of the trigger guard.\n\nBăng đạn cong nhẹ cổ điển 30 viên, lắp phía trước vành bảo vệ cò.\n\nRecognition cues: Gentle curve, inserted vertically in front of the trigger guard — silhouette closely tied to the classic MP5 family\nDấu hiệu nhận diện: Cong nhẹ, lắp thẳng đứng phía trước vành bảo vệ cò — hình dáng gắn liền với dòng MP5 cổ điển\n\nThree.js target: ExtrudeGeometry with a shallow-curved 2D profile, inserted into a magazine-well socket forward of the grip","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.smg[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.smg.helical-magazine-bizon-style","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"smg helical magazine (bizon-style)","title":"Helical Magazine (Bizon-style) / Băng đạn hình trụ xoắn (kiểu Bizon)","aliases":["Băng đạn hình trụ xoắn (kiểu Bizon)"],"content":"High-capacity (64-round) cylindrical magazine mounted beneath and along the barrel, doubling as a handguard.\n\nBăng đạn hình trụ dung lượng lớn (64 viên) lắp dưới và dọc theo nòng súng, kiêm luôn vai trò ốp lót tay.\n\nRecognition cues: Long cylindrical magazine running parallel under the full barrel length, gripped directly by the support hand\nDấu hiệu nhận diện: Băng đạn hình trụ dài chạy song song dưới suốt chiều dài nòng súng, được tay đỡ nắm trực tiếp\n\nThree.js target: CylinderGeometry magazine node spanning the underside of the barrel, doubling as the handguard grip surface","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.smg[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.smg.integrated-silencer-mp5-sd","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"smg integrated silencer (mp5-sd)","title":"Integrated Silencer (MP5-SD) / Ống giảm thanh tích hợp (MP5-SD)","aliases":["Ống giảm thanh tích hợp (MP5-SD)"],"content":"Large cylindrical suppressor sleeve permanently enclosing the barrel on the MP5-SD variant.\n\nVỏ giảm thanh hình trụ lớn bao trùm vĩnh viễn nòng súng ở biến thể MP5-SD.\n\nRecognition cues: Barrel appears uniformly thick/enclosed for its entire length rather than showing a distinct thin barrel + separate can\nDấu hiệu nhận diện: Nòng súng trông đồng đều dày/được bao bọc suốt chiều dài thay vì có nòng mảnh riêng biệt + ống giảm thanh rời\n\nThree.js target: Single large CylinderGeometry enclosing the barrel node, replacing separate barrel+suppressor children","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.smg[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.smg.stock-smg-specific","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"smg stock (smg-specific)","title":"Stock (SMG-specific) / Báng súng (đặc trưng SMG)","aliases":["Báng súng (đặc trưng SMG)"],"content":"Shoulder-stabilizing rear piece, typically foldable/retractable/collapsible on SMGs to keep the platform compact.\n\nBộ phận tì vai phía sau, thường gấp/rút được ở SMG để giữ súng nhỏ gọn.\n\nRecognition cues: Distinctly more compact and often skeletal/folding compared to a rifle's fixed stock — a strong SMG vs rifle discriminator\nDấu hiệu nhận diện: Rõ ràng nhỏ gọn hơn và thường dạng khung/gấp được so với báng súng cố định của súng trường — dấu hiệu phân biệt SMG với súng trường\n\nThree.js target: Hinged BoxGeometry/thin-frame ExtrudeGeometry child node with a fold pivot relative to the receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.smg[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.smg.top-mounted-horizontal-magazine-p90-style","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"smg top-mounted horizontal magazine (p90-style)","title":"Top-Mounted Horizontal Magazine (P90-style) / Băng đạn nằm ngang phía trên (kiểu P90)","aliases":["Băng đạn nằm ngang phía trên (kiểu P90)"],"content":"Translucent polymer magazine running parallel to and above the barrel, bullpup layout.\n\nBăng đạn nhựa trong suốt chạy song song và nằm phía trên nòng súng, bố cục bullpup.\n\nRecognition cues: Magazine lies flat along the top of the receiver rather than protruding downward — the single strongest P90 identifier; Downward-facing ejection port in the stock area\nDấu hiệu nhận diện: Băng đạn nằm phẳng dọc theo phía trên thân súng thay vì nhô xuống dưới — dấu hiệu nhận diện P90 mạnh nhất; Cửa hất vỏ đạn hướng xuống dưới ở khu vực báng súng\n\nThree.js target: BoxGeometry magazine node parented along the top rail axis instead of the bottom of the receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.smg[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.bipod-monopod","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper bipod / monopod","title":"Bipod / Monopod / Chân chống hai chân / Chân chống đơn","aliases":["Chân chống hai chân / Chân chống đơn"],"content":"Front two-legged support (bipod) and rear retractable spike (monopod) creating a stable three-point stance when deployed.\n\nChân chống hai chân phía trước (bipod) và chân chống đơn/spike có thể thu vào phía sau (monopod) tạo thế đứng ba điểm ổn định khi triển khai.\n\nRecognition cues: Folding legs under the front handguard plus a small retractable spike under the rear of the stock — together create a distinct three-point silhouette when deployed\nDấu hiệu nhận diện: Chân gấp dưới ốp lót tay phía trước cộng với spike nhỏ có thể thu vào dưới đuôi báng súng — cùng tạo hình dáng ba điểm rõ rệt khi triển khai\n\nThree.js target: Two hinged thin CylinderGeometry legs (bipod) + one telescoping CylinderGeometry spike (monopod), child nodes with fold/extend joints","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.bolt-action","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper bolt action","title":"Bolt Action / Cơ cấu lên đạn (Bolt Action)","aliases":["Cơ cấu lên đạn (Bolt Action)"],"content":"Manually-operated locking/cycling mechanism characteristic of precision sniper rifles.\n\nCơ chế khóa nòng/lên đạn vận hành thủ công đặc trưng của súng bắn tỉa chính xác.\n\nRecognition cues: Protruding bolt handle is the visual proxy for this mechanism (see Bolt Handle entry)\nDấu hiệu nhận diện: Cần kéo khóa nòng nhô ra là dấu hiệu thị giác đại diện cho cơ chế này (xem mục Cần kéo khóa nòng)\n\nThree.js target: Internal action geometry usually low-detail; represented externally via the bolt handle child mesh","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[0]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.bolt-handle","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper bolt handle","title":"Bolt Handle / Cần kéo khóa nòng","aliases":["Cần kéo khóa nòng"],"content":"Protruding manual handle used to cycle a bolt-action rifle.\n\nCần kéo thủ công nhô ra dùng để lên đạn cho súng bolt-action.\n\nRecognition cues: Prominent knob/lever extending from the side of the receiver — unlike the recessed charging handles of gas-operated rifles, this is the single strongest sniper-vs-assault-rifle discriminator\nDấu hiệu nhận diện: Núm/cần nhô rõ rệt từ bên hông thân súng — khác với cần kéo nạp đạn thụt vào của súng trích khí, đây là dấu hiệu phân biệt súng bắn tỉa và súng trường mạnh nhất\n\nThree.js target: SphereGeometry knob + thin CylinderGeometry arm, child node on the side of the receiver","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[1]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.cheek-riser-adjustable-buttstock","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper cheek riser / adjustable buttstock","title":"Cheek Riser / Adjustable Buttstock / Ốp má / Báng súng có thể điều chỉnh","aliases":["Ốp má / Báng súng có thể điều chỉnh"],"content":"Elevated, often adjustable stock component aligning the shooter's eye with a high-mounted scope; foldable on some platforms (SSG 08).\n\nBộ phận báng súng nâng cao, thường điều chỉnh được, giúp căn mắt xạ thủ với kính ngắm gắn cao; gấp được ở một số dòng (SSG 08).\n\nRecognition cues: Visible knobs/sliders/adjustment screws on the stock, giving a more 'modular' look than a simple fixed rifle stock\nDấu hiệu nhận diện: Thấy rõ các núm/thanh trượt/ốc điều chỉnh trên báng súng, tạo cảm giác 'modular' hơn báng súng cố định đơn giản\n\nThree.js target: ExtrudeGeometry stock body with small CylinderGeometry adjustment knob child nodes and a slide joint for the riser","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[5]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.heavybull-free-floating-fluted-barrel","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper heavy/bull, free-floating, fluted barrel","title":"Heavy/Bull, Free-Floating, Fluted Barrel / Nòng nặng, Nòng tự do, Nòng có rãnh","aliases":["Nòng nặng, Nòng tự do, Nòng có rãnh"],"content":"Thick match-grade barrel variants: bull barrel (vibration control), free-floating (no stock contact, for accuracy), fluted (grooved to save weight).\n\nCác biến thể nòng match-grade dày: nòng bull (kiểm soát rung), nòng tự do (không chạm báng súng, tăng độ chính xác), nòng có rãnh (khoét rãnh để giảm trọng lượng).\n\nRecognition cues: Noticeably thicker barrel profile than assault rifles; A visible air gap between barrel and handguard signals free-floating design; Longitudinal grooves along the barrel signal fluting\nDấu hiệu nhận diện: Tiết diện nòng dày rõ rệt hơn súng trường thường; Khe hở rõ giữa nòng và ốp lót tay báo hiệu thiết kế free-floating; Các rãnh dọc theo nòng báo hiệu nòng có rãnh (fluted)\n\nThree.js target: Thicker CylinderGeometry barrel with optional longitudinal groove geometry (repeated thin CSG-subtracted channels) for fluting","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[2]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.muzzle-brake-compensator-heavy","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper muzzle brake / compensator (heavy)","title":"Muzzle Brake / Compensator (Heavy) / Bộ phận hãm giật / Bù giật (cỡ lớn)","aliases":["Bộ phận hãm giật / Bù giật (cỡ lớn)"],"content":"Oversized gas-redirecting device at the muzzle to counter significant recoil from high-caliber rounds.\n\nThiết bị dẫn hướng khí cỡ lớn ở đầu nòng để chống giật đáng kể từ đạn cỡ lớn.\n\nRecognition cues: Boxy, noticeably wider-than-barrel device with large venting ports at the muzzle tip\nDấu hiệu nhận diện: Thiết bị dạng hộp, rõ ràng rộng hơn nòng súng, có các lỗ thoát khí lớn ở đầu nòng\n\nThree.js target: BoxGeometry/CylinderGeometry hybrid, wider radius than the barrel, with CSG-subtracted vent slots","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[3]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.sniper.scope-mount-rings-picatinny-rail","collection":"cs2","domain":"weapon-anatomy","kind":"component","entity":"sniper scope mount, rings & picatinny rail","title":"Scope Mount, Rings & Picatinny Rail / Gá ống ngắm, vòng khuyên giữ và rail Picatinny","aliases":["Gá ống ngắm, vòng khuyên giữ và rail Picatinny"],"content":"Hardware (claw mounts, rings, standardized MIL-STD-1913 rail) securing a high-magnification optic well above the bore axis.\n\nPhần cứng (gá kẹp, vòng khuyên, rail chuẩn MIL-STD-1913) cố định kính ngắm phóng đại cao, nằm cao hơn hẳn trục nòng.\n\nRecognition cues: Long flat rail spanning the top of the receiver, dominated by a tall scope sitting well above the standard iron-sight line\nDấu hiệu nhận diện: Rail phẳng dài trải dọc phía trên thân súng, bị chi phối bởi ống ngắm cao nằm hẳn trên đường ngắm cơ bản tiêu chuẩn\n\nThree.js target: BoxGeometry rail strip on top of receiver + CylinderGeometry scope body + Torus/ring mount clamps as child nodes","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.geometry_anatomy.sniper[4]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.wear.glove-float-cap-range","collection":"cs2","domain":"wear","kind":"finish","entity":"Glove Float Cap Range","title":"Glove Float Cap Range / Giới hạn Float của Găng tay","aliases":["Giới hạn Float của Găng tay"],"content":"Gloves use a compressed float range (0.06-0.80) compared to weapons (0.00-1.00), making a given float value read as visually more worn on gloves than on a gun.\n\nGăng tay dùng dải float bị nén (0.06-0.80) so với vũ khí (0.00-1.00), khiến cùng một giá trị float trông mòn hơn về mặt thị giác trên găng tay so với trên súng.\n\nRecognition cues: Factory New band is unusually narrow: 0.06-0.07 only; A glove at float 0.15 (nominally 'Minimal Wear') can look as worn as a Field-Tested gun at 0.35; Wear shows most prominently on the knuckle guard, fingertips, and palm edges\nDấu hiệu nhận diện: Dải Factory New bất thường hẹp: chỉ 0.06-0.07; Găng tay ở float 0.15 (danh nghĩa 'Minimal Wear') có thể trông mòn tương đương súng Field-Tested ở 0.35; Vết mòn thể hiện rõ nhất ở gù bảo vệ khớp, đầu ngón tay và cạnh lòng bàn tay\n\nThree.js target: Same wear-state mix() shader as weapons but with wear_remap_min=0.06/wear_remap_max=0.80 applied before sampling the float-driven blend","constraints":["Do not apply to rifle, pistol, knife, smg, sniper, heavy — documented only for gloves in the source research."],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[8]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}-{"record_id":"cs2.wear.wear-float-level-system","collection":"cs2","domain":"wear","kind":"finish","entity":"Wear / Float Level System","title":"Wear / Float Level System / Hệ thống độ mòn / Float","aliases":["Hệ thống độ mòn / Float"],"content":"Permanent 0.00-1.00 float value fixed at item creation, mapped to five wear-level bands (Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred) each with characteristic surface degradation.\n\nGiá trị float cố định vĩnh viễn từ 0.00-1.00 khi tạo vật phẩm, ánh xạ sang năm dải cấp độ mòn (Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred), mỗi cấp có đặc điểm xuống cấp bề mặt riêng.\n\nRecognition cues: Factory New [0.00-0.07): near-perfect finish, at most barely-visible edge scuffing; Minimal Wear [0.07-0.15): small micro-scratches at corners, paint intact on ~95% of surface; Field-Tested [0.15-0.38): clearly visible scratches/chips, paint starting to peel at edges, reduced gloss; Well-Worn [0.38-0.45): large dense scratches exposing substrate, color oxidation/dulling; Battle-Scarred [0.45-1.00]: near-total paint loss, deep gouges, dirt/grunge accumulation; Weathering is geometry-aware: curvature maps concentrate scratches on sharp edges, AO maps protect recesses (which instead darken/accumulate grime)\nDấu hiệu nhận diện: Factory New [0.00-0.07): finish gần hoàn hảo, cùng lắm là trầy nhẹ khó thấy ở cạnh; Minimal Wear [0.07-0.15): vết trầy nhỏ li ti ở góc, sơn còn nguyên ~95% bề mặt; Field-Tested [0.15-0.38): vết trầy/mẻ thấy rõ, sơn bắt đầu bong ở cạnh, độ bóng giảm; Well-Worn [0.38-0.45): vết trầy lớn dày đặc lộ chất nền, màu bị oxy hóa/xỉn; Battle-Scarred [0.45-1.00]: mất sơn gần như hoàn toàn, vết lõm sâu, tích tụ bụi bẩn; Sự xuống cấp có nhận biết hình học: bản đồ độ cong tập trung vết xước ở cạnh sắc, bản đồ AO bảo vệ chỗ lõm (thay vào đó tối màu/tích bụi)\n\nThree.js target: Float value drives a mix() between pristine and worn material states via the Wearness Alpha Mask, curvature map, and AO map — see rendering_shader_mapping 'Wear-State Material Blend'","constraints":[],"measurements":[],"source_refs":[{"path":"docs/raw/img2threejs-skill-dataset.json","key_path":"categories.finish_pattern_rarity[6]"}],"evidence_refs":[{"kind":"source","ref":"docs/raw/img2threejs-skill-dataset.json","note":"img2threejs NotebookLM research distillation"}],"observation_status":"observed","confidence":0.8,"assumptions":[]}diff --git a/forge/_shared/domains/__init__.py b/forge/_shared/domains/__init__.pyindex c6f06c8..a22c33a 100644--- a/forge/_shared/domains/__init__.py+++ b/forge/_shared/domains/__init__.py@@ -21,6 +21,8 @@ Optional keys, each defaulting to "contributes nothing":from __future__ import annotationsimport importlib.util+import json+import osfrom pathlib import Pathfrom typing import Any, Final@@ -67,8 +69,21 @@ def _validate(entry: Any, source: Path) -> dict[str, Any]:def registered_domains() -> dict[str, dict[str, Any]]:- """Every domain profile available to this checkout, keyed by id."""+ """Every domain profile available to this run, keyed by id.++ Two sources, treated identically once loaded: modules in this package (in-repo domains) and+ `domain.json` in each installed plugin. A domain that moves from the first to the second changes+ nothing for the base pipeline -- that equivalence is the point of the registry.+ """found: dict[str, dict[str, Any]] = {}++ def claim(entry: Any, source: Path) -> None:+ entry = _validate(entry, source)+ if entry["id"] in found:+ # Two providers claiming one id is ambiguous; the base must not pick one.+ raise DomainRegistryError(f"domain id {entry['id']!r} is declared twice")+ found[entry["id"]] = entry+for path in sorted(_PACKAGE_DIR.glob("*.py")):if path.name == "__init__.py":continue@@ -76,14 +91,58 @@ def registered_domains() -> dict[str, dict[str, Any]]:entry = getattr(module, "DOMAIN", None)if entry is None:raise DomainRegistryError(f"{path.name}: a domain module must declare DOMAIN")- entry = _validate(entry, path)- if entry["id"] in found:- # Two providers claiming one id is ambiguous; the base must not pick one.- raise DomainRegistryError(f"domain id {entry['id']!r} is declared twice")- found[entry["id"]] = entry+ claim(entry, path)++ for path, entry in _installed_plugin_domains():+ claim(entry, path)+return found+def _img2_home() -> Path:+ return Path(os.environ.get("IMG2_HOME") or Path.home() / ".img2")+++def _installed_plugin_domains() -> list[tuple[Path, Any]]:+ """Domain declarations from installed plugins.++ Reads the harness registry rather than globbing the plugins directory, so a checkout left behind+ by a removed plugin does not silently contribute steps. A plugin that ships no `domain.json`+ simply contributes no domain -- it may still provide capabilities.+ """+ registry = _img2_home() / "plugins.json"+ if not registry.is_file():+ return []+ try:+ rows = json.loads(registry.read_text(encoding="utf-8")).get("plugins") or []+ except (OSError, json.JSONDecodeError) as exc:+ raise DomainRegistryError(f"cannot read the plugin registry at {registry}: {exc}") from exc++ out: list[tuple[Path, Any]] = []+ for row in rows:+ plugin_id = (row or {}).get("id")+ if not plugin_id:+ continue+ declaration = _img2_home() / "plugins" / plugin_id / "domain.json"+ if not declaration.is_file():+ continue+ try:+ entry = json.loads(declaration.read_text(encoding="utf-8"))+ except (OSError, json.JSONDecodeError) as exc:+ raise DomainRegistryError(f"cannot read {declaration}: {exc}") from exc+ # Steps arrive as JSON arrays; the splice unpacks them as (id, command) pairs. {plugin_dir}+ # is resolved here, the same substitution the harness performs, so a checklist command a+ # plugin supplied is runnable from the workspace without the caller knowing where it lives.+ plugin_dir = str(declaration.parent)+ for key in ("setupSteps", "passSteps"):+ if key in entry:+ entry[key] = tuple(+ (step_id, command.replace("{plugin_dir}", plugin_dir)) for step_id, command in entry[key]+ )+ out.append((declaration, entry))+ return out++def domain_profile(profile: str) -> dict[str, Any] | None:"""The registered domain for `profile`, or None for the generic pipeline."""if profile == "generic":diff --git a/forge/_shared/domains/cs2.py b/forge/_shared/domains/cs2.pydeleted file mode 100644index cff2779..0000000--- a/forge/_shared/domains/cs2.py+++ /dev/null@@ -1,31 +0,0 @@-"""CS2 domain profile.--An in-repo provider for now. This module is what leaves the repository when CS2 becomes its own-plugin -- at which point the harness supplies the same mapping and the base pipeline is unchanged.-"""--from __future__ import annotations--from typing import Any, Final--DOMAIN: Final[dict[str, Any]] = {- "id": "cs2",- "setupSteps": (- ("cs2-contract-read", "Read grimoire/intake/cs2_intake_contract.md completely"),- ("cs2-authoritative-classification", "Obtain an authoritative CS2 family/subtype classification record"),- (- "cs2-manifest",- "python3 forge/stage1_intake/cs2_manifest.py {reference} --classification classification.json --out cs2-intake.json",- ),- ),- "setupAnchorBefore": "local-spec-search",- "passSteps": (- (- "cs2-review",- "python3 forge/stage4_review/cs2_review.py --manifest cs2-intake.json --metrics cs2-review-inputs.json"- " --scene forge/tests/fixtures/knife_review_scene.json --out cs2-review.json",- ),- ),- "passAnchorBefore": "ai-review-recorded",- "specCollection": "cs2",-}diff --git a/forge/_shared/spec_search_profiles.json b/forge/_shared/spec_search_profiles.jsonindex 6fe5320..23980d4 100644--- a/forge/_shared/spec_search_profiles.json+++ b/forge/_shared/spec_search_profiles.json@@ -29,21 +29,6 @@}},"collections": {- "cs2": {- "source_roots": [],- "optional_source_roots": [- "docs/cs2/",- "docs/cs2-anatomy/"- ],- "distilled_records": [- "docs/specs/vocabulary/cs2.jsonl",- "docs/specs/vocabulary/cs2_reconstruction.jsonl",- "docs/specs/vocabulary/core_3d.jsonl",- "docs/specs/vocabulary/core_3d_reconstruction.jsonl"- ],- "documentation": "docs/specs/vocabulary/README.md",- "cache": ".cache/spec-search/cs2.json"- },"core_3d": {"source_roots": [],"optional_source_roots": [],diff --git a/forge/stage4_review/cs2_review.py b/forge/stage4_review/cs2_review.pydeleted file mode 100644index b90d66b..0000000--- a/forge/stage4_review/cs2_review.py+++ /dev/null@@ -1,224 +0,0 @@-from __future__ import annotations--import argparse-import json-import os-import sys-import tempfile-from pathlib import Path-from typing import Any--REQUIRED_SCENE_KEYS = {- "version",- "fixtureId",- "reference",- "identity",- "camera",- "transform",- "environment",- "resolution",- "background",- "rendererVersion",- "calibration",- "thresholds",-}-REQUIRED_THRESHOLDS = {- "silhouetteIoU",- "aspectRatioDelta",- "scaleDelta",- "projectionCoverage",- "finishMaterialResponse",- "identityDetail",- "paintedRegion",- "maxOrbitCollapseRatio",-}---def load_review_scene(path: Path) -> dict[str, Any]:- payload = json.loads(path.read_text(encoding="utf-8"))- if not isinstance(payload, dict):- raise ValueError("review scene must be a JSON object")- missing = REQUIRED_SCENE_KEYS - payload.keys()- if missing:- raise ValueError("review scene is missing: " + ", ".join(sorted(missing)))- thresholds = payload.get("thresholds")- if not isinstance(thresholds, dict) or not REQUIRED_THRESHOLDS.issubset(thresholds):- raise ValueError("review scene thresholds are incomplete")- if payload.get("version") != 1:- raise ValueError("unsupported review scene version")- return payload---def _number(value: Any) -> bool:- return isinstance(value, (int, float)) and not isinstance(value, bool)---def _failed_threshold(metrics: dict[str, Any], key: str, threshold: float, *, maximum: bool) -> bool:- value = metrics.get(key)- if not _number(value):- return True- return float(value) > threshold if maximum else float(value) < threshold---def _region_results(inputs: dict[str, Any], threshold: float) -> tuple[list[dict[str, Any]], list[str]]:- raw = inputs.get("paintedRegions", [])- if not isinstance(raw, list):- return [], ["painted-regions-invalid"]- results: list[dict[str, Any]] = []- failures: list[str] = []- for region in raw:- if not isinstance(region, dict) or not isinstance(region.get("id"), str):- failures.append("painted-region-invalid")- continue- score = region.get("score")- confidence = region.get("confidence")- result = {"id": region["id"], "score": score, "confidence": confidence}- results.append(result)- if not _number(score) or float(score) < threshold:- failures.append(f"painted-region:{region['id']}")- if not _number(confidence):- failures.append(f"painted-region-confidence:{region['id']}")- return results, failures---def _critical_feature_failures(inputs: dict[str, Any], default_threshold: float) -> list[str]:- raw = inputs.get("criticalFeatures", [])- if not isinstance(raw, list):- return ["critical-features-invalid"]- failures: list[str] = []- for feature in raw:- if not isinstance(feature, dict) or not isinstance(feature.get("id"), str):- failures.append("critical-feature-invalid")- continue- threshold = feature.get("threshold", default_threshold)- if not _number(feature.get("score")) or not _number(threshold):- failures.append(f"critical-feature:{feature['id']}")- elif float(feature["score"]) < float(threshold):- failures.append(f"critical-feature:{feature['id']}")- return failures---def evaluate_knife_review(- manifest: dict[str, Any],- inputs: dict[str, Any],- review_scene: dict[str, Any],-) -> dict[str, Any]:- thresholds = review_scene["thresholds"]- failed: list[str] = []- family = manifest.get("itemFamily")- if family != "knife":- failed.append(f"unsupported-family:{family or 'missing'}")- if manifest.get("componentAdapter") != "cs2-knife-v1":- failed.append("knife-adapter-missing")- if manifest.get("state") != "proceed":- failed.append(f"manifest-state:{manifest.get('state', 'missing')}")-- for key in ("silhouetteIoU", "aspectRatioDelta", "scaleDelta"):- maximum = key != "silhouetteIoU"- if _failed_threshold(inputs, key, float(thresholds[key]), maximum=maximum):- failed.append(key)- for key in ("finishMaterialResponse", "identityDetail"):- if _failed_threshold(inputs, key, float(thresholds[key]), maximum=False):- failed.append(key)-- region_results, region_failures = _region_results(inputs, float(thresholds["paintedRegion"]))- failed.extend(region_failures)- failed.extend(_critical_feature_failures(inputs, float(thresholds["identityDetail"])))-- projection = inputs.get("projection")- if manifest.get("route") == "reference-projection":- if not isinstance(projection, dict) or projection.get("required") is not True:- failed.append("projection-evidence-missing")- elif _failed_threshold(projection, "coverage", float(thresholds["projectionCoverage"]), maximum=False):- failed.append("projection-coverage")-- multi_angle = inputs.get("multiAngle")- if not isinstance(multi_angle, dict) or multi_angle.get("degenerate") is True:- failed.append("degenerate-orbit")- elif len(multi_angle.get("angles", [])) < 2:- failed.append("orbit-coverage-missing")-- notes = manifest.get("approximationNotes", inputs.get("approximationNotes", []))- approximation_notes = [str(note) for note in notes] if isinstance(notes, list) else []- hidden_confidence = manifest.get("confidence", {}).get("hiddenRegions")- report = {- "verdict": "pass" if not failed else "reject",- "action": "continue" if not failed else ("request-input" if any(- item.startswith(("unsupported-family", "manifest-state", "projection-evidence", "orbit-coverage"))- for item in failed- ) else "refine-code"),- "family": family,- "subtype": manifest.get("subtype"),- "exactnessTier": manifest.get("exactnessTier"),- "route": manifest.get("route"),- "reviewScene": {- "version": review_scene["version"],- "fixtureId": review_scene["fixtureId"],- "camera": review_scene["camera"],- "transform": review_scene["transform"],- "environment": review_scene["environment"],- "resolution": review_scene["resolution"],- "background": review_scene["background"],- "rendererVersion": review_scene["rendererVersion"],- "calibration": review_scene["calibration"],- },- "metrics": inputs,- "paintedRegions": region_results,- "perRegionConfidence": {region["id"]: region["confidence"] for region in region_results},- "hiddenRegionConfidence": hidden_confidence,- "approximationNotes": approximation_notes,- "failedGates": failed,- }- return report---def _load_object(path: Path, label: str) -> dict[str, Any]:- payload = json.loads(path.expanduser().read_text(encoding="utf-8"))- if not isinstance(payload, dict):- raise ValueError(f"{label} must be a JSON object")- return payload---def _write_json_atomic(path: Path, payload: dict[str, Any]) -> None:- target = path.expanduser().resolve()- target.parent.mkdir(parents=True, exist_ok=True)- handle, temporary = tempfile.mkstemp(prefix=f".{target.name}.", suffix=".tmp", dir=target.parent)- try:- with os.fdopen(handle, "w", encoding="utf-8") as stream:- json.dump(payload, stream, indent=2, ensure_ascii=False)- stream.write("\n")- stream.flush()- os.fsync(stream.fileno())- os.replace(temporary, target)- finally:- if os.path.exists(temporary):- os.unlink(temporary)---def main(argv: list[str] | None = None) -> int:- parser = argparse.ArgumentParser(description="Evaluate the blocking CS2 knife review contract")- parser.add_argument("--manifest", type=Path, required=True, help="validated cs2-intake.json")- parser.add_argument("--metrics", type=Path, required=True, help="render/review metrics JSON")- parser.add_argument(- "--scene",- type=Path,- default=Path("forge/tests/fixtures/knife_review_scene.json"),- help="versioned review scene fixture",- )- parser.add_argument("--out", type=Path, required=True, help="output review report JSON")- args = parser.parse_args(argv)- try:- manifest = _load_object(args.manifest, "manifest")- metrics = _load_object(args.metrics, "metrics")- scene = load_review_scene(args.scene.expanduser())- report = evaluate_knife_review(manifest, metrics, scene)- _write_json_atomic(args.out, report)- print(json.dumps(report, indent=2, ensure_ascii=False))- return 0 if report["verdict"] == "pass" else 1- except (OSError, ValueError, json.JSONDecodeError) as error:- print(f"error: {error}", file=sys.stderr)- return 2---if __name__ == "__main__":- raise SystemExit(main())diff --git a/forge/tests/fixtures/oracle-talon/cs2-intake.json b/forge/tests/fixtures/oracle-talon/cs2-intake.jsondeleted file mode 100644index 61e5fde..0000000--- a/forge/tests/fixtures/oracle-talon/cs2-intake.json+++ /dev/null@@ -1,389 +0,0 @@-{- "schemaVersion": 1,- "state": "proceed",- "sourceViews": [- {- "role": "front",- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "hash": 18347940451214977680,- "width": 2560,- "height": 1440,- "coverage": 0.2097,- "duplicate": false- },- {- "role": "back",- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-back.png",- "hash": 17771475369051842768,- "width": 2560,- "height": 1440,- "coverage": 0.2097,- "duplicate": false- }- ],- "admission": {- "admitted": true,- "reasons": [],- "provenance": {- "viewpoint": "reference",- "sourcePath": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "width": 2560,- "height": 1440,- "foregroundCoverage": 0.2097,- "largestComponentFraction": 1.0,- "pHash": 18347940451214977680,- "duplicateOfHash": null- }- },- "probe": {- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "type": "png",- "bytes": 1138300,- "width": 2560,- "height": 1440,- "aspectRatio": 1.7777777777777777,- "technicalSuitability": "pass",- "warnings": [],- "note": "This is only technical image probing. Semantic object suitability still requires visual inspection."- },- "heuristicSignal": {- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "is_cs2_candidate": true,- "confidence": 0.55,- "signals": [- "aspect_ratio_matches:knife_folder,pistol_angle",- "wide_format_workshop_render",- "neutral_background_steam_style",- "typical_render_file_size"- ],- "weapon_categories": [- "knife_folder",- "pistol_angle"- ],- "dimensions": {- "width": 2560,- "height": 1440,- "aspectRatio": 1.778- },- "color_profile": {- "dominant_range": "neutral_grey",- "energy": 218.77- },- "note": "This is a heuristic pre-analysis guard using file metadata and basic byte statistics. It does NOT perform visual analysis. The agent's vision layer (Step 1) performs definitive CS2 identification using the M.C.M.T framework in grimoire/intake/cs2_technical_analysis.md"- },- "exactnessTier": "image-only",- "route": "reference-projection",- "textureSource": "image-only",- "identity": {- "status": "resolved",- "identity": {- "itemFamily": "knife",- "subtype": "talon",- "confidence": 0.93,- "evidenceRefs": [- ".img2threejs/talon/refs/talon-front.png",- ".img2threejs/talon/refs/talon-back.png",- ".img2threejs/talon/evidence/reference-measurements.json",- ".img2threejs/talon/evidence/suitability-and-classification.md"- ],- "provider": "agent-vision/claude-opus-5",- "version": "1",- "timedOut": false,- "discriminatingEvidence": [- "closed circular finger ring at the butt, bore circularity 0.986 -> karambit/talon family",- "hawkbill blade with the cutting edge on the concave inner curve",- "three graduated circular through-holes in the blade flat (r 25.7 / 30.5 / 40.7 px, circularity 0.98-1.02) -> Talon marker, absent on Karambit",- "sawtooth jimping band on the upper spine (dark notch components at (876,484) and (889,454))",- "broad-bellied hawkbill rather than the Karambit's narrower, more sharply recurved blade"- ],- "candidates": [- {- "subtype": "talon",- "confidence": 0.93- },- {- "subtype": "karambit",- "confidence": 0.06- }- ],- "notes": "Classification owns semantic identity only; it does not set geometry or finish parameters. detect_cs2.py (is_cs2_candidate true, 0.55) was recorded as a non-authoritative routing hint only."- },- "provenance": "classification-record"- },- "finish": {- "provenance": "visual-observation+measured-pixels",- "confidence": 0.88,- "finishStyle": "anodized-multicolored",- "family": "doppler-ruby",- "evidenceRefs": [- ".img2threejs/talon/evidence/image-analysis.md#layer-6"- ],- "note": "finishStyle from the measured highlight shape + gradient stops, not from the skin name"- },- "assets": {- "source": "image-only",- "records": []- },- "camera": {- "status": "unknown",- "provenance": "not-supplied"- },- "provenance": {- "reference": "user-supplied",- "metadata": "csgo-api-unreachable-http-403; image-only path retained"- },- "assumptions": {- "float": "band 0.00-0.07 inferred from the user-supplied 'Factory New' wear name only; no exact per-item float",- "paintSeed": "not recoverable from an image; fixed centred placement, approximated: true",- "hiddenRegions": "both flats observed via front+back; the Z axis (grind, stock thickness, spine top, bore chamfer) is inference",- "paintIndexCandidate": "415 (Doppler Ruby) per docs/cs2/distill.md:123 - local doc evidence, candidate only, drives nothing",- "toneMapping": "render uses AgX, not the fixture's recorded ACESFilmic; the peak ruby is clipped at R=255 in the reference and ACES desaturates it toward pink (registry.ts:90-92)"- },- "confidence": {- "overall": 0.93,- "hiddenRegions": 0.35,- "perRegion": {- "silhouette-both-flats": 0.95,- "in-plane-proportions": 0.93,- "ruby-albedo-gradient": 0.88,- "hardware-placement": 0.92,- "ivory-albedo-staining": 0.85,- "blade-cross-section-grind": 0.45,- "thickness-in-z": 0.35,- "spine-top-face": 0.3,- "ring-bore-chamfer": 0.4,- "finger-choil-depth": 0.35,- "roughness-metalness-scalars": 0.6,- "paint-seed-float": 0.0- }- },- "warnings": [- "heuristicSignal"- ],- "extensions": {- "compatibilityMode": "manifest-v1"- },- "reviewScene": {- "version": "cs2-knife-review-v1",- "camera": {- "fovDegrees": 40.0,- "position": [- 0.0,- 0.0,- 3.0- ],- "target": [- 0.0,- 0.0,- 0.0- ]- },- "objectTransform": {- "position": [- 0.0,- 0.0,- 0.0- ],- "rotation": [- 0.0,- 0.0,- 0.0- ],- "scale": [- 1.0,- 1.0,- 1.0- ]- },- "environmentHash": "not-supplied",- "exposure": 1.0,- "toneMapping": "ACESFilmic",- "resolution": [- 1024,- 1024- ],- "background": "#20242a",- "rendererVersion": "three-r170",- "thresholds": {- "silhouetteIoU": 0.85,- "aspectRatioDelta": 0.05,- "scaleDelta": 0.08,- "paintedRegionMask": 0.85,- "colorRegion": 0.8,- "patternRegion": 0.75,- "wearRegion": 0.7- },- "orbitViewpoints": [- {- "yaw": 35.0,- "pitch": 8.0- },- {- "yaw": -35.0,- "pitch": 8.0- }- ]- },- "classification": {- "itemFamily": "knife",- "subtype": "talon",- "confidence": 0.93,- "evidenceRefs": [- ".img2threejs/talon/refs/talon-front.png",- ".img2threejs/talon/refs/talon-back.png",- ".img2threejs/talon/evidence/reference-measurements.json",- ".img2threejs/talon/evidence/suitability-and-classification.md"- ],- "provider": "agent-vision/claude-opus-5",- "version": "1",- "timedOut": false,- "discriminatingEvidence": [- "closed circular finger ring at the butt, bore circularity 0.986 -> karambit/talon family",- "hawkbill blade with the cutting edge on the concave inner curve",- "three graduated circular through-holes in the blade flat (r 25.7 / 30.5 / 40.7 px, circularity 0.98-1.02) -> Talon marker, absent on Karambit",- "sawtooth jimping band on the upper spine (dark notch components at (876,484) and (889,454))",- "broad-bellied hawkbill rather than the Karambit's narrower, more sharply recurved blade"- ],- "candidates": [- {- "subtype": "talon",- "confidence": 0.93- },- {- "subtype": "karambit",- "confidence": 0.06- }- ],- "notes": "Classification owns semantic identity only; it does not set geometry or finish parameters. detect_cs2.py (is_cs2_candidate true, 0.55) was recorded as a non-authoritative routing hint only."- },- "itemFamily": "knife",- "subtype": "talon",- "rawItemFamily": "knife",- "componentAdapter": "cs2-knife-v1",- "adapterRoute": "cs2-knife-v1",- "adapterContractVersion": "1",- "adapterFixtureId": "cs2-knife-front-v1",- "adapterContract": {- "family": "knife",- "subtype": "talon",- "topology": [- "ground-blade",- "curve-sweep",- "extrude",- "assembled-solid"- ],- "paintedRegions": [- "blade-painted",- "grip-painted",- "guard-bare-metal",- "pommel-bare-metal"- ],- "materialAssignments": [- "skin-finish",- "substrate"- ],- "featureTargets": [- "silhouette",- "blade-edge-spine",- "grip",- "guard-quillon",- "fastener",- "pommel"- ],- "attachmentRules": [- "guard-to-blade",- "grip-to-guard",- "pommel-to-grip"- ],- "reviewViewpoints": [- "reference",- "orbit-left",- "orbit-right"- ],- "adapterId": "cs2-knife-v1",- "contractVersion": "1",- "active": true,- "fixtureId": "cs2-knife-front-v1"- },- "admissionByView": {- "front": {- "admitted": true,- "reasons": [],- "provenance": {- "viewpoint": "reference",- "sourcePath": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "width": 2560,- "height": 1440,- "foregroundCoverage": 0.2097,- "largestComponentFraction": 1.0,- "pHash": 18347940451214977680,- "duplicateOfHash": null- }- },- "back": {- "admitted": true,- "reasons": [],- "provenance": {- "viewpoint": "back",- "sourcePath": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-back.png",- "width": 2560,- "height": 1440,- "foregroundCoverage": 0.2097,- "largestComponentFraction": 1.0,- "pHash": 17771475369051842768,- "duplicateOfHash": null- }- }- },- "probeByView": {- "front": {- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-front.png",- "type": "png",- "bytes": 1138300,- "width": 2560,- "height": 1440,- "aspectRatio": 1.7777777777777777,- "technicalSuitability": "pass",- "warnings": [],- "note": "This is only technical image probing. Semantic object suitability still requires visual inspection."- },- "back": {- "path": "/Users/tamlh/workspaces/self/AI/img2threejs-org/img2threejs/.img2threejs/talon/refs/talon-back.png",- "type": "png",- "bytes": 1099625,- "width": 2560,- "height": 1440,- "aspectRatio": 1.7777777777777777,- "technicalSuitability": "pass",- "warnings": [],- "note": "This is only technical image probing. Semantic object suitability still requires visual inspection."- }- },- "paintedRegions": {- "observedPainted": [- "blade-painted",- "tang-exposed-painted",- "pommel-ring-painted"- ],- "observedUnpainted": [- "grip-scale-ivory",- "hardware-brass",- "edge-apex-bare-steel"- ],- "adapterSeededPainted": [- "blade-painted",- "grip-painted",- "guard-bare-metal",- "pommel-bare-metal"- ],- "adapterRegionsNotPresentOnSubtype": [- "guard-bare-metal",- "guard-quillon"- ],- "divergenceNote": "The cs2-knife-v1 adapter seeds guard-bare-metal and a guard-quillon feature target. The Talon subtype has no crossguard or quillon; the blade runs straight into the scaled tang. The adapter list is preserved for auditability but the observed map is authoritative for this build, and guard-* regions must be reported not-applicable rather than scored as passing.",- "evidenceRefs": [- ".img2threejs/talon/evidence/image-analysis.md#layer-5",- ".img2threejs/talon/evidence/reference-measurements.json"- ]- }-}diff --git a/forge/tests/fixtures/oracle-talon/cs2-review-inputs.json b/forge/tests/fixtures/oracle-talon/cs2-review-inputs.jsondeleted file mode 100644index 3b40564..0000000--- a/forge/tests/fixtures/oracle-talon/cs2-review-inputs.json+++ /dev/null@@ -1,73 +0,0 @@-{- "_provenance": "All silhouette numbers are measured by forge/stage4_review/diagnose_render.py on renders/pass-final/front.png against renders/refplate/reference-front-1600.png (background-matched, 1600x900). Feature and region scores are agent-vision judgements against renders/pass-final/cmp-front.png, stated per the render_capture.md scorecard.",- "silhouetteIoU": 0.9654,- "aspectRatioDelta": 0.0149,- "scaleDelta": 0.0147,- "silhouetteIoUBack": 0.9559,- "finishMaterialResponse": 0.85,- "identityDetail": 0.9,- "_finishNote": "Measured region medians vs reference: ruby [135,20,25] vs [127,24,27] (dV +8, dS +10); ivory [163,162,160] vs [162,162,159] (dV +1, dS +1); brass [92,79,42] vs [122,106,64] (dV -30, dS +30). Divine Eye tonalParity 0.9578. Brass is 0.5% of frame and its hue-mask median is unstable under saturation change, so it is reported rather than treated as a confident 30-unit error.",- "paintedRegions": [- {- "id": "blade-painted",- "score": 0.9,- "confidence": 0.88,- "note": "de-lit front/back plates projected through the traced image->world mapping; measured ruby median within dV +8 / dS +10 of reference"- },- {- "id": "tang-exposed-painted",- "score": 0.82,- "confidence": 0.35,- "note": "the tang is OCCLUDED by the scales in both views; its painted extent is inferred, not observed"- },- {- "id": "pommel-ring-painted",- "score": 0.85,- "confidence": 0.85,- "note": "ruby coat continues onto the ring (reference crop share 0.96, median [89,12,17]); modelled with the solid measured ruby, not a plate, because the ring's own pixels are a thin arc"- }- ],- "_regionsNotApplicable": [- "guard-bare-metal and guard_quillon: the cs2-knife-v1 adapter and the knife_review_scene fixture both list a guard/quillon. A Talon has NO crossguard - the blade runs straight into the scaled tang - so these are reported not-applicable rather than scored as passing on a part that does not exist."- ],- "criticalFeatures": [- { "id": "hawkbill-silhouette", "score": 0.95, "threshold": 0.75, "note": "IoU 0.9654 front / 0.9559 back; aspect 2.908 render vs 2.883 reference" },- { "id": "spine-sawtooth-band", "score": 0.9, "threshold": 0.7, "note": "5 teeth at measured irregular pitches 64/61/69/139px, raked ratchet form, present in the traced outline as real geometry" },- { "id": "blade-hole-triad", "score": 0.95, "threshold": 0.75, "note": "3 real openings, radii 0.0245/0.0291/0.0388 world, growing toward the handle" },- { "id": "ruby-finish-response", "score": 0.85, "threshold": 0.7, "note": "projection route; gradient direction and crimson wisps read; measured dV +8 / dS +10. Residual: the spine specular is softer than the reference's" },- { "id": "grip-hardware-layout", "score": 0.88, "threshold": 0.7, "note": "7 rivets/side at measured positions, medallion with neutral-grey inlay + 4 spokes, 2 spacers with the aft one raked 12deg" },- { "id": "blade-cross-section-realism", "score": 0.82, "threshold": 0.6, "note": "variable-thickness loft; bladeBody distinct-Z 42 (a slab lands <=10); holds at three-quarter (ratio 0.880) and orbit-035 (0.929)" },- { "id": "tang-and-seam-continuity", "score": 0.75, "threshold": 0.6, "note": "blade->tang->ring is one continuous body with >=0.02 world seam overlap; the tang itself is inferred (confidence 0.35)" }- ],- "projection": {- "required": true,- "coverage": 0.92,- "source": "evidence/delit-regionwise-front.png + delit-regionwise-back.png",- "method": "mean-preserving per-region de-light, then planar projection that algebraically inverts the tracer's image->world mapping",- "note": "Coverage is 0.92 not 1.0: the broad +Z and -Z faces carry the plates, but walls, the ground bevel and hole interiors take a solid measured ruby because no reference pixel exists for a surface the camera never saw."- },- "multiAngle": {- "degenerate": false,- "collapseRatio": 0.15,- "angles": [- { "name": "orbit-035", "ratio": 0.929, "degenerate": false },- { "name": "orbit-325", "ratio": 0.881, "degenerate": false },- { "name": "orbit-180", "ratio": 1.007, "degenerate": false },- { "name": "three-quarter", "ratio": 0.88, "degenerate": false }- ],- "note": "The +-90 edge-on frames are excluded: the forge segmenter returns areaFraction 0.0 for them, while direct pixel measurement finds a real 97x545 sliver at 3.28% of frame. That is a segmentation limit on a 19:1 flat subject, not a collapsed volume - and a flat plane would also read ~0 at 90deg, so that angle cannot discriminate. The four angles above can, and none is degenerate."- },- "approximationNotes": [- "Every Z/thickness value is an inference: both references are broadside. bladeHalfStock 0.021, tangHalf 0.019, scaleHalf 0.019 (confidence 0.35).",- "Blade grind type modelled flat/sabre; hollow-vs-flat is not resolvable from a broadside (confidence 0.45).",- "The tang between blade base and ring is fully occluded; authored as a 62% vertical inset of the traced scale outline so blade and ring stay one body (confidence 0.35).",- "Rivet heads modelled as shallow domes; a broadside cannot separate a low dome from a flat pin (confidence 0.40).",- "Spacer strips modelled full-depth through the scale (confidence 0.40).",- "Ring bore chamfer profile not observable (confidence 0.40).",- "Paint seed and float are NOT recoverable from an image: fixed centred pattern placement and a Factory-New wear approximation, both marked approximated.",- "The ruby peak band's red channel is clipped at 255 in the source, so its true radiance is unknown and cannot be matched exactly.",- "Tone mapping is 'neutral' at exposure 0.70, chosen by a measured 16-way sweep. The registry documents 'agx' for a Ruby-Doppler blade, which is right for a procedural finish but was the WORST of 16 combinations here (dV +50 / dS -79) because the projected plate already carries the appearance.",- "The knife_review_scene fixture records environment.toneMapping as ACESFilmic; this build renders with NeutralToneMapping. The fixture's value is recorded scene metadata for the fixture itself and is not compared against the render, but the divergence is stated rather than left implicit.",- "Two small brass blobs appear on the BACK view only at (390,939) r 9.9 and (428,941) r 8.9 with no mirrored front counterpart. NOT modelled as hardware - recorded as an unexplained observation rather than invented as a part (confidence 0.30)."- ]-}diff --git a/forge/tests/fixtures/oracle-talon/cs2-review.json b/forge/tests/fixtures/oracle-talon/cs2-review.jsondeleted file mode 100644index 074b140..0000000--- a/forge/tests/fixtures/oracle-talon/cs2-review.json+++ /dev/null@@ -1,217 +0,0 @@-{- "verdict": "pass",- "action": "continue",- "family": "knife",- "subtype": "talon",- "exactnessTier": "image-only",- "route": "reference-projection",- "reviewScene": {- "version": 1,- "fixtureId": "cs2-knife-front-v1",- "camera": {- "projection": "orthographic",- "azimuthDegrees": 0,- "elevationDegrees": 0,- "rollDegrees": 0,- "target": [- 0,- 0,- 0- ]- },- "transform": {- "position": [- 0,- 0,- 0- ],- "rotationDegrees": [- 0,- 0,- 0- ],- "scale": [- 1,- 1,- 1- ]- },- "environment": {- "hash": "code-generated-room-v1",- "exposure": 0,- "toneMapping": "ACESFilmic"- },- "resolution": {- "width": 1024,- "height": 1024- },- "background": "neutral-white",- "rendererVersion": "three-runtime-contract-v1",- "calibration": {- "status": "thresholds-frozen-awaiting-positive-negative-render-corpus",- "positiveFixtures": [],- "negativeFixtures": []- }- },- "metrics": {- "_provenance": "All silhouette numbers are measured by forge/stage4_review/diagnose_render.py on renders/pass-final/front.png against renders/refplate/reference-front-1600.png (background-matched, 1600x900). Feature and region scores are agent-vision judgements against renders/pass-final/cmp-front.png, stated per the render_capture.md scorecard.",- "silhouetteIoU": 0.9654,- "aspectRatioDelta": 0.0149,- "scaleDelta": 0.0147,- "silhouetteIoUBack": 0.9559,- "finishMaterialResponse": 0.85,- "identityDetail": 0.9,- "_finishNote": "Measured region medians vs reference: ruby [135,20,25] vs [127,24,27] (dV +8, dS +10); ivory [163,162,160] vs [162,162,159] (dV +1, dS +1); brass [92,79,42] vs [122,106,64] (dV -30, dS +30). Divine Eye tonalParity 0.9578. Brass is 0.5% of frame and its hue-mask median is unstable under saturation change, so it is reported rather than treated as a confident 30-unit error.",- "paintedRegions": [- {- "id": "blade-painted",- "score": 0.9,- "confidence": 0.88,- "note": "de-lit front/back plates projected through the traced image->world mapping; measured ruby median within dV +8 / dS +10 of reference"- },- {- "id": "tang-exposed-painted",- "score": 0.82,- "confidence": 0.35,- "note": "the tang is OCCLUDED by the scales in both views; its painted extent is inferred, not observed"- },- {- "id": "pommel-ring-painted",- "score": 0.85,- "confidence": 0.85,- "note": "ruby coat continues onto the ring (reference crop share 0.96, median [89,12,17]); modelled with the solid measured ruby, not a plate, because the ring's own pixels are a thin arc"- }- ],- "_regionsNotApplicable": [- "guard-bare-metal and guard_quillon: the cs2-knife-v1 adapter and the knife_review_scene fixture both list a guard/quillon. A Talon has NO crossguard - the blade runs straight into the scaled tang - so these are reported not-applicable rather than scored as passing on a part that does not exist."- ],- "criticalFeatures": [- {- "id": "hawkbill-silhouette",- "score": 0.95,- "threshold": 0.75,- "note": "IoU 0.9654 front / 0.9559 back; aspect 2.908 render vs 2.883 reference"- },- {- "id": "spine-sawtooth-band",- "score": 0.9,- "threshold": 0.7,- "note": "5 teeth at measured irregular pitches 64/61/69/139px, raked ratchet form, present in the traced outline as real geometry"- },- {- "id": "blade-hole-triad",- "score": 0.95,- "threshold": 0.75,- "note": "3 real openings, radii 0.0245/0.0291/0.0388 world, growing toward the handle"- },- {- "id": "ruby-finish-response",- "score": 0.85,- "threshold": 0.7,- "note": "projection route; gradient direction and crimson wisps read; measured dV +8 / dS +10. Residual: the spine specular is softer than the reference's"- },- {- "id": "grip-hardware-layout",- "score": 0.88,- "threshold": 0.7,- "note": "7 rivets/side at measured positions, medallion with neutral-grey inlay + 4 spokes, 2 spacers with the aft one raked 12deg"- },- {- "id": "blade-cross-section-realism",- "score": 0.82,- "threshold": 0.6,- "note": "variable-thickness loft; bladeBody distinct-Z 42 (a slab lands <=10); holds at three-quarter (ratio 0.880) and orbit-035 (0.929)"- },- {- "id": "tang-and-seam-continuity",- "score": 0.75,- "threshold": 0.6,- "note": "blade->tang->ring is one continuous body with >=0.02 world seam overlap; the tang itself is inferred (confidence 0.35)"- }- ],- "projection": {- "required": true,- "coverage": 0.92,- "source": "evidence/delit-regionwise-front.png + delit-regionwise-back.png",- "method": "mean-preserving per-region de-light, then planar projection that algebraically inverts the tracer's image->world mapping",- "note": "Coverage is 0.92 not 1.0: the broad +Z and -Z faces carry the plates, but walls, the ground bevel and hole interiors take a solid measured ruby because no reference pixel exists for a surface the camera never saw."- },- "multiAngle": {- "degenerate": false,- "collapseRatio": 0.15,- "angles": [- {- "name": "orbit-035",- "ratio": 0.929,- "degenerate": false- },- {- "name": "orbit-325",- "ratio": 0.881,- "degenerate": false- },- {- "name": "orbit-180",- "ratio": 1.007,- "degenerate": false- },- {- "name": "three-quarter",- "ratio": 0.88,- "degenerate": false- }- ],- "note": "The +-90 edge-on frames are excluded: the forge segmenter returns areaFraction 0.0 for them, while direct pixel measurement finds a real 97x545 sliver at 3.28% of frame. That is a segmentation limit on a 19:1 flat subject, not a collapsed volume - and a flat plane would also read ~0 at 90deg, so that angle cannot discriminate. The four angles above can, and none is degenerate."- },- "approximationNotes": [- "Every Z/thickness value is an inference: both references are broadside. bladeHalfStock 0.021, tangHalf 0.019, scaleHalf 0.019 (confidence 0.35).",- "Blade grind type modelled flat/sabre; hollow-vs-flat is not resolvable from a broadside (confidence 0.45).",- "The tang between blade base and ring is fully occluded; authored as a 62% vertical inset of the traced scale outline so blade and ring stay one body (confidence 0.35).",- "Rivet heads modelled as shallow domes; a broadside cannot separate a low dome from a flat pin (confidence 0.40).",- "Spacer strips modelled full-depth through the scale (confidence 0.40).",- "Ring bore chamfer profile not observable (confidence 0.40).",- "Paint seed and float are NOT recoverable from an image: fixed centred pattern placement and a Factory-New wear approximation, both marked approximated.",- "The ruby peak band's red channel is clipped at 255 in the source, so its true radiance is unknown and cannot be matched exactly.",- "Tone mapping is 'neutral' at exposure 0.70, chosen by a measured 16-way sweep. The registry documents 'agx' for a Ruby-Doppler blade, which is right for a procedural finish but was the WORST of 16 combinations here (dV +50 / dS -79) because the projected plate already carries the appearance.",- "The knife_review_scene fixture records environment.toneMapping as ACESFilmic; this build renders with NeutralToneMapping. The fixture's value is recorded scene metadata for the fixture itself and is not compared against the render, but the divergence is stated rather than left implicit.",- "Two small brass blobs appear on the BACK view only at (390,939) r 9.9 and (428,941) r 8.9 with no mirrored front counterpart. NOT modelled as hardware - recorded as an unexplained observation rather than invented as a part (confidence 0.30)."- ]- },- "paintedRegions": [- {- "id": "blade-painted",- "score": 0.9,- "confidence": 0.88- },- {- "id": "tang-exposed-painted",- "score": 0.82,- "confidence": 0.35- },- {- "id": "pommel-ring-painted",- "score": 0.85,- "confidence": 0.85- }- ],- "perRegionConfidence": {- "blade-painted": 0.88,- "tang-exposed-painted": 0.35,- "pommel-ring-painted": 0.85- },- "hiddenRegionConfidence": 0.35,- "approximationNotes": [- "Every Z/thickness value is an inference: both references are broadside. bladeHalfStock 0.021, tangHalf 0.019, scaleHalf 0.019 (confidence 0.35).",- "Blade grind type modelled flat/sabre; hollow-vs-flat is not resolvable from a broadside (confidence 0.45).",- "The tang between blade base and ring is fully occluded; authored as a 62% vertical inset of the traced scale outline so blade and ring stay one body (confidence 0.35).",- "Rivet heads modelled as shallow domes; a broadside cannot separate a low dome from a flat pin (confidence 0.40).",- "Spacer strips modelled full-depth through the scale (confidence 0.40).",- "Ring bore chamfer profile not observable (confidence 0.40).",- "Paint seed and float are NOT recoverable from an image: fixed centred pattern placement and a Factory-New wear approximation, both marked approximated.",- "The ruby peak band's red channel is clipped at 255 in the source, so its true radiance is unknown and cannot be matched exactly.",- "Tone mapping is 'neutral' at exposure 0.70, chosen by a measured 16-way sweep. The registry documents 'agx' for a Ruby-Doppler blade, which is right for a procedural finish but was the WORST of 16 combinations here (dV +50 / dS -79) because the projected plate already carries the appearance.",- "The knife_review_scene fixture records environment.toneMapping as ACESFilmic; this build renders with NeutralToneMapping. The fixture's value is recorded scene metadata for the fixture itself and is not compared against the render, but the divergence is stated rather than left implicit.",- "Two small brass blobs appear on the BACK view only at (390,939) r 9.9 and (428,941) r 8.9 with no mirrored front counterpart. NOT modelled as hardware - recorded as an unexplained observation rather than invented as a part (confidence 0.30)."- ],- "failedGates": []-}diff --git a/forge/tests/test_cs2_oracle_replay.py b/forge/tests/test_cs2_oracle_replay.pydeleted file mode 100644index 54dbbe7..0000000--- a/forge/tests/test_cs2_oracle_replay.py+++ /dev/null@@ -1,67 +0,0 @@-"""Byte-equality replay of a completed CS2 run.--The fixture under fixtures/oracle-talon/ is lifted verbatim from a real finished reconstruction-(.img2threejs/talon: 23/25 steps done, verdict pass, silhouetteIoU 0.9654). It is the correctness-oracle for extracting CS2 into its own plugin: if the review report drifts by a single byte during-that work, this fails.--Deliberately a byte comparison rather than a semantic one. A semantic assertion would have to-enumerate what matters, and the whole point of an oracle is to catch the change nobody predicted ---a reordered key, a dropped note, a float rendered to a different precision.-"""--from __future__ import annotations--import json-import subprocess-import sys-import tempfile-import unittest-from pathlib import Path--ROOT = Path(__file__).resolve().parents[1]-ORACLE = Path(__file__).resolve().parent / "fixtures" / "oracle-talon"-CS2_REVIEW = ROOT / "stage4_review" / "cs2_review.py"---class Cs2OracleReplay(unittest.TestCase):- def test_replaying_the_completed_run_reproduces_its_review_byte_for_byte(self) -> None:- expected = (ORACLE / "cs2-review.json").read_bytes()- with tempfile.TemporaryDirectory() as tmp:- out = Path(tmp) / "replay.json"- proc = subprocess.run(- [- sys.executable,- str(CS2_REVIEW),- "--manifest",- str(ORACLE / "cs2-intake.json"),- "--metrics",- str(ORACLE / "cs2-review-inputs.json"),- "--out",- str(out),- ],- cwd=ROOT.parent,- capture_output=True,- text=True,- )- self.assertEqual(proc.returncode, 0, f"cs2_review.py failed:\n{proc.stderr}")- actual = out.read_bytes()-- self.assertEqual(- actual,- expected,- "CS2 review output drifted from the recorded oracle. If the change was intentional, "- "re-record the fixture in the same commit and say so -- do not relax this assertion.",- )-- def test_the_oracle_records_a_passing_verdict(self) -> None:- # Guards against the fixture being replaced by a failing run, which would make the byte- # comparison above pass while proving nothing about a working pipeline.- report = json.loads((ORACLE / "cs2-review.json").read_text())- self.assertEqual(report["verdict"], "pass")- self.assertEqual(report["failedGates"], [])- self.assertGreaterEqual(report["metrics"]["silhouetteIoU"], 0.95)---if __name__ == "__main__":- unittest.main()diff --git a/forge/tests/test_cs2_review.py b/forge/tests/test_cs2_review.pydeleted file mode 100644index 5827b3c..0000000--- a/forge/tests/test_cs2_review.py+++ /dev/null@@ -1,143 +0,0 @@-from __future__ import annotations--import json-import sys-import tempfile-import unittest-from contextlib import redirect_stdout-from io import StringIO-from pathlib import Path--ROOT = Path(__file__).resolve().parent.parent-sys.path.insert(0, str(ROOT / "stage4_review"))--from cs2_review import evaluate_knife_review, load_review_scene, main as cs2_review_main # noqa: E402-from append_review import main as append_review_main # noqa: E402---class Cs2ReviewGateTest(unittest.TestCase):- def setUp(self) -> None:- self.scene = load_review_scene(ROOT / "tests" / "fixtures" / "knife_review_scene.json")- self.manifest = {- "schemaVersion": 1,- "state": "proceed",- "itemFamily": "knife",- "subtype": "karambit",- "componentAdapter": "cs2-knife-v1",- "route": "reference-projection",- "exactnessTier": "image-only",- "confidence": {"overall": 0.86, "hiddenRegions": 0.25},- "assumptions": {"hiddenRegions": "inferred"},- }-- def passing_inputs(self) -> dict:- return {- "silhouetteIoU": 0.91,- "aspectRatioDelta": 0.02,- "scaleDelta": 0.04,- "finishMaterialResponse": 0.88,- "identityDetail": 0.9,- "paintedRegions": [{"id": "blade_finish", "score": 0.9, "confidence": 0.8}],- "projection": {"coverage": 0.94, "required": True},- "multiAngle": {"degenerate": False, "angles": [{"id": "orbit-a"}, {"id": "orbit-b"}]},- "criticalFeatures": [{"id": "karambit_ring", "score": 0.9, "threshold": 0.8}],- "approximationNotes": ["hidden blade side inferred from single view"],- }-- def test_passing_knife_review_returns_machine_readable_report(self) -> None:- report = evaluate_knife_review(self.manifest, self.passing_inputs(), self.scene)-- self.assertEqual(report["verdict"], "pass")- self.assertEqual(report["action"], "continue")- self.assertEqual(report["family"], "knife")- self.assertEqual(report["exactnessTier"], "image-only")- self.assertEqual(report["reviewScene"]["version"], 1)- self.assertEqual(report["failedGates"], [])- self.assertEqual(report["approximationNotes"], ["hidden blade side inferred from single view"])-- def test_cli_writes_report_and_returns_verdict_status(self) -> None:- with tempfile.TemporaryDirectory() as directory:- root = Path(directory)- manifest_path = root / "manifest.json"- metrics_path = root / "metrics.json"- report_path = root / "report.json"- manifest_path.write_text(json.dumps(self.manifest), encoding="utf-8")- metrics_path.write_text(json.dumps(self.passing_inputs()), encoding="utf-8")- with redirect_stdout(StringIO()):- result = cs2_review_main([- "--manifest", str(manifest_path),- "--metrics", str(metrics_path),- "--scene", str(ROOT / "tests" / "fixtures" / "knife_review_scene.json"),- "--out", str(report_path),- ])- self.assertEqual(result, 0)- self.assertEqual(json.loads(report_path.read_text(encoding="utf-8"))["verdict"], "pass")-- def test_wrong_family_is_blocking_even_when_visual_metrics_pass(self) -> None:- manifest = {**self.manifest, "itemFamily": "rifle"}-- report = evaluate_knife_review(manifest, self.passing_inputs(), self.scene)-- self.assertEqual(report["verdict"], "reject")- self.assertEqual(report["action"], "request-input")- self.assertIn("unsupported-family:rifle", report["failedGates"])-- def test_projection_coverage_and_identity_detail_are_blocking(self) -> None:- inputs = self.passing_inputs()- inputs["projection"] = {"coverage": 0.42, "required": True}- inputs["criticalFeatures"] = [{"id": "karambit_ring", "score": 0.4, "threshold": 0.8}]-- report = evaluate_knife_review(self.manifest, inputs, self.scene)-- self.assertEqual(report["verdict"], "reject")- self.assertEqual(report["action"], "refine-code")- self.assertIn("projection-coverage", report["failedGates"])- self.assertIn("critical-feature:karambit_ring", report["failedGates"])-- def test_degenerate_orbit_is_blocking_and_missing_scene_metadata_is_error(self) -> None:- inputs = self.passing_inputs()- inputs["multiAngle"] = {"degenerate": True, "angles": [{"id": "orbit-a", "degenerate": True}]}- report = evaluate_knife_review(self.manifest, inputs, self.scene)- self.assertEqual(report["verdict"], "reject")- self.assertIn("degenerate-orbit", report["failedGates"])-- with tempfile.TemporaryDirectory() as directory:- path = Path(directory) / "invalid.json"- path.write_text(json.dumps({"version": 1}), encoding="utf-8")- with self.assertRaises(ValueError):- load_review_scene(path)-- def test_append_review_persists_cs2_report_and_rejects_failed_report(self) -> None:- report = evaluate_knife_review(self.manifest, self.passing_inputs(), self.scene)- failed = evaluate_knife_review(- self.manifest,- {**self.passing_inputs(), "identityDetail": 0.2},- self.scene,- )- with tempfile.TemporaryDirectory() as directory:- root = Path(directory)- spec_path = root / "spec.json"- report_path = root / "report.json"- failed_path = root / "failed.json"- spec_path.write_text(json.dumps({"sourceImage": "ref.png"}), encoding="utf-8")- report_path.write_text(json.dumps(report), encoding="utf-8")- failed_path.write_text(json.dumps(failed), encoding="utf-8")- append_review_main([- str(spec_path), "--pass-id", "optimization-pass", "--fidelity", "0.9",- "--action", "continue", "--summary", "ok", "--cs2-review-json", str(report_path),- "--review-scene-json", str(ROOT / "tests" / "fixtures" / "knife_review_scene.json"),- "--force-out-of-order",- "--in-place",- ])- persisted = json.loads(spec_path.read_text(encoding="utf-8"))- self.assertEqual(persisted["reviewHistory"][0]["cs2Review"]["verdict"], "pass")- with self.assertRaises(ValueError):- append_review_main([- str(spec_path), "--pass-id", "optimization-pass", "--fidelity", "0.9",- "--action", "continue", "--summary", "blocked", "--cs2-review-json", str(failed_path),- "--force-out-of-order",- ])---if __name__ == "__main__":- unittest.main(verbosity=2)diff --git a/forge/tests/test_pipeline.py b/forge/tests/test_pipeline.pyindex 6464df1..77b6f92 100644--- a/forge/tests/test_pipeline.py+++ b/forge/tests/test_pipeline.py@@ -82,19 +82,18 @@ class PipelineTest(unittest.TestCase):self.assertEqual(spec["schemaVersion"], "2.1")self.assertEqual(spec["targetName"], "Oak")- def test_cs2_assessment_embeds_local_spec_search_results(self):+ def test_assessment_embeds_local_spec_search_results(self):r = run("stage2_spec/new_pre_spec_assessment.py","Karambit Fade",- "--collection",- "cs2","--out",self.assessment,)self.assertEqual(r.returncode, 0, r.stderr)assessment = json.loads(self.assessment.read_text())search = assessment["localSpecSearch"]- self.assertEqual(search["collection"], "cs2")+ # The cs2 collection ships with the CS2 plugin; a base checkout searches the generic one.+ self.assertEqual(search["collection"], "core_3d")self.assertEqual(search["query"], "Karambit Fade")self.assertGreater(len(search["matches"]), 0)self.assertTrue(search["matches"][0]["source_refs"])@@ -110,7 +109,7 @@ class PipelineTest(unittest.TestCase):)self.assertEqual(r.returncode, 0, r.stderr)spec = json.loads(self.spec.read_text())- self.assertEqual(spec["localSpecSearch"]["collection"], "cs2")+ self.assertEqual(spec["localSpecSearch"]["collection"], "core_3d")self.assertTrue(spec["localSpecSearch"]["matches"])def test_generic_assessment_uses_generic_spec_collection(self):diff --git a/forge/tests/test_search_specs.py b/forge/tests/test_search_specs.pyindex 90539a5..9478b05 100644--- a/forge/tests/test_search_specs.py+++ b/forge/tests/test_search_specs.py@@ -55,9 +55,10 @@ REQUIRED_STRING_FIELDS = ("observation_status",)REQUIRED_LIST_FIELDS = ("aliases", "constraints", "measurements", "source_refs", "evidence_refs", "assumptions")+# cs2.jsonl moved to the CS2 domain plugin, which asserts its own records. A base checkout holds+# only the generic corpus.DISTILLED_RECORD_PATHS = (ROOT / "docs/specs/vocabulary/core_3d.jsonl",- ROOT / "docs/specs/vocabulary/cs2.jsonl",)DISTILLED_RECORD_FIELDS = frozenset((*REQUIRED_STRING_FIELDS, *REQUIRED_LIST_FIELDS, "confidence"))@@ -361,16 +362,16 @@ class DistilledRecordTest(unittest.TestCase):def test_reviewed_bilingual_records_are_complete_and_source_backed(self):records_by_path = {path: load_contract_fixture(path) for path in DISTILLED_RECORD_PATHS}core_records = records_by_path[DISTILLED_RECORD_PATHS[0]]- cs2_records = records_by_path[DISTILLED_RECORD_PATHS[1]]all_records = [record for records in records_by_path.values() for record in records]self.assertGreaterEqual(len(core_records), 12)- self.assertGreaterEqual(len(cs2_records), 8)self.assertEqual(len({record["record_id"] for record in all_records}), len(all_records))self.assertTrue(all(set(record) <= DISTILLED_RECORD_FIELDS for record in all_records))self.assertTrue(all(record["source_refs"] for record in all_records))aliases = {alias.casefold() for record in all_records for alias in record["aliases"]}+ # Karambit anatomy (safety ring, pommel) and the wear pair live in the CS2 corpus, which the+ # plugin now owns and asserts. Everything below is in the generic corpus, verified against it.self.assertTrue({"socket",@@ -379,12 +380,6 @@ class DistilledRecordTest(unittest.TestCase):"điểm xoay","roughness","độ thô",- "wear",- "hao mòn",- "safety ring",- "vòng ngón",- "pommel",- "chuôi cuối","attachment","gắn kết",}.issubset(aliases)@@ -397,10 +392,6 @@ class DistilledRecordTest(unittest.TestCase):"grimoire/readiness/action_rigging.md","grimoire/readiness/joint_attachment.md","grimoire/intake/image_analysis.md",- "docs/cs2/3D_Technical_Mapping.json",- "docs/cs2/3D_Vocabulary_CS2.json",- "docs/cs2/distill.md",- "docs/cs2-anatomy/knives.md",}.issubset(source_paths))@@ -446,15 +437,6 @@ class TokenizerTest(unittest.TestCase):class SourceIngestionTest(unittest.TestCase):- def test_profile_loader_exposes_cs2_cache_and_documentation(self):- profile = load_profiles()["cs2"]-- self.assertEqual(profile["cache"], ".cache/spec-search/cs2.json")- self.assertEqual(profile["documentation"], "docs/specs/vocabulary/README.md")- self.assertEqual(profile["encoding"], "utf-8")- self.assertEqual(profile["source_roots"], [])- self.assertEqual(profile["optional_source_roots"], ["docs/cs2/", "docs/cs2-anatomy/"])-def test_profile_loader_rejects_malformed_and_unknown_collections(self):with tempfile.TemporaryDirectory() as temporary_directory:malformed_profile = Path(temporary_directory) / "profiles.json"diff --git a/forge/tests/test_suite_integrity.py b/forge/tests/test_suite_integrity.pyindex 589b17e..dbbae11 100644--- a/forge/tests/test_suite_integrity.py+++ b/forge/tests/test_suite_integrity.py@@ -24,7 +24,13 @@ TESTS_DIR = Path(__file__).resolve().parent# Raise this deliberately when tests are added; never lower it to make a red suite green. A drop# means tests stopped being collected, which is the failure this file exists to catch.-COLLECTED_FLOOR = 1134+#+# Lowered once, deliberately and with accounting: 1134 -> 1125 when the CS2 domain moved to its own+# plugin. Nine tests left this suite: 2 oracle-replay and 5 cs2_review unit tests now run in the+# plugin's standalone suite, 1 asserted a profile collection the plugin owns, and 1 needed both the+# base's append_review and the plugin's cs2_review so it could live on neither side. Relocated, not+# lost -- and the import guard above is what caught test_cs2_foundation going dark during the move.+COLLECTED_FLOOR = 1125REPO_ROOT = TESTS_DIR.parents[1]diff --git a/forge/tests/test_workflow_state.py b/forge/tests/test_workflow_state.pyindex 37a7ed8..c0e58b4 100644--- a/forge/tests/test_workflow_state.py+++ b/forge/tests/test_workflow_state.py@@ -365,7 +365,7 @@ class WorkflowStateTest(unittest.TestCase):def test_skill_router_keeps_mandatory_state_and_reference_gates_visible(self):skill = (ROOT / "SKILL.md").read_text(encoding="utf-8")self.assertIn("forge/next.py --state .img2threejs/state.json", skill)- self.assertIn("MUST read `grimoire/intake/cs2_intake_contract.md` completely", skill)+ self.assertIn("MUST read the CS2 plugin's `cs2_intake_contract.md` completely", skill)self.assertIn("MUST read\n `grimoire/review/gates_reference.md`", skill)self.assertIn("forge/stage4_review/diagnose_render.py", skill)self.assertIn("forge/stage4_review/diagnose_render_multi_angle.py", skill)@@ -373,7 +373,8 @@ class WorkflowStateTest(unittest.TestCase):def test_all_direct_router_references_exist(self):for relative in (- "grimoire/intake/cs2_intake_contract.md",+ # cs2_intake_contract.md is deliberately absent: it ships with the CS2 domain plugin,+ # so a base checkout must NOT be expected to hold it."grimoire/intake/local_spec_search.md","grimoire/review/gates_reference.md","grimoire/review/self_correction.md",diff --git a/grimoire/build/cs2_finishes.md b/grimoire/build/cs2_finishes.mddeleted file mode 100644index 41a41d0..0000000--- a/grimoire/build/cs2_finishes.md+++ /dev/null@@ -1,126 +0,0 @@-# CS2 / Steam Item Finishes--Rulebook for the supported CS2 **knife** finish track. The reconstruction stays **image-first**: a-reference image is the only required input. A skin name, descriptor (`finishStyle`, `float`,-`paintSeed`), or an extracted Valve texture are optional layers that add exactness when the user-supplies them — they never block the default path.--**Two finish routes, chosen by goal — do NOT default to procedural for a reference-match.**--This rulebook does not authorize pistol, rifle, SMG, sniper, heavy, glove, or unknown knife-subtypes. Intake must return `unsupported-family` or `unsupported-subtype` before finish selection-for those families. The route (`reference-projection`, `authored-texture`, or `procedural-finish`)-and evidence tier (`image-only`, `metadata-assisted`, or `exact-texture`) are separate fields in-`cs2-intake.json`; a route fallback never changes the evidence tier.--- **Projection (default when the goal is matching a specific reference image — e.g. rebuilding a- named skin from its photo):** author the geometry procedurally, then project the **de-lit**- reference crop onto the blade/grip as the finish and bake it into UVs — camera-match- (`solve_camera_pose.py`) → de-light (`delight_albedo.py`) → project + bake- (`bake_projected_texture.py`). Recipe: `grimoire/character/likeness_maximization.md` (its levers- generalize from faces to objects). This is what reaches reference fidelity for patterned finishes- (Doppler / Gamma Doppler / Marble Fade / Fade), and is what the v1.3 baseline demos use. A- procedural finish for a patterned skin reads visibly wrong beside the reference — that mismatch- is the #1 CS2 fidelity failure.-- **Procedural per finish style (default ONLY when live view-dependent response matters more than- matching one reference):** build the finish from independent PBR channels + paint-seed for a real- environment/anodized response.--**Never** project the raw 2D inventory **icon** as albedo: an icon is a flat render with baked-lighting, no paint-seed, no PBR channels, no environment response; projecting *that* locks in one-wrong, flat-lit pattern. The projection route sidesteps this by **de-lighting first** — the real-distinction is *de-lit reference crop* (the fidelity path) vs *raw flat-lit icon* (banned), NOT-projection vs procedural.--## Identity precedence (who decides the finish style)--`resolve_cs2_finish_style()` (in `forge/stage2_spec/new_sculpt_spec.py`) resolves in order:--1. **explicit descriptor** (`--finish-style`) —-2. **skin name** (`--skin-name`, mapped by `SKIN_NAME_FINISH_HINTS`) —-3. **vision inference** (`--vision-finish-style` + `--vision-confidence`).--A vision read below the confidence threshold (default 0.55) is still used but **flagged**, never-silently dropped. When two sources disagree, the higher-precedence one wins **and the conflict is-written to `preSpecAssessment.unknownsToResolveBeforeImplementation`** — never silently-overwritten. With nothing resolvable, the default is `anodized-multicolored` (the Doppler case the-track exists to fix).--## Finish styles--Eight styles, each with its own PBR recipe and macro/meso/micro `surfaceFrequencyBands`-(`CS2_FINISH_PROFILES`):--| finishStyle | metalness | roughness | view-dependent | note |-|---|---|---|---|---|-| `solid` | low | mid | no | near-uniform lacquer |-| `hydrographic` | low | mid | no | dip-film swirl print |-| `anodized` | high | low | **yes** | dyed metal; colour from reflections |-| `spray-paint` | low | high | no | matte overspray speckle |-| `anodized-multicolored` | high | very low | **yes** | Doppler/Marble-Fade; strong env |-| `custom-paint-job` | low–mid | mid | no | non-tiled illustrative art over dark substrate |-| `patina` | mid | mid | no | oxidation: darkens/hue-shifts with wear |-| `gunsmith` | mid | mid | no | custom-paint ↔ patina mask blend |--**View-dependent** finishes (`anodized`, `anodized-multicolored`) read their colour from-environment reflections. Without an environment map + filmic tonemapping they render muddy — see-*Environment* below.--## Float → wear--`_cs2_wear_mask(float_value)` maps a CS2 float `0.0` (Factory New) … `1.0` (Battle-Scarred) to a-wear mask (albedo-alpha wearness curve + AO bias + curvature-weighted edge scratches/chips), so-scratching concentrates on exposed edges and recesses accumulate grime. Higher float → higher-`edgeWear`, scratches above ~0.15, chips above ~0.55.--With **no float** (image-only default) the mask is an approximated light-moderate condition-estimated from the visible reference and marked `approximated: true` — never presented as an exact-per-item float.--## Paint seed → pattern placement--`_cs2_pattern_affine(paint_seed)` derives a deterministic `A = T2·R·S·T1` affine (rotation +-translation + scale, and the resulting 2×3 matrix) from the seed, so two items sharing a skin but-differing in seed place the pattern differently, and the same seed reproduces identically.--With **no paint seed** (image-only default) a fixed centered placement is used and marked-`approximated: true` — it reproduces the skin's *look*, not a specific item's exact "Max" pattern.-Exact per-item seed matching (community pattern DB / inspect-link) is a deferred follow-up.--## PBR and environment--- **Material**: metallic-roughness `MeshPhysicalMaterial` with independent map channels (never- alias albedo into roughness/normal/AO). Profiles seed metalness / roughness / clearcoat /- `envMapIntensity`.-- **Environment (code-generated default)**: `create<Name>Environment(renderer, hdriUrl?)` in the- generated factory builds a `RoomEnvironment` → `PMREMGenerator` IBL **in code — no bundled image- asset**, so the image-only path always has one. A user HDRI (`hdriUrl`, via `RGBELoader`) is an- optional realism upgrade; it falls back to the code-generated default on omission or load- failure.-- **Renderer**: `configure<Name>Renderer(renderer)` sets `ACESFilmicToneMapping` + `SRGBColorSpace`- — load-bearing for view-dependent finishes, not cosmetic.-- **Inspect**: `create<Name>InspectControls(camera, domElement)` wraps `OrbitControls` tuned for- close inspection, because a view-dependent finish only reads correctly in motion.--### The no-environment gate--`validate_cs2_view_dependent_environment()` (in `validate_sculpt_spec.py`) **blocks generation-only** when a `needsEnvironment` material would render with no environment at all — i.e.-`cs2Finish.environmentAvailable` is explicitly `false` (`--no-environment`). Because the-code-generated default always exists otherwise, this is a last-resort guard, **not** the common-path: the flagship image-only Doppler case passes normally.--## Complexity tier & detail floor--A supported CS2 knife skin always carries more identity-defining detail than a generic object-at the same structural tier, so `--cs2` **defaults the complexity tier to `ultra-complex`**-(`targetMinDetails` 16) — the CS2 track is held to the top fidelity bar regardless of how simple-the bare geometry looks. If `--complexity` is set lower by hand, the detail-count floor still-never drops below **9** (see `grimoire/intake/quality_contract.md`).--## Honest ceiling--Image-only reproduces the skin's *look* faithfully but cannot recover a specific item's exact paint-seed / float — the pipeline reports these as approximated rather than implying a byte-exact match.-For exactness, layer in a descriptor or extracted Valve textures-(`grimoire/intake/cs2_texture_acquisition.md`).diff --git a/grimoire/intake/cs2_intake_contract.md b/grimoire/intake/cs2_intake_contract.mddeleted file mode 100644index f05cd9e..0000000--- a/grimoire/intake/cs2_intake_contract.md+++ /dev/null@@ -1,80 +0,0 @@-# CS2 Intake Contract--Read this reference completely for every CS2 request before creating `cs2-intake.json` or running-pre-spec assessment. Do not advance the local checklist until its classification and manifest-requirements are satisfied.--For a CS2 item, the target is observable agreement between the supplied image and the rendered-item: silhouette, proportions, edge profile, hardware layout, coating colour, pattern placement,-wear, roughness response, and camera framing. Every decision must be traceable to evidence or be-labelled as an approximation.--The initial CS2 family boundary is **knife only**. Pistol, rifle, SMG, sniper, heavy, glove, and-unknown knife subtypes must stop with `unsupported-family` or `unsupported-subtype`; they must not-receive the knife component tree as a generic fallback.--## When to build `cs2-intake.json`--For a CS2 request, create and validate `cs2-intake.json` before pre-spec authoring. Run admission-and probing for every source view, record the heuristic signal as non-authoritative evidence,-attach the classification record, resolve the supported family, and choose `route` independently-from `exactnessTier`. Missing classification, insufficient coverage, or a contradictory-high-confidence class is `request-input`; unsupported families do not continue into spec-generation.--## Layer contract--Pass these records between layers. Do not copy an informal vision description into the next stage:--| Layer | Owns | Must emit | Must not decide alone |-| --- | --- | --- | --- |-| Intake | view validity and technical evidence | role, path/hash, resolution, coverage, duplicate status, admission verdict | item identity from aspect ratio or filename |-| Classification | semantic identity | family, subtype, confidence, evidence refs, provider/version, timeout state | geometry or finish parameters |-| Identity | skin/name/paint metadata | precedence, resolved values, ambiguity candidates, provenance | guessed paint index, float, or seed |-| Surface evidence | pixels and texture sources | de-lit reference, PBR channels, map provenance, colour space, UV orientation, confidence | albedo reused as roughness/normal/AO |-| Geometry adapter | family-specific form | component tree, topology, dimensions, edge/spine, hardware relationships, painted regions | hidden geometry without confidence notes |-| Spec/route | evidence-backed implementation choice | route, exactness tier, assumptions, feature targets, camera contract | exact-texture claim without exact evidence |-| Build/review | rendered observables | fixed view, two non-degenerate orbit views, per-region results, failed gates, next action | overriding a failed critical feature with a global score |--The canonical hand-off is `cs2-intake.json` (`schemaVersion: 1`). Its state is one of-`proceed`, `request-input`, `fallback`, `rejected`, `unsupported-family`, or-`unsupported-subtype`. Write it atomically and preserve unknown provider fields under-`extensions`; a fallback must never erase prior evidence.--## CS2 intake order--1. Admit and technically probe every view. Reject undecodable, empty, tiny, fragmented, or- duplicate references before classification.-2. Record the heuristic CS2 signal only as a routing hint. `detect_cs2.py` is never authoritative- identity evidence.-3. Require a classification record before selecting a family adapter. If classification is absent,- timed out, or contradicts a high-confidence objectness result, return `request-input`.-4. Resolve identity in this order: explicit user metadata, uniquely resolved metadata, then the- authoritative classification record. Preserve ambiguity rather than guessing.-5. Select route and exactness independently:- - `reference-projection`: default for matching a specific patterned image;- - `authored-texture`: only when independent texture maps are supplied or legally acquired;- - `procedural-finish`: fallback when projection evidence is unavailable or live response is the- stated priority.- Exactness is `image-only`, `metadata-assisted`, or `exact-texture`; changing route must not- silently upgrade or downgrade the evidence tier.-6. Select the knife adapter only after family/subtype validation. Record painted regions, unpainted- substrate, visible hardware, hidden-region confidence, and every approximation in the spec.-7. For projection, solve the camera and de-light the source first. Projected pixels provide colour- evidence, not automatic geometry truth; geometry still comes from the adapter and silhouette- review.--## Surface and review rule--For a specific CS2 reference, preserve the reference's own colour/pattern pixels whenever legal and-technically possible. Procedural Doppler/Fade/Gamma/Marble patterns are not equivalent to the input-image and may only be used with an explicit `procedural-finish` route and approximation warning.-Keep albedo, roughness, metalness, normal/height, AO, mask, and wear as independent channels. Record-channel source, colour space, UV orientation, dimensions, packed-channel decoding, and missing-channel-derivation. A low-confidence PBR inference is a refine-input signal, not proof of exact material.--Single-view reconstruction may proceed only when visible identity features are sufficiently covered;-hidden blade sides, underside, and back hardware must carry inference confidence and may trigger-`request-input`. Review the fixed camera plus two meaningful orbit views. Report what changed, which-evidence caused it, what still differs, and choose exactly one next action:-`continue`, `refine-spec`, `refine-code`, `request-input`, or `stop`.diff --git a/grimoire/intake/cs2_technical_analysis.md b/grimoire/intake/cs2_technical_analysis.mddeleted file mode 100644index 20a1d38..0000000--- a/grimoire/intake/cs2_technical_analysis.md+++ /dev/null@@ -1,88 +0,0 @@-# CS2 Technical Analysis & Reverse-Engineering Protocol--**Role:** You are an Expert 3D Technical Director specialized in CS2 (Counter-Strike 2) weapon and item pipelines.-**Integration:** This protocol operates during Step 1 (Analysis) and Step 3 (Spec Authoring) of the `img2threejs` pipeline.--## Core Mandates (img2threejs Alignment)-1. **No One-Shot Meshes:** Deconstruct the item into logical components. Do not attempt to describe a single blob mesh.-2. **Procedural Geometry + Projected Finish:** For CS2 patterned skins (Doppler, Fade, Crimson Web), the geometry (blade/guard/grip profiles) is procedural, but the *finish* must be planned as a de-lit reference-crop projection. Do not hallucinate procedural noise for complex skins.-3. **Transparent Debugging:** Explicitly name what is visible, what is inferred, and what the single 2D view obscures. If an identity-defining feature cannot be determined, flag it for `request-input`.--## The M.C.M.T Framework for CS2--Analyze the provided orthographic 2D reference images using this exact framework:--* **Macro Shape:** Overall bounding box, primary silhouette taper (e.g., wedge grind of a blade), and axis alignment.-* **Components (CS2 Anatomy):** Strictly divide the item using correct nomenclature: `Blade` (Edge, Spine, Swedge/Clip-point, Ricasso), `Guard/Quillon`, `Handle/Grip` (Scales, Tang), `Pommel`, `Fasteners` (Rivets, Screws).-* **Materials (PBR):** Extract strict Three.js `MeshStandardMaterial` / `MeshPhysicalMaterial` values.- * Identify if a texture is Solid Paint vs. Anodized Metal vs. Projected Skin.- * Identify Micro-surface data for Normal maps (e.g., hexagonal grip knurling, spine serrations).-* **Topology:** Define base primitives (Plane, Box, Cylinder) and modifiers (Extrusion profiles, Bevels for edge highlights, Boolean cuts for holes). Do not model micro-details (use normal maps).--## Weathering & Surface Imperfections-CS2 items rely heavily on wear and tear (Float values). Identify:-* **Edge Wear:** Paint chipping on sharp geometry edges exposing base metal.-* **Patina/Rust:** Oxidation changing Base Color, dropping Metalness to `0.0`, and spiking Roughness to `0.8+`.-* **Scratches/Dents:** High-frequency normal map alterations.--## Review hand-off--Use `forge/tests/fixtures/knife_review_scene.json` as the versioned review-scene-contract. It owns the camera, environment hash, exposure, tone mapping, resolution,-background, renderer version, and calibrated knife thresholds. The report from-`forge/stage4_review/cs2_review.py` must preserve family identity, route, exactness-tier, painted-region scores, projection coverage, critical identity-detail scores,-per-region confidence, hidden-region confidence, and approximation notes.--The initial fixture is user-supplied and marked `user-supplied-review-required`-until rights provenance is verified. No extracted Valve texture may be committed or-used to imply an exact-texture result. A single-view result may proceed only when-visible identity features and the two orbit checks pass; hidden regions remain-inferred and confidence-labeled.-------## Required JSON Output Schema--When instructed to output the CS2 analysis, you MUST return a valid JSON object matching this exact schema. Do not output markdown code blocks wrapping the JSON if writing directly to a file, and do not include conversational text.--{- "itemClassification": {- "cs2_type": "Specific weapon/knife type (e.g., Bowie Knife, Karambit)",- "skin_type": "Identify if Solid, Anodized, or Pattern/Custom Paint (requires projection)",- "visibility_warnings": "List features obscured by the 2D view (e.g., blade thickness, hidden side symmetry)"- },- "threejs_environment": {- "hdri_required": true,- "lighting_notes": "Required setup to validate metalness (e.g., strong point light for edge highlights)"- },- "featureReviewTargets": [- "List 3-5 critical identity-defining geometry/material targets for the review gates"- ],- "components": [- {- "anatomy_part": "e.g., Blade Profile",- "topology_directives": {- "primitive": "Base Three.js primitive",- "construction_rule": "e.g., Extrude 2D shape, apply bevel to cutting edge. Taper Z-thickness towards the tip.",- "boolean_operations": "e.g., Subtraction for lanyard hole"- },- "material_directives": {- "material_type": "MeshPhysicalMaterial",- "render_strategy": "procedural | projected_crop",- "pbr_base": {- "baseColor": "Hex or descriptor",- "metalness": 1.0,- "roughness": 0.15,- "clearcoat": 0.0- },- "normal_map_requirements": "Description of normal map needed (e.g., None, or Hexagonal Grip)"- },- "weathering_and_imperfections": {- "has_wear": true,- "wear_types": ["Edge Wear", "Scratches"],- "pbr_overrides": "e.g., Edge wear reveals silver albedo, metalness 1.0, roughness 0.3."- }- }- ]-}diff --git a/grimoire/intake/cs2_texture_acquisition.md b/grimoire/intake/cs2_texture_acquisition.mddeleted file mode 100644index b7e2ed1..0000000--- a/grimoire/intake/cs2_texture_acquisition.md+++ /dev/null@@ -1,77 +0,0 @@-# CS2 Texture Acquisition (optional exactness upgrade)--This is **not** part of the default image-first path. It is an optional Tier-3 upgrade for exact-texture likeness, driven autonomously by the host agent from the **user's own legal CS2 install**.-The user performs no manual step beyond, at most, pointing at the install / VPK path. If nothing is-found the agent falls back to the image-only reconstruction — it never fabricates a wrong render.--**IP boundary (hard rule):** extracted textures are Valve IP. They stay in the local, gitignored-`cs2_textures/` workspace and are **never** committed or redistributed. The MIT repo ships code-only. `.gitignore` excludes `cs2_textures/`; a test asserts nothing under it is-tracked.--## Steps--### 1. Metadata (optional, no install needed) — `forge/stage1_intake/fetch_cs2_metadata.py`--Resolve the skin's paint index, float range, rarity, and CDN image URL from the public CSGO-API-skins index (`--index-file` local, or `--index-url` live). The index is the community-maintained-[`ByMykel/CSGO-API`](https://github.com/ByMykel/CSGO-API) `skins.json` — fetch it straight from-GitHub during a run (metadata only; not Valve's texture files):--```-# live from GitHub (jsDelivr CDN — pin @<tag-or-commit> for reproducible runs, not @main)-fetch_cs2_metadata.py --weapon Karambit --skin Doppler --paint-index 419 \- --index-url "https://cdn.jsdelivr.net/gh/ByMykel/CSGO-API@main/public/api/en/skins.json" \- --out metadata.json--# or fully offline from a saved copy-fetch_cs2_metadata.py --weapon Karambit --skin Doppler --phase "Phase 2" \- --index-file skins.json --out metadata.json-```--A no-match or an ambiguous multi-match is an **error** (nonzero exit), never a silent guess. Add-`--phase` to disambiguate by name — **but** this dataset lists every Doppler phase under the *same*-name (`★ Karambit | Doppler`), differing only by `paint_index`; there, `--phase` can't help and the-ambiguity error lists each candidate's `paint_index` so you can re-run with `--paint-index N`-(e.g. `419` = Phase 2). This gives the precise paint index for a Tier-2 descriptor even without-extracting textures.--> Reproducibility & IP: `@main` is a moving target — pin a commit/tag for deterministic runs. The-> metadata and the `image` preview (Steam CDN) are community data; Valve's actual paint textures are-> **not** distributed via this source (use the local VPK path below, and never commit `cs2_textures/`).--### 2. Locate the VPK — `forge/stage1_intake/locate_cs2_vpk.py`--```-locate_cs2_vpk.py --json # or --root <steam-root> (repeatable) to override-```--Searches the per-OS default Steam roots (override or add more with repeatable `--root`) for-`.../Counter-Strike Global Offensive/game/csgo/pak01_dir.vpk`. Best-effort and non-fatal:-prints `{"found": false, ...}` and exits 1 when nothing is located (never raises). `--root` is-dependency-injectable for offline testing.--### 3. Extract + classify — `forge/stage1_intake/extract_cs2_textures.py`--Requires `Source2Viewer-CLI` on `PATH` (which needs the .NET runtime). Assert availability first,-then extract into the gitignored workspace and bucket the output maps by filename convention-(`color` / `normal` / `roughness_metalness` / `mask` / `other`):--```-extract_cs2_textures.py --out cs2_textures --json # --vpk <path> to skip locating-```--On any failure — no VPK, missing binary, subprocess error, or non-zero exit — it returns-`{"status": "fallback", "reason": ...}` and exits 1, so the pipeline degrades to the image-only-path with an explicit notice that exact texture likeness is unavailable. On `Source2Viewer-CLI`-flag drift, consult its `--help` and adapt the wrapped call in `run_source2viewer()`; if it still-fails, report and fall back rather than guessing.--## Using the result--Feed the classified maps into the finish material's PBR channels (color → albedo, normal → normal,-packed → roughness/metalness, mask → wear/pattern) to raise fidelity above the procedural-image-only recipe. The finish-style machinery (PBR ranges, environment, wear) in-`grimoire/build/cs2_finishes.md` still applies — it drives *realism* independent of whether exact-textures were acquired.diff --git a/skills/cs2-knife.md b/skills/cs2-knife.mddeleted file mode 100644index df63494..0000000--- a/skills/cs2-knife.md+++ /dev/null@@ -1,174 +0,0 @@-Create a high-fidelity procedural Three.js 3D reconstruction of:-- ★ Classic Knife | Fade- Wear condition: Minimal Wear- Item family: knife- Subtype: classic-knife-- The goal is maximum observable agreement with the supplied reference images,- including:-- - blade silhouette and proportions;- - spine, cutting edge, tip and bevel profile;- - guard, handle, pommel and hardware placement;- - metal base colour and exposed metal;- - Fade colour gradient, transition zones and pattern placement;- - roughness, metallic response, clearcoat and edge wear;- - front/back consistency;- - camera framing and object orientation.-- The FRONT and BACK images below are the only visual ground truth. Treat them as- two views of the same physical item, not as separate objects.-- Workflow:-- 1. Validate both images before reconstruction.- - Check that both images contain the same knife.- - Check for duplicate views, unreadable regions, cropping, empty background- and inconsistent scale.- - Record the role of each image as `front` or `back`.-- 2. Analyze the images before authoring geometry.- - Separate observation from inference.- - Identify visible geometry, material regions, wear, lighting artifacts and- hidden areas.- - Do not use the filename, skin name or prior model as a substitute for image- evidence.-- 3. Build one geometry contract from both views.- - Reconcile front and back silhouette, proportions and orientation.- - Use a dedicated Classic Knife adapter.- - Do not substitute a Bayonet, Karambit, Navaja, Flip Knife or generic knife- model.- - Do not use a generic knife tree when a Classic Knife-specific detail is- visible.-- 4. Build the surface/material contract.- - Separate blade coating, exposed metal, handle, guard, hardware and wear- regions.- - Preserve the actual Fade colour placement from the images.- - Use de-lit reference projection for the visible pattern whenever- technically possible.- - Do not replace the observed Fade pattern with a generic procedural gradient- unless projection is unavailable.- - Keep albedo, roughness, metalness, normal/height, AO, mask and wear as- independent channels.- - Never reuse albedo as roughness, normal, AO or metalness.-- 5. Handle missing evidence honestly.- - Do not invent paint seed, float value, UV layout or unseen-side details.- - Mark hidden or inferred geometry with per-region confidence.- - If the two views are insufficient to resolve an important feature, return- `request-input`.- - Do not claim exact geometry or exact texture where the images do not- provide evidence.-- 6. Exactness policy:- - If only the two images are available, use `exactnessTier: image-only`.- - If the skin name is verified with reliable metadata but exact paint seed/- float/texture maps are unavailable, use `exactnessTier: metadata-assisted`.- - Use `exactnessTier: exact-texture` only when exact texture maps and valid- provenance are available.- - Knowing the skin name alone is not enough for `exact-texture`.- - Keep `route` and `exactnessTier` independent.- - If projection falls back to procedural-finish, preserve the original- evidence tier and record the approximation warning.-- 7. Existing project context:- - You may inspect `builds/` and `runtime/cs2-preview/` to understand- available implementation layers.- - Treat those directories as implementation context only.- - Do not copy their geometry, materials, colours, proportions or fixture data- when they conflict with the uploaded images.- - Do not treat an existing preview fixture as evidence that the- reconstruction is correct.- - The uploaded FRONT and BACK images always have priority.-- 8. Review requirements:- - Render a fixed view aligned to the primary reference view.- - Render at least two meaningful orbit views.- - Reject degenerate views where the model is only a flat plane.- - Review silhouette, proportions, material response, Fade placement, wear and- hardware separately.- - A good global score must not override a failed critical feature.-- 9. Final report must include:- - geometry features matched;- - material and colour features matched;- - front/back consistency;- - inferred or hidden regions;- - approximation notes;- - selected route;- - exactness tier;- - unresolved differences;- - recommended next action: `continue`, `refine-spec`, `refine-code`,- `request-input`, or `stop`.-- Do not claim that the model is exact unless the evidence supports that claim.-- FRONT IMAGE:- FRONT IMAGE: [Image #2]-- BACK IMAGE: [Image #3]-[Image #2]-[Image #3]--I'll start by loading the img2threejs skill, which is purpose-built for this task.-- technically possible.- - Do not replace the observed Fade pattern with a generic procedural gradient- unless projection is unavailable.- - Keep albedo, roughness, metalness, normal/height, AO, mask and wear as- independent channels.- - Never reuse albedo as roughness, normal, AO or metalness.-- 5. Handle missing evidence honestly.- - Do not invent paint seed, float value, UV layout or unseen-side details.- - Mark hidden or inferred geometry with per-region confidence.- - If the two views are insufficient to resolve an important feature, return- `request-input`.- - Do not claim exact geometry or exact texture where the images do not- provide evidence.-- 6. Exactness policy:- - If only the two images are available, use `exactnessTier: image-only`.- - If the skin name is verified with reliable metadata but exact paint seed/- float/texture maps are unavailable, use `exactnessTier: metadata-assisted`.- - Use `exactnessTier: exact-texture` only when exact texture maps and valid- provenance are available.- - Knowing the skin name alone is not enough for `exact-texture`.- - Keep `route` and `exactnessTier` independent.- - If projection falls back to procedural-finish, preserve the original- evidence tier and record the approximation warning.-- 7. Existing project context:- - You may inspect `builds/` and `runtime/cs2-preview/` to understand- available implementation layers.- - Treat those directories as implementation context only.- - Do not copy their geometry, materials, colours, proportions or fixture data- when they conflict with the uploaded images.- - Do not treat an existing preview fixture as evidence that the- reconstruction is correct.- - The uploaded FRONT and BACK images always have priority.-- 8. Review requirements:- - Render a fixed view aligned to the primary reference view.- - Render at least two meaningful orbit views.- - Reject degenerate views where the model is only a flat plane.- - Review silhouette, proportions, material response, Fade placement, wear and- hardware separately.- - A good global score must not override a failed critical feature.-- 9. Final report must include:- - geometry features matched;- - material and colour features matched;- - front/back consistency;- - inferred or hidden regions;- - approximation notes;- - selected route;- - exactness tier;- - unresolved differences;- - recommended next action: `continue`, `refine-spec`, `refine-code`,- `request-input`, or `stop`.-- Do not claim that the model is exact unless the evidence supports that claim.\ No newline at end of filediff --git a/skills/cs2-pistol.md b/skills/cs2-pistol.mddeleted file mode 100644index 3da67be..0000000--- a/skills/cs2-pistol.md+++ /dev/null@@ -1,35 +0,0 @@-reate a high-fidelity procedural Three.js 3D reconstruction of:-- ★ Glock-18 | Ghost Protocol- Wear condition: Well-Worn- Item family: weapon- Subtype: glock-18-- The goal is maximum observable agreement with the supplied FRONT and BACK reference images, covering:- - Slide silhouette, frame/grip ergonomics, ejection port, trigger guard, and internal barrel/breech geometry.- - Sights, trigger shoe, safety blade, magazine extension, and pin placement.- - Translucent red polymer PBR parameters (transmission, IOR, thickness, internal occlusion), metallic breech block response, and surface abrasions.- - Ghost Protocol cybernetic circuit linework, decal positioning ("GHOST (*)", "PROTOCOL", ">_"), and refraction placement.- - Front/back consistency, camera framing, and 3D orientation.-- Treat the provided FRONT and BACK images as two views of the same physical item.-- ### Workflow & Protocol:-- 1. Image Validation: Verify front/back alignment, scale consistency, readable resolution, and reject inconsistent/duplicate inputs.- 2. Layered Observation: Isolate visible polymer frame, PBR transmission, visible internal sub-meshes, and wear features. Separate observation from inference.- 3. Geometry Contract: Reconcile front/back silhouettes using a dedicated glock-18 adapter (never substitute generic pistol models).- 4. Material Contract: Use de-lit reference projection for translucent shell linework and decals. Keep PBR channels (Albedo, Transmission, Roughness, Metalness, Normal, AO) strictly independent.- 5. Evidence Honesty: Mark hidden internal geometry with per-region confidence scores. Return `request-input` if crucial features are ambiguous.- 6. Exactness Tiers:- - `image-only`: Derived strictly from the 2D reference images.- - `metadata-assisted`: Verified skin/float metadata without raw texture maps.- - `exact-texture`: Full raw texture maps and provenance available.- 7. Context Priority: The uploaded FRONT and BACK images strictly override any existing preview fixtures or legacy code in `builds/`.- 8. Review Gates: Render fixed reference view + ≥2 orbit views. Reject degenerate flat planes. A high global score cannot bypass a failed critical feature.- 9. Output Report: Provide matched geometry/material features, front/back consistency, exactness tier, and recommended action (`continue` | `refine-spec` | `refine-code` | `request-input` | `stop`).-- FRONT: [Image #9]- BACK: [Image #10]-- Do not claim that the model is exact unless the evidence supports that claim.\ No newline at end of filediff --git a/skills/cs2_technical_analysis.md b/skills/cs2_technical_analysis.mddeleted file mode 100644index 59afe6e..0000000--- a/skills/cs2_technical_analysis.md+++ /dev/null@@ -1,36 +0,0 @@-You are an Expert 3D Technical Director specialized in CS2 (Counter-Strike 2) weapon and item pipelines. Your task is to analyze orthographic 2D reference images of an item and reverse-engineer it into a strict technical blueprint for rendering in Three.js.--Analyze the image using the M.C.M.T (Macro, Components, Materials, Topology) framework and identify Surface Imperfections (Wear and Tear).--Output ONLY a valid JSON object. Do not include markdown formatting like ```json or any conversational text.--The JSON MUST follow this exact schema:-{- "item_id": "Classify the item (e.g., Bowie Knife, Karambit, AK-47)",- "threejs_environment": {- "hdri_required": true/false,- "lighting_notes": "Specific lighting setup required to showcase the materials"- },- "components": [- {- "anatomy_part": "Precise name of the part (e.g., Blade Edge, Spine, Pommel, Handle Scales)",- "geometry_directives": {- "primitive_shape": "Base shape (Plane, Box, Cylinder)",- "topology_rules": "Instructions for extrusions, bevels, or boolean cuts",- "thickness_estimation": "Relative thickness description"- },- "threejs_material": {- "material_type": "MeshStandardMaterial or MeshPhysicalMaterial",- "baseColor": "Hex code or precise color description",- "metalness": Float (0.0 to 1.0),- "roughness": Float (0.0 to 1.0),- "normal_map_details": "Describe micro-surface details like serrations or grips to be baked into normals"- },- "weathering_and_imperfections": {- "has_wear": true/false,- "wear_type": "e.g., Edge Wear, Rust, Scratches, Blood Stains",- "pbr_overrides": "How the wear alters PBR (e.g., Rust drops metalness to 0.0 and raises roughness to 0.9)"- }- }- ]-}