# SLeeLa 3.0 — ประเทศไทย (TH)


ภาษาระบบแบบเนทีฟ คอมไพเลอร์ รันไทม์ และระบบนิเวศเครื่องเสมือน

> **ฉบับนานาชาติประจำประเทศ** ฉบับนี้จัดทำเป็นภาษาไทย ส่วนตัวระบุเชิงเทคนิค คำสั่ง ตัวอย่างโค้ด ชื่อไฟล์ เส้นทางไฟล์ และลิงก์ ยังคงเหมือนกับ [README.md](../../README.md) ฉบับภาษาอังกฤษที่เป็นต้นฉบับหลักทุกประการ
**The Now. The Ingredient.** ภาษาโปรแกรมมีมากกว่าไวยากรณ์ มันคือคอมไพเลอร์ รันไทม์ ไลบรารี เครื่องมือ และข้อตกลงของแพลตฟอร์มที่ทำให้ซอฟต์แวร์ใช้งานได้จริง
**SLeeLa เกี่ยวข้องกับอะไร** SLeeLa เกี่ยวข้องกับ **Math**, **Object**,
**Science** และ **Reach** — สี่ด้านของงานของมัน ได้แก่ สิ่งที่คำนวณได้
(Math) สิ่งที่ลงหลักแล้วซึ่งปรากฏอยู่ในบัญชีของสิ่งที่มีอยู่ (Object)
การศึกษาความจริงอย่างมีวินัย (Science) และการที่ระบบยื่นมือไปถึงระบบอื่น
และผู้คน (Reach) **ผลประโยชน์แห่งชาติยังคงอยู่** — ทั้งสี่ด้านไม่ได้ทำให้
ผลประโยชน์นั้นถูกละเลย เมื่อเรื่องใดเกี่ยวข้องกับผลประโยชน์ของประเทศ
สถานะนั้นจะได้รับการรักษาไว้ (บันทึกอย่างซื่อตรง เช่น ใน Metadata ของแต่ละคลาส
ที่ `metaOrigin` / `metaNationalSchedule`) และจะไม่ถูกทำให้สลายไป
## I. เริ่มต้นใช้งาน
- [สร้างการทำงานแบบเนทีฟ](../../impl/README.md)
- [เครื่องเสมือนและ Modium — คู่มือผู้ใช้เชิงปฏิบัติ](../../virtual-machine/USER-GUIDE.md) (`sleela vm`, `sleela modium`)
- [สแตก CPU ในซอร์สโค้ด SLeeLa](../../lib/cpu/CPU.md) — เครื่องคอมพิวเตอร์ครบวงจรตั้งแต่เกต→ALU→คอร์→ระบบปฏิบัติการ→โปรแกรม รายการโปรไฟล์ CPU กว่า 130 แบบ และ[แรงดันไฟฟ้า สัญญาณนาฬิกาแปรผัน และการกำหนดจังหวะเวลาระดับผู้เชี่ยวชาญ](../../lib/cpu/TIMING.md)ที่ปรับได้ ซึ่งคุณสามารถ[รันตามข้อกำหนดและโอเวอร์คล็อก](../../lib/cpu/components/README.md)ได้
- [ดัชนีเอกสาร](../../docs/README.md)
- [แหล่งข้อมูล CSPML และเอกสารอ้างอิงงานวิจัย Salt & Salary](../reference/CSPML.DATA.SOURCE.AND.SALT-AND-SALARY.REFERENCE.md) — แหล่งที่มาของข้อมูลและแนวทางการบูรณาการสำหรับข้อมูลสถานที่ เศรษฐกิจและสังคม กำลังแรงงาน การศึกษา และโรงเรียนรัฐบาลของสหรัฐอเมริกาจากภายนอก
- [เอกสาร API ที่สร้างขึ้น](../../docs/api/README.md) — เอกสารอ้างอิง HTML ปัจจุบัน ฉบับ API ที่มีเวอร์ชัน และวิธีสร้างใหม่
- [แค็ตตาล็อก API](../../api/README.md)
- [มาตรฐานการเปรียบเทียบเชิงคำนวณ](../../comparison/README.md) — มาตรฐานด้านชนิดข้อมูล หน่วยความจำ ABI และความสอดคล้องของ SLeeLa VM, Java/JVM และ C/C++ แบบเนทีฟ
- [Recursion stanchion — ต้นแบบ C และ C++](../../recursion/stanchion/README.md) — ตัวอย่างเฉพาะชนิดพื้นฐานสำหรับ Boolean, Byte, Character, Integer, Long, Float และ Double พร้อมรูปแบบเรียกซ้ำแบบทั่วไป เชิงประยุกต์ เชิงวิทยาศาสตร์ และเพื่อการสอน
- [เมทริกซ์การรองรับแพลตฟอร์มและการตรวจสอบ](../../docs/PLATFORM-SUPPORT.md)
- [คู่มือแบรนด์](../../docs/BRAND-GUIDE.md)
- [แนวคิดและสินทรัพย์สินค้าที่ระลึก](../../merchandise/README.md)
- [โลโก้ NitroWebExpress](../../images/nitro-web-express/nitrowebexpress-logo-004.jpeg)
- [นโยบายการทดสอบและเกณฑ์ผ่านการเผยแพร่](../../markdown/TESTING.md)
## II. ข่าวสาร
ส่วนเพิ่มเติมล่าสุดของภาษา ไดรเวอร์ และไลบรารีมาตรฐาน:
- **แพ็กเกจไลบรารีมาตรฐาน `advantage` — การทำ advantage ให้เงินปันผล
พร้อมคณิตศาสตร์ ฟิสิกส์ การบูรณาการ การให้เกรด และเอาต์พุตที่กำหนดเส้นทางได้**
[`lib/advantage/`](../../lib/advantage/README.md) ห่อหุ้มแนวคิด *การทำ advantage ให้
เงินปันผลที่เป็นเอกลักษณ์ เทียบกับแบบจำลอง* เป็น **Sequitur onion** แบบหลายชั้น
(เงินปันผล → การทบทวน → ข้อกังวล → คณิตศาสตร์ → ส่วนเพิ่ม → การหัก → การจัดกลุ่มใหม่
→ การวนซ้ำ) ที่เลื่อนเข้า–ออกได้พร้อมการอัปเดตแบบไดนามิกเต็มรูปแบบและ
restitute โดยเปิดให้ใช้ผ่าน **user's model** ที่เรียบง่าย และ
**developer's model** ที่ควบคุมได้เต็มที่ มีห้าสาขาวิชา ได้แก่ **`math/`** เศรษฐศาสตร์
การค้าทวิภาคี (การขยายกำไรร่วมสูงสุด การเจรจาต่อรองแบบ Nash อัตราส่วนวิกฤตของ
newsvendor ทวิภาคี) **`physics/`** "ฟิสิกส์ของสนามความไว้วางใจ" เชิงโครงสร้างทางเศรษฐศาสตร์
(ความไว้วางใจเป็นเมตริกเทนเซอร์ จีโอเดสิกเชิงธุรกรรม โครงสร้างการสัมผัสของประกาศ
และ SDE การเสื่อมของความไว้วางใจแบบ CIR+jump — เป็นการเปรียบเทียบเชิงแบบจำลอง
ซึ่งระบุไว้เช่นนั้น) **`integration/`** แบบจำลองการบูรณาการแนวดิ่งที่ประกอบซ้ำได้
สำหรับทุนนิยม/ค้าปลีก (ช่อง bay วิศวกรรม ช่องทดลอง ถาดค่ามัธยฐาน newton
และคะแนนความซับซ้อนของระบบ) **`grading/`** ตัวให้เกรดวงจรความซับซ้อนที่จัดอันดับแต่ละโมดูล
และชุดโมดูลที่ชนะ/แพ้/ผู้ให้เกรด/สัมบูรณ์ เป็น A–D และ **`output/`**
จุดส่งออกที่กำหนดเส้นทางได้ ซึ่งส่งเอาต์พุตของโมดูลไปยังเทอร์มินัล พื้นผิวที่จัดรูปแบบด้วย
**CommonRails** หรือซ็อกเก็ต/ตัวเชื่อมต่อ (จัดเฟรมสำหรับ `slnet_write` แบบเนทีฟ)
ทุกคลาสมีบันทึก Metadata-Class เดโมที่รันได้ห้าชุดตรวจสอบแต่ละสาขาวิชา และเอกสารประกอบ
[`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md)
[`MATH.md`](../../lib/advantage/MATH.md) และ
[`PHYSICS.md`](../../lib/advantage/PHYSICS.md) อธิบายไว้ ผู้ใช้ C/C++ แบบเนทีฟใต้
[`advantage/`](../../advantage/README.md) (แกน C `advantage_value`/`advantage_mean`
ที่เก็บความรู้แบบ XML ไลบรารีการได้มาซึ่งข้อมูลที่ปลอดภัยผ่าน HTTPS/SFTP/SSH
พร้อมคลังกุญแจและการขนส่งแบบ DH/ECDH) เชื่อมแบบจำลองเข้ากับ
[ตัวอย่างการค้า](../../advantage/examples/README.md)ที่ใช้งานจริง —
การค้าเชิงบวกจากแหล่งอินเทอร์เน็ตที่สันนิษฐาน ลำดับความเกี่ยวข้องกับผู้ชม (Traders,
Consumers, Helpers, Healers) และแบบจำลองแปดแบบที่จัดอันดับ A–D (D = Cement มากที่สุด
A = Brand มากที่สุด)
- **คำอธิบายประกอบกำหนดจังหวะลูป — `@loopDelay` / `@loopBudget` (พร้อมฟังก์ชันในตัว
`sleep(ms)`)** คำอธิบายประกอบ**ระดับคำสั่งเชิงพฤติกรรม**ชุดแรกใน SLeeLa:
เขียนในบรรทัดของตัวเองก่อนลูป `for` / `while` / `do` เพื่อแทรกการหยุดพัก
จริงเข้าไปในการทำงานของลูป `@loopDelay(ms = 250)` /
`@loopDelay(seconds = 2)` หยุดเป็นเวลาคงที่ต่อรอบ (`@loopDelay(250)` เปล่า ๆ
ใช้หน่วยมิลลิวินาทีโดยปริยาย) ส่วน `@loopBudget(seconds = 10,
iterations = 1000)` กระจายจำนวนรอบที่ทราบไว้ให้เท่ากันตลอดงบเวลานาฬิกาจริงทั้งหมด
ทั้งสองแปลงเป็น opcode ใหม่แบบ append-only คือ **`OP_SLEEP`**
(ISA 157) ซึ่งหนุนฟังก์ชันในตัว **`sleep()`** ที่เรียกได้ทุกที่ด้วย
การหยุดพักนี้ทำให้พกพาได้ (`nanosleep` / `Sleep`) กำหนดไว้ใน
[`SLEELA.syntax` §32](../../SLEELA.syntax) เอกสารอ้างอิง API อยู่ที่
[`api/sleela/3.0/LOOP_TIMING_API.md`](../../api/sleela/3.0/LOOP_TIMING_API.md)
ตัวอย่างที่รันได้คือ
[`examples/loop-timing-annotation-demo.sleela`](../../examples/loop-timing-annotation-demo.sleela)
ดัชนีส่วนเพิ่มของเซสชัน (รวมถึงส่วนนี้ การคูณจำนวนเต็มขนาดใหญ่แบบเนทีฟ `OP_BIGMUL`
และเครื่องมือแบบสแตนด์อโลน **[local-generator](../../local-generator/README.md)**
และ **[pi-generator](../../pi-generator/README.md)**) อยู่ที่
[`api/sleela/3.0/SESSION-ADDITIONS-API.md`](../../api/sleela/3.0/SESSION-ADDITIONS-API.md)
พื้นผิว API ที่สร้างขึ้นทั้งสาม
([`sleeladoc-api/`](../../sleeladoc-api/README.md)
[`docs/api/`](../../docs/api/README.md) และสแนปช็อตที่เปลี่ยนแปลงไม่ได้
[`api/sleela/3.0/version-014/`](../../api/sleela/3.0/version-014/index.html))
ถูกสร้างใหม่ด้วย `make api-docs` และตอนนี้มีรายการคำสั่ง `SLISASleep`
/ `SLISABigMul` ใหม่ในหน้าแพ็กเกจ `vm`
- **SleelaDoc จากบรรทัดคำสั่ง — `sleela docs`** ตอนนี้เข้าถึง SleelaDoc ได้
โดยตรงจากเทอร์มินัล `sleela docs` แสดงหัวข้อที่จัดทำเอกสารได้ทั้งหมด
`sleela docs crypto` แสดงแพ็กเกจ `sleela docs stringbuilder` ค้นหา
คลาส (ไม่แยกตัวพิมพ์เล็กใหญ่ และด้วยคำนำหน้าไลบรารีมาตรฐาน `SL` →
`SLStringBuilder`) และพิมพ์หน้าที่สมบูรณ์ — **คำนิยาม วัตถุประสงค์ของการออกแบบ
ความสัมพันธ์ โครงสร้าง user clays และบันไดความเชี่ยวชาญห้าขั้น** — พร้อมผลลัพธ์
"คุณหมายถึง" ที่จัดอันดับเมื่อพิมพ์ใกล้เคียง ผู้เขียนเสริมหน้าใดก็ได้เพียงเพิ่ม
แท็ก `@` ของ SleelaDoc (`@intent`, `@thesis`, `@axiom`, `@param`,
`@see`, `@mastery`) `sleela docs --generate [dir]` เขียนคลังข้อความล้วน
(หนึ่งหน้าต่อคลาส พร้อม `TOPICS.index`) ที่ CLI อ่านแบบออฟไลน์ได้ต่อไป
**`make sleeladoc`** รวมคลังนั้น **และซอร์ส `.sleela` ที่ตรงกัน**
ไว้ใน `sleeladoc/build/sleeladoc.jar` สำหรับหัวข้อที่มีเพียง facade (เช่น
`psychiatry`, `politico`) `sleela docs --facade ` ค้นหา
ระบบไฟล์ขณะรันไทม์และแสดง**โฟลเดอร์ (แล้วจึงไฟล์ ในฐานะการเคลื่อนที่ตามธรรมชาติ)**
จริง ภายใต้เพดานที่ผู้ใช้ปรับเองได้คือ **6 MB / 6000 ไฟล์ / 6
นาที** หน่วย `lib/sleeladoc` ได้รับการดูแลในฉบับปัจจุบัน
**`#sleela 3.0`** ดู [`man/man1/sleela.1`](../../man/man1/sleela.1) และ
[`lib/sleeladoc/README.md`](../../lib/sleeladoc/README.md)
- **SleelaDoc — โซลูชันจัดทำเอกสารแบบ Javadoc พร้อมเว็บไซต์ HTML ที่สร้างขึ้น**
**SleelaDoc** คือแบบแผนคอมเมนต์เอกสารในซอร์สของ SLeeLa
(คอมเมนต์วงเล็บมุมที่มีตัวนำ `@doc` / `@page` ดู
[`manifesto/SLEELADOC.md`](../../manifesto/SLEELADOC.md)) และ
[`lib/sleeladoc`](../../lib/sleeladoc/README.md) คือ**ตัวสกัด**ที่เรนเดอร์
ยูนิต `.sleela` เป็นหน้า API แบบ Markdown หรือ HTML — เหมือนที่ `javadoc` เรนเดอร์ Java
โดยบันทึก*เจตนา* **เว็บไซต์เอกสาร HTML ที่เรียกดูได้ครบถ้วนสำหรับ
`/lib` ทั้งหมด**ถูกสร้างไว้ที่ [`/sleeladoc-api`](../../sleeladoc-api/README.md)
โดย `tools/generate-sleeladoc-api.py` (เปิด `sleeladoc-api/index.html` สไตล์สะอาดตา
น้ำเงิน / ฟ้าอ่อน / เทาอ่อน / ขาว มีลำดับชั้นแพ็กเกจ → คลาส → สมาชิก และ
อภิธานศัพท์ที่เขียนสำหรับผู้อ่าน *Student 2*) คอมไพเลอร์ยังสร้าง
เอาต์พุตเอกสารที่ผู้เขียนทำเครื่องหมายไว้เป็นผลพลอยได้ของการคอมไพล์ (หน้า MediaWiki ด้วย `--wiki`
และฝาแฝดซอร์สที่ถูกสร้างต้นทาง) ซึ่งระบุไว้ใน
[`manifesto/SLEELADOC.WIKI.md`](../../manifesto/SLEELADOC.WIKI.md) ตัวอย่างที่รันได้:
[`lib/sleeladoc/sleeladoc-demo.sleela`](../../lib/sleeladoc/sleeladoc-demo.sleela)
- **XML Document Object Model (`lib/xml`)** XML DOM ฝั่ง SLeeLa — เอกสารที่เป็นเจ้าของ
ต้นไม้ของโหนด element/text/comment/CDATA/PI ที่มีลูกเรียงลำดับและแอตทริบิวต์ที่มีชื่อ
ตัวสร้างลำดับข้อมูล (แบบกะทัดรัด/อ่านง่าย การ escape ตาม XML 1.0 §2.4) ตัวแยกวิเคราะห์
แบบ char-cell และทะเบียนคุณภาพ `SLXmlAspect` ความเท่ากันของโหนดเป็น
การผูกความไว้วางใจสามขั้น (ตัวตน → หัวเรื่องเดียวกัน → โครงสร้าง) ซึ่งสะท้อนกลับ
สมมาตร และกำหนดแน่นอน ดู [`lib/xml/README.md`](../../lib/xml/README.md) และ
ตัวอย่างที่รันได้ [`lib/xml/xml-dom.sleela`](../../lib/xml/xml-dom.sleela)
- **ชนิดจำนวนเต็มมีเครื่องหมายแบบกว้าง (`long`, `int64`, `int128`)** `int`, `long`
และ `int64` ล้วนเป็นจำนวนเต็มมีเครื่องหมาย 64 บิตที่ตรวจชนิดและทำงานเหมือนกัน
`int128` ยอมรับเป็นชนิดจำนวนเต็ม (ขณะนี้ใช้ 64 บิตรองรับ ส่วน 128 บิตจริง
เป็นงานต่อเนื่องที่มีเอกสารระบุ) ชุดมีเครื่องหมายฐาน 2 `int32`..`int16777216`
(ไวยากรณ์ 2.7) และชุดไม่มีเครื่องหมายที่สอดคล้องกัน `uint32`..`uint16777216`
(ไวยากรณ์ 2.8) ขยายความต่อไปอีก ดู [`SLEELA.syntax`](../../SLEELA.syntax) §21, §24, §25
- **ฟิลด์ต่อเนื่อง `@mix` (ไวยากรณ์ 2.9)** คลาสอาจประกาศฟิลด์อินสแตนซ์หลายตัว
ที่มี**ชื่อเดียวกัน**ได้เมื่อแต่ละตัวที่ซ้ำมี `@mix` ภาษาเข้าใจกลุ่มนั้นว่าเป็นฟิลด์ต่อเนื่อง
(อาร์เรย์ / ลิสต์ที่จัดดัชนี) เรียง `1,2,3,…` จากบนลงล่างโดยปริยาย หรือกำหนดเองด้วย
`@mix(1,2,3,...)` ซึ่งจำนวนดัชนีต้องตรงกับจำนวนฟิลด์ ดู [`SLEELA.syntax`](../../SLEELA.syntax) §28
- **เครื่องหมายเอกสาร — Natural Process ซึ่งมีชื่อเรียกว่า Preonems
(`author`/`authorial`, `material`, `memory`, `determine`, `object`, `field`)**
คำเครื่องหมายเอกสารเปล่า ๆ เหล่านี้รวมกันมีชื่อเรียกว่า **Preonems**
(เครื่องหมายหนึ่งตัวคือ *Preonem* ทั้งชุดคือ *Preonems* — ดู
[`SLEELA.syntax`](../../SLEELA.syntax) §26.1) เป็นเครื่องหมายเอกสารชั้นหนึ่งที่ประกาศอย่างเดียว
ซึ่งระบุว่าเอกสาร*เป็นอะไร*ตามลำดับของการสร้าง:
`author`/`authorial` (ไวยากรณ์ 2.4; จัดการโดยสภาวิชาชีพ — สมาชิกเดียวที่มีผลเชิงพฤติกรรม)
`material;` (Source ที่ลงหลักแล้ว) และ `memory;`
(ไวยากรณ์ 2.5) `determine;` (ไวยากรณ์ 2.6; เอกสารที่เปิดให้แพทย์ นายแพทย์
หรือผีประมวลผลต่อไปจนเสร็จสมบูรณ์โดยมือที่ถูกต้องตามกฎหมาย)
และสองตัวใหม่ล่าสุด คือ **`object;`** (สิ่งที่ลงหลักแล้วซึ่งปรากฏในบัญชีของสิ่งที่มีอยู่ —
**ถูกทำให้เป็นรูปธรรม มีสถานะที่จับต้องได้ ที่ไวยากรณ์ 2.8**) และ
**`field;`** (พื้นฐานของความสัมพันธ์ที่วัตถุทั้งหลายตั้งอยู่และเคลื่อนไหว) —
ทั้งสองถูกกั้นตั้งแต่ไวยากรณ์ 2.6 ทุกตัวเป็นคำเปล่า ขึ้นกับบริบท และกั้นตามเวอร์ชัน
โดย front end โดยไม่มีผลต่อการแยกวิเคราะห์ การตรวจชนิด หรือการสร้างโค้ด นอกตำแหน่ง
เครื่องหมาย ทุกตัวยังคงเป็นตัวระบุธรรมดา (ดังนั้น `field` จะไม่รบกวน
สมาชิกคลาสหรือการเข้าถึง `.field`) ดู [`SLEELA.syntax`](../../SLEELA.syntax)
§18–§20, §23 และ §26
- **Nordshrift ที่ไวยากรณ์ 3.0 พร้อมการเข้าถึงไลบรารีเต็มรูปแบบ** Nordshrift ค้นหา
ผ่านดัชนี `/lib` แบบเรียกซ้ำเดียวกับคอมไพเลอร์ เข้าถึงทุก
แพ็กเกจและยูนิต `.sleela` โดย `nordshrift check` รายงานจำนวนทั้งต้นไม้
- **Recursion stanchion** ไดเรกทอรี [`recursion/stanchion/`](../../recursion/stanchion/README.md) ตอนนี้มีต้นแบบอ้างอิง C และ C++ โดยเฉพาะสำหรับสัญญาของชนิดพื้นฐานที่มีเอกสารทั้งเจ็ด รวมทั้งตัวอย่างแบบทั่วไป เชิงประยุกต์ เชิงวิทยาศาสตร์ และเพื่อการสอน ทั้งหมดนี้เป็นซอร์สอ้างอิง ให้คอมไพล์และทดสอบก่อนถือว่าผ่านการตรวจสอบแล้ว
- **คอมเมนต์วงเล็บมุม (`<` / `<<`)** รูปแบบคอมเมนต์ใหม่สำหรับต่อไปข้างหน้า —
`< line >` และ `<< block >>` — ถูกวิเคราะห์ศัพท์โดย frontend ของ SLeeLa และมีเอกสารใน
[`SLEELA.syntax`](../../SLEELA.syntax) §1.1
- **ลิเทอรัลจำนวนเต็มหลายฐาน** ลิเทอรัล `int` ตอนนี้รองรับรูปแบบเลขฐานสิบหก (`0x`)
ฐานสอง (`0b`) และฐานแปด (`0o`) พร้อมตัวคั่นหลัก `_` ทั้งในภาษาซอร์ส SLeeLa
([`SLEELA.syntax`](../../SLEELA.syntax) §1.4) และ
[รูปแบบแบบจำลอง CPU `.xlt`](../../lib/xlt/README.md)
- **มาตรฐาน Metadata Class ทั่วทั้งไลบรารี** metapattern ของข้อมูลเมตาเชิงพรรณนา
(ที่มา ความถูกต้องตามกฎหมาย ขอบเขตทางเขตอำนาจศาล) ตอนนี้ปรากฏในทุกไฟล์ `.sleela`
ที่มีคลาสภายใต้ `/lib` ดู
[`SLEELA.syntax`](../../SLEELA.syntax) §15 และ
[บทเรียนในแบบฝึกหัด](../../tutorial/13-metadata-class.md)
- **ตระกูลข้อความ / String ที่สมบูรณ์ขึ้น** `lib/text` ได้ตัวช่วยในภาษาจริง
มุมมอง char-cell ที่ให้ `charAt`/`substring`/`indexOf`/`reverse`/
การจัดแนวคอลัมน์ที่แท้จริง และตัวสร้างแม่แบบตามตำแหน่งที่ใช้งานได้จริง — ดู
[แบบฝึกหัดข้อความและ String](../../tutorial/14-text-and-strings.md) และตัวอย่างที่รันได้
[`lib/text/text-string-demo.sleela`](../../lib/text/text-string-demo.sleela)
- **`String` ชั้นหนึ่งในแผ่น Nordshrift** แผ่น `.sst` ประกาศบล็อก `strings:`
แบบกำหนดชนิดซึ่งมีส่วนร่วมใน manifest ส่วนประกอบของการ build ได้
ดู [เอกสารอ้างอิงแผ่น Nordshrift](../../wiki/Nordshrift-Sheet-Reference.md)
- **แบบจำลอง CPU ทำงานได้ทั้งด้วย opcode และการเทียบเท่าการเรียกฟังก์ชัน** ทุก
`SLCPU` สืบทอดพื้นฐานของการรันสตรีมคำสั่งเนทีฟ
ผ่านลูป fetch-decode-execute *และ*การรันโค้ดของกระบวนการอื่นที่สมมติขึ้น
ด้วยการเรียกที่เทียบเท่าบนสับสเตรตของ VM ที่ใช้ร่วมกัน — ดู
[`lib/cpu/EXECUTION.md`](../../lib/cpu/EXECUTION.md) §5
## III. การ build และการทดสอบ
**ข้อกำหนดเบื้องต้น:** toolchain C/C++ (GCC หรือ Clang) และ GNU Make; Python 3
สำหรับเครื่องมือ manifest/flow; บน Linux ต้องมีแพ็กเกจพัฒนา X11/Xrandr
สำหรับผลิตภัณฑ์แสดงผล (`make deps` ของโมดูลจะรายงาน/ติดตั้งสิ่งที่ต้องใช้) การ build
ของ `impl/` เป็นแบบ fail-closed ตาม manifest SHA-256 ที่เชื่อถือได้ ซึ่ง
`Makefile` ที่รากชี้ไปให้โดยอัตโนมัติ
จาก checkout ที่สะอาด เริ่มต้นเร็วที่สุดคือ:
```sh
make # build everything from the repo root
```
หรือ build และทดสอบเฉพาะแกนเนทีฟ:
```sh
make -C impl all # build the core compiler/runtime only
bash ./test-suites/run-all.sh --all # run the full test suite
```
`make` ที่รากของ repo จะ build ทุกผลิตภัณฑ์ (แกน, VM, codec, churn,
antivirus, …) และปิดท้ายด้วยการ build **registry** และสร้างตารางพื้นฐานของมัน
ดังนั้นต้นไม้ที่ build แล้วจึงมาพร้อม registry ที่ตรวจทานได้ทันที
เป้าหมายสำคัญ:
```sh
make # build everything (alias of `make all`; registry runs last)
make all # the same full build, named explicitly
sudo make install # install commands + runtime support (see §IV)
make clean # remove build outputs from every dispatched build system
make help # list every target the root Makefile provides
```
เป้าหมายอื่นที่มีประโยชน์:
```sh
make registry # just the registry: build + materialize the table
./build-registry.sh # same thing, invoked directly
make tests # build and run the test suite
make ballum # build the Ballum display library for this OS (see ballum/)
bin/install-modules # paced install/build of each module over ~10-20 min (see bin/)
```
เป้าหมาย `registry` รัน [`build-registry.sh`](../../build-registry.sh): สร้าง
แกน registry หยอดตารางพื้นฐานลงในที่เก็บข้อความแบบพกพา
`registry/build/sleela.sleelareg` และส่งออกสคริปต์ตาราง MySQL
`registry/build/registry.sql` (ผ่าน `sleela registry export`) ตรวจทานได้ด้วย
`sleela registry` หรือ `registry/build/sleela-registry review` ดู
[คู่มือ registry](../../registry/README.md) และ [สถาปัตยกรรม Registry 3.0](../../registry/REGISTRY-3.0-ARCHITECTURE.md)
โปรดดูคู่มือการ build และการทดสอบสำหรับข้อกำหนดเบื้องต้นและขั้นตอนเฉพาะแพลตฟอร์ม การ build คอมโพเนนต์หนึ่งสำเร็จไม่ได้พิสูจน์ว่าทุกไลบรารีหรือทุกแพลตฟอร์มพร้อมสำหรับการเผยแพร่
## IV. การติดตั้ง
หลัง build ผลิตภัณฑ์เนทีฟแล้ว ให้ติดตั้งคำสั่งและไฟล์สนับสนุนรันไทม์:
```sh
sudo make install
make install PREFIX="$HOME/.local" # user-local install, no sudo
make install DESTDIR="$PWD/package-root" # staged package install
make install-check
```
ตัวติดตั้งแบบดั้งเดิมใช้ `/usr/local/bin`, `/usr/local/lib/sleela`
และ `/usr/local/share/sleela` โดยปริยาย โดยจะคงการกำหนดค่าเริ่มต้นระบบที่มีอยู่
และปฏิเสธการเขียนทับคำสั่งเดิมที่ไม่ได้ถูกติดตามไว้ การถอนการติดตั้ง
จะลบเฉพาะไฟล์ที่ตัวติดตั้งบันทึกไว้ โดยคงการกำหนดค่าและ
ข้อมูลรันไทม์ที่ไม่ได้ติดตามไว้
สำหรับการติดตั้งแบบเจาะจงเฉพาะแพ็กเกจหลัก — ไบนารี `sleela`
`sleelvac` และ `nordshrift` ไลบรารีมาตรฐาน โปรโตคอล และโมดูลสนับสนุน —
ให้ใช้ตัวติดตั้งแบบสะอาด:
```sh
make clean-install # guided install of the main package only
```
ตัวติดตั้งนี้ให้ตัดสินใจหลักเพียงครั้งเดียว (ติดตั้งแพ็กเกจหลัก) จากนั้นเลือกขอบเขต
และเมื่อสำเร็จจะมีตัวเลือกเพิ่มเติมสำหรับโมดูลเสริมที่คัดสรรไว้ สำหรับ
เวิร์กโฟลว์การติดตั้งแบบโต้ตอบและตัวเลือกการติดตั้งทั้งหมด ดู
[การติดตั้งที่รวดเร็วและปลอดภัย](../../install/README.md)
## V. ภาษาและรันไทม์
ไวยากรณ์ที่เป็นทางการคือ [`SLEELA.syntax`](../../SLEELA.syntax) ปัจจุบัน repository ระบุเอกสารไวยากรณ์เวอร์ชัน **3.0** เวอร์ชันของคอมไพเลอร์/เครื่องมือและเวอร์ชันไวยากรณ์ของซอร์สเป็นคนละอย่างกัน ไวยากรณ์ 3.0 เพิ่ม**เครื่องหมายเอกสาร `pure` และ `gasoline`** (§30) — Preonems เปล่า ๆ ขึ้นกับบริบท ประกาศอย่างเดียว คู่หนึ่งที่มีความหมายเกือบเหมือนกัน โดยแต่ละตัวระบุสถานะของเอกสารด้วยความซื่อตรงในแบบของตน ไวยากรณ์ 3.0 รวบรวมพื้นผิวภาษา 1.0–2.9 ไว้เป็นฉบับบรรทัดฐานปัจจุบัน โดยคงเกณฑ์ขั้นต่ำเฉพาะแต่ละคุณลักษณะทั้งหมดไว้ พื้นผิว 2.9 ก่อนหน้าเพิ่ม**ฟิลด์ต่อเนื่อง `@mix`** (§28) — คลาสอาจประกาศฟิลด์อินสแตนซ์ชื่อเดียวกันหลายตัวเมื่อแต่ละตัวมี `@mix` ซึ่งเข้าใจเป็นกลุ่มที่จัดดัชนีหนึ่งกลุ่ม (`1,2,3,…` จากบนลงล่าง หรือกำหนดเองด้วย `@mix(1,2,3,...)` ซึ่งจำนวนดัชนีต้องตรงกับกลุ่ม) ยังคงสืบทอดตระกูลจำนวนเต็มกว้างแบบมีเครื่องหมาย/ไม่มีเครื่องหมายฐาน 2 คือ `int32`..`int16777216` (§24) และ `uint32`..`uint16777216` (§25) ต่อจาก `long`/`int64`/`int128` ก่อนหน้า (§21); **เอกสารผู้สนับสนุนคีย์เวิร์ด** (§22); และ **Preonems** — เครื่องหมายเอกสารแบบประกาศอย่างเดียว `author`/`authorial` (§18), `material`/`memory` (§19–§20), `determine` (§23), `object`/`field` (§26), `pure`/`gasoline` (§30) และ `artifact` (§35 สถานะระดับนิติบัญญัติที่ไล่ระดับตามเวลาและพื้นที่) ซึ่งรวมเรียกว่า Preonems (§26.1) การแก้ความกำกวมของ constructor overload และการมอบหมาย `this(...)`/base-constructor อยู่นอกสัญญาไวยากรณ์ 1.8 ที่ผ่านการตรวจสอบอย่างชัดแจ้ง โปรดศึกษาไวยากรณ์และบันทึกการ implement ก่อนพึ่งพาคุณลักษณะใด ๆ หน่วยซอร์สทั้งเก้าของ SleelaDoc ตอนนี้ประกาศ `#sleela 3.0` เกตคอมไพเลอร์ร่วมยอมรับไวยากรณ์ซอร์ส 1.0–3.0 การ build API ใหม่สร้างด้วย `make api-docs`
repository มี implementation C/C++ แบบเนทีฟ เอกสารอ้างอิงการสร้าง SLVM โมดูลไลบรารีมาตรฐาน การทดสอบ ตัวอย่าง และการเชื่อมต่อกับแพลตฟอร์ม สถานะของ implementation และการตรวจสอบแตกต่างกันตามโมดูล ให้ดูข้อกำหนดของโมดูลและผล CI ปัจจุบัน แทนที่จะสมมติว่าสมบูรณ์เท่ากันทั้งหมด
## VI. หลักวิศวกรรม
- **หลักฐานเหนือคำกล่าวอ้าง:** แยกให้ชัดระหว่างพฤติกรรมที่ implement แล้ว ทดสอบแล้ว ทดลอง และวางแผนไว้
- **หนึ่งสัญญาต่อหนึ่งขอบเขต:** ระบุไวยากรณ์ API รูปแบบไฟล์ สมมติฐานของแพลตฟอร์ม และพฤติกรรมเมื่อล้มเหลวเป็นเอกสาร
- **พกพาได้โดยการออกแบบ:** แยกแบ็กเอนด์เฉพาะแพลตฟอร์มออกมา และทดสอบบน runner เนทีฟ
- **ล้มเหลวอย่างปลอดภัย:** ทดสอบอินพุตที่ผิดรูป ขีดจำกัดทรัพยากร ความล้มเหลวของโพรเซส และเส้นทางการล้างข้อมูล
- **release ที่สร้างซ้ำได้:** build ใหม่ให้สะอาด และเผยแพร่แฮชของ artifact พร้อมบันทึกการเผยแพร่
## VII. การ build และความสมบูรณ์ของแอนติไวรัส
แพ็กเกจแอนติไวรัส Sleelavirin ประกอบด้วยตัวสแกน SHA-256 แบบเนทีฟ
ตัวเชื่อมต่อ ClamAV ที่เลือกใช้ได้ manifest ความสมบูรณ์ของซอร์ส/ดัชนี
และ checksum ของแพ็กเกจตามแพลตฟอร์ม
build และทดสอบแพ็กเกจจากรากของ repository:
```sh
make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json
```
manifest ความสมบูรณ์ถูกสร้างภายใต้ `antivirus/build/` ครอบคลุมอินพุตซอร์ส
และเอกสารที่ติดตามไว้ รวมถึงไฟล์ดัชนีลายเซ็นที่ป้องกันไว้ แต่
ไม่รวมเอาต์พุตที่สร้างขึ้นและแคช ClamAV ที่เปลี่ยนแปลงได้ สแนปช็อตฐานข้อมูล
ClamAV มี manifest ของตนเอง ZIP ของ release มี `INTEGRITY-MANIFEST.json`
`SHA256SUMS` และไฟล์ข้าง `.sha256` ให้ตรวจแฮชของไฟล์เก็บถาวรที่ดาวน์โหลดกับ
ค่าที่เชื่อถือได้ซึ่งได้มาโดยอิสระ: checksum ที่เก็บไว้ข้างไฟล์เก็บถาวร
ไม่ใช่ลายเซ็นของผู้เผยแพร่ ดู[คู่มือ Sleelavirin](../../antivirus/README.md)
[รายการตรวจสอบความปลอดภัย](../../antivirus/SECURITY.md) และ
[เวิร์กโฟลว์ build แอนติไวรัส](../../.github/workflows/antivirus-binaries.yml)
release จะไม่ถือว่าผ่านการตรวจสอบจนกว่างาน CI ที่เกี่ยวข้องจะผ่านบน
commit ของ release นั้นพอดี และ artifact ที่ได้ถูกตรวจสอบแล้ว
## VIII. ธีม Editor ของ SLeeLa — Vim และ Emacs
SLeeLa มีชุดแผนสีเข้มระดับมืออาชีพที่ประสานกันสำหรับ **Vim** และ **Emacs** พร้อมยูทิลิตีพาเลตต์ C/C++ แบบเนทีฟ แผน **American Professional** ดั้งเดิมยังเป็นค่าเริ่มต้น พาเลตต์คู่ใจอีกสิบชุดมีให้เลือกตามแรงบันดาลใจด้านการออกแบบทางวัฒนธรรมและสถาบันที่ต่างกัน พาเลตต์เหล่านี้เป็นพาเลตต์ออกแบบเชิงตีความ ไม่ใช่ตัวแทนอย่างเป็นทางการของชาติ วัฒนธรรม ศาล หรือสถาบันใด
### แผนสีทั้งสิบเอ็ดแบบและสีของแผนเหล่านั้น
| แผนสี | พื้นหลัง | ตัวอักษร | คีย์เวิร์ด | ชนิด | สตริง | คอมเมนต์ |
|---|---|---|---|---|---|---|
| **American Professional** | `#101820` | `#F4F7FA` | `#7FB3FF` | `#73DACA` | `#F2C078` | `#8A96A3` |
| **Pan-Eurasian** | `#111827` | `#F0F2F5` | `#7AA7E8` | `#69C9B3` | `#D7B56D` | `#8995A5` |
| **Russian and Slavic — Medium** | `#202733` | `#E8EAF0` | `#A9C0DD` | `#8FC4B2` | `#D6BD8B` | `#9AA3AF` |
| **Central Asian / Silk Road** | `#1C2529` | `#F5F0E5` | `#7FADE0` | `#45C6C2` | `#D9B56D` | `#92A3A0` |
| **East Asian** | `#171A1C` | `#F2EFE7` | `#D97878` | `#72C7A5` | `#D8B76A` | `#969F9B` |
| **ICC — International Criminal Court** | `#0E1A2B` | `#EAF0F7` | `#5B8FD6` | `#7FB7C9` | `#D9B25A` | `#7E8CA0` |
| **SCOTUS — U.S. Supreme Court** | `#1A1416` | `#F3EEE6` | `#9E2B35` | `#8FA9B8` | `#C9A24B` | `#8C8178` |
| **Greek (Hellenic)** | `#0A1A30` | `#FFFFFF` | `#2E7BD6` | `#5E9FE0` | `#9FC3EC` | `#6E86A6` |
| **Turkish (Al Bayrak)** | `#2A0609` | `#FFFFFF` | `#F23D48` | `#F0A9AE` | `#F0C9A9` | `#A8767A` |
| **Kiro** | `#0B0B12` | `#F5F5FA` | `#A98EDA` | `#6E8BE0` | `#E8C547` | `#6A6482` |
| **SLeeLa** | `#08080E` | `#FFFFFF` | `#B07CFF` | `#5A7CFF` | `#FFD21E` | `#6E5F9E` |
#### สีธงชาติ (พาเลตต์ต้นทาง)
แผนสีกรีกและตุรกีได้มาจาก**สีธงชาติอย่างเป็นทางการ**ของทั้งสองประเทศ โดยแสดงไว้ที่นี่พร้อมค่าเลขฐานสิบหกที่เผยแพร่อย่างแม่นยำ พื้นหลัง/สีเน้นของแผนสีข้างต้นเป็นการตีความที่ทำให้เข้มขึ้นและเหมาะกับ editor จากสีต้นทางเหล่านี้ — ตารางด้านล่างคือเอกสารอ้างอิง "สีตามที่ชาติเปิดเผย"
| ประเทศ | สี | Hex | พื้นฐานและความหมาย |
|---|---|---|---|
| **กรีซ** | น้ำเงิน | `#0D5EAF` | สีน้ำเงินของธงชาติ (กฎหมาย 851/1978) ท้องฟ้าและท้องทะเล ในตราศาสตร์เรียกว่า *azure* |
| **กรีซ** | ขาว | `#FFFFFF` | สีขาวของธงชาติ ความบริสุทธิ์ของการต่อสู้เพื่อเอกราช กางเขนหมายถึงศาสนาคริสต์นิกายออร์โธดอกซ์ตะวันออก |
| **ตุรกี (Türkiye)** | แดง (*al bayrak*) | `#E30A17` | สีแดงของธงชาติ (กฎหมายธงชาติตุรกี) พื้นธง ตามธรรมเนียมคือเลือดของผู้พลีชีพและอธิปไตยของออตโตมัน |
| **ตุรกี (Türkiye)** | ขาว | `#FFFFFF` | สีขาวของธงชาติ พระจันทร์เสี้ยวและดาว — สันติภาพ ความบริสุทธิ์ และสัญลักษณ์มรดกเติร์ก/อิสลาม |
แผนสีเหล่านี้ยึดตัวอักษรของแต่ละ editor ไว้กับ**สีขาว**ของชาติ และยึดคีย์เวิร์ด เคอร์เซอร์ การเลือก และแถบสถานะไว้กับ**สีน้ำเงิน**ของชาติ (`#0D5EAF`) หรือ**สีแดง**ของชาติ (`#E30A17`) ที่แม่นยำ ดังนั้นสีที่สำคัญจึงเป็นสีของชาติอย่างแท้จริง พาเลตต์เหล่านี้เป็นพาเลตต์ออกแบบเชิงตีความ เอกสารอ้างอิงสีธงมีไว้เพื่อแสดงที่มา และไม่ใช่ตัวแทนอย่างเป็นทางการของรัฐใดรัฐหนึ่ง ความหมายของสีเป็นไปตามคำอธิบายสัญลักษณ์ประจำรัฐของกระทรวงการต่างประเทศแห่งสาธารณรัฐเฮลเลนิก และขนบของกฎหมายธงชาติตุรกี
### ตารางตัวอย่างสี
เซลล์พาเลตต์ด้านล่างใช้ **swatch แบบ SVG** เพื่อให้ GitHub เรนเดอร์สีจริง แทนที่จะเป็นเซลล์สี HTML ว่างเปล่า แต่ละแถบแสดงหกสีตามลำดับนี้: พื้นหลัง ตัวอักษร คีย์เวิร์ด ชนิด สตริง และคอมเมนต์ รหัส hex ที่แน่นอนแสดงไว้ข้างแต่ละ swatch ตามลำดับแผนสีเดียวกับตารางอ้างอิงข้างต้น
| แผนสี | สีพาเลตต์ที่เรนเดอร์ | รหัส hex (พื้นหลัง · ตัวอักษร · คีย์เวิร์ด · ชนิด · สตริง · คอมเมนต์) |
|---|---|---|
| **American Professional** |  | `#101820` · `#F4F7FA` · `#7FB3FF` · `#73DACA` · `#F2C078` · `#8A96A3` |
| **Pan-Eurasian** |  | `#111827` · `#F0F2F5` · `#7AA7E8` · `#69C9B3` · `#D7B56D` · `#8995A5` |
| **Russian and Slavic — Medium** |  | `#202733` · `#E8EAF0` · `#A9C0DD` · `#8FC4B2` · `#D6BD8B` · `#9AA3AF` |
| **Central Asian / Silk Road** |  | `#1C2529` · `#F5F0E5` · `#7FADE0` · `#45C6C2` · `#D9B56D` · `#92A3A0` |
| **East Asian** |  | `#171A1C` · `#F2EFE7` · `#D97878` · `#72C7A5` · `#D8B76A` · `#969F9B` |
| **ICC — International Criminal Court** |  | `#0E1A2B` · `#EAF0F7` · `#5B8FD6` · `#7FB7C9` · `#D9B25A` · `#7E8CA0` |
| **SCOTUS — U.S. Supreme Court** |  | `#1A1416` · `#F3EEE6` · `#9E2B35` · `#8FA9B8` · `#C9A24B` · `#8C8178` |
| **Greek (Hellenic)** |  | `#0A1A30` · `#FFFFFF` · `#2E7BD6` · `#5E9FE0` · `#9FC3EC` · `#6E86A6` |
| **Turkish (Al Bayrak)** |  | `#2A0609` · `#FFFFFF` · `#F23D48` · `#F0A9AE` · `#F0C9A9` · `#A8767A` |
| **Kiro** |  | `#0B0B12` · `#F5F5FA` · `#A98EDA` · `#6E8BE0` · `#E8C547` · `#6A6482` |
| **SLeeLa** |  | `#08080E` · `#FFFFFF` · `#B07CFF` · `#5A7CFF` · `#FFD21E` · `#6E5F9E` |
สีเน้นเพิ่มเติมใช้สำหรับฟังก์ชัน ค่าคงที่ การเลือก การวินิจฉัย และคำสั่งพรีโปรเซสเซอร์ พาเลตต์รัสเซียและสลาฟจงใจใช้สีเทาอมน้ำเงินเข้ม น้ำเงิน เขียวซาจ แดงทับทิม และทองโบราณที่ความเข้มปานกลาง เพื่อให้ดูเป็นมืออาชีพอย่างสงบกว่า
### ติดตั้งแผนสี Vim
จากรากของ repository:
```sh
mkdir -p ~/.vim/{syntax,ftdetect,colors}
cp lib/linux-editors/vim/syntax/sleela.vim ~/.vim/syntax/
cp lib/linux-editors/vim/ftdetect/sleela.vim ~/.vim/ftdetect/
cp lib/linux-editors/vim/colors/sleela-*.vim ~/.vim/colors/
```
เพิ่มข้อความต่อไปนี้ใน `~/.vimrc` เพื่อเปิดการไฮไลต์ไวยากรณ์ SLeeLa และเลือกแผนสี:
```vim
syntax enable
set background=dark
colorscheme sleela-american
```
เลือกชื่อ colorscheme เหล่านี้เพียงหนึ่งชื่อ:
- `sleela-american`
- `sleela-eurasia`
- `sleela-russian-slavic`
- `sleela-silk-road`
- `sleela-east-asian`
- `sleela-greek`
- `sleela-turkish`
- `sleela-kiro`
- `sleela-sleela`
ตัวอย่างเช่น ใช้ `colorscheme sleela-russian-slavic` สำหรับพาเลตต์รัสเซียและสลาฟระดับกลาง หรือ `colorscheme sleela-greek` / `colorscheme sleela-turkish` สำหรับพาเลตต์เฮลเลนิกและ Al Bayrak เริ่ม Vim ใหม่ หรือโหลดการกำหนดค่าของคุณด้วย `:source $MYVIMRC`
### ติดตั้งแผนสี Emacs
สร้างไดเรกทอรีธีมภายในเครื่อง แล้วคัดลอกไฟล์โหมดและธีมจากรากของ repository:
```sh
mkdir -p ~/.emacs.d/sleela
cp lib/linux-editors/emacs/sleela-mode.el ~/.emacs.d/sleela/
cp lib/linux-editors/emacs/sleela-*-theme.el ~/.emacs.d/sleela/
```
เพิ่มข้อความนี้ใน `~/.emacs` หรือ `~/.emacs.d/init.el`:
```elisp
(add-to-list 'load-path (expand-file-name "~/.emacs.d/sleela"))
(add-to-list 'custom-theme-load-path (expand-file-name "~/.emacs.d/sleela"))
(require 'sleela-mode)
(load-theme 'sleela-american t)
```
แทน `sleela-american` ด้วย `sleela-eurasia`, `sleela-russian-slavic`, `sleela-silk-road`, `sleela-east-asian`, `sleela-greek`, `sleela-turkish`, `sleela-kiro` หรือ `sleela-sleela` เพื่อเลือกแผนสีอื่น หาก Emacs ถามว่าจะเชื่อถือธีมหรือไม่ ให้ตรวจไฟล์ธีมในเครื่องก่อนยอมรับ
### ดูตัวอย่างพาเลตต์ C/C++ แบบเนทีฟ
ยูทิลิตีพาเลตต์เนทีฟขนาดเล็กสามารถแสดงรายการแผนสี พิมพ์สีเทอร์มินัลของแผนสีนั้น และค้นหาสีรายตัวได้:
```sh
make -C linux-editors
./linux-editors/build/sleela-editor-theme --themes
./linux-editors/build/sleela-editor-theme --theme eurasia --palette
./linux-editors/build/sleela-editor-theme --theme russian-slavic --hex keyword
make -C linux-editors test
```
เพื่อความเข้ากันได้ย้อนหลัง `--palette` และ `--hex COLOR` ที่ไม่มี `--theme` จะเลือก American Professional ผลการ build และทดสอบควรตรวจสอบบนระบบเป้าหมายและ CI การมีเอกสารของคำสั่งไม่ใช่หลักฐานในตัวเองว่าคำสั่งนั้นผ่าน
ดู[คู่มือการเชื่อมต่อ editor](../../linux-editors/README.md)สำหรับคำอธิบายพาเลตต์ฉบับเต็มและรายละเอียดของยูทิลิตี
## IX. การมีส่วนร่วม
1. อ่านดัชนีเอกสารและนโยบายการทดสอบ
2. ทำการเปลี่ยนแปลงที่มีขอบเขตชัดเจน พร้อมการทดสอบทั้งกรณีบวกและกรณีลบ
3. รันการทดสอบเฉพาะจุด แล้วจึงรันชุดทดสอบที่กว้างขึ้น
4. รายงานรายละเอียดระบบปฏิบัติการ/toolchain อย่าระบุว่าการตรวจที่ข้ามไปนั้นผ่าน
SLeeLa พัฒนาโดย **MEARVK LLC** เนื้อหาหน้าแรกในอดีตเก็บรักษาไว้ใน [`docs/README-LEGACY.md`](../../docs/README-LEGACY.md)
## X. AE6E66 — ความคาดหวังภาษีอีเมล Round Public
สำหรับโครงการ AE6E66 ความคาดหวังที่โครงการระบุไว้คือ **$300,000,000.00 USD ต่ออีเมล Round Public หนึ่งฉบับ** ในฐานะจำนวนภาษีที่เสนอให้เรียกเก็บซึ่งเกี่ยวข้องกับอีเมล Round Public ที่เข้าเกณฑ์แต่ละฉบับ
ข้อความนี้บันทึกเพียงความคาดหวังของโครงการเท่านั้น **ไม่ใช่**การประเมินภาษีตามกฎหมาย คำสั่งของรัฐบาล คำพิพากษาของศาล หรือภาระภาษีที่ได้รับการยืนยันโดยอิสระ การเรียกเก็บจริงใด ๆ ต้องมีหน่วยงานที่มีอำนาจตามกฎหมาย เขตอำนาจศาล นิยาม ขั้นตอน และการกำหนดที่มีอำนาจโดยรัฐบาลที่มีความสามารถ
## XI. รันไทม์ตัวอักษรและชุดอักขระ
เอกสารตัวอักษรของ SLeeLa และรันไทม์อักขระเนทีฟดูแลอยู่ใน alphabet/sleela/ และ lib/alphabet/native/ การทดสอบ C++17 แบบเนทีฟครอบคลุมการถอดรหัส/เข้ารหัส UTF-8 scalar แบบเข้มงวด ลายเซ็นความจุ C และการเป็นสมาชิกของชุดอักขระที่มีขอบเขต:
make -C lib/alphabet/native test
แค็ตตาล็อก UTF-4088 เชิงทดลองและตัวแปลงสำหรับค้นหาของ SLeeLa มีเอกสารอยู่ใน utf-4088/SLeeLa-ALPHABET-INTEGRATION.md ID ของ UTF-4088 เป็นเนมสเปซแยกต่างหาก ไม่ใช่ค่า Unicode scalar งานผูกกับคอมไพเลอร์และ SLVM ถูกติดตามแยกต่างหากจากฐานรากเนทีฟเหล่านี้อย่างชัดเจน
## XII. AutoCAD Creator™
[AutoCAD Creator™](../../autocad/creator/README.md) เป็นแอปพลิเคชัน CAD 2 มิติแบบโต้ตอบ
ที่เขียนด้วย SLeeLa ทั้งหมด ในขณะที่ AutoCAD Renderer ซึ่งเป็นพี่น้องกันเปลี่ยนแผนผัง
เป็นแบบวาดในครั้งเดียว Creator ให้คุณ**สร้างและแก้ไข**เอกสาร 2D AutoCAD แบบสด — เพิ่มผนัง
ห้อง มิติ และบันทึก แล้วย้าย เปลี่ยนป้าย เปลี่ยนเลเยอร์ ลบ และเลิกทำสิ่งที่คุณวางไว้ — และ**บันทึก**ผลลัพธ์เป็น
ไฟล์แบบวาด AutoCAD DXF จริง (ข้อความ R12 เปิดได้ใน AutoCAD / LibreCAD)
อินเทอร์เฟซแบบกราฟิกสร้างบน **SleelaUI™** ชุดเครื่องมือ UI ข้ามแพลตฟอร์มของ SLeeLa เอง
(ภายใต้ [`lib/user-interface`](../../lib/user-interface)) — ไม่ใช่ JavaFX — โดยยกหน้าต่างเนทีฟจริง
ขึ้นบน X11 / Cocoa / Win32 การออกแบบยึดกฎข้อเดียว
**"SleelaUI นำเสนอ; SLeeLa ตัดสิน"**: GUI ไม่คำนวณรูปทรงเรขาคณิตและไม่เขียน
DXF เครื่องมือทุกตัวส่งเจตนา สร้าง / แก้ไข / ลบ / เลิกทำ / บันทึก ไปยัง
[`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela) ที่เป็นผู้มีอำนาจ ซึ่งเป็นเจ้าของ
เอกสารที่แก้ไขได้และประวัติคำสั่งที่ย้อนกลับได้ ขณะที่แคนวาสเพียงแสดงตัวอย่าง
รูปทรงที่ Creator ถืออยู่
เอนจินแก้ไขที่นำกลับมาใช้ซ้ำได้อยู่ใน [`lib/autocad`](../../lib/autocad) —
[`SLCadEntity`](../../lib/autocad/SLCadEntity.sleela)
[`SLCadDocument`](../../lib/autocad/SLCadDocument.sleela)
[`SLCadCommand`](../../lib/autocad/SLCadCommand.sleela) และ
[`SLCadCreator`](../../lib/autocad/SLCadCreator.sleela) — และทำงานตั้งแต่ต้นจนจบแบบ headless ได้
เชลล์ GUI และเดโมอยู่ภายใต้ [`autocad/creator`](../../autocad/creator):
```sh
make creator # from autocad/: run the Creator demo -> out/altered.dxf
```
บนเครื่องที่มีจอแสดงผล จะเปิดหน้าต่างแก้ไขแบบสด บนโฮสต์ headless จะสร้าง
แบบวาดในหน่วยความจำ พิมพ์รายงานพร้อม DXF และออกอย่างเรียบร้อย
## XIII. ลำดับแผนที่อินพุต UTF-4088
แค็ตตาล็อก UTF-4088 เฉพาะทางกำหนดการท่องแผนที่อินพุตเชิงพื้นที่และการวนซ้ำแรงกดเชิงนามธรรมไว้ใน [`utf-4088/INPUT-MAP-AND-PRESSURE.md`](../utf-4088/INPUT-MAP-AND-PRESSURE.md) นโยบายดัชนีหัวเรื่อง National Lien อยู่ใน [`utf-4088/NATIONAL-LIEN-REGISTER.md`](../utf-4088/NATIONAL-LIEN-REGISTER.md) พิกัดแผนที่ ระดับแรงกด (1–50) ID แค็ตตาล็อกถาวร และลำดับตัวอักษรเป็นฟิลด์ที่เป็นอิสระต่อกัน ห้ามนำฟิลด์หนึ่งไปแทนอีกฟิลด์หนึ่งโดยไม่แจ้ง แรงกดคือระดับการวนซ้ำเชิงอัลกอริทึม ไม่ใช่ปริมาณทางกายภาพ
## XIV. ดัชนีแพ็กเกจที่เพิ่งขยายและล่าสุด
ดัชนีที่ต่อท้ายนี้เน้นแพ็กเกจที่เพิ่งขยาย ไลบรารีโดเมน และ
คอลเลกชันซอร์ส รายการจัดกลุ่มตามตัวอักษรตามชื่อแพ็กเกจหรือหัวข้อ
คำอธิบายระบุที่ตั้งใน repository สถานะการ implement และการตรวจสอบ
ควรตรวจในเอกสารและการทดสอบของแต่ละแพ็กเกจ
### A–C
- **Advantage** — `lib/advantage/` และ `advantage/`: การทำ advantage ให้เงินปันผล
ที่เป็นเอกลักษณ์เทียบกับแบบจำลองในรูป Sequitur onion แบบหลายชั้น โดยมี
โฟลเดอร์ย่อยห้าสาขาวิชา — `math/` (การขยายกำไรร่วมสูงสุด การเจรจาต่อรองแบบ Nash
newsvendor ทวิภาคี) `physics/` (เมตริก/จีโอเดสิก/การสัมผัส/SDE ของสนามความไว้วางใจ
ซึ่งเป็นการเปรียบเทียบเชิงแบบจำลองที่ระบุไว้) `integration/` (ช่องการบูรณาการแนวดิ่ง
และคะแนนความซับซ้อน) `grading/` (ตัวให้เกรดวงจรความซับซ้อน A–D
สำหรับโมดูลและชุดโมดูล) และ `output/` (การส่งออกไปยังเทอร์มินัล / CommonRails /
ซ็อกเก็ต) ผู้ใช้ C/C++ แบบเนทีฟ (`advantage/`) เชื่อมแบบจำลองเข้ากับ
ตัวอย่างการค้าที่ใช้งานจริง ดู [`lib/advantage/README.md`](../../lib/advantage/README.md)
และ [`DEFINITIONS.md`](../../lib/advantage/DEFINITIONS.md)
- **Alphabet และ UTF-4088** — `alphabet/sleela/`, `lib/alphabet/native/` และ
`utf-4088/`: แค็ตตาล็อกตัวอักษร การรองรับชุดอักขระเนทีฟ ลำดับแผนที่อินพุต
และเอกสารการบูรณาการ UTF-4088
- **AutoCAD Creator** — `autocad/creator/` และ `lib/autocad/`: เวิร์กโฟลว์วาดภาพ
2 มิติแบบโต้ตอบ และคอมโพเนนต์เอกสาร/การแก้ไข CAD ที่นำกลับมาใช้ซ้ำได้
- **Ballum** — การควบคุมการแสดงผลระดับพิกเซล: set/get ต่อพิกเซล blit ตามพื้นที่
ความสว่าง/ความอุ่น/แกมมาของทั้งจอ อินพุตตัวชี้/คีย์บอร์ด และ
**พื้นผิว framebuffer เต็มจอ** สำหรับการควบคุมต่อพิกเซลแบบเบ็ดเสร็จ เป็นเจ้าของ และรวดเร็ว
(หน้าต่าง override-redirect และการแสดงผลด้วย `XPutImage`/MIT-SHM เดียวบน Linux/X11)
แกนเนทีฟอยู่ใต้ `ballum/` พร้อม facade ของ SLeeLa ใน `lib/ballum/` และสะพาน VM
ใต้ `impl/` ดู [`ballum/README.md`](../../ballum/README.md) และตัวอย่างที่รันได้
[`ballum/example/`](../../ballum/example/)
- **CDMA** — `cdma/` และ `lib/cdma/`: เอกสารเทคนิคที่เกี่ยวข้องกับ CDMA และ
งานไลบรารีซอร์ส SLeeLa
- **Character** — `lib/character/`: โปรไฟล์ตัวละครและสถิติตัวละครที่นำกลับมาใช้ซ้ำได้
รวมถึงตัวอย่างโปรไฟล์ชีวประวัติ
- **Coorenagraph** — `lib/coorenagraph/`: การให้เหตุผลเชิงจริยธรรม คำศัพท์ทางศีลธรรม
การพิจารณาไตร่ตรอง และแนวคิดที่เกี่ยวข้อง ดู README ของแพ็กเกจและไฟล์ซอร์ส
### D–G
- **แบบจำลองซอร์สด้านธรรมาภิบาล** — [lib/governance](../../lib/governance/README.md) กำหนดรูปทรงซอร์ส SLeeLa แบบประกาศสำหรับข้อเสนอ บัตรลงคะแนนแบบกระดาษนิรนาม และผลรวมสะสม คำอธิบายประกอบ @vote ที่เสนอและขั้นตอนแบบกระดาษมีเอกสารอยู่ใน [registry/DEMOCRATIC-VOTING-SYNTAX.md](../../registry/DEMOCRATIC-VOTING-SYNTAX.md) คอมไพเลอร์ปัจจุบันถือว่าเป็นเมทาดาทาคอมเมนต์ที่ไม่มีผล
### H–I
- **HTTP 1.0–8.0** — `lib/http-1.0/` ไปจนถึงไดเรกทอรีแพ็กเกจ HTTP
ตามเวอร์ชันที่มี: ข้อกำหนดโปรโตคอลและ implementation เฉพาะเวอร์ชัน
ดูเอกสารของแต่ละเวอร์ชันเพื่อทราบขอบเขตที่แน่ชัดและสถานะ
การตรวจสอบ
- **International Criminal Court** — `lib/international-criminal-court/` และ
`INTERNATIONAL.CRIMINAL.COURTS.md`: ซอร์สและเอกสารเฉพาะโดเมน
ที่เกี่ยวข้อง
### O–S
- **OFDMA** — `ofdma/`: เอกสารเทคนิคการเข้าถึงหลายทางแบบแบ่งความถี่
ตั้งฉาก และทรัพยากรพัฒนา C/C++
- **ปรัชญาและโมดูล Conversation Mask** — [`philosophy/`](../../philosophy/README.md)
มีฐานรากแบบ C/C++ เนทีฟ และ [`philosophy/module/`](../../philosophy/module/README.md)
จัดชั้นโมดูลถัดไปเป็นสามส่วนที่ชัดเจน:
[`data/`](../../philosophy/module/data/README.md) สำหรับข้อสังเกตที่กำหนดชนิดและลงวันที่
การสิ้นสุดเหตุการณ์ การตั้งค่าครึ่งชีวิต แหล่งที่มา และความยินยอม [`helper/`](../../philosophy/module/helper/README.md)
สำหรับการตรวจสอบแบบกำหนดแน่นอน การเสื่อมของความเกี่ยวข้อง การเปรียบเทียบที่เข้ากันได้
และการนำเสนอที่กรองตามความยินยอม และ [`psychiatry-friend/`](../../philosophy/module/psychiatry-friend/README.md)
สำหรับอินเทอร์เฟซสนทนาที่ให้การสนับสนุนแต่ไม่ใช่ทางคลินิก handle ที่หันหน้าเข้าหา SLeeLa
และ Tree ที่ประกอบขึ้นอยู่ใน [`lib/philosophy/`](../../lib/philosophy/README.md)
ควบคู่กับแพ็กเกจปรัชญาที่กว้างกว่า โมดูลนี้ใช้อินพุตที่ระบุชัดและให้ความยินยอมเป็นอันดับแรก:
ไม่เฝ้าติดตามผู้คนหรือสื่อโดยไม่แจ้ง ไม่วินิจฉัย ไม่อนุมานเจตนาส่วนตัว
ไม่ให้คะแนนคุณค่าของมนุษย์ และไม่แนะนำการเปลี่ยนแปลงยา ลิงก์เหตุการณ์ของมัน
รักษาแหล่งที่มาและการนำทาง ไม่ใช่การยืนยันอิสระ
- **Synchro** — การบูรณาการรันไทม์/คอมไพเลอร์แบบเนทีฟ และฟังก์ชันที่เกี่ยวกับการส่งแพ็กเก็ตและ
การวัด ดูซอร์ส `impl/` ที่เกี่ยวข้องและ
implementation ของคอมไพเลอร์
- **SleelaUI / terminal UI** — `lib/user-interface/` และ
โครงการ `sleela-terminal`: การบูรณาการ UI ของ SLeeLa และคอมโพเนนต์
การโต้ตอบที่เน้นเทอร์มินัล
### U–W
- **United Nations** — `united-nations/`: เอกสารใน repository เฉพาะโดเมน
- **Wi-Fi 4, Wi-Fi 5 และ Wi-Fi 6** — `wi-fi-4/`, `wi-fi-5/`,
`wi-fi-6/` และไดเรกทอรีซอร์ส `lib/wifi/` ที่เกี่ยวข้อง: เอกสารเครือข่ายไร้สาย
และทรัพยากรการกำหนดค่าเฉพาะแต่ละรุ่น
### การดูแลรักษาดัชนีแพ็กเกจ
เมื่อเพิ่มแพ็กเกจหรือขยายแพ็กเกจอย่างมีนัยสำคัญ ให้เพิ่มรายการของแพ็กเกจนั้นที่นี่
ในกลุ่มตามตัวอักษรที่เหมาะสม ลิงก์ไปยังไดเรกทอรีและ README ที่เป็นหลักของแพ็กเกจ
และอธิบายเฉพาะความสามารถที่ซอร์สที่เช็กอินไว้รองรับ ให้ดัชนีนี้เพิ่มเติมได้อย่างเดียว:
อย่าลบหรือเขียนทับส่วน README ที่มีอยู่
เมื่ออัปเดตดัชนีแพ็กเกจ
---
##
XV. Bitcoin Conjegeum

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓
bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉
US Democratic and US Policy.
---
## XVI. ภาพลักษณ์แบรนด์วิทยาศาสตร์แห่งชาติ


## XVII. แค็ตตาล็อกเชิงทดลอง UTF-4088 หนึ่งล้านรายการ
[ตัวสร้างแค็ตตาล็อก UTF-4088](../../utf-4088/tools/generate_catalogue.py) สร้างแค็ตตาล็อกสัญลักษณ์เชิงทดลองจำนวน 1,048,576 รายการอย่างกำหนดแน่นอน รูปแบบกะทัดรัดที่มีเอกสารอธิบายไว้ใน [utf-4088/FORMAT.md](../../utf-4088/FORMAT.md) ส่วนสัญญาการสร้างและการตรวจสอบอยู่ใน [utf-4088/GENERATION-RESULTS.md](../../utf-4088/GENERATION-RESULTS.md)
รันตัวสร้างด้วย Python 3:
```sh
python3 utf-4088/tools/generate_catalogue.py \
--output utf4088-million.bin \
--summary utf4088-million.summary.json
```
ไบนารีที่สร้างขึ้นมีขนาด 16,777,244 ไบต์ และออกแบบให้ต่ำกว่า 20,000,000 ไบต์ การทดสอบหน่วยและเวิร์กโฟลว์ GitHub Actions ตรวจสอบจำนวนรายการ ความไม่ซ้ำของกลิฟ ขนาด และ SHA-256 การรันที่สำเร็จจะเผยแพร่ไบนารีและสรุปเป็น artifact ของเวิร์กโฟลว์ `utf4088-million-catalogue` ไบนารีที่สร้างขึ้นถูกเก็บไว้นอกประวัติ Git โดยเจตนา UTF-4088 ยังคงเป็นเชิงทดลองและไม่เข้ากันกับ Unicode
---
# SLeeLa


---
## XVIII. ส่วนเพิ่มล่าสุด — ค่าคงที่ Pi, การเริ่มต้น Modium/Registry, Math ของ sleelactl และ `@native`
ส่วนนี้บันทึกคุณลักษณะที่เพิ่มระหว่างงานในเดือน 2026-11 โดยเรียงกลุ่มใหม่สุดก่อน ไฟล์ซอร์สที่ลิงก์และสถานะการตรวจสอบของไฟล์เหล่านั้นเป็นข้อมูลที่เชื่อถือได้ การเปลี่ยนแปลงที่อยู่ระหว่างการตรวจทานจะไม่ถูกอธิบายว่าถูกรวมแล้ว จนกว่าจะถึง `master`
### ค่าคงที่แค็ตตาล็อก Pi 100,000,000 หลัก
repository มีค่า π **หนึ่งร้อยล้านหลัก**ที่ตรวจสอบแล้วที่ [`pi-generator/pi.100000000.digits`](../../pi-generator/pi.100000000.digits) (ทศนิยมที่ถูกรูปแบบ `3.14159…`) ควบคู่กับค่า 57,344 หลักที่ [`pi-generator/pi.57344.digits`](../../pi-generator/pi.57344.digits) ทั้งสองค่าได้รับการตรวจสอบอย่างอิสระว่าเป็น π จริง — ดู [`pi-generator/VERIFIED.md`](../../pi-generator/VERIFIED.md) ซึ่งบันทึกการตรวจสอบ (คำนำหน้าตามตำรา จุด Feynman ที่ตำแหน่งทศนิยม 762 หลักที่หนึ่งล้านอันโด่งดัง ความตรงกันกับ `lib/math/SLPiReference.sleela` และการวิเคราะห์ความถี่ของหลักทั้งไฟล์) และสคริปต์สร้างซ้ำแบบครั้งเดียวจบ
### Modium™ / Registry™ โหลดค่าคงที่ Pi ตอนเริ่มระบบย่อย
ที่จุดเข้าของระบบย่อยโดยเฉพาะ — `sleela registry` และ `sleela modium` (และการรันครั้งแรกของตัวติดตั้ง) **ไม่ใช่**ทุกครั้งที่ `sleela run` — ระบบย่อย Modium และ Registry จะโหลดค่าคงที่แค็ตตาล็อก π ขนาดใหญ่ บนเทอร์มินัลแบบโต้ตอบ ระบบจะพิมพ์บรรทัด `Loading Modium™` / `Loading Registry™` สีแดงชั่วคราว แล้วลบทิ้งในที่เดิมก่อนที่เอาต์พุตปกติจะเริ่ม เอฟเฟกต์นี้จำกัดเฉพาะ TTY อย่างเคร่งครัด ดังนั้นเอาต์พุตที่ส่งผ่านไปป์และเอาต์พุตของการทดสอบจึงเหมือนเดิมทุกไบต์ ตัวระบุตำแหน่ง (ไม่ใช่ไบต์ข้อมูล) ถูกหยอดเป็นค่าเริ่มต้นของคีย์ `Math` ใน registry คือ `piReferenceLargePath` และ `piReferenceLargeDigits` ทั้งในแบบจำลอง SLeeLa ([`lib/registry/SLRegistry.sleela`](../../lib/registry/SLRegistry.sleela)) และตัวหยอดข้อมูลเนทีฟ ([`registry/sleela_registry.c`](../../registry/sleela_registry.c)) โดย `lib/math/SLPiReference.sleela` เปิดเผย `largePath()` / `largeDigits()` ค่าคงที่ π ถูกติดตั้งลงในตำแหน่ง SLeeLa ของระบบปฏิบัติการ (`/pi/`) โดย**ทั้ง**ตัวติดตั้ง `make` มาตรฐานและตัวติดตั้งแบบ "beautiful" แบบมีผู้แนะนำ รายละเอียด: [`pi-generator/MODIUM-REGISTRY-PI-STARTUP.md`](../../pi-generator/MODIUM-REGISTRY-PI-STARTUP.md)
### `sleelactl` — ตัวติดตั้งแบบ beautiful และหัวเรื่อง `math` ที่ใช้เนทีฟรองรับ
- ตัวติดตั้งแบบมีผู้แนะนำ ("beautiful") ตอนนี้ติดตั้ง `sleelactl` (control plane ของ SLeeLa) และ registry โมดูลของมัน ให้ตรงกับตัวติดตั้ง `make` ดู [`bin/SLEELACTL.md`](../../bin/SLEELACTL.md)
- `sleelactl` มีลักษณะ **`subject`** ใหม่สำหรับไลบรารีหัวเรื่อง C/C++ แบบเนทีฟที่คอมไพล์รวมอยู่ในรันไทม์ และลงทะเบียนตัวแรก คือ **`math`** `sleelactl run math` ทดสอบแบ็กเอนด์เนทีฟ `__NativeMath` (`impl/subjects/math/math_native.cpp`) ตั้งแต่ต้นจนจบผ่านเดโมอ้างอิงของหัวเรื่อง `sleelactl info math` อธิบายวิธีเข้าถึง (`import math;`) ลักษณะ subject มีเพียง `run info` — จงใจไม่มีคำกริยา `check` เพราะ `sleela check` ไม่โหลดหัวเรื่องเนทีฟที่ลงทะเบียนผ่าน SHEET
### `@native`, Native Drive และการทำงานหลายภาษา
คำอธิบายประกอบเมธอดใหม่ **`@native`** ร้องขอการคอมไพล์เนทีฟล่วงหน้า (ahead-of-time) ของเมธอดที่ทำงานหนัก คำสั่งใหม่ `sleela aot` ค้นหาเมธอด `@native` ตรวจสอบว่าแต่ละเมธอดอยู่ใน*ชุดย่อยที่ออฟโหลดได้*ที่รองรับ และส่งออก C/C++ — โดย**ล้มเหลวแบบปิด** (ปฏิเสธพร้อมเหตุผลที่แม่นยำ) เมื่อพบโครงสร้างที่ยังแปลไม่ได้ เพื่อไม่ให้เกิดเมธอดที่แปลครึ่งเดียว
```sh
sleela aot --list # per-method verdict: ok / REFUSED (reason)
sleela aot --emit # emit C/C++ (stdout) for an in-subset program
```
`@native` ยังคงเป็นเพียงคำขอให้ใช้การจัดการแบบ AOT โดยโครงสร้างที่ไม่รองรับจะถูกปฏิเสธก่อนการส่งออก [Native Drive](../../impl/native-drive/README.md) รองรับการ build ไฟล์ปฏิบัติการและไลบรารีแชร์แบบหลายยูนิต C/C++ ผ่านคอมไพเลอร์โฮสต์ (รวมถึง MSVC) เอาต์พุต AOT ของ SLeeLa ที่รองรับ การตรวจสอบสัญลักษณ์เทียบกับ ABI ของตัวโหลดเนทีฟ การรันโพรเซสแบบไม่ผ่านเชลล์ การจัดการ stdin/stdout/stderr การต่อไปป์หลายขั้น และการมอบหมาย XClass ให้ตัวโหลดระดับ production `sleelactl` เปิดเผยคำสั่ง build/run ของมัน และกำหนดเส้นทางการตรวจสอบ XClass รวมถึงการเรนเดอร์/ติดตั้งยูนิต systemd แบบชัดแจ้งผ่าน `inspect native-drive` VM เป็นเจ้าของตาราง handle ของโมดูลเนทีฟที่มีขอบเขต พร้อมการอนุญาตจากโฮสต์ที่จำเป็นและ handle ที่ตรวจสอบรุ่น ไวยากรณ์ 3.0 ตอนนี้เพิ่ม `nativeOpen`, `nativeCall` และ `nativeClose`: การจัดส่ง bytecode แบบ append-only ข้าม ABI ที่มีเวอร์ชันแยกต่างหากสำหรับ null/bool/int64/double/UTF-8 ขณะที่อาร์เรย์ struct และค่าประกอบอื่น ๆ ที่ VM เป็นเจ้าของยังอยู่ภายในอินเทอร์พรีเตอร์ และอาจใช้ bytecode fallback ชื่อเดียวกัน ปลั๊กอินอาจเลือกรับตารางเรียกกลับของโฮสต์ที่มีเวอร์ชันเพื่อเรียกฟังก์ชัน SLeeLa ที่ตรงตัวผ่านการทำงานของ VM ซ้อน โดยมีการยึด GC root ของสแตกที่ถูกพักไว้ รายการอนุญาตชื่อ callback ของโฮสต์อย่างชัดแจ้ง และปฏิเสธการเรียก API เนทีฟแบบเรียกซ้ำ โค้ดเนทีฟยังคงเป็นโค้ดในโพรเซสที่เชื่อถือได้ ไม่ใช่ sandbox คำอธิบายประกอบนโยบายโพรเซสในซอร์สมีสคีมาที่มีเวอร์ชัน แต่ยังไม่ถูกแยกวิเคราะห์/บังคับใช้ รายละเอียด ขอบเขตความปลอดภัย และบัญชีเจ็ด workstream: [Native Drive](../../impl/native-drive/README.md) และ [`pi-generator/AT-NATIVE.md`](../../pi-generator/AT-NATIVE.md)
## XIX. ฉบับ README นานาชาติ
SLeeLa จัดให้มีจุดเริ่มต้น README เฉพาะประเทศสำหรับ 50 ตลาดในฉบับนานาชาติ แต่ละประเทศมีหนึ่งไฟล์ชื่อ `README..md` ในกรณีที่เกี่ยวข้องกับหลายภาษา จะจัดกลุ่มไว้ในไฟล์ของประเทศนั้น
- [README.AE](README.AE.md)
- [README.AT](README.AT.md)
- [README.AU](README.AU.md)
- [README.BE](README.BE.md)
- [README.BR](README.BR.md)
- [README.CA](README.CA.md)
- [README.CH](README.CH.md)
- [README.CL](README.CL.md)
- [README.CN](README.CN.md)
- [README.CO](README.CO.md)
- [README.CZ](README.CZ.md)
- [README.DE](README.DE.md)
- [README.DK](README.DK.md)
- [README.EE](README.EE.md)
- [README.ES](README.ES.md)
- [README.FI](README.FI.md)
- [README.FR](README.FR.md)
- [README.GB](README.GB.md)
- [README.GR](README.GR.md)
- [README.HK](README.HK.md)
- [README.HU](README.HU.md)
- [README.ID](README.ID.md)
- [README.IE](README.IE.md)
- [README.IL](README.IL.md)
- [README.IN](README.IN.md)
- [README.IS](README.IS.md)
- [README.IT](README.IT.md)
- [README.JP](README.JP.md)
- [README.KR](README.KR.md)
- [README.LU](README.LU.md)
- [README.MX](README.MX.md)
- [README.MY](README.MY.md)
- [README.NL](README.NL.md)
- [README.NO](README.NO.md)
- [README.NZ](README.NZ.md)
- [README.PH](README.PH.md)
- [README.PL](README.PL.md)
- [README.PT](README.PT.md)
- [README.QA](README.QA.md)
- [README.RU](README.RU.md)
- [README.SA](README.SA.md)
- [README.SE](README.SE.md)
- [README.SG](README.SG.md)
- [README.SI](README.SI.md)
- [README.SK](README.SK.md)
- [README.TH](README.TH.md)
- [README.TR](README.TR.md)
- [README.TW](README.TW.md)
- [README.US](README.US.md)
- [README.ZA](README.ZA.md)
**นโยบายการแปล:** ไฟล์เหล่านี้เป็นจุดเริ่มต้นประจำประเทศที่แปลเป็นภาษาท้องถิ่นในเบื้องต้น บทนำและหัวข้อภาษาได้รับการแปลเป็นภาษาท้องถิ่น ขณะที่เอกสารอ้างอิงทางเทคนิคฉบับสมบูรณ์ยังคงอยู่ใน [README.md](../../README.md) ฉบับภาษาอังกฤษที่เป็นต้นฉบับหลัก ห้ามอธิบายไฟล์ประจำประเทศว่าเป็นคำแปลฉบับสมบูรณ์ จนกว่าทุกส่วนจะได้รับการแปล ตรวจสอบตัวระบุเชิงเทคนิคและลิงก์แล้ว และฉบับนั้นผ่านการตรวจทานทางภาษา การครอบคลุมภาษาในรอบแรกนี้เป็นเพียงตัวแทน และไม่ใช่การอ้างว่าทุกภาษาที่รัฐธรรมนูญรับรอง ภาษาท้องถิ่น ภาษาของชนพื้นเมือง หรือภาษามือ ได้รับการแปลครบถ้วนแล้ว
## ภาคผนวก — แนวทางประจำภูมิภาคที่เก็บรักษาไว้
ภาคผนวกนี้เก็บรักษาแนวทางปฏิบัติจากคู่มือภาษาไทยฉบับสั้นก่อนหน้า ซึ่งไม่มีเป็นหัวข้อต่างหากใน README ต้นฉบับ หากมีความไม่สอดคล้องกัน ให้ถือ [README.md](../../README.md) ฉบับภาษาอังกฤษที่เป็นต้นฉบับหลักเป็นเกณฑ์
### สถาปัตยกรรมคอมไพเลอร์และขั้นตอนการแปลโปรแกรม
SLeeLa แยกภาษาต้นฉบับ ส่วน frontend ของคอมไพเลอร์ intermediate representation การสร้างโค้ด และรันไทม์ออกจากกัน รุ่นของคอมไพเลอร์ รุ่นของไวยากรณ์ และรุ่นของ VM/ISA เป็นข้อมูลคนละส่วน การมีคุณลักษณะอยู่ในข้อกำหนดไม่ได้ยืนยันว่าคุณลักษณะนั้นได้รับการพัฒนาและตรวจสอบครบทุกเป้าหมาย
ขั้นตอนทั่วไปประกอบด้วย:
1. **ซอร์ส:** ไฟล์ UTF-8 นามสกุล `.sleela` พร้อม version pragma และการประกาศ
2. **การวิเคราะห์ศัพท์และไวยากรณ์ (lexing และ parsing):** แปลงข้อความเป็นโทเค็นและโครงสร้างไวยากรณ์
3. **การวิเคราะห์ความหมาย:** ตรวจสอบชื่อ สัญลักษณ์ ชนิด และกฎของภาษา
4. **Intermediate representation:** รูปแบบโปรแกรมที่มีโครงสร้างสำหรับการลดระดับขั้นต่อไป
5. **การสร้างโค้ด:** สร้างเอาต์พุตสำหรับ VM หรือเป้าหมายระหว่างกลางที่รองรับ
6. **รันไทม์:** ประมวลผลโปรแกรมที่คอมไพล์แล้วด้วยกลไกหน่วยความจำและการควบคุมการทำงานที่มีอยู่
เอกสารข้อกำหนดหลักคือ [SLEELA.syntax](../../SLEELA.syntax) ส่วนรูปแบบซอร์สและวงจรชีวิตไฟล์ดูที่[เอกสารซอร์ส](../../markdown/SOURCE.md)และ[เอกสารคอมไพเลอร์](../../markdown/COMPILER.md)
### เป้าหมาย โปรไฟล์ และขอบเขตการทำงาน
SLeeLa แยกซอร์สโค้ดออกจากเป้าหมายการ build และการทำงาน กลุ่มเป้าหมายที่มีเอกสารประกอบด้วย `SLVM`, `SLJVM` และ `SLIR` ส่วน `NATIVE` เป็นเป้าหมายที่มีขอบเขตและมีเงื่อนไข จึงไม่ควรสมมติว่ามีบนทุกแพลตฟอร์ม โปรไฟล์ `BASIC_COMPLETE` และ `ADVANCED_TOTAL` ระบุขอบเขตที่ต่างกัน ให้ตรวจเป้าหมาย โปรไฟล์ และการรองรับแพลตฟอร์มจริงของแต่ละ build
ข้อมูลอ้างอิง (reference) ระบุไฟล์ โมดูล หรือทรัพยากร แต่ไม่ได้ให้สิทธิ์ในการรันสิ่งนั้นในตัวเอง เมื่อโปรแกรมใช้ไฟล์ ไลบรารีภายนอก native binding หรือทรัพยากรของระบบ ต้องกำหนดขอบเขตการอนุญาตและความรับผิดชอบในการทำงานให้ชัดเจน คำอธิบายในเอกสารเพียงอย่างเดียวไม่ใช่หลักฐานของการรับประกันความปลอดภัยขณะรันไทม์ ให้ตรวจ implementation และการทดสอบที่เกี่ยวข้อง
### ชนิดข้อมูลและแบบจำลองออบเจ็กต์
ชนิดข้อมูลหลักประกอบด้วย `int`, `double`, `boolean`, `String`, `void`, ชนิด `struct` ที่ประกาศเอง และลายเซ็นชนิดอ้างอิงที่รองรับ ตามเอกสารปัจจุบัน `int`, `long` และ `int64` เป็นจำนวนเต็มมีเครื่องหมาย 64 บิต ส่วน `int128` ยอมรับเป็นชนิดจำนวนเต็มได้ แต่ implementation ที่ระบุยังอิง 64 บิต จึงไม่ควรถือว่าเป็นเลขคณิต 128 บิตอย่างสมบูรณ์
`struct` คือ aggregate ที่มีฟิลด์ระบุชื่อ struct handle ที่ VM จัดการไม่ใช่พอยน์เตอร์ดิบที่เปิดเผยโดยตรง การกำหนดค่าและการส่งพารามิเตอร์ใช้อินสแตนซ์เดียวกัน และความเท่ากันอิงตัวตน (identity) สำหรับการแลกเปลี่ยนข้อมูลแบบพกพา ให้ใช้ตัวช่วยการทำซีเรียลไลซ์ที่ระบุ เช่น `structPack(instance)` และ `structUnpack(TypeName, json)`; handle ภายใน VM ไม่ใช่ข้อมูลเครือข่ายที่ส่งต่อได้โดยตรง
คลาสประกอบด้วยฟิลด์และเมธอด ในแบบจำลองการทำงานปัจจุบัน ฟิลด์เป็นสถานะคลาสที่ใช้ร่วมกัน ส่วนตัวแปรภายในเมธอดเป็นของแต่ละเธรด การสืบทอดคลาส คลาสซ้อน และ generics ขึ้นกับเกตเวอร์ชันไวยากรณ์ ดูรายละเอียดที่ [International Language Reference](../reference/LANGUAGE.INTERNATIONAL.3.0.md)
### Control flow และการกำหนดเวลาของลูป
ภาษามีไวยากรณ์สำหรับเงื่อนไข ลูป การเรียกเมธอด และการเรียกซ้ำ คำอธิบายประกอบ `@loopDelay` และ `@loopBudget` ใช้กำหนดเวลาหยุดหรืองบเวลาของลูป โดยเขียนไว้ก่อนลูป และจะถูกลดระดับเป็นคำสั่ง VM `OP_SLEEP` (ISA 157) ฟังก์ชันในตัว `sleep(ms)` ใช้คำสั่งเดียวกัน
```sleela
@loopDelay(ms = 250)
while (running) {
processNext();
}
```
ตัวอย่างนี้แสดงเฉพาะรูปแบบไวยากรณ์ โปรแกรมจริงต้องประกาศตัวระบุและคลาสที่ห่อหุ้มให้ครบ ดู [SLEELA.syntax §32](../../SLEELA.syntax) และ [Loop Timing API](../../api/sleela/3.0/LOOP_TIMING_API.md)
### ระดับความพร้อมของโมดูลไลบรารี
repository มีโมดูลที่มีระดับความพร้อมแตกต่างกัน การมีชื่อโมดูลในแค็ตตาล็อกไม่ได้แปลว่าพร้อมใช้ใน production ควรตรวจสอบ README ของโมดูล ความครอบคลุมของการทดสอบ ข้อจำกัดของแพลตฟอร์ม และเอกสารการตรวจสอบก่อนนำไปใช้ การกล่าวถึงฟิลด์ความไว้วางใจในเชิงฟิสิกส์ของ `lib/advantage` เป็นการเปรียบเทียบเชิงแบบจำลอง ไม่ใช่ข้ออ้างว่าเป็นกฎฟิสิกส์ ส่วน `sleela docs --generate [dir]` ของ `lib/sleeladoc` สร้างคลังข้อความสำหรับใช้งานแบบออฟไลน์
### การเชื่อมต่อ C/C++ และขอบเขตเนทีฟ
การเชื่อมต่อ C/C++ ต้องระบุ ABI, calling convention, ความเป็นเจ้าของหน่วยความจำ, data layout, การจัดการข้อผิดพลาด และ dependency ของแพลตฟอร์มอย่างชัดเจน ให้ถือโค้ดเนทีฟเป็นขอบเขตความเชื่อถือแยกต่างหาก ข้อมูลอ้างอิงหรือการประกาศระบุทรัพยากรได้ แต่ไม่ได้ให้สิทธิ์ในการรัน ดู[การ implement แบบเนทีฟ](../../impl/README.md) [เมทริกซ์แพลตฟอร์ม](../../docs/PLATFORM-SUPPORT.md) และ[มาตรฐานการเปรียบเทียบ](../../comparison/README.md) อย่าสมมติว่า dependency และคำสั่งเดียวกันใช้ได้เหมือนกันบน Linux, macOS และ Windows
### วงจรชีวิตของทรัพยากรและการแก้ปัญหา
ให้บันทึกความเป็นเจ้าของ อายุการใช้งาน และความรับผิดชอบด้านการซิงโครไนซ์ของทรัพยากรที่ใช้ร่วมกันระหว่างฟังก์ชันหรือเธรด แยกตัวแปรภายใน สถานะออบเจ็กต์ที่ใช้ร่วมกัน VM handle และข้อมูลที่ซีเรียลไลซ์ได้ออกจากกัน VM handle ภายในไม่ใช่รูปแบบไฟล์หรือข้อความเครือข่ายที่เสถียร ให้ใช้อินเทอร์เฟซซีเรียลไลซ์ที่โมดูลกำหนด และทดสอบค่าที่ไม่ถูกต้อง ขาดหาย และค่าที่ขอบเขต
เมื่อแก้ปัญหา ให้บันทึก commit ระบบปฏิบัติการ สถาปัตยกรรม และ toolchain build เป้าหมายที่เล็กที่สุดที่เกี่ยวข้องก่อน เก็บเอาต์พุตข้อผิดพลาดทั้งหมด แยกข้อผิดพลาดของคอมไพเลอร์ออกจากข้อผิดพลาดขณะรันไทม์ และสร้างตัวอย่างขั้นต่ำที่ทำซ้ำได้ การ build ที่สำเร็จไม่ได้พิสูจน์ว่าพฤติกรรมขณะรันไทม์ถูกต้อง
รายงานการตรวจสอบควรระบุ commit ที่แน่นอน ระบบปฏิบัติการ/สถาปัตยกรรม เวอร์ชันคอมไพเลอร์ คำสั่ง build/ทดสอบแบบเต็ม จำนวนการทดสอบที่ผ่าน/ล้มเหลว/ข้าม และข้อจำกัดที่ทราบ การทดสอบที่ข้ามหรือไม่ได้รันต้องไม่นับว่าผ่าน
### ข้อสังเกตเกี่ยวกับการอ้างอิงและที่อยู่
การอ้างถึงหัวข้อต่าง ๆ ใน README เช่น CSPML, Character, Governance, Synchro, SleelaUI และ United Nations อธิบายเนื้อหาของ repository และไม่ใช่การรับรองอย่างเป็นทางการจากหน่วยงานหรือสถาบันใด
การมีที่อยู่หรือรูปภาพในส่วน **Bitcoin Conjegeum** (XV) ไม่ใช่คำแนะนำทางการเงิน การยืนยันความเป็นเจ้าของ หรือคำสั่งให้โอนเงิน โปรดตรวจสอบข้อมูลโดยอิสระก่อนใช้
**สถานะการแปล:** หัวข้อ I–XIX ได้รับการแปลเป็นภาษาไทยแล้ว ตัวระบุเชิงเทคนิค คำสั่ง ตัวอย่างโค้ด ชื่อไฟล์ ลิงก์ และที่อยู่ยังคงเดิม แนะนำให้ผู้ใช้ภาษาไทยเป็นภาษาแม่ตรวจทานทางภาษาในขั้นสุดท้าย