规范版本：1.0 · 状态：Draft

LWTS v1.0 字段参考

LWTS 是乐家APP的流程模板交换格式。它只描述模板和流程结构，不携带账号、项目实际进度、财务、附件或设备信息。新建与 AI 生成文件使用 .lwts.json。

根对象

必填 schema（固定 lwts）、schemaVersion（固定 1.0）、template、nodes、events。可选 relations、nodeStartConditions、reminderRules、extensions。未知字段禁止。

template、nodes、events

对象	必填字段	约束
template	key, name, description, version	version 是正整数；description 为 null 或最多200字符。
node	key, name, description, order, startStrategy	order 为非负整数；startStrategy 仅 auto / manual。
event	key, nodeKey, name, description, order, expectedDurationDays, preconditionMode, preconditionStrategy, flowRole	nodeKey 引用 node.key；expectedDurationDays 为预计持续自然日数，范围 0–3650；mode 为 all/any；strategy 为 auto/none/manual；role 为 main/side。

所有 key：^[a-z][a-z0-9_]*$，最多80字符；首字符为小写英文字母，之后只可小写字母、数字、下划线。name/message 为1–200字符。

关系、启动条件与提醒

对象	字段	关键规则
relation	key, fromEventKey, toEventKey, type, offsetDays	两个引用都是 event.key，不能相同、不能成环；type 仅 interval/mustFinishBefore；offsetDays -3650–3650。
nodeStartCondition	key, targetNodeKey, sourceEventKey	分别引用 node.key 与 event.key；不存在 nodeKey、dependsOn。
reminderRule	key, eventKey, offsetDays, time, message, enabled	time 为 HH:MM；每事项最多8条、每模板最多200条；一条规则只对应一个关键提醒时点；不存在 offset、channel。

工期与提醒语义

expectedDurationDays 表示事项预计持续的自然日数，不是提醒窗口。例如事项计划在 9 月 1 日开始、工期为 10 天，表示预计执行至 9 月 10 日；超过预计完成日仍未完成时，APP 会进入超时提醒。

reminderRule 是一次关键提醒：offsetDays < 0 表示事件日前 N 天，= 0 表示当天，> 0 表示事件后 N 天。每条启用规则只在其指定日期和时间提醒一次；同一 eventKey 可配置多条规则，例如提前 7 天、提前 2 天和当天三个关键时点。

{"key":"window_install_prepare","eventKey":"window_install","offsetDays":-7,"time":"09:00","message":"确认门窗生产与送货时间","enabled":true}

上例表示在门窗安装事件日前 7 天的 09:00 提醒一次。事项施工期间的每日进行中提示，以及超过预计完成日后的每日超时提示，均由 APP 根据日期、工期和状态自动生成，不写入 reminderRules。

cn.lejia 扩展

非装修流程可以省略 extensions。唯一支持的命名空间是 cn.lejia，其 events[eventKey] 可使用 eventKind（construction、booking、acceptance、payment）和/或 completionPurpose（none、prompt_cost_baseline）。不得使用其他 namespace 或 industry、meta、author、source、URL。

Mobile Profile 与文件限制

建议：nodes≤35、events≤210、relations≤350、nodeStartConditions≤140。硬上限：50、300、500、200；超过即拒绝导入。文件为 UTF-8 JSON，最大1 MiB，结构深度最多16，单个字符串最多4096字符。

查看机器可读 Schema，并下载真机正式导出示例。