JSON
向 JSON 添加值
在 JSON 当前层追加一个名称和值，适用于构造对象字段、补充返回结果和逐步拼装结构化数据。
命令用途
Json-AddValue 对应的实际命令写法是 JSON <标识> AddValue，用于在当前 JSON 对象层里追加一个名称和值。
它适合从空对象开始逐步拼装字段，也适合在已有 JSON 结果中继续补入新的键值对。
命令名
Json-AddValue
调用格式
JSON <标识> AddValue <名称> <值>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要写入的 JSON 标识。 |
AddValue | 是 | 固定子命令，表示追加一个名称和值。 |
名称 | 是 | 当前层中新字段的名称。 |
值 | 是 | 要写入的值，支持整数、字符串、布尔值、浮点数、数组或对象。 |
返回或影响
- 该命令会在当前层中新增一个名称和值。
- 适合从空 JSON 开始逐项构造对象内容。
- 值本身可以是普通标量，也可以直接写数组或对象文本。
示例
基础用法
#ACT
JSON myjson AddValue 整数 12345
这段写法会在 myjson 当前层中新增一个名为 整数、值为 12345 的字段。
常见变体
#ACT
JSON myjson AddValue 布尔值 True
JSON myjson AddValue 浮点数 2.532
这类写法适合连续向同一个 JSON 中补入不同类型的字段值。
注意事项
- 字符串值里如果包含空格或完整句子，建议用双引号包起来，避免被拆成多个参数。
- 当你希望同名字段已存在时自动覆盖，应改用
Json-AddOrUpdateValue。 Json-AddValue更适合对象当前层字段追加；深层路径赋值要留给SetValueByPath这一类命令处理。