SuperAPI AI 工具集

balise-affinity-mcp

智能体与模型

查看项目

更新于 10-16 01:29

技能介绍

用途:把 Affinity MCP 当作实时应用控制面,在 Affinity(Canva 旗下)的打开文档上做脚本化操作,遵循“先检查、后小步可逆修改、再验证”的工作流。

主要能力: 读取与检查文档:通过 Document.current 获取标题、路径、会话 UUID、只读与修改状态、页数与跨页数、选中节点数等;文档为空或只读时停止操作。 对象操作:读取 doc.selection 与 doc.selection.nodes,设置 node.userDescription,执行选择全部 doc.selectAll(false)、删除 doc.deleteSelection(selection)、显隐与锁定,以及用 doc.addNode(def, doc.currentSpread) 在当页新建节点。 几何与外观:用 ShapeNodeDefinition 加 ShapeRectangle/ShapeEllipse 创建基本形状;用 CurveBuilder 与 PolyCurve 建精确路径;用 RGBA8、FillDescriptor.createSolid/createNone 与 linestyle 控制填充、描边和线型。 文本:当前 SDK 中 FrameTextNodeDefinition/ArtTextNodeDefinition/TextNodeDefinition 的 createDefault 不可用,改用 StoryBuilder 配合 createFromStoryBuilder,设置字形、段落、填充与字距;characterSpacing 为类似 em 的小值。 文档功能:使用 DocumentCommand.createAddGuide 添加参考线、setSpreadSizeWithAnchor 调整尺寸、undo/redo 与导出配置;生成图像、去背景、选择主体、生成式编辑等命令可能受 Affinity 设置限制,需报告 NOT_ALLOWED。 验证:视觉结果用 render_selection(document_session_uuid) 检查,整体版面优先用 render_spread,避免全选引入 UI 选择框干扰。

使用方式:先加载 Affinity 工具,按顺序读 preamble、list_sdk_documentation,再读所需主题;修改前先检查文档,选择最小范围编辑,通过 execute_script 执行脚本,用 console.log(JSON.stringify(...)) 输出可观察结果;未获用户要求时不保存、导出、合并、删除大范围选择或调整跨页尺寸。

适用场景:Affinity 文档内的对象、图层、几何、文本、颜色、填充与描边自动化,以及海报/版面复刻等基于上述原语的应用。

限制:资料未提供安装命令、收费与平台信息;部分功能受 Affinity 设置限制;需注意文本裁剪、未保存状态与选择状态等风险。