JSON
向 JSON 添加或更新值
在 JSON 当前层按名称添加或覆盖一个值，适用于状态回写、重复执行流程和同名字段更新。
命令用途
Json-AddOrUpdateValue 对应的实际命令写法是 JSON <标识> AddOrUpdateValue，用于在当前层按名称添加或更新值。
它适合处理同名字段可能已存在的场景，不需要先手动判断是否存在再决定新增还是覆盖。
命令名
Json-AddOrUpdateValue
调用格式
JSON <标识> AddOrUpdateValue <名称> <值>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要写入的 JSON 标识。 |
AddOrUpdateValue | 是 | 固定子命令，表示同名时更新，不存在时新增。 |
名称 | 是 | 当前层中的字段名称。 |
值 | 是 | 要写入的新值。 |
返回或影响
- 该命令会在字段不存在时新增，字段已存在时覆盖原值。
- 适合做状态回写、结果刷新和重复执行流程下的同名字段更新。
- 不需要额外先判断字段是否已经存在。
示例
基础用法
#ACT
JSON myjson1 AddOrUpdateValue 金币 <$GAMEGOLD>
这段写法会把 myjson1 中 金币 字段更新为当前金币数；如果该字段原本不存在，则直接新增。
常见变体
#ACT
JSON myjson1 AddOrUpdateValue 日期 "2018-11-12 06:12:11"
JSON myjson1 AddOrUpdateValue 数组 ["字符串",1000]
这类写法适合把日期文本或数组结果统一回写到同一个 JSON 标识中。
注意事项
- 当值里本身包含空格、日期文本或整句说明时，建议使用双引号包裹。
- 如果你明确知道字段当前不存在，只想单纯追加，也可以直接用
Json-AddValue。 - 如果要按路径修改深层节点，而不是当前层字段，应该改用按路径写值的 JSON 命令。