Files
change_code/help/Writerside/topics/按需转码.md
T
2026-09-22 15:15:22 +08:00

38 lines
1.6 KiB
Markdown

# 按需转码
针对**非 LS 功能**的按需转码工作台。入口:左侧导航"业务转码"页,顶部标签切换到"按需转码"。
转码范围不包含核心文件、module 模块文件。支持两种模式:
- **非递归模式**:仅对目标文件本身执行转码,不会处理该文件内调用的函数;
- **递归模式**:转码目标文件的同时,自动对文件中所调用的关联函数一并完成转码。
## 功能列表管理
点击"添加"按钮,在弹窗中每行输入一个函数名(短名,如 AS_xxx),支持批量粘贴。若误带设计器扩展名后缀(如 .service_design)会自动剥离。
对于以 LS_ 开头的函数,界面会以黄色文字提示,并弹窗建议放入"全量转码"工作台转码(不拦截添加)。
选中行后点击"删除选中"移除函数、点击"清空列表"清空所有函数。
## 递归模式
每行行尾提供"是否递归"下拉框:
- **否**:非递归模式(默认);
- **是**:递归模式,自动转码关联函数。
切换后立即生效并保存。
## 配置文件同步
- 自动读取 `bin/uf2touft3/config/cust_nonls.json` 配置,"是否递归"对应文件中 convert 节点的 dir 值(0=否、-1=是);
- 兼容旧版清单格式(纯函数名数组,默认按"否"加载);
- 配置文件外部修改时自动刷新列表。
## 转换操作
点击"开始转换"启动转换任务,转换过程中可查看进度条和状态信息;点击"停止转换"可中止当前任务。
工具以按需转码模式调用引擎,函数清单与递归开关由引擎直接读取 `cust_nonls.json`,无需手动同步。