Home /Modules/docs/README.CN.md

README.CN.md

docs/i18n/README.CN.md · 521 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 — 中国大陆(CN)

<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>

国际国别版(简体中文,中国大陆)。 本文件是面向中国大陆读者的国别版本,以简体中文提供 README 的第 I 至 XIX 节。技术标识符、命令、代码、文件名和链接均保持原样。

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 会自动指向该清单。

从干净的检出开始,最快的上手方式:

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 会构建每个产品(核心、虚拟机、编解码器、churn、杀毒软件等),并最后构建注册表并生成其基线表——因此构建完成的目录树开箱即带有可供审阅的注册表。主要目标:

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 指南和 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 编写的交互式二维 CAD 应用。同系列的 AutoCAD Renderer 是一次性把图纸方案转换为图形,而 Creator 允许您实时创建和修改二维 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. 近期新增——Pi 常量、Modium/Registry 启动、sleelactl Math 与 @native

本节记录 2026-11 期间的工作中新增的功能,最新的分组在前。所链接的源文件及其验证状态具有权威性;在进入 master 之前,处于评审中的更改不会被描述为已合并。

1 亿位 Pi 目录常量

仓库提供了经过验证的 π 的一亿位数值,位于 pi-generator/pi.100000000.digits(格式良好的十进制数,3.14159…),同时还有一个 57,344 位的数值 pi-generator/pi.57344.digits。两者均已独立验证确为真正的 π——参见 pi-generator/VERIFIED.md,其中记录了相关检查(教科书式前缀、小数位置 762 处的 Feynman 点、著名的第一百万位数字、与 lib/math/SLPiReference.sleela 的一致性,以及整个文件的数字频率分析),并附有一键复现脚本。

Modium™ / Registry™ 在子系统启动时加载 Pi 常量

在专用的子系统入口点——sleela registry 和 sleela modium(以及安装程序首次运行)上,Modium 和 Registry 子系统会加载大型 π 目录常量,而不是在每次 sleela run 时加载。在交互式终端上,它们会输出一行短暂的红色 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 方法注解用于请求对热点方法进行提前(AOT)原生编译。新的 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 单元渲染/安装。虚拟机拥有一个有界的原生模块句柄表,要求强制性的宿主授权,并对句柄进行代数(generation)检查。语法 3.0 现已新增 nativeOpen、nativeCall 和 nativeClose:仅追加的字节码分派跨越一个单独版本化的 null/bool/int64/double/UTF-8 ABI,而虚拟机持有的数组、结构体及其他复合值则留在解释器内部,并可使用同名字节码回退。插件可以选择性地接收一个带版本的宿主回调表,通过嵌套的虚拟机执行来调用确切的 SLeeLa 函数,同时具备挂起栈的 GC 根、显式的宿主回调名称允许列表,并拒绝递归的原生 API 调用。原生代码仍然是受信任的进程内代码,而不是沙箱。源码进程策略注解拥有带版本的模式,但尚未被解析/强制执行。详情、安全边界以及七个工作流的台账:Native Drive 和 pi-generator/AT-NATIVE.md。

XIX. 国际 README 版本

SLeeLa 为其国际版本涵盖的 50 个市场提供各国专属的 README 入口。每个国家有一个名为 README.<CC>.md 的文件;当涉及多种语言时,这些语言归并在该国的同一个文件中。

翻译政策: 这些文件是初步的本地化国别入口。其引言和语言标题已本地化,而完整的技术参考仍保留在英文规范版 README.md 中。在每一节都已翻译、技术标识符和链接均已核对,且该版本经过语言审校之前,不得将某个国别文件称为完整翻译。首轮的语言覆盖具有代表性,并不表示宪法承认的、地区性的、原住民的或手语等所有语言均已完整翻译。

附录——保留的地区性指引

以下内容来自原有的简体中文简明指南,规范版 README 中没有对应章节;保留于此,供中国大陆读者参考。若与英文规范版 README 有出入,以规范版 README 为准。

编译目标、配置档案与执行边界

SLeeLa 将源代码与 build/execution targets 区分开来。已记录的目标系列包括 SLVM、SLJVM 和 SLIR;NATIVE 是受限制且有条件的目标,不应假设所有平台均可使用。BASIC_COMPLETE 与 ADVANCED_TOTAL 表示不同的 profile scope。每次构建都应确认实际 target、profile 和平台支持情况。

Reference 用于识别文件、模块或资源,本身并不授予执行权限。程序使用文件、外部库、native bindings 或系统资源时,必须明确权限边界和执行责任。文档中的功能描述不能单独证明 runtime security guarantee;应结合实现代码和相应测试进行判断。

资源生命周期、错误处理与调试

对跨函数或线程共享的资源,应记录 ownership、lifetime 和 synchronization responsibilities。区分 local variables、shared object state、VM handles 与 serializable data。VM-local handle 不是稳定的文件格式或网络消息。使用模块定义的 serialization interface,并测试 invalid、missing 和 boundary values。

调试时记录 commit、操作系统、架构和 toolchain。先构建最小相关 target,再运行相应测试;保留完整错误输出,区分 compiler errors 与 runtime errors,并尽可能建立最小可复现案例。Build 成功并不意味着 runtime behavior 已正确。

验证报告应列出 exact commit、OS/architecture、compiler versions、完整 build/test commands、pass/fail/skip 数量及已知限制。Skipped 或未执行的 tests 不得计为 passed。

跨平台与国际文档维护

不同操作系统的编译器、系统依赖、窗口后端、文件路径和安装权限可能不同。不要将 Linux 命令直接视为 Windows 或 macOS 的通用步骤。请结合平台支持矩阵与安装指南,记录实际测试的平台和工具链。

国别 README 是不同地区用户的技术文档入口,不取代规范性的语言规范或模块 API 文档。英文源文档更新后,应逐项检查翻译是否过时。技术标识符、命令、路径和代码示例应保持不变;尚未完成语言或技术审校的内容应明确标注。

模块 API 契约、兼容性与测试策略

引入新 API 时,应记录输入、输出、错误条件、数据所有权,以及操作是否产生 side effects。文档示例应同时展示正常用法和 invalid/missing input 的处理。未经实现和测试验证的行为,不应写成保证。

测试应按编译器流水线分层:lexing/parsing、semantic analysis、IR lowering、code generation、VM execution 和 native integration。每个 regression case 都应保留最小可复现输入、预期结果与实际结果。API 变更必须说明向后兼容性、迁移步骤,以及对现有示例的影响。

本地化、字符编码与可读性

不同语言版本中的技术标识符、命令、路径、语法和代码块必须保持一致。翻译说明文字,不要翻译源代码所使用的 token 或名称。应明确语言和地区语境;简体中文术语应保持一致,同时避免把地区性用语误写成所有中文用户的统一表达。

每次更新后检查 Markdown 链接、标题层级、代码围栏和示例。英文规范文档更新时,应逐节比对并同步翻译,而不是只更新简介。未经母语者或技术审校的内容应明确标注。

翻译状态: 第 I 至 XIX 节已翻译为简体中文(中国大陆);技术标识符、命令、代码示例、文件名、链接和地址均保持原样。建议在发布前由母语者进行最终的语言审校,并与英文规范版 README 的后续变更逐项核对。