# 按需转码

针对**非 LS 功能**的按需转码工作台。入口：左侧导航"业务转码"页，顶部标签切换到"按需转码"。

转码范围不包含核心文件、module 模块文件。支持两种模式：

- **非递归模式**：仅对目标文件本身执行转码，不会处理该文件内调用的函数；
- **递归模式**：转码目标文件的同时，自动对文件中所调用的关联函数一并完成转码。

## 功能列表管理

点击"添加"按钮，在弹窗中每行输入一个函数名（短名，如 AS_xxx），支持批量粘贴。若误带设计器扩展名后缀（如 .service_design）会自动剥离。

对于以 LS_ 开头的函数，界面会以黄色文字提示，并弹窗建议放入"全量转码"工作台转码（不拦截添加）。

选中行后点击"删除选中"移除函数、点击"清空列表"清空所有函数。

## 递归模式

每行行尾提供"是否递归"下拉框：

- **否**：非递归模式（默认）；
- **是**：递归模式，自动转码关联函数。

切换后立即生效并保存。

## 配置文件同步

- 自动读取 `bin/uf2touft3/config/cust_nonls.json` 配置，"是否递归"对应文件中 convert 节点的 dir 值（0=否、-1=是）；
- 兼容旧版清单格式（纯函数名数组，默认按"否"加载）；
- 配置文件外部修改时自动刷新列表。

## 转换操作

点击"开始转换"启动转换任务，转换过程中可查看进度条和状态信息；点击"停止转换"可中止当前任务。

工具以按需转码模式调用引擎，函数清单与递归开关由引擎直接读取 `cust_nonls.json`，无需手动同步。