JSON画布工具

创建和编辑JSON Canvas文件，支持节点、边、分组和连接管理，适用于API集成和自动化工作流场景。

核心功能: 本技能提供中文交互、、格式互转、内容提取时使用、化工作流场景等能力。

Json Canvas

专业版增值服务

能力	免费版	付费版
基础功能	支持	支持
Json Canvas创建编辑	不支持	支持
大数据集流式处理	不支持	支持
多数据源关联查询	不支持	支持
可视化图表自动生成	不支持	支持
定时数据同步与增量更新	不支持	支持

主要能力

• Create and edit JSON Canvas files (
• canvas) with nodes, edges, groups, and connections

部署说明

1. 确认运行环境满足依赖说明中的要求
2. 在AI Agent对话中调用本技能,提供必要的输入参数
3. 检查输出结果,根据需要进行后续处理

详细的输入输出格式请参考下方章节说明。

场景示例

场景	输入	输出
画布创建	节点类型和连接关系	JSON Canvas格式文件
画布编辑	现有.canvas文件和修改	编辑后的画布和节点结构
节点管理	节点ID和属性	节点增删改和边连接

不适用于：非Canvas格式的可视化文件编辑(如SVG/PSD)

输入规范

参数名	类型	必填	说明
canvas_path	string	否	Canvas文件路径, 新建时留空
node_type	string	否	节点类型, 可选: text/group/file/link, 默认: text

响应格式

json

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

依赖与配置

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux

工具依赖

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

可用性分类

• 分类: MD+execute()
• 说明: 基于Markdown的AI Skill,

API Key配置方式:

bash

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

疑问汇编

Q1: 如何开始使用Json Canvas？

A: 请参考使用流程和依赖说明章节，确保运行环境满足要求后调用本技能。

异常处置

错误场景	原因	处理方式
LLM响应超时或无响应	网络延迟或模型负载过高	请求重试；确认Agent平台LLM服务正常
输入内容格式不正确	用户输入不符合skill预期格式	检查输入是否符合skill使用说明中的格式要求，参考示例章节
执行结果与预期不符	指令描述不够明确或上下文不足	提供更详细的指令描述，补充必要的上下文信息
命令执行失败	运行环境不满足要求或权限不足	确认运行环境符合依赖说明中的要求；检查命令权限设置

限制条件

• 需要API Key，无Key环境无法使用

创新特色

效率提升量化分析

操作步骤	手动耗时	自动化耗时	时间节约	准确率提升
创建画布	30分钟	5分钟	25分钟	10%
编辑节点	1小时	10分钟	50分钟	15%
添加连接	20分钟	3分钟	17分钟	12%
导出文件	15分钟	1分钟	14分钟	10%
数据同步	2小时	30分钟	1.5小时	20%

差异化对比

对比维度	本技能	手动操作	Python脚本	专业软件
易用性	高	低	中	高
功能丰富度	高	低	中	高
适应场景	广泛	有限	有限	专业
成本	低	高	中	高
学习曲线	低	高	中	高

核心痛点解决

痛点	描述	影响范围	解决方案	量化效果
手动操作效率低	人工操作耗时且容易出错	影响工作效率和准确性	自动化操作，提高效率和准确性	提升效率20%，减少错误率15%
数据同步困难	数据在不同系统间同步复杂，易出错	影响数据一致性	提供自动化数据同步功能	提升数据一致性90%
画布编辑复杂	画布编辑需要专业知识，操作复杂	影响普通用户使用	提供可视化编辑界面，降低使用门槛	提升用户满意度30%

常见问题FAQ

Q2: Json Canvas支持哪些类型的节点？

A: Json Canvas支持文本、分组、文件和链接类型的节点。

Q3: Json Canvas可以与哪些系统进行集成？

A: Json Canvas可以与需要API集成、接口对接、Webhook配置、系统连接的场景进行集成。

Q4: Json Canvas是否支持多人协作？

A: Json Canvas目前不支持多人实时协作，但支持将编辑后的文件共享给其他用户。

Q5: Json Canvas的付费版相比免费版有哪些优势？

A: 付费版提供了Json Canvas创建编辑、大数据集流式处理、多数据源关联查询、可视化图表自动生成和定时数据同步与增量更新等功能，能够满足更高级别的需求。

安全规范

1. 确保API Key安全，避免泄露到版本控制系统。
2. 对敏感数据进行加密处理，防止数据泄露。
3. 定期更新运行环境，确保系统安全。
4. 对用户输入进行验证，防止恶意操作。
5. 使用HTTPS协议进行数据传输，确保数据安全。

安全风险防范

风险项	等级	防护措施	验证方法
API密钥泄露	高	通过环境变量配置，禁止硬编码	定期检查代码和配置文件
命令执行风险	高	仅执行白名单命令，避免拼接用户输入	使用沙箱环境测试
网络通信安全	中	使用HTTPS协议，验证SSL证书	定期检查证书有效期
敏感数据暴露	高	输出结果中不包含密钥、令牌等敏感信息	日志脱敏审查
未授权访问	中	限制访问权限，实施认证机制	定期审计访问日志

功能特性总览

• 自动化执行: 创建编辑JSON Canvas文件,含节点/边/分组/连接。Create and edit JSON Canvas fi
• 文件处理: 支持多种文件格式的读取、解析和写入操作
• API集成: 通过标准化接口调用外部服务并处理响应
• 命令执行: 在安全沙箱中执行系统命令并收集结果
• 信息检索: 快速搜索和过滤目标数据

故障处理方案

针对JSON画布工具使用中可能遇到的常见问题,提供以下排查方案:

错误类型	原因分析	解决方案
API认证失败(401)	API密钥错误或过期	检查密钥配置,重新生成token
接口限流(429)	请求频率超出限制	降低调用频率,启用重试退避策略
响应超时(504)	网络延迟或服务端负载过高	增加超时阈值,检查网络连接
文件不存在	路径错误或文件未创建	检查路径拼写,确认文件已生成
文件格式不支持	扩展名不在支持列表中	转换为支持的格式后重试
权限不足	当前用户无读写权限	检查文件权限,以管理员身份运行
命令执行失败	参数错误或环境依赖缺失	检查命令语法,确认依赖已安装
进程超时	命令执行时间过长	增加超时设置,优化命令参数
网络连接失败	DNS解析失败或防火墙拦截	检查网络配置,确认代理设置

JSON画布工具通用排查步骤

1. 检查输入参数: 确认所有必填参数已提供且格式正确
2. 查看日志输出: 定位具体错误行和异常类型
3. 验证环境配置: 确认依赖库版本和运行环境满足要求
4. 逐步调试: 缩小问题范围,隔离故障模块

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent
• 操作系统: Windows / macOS / Linux

可用性分类

• 分类: MD（纯Markdown指令，通过自然语言驱动Agent完成操作）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作。