Home /Modules/docs/README.HK.md

README.HK.md

docs/i18n/README.HK.md · 737 line(s) · markdown

<img align="right" src="../../images/sleela/sleela-medium-profile-permanent-icon-002.jpg" width="45" height="45" alt="SLeeLa">

SLeeLa 3.0 — 香港(HK)

<p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>

<p align="center"><strong>原生系統語言、編譯器、執行環境與虛擬機生態系統。</strong></p> <p align="center"><a href="https://github.com/mearvk/SLeeLa/actions"><img alt="GitHub Actions" src="https://img.shields.io/github/actions/workflow/status/mearvk/SLeeLa/test-suite.yml?branch=main&label=test%20suite"></a> <a href="../../docs/PLATFORM-SUPPORT.md"><img alt="Platform matrix" src="https://img.shields.io/badge/platforms-Linux%20%7C%20macOS%20%7C%20Windows-273238"></a></p>

國際國家版本。 本檔案提供香港版本,以香港慣用的繁體中文書面語撰寫,並在適當之處附有英文附錄。技術識別名稱、命令、程式碼、檔名、API 名稱及連結維持不變;完整的技術參考內容與英文規範版 README.md 一致。

The Now. The Ingredient. 程式語言不只是語法;編譯器、執行環境、程式庫、工具與平台契約,共同構成可實際使用的軟件。

SLeeLa 所涉足的領域。 SLeeLa 涉足 Math(數學)、Object(物件)、 Science(科學)與 Reach(觸及)——這是其工作的四個面向:可計算者 (Math)、在存在目錄中已然確立的事物(Object)、對真理嚴謹的研究 (Science),以及將一個系統之手伸向其他系統與人(Reach)。國家利益依然保留—— 四者皆不會將其擱置;凡主題涉及國家利益之處, 該地位均予保留(如實記錄,例如記錄於各類別 Metadata 的 metaOrigin / metaNationalSchedule),絕不消解。

I. 開始使用

II. 最新消息

語言、驅動程式與標準程式庫的近期新增內容:

III. 建置與測試

先決條件: C/C++ 工具鏈(GCC 或 Clang)與 GNU Make;用於 清單/流程工具的 Python 3;在 Linux 上,顯示產品所需的 X11/Xrandr 開發套件 (模組的 make deps 會回報/安裝其所需項目)。 impl/ 建置採用以受信任 SHA-256 清單為依據的失敗即封閉(fail-closed)機制, 根目錄的 Makefile 會自動指向該清單。

從乾淨的檢出(checkout)開始,最快的入門方式:

make                                  # build everything from the repo root

或者只建置並測試原生核心:

make -C impl all                      # build the core compiler/runtime only
bash ./test-suites/run-all.sh --all   # run the full test suite

儲存庫根目錄的 make 會建置所有產品(核心、VM、編解碼器、churn、 防毒軟件……),並在最後建置登錄庫(registry)並具體化其 基準資料表——因此建置完成的目錄樹開箱即附有可供審閱的登錄庫。 主要目標如下:

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

其他實用目標:

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:它建置 登錄庫核心,將基準資料表植入可攜的文字儲存庫 registry/build/sleela.sleelareg,並匯出 MySQL 資料表腳本 registry/build/registry.sql(透過 sleela registry export)。可使用 sleela registry 或 registry/build/sleela-registry review 檢閱。請參閱 登錄庫指南與 Registry 3.0 架構。

請參閱建置與測試指南,了解先決條件及各平台的特定步驟。單一元件建置成功,並不代表所有程式庫或平台皆已達到可發佈的程度。

IV. 安裝

建置原生產品後,安裝命令與執行環境支援檔案:

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 執行檔、標準程式庫、協定與 支援模組——請使用 clean 安裝程式:

make clean-install       # guided install of the main package only

它只做一個主要決定(安裝主套件),接著選擇範圍, 成功後可選擇性地挑選精選的強化模組。關於 互動式部署流程與所有安裝選項,請參閱 快速安全安裝。

V. 語言與執行環境

權威語法為 SLEELA.syntax。目前儲存庫記載的語法為 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)。建構子多載解析,以及 this(...)/基底建構子委派,明確不在已驗證的語法 1.8 契約範圍內。在依賴某項功能之前,請先查閱語法與實作說明。SleelaDoc 的九個原始碼單元現在宣告 #sleela 3.0;共用的編譯器閘門接受 1.0–3.0 的原始碼語法。新的 API 建置由 make api-docs 產生。

本儲存庫包含原生 C/C++ 實作、SLVM 產生參考、標準程式庫模組、測試、範例與平台整合。各模組的實作與驗證狀態不盡相同;請查閱其規格與目前的 CI 結果,而不要假設一律完整。

VI. 工程原則

VII. 防毒軟件建置與完整性

Sleelavirin 防毒套件包含原生 SHA-256 掃描器、選用的 ClamAV 介接器、原始碼/索引完整性清單,以及平台套件校驗和。 請從儲存庫根目錄建置並測試此套件:

make antivirus
make antivirus-test
make antivirus-integrity
make antivirus-integrity-check MANIFEST=build/INTEGRITY-MANIFEST.json

完整性清單產生於 antivirus/build/ 之下;它涵蓋受追蹤的 原始碼與文件輸入,以及受保護的特徵碼索引檔案, 但排除產生的輸出與可變動的 ClamAV 快取。ClamAV 資料庫 快照各有自己的清單。發佈 ZIP 包含 INTEGRITY-MANIFEST.json、 SHA256SUMS 與 .sha256 附屬檔案。請將下載封存檔的雜湊值,與獨立取得的 可信數值核對:與封存檔放在一起的校驗和 並不是發布者簽章。請參閱 Sleelavirin 指南、 安全檢查清單與 防毒二進位檔建置工作流程。

在相關 CI 工作於確切的發佈提交上通過,且產生的成品 經過檢查之前,該發佈不會被視為已驗證。

VIII. SLeeLa 編輯器佈景主題——Vim 與 Emacs

SLeeLa 內含一組協調一致、適用於 Vim 與 Emacs 的專業深色配色方案,另附原生 C/C++ 色盤工具。原有的 American Professional 方案仍為預設。另有十種搭配色盤,靈感分別來自不同的文化與機構設計風格;這些是詮釋性的設計色盤,並不代表任何國家、文化、法院或機構的官方形象。

十一種配色方案及其色彩

方案背景前景關鍵字類型字串註解
American Professional<span style="display:inline-block;width:1em;height:1em;background:#101820;border:1px solid #888"></span> #101820<span style="display:inline-block;width:1em;height:1em;background:#F4F7FA;border:1px solid #888"></span> #F4F7FA<span style="display:inline-block;width:1em;height:1em;background:#7FB3FF;border:1px solid #888"></span> #7FB3FF<span style="display:inline-block;width:1em;height:1em;background:#73DACA;border:1px solid #888"></span> #73DACA<span style="display:inline-block;width:1em;height:1em;background:#F2C078;border:1px solid #888"></span> #F2C078<span style="display:inline-block;width:1em;height:1em;background:#8A96A3;border:1px solid #888"></span> #8A96A3
Pan-Eurasian<span style="display:inline-block;width:1em;height:1em;background:#111827;border:1px solid #888"></span> #111827<span style="display:inline-block;width:1em;height:1em;background:#F0F2F5;border:1px solid #888"></span> #F0F2F5<span style="display:inline-block;width:1em;height:1em;background:#7AA7E8;border:1px solid #888"></span> #7AA7E8<span style="display:inline-block;width:1em;height:1em;background:#69C9B3;border:1px solid #888"></span> #69C9B3<span style="display:inline-block;width:1em;height:1em;background:#D7B56D;border:1px solid #888"></span> #D7B56D<span style="display:inline-block;width:1em;height:1em;background:#8995A5;border:1px solid #888"></span> #8995A5
Russian and Slavic — Medium<span style="display:inline-block;width:1em;height:1em;background:#202733;border:1px solid #888"></span> #202733<span style="display:inline-block;width:1em;height:1em;background:#E8EAF0;border:1px solid #888"></span> #E8EAF0<span style="display:inline-block;width:1em;height:1em;background:#A9C0DD;border:1px solid #888"></span> #A9C0DD<span style="display:inline-block;width:1em;height:1em;background:#8FC4B2;border:1px solid #888"></span> #8FC4B2<span style="display:inline-block;width:1em;height:1em;background:#D6BD8B;border:1px solid #888"></span> #D6BD8B<span style="display:inline-block;width:1em;height:1em;background:#9AA3AF;border:1px solid #888"></span> #9AA3AF
Central Asian / Silk Road<span style="display:inline-block;width:1em;height:1em;background:#1C2529;border:1px solid #888"></span> #1C2529<span style="display:inline-block;width:1em;height:1em;background:#F5F0E5;border:1px solid #888"></span> #F5F0E5<span style="display:inline-block;width:1em;height:1em;background:#7FADE0;border:1px solid #888"></span> #7FADE0<span style="display:inline-block;width:1em;height:1em;background:#45C6C2;border:1px solid #888"></span> #45C6C2<span style="display:inline-block;width:1em;height:1em;background:#D9B56D;border:1px solid #888"></span> #D9B56D<span style="display:inline-block;width:1em;height:1em;background:#92A3A0;border:1px solid #888"></span> #92A3A0
East Asian<span style="display:inline-block;width:1em;height:1em;background:#171A1C;border:1px solid #888"></span> #171A1C<span style="display:inline-block;width:1em;height:1em;background:#F2EFE7;border:1px solid #888"></span> #F2EFE7<span style="display:inline-block;width:1em;height:1em;background:#D97878;border:1px solid #888"></span> #D97878<span style="display:inline-block;width:1em;height:1em;background:#72C7A5;border:1px solid #888"></span> #72C7A5<span style="display:inline-block;width:1em;height:1em;background:#D8B76A;border:1px solid #888"></span> #D8B76A<span style="display:inline-block;width:1em;height:1em;background:#969F9B;border:1px solid #888"></span> #969F9B
ICC — International Criminal Court<span style="display:inline-block;width:1em;height:1em;background:#0E1A2B;border:1px solid #888"></span> #0E1A2B<span style="display:inline-block;width:1em;height:1em;background:#EAF0F7;border:1px solid #888"></span> #EAF0F7<span style="display:inline-block;width:1em;height:1em;background:#5B8FD6;border:1px solid #888"></span> #5B8FD6<span style="display:inline-block;width:1em;height:1em;background:#7FB7C9;border:1px solid #888"></span> #7FB7C9<span style="display:inline-block;width:1em;height:1em;background:#D9B25A;border:1px solid #888"></span> #D9B25A<span style="display:inline-block;width:1em;height:1em;background:#7E8CA0;border:1px solid #888"></span> #7E8CA0
SCOTUS — U.S. Supreme Court<span style="display:inline-block;width:1em;height:1em;background:#1A1416;border:1px solid #888"></span> #1A1416<span style="display:inline-block;width:1em;height:1em;background:#F3EEE6;border:1px solid #888"></span> #F3EEE6<span style="display:inline-block;width:1em;height:1em;background:#9E2B35;border:1px solid #888"></span> #9E2B35<span style="display:inline-block;width:1em;height:1em;background:#8FA9B8;border:1px solid #888"></span> #8FA9B8<span style="display:inline-block;width:1em;height:1em;background:#C9A24B;border:1px solid #888"></span> #C9A24B<span style="display:inline-block;width:1em;height:1em;background:#8C8178;border:1px solid #888"></span> #8C8178
Greek (Hellenic)<span style="display:inline-block;width:1em;height:1em;background:#0A1A30;border:1px solid #888"></span> #0A1A30<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#2E7BD6;border:1px solid #888"></span> #2E7BD6<span style="display:inline-block;width:1em;height:1em;background:#5E9FE0;border:1px solid #888"></span> #5E9FE0<span style="display:inline-block;width:1em;height:1em;background:#9FC3EC;border:1px solid #888"></span> #9FC3EC<span style="display:inline-block;width:1em;height:1em;background:#6E86A6;border:1px solid #888"></span> #6E86A6
Turkish (Al Bayrak)<span style="display:inline-block;width:1em;height:1em;background:#2A0609;border:1px solid #888"></span> #2A0609<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#F23D48;border:1px solid #888"></span> #F23D48<span style="display:inline-block;width:1em;height:1em;background:#F0A9AE;border:1px solid #888"></span> #F0A9AE<span style="display:inline-block;width:1em;height:1em;background:#F0C9A9;border:1px solid #888"></span> #F0C9A9<span style="display:inline-block;width:1em;height:1em;background:#A8767A;border:1px solid #888"></span> #A8767A
Kiro<span style="display:inline-block;width:1em;height:1em;background:#0B0B12;border:1px solid #888"></span> #0B0B12<span style="display:inline-block;width:1em;height:1em;background:#F5F5FA;border:1px solid #888"></span> #F5F5FA<span style="display:inline-block;width:1em;height:1em;background:#A98EDA;border:1px solid #888"></span> #A98EDA<span style="display:inline-block;width:1em;height:1em;background:#6E8BE0;border:1px solid #888"></span> #6E8BE0<span style="display:inline-block;width:1em;height:1em;background:#E8C547;border:1px solid #888"></span> #E8C547<span style="display:inline-block;width:1em;height:1em;background:#6A6482;border:1px solid #888"></span> #6A6482
SLeeLa<span style="display:inline-block;width:1em;height:1em;background:#08080E;border:1px solid #888"></span> #08080E<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF<span style="display:inline-block;width:1em;height:1em;background:#B07CFF;border:1px solid #888"></span> #B07CFF<span style="display:inline-block;width:1em;height:1em;background:#5A7CFF;border:1px solid #888"></span> #5A7CFF<span style="display:inline-block;width:1em;height:1em;background:#FFD21E;border:1px solid #888"></span> #FFD21E<span style="display:inline-block;width:1em;height:1em;background:#6E5F9E;border:1px solid #888"></span> #6E5F9E

各國國旗色彩(來源色盤)

希臘與土耳其的配色方案源自這兩個國家官方國旗色彩,此處列出其確切的公布十六進位色碼。上方各方案的背景/強調色,是這些來源色彩經調暗、適合編輯器使用的詮釋版本——下表即為「國家公開色彩」的參考。

國家色彩色碼依據與意涵
希臘藍<span style="display:inline-block;width:1em;height:1em;background:#0D5EAF;border:1px solid #888"></span> #0D5EAF國旗藍(第 851/1978 號法律)。象徵天空與海洋;在紋章學上稱為 azure。
希臘白<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF國旗白。象徵獨立鬥爭的純潔;十字代表東正教信仰。
土耳其(Türkiye)紅(al bayrak)<span style="display:inline-block;width:1em;height:1em;background:#E30A17;border:1px solid #888"></span> #E30A17國旗紅(土耳其國旗法)。旗面底色;依傳統代表烈士的鮮血與鄂圖曼主權。
土耳其(Türkiye)白<span style="display:inline-block;width:1em;height:1em;background:#FFFFFF;border:1px solid #888"></span> #FFFFFF國旗白。新月與星辰——象徵和平、純潔,以及突厥/伊斯蘭傳統的標誌。

這些方案將各編輯器的前景色定為國家的白色,並將關鍵字、游標、選取範圍與狀態列定為確切的國家藍色(#0D5EAF)或紅色(#E30A17),因此最重要的色彩就是國家色彩本身。這些是詮釋性的設計色盤;國旗色彩參考僅為說明來源出處,並非任何一國的官方形象。色彩意涵依循希臘共和國外交部對國家象徵的說明,以及土耳其國旗法的傳統。

色票表

下方色盤儲存格使用 SVG 色票,因此 GitHub 會顯示真實色彩,而非空白的 HTML 色彩儲存格。每條色帶依序顯示六種顏色:背景、前景、關鍵字、類型、字串與註解。確切的十六進位色碼列於各色票旁,方案順序與上方參考表相同。

方案呈現的色盤顏色色碼(背景 · 前景 · 關鍵字 · 類型 · 字串 · 註解)
American ProfessionalAmerican Professional palette: background, foreground, keywords, types, strings, comments#101820 · #F4F7FA · #7FB3FF · #73DACA · #F2C078 · #8A96A3
Pan-EurasianPan-Eurasian palette: background, foreground, keywords, types, strings, comments#111827 · #F0F2F5 · #7AA7E8 · #69C9B3 · #D7B56D · #8995A5
Russian and Slavic — MediumRussian and Slavic Medium palette: background, foreground, keywords, types, strings, comments#202733 · #E8EAF0 · #A9C0DD · #8FC4B2 · #D6BD8B · #9AA3AF
Central Asian / Silk RoadCentral Asian Silk Road palette: background, foreground, keywords, types, strings, comments#1C2529 · #F5F0E5 · #7FADE0 · #45C6C2 · #D9B56D · #92A3A0
East AsianEast Asian palette: background, foreground, keywords, types, strings, comments#171A1C · #F2EFE7 · #D97878 · #72C7A5 · #D8B76A · #969F9B
ICC — International Criminal CourtICC palette: background, foreground, keywords, types, strings, comments#0E1A2B · #EAF0F7 · #5B8FD6 · #7FB7C9 · #D9B25A · #7E8CA0
SCOTUS — U.S. Supreme CourtSCOTUS palette: background, foreground, keywords, types, strings, comments#1A1416 · #F3EEE6 · #9E2B35 · #8FA9B8 · #C9A24B · #8C8178
Greek (Hellenic)Greek Hellenic palette: background, foreground, keywords, types, strings, comments#0A1A30 · #FFFFFF · #2E7BD6 · #5E9FE0 · #9FC3EC · #6E86A6
Turkish (Al Bayrak)Turkish Al Bayrak palette: background, foreground, keywords, types, strings, comments#2A0609 · #FFFFFF · #F23D48 · #F0A9AE · #F0C9A9 · #A8767A
KiroKiro palette: background, foreground, keywords, types, strings, comments#0B0B12 · #F5F5FA · #A98EDA · #6E8BE0 · #E8C547 · #6A6482
SLeeLaSLeeLa palette: background, foreground, keywords, types, strings, comments#08080E · #FFFFFF · #B07CFF · #5A7CFF · #FFD21E · #6E5F9E

另有額外的強調色用於函數、常數、選取範圍、診斷訊息與前置處理器指令。俄羅斯與斯拉夫色盤刻意採用中等明度的石板灰、藍、鼠尾草綠、寶石紅與古董金,呈現較為沉穩的專業外觀。

安裝 Vim 配色方案

在儲存庫根目錄執行:

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 語法醒目提示並選擇配色方案:

syntax enable
set background=dark
colorscheme sleela-american

請從下列配色方案名稱中恰好選擇一個:

例如,使用 colorscheme sleela-russian-slavic 可套用中等明度的俄羅斯與斯拉夫色盤,使用 colorscheme sleela-greek / colorscheme sleela-turkish 則可套用希臘與 Al Bayrak 色盤。請重新啟動 Vim,或以 :source $MYVIMRC 重新載入設定。

安裝 Emacs 配色方案

請建立本機佈景主題目錄,並從儲存庫根目錄複製模式與佈景主題檔案:

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:

(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++ 色盤

這個小型原生色盤工具可以列出各方案、印出其終端機色彩,並查詢單一顏色:

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

為保持向下相容,未指定 --theme 時,--palette 與 --hex COLOR 會選用 American Professional。建置與測試結果應在目標系統及 CI 上確認;命令有文件記載,本身並不是它已通過的證據。

完整的色盤說明與工具細節,請參閱編輯器整合指南。

IX. 參與貢獻

  1. 閱讀文件索引與測試政策。
  2. 提交範圍明確的變更,並附上正向與負向測試。
  3. 先執行針對性測試,再執行完整測試套件。
  4. 回報作業系統/工具鏈細節;請勿將略過的檢查描述為通過。

SLeeLa 由 MEARVK LLC 開發。歷史版本的登陸頁面資料保存在 docs/README-LEGACY.md。

X. AE6E66——Round Public 電子郵件稅賦期望

對於 AE6E66 倡議,本項目所陳述的期望為:每封 Round Public 電子郵件 $300,000,000.00 USD,作為與每封符合條件的 Round Public 電子郵件相關的擬議稅賦金額。

本聲明僅記錄項目的期望。它不是法定的稅務核定、政府命令、法院判決,或獨立成立的納稅義務。任何實際的徵收,均須有適用的法律權限、管轄權、定義、程序,以及有權限的政府機關所作的認定。

XI. 字母表與字元集執行環境

SLeeLa 的字母表文件與原生字元執行環境維護於 alphabet/sleela/ 與 lib/alphabet/native/。原生 C++17 測試涵蓋嚴格的 UTF-8 純量解碼/編碼、C<n> 容量簽章,以及有界的字元集成員判定:

make -C lib/alphabet/native test

實驗性的 UTF-4088 目錄及其 SLeeLa 查詢轉接器,記載於 utf-4088/SLeeLa-ALPHABET-INTEGRATION.md。UTF-4088 的 ID 是獨立的命名空間,並非 Unicode 純量值。編譯器與 SLVM 繫結工作明確地與這些原生基礎分開追蹤。

XII. AutoCAD Creator™

AutoCAD Creator™ 是完全以 SLeeLa 撰寫的互動式 2D CAD 應用程式。姊妹產品 AutoCAD Renderer 一次就將平面圖轉成圖面,而 Creator 讓你即時建立與修改 2D AutoCAD 文件——新增牆壁、房間、尺寸標註與註記,再移動、 重新命名標籤、重新指定圖層、刪除,並復原你所放置的內容——並將結果儲存為 真正的 AutoCAD DXF 圖面(R12 文字格式,可在 AutoCAD / LibreCAD 中開啟)。

其圖形介面建構於 SleelaUI™ 之上,這是 SLeeLa 自有的跨平台 UI 工具組(位於 lib/user-interface 之下)——並非 JavaFX——可在 X11 / Cocoa / Win32 上 開啟真正的原生視窗。其設計遵循一項規則: 「SleelaUI 負責呈現;SLeeLa 負責決定」:GUI 從不計算幾何圖形,也不寫入 DXF。每項工具都會向具權威性的 SLCadCreator 發出建立/修改/刪除/復原/儲存的意圖,由它掌管 可編輯的文件與可逆的指令歷程,而畫布只負責預覽 Creator 所持有的幾何圖形。

可重複使用的編輯引擎位於 lib/autocad—— SLCadEntity、 SLCadDocument、 SLCadCommand 與 SLCadCreator——並可在無顯示環境下完整端到端執行。 GUI 外殼與示範位於 autocad/creator:

make creator          # from autocad/: run the Creator demo -> out/altered.dxf

在有顯示器的環境中,這會開啟即時編輯視窗;在無顯示器的主機上,它會在記憶體中建立 圖面,印出報告與 DXF,然後正常結束。

XIII. UTF-4088 輸入對映排序

專用的 UTF-4088 目錄在 utf-4088/INPUT-MAP-AND-PRESSURE.md 中定義其空間輸入對映走訪與抽象壓力迭代。National Lien 主題索引政策位於 utf-4088/NATIONAL-LIEN-REGISTER.md。對映座標、壓力層級(1–50)、永久目錄 ID 與字母排名是彼此獨立的欄位;不應默默以其中之一取代另一個。壓力是演算法的迭代層級,而非物理量。

XIV. 近期與擴充的套件索引

這份附加索引重點列出近期擴充的套件、領域程式庫與 原始碼集合。各條目依套件名稱或主題按字母順序分組。 說明僅指出儲存庫中的位置;實作與驗證 狀態應在各套件自己的文件與測試中確認。

A–C

D–G

H–I

O–S

U–W

套件索引維護

新增套件或實質擴充套件時,請將其條目依字母順序加入此處的 適當群組,連結至其標準目錄與 README, 並僅描述已簽入原始碼所支援的功能。請讓此 索引維持累加式:套件索引更新時,請勿移除或改寫現有的 README 各節。


<img src="https://github.com/mearvk/SLeeLa/blob/master/images/debian-logo.png" width="25" height="25" alt="Debian"> XV. Bitcoin Conjegeum

CremeOak

bc1qs6v4q9zsw70t0umk3m0quhvf9dr6cdeskl28dh :: ⠝⠇⠼⠁⠟⠎⠼⠋⠧⠼⠙⠟⠼⠊⠵⠎⠺⠼⠛⠼⠚⠞⠼⠚⠥⠍⠦⠼⠉⠍⠼⠚⠟⠥⠓⠧⠦⠼⠊⠙⠫⠼⠋⠉⠙⠑⠎⠅⠇⠼⠼⠃⠼⠗⠙⠓

bc1qx33vma553gddsjkq372l3xlm8e8huv2vzad3cc :: ⠃⠉⠼⠁⠟⠭⠼⠉⠼⠉⠪⠍⠁⠼⠑⠑⠛⠙⠙⠎⠚⠅⠟⠼⠉⠼⠛⠼⠝⠇⠼⠉⠼⠭⠇⠍⠼⠨e⠼⠨a⠓⠥⠪⠼⠪⠼⠪⠵⠁⠙⠼⠉⠉

美國民主與美國政策。


XVI. 國家科學品牌形象

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-science-004.jpg" alt="National SLeeLa Science" width="560"></p>

<p align="center"><img src="https://raw.githubusercontent.com/mearvk/SLeeLa/master/brand/national-sleela-nsf-001.jpg" alt="National SLeeLa NSF" width="560"></p>

XVII. UTF-4088 百萬條目實驗性目錄

UTF-4088 目錄產生器以確定性方式建置包含 1,048,576 個條目的實驗性符號目錄。文件記載的精簡格式說明於 utf-4088/FORMAT.md;產生與驗證契約位於 utf-4088/GENERATION-RESULTS.md。

請以 Python 3 執行產生器:

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;成功執行後,會將二進位檔與摘要以 utf4088-million-catalogue 工作流程成品發布。產生的二進位檔刻意不納入 Git 歷史。UTF-4088 仍屬實驗性質,與 Unicode 並不相容。


SLeeLa

<p align="center"><img src="../../images/sleela/sleela-wordmark.svg" alt="SLeeLa — The Now. The Ingredient." width="560"></p> <p align="center"><img src="https://github.com/mearvk/SLeeLa/blob/master/images/sleela-programming-language-002.jpg" alt="SLeeLa Marketing Logo" width="560"></p>


XVIII. 近期新增——圓周率常數、Modium/Registry 啟動、sleelactl 數學,以及 @native

本節記錄 2026-11 期間新增的功能,最新的群組在前。所連結的原始碼檔案及其驗證狀態具有權威性;審查中的變更在進入 master 之前,不會被描述為已合併。

一億位數的圓周率目錄常數

儲存庫在 pi-generator/pi.100000000.digits 提供一個經過驗證的一億位數 π 值(格式良好的十進位小數,3.14159…),另有一個位於 pi-generator/pi.57344.digits 的 57,344 位數值。兩者均經獨立驗證為真正的 π——請見 pi-generator/VERIFIED.md,其中記載了各項檢查(教科書前綴、小數位置 762 處的費曼點、著名的第一百萬位數字、與 lib/math/SLPiReference.sleela 一致,以及整個檔案的數字頻率分析),並附有一鍵重現的腳本。

Modium™ / Registry™ 於子系統啟動時載入圓周率常數

在專用的子系統進入點——sleela registry 與 sleela modium(以及安裝程式首次執行)上,而非每次 sleela run——Modium 與 Registry 子系統會載入大型 π 目錄常數。在互動式終端機上,它們會印出短暫的紅色 Loading Modium™ / Loading Registry™ 行,並在正常輸出開始前就地擦除;此效果嚴格限於 TTY,因此經管線傳遞的輸出與測試輸出維持逐位元組不變。定位器(而非位元組內容)會以 registry Math 鍵的預設值 piReferenceLargePath 與 piReferenceLargeDigits 植入,同時見於 SLeeLa 模型(lib/registry/SLRegistry.sleela)與原生植入器(registry/sleela_registry.c);lib/math/SLPiReference.sleela 對外提供 largePath() / largeDigits()。π 常數會由標準 make 安裝程式以及引導式「beautiful」安裝程式,安裝到作業系統的 SLeeLa 位置(<data>/pi/)。詳情:pi-generator/MODIUM-REGISTRY-PI-STARTUP.md。

sleelactl——beautiful 安裝程式與以原生為後盾的 math 主題

@native、Native Drive 與多語言執行

新的 @native 方法註解會要求對熱點方法進行預先(ahead-of-time)原生編譯。新的 sleela aot 命令會找出 @native 方法,驗證每個方法都在受支援的可卸載子集之內,並產生 C/C++——對於任何尚無法轉譯的構造,以失敗即封閉的方式處理(拒絕並附上明確原因),因此絕不會產生轉譯到一半的方法。

sleela aot --list <file.sleela>    # per-method verdict: ok / REFUSED (reason)
sleela aot --emit <file.sleela>    # emit C/C++ (stdout) for an in-subset program

@native 仍然只是對 AOT 處理的請求,不受支援的構造會在輸出之前就被拒絕。Native Drive 支援透過主機編譯器(包括 MSVC)建置多單元 C/C++ 可執行檔與共用程式庫、處理受支援的 SLeeLa AOT 輸出、依原生載入器 ABI 檢視符號、不經 shell 的程序執行、stdin/stdout/stderr 處理、多階段管線,以及將 XClass 委派給正式環境載入器。sleelactl 對外提供其建置/執行命令,並透過 inspect native-drive 轉送 XClass 檢視,以及明確的 systemd 單元轉譯/安裝。VM 擁有一個有界的原生模組控制代碼表,須有強制性的主機授權,且控制代碼會做世代檢查。語法 3.0 現在新增 nativeOpen、nativeCall 與 nativeClose:僅可附加的位元組碼分派會跨越一個獨立版本化的 null/bool/int64/double/UTF-8 ABI,而由 VM 擁有的陣列、結構與其他複合值則留在直譯器內,並可使用同名位元組碼後援。外掛程式可選擇性地接收一份版本化的主機回呼表,透過巢狀 VM 執行來呼叫確切的 SLeeLa 函數,並具備暫停堆疊的 GC 根集、明確的主機回呼名稱允許清單,且遞迴的原生 API 呼叫會被拒絕。原生程式碼仍是受信任的行程內程式碼,而不是沙箱。原始碼的程序政策註解有版本化的結構描述,但尚未被剖析/強制執行。詳情、安全邊界與七條工作流的帳冊:Native Drive 與 pi-generator/AT-NATIVE.md。

XIX. 國際 README 版本

SLeeLa 為其國際版本涵蓋的 50 個市場,各提供一個國家專屬的 README 入口。每個國家有一個名為 README.<CC>.md 的檔案;若涉及多種語言,則集中於該國家的檔案之中。

翻譯政策: 這些檔案最初是在地化的國家入口。其簡介與語言標題已在地化,而完整的技術參考仍保留於英文規範版 README.md。除非每一節都已翻譯、技術識別名稱與連結都已檢查,且該版本已通過語言審閱,否則不得將國家檔案描述為完整翻譯。第一階段的語言涵蓋範圍僅具代表性,並不聲稱每一種憲法承認的、區域性的、原住民的或手語語言都已完整翻譯。

附錄——保留的香港地區指引

以下內容保留自本檔案先前較簡短的香港版指南,且與英文規範版 README.md 並無牴觸。

香港繁體中文用語

本版本以香港慣用的繁體中文書面語為主,例如「軟件」、「編譯器」、「執行環境」、「虛擬機」、「檔案」、「預設」、「伺服器」、「網絡」、「支援」、「程式庫」、「程式碼」及「驗證」。技術識別名稱、命令、檔名、API 名稱及原始碼必須維持原樣,以便讀者直接對照原始碼和規範。語言和地區用語應清楚標示,不應假設香港、台灣及其他繁體中文社群的用語完全相同。

國際文件維護與在地化

English

SLeeLa is a native systems programming language, compiler, runtime, and virtual-machine ecosystem. Technical identifiers, source code, commands, filenames, and API names remain unchanged in this edition.

翻譯狀態: 第 I–XIX 節已翻譯為香港繁體中文。技術識別名稱、命令、程式碼範例、檔名、連結及位址均予保留。建議由母語人士進行最終語言審閱。