Squashed 'docs/standards/playbook/' changes from c3f8137..25d895d
25d895d 🐛 fix(gitea_workflow): clean up temp repos after job steps 2bc3b11 🐛 fix(gitea_workflow): clean up temporary repo dirs in workflows 98c3f30 📝 docs(agent_rules): allow plan execution on current branch 16c7230 📝 docs(prompts): define custom verify layering 8efc4dd 🐛 fix(skills): quote commit-message description bc8498f 🐛 fix(ci): install tomli for gitea tests 55cda3b 🐛 fix(tests): report missing toml parser clearly c0729c7 🐛 fix(playbook): import Optional for cli compatibility 63e24bf 📦 deps(skills): sync thirdparty skills d2f9356 🐛 fix(ci): isolate gitea workflow repos 588b81d 🐛 fix(ci): inline gitea workflow bootstrap e0b1c3a ♻️ refactor(skills): standardize first-party skill contracts 2c5050d ♻️ refactor(skills): rename repo skills source dir f049dfb 📦 deps(skills): drop duplicate first-party superpowers skills 234b335 ✨ feat(workflow): add superpowers planning and execution state tracking c1702a6 📝 docs(markdown): format tracked markdown and drop stale templates 2325409 📝 docs(markdown): clarify optional markdownlint usage 214c44e 🔧 chore(markdown): add markdownlint baseline and lint fixes a22b324 📝 docs(templates): add execution and memory-bank prompt templates 223a797 📝 docs(templates): update README for Claude Code and current features 4ac8672 📝 docs: simplify README + platform-agnostic tools + auto-create local rules 2431c9d 📝 docs: add claude_md config and use cross-platform paths d64b248 📝 docs: fix README.md inaccuracies and add Claude Code info c8d6bf2 🐛 fix(playbook): use relative paths in CLAUDE.md when not at project root 6518f0f ✨ feat(playbook): auto-create CLAUDE.md with path discovery 6ec9a45 ✨ feat(skills): add skill_link symlink support + platform-agnostic prompt 9f8b6b5 📝 docs: update README and config example for Claude Code support 79cff6c 📝 docs(skills): add Claude Code platform support 452c6f5 ✨ feat(playbook): auto-inject AGENTS.md into CLAUDE.md e1dbf3c 🐛 fix(skills): remove dual-path from commit-message skill f3a7259 🔧 chore(ci): use prepare_repo.sh in both workflows da08212 🔧 chore(ci): extract prepare_repo.sh and clean up workflows 7ade85e 🗑️ remove(tsl): drop syntax_book/, data/ source and build script f94dba0 ♻️ refactor(skills): update playbook.py and tests for thirdparty/ layout b3df412 ♻️ refactor(skills): separate thirdparty skills into thirdparty/ subdirectory 64950e7 📦 deps(skills): sync thirdparty skills a2e3cb0 ✨ feat(playbook): add no_backup deploy controls 8609d59 🐛 fix(docs): repair reference catalog source links 956da11 🐛 fix(playbook): publish hidden ci test fixes 3f67754 📦 deps(skills): sync thirdparty skills 08ca87b 📦 deps(skills): add karpathy thirdparty sync 96b705b 📝 docs(tsl): rebuild canonical syntax and routing manual 3ed5052 📦 deps(skills): sync thirdparty skills 60108dd 📦 deps(skills): sync thirdparty skills da85d4e 🐛 fix(thirdparty): prune nested project snapshots a2a697e 📦 deps(skills): sync thirdparty skills 9df610a 🐛 fix(thirdparty): exclude duplicated superpowers skills 33dd5bb 🐛 fix(thirdparty): preserve optional manifest fields 91b0ea7 🐛 fix(thirdparty): preserve manifest during snapshot update 2e26f98 🔧 chore(thirdparty): generalize skills sync pipeline 5b9c1e3 📦 deps(skills): sync superpowers 2f2d34a 📝 docs(readme): normalize subtree command spacing 62db7db 🐛 fix(ci): serialize superpowers update and sync 3463223 🐛 fix(ci): use literal superpowers sync paths 48f6de8 📦 deps(skills): sync superpowers 4b23529 🔧 chore(ci): merge superpowers update and sync workflow a56d75b 📦 deps(skills): sync superpowers 84bcefa 🔧 chore(ci): use ci[bot] commit author name 00a07e5 📦 deps(skills): sync superpowers 7b84daf 🐛 fix(templates): enforce main loop progress tracking 51373d7 🔧 chore(ci): automate superpowers sync workflow eaaa39c 🐛 fix(ci): prevent stale superpowers sync from restoring skills block 79755c6 📦 deps(skills): sync superpowers 836d878 📦 deps(skills): sync superpowers 8216c9f 📦 deps(skills): sync superpowers 9439505 🐛 fix(playbook): address reported repo issues git-subtree-dir: docs/standards/playbook git-subtree-split: 25d895d8b3f56624ccfe99ad7289e9eb49e0f316
This commit is contained in:
@@ -0,0 +1,166 @@
|
||||
# Builtin Runtime Objects
|
||||
|
||||
文档类型：语法主线
|
||||
是否可直接用于生成代码：仅部分
|
||||
是否含已验证可执行示例：是
|
||||
是否含已验证反例：否
|
||||
遇到不确定时跳转到：[23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md)、[30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md)、[12_pitfalls.md](12_pitfalls.md)
|
||||
|
||||
手册位置：第 24 篇，共 32 篇。上一篇：[23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md)。下一篇：[25_set_operations.md](25_set_operations.md)。
|
||||
|
||||
这一篇只收当前解释器下已经实际跑通的运行时内置对象最小模型。这里讲的是语言运行时对象，不是金融业务 API。
|
||||
|
||||
## 这一篇解决什么问题
|
||||
|
||||
回答“写普通 TSL/TSF 脚本时，哪些内置对象可以直接创建，最小可用接口是什么，哪些对象其实依赖特定运行上下文”。
|
||||
|
||||
## 必须记住的规则
|
||||
|
||||
- 当前 CLI 里，`TStringList` 已验证可以直接 `CreateObject("TStringList")` 创建。
|
||||
- `TStringList` 当前已验证支持数字下标、字符串键下标、`Count` 和 `Add(...)`。
|
||||
- 流对象应先按 `TStream` 家族理解；当前 CLI 里最小可靠入口是 `TMemoryStream` 这种具体类型。
|
||||
- 当前 CLI 里，直接 `CreateObject("TStream")` 会失败，错误信息包含 `function:tstream compile error or not found`。
|
||||
- `TMemoryStream` 当前已验证支持 `Write(...)`、`Read(...)`、`Position`、`Size`。
|
||||
- `TCipher` 当前不是“无参即可创建”的对象；`CreateObject("TCipher")` 会失败。
|
||||
- `TCipher` 当前已验证可用的最小写法是 `CreateObject("TCipher", 2)`，然后设置 `Password` 再做 `Encrypt(...)` / `Decrypt(...)`。
|
||||
- `TWebRequest` 和 `TWebResponse` 在当前 CLI 环境里没有通过直接 `CreateObject(...)` 的最小样例。
|
||||
- 因此，WEB 请求 / 响应对象不要直接写进普通命令行脚本模板；它们应视为特定运行上下文对象。
|
||||
|
||||
## 已验证语法
|
||||
|
||||
### `TStringList`
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
program test;
|
||||
begin
|
||||
obj := CreateObject("TStringList");
|
||||
obj.CommaText := "A=aaa,B=bbb,C=222";
|
||||
WriteLn(obj[1]);
|
||||
WriteLn(obj["B"]);
|
||||
WriteLn(obj.Count);
|
||||
obj.Add("D=444");
|
||||
WriteLn(obj.Count);
|
||||
end.
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- 依次输出 `B=bbb`、`bbb`、`3`、`4`
|
||||
- 说明当前既可以按数字下标取整行，也可以按键名取 `Name=Value` 里的值
|
||||
|
||||
### `TStream` 家族的最小可靠入口：`TMemoryStream`
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
program test;
|
||||
begin
|
||||
mem := CreateObject("TMemoryStream");
|
||||
buffer := "ABC";
|
||||
mem.Write(buffer, 3);
|
||||
mem.Position := 0;
|
||||
outbuf := "xxx";
|
||||
mem.Read(outbuf, 3);
|
||||
WriteLn(outbuf);
|
||||
WriteLn(mem.Size);
|
||||
try
|
||||
base := CreateObject("TStream");
|
||||
WriteLn(ifObj(base));
|
||||
except
|
||||
WriteLn("TStreamError");
|
||||
WriteLn(ExceptObject.ErrInfo);
|
||||
end;
|
||||
end.
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- 前两行输出 `ABC`、`3`
|
||||
- 后两行输出 `TStreamError`，以及包含 `function:tstream compile error or not found` 的错误信息
|
||||
- 说明当前 CLI 里应优先使用 `TMemoryStream` 这类具体流对象，不要把裸 `TStream` 当成可直接创建对象
|
||||
|
||||
### `TCipher`
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
program test;
|
||||
begin
|
||||
try
|
||||
bad := CreateObject("TCipher");
|
||||
WriteLn("NoArg");
|
||||
WriteLn(ifObj(bad));
|
||||
except
|
||||
WriteLn("NoArgError");
|
||||
WriteLn(ExceptObject.ErrInfo);
|
||||
end;
|
||||
|
||||
cipher := CreateObject("TCipher", 2);
|
||||
cipher.Password := "Tinysoft";
|
||||
enc := cipher.Encrypt("abc");
|
||||
WriteLn(enc <> "abc");
|
||||
WriteLn(cipher.Decrypt(enc));
|
||||
end.
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- 前两行输出 `NoArgError`，以及包含 `New Class tcipher Error.` 的错误信息
|
||||
- 后两行输出 `1`、`abc`
|
||||
- 说明 `TCipher` 当前必须按“带模式参数创建”来写，随后可稳定走 `Password -> Encrypt -> Decrypt`
|
||||
|
||||
### `TWebRequest` / `TWebResponse` 的 CLI 边界
|
||||
|
||||
代码块身份：已验证可执行示例
|
||||
|
||||
```tsl
|
||||
program test;
|
||||
begin
|
||||
try
|
||||
req := CreateObject("TWebRequest");
|
||||
WriteLn("ReqOk");
|
||||
WriteLn(ifObj(req));
|
||||
except
|
||||
WriteLn("ReqError");
|
||||
WriteLn(ExceptObject.ErrInfo);
|
||||
end;
|
||||
|
||||
try
|
||||
resp := CreateObject("TWebResponse");
|
||||
WriteLn("RespOk");
|
||||
WriteLn(ifObj(resp));
|
||||
except
|
||||
WriteLn("RespError");
|
||||
WriteLn(ExceptObject.ErrInfo);
|
||||
end;
|
||||
end.
|
||||
```
|
||||
|
||||
已验证运行结果：
|
||||
|
||||
- 先输出 `ReqError`，随后错误信息包含 `function:twebrequest compile error or not found`
|
||||
- 再输出 `RespError`，随后错误信息包含 `function:twebresponse compile error or not found`
|
||||
- 说明当前 CLI 环境下，WEB 请求 / 响应对象不能直接按普通 `CreateObject(...)` 脚本对象来写
|
||||
|
||||
## 暂不在本页展开的对象
|
||||
|
||||
- `TFileStream`
|
||||
- `TIniFile`
|
||||
- `TMemIniFile`
|
||||
- `THashedStringList`
|
||||
- `TRSA`
|
||||
- `FTP` / `SMTP` / `POP3`
|
||||
- `MailMsg` / `MessagePart`
|
||||
- `TCookie` / `TCookieCollection`
|
||||
- `TSessionMan` / `TSession`
|
||||
|
||||
这些对象旧资料里都出现过，但当前这一篇先只保留“新 session 最容易直接用到”的最小主干。需要把其中某个对象升级进主线正文时，应先补最小脚本再写结论。
|
||||
|
||||
## 跳转指引
|
||||
|
||||
- 回看对象主线：见 [09_objects_and_classes.md](09_objects_and_classes.md)
|
||||
- 看对象运行时反射：见 [23_object_runtime_and_introspection.md](23_object_runtime_and_introspection.md)
|
||||
- 看运行时服务与缓存：见 [30_runtime_services_and_global_cache.md](30_runtime_services_and_global_cache.md)
|
||||
- 看对象重载与遍历：见 [32_object_overloads_and_iteration.md](32_object_overloads_and_iteration.md)
|
||||
Reference in New Issue
Block a user