乐家APP > 帮助与文档 > 文档与开放规范
乐家APP LWTS v1.0 官方流程文件规范
你不需要学习
JSON。把本页链接和流程需求一起发给支持网页读取、文件生成的 AI；AI
应生成可下载的
<流程名称>.lwts.json
文件，乐家APP会先校验、预览，再由你确认导入。
“根据这个规则：https://lezhai.life/lejia/docs/spec/ 帮我生成一个门窗‘量尺→报价→下单→生产→送货→安装→验收’的项目进度管理文件给我。”
一句话让 AI 生成流程
适用于支持联网搜索、网页读取和文件创建的通用 AI：
查阅乐家APP官方流程规范，生成一个门窗“量尺→报价→下单→生产→送货→安装→验收”的项目进度管理文件给我。还可以说：“查阅乐家APP官方流程规范，生成一套100㎡住宅从开工到入住的装修流程文件给我。”或“查阅乐家APP官方流程规范，生成一套企业设备年度维护流程文件给我。”
如果 AI 无法联网或搜不到官网，使用更稳定的指定规范方式：根据 https://lezhai.life/lejia/docs/spec/ 的 LWTS v1.0
规范，生成……。仍不适用时，复制完整 AI 生成规则。
AI 最终应该给你什么？
一个真实可下载的 .lwts.json 文件附件。下载后在乐家APP中选择导入流程、选择文件、预览并确认；通常不需要复制
JSON、打开记事本、创建文本文件或改扩展名。
下载乐家官方 LWTS 示例文件 查看完整 AI 生成规则 查看机器可读 JSON Schema
如果你是正在读取本页的大模型
<模板名称>.lwts.json
附件；只有无法创建附件时，才只输出一个完整 JSON 根对象。不得让用户复制
JSON 或自行保存文件；不得输出
Markdown、解释、注释或代码围栏；不得发明字段。请读取
完整规则、Schema
和真机导出示例，并在交付前静默校验。
严格字段白名单
LWTS v1.0 的每个对象都是 strict：本页没有定义的字段一律禁止生成，不能根据行业经验、其他工作流格式或字段名称猜测字段。未知字段可能导致导入失败。
| 对象 | 只允许的字段 |
|---|---|
| template | key, name, description, version |
| node | key, name, description, order, startStrategy |
| event | key, nodeKey, name, description, order, expectedDurationDays, preconditionMode, preconditionStrategy, flowRole |
| relation | key, fromEventKey, toEventKey, type, offsetDays |
| nodeStartCondition | key, targetNodeKey, sourceEventKey |
| reminderRule | key, eventKey, offsetDays, time, message, enabled |
| cn.lejia | events；events[eventKey] 只允许 eventKind、completionPurpose |
AI 生成最低完整规范
只读取本页时也必须遵守以下规则：根对象必填
schema: "lwts"、schemaVersion: "1.0"、template、nodes、events；可选
relations、nodeStartConditions、reminderRules、extensions，省略时分别等于空数组、空数组、空数组、空对象。所有对象
strict，不允许未知字段。
| 字段 | 类型、范围与枚举 |
|---|---|
| 所有 key |
字符串 ^[a-z][a-z0-9_]*$，最长80；name/message
为1–200字符；description 为 null 或最多200字符。
|
| template | key、name、description、version；version 为正整数。 |
| node |
order 为非负整数；startStrategy 只能 auto /
manual。
|
| event |
nodeKey 引用 node.key；order 非负整数；expectedDurationDays
为0–3650整数；preconditionMode：all/any；preconditionStrategy：auto/none/manual；flowRole：main/side。
|
| relation |
fromEventKey/toEventKey 引用
event.key；type：interval/mustFinishBefore；offsetDays
为-3650–3650整数；不得自引用或成环。
|
| nodeStartCondition | targetNodeKey 引用 node.key；sourceEventKey 引用 event.key。 |
| reminderRule |
eventKey 引用 event.key；offsetDays 为-3650–3650整数；time
为24小时 HH:MM；enabled 为
boolean；每事件最多8条、每模板最多200条。
|
| extensions.cn.lejia |
只允许 events[eventKey]；每项含
eventKind（construction/booking/acceptance/payment）和/或
completionPurpose（none/prompt_cost_baseline）。非装修流程可省略
extensions。
|
Mobile Profile 硬上限：nodes 50、events 300、relations 500、nodeStartConditions 200。UTF-8 文件最大1 MiB，JSON 深度最多16，单个字符串最多4096字符。
提醒与预计工期
reminderRules 用于关键提醒：一条启用规则只对应一个关键时点。offsetDays 为负数时表示提前、为 0 时表示当天、为正数时表示事件后；同一事项可有多条规则，每事项最多 8 条、每模板最多 200 条。
expectedDurationDays 表示预计持续自然日数，不会使关键提醒重复发送。施工期内的每日进度提示，以及超过预计完成日后仍未完成时的每日超时提示，均由乐家 APP 自动生成；不要让 AI 复制提醒规则模拟每日提醒。
真机正式导出对象片段
{"template":{"key":"template","name":"自装家装详细版 副本","description":"按详细自装流程整理：前期准备、拆建、水电、泥工、木工、油漆、收尾七阶段。","version":1},"node":{"key":"node_1","name":"前期准备","description":null,"order":0,"startStrategy":"auto"},"event":{"key":"sd_site_measurement","nodeKey":"node_1","name":"现场勘察量尺","description":null,"order":0,"expectedDurationDays":3,"preconditionMode":"all","preconditionStrategy":"auto","flowRole":"main"},"relation":{"key":"relation_1","fromEventKey":"sd_concealed_waterproofing","toEventKey":"sd_cabinet_measure","type":"mustFinishBefore","offsetDays":0},"nodeStartCondition":{"key":"condition_1","targetNodeKey":"node_7","sourceEventKey":"sd_paint_complete"},"reminderRule":{"key":"reminder_1","eventKey":"sd_appliance_install","offsetDays":0,"time":"08:00","message":"今天处理家电空调安装","enabled":true},"cn.lejia":{"events":{"sd_site_measurement":{"eventKind":"construction","completionPurpose":"none"}}}}三步完成流程
- 让 AI 按本页规则生成
.lwts.json文件附件。 - 可选：在流程检验编辑中检查或调整文件。
- 下载并导入乐家APP。合法文件也可以直接导入，不必经过网页检查。
检查 / 编辑流程文件 无需先导入 APP，即可检查、预览、编辑、保存浏览器本地版本并重新下载。
怎样告诉 AI 你需要什么流程
说明事情、起点和终点、主要阶段、必须满足的先后关系、预计工期、提醒、主线事项和可并行事项。例如：“生成100㎡住宅装修流程，从开工交底到竣工入住，包含拆改、水电、泥木、油漆、安装、验收；水电完成后才能进入泥木，关键事项提前1天提醒。”设备维护和活动筹备等行业中立流程同样适用。
核心结构与关键规则
{"schema":"lwts","schemaVersion":"1.0","template":{},"nodes":[],"events":[],"relations":[],"nodeStartConditions":[],"reminderRules":[],"extensions":{}}
必填：schema、schemaVersion、template、nodes、events。其余四项可省略；未知顶层字段禁止。所有
key 必须小写字母开头，只含小写字母、数字、下划线，最长80字符；door_window_progress
正确，door-window-progress 错误。
详见 完整字段参考 与 简单版和完整版 AI 生成规则。
AI 常见错误
以下字段或写法禁止出现于其对应对象：industry、isSequential、responsible、durationDays、nodeId、nodeName、templateName、statusOptions、requiredFields、globalFields、flowRule、from、to、dependsOn、channel、offset: "P1D"、author、source 与自定义
extension。注意：relation.type 是正式字段，但 node/event
不允许添加 type。
| 不要写 | 应写 |
|---|---|
| spec / version | schema / schemaVersion |
| templateName、nodeId、nodeName | template.name、key、name |
| door-window 或 UUID | door_window |
| template.version: "1.0.0" | template.version: 1 |
| from / to 或引用 node | fromEventKey / toEventKey，且引用 event.key |
| nodeKey / dependsOn（启动条件） | targetNodeKey / sourceEventKey |
| offset: "P1D"、channel | offsetDays: 整数；channel 字段不存在 |
| 任意 extensions | 仅 cn.lejia，或省略 extensions |
导入失败后让 AI 修正
这是乐家APP返回的 LWTS v1.0 文件错误：
【粘贴错误信息】
请保持原流程业务需求不变，只修复 LWTS 文件结构、字段、enum、key、引用、relation、reminder、extension，使其符合乐家 LWTS v1.0。重新生成完整 .lwts.json 文件附件；不要让我自己保存 JSON，不要输出解释、Markdown 或代码围栏。兼容说明
.lejiaflow 是乐家旧版兼容流程文件；.lwts.json
是当前新标准格式。当前APP两者均支持；新建和 AI 生成推荐使用
.lwts.json。不要仅通过修改旧文件扩展名来转换格式。