♻️ refactor(tsl-api-reference): split lookup workflows and maintenance tooling
This commit is contained in:
@@ -18,7 +18,8 @@ tools/tsl-codegen/
|
||||
│ ├─ generate.py yaml/json → markdown
|
||||
│ ├─ lint.py markdown 格式校验
|
||||
│ ├─ api_markdown.py lint/index 共用标题模型
|
||||
│ └─ build_index.py 重建 13 列 function_index.tsv
|
||||
│ ├─ build_index.py 重建 13 列 function_index.tsv
|
||||
│ └─ build_dictionary.py HTML 数据字典 → markdown/TSV
|
||||
└─ tests/ 工具测试
|
||||
```
|
||||
|
||||
@@ -193,6 +194,15 @@ tmp/my-api.json
|
||||
一个录入文件对应一个 markdown 叶子页。录入文件不放入 skill;是否长期保留由
|
||||
维护者自行决定
|
||||
|
||||
#### Class 与 Framework Profile
|
||||
|
||||
生成 class 页面并更新 `function_index.tsv` 后,class 已可通过自动成员视图查询,不要求
|
||||
额外的 Framework Profile。`class_lookup.py` 返回 `profile_status=not_profiled` 表示普通
|
||||
class,属于正常且完整的结果;不要为它创建空 profile。
|
||||
|
||||
本工具不会从 class 名称或成员列表推断生命周期、配置、回调和执行阶段。只有另有可核验
|
||||
协议证据的框架类才需要 curated Framework Profile。
|
||||
|
||||
### 4. 选择 Skill 中的目标位置
|
||||
|
||||
TSL API skill 的相关目录如下:
|
||||
@@ -391,4 +401,4 @@ python skills/tsl-api-reference/scripts/lookup.py --name DemoUnit.Document.Save
|
||||
- `skills/tsl-api-reference/data/function_index.tsv`
|
||||
|
||||
TSL API skill 只需要 markdown 和 TSV。录入用的 yaml/json 可以由维护者在自己的
|
||||
版本库中管理
|
||||
版本库中管理。
|
||||
|
||||
Reference in New Issue
Block a user