SuperAPI AI 工具集

pencil-mcp-get-editor-state

智能体与模型

查看项目

更新于 10-15 21:48

技能介绍

用途:该技能用于调用 Pencil 的 MCP 工具 get_editor_state,获取当前设计环境上下文,例如用户当前在画布上选中的内容、画布位置与文档状态,适合在开始任何设计任务前先了解环境。若客户端对 MCP 工具做了命名空间处理,工具可能显示为 mcp__pencil__get_editor_state。

主要能力:返回选中节点的 ID 列表、当前页面 ID(activePageId)以及当前文档路径(filePath)。可选参数 include_schema(布尔值,可选)设为 true 时会在结果中包含 .pen 文件 schema;若已了解 schema,可设为 false(默认)以节省上下文。

使用方式:调用 MCP 工具 get_editor_state,然后分析输出中的 selection、activePageId 与 filePath。资料给出的示例包括基础状态检查、带 schema 的状态获取,以及多步工作流中显式检查状态。

适用场景:需要知道用户在画布上选中了什么、检查活动文档路径、开始新设计任务前定位环境,或用户询问“我在看什么”“获取上下文”时。触发短语包括“获取 Pencil 编辑器状态”“检查 Pencil 当前选区”“Pencil 中选中了什么”“我在 Pencil 画布哪里”等。

限制:仅在用户明确提到“Pencil”或当前对话上下文明确属于 Pencil 设计任务时使用;若意图不明确则不应使用,例如“选中了什么”可能指 IDE 中的文本而非 Pencil 画布。该技能是使用 Pencil 的硬性前提。资料未提供收费、价格、平台支持范围或具体效果等信息。