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

1.6 KiB

按需转码

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

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

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

功能列表管理

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

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

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

递归模式

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

  • 否:非递归模式(默认);
  • 是:递归模式,自动转码关联函数。

切换后立即生效并保存。

配置文件同步

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

转换操作

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

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