Moss JSON 处理插件

v1.0.0 · 数据处理 · 官方

JSON 数据格式化校验 CSV API Moss

简介

Moss JSON 处理插件 v1.0，AI 直接处理 JSON：

format 美化/压缩　validate 语法校验　extract 路径提取
merge 合并两份 JSON　to_csv 对象数组转 CSV
支持 --data 字符串或 --filepath 文件，无需 pip

适用：接口数据整理、配置检查、日志提取、导出表格。

操作说明

action	功能
`format`	美化或压缩
`validate`	校验语法
`extract`	按路径取值
`merge`	合并两份 JSON
`to_csv`	数组转 CSV

extract 路径示例： name · data.items · users[0].email

merge 规则： 对象+对象→键合并｜数组+数组→拼接｜类型不同→包成数组

安装

解压到 D:\moss-plugins\数据处理\JSON处理插件\
复制 python/ 到本目录
测试：run.bat --action validate --data "{\"ok\":true}"

文件	说明
`json_plugin.py`	主程序
`run.bat` / `run.sh`	启动脚本
`JSON处理插件.md`	用户文档

命令行

run.bat --action format --data "{\"a\":1,\"b\":[1,2]}"
run.bat --action validate --filepath D:\data\config.json
run.bat --action extract --filepath D:\data\api.json --path users[0].email
run.bat --action merge --data "{\"a\":1}" --data2 "{\"b\":2}" --output D:\data\merged.json
run.bat --action to_csv --filepath D:\data\records.json --output D:\data\records.csv

注册技能 json_tool

名称： json_tool

描述： JSON处理 v1.0：format/validate/extract/merge/to_csv。格式化、校验、按路径提取、合并、转CSV。用 data 或 filepath 传入。用户处理 JSON、合并配置、转表格时使用。

脚本： D:\moss-plugins\数据处理\JSON处理插件\run.bat

参数 JSON：

{
  "type": "object",
  "properties": {
    "action": {"type": "string", "enum": ["format", "validate", "extract", "merge", "to_csv"], "description": "操作类型"},
    "data": {"type": "string", "description": "JSON字符串"},
    "data2": {"type": "string", "description": "merge第二份"},
    "filepath": {"type": "string", "description": "JSON文件路径"},
    "filepath2": {"type": "string", "description": "merge第二文件"},
    "path": {"type": "string", "description": "extract路径如 users[0].email"},
    "output": {"type": "string", "description": "输出路径"},
    "indent": {"type": "string", "description": "format缩进默认2"},
    "compact": {"type": "string", "description": "format压缩 true/false"}
  },
  "required": ["action"]
}

对话示例

场景	说法
格式化	帮我把这段 JSON 格式化：{...}
校验	检查 D:\config\app.json 是否合法
提取	从 response.json 取 data.items[0].title
合并	合并 base.json 和 override.json
转表	把 records.json 转成 CSV

常见错误

现象	处理
JSON 解析失败	用 validate 查语法
缺 data/filepath	至少传一个
extract 无结果	先用 format 看结构
to_csv 失败	需 `[{对象},{对象}]` 格式

能力边界

支持	不支持
五种基础操作	JSON Schema
点号+下标提取	JSONPath
对象/数组合并	深度递归合并

配合：csv_tool 筛统计 · data_clean 清洗 · excel_tool 加样式

详见包内 JSON处理插件.md。