Merge commit 'ac794a6a7051497ff60b947642d44f0f8c04d6c6' into lsp-server

2026-01-08 15:56:37 +08:00
parent f056b0cad1 ac794a6a70
commit 488785f08f
113 changed files with 254751 additions and 176 deletions
@@ -4,7 +4,10 @@

 ## 1. 总体要求

- 对 `.tsl`/`.tsf` 文件一律按 TSL 规范处理（`.tsf` 也是 TSL 源文件）：遵守标准快照中的 `docs/tsl/code_style.md` 与 `docs/tsl/naming.md`（在目标项目中通常 vendoring 到 `docs/standards/playbook/docs/tsl/`）。
+- 对 `.tsl`/`.tsf` 文件一律按 TSL 规范处理（`.tsf`
+  也是 TSL 源文件）：遵守标准快照中的 `docs/tsl/code_style.md` 与
+  `docs/tsl/naming.md`（在目标项目中通常 vendoring 到
+  `docs/standards/playbook/docs/tsl/`）。
 - 改动聚焦目标；避免“顺手重构”。
 - API 变更要显式说明影响与迁移方式。

@@ -25,10 +25,19 @@

 ## TSL/TSF 必要约定（必须遵守）

- `.tsl` 与 `.tsf` 都是 Tinysoft Language 源文件；修改它们时统一按 TSL 规范处理（不要把 `.tsf` 当成“另一种语言/无风格约束的脚本”）。
- 文件级约束：一个文件只能有一个顶层声明，且文件基名必须与该顶层声明同名（推荐 `PascalCase`）；`.tsl` 顶层声明只能是 `function`。
- 格式：空格缩进（默认 4 空格），关键字用小写，复杂分支/多语句分支用 `begin/end` 块表达结构。
- 命名：类型/顶层函数/property 用 `PascalCase`；局部变量/参数用 `snake_case`；私有成员变量用 `snake_case_`。
+- `.tsl` 与 `.tsf` 都是 Tinysoft
+  Language 源文件；修改它们时统一按 TSL 规范处理（不要把 `.tsf`
+  当成“另一种语言/无风格约束的脚本”）。
+- 语法权威来源：以 `docs/tsl/syntax_book/index.md`
+  为准；如与其他说明冲突，以语法手册为准。
+- 为避免上下文膨胀：不要整份加载
+  `docs/tsl/syntax_book/function.md`，只按需检索与引用相关片段。
+- 文件级约束：一个文件只能有一个顶层声明，且文件基名必须与该顶层声明同名（推荐
+  `PascalCase`）；`.tsl` 顶层声明只能是 `function`。
+- 格式：空格缩进（默认 4 空格），关键字用小写，复杂分支/多语句分支用 `begin/end`
+  块表达结构。
+- 命名：类型/顶层函数/property 用 `PascalCase`；局部变量/参数用
+  `snake_case`；私有成员变量用 `snake_case_`。

 ## 与开发规范的关系