expanso-json-pretty

json-pretty 是一款基于 Expanso Edge 运行时的 JSON 数据美化工具，采用纯声明式配置实现，无需编写任何可执行代码即可完成复杂的 JSON 格式化任务。该技能通过简洁的 YAML 配置文件定义数据处理流程，支持 CLI 管道模式和 MCP 服务器模式两种运行方式，为用户提供灵活多样的集成选择。

在核心用法方面，用户可通过 CLI 模式将 JSON 数据通过标准输入传递给 expanso-edge 运行时，工具会自动调用 parse_json() 函数解析输入内容，并经过 format_json() 函数输出带标准缩进和换行的美化后 JSON。MCP 模式则允许将技能部署为 HTTP 服务，通过 Model Context Protocol 为 AI 应用提供 JSON 格式化能力。此外，该技能还支持直接部署到 Expanso Cloud，实现云端流水线处理。

显著优点包括：首先，纯配置型架构彻底杜绝了代码执行风险，无 eval、exec、system 等危险函数调用，逻辑完全透明可查；其次，数据处理完全在本地完成，无网络传输和远程服务器依赖，有效保障数据隐私；第三，双模式设计既满足命令行用户的脚本化需求，也支持现代化 AI 应用的协议集成；第四，依赖的 Expanso Edge 为官方声明式数据处理引擎，无已知安全漏洞。

潜在局限性在于：功能相对单一，仅提供基础格式化而不支持 JSON Schema 验证或复杂查询；存在 10MB 的缓冲区大小限制，无法处理超大 JSON 文件；作为 T3 级个人开发者作品，长期维护能力和代码审查严格度不及企业级项目。

该技能特别适合以下群体：频繁处理 API 返回数据的开发者、需要清洗日志文件的数据工程师、使用 Expanso 生态构建数据处理流水线的工程师，以及需要通过 MCP 协议为 AI 助手添加 JSON 美化能力的系统集成商。

常规使用风险主要包括：对 Expanso Edge 运行时的版本依赖，若运行时环境被篡改可能导致意外行为；尽管当前版本安全，但 T3 来源意味着后续更新需人工审查；大文件处理时可能因内存限制导致失败，建议在处理前进行文件大小检查。

核心用法

json-pretty 是一款极简的 JSON 美化格式化 Skill，专为 Expanso Edge 平台设计。用户可通过三种方式调用：

1. CLI 管道模式：直接通过 bash 管道输入 JSON，即时获得格式化输出
2. MCP 服务器模式：作为长期运行的 Model Context Protocol 服务，供 AI 助手调用
3. 云端部署：一键部署至 Expanso Cloud 实现规模化处理

典型工作流：

echo '{"a":1,"b":2}' | expanso-edge run pipeline-cli.yaml
# 输出：缩进格式化的 JSON

显著优点

• 极致安全：T-MD 分类（纯 Markdown/配置），无任何可执行代码，六维安全扫描全满分
• 零依赖攻击面：不依赖 npm/pip 等任何第三方包，彻底杜绝供应链风险
• 功能透明：声明功能与实际行为完全一致，无隐藏逻辑或数据收集
• 轻量高效：142 行代码，8 个文件，毫秒级响应

局限与适用边界

• 仅支持格式化：无 JSON Schema 验证、无语法修复、无压缩/转义等高级功能
• 输入大小限制：默认 10MB 缓冲区，超大 JSON 可能截断
• T3 来源等级：社区开源项目，虽经安全认证但非企业级商业背书
• 平台锁定：必须配合 Expanso Edge 运行时，无法独立使用

适合人群

• 需要安全、可审计 JSON 处理能力的 AI 工作流开发者
• 对供应链攻击高度敏感的企业安全团队
• Expanso 生态用户寻求即插即用的数据美化工具

常规风险

| 风险类型 | 评估 | 说明 |

|---------|------|------|

| 代码执行 | 无 | 纯 YAML 配置，无脚本 |

| 数据泄露 | 极低 | 仅访问官方域名，TLS 加密 |

| 提示词注入 | 无 | 无 LLM 交互逻辑 |

| 依赖漏洞 | 无 | 零第三方依赖 |

免责声明：静态分析认证不代表运行时绝对安全，建议在受控环境预演。