用途:Fluent 是 ServiceNow 的 pro-code 模式,把应用元数据写成声明式 TypeScript,git 作为事实来源而非实例。编辑本地 .now.ts 文件,编译(build),再把编译包推送到实例(install)。底层 CLI 是 @servicenow/sdk 的 now-sdk(4.x,Node 20+)。
主要能力:snow_fluent_* 工具仅本地可用,通过 stdio 运行 MCP 服务器时存在;托管 HTTP 传输(如网页聊天)下不可用,应改用 git + CI 流程。开发循环包括:snow_fluent_status 查看当前项目(scope、SDK 版本、keys.ts 状态);snow_fluent_explain 查阅离线 SDK 文档,写 DSL 前先核对 API 属性;snow_fluent_init 脚手架新应用或从 sys_id 转换现有实例应用;编辑 .now.ts;snow_fluent_build 编译直到无 TypeScript 错误;snow_fluent_install 部署到开发实例并验证。还可用 snow_fluent_download 和 snow_fluent_transform 把实例上的更改增量转回 Fluent(可选、逐条迁移)。
使用方式:Now.ID['stable-key'] 为每条记录提供稳定标识,src/fluent/generated/keys.ts 必须提交,否则别处构建会生成新 sys_id 导致重复记录。Fluent DSL 用现代 TypeScript,但 script: 字符串内的代码运行在实例 Rhino 引擎上,只能用 ES5。Fluent 未覆盖的类型(如经典 Workflow、UI Builder 页面、报表等)用通用 Record API、$override 或保留为 metadata/ 中的 XML。
限制:安装绕过 update set、无回滚上下文,切勿直接装到生产环境;reinstall 具有破坏性且是唯一“回滚”,不会清理副作用记录。CLI 默认 demoData 为 TRUE,而 snow_fluent_install 工具默认为 FALSE。在项目外构建即使报 “Could not find package.json” 仍退出 0,需检查 dist/ 输出。从 4.4.0 起未知或拼错属性会成为构建错误。全局应用需要 SDK >= 4.4.0 及 Australia 版本实例,且 pnpm 未完全支持。同类工件不要混用 Fluent 与 API 工具,API 编辑会被下次安装覆盖。