Introduction

文档类型：语法主线是否可直接用于生成代码：仅部分是否含已验证可执行示例：是是否含已验证反例：否遇到不确定时跳转到：02_quickstart.md、03_core_model.md、12_pitfalls.md

手册位置：第 1 篇，共 32 篇。上一篇：手册入口 index.md。下一篇：02_quickstart.md。

这一篇只做一件事：给 agent 建立 TSL 的第一判断模型。它不是人类教程，不负责展开所有语法细节；它只告诉 agent 第一次看到 TSL 任务时先判断什么、按什么证据生成代码、哪些直觉不能继承。

这一篇解决什么问题

回答“agent 第一次读到 TSL 需求时，怎样先识别交付形态，再选择最小可靠代码结构”。

涉及赋值、命名参数、类外形、unit 骨架、数组 / 字符串下标这类高频硬规则时，统一以 02_quickstart.md 的“语言核心事实速查”为准；这一页只负责建立第一判断模型。

TSL 可以借 Pascal 风格外形理解：function ... begin ... end;、unit ... interface ... implementation ... end.、type Name = class ... end; 都很接近。
这里只借外形，不默认继承 Pascal 的全部语义、库习惯和文件模型。
.tsl / .tsf 首先是用户交付形态：.tsl 是可执行脚本，.tsf 是通用模块 / 函数扩展。
日常赋值先记 :=，不要把 = 当成普通赋值。

.tsl 可执行脚本第一印象：

代码块身份：已验证可执行示例

a := 1;
test();

function test();
begin
    echo "test";
end;

代码块说明：.tsl 的语句区在前，按顺序执行；函数声明区在后，供前面的脚本语句调用。

.tsf 通用模块第一印象：

代码块身份：已验证可执行示例

function Test1();
begin
    echo "test1";
end;

代码块说明：这个 .tsf 部署到解释器 funcext 后，.tsl 脚本可以直接调用 Test1();。文件部署方式属于项目执行层，不写进通用语法页。

赋值、数组、字符串下标的第一印象：

代码块身份：已验证可执行示例

items := array(10, 20, 30);
table_data := array("Code": "000001", "Name": "Demo");
echo items[0];
echo table_data["Code"];
echo "ABC"[1];

代码块说明：数组下标从 0 开始，字符串下标从 1 开始；更完整规则见 04_values_and_literals.md。