自定义订单编辑器逐步操作
本页专门说明“自定义订单配置”弹窗本身的操作方式。字段语义见订单与 VHDX 配置，本页关注打开弹窗后每个按钮、表单区、JSON 区和保存状态如何工作。
如果需要逐字段核对默认值、类型转换和控件联动，继续看自定义订单字段与控件矩阵。
打开编辑器前
- 登录拥有机台权限的账号；
- 打开“机台管理”；
- 先刷新当前机台配置；
- 确认订单读取成功；
- 下载当前配置和账号缓存；
- 确认机台空闲且没有订单正在应用。
读取失败时不要直接打开空配置覆盖原内容。空数组只能在确认当前确实没有自定义订单时使用。
弹窗生命周期
打开弹窗时，当前配置会复制到编辑状态。打开后即使父页面刷新配置，已经打开的编辑器也不会自动覆盖正在编辑的内容；因此保存前应关闭并重新打开，或手动确认自己使用的是最新版本。
点击关闭/取消不会保存当前编辑。点击“保存配置”后，弹窗提交 JSON，弹窗关闭，机台管理页继续显示操作进度。
顶部工具栏
订单数量
顶部显示当前编辑数组中的订单数量。数量为 0 时，底部 JSON 应为 []。
填入压缩包示例配置
点击后会把当前订单数组替换为一份脱敏的压缩包模板。已有订单时会先确认“是否替换全部内容”。
示例只用于查看字段形状：
- 下载地址是占位地址；
- 密码、Hash、路径和大小不能直接用于真实机台；
- 点击确认会替换当前编辑内容，但还没有保存到机台；
- 替换后可以继续编辑或关闭放弃。
填入 VHDX 示例配置
行为与压缩包示例相同，但会填入 is_vhdx: true、镜像名称、镜像密码占位符和映射结构。它用于理解字段关系，不是可直接安装的生产订单。
使用示例后必须替换：订单名、描述、路径、密码、Hash、URL、大小、镜像文件名、时间和映射。不要把示例值当作管理员提供的真实值。
添加订单
“添加订单”会增加一个空订单卡片。空订单不会自动下载，但保存前应至少填写：
- 唯一的订单名；
- 描述；
- 安装路径；
- 一项或多项安装内容；
- 与目标机台匹配的时间和启动设置。
不需要的空订单应删除，不要把空对象留在生产配置中。
订单卡片
每个订单卡片显示“订单 1、订单 2…”和“移除”按钮。移除只改变当前编辑数组，点击保存后才会提交。
基本文本框
| UI 标签 | 对应字段 | 输入要求 |
|---|---|---|
| 订单名称 | name | 唯一、稳定、不要包含密码 |
| 描述 | description | 供管理员识别用途和来源 |
| 安装路径 | install_path | 目标机台可用的绝对路径 |
| VHDX 密码 | vhdx_pwd | 仅填写管理员提供的镜像密码 |
| 订单时间 | current.order_time | 使用约定的时间格式和时区 |
| 发布时间 | current.release_time | 到时间后才允许后续应用 |
Windows 路径在 JSON 文本中需要双反斜杠。表单输入和底部 JSON 显示可能看起来不同，这是 JSON 转义造成的正常差异。
三个开关
删除项
开启后该订单被视为清理/删除操作。它不是“隐藏订单”开关，保存前要再次确认名称和路径。
可选安装项
开启后该订单不会仅因为存在于数组就自动应用。还要在机台的“订单项可选安装列表”中选择它。
VHDX 订单
开启后表示安装项使用镜像方案。此时通常需要同时填写顶层镜像密码、安装项 vhdx_name、Hash、大小和映射。不要只打开开关而继续使用压缩包模板。
settings.mklink 区域
订单卡片中的 mklink 区域包含：
- 启用开关；
- 模式数字；
- 源路径；
- 目标路径。
页面允许输入数字模式，但不提供完整枚举。未知模式不要凭猜测填写；使用管理员已经验证过的样例，在测试机台上检查目录可见性。
启用映射前确认源路径存在、目标路径属于当前订单、磁盘已挂载。映射方向错误可能让内容不可见或影响错误目录。
settings.sideload 区域
该区域包含：
- 侧载启用开关；
- 运行路径。
启用后订单会出现在侧载选择弹窗。运行路径必须是目标机台可访问的启动入口；盘符未挂载、文件不存在或路径转义错误时，可能出现“下载成功但无法启动”。
安装项列表
点击“添加安装项”增加一行。每个安装项可以删除，字段如下：
| 输入框 | 对应字段 | 说明 |
|---|---|---|
| 名称 | install[].name | 安装项标识和进度名称 |
| Hash | install[].hash | 下载完整性校验值 |
| URL | install[].url | 下载地址 |
| 密码 | install[].pwd | 压缩包/安装项密码，没有则留空 |
| 大小 | install[].size | 字节数，不是 MB 或 GB |
| VHDX 名称 | install[].vhdx_name | 镜像文件名，普通包通常留空 |
| 订单时间 | install[].order_time | 安装项自己的处理时间 |
| 发布时间 | install[].release_time | 安装项自己的发布时间 |
添加安装项的顺序
- 点击“添加安装项”；
- 填写名称；
- 粘贴管理员提供的 Hash 和 URL；
- 填写准确字节大小；
- VHDX 订单填写镜像文件名；
- 需要单独调度时填写安装项时间；
- 再添加下一项；
- 保存前逐项检查。
删除安装项只从当前数组移除，保存后才会提交。大包拆分时不要把主包和分包的名称、大小、Hash 互换。
install_mklink 映射区
点击“添加映射”会生成一行键/值输入框：
- 键表示映射的一侧路径；
- 值表示另一侧路径；
- 删除映射只从 JSON 移除，不删除磁盘原文件；
- 修改键会删除旧键并创建新键；
- 空键、重复键和路径方向错误都应在保存前修正。
路径方向必须使用管理员提供的已验证样例确认，不要根据“源/目标”文字自行推断真实链接方向。
底部 JSON 编辑区
底部显示“生成的订单列表配置”文本区，是最终提交内容的可见副本。右侧状态有两种：
JSON 有效：文本可以解析为数组，保存按钮可用；JSON 格式错误：文本无法解析，保存按钮禁用。
表单改动
修改表单字段后，页面会重新序列化整个数组，JSON 区会同步更新。可以复制 JSON 区保存到离线文件。
直接修改 JSON
直接编辑 JSON 区时：
- 使用双引号；
- 顶层必须是数组；
- 逗号、括号和字符串必须完整；
- 数字字段保持数字类型；
- 未知字段不要删除；
- 解析成功后表单才会同步到新结构；
- 解析失败时，页面会暂时保留上一次有效表单，但不会允许保存。
发现错误时，先撤销最后一次改动或从离线有效文件恢复，不要连续粘贴多份不同配置。
保存按钮与操作进度
点击“保存配置”前，页面至少检查：
- JSON 没有语法错误；
- 顶层是数组；
- 订单名称没有重复；
- VHDX 字段和安装项配套；
- URL、Hash、大小和路径经过核对；
- 订单列表没有误把目标放进黑名单/删除列表；
- 机台处于空闲。
保存期间按钮显示处理中并禁用。成功后弹窗关闭，页面显示机台操作进度；失败时不要重复保存同一份未知配置，应重新打开编辑器检查原始值和返回消息。
三个示例的正确使用方式
| 操作 | 是否会覆盖当前编辑内容 | 是否会立即安装 |
|---|---|---|
| 填入压缩包示例 | 会，已有内容需确认 | 不会 |
| 填入 VHDX 示例 | 会，已有内容需确认 | 不会 |
| 保存配置 | 提交整个数组 | 可能触发后续订单流程，但仍需下载/发布时间/应用 |
示例按钮只是模板生成器。真实 URL、密码、Hash 和路径必须来自当前管理员的受信配置。
编辑器故障处理
| 现象 | 首先检查 |
|---|---|
| 打开后订单为空 | 当前配置读取是否失败，不要直接保存 |
| JSON 格式错误 | 最后一处逗号、引号、括号和顶层类型 |
| 保存按钮禁用 | JSON 状态、是否仍在保存、是否有输入错误 |
| VHDX 下载成功但无法应用 | 密码、Hash、字节大小、镜像文件名和发布时间 |
| 订单不显示在侧载列表 | is_option、侧载开关和可选列表 |
| 启动后找不到内容 | 安装路径、挂载状态和映射方向 |
| 保存成功但机台无变化 | 操作进度、发布时间和是否需要重启 |
编辑完成后的验收
- 重新打开弹窗，确认 JSON 与刚才保存一致；
- 在订单状态中确认所有安装项；
- 检查磁盘空间和下载进度；
- 选择目标侧载项并记录选择；
- 在空闲时间执行页面要求的重启；
- 用截图、健康数据和普通用户最小操作验收；
- 把最终 JSON 和操作记录放到受保护的离线位置。