change_code/help/Writerside/topics/按需转码.md

按需转码

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

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

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

功能列表管理

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

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

选中行后点击"删除选中"移除函数、点击"清空列表"清空所有函数。双击函数名所在行，可在弹窗中修改函数名（页面顶部有操作提示）。

递归模式 与 db模式

每行提供"是否递归"与"db模式"下拉框：

• 是否递归：
  • 否：非递归模式（默认）；
  • 是：递归模式，自动转码关联函数。
• db模式：选择 SQL 语法转换方言：
  • 否：mdb 方言（默认）；
  • 是：db 方言。

切换后立即生效并保存。

配置文件同步

• 自动读取 bin/uf2touft3/config/cust_nonls.json 配置："是否递归"对应 convert.dir 条目的 depth（0=否、-1=是），"db模式"对应 dialect（mdb=否、db=是）；
• 兼容旧版清单格式（纯函数名数组或数值条目，均按"否/mdb"加载）；
• 配置文件外部修改时自动刷新列表。

转换操作

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

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