✨ feat(tsl-codegen): support file and directory inputs

tools/tsl-codegen/README.md

@@ -250,15 +250,26 @@ skills/tsl-api-reference/references/codegen/project/base/array.md
 目标文件不存在时，可以直接生成到 skill。例如：
 
 ```bash
-python tools/tsl-codegen/scripts/generate.py tmp/my-api.yaml
+python tools/tsl-codegen/scripts/generate.py --file tmp/my-api.yaml
 ```
 
 json 使用相同命令：
 
 ```bash
-python tools/tsl-codegen/scripts/generate.py tmp/my-api.json
+python tools/tsl-codegen/scripts/generate.py --file tmp/my-api.json
 ```
 
+需要批量生成时，将录入文件放在同一目录并使用 `--dir`：
+
+```bash
+python tools/tsl-codegen/scripts/generate.py --dir tmp/api-recordings
+```
+
+目录模式只处理目录中的直属文件，不进入子目录。默认处理 `.json`、`.yaml` 和
+`.yml`；`--format json` 只处理 `.json`，`--format yaml` 只处理 `.yaml` 和
+`.yml`。所有录入文件会先完成解析、校验和格式化；预检发现任何错误或输出目标冲突
+时，生成器会列出对应输入文件和具体原因，并且不写入任何 markdown。
+
 生成器读取录入文件中的 `path`，默认写入
 `skills/tsl-api-reference/references/codegen/project/<path>.md`。不指定
 `--scope` 时，scope 就是 `project`
@@ -269,7 +280,7 @@ builtin 页面保持一致。未安装 Prettier 或格式化失败时，生成
 需要使用自定义 scope 时，通过 `--scope` 指定单级目录名：
 
 ```bash
-python tools/tsl-codegen/scripts/generate.py tmp/my-api.json --scope my-project
+python tools/tsl-codegen/scripts/generate.py --file tmp/my-api.json --scope my-project
 ```
 
 #### 修改现有叶子页