墨刀双十一 会员低至3.7折 限时加赠 15000 AI积分 立即前往 arrow

Codex 怎么读懂墨刀原型?从页面结构到交互说明的实操

文章目录
免费使用墨刀
更新时间: 2026年11月06日

Codex 可以通过墨刀 AI MCP 读取已有原型的目录、布局、文字、组件和交互,再帮你整理流程与交互说明。实际接手时,按“找到项目—选定画布—读取结构—核对状态—输出说明”推进,比直接要求“总结整个原型”更可靠。先接入 墨刀 AI MCP,从一个关键页面开始;读取本身不会修改原型,也不等于已经验证了接口、权限或业务规则。

客户跟进原型中的结构事实、交互事实、推断与待确认问题
先区分证据类型,再整理交互说明。

先准备一份能被准确接手的原型

下面用一个“客户跟进”设计练习贯穿过程:销售从客户列表进入详情,填写跟进记录,必要时预约下次联系。预设页面为客户列表、客户详情、填写跟进和保存结果;关注销售与只读访客两种角色。客户“远山科技”、跟进人“林悦”和示例日期只用于说明字段,不是客户数据或实际工具返回。

读取前,先写清三个边界:本轮只理解已有设计,不新建生成任务;只处理客户跟进相关画布,不扫描无关项目;找不到的状态一律记为“待确认”,不根据行业习惯补成既有规则。页面命名不必完美,但最好能区分默认、空、错误和只读状态。

请用墨刀 MCP 读取我创建的“客户跟进”原型。
目标:理解销售填写跟进记录的主路径和异常路径。
本轮只读,不新建、不修改、不导入。
先列出候选项目让我确认;随后读取页面目录,只分析客户列表、详情和跟进表单。
输出时分开写:工具返回的事实、你的推断、需要我确认的问题。

第一步:接入 MCP,先确认连接的是谁

登录墨刀 AI,在头像菜单的“令牌设置”创建个人空间令牌。Codex 使用远程 Streamable HTTP 服务;在启动 Codex 的环境中设置 MODAO_TOKEN,将下面配置加入用户目录的 .codex/config.toml。令牌不要写进项目、提示词或截图。

[mcp_servers.modao]
url = "https://modao.cc/agent-py/ai/mcp"
env_http_headers = { "modao-token" = "MODAO_TOKEN" }

Windows CLI 可在启动 Codex 的同一个 PowerShell 会话中设置临时变量,再启动客户端:

$env:MODAO_TOKEN = "替换为自己的令牌"
codex

上面的变量只对当前终端及其启动的进程生效;桌面客户端则在 Windows 用户环境变量中设置 MODAO_TOKEN,完全退出后重新打开,再核对工具状态。

重启后,CLI 可运行 codex mcp list;在 Codex 终端会话中用 /mcp查看服务状态。接着让 Codex 调用 get_account_status,核对令牌绑定账号与默认空间。列表里有服务但调用失败,仍不算连接成功;先修连接,不要用“新建原型”来试探。

第二步:找准项目,再缩小到一个画布

让 Codex 用 list_created_prototypes 按项目名查找,并核对空间和更新时间。它的查询范围是当前账号本人创建的 proto2 原型,不是所有能打开的团队项目。遇到重名项目,先确认项目链接;不要凭第一个结果继续。

确认后,把返回的 project_cid 交给 get_proto_details,先读页面与画布目录,再用 target_key 读取“填写跟进”的具体内容。先目录、后局部,能够减少相似画布混淆,也便于发现模型漏掉的错误或只读状态。

这一步要拿到什么核对方法不合格时怎么做
正确项目与空间名称、空间、更新时间与墨刀中看到的一致补空间名或项目链接,重新定位
页面/画布目录与 Key目录能对应列表、详情、表单和结果页保留原始目录,不让模型重命名后丢失关联
目标画布的结构标题、字段、按钮、组件与页面一致换正确 target_key,只重读该画布
先输出原始页面/画布名称及对应 Key,不改名。
读取“填写跟进”画布后,列出可见字段、按钮、组件和交互。
每条结论附页面或画布定位;没有返回的信息写“未观察到”。
暂不补充业务规则,也不生成交互文档全文。

第三步:把“看见了什么”和“认为应该怎样”分开

模型很容易把“页面上有预约开关”扩写成“开启后预约时间必填”,但前者是元素事实,后者需要交互或规则证据。客户跟进练习可以按下表记录。表中的内容是整理方式示例,使用时应替换为你的工具返回与人工复核结果。

信息类型客户跟进示例说明中怎样写
已观察的结构画布包含跟进方式、内容、预约开关、保存按钮按原名称记录,并附画布定位
已观察的交互若返回显示点击保存跳到成功状态写触发与目标;没有返回则不写成确定跳转
合理推断开启预约后可能需要选择下次联系时间标为建议规则,不能写“系统会要求”
待确认问题保存失败是否保留输入、只读角色能否看到保存按钮指定确认人和需查看的状态

结构能说明页面由什么组成,截图更适合核对视觉和层级。需要图像对照时,先从目录取得画布 Key,将 project_cid 和 canvas_key 交给 export_proto_to_png 导出指定画布,留意返回的链接有效期。这里的 canvas_key 不要与 get_proto_details 局部读取使用的 target_key 混用。一次导出对应一个画布,不要把一张静态图片当作所有交互已经成立的证据。

墨刀MCP说明页中的原型读取和PNG画布导出参数
原型读取与画布导出使用的参数不同。
墨刀原型中的页面目录、选中组件和页面连线
墨刀官方旅行 App 示例:用页面目录、组件选区与连线核对对象定位。

第四步:用一张交互表把任务讲完整

确认结构后,再要求 Codex 生成交互说明。说明要覆盖“从哪里来、做什么、发生什么、失败后怎么办”。以下是该练习的目标规则模板;它不代表读取工具已经证明了这些行为。把每行与原型对照,存在就补定位,缺失就转为修改任务。

位置与触发条件和目标行为异常与恢复需要核对
客户列表点击“远山科技”进入对应客户详情,保留列表筛选上下文客户不可用时给返回入口目标页面、返回后筛选是否保留
详情点击“新增跟进”打开表单并显示当前客户只读角色不允许提交角色条件来自规则文档还是仅视觉隐藏
开启“预约下次联系”显示预约时间;关闭时不要求该字段时间未填时定位错误,不清空其他字段显示条件、必填规则和错误提示
点击保存按约定校验;提交中防重复操作失败后保留输入并允许重试提交中、成功、失败三个状态
有修改时返回按约定保留草稿或提示放弃取消返回后继续填写是否存在二次确认及对应入口

主路径按“列表—详情—表单—保存成功”逐步检查;异常路径分别从空内容、预约时间缺失、保存失败、无权限和中途返回进入。用同一组练习数据跑完,才能判断差异来自状态设计,还是输入变化。模型无法观察的结果,应由人在演示中操作或向产品负责人确认。

客户跟进主路径以及预约时间未填、保存失败和中途返回的恢复
异常分支写清下一步,恢复后保留已填写内容。

第五步:交付说明,同时留下缺口和修改入口

最终交付建议保留三份材料:页面目录、交互说明表、待确认/待补状态清单。每个问题写成“页面+组件+条件+后果+建议动作”,例如:“填写跟进/保存按钮/网络失败/输入可能丢失/补失败提示与重试状态”,比“体验不够顺畅”更容易被设计和研发接手。

现在根据已核对内容生成交互说明。
已观察、人工确认、待确认分列;每行保留画布定位。
不要把推断转为事实。对缺少的失败、返回和权限状态,另列修改清单。
输出按页面排序的 Markdown 表格,便于回到墨刀标注和评审。

如果需要继续改 AI 生成任务,应先查找原任务、确认状态,再决定是否使用 continue_task。这与读取原型是两件事:get_proto_details 不会直接改画布,也不把原型自动转成生产代码。真实接口、服务端权限、存储与性能仍需工程实现和测试。

读取失败或结果不完整,先定位在哪一层

现象先检查恢复动作
服务存在但没有工具HTTP地址、modao-token Header、环境变量是否被客户端读取刷新/重启后只读查账号;不反复新建任务
找不到团队里的项目是否本人创建、是否为支持的原型类型、是否重名确认账号与创建者;不要承诺令牌可读所有团队资产
有目录但内容不对project_cid、target_key与画布名称是否匹配回到目录取Key,只重读目标画布
文字有了,交互说不清原型是否有对应状态/交互,返回是否包含细节补人工演示记录,结论标待确认,不让模型补剧情
PNG链接失效返回有效期与导出画布是否正确重新导出该画布,保存新链接,不重建项目

第一次实践只选一条客户跟进流程:读目录、核对一个画布、补齐一张交互表,再回到 墨刀原型 添加标注并分享评审。完成这一小段后,再扩展到其他模块,团队得到的会是一份能继续推进的设计说明。

免费在线原型设计工具

内容丰富组件拖拽即用

多人在线编辑实时协作

海量模板素材快速复用

一键分享交付在线评论互动