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 混用。一次导出对应一个画布,不要把一张静态图片当作所有交互已经成立的证据。


第四步:用一张交互表把任务讲完整
确认结构后,再要求 Codex 生成交互说明。说明要覆盖“从哪里来、做什么、发生什么、失败后怎么办”。以下是该练习的目标规则模板;它不代表读取工具已经证明了这些行为。把每行与原型对照,存在就补定位,缺失就转为修改任务。
| 位置与触发 | 条件和目标行为 | 异常与恢复 | 需要核对 |
|---|---|---|---|
| 客户列表点击“远山科技” | 进入对应客户详情,保留列表筛选上下文 | 客户不可用时给返回入口 | 目标页面、返回后筛选是否保留 |
| 详情点击“新增跟进” | 打开表单并显示当前客户 | 只读角色不允许提交 | 角色条件来自规则文档还是仅视觉隐藏 |
| 开启“预约下次联系” | 显示预约时间;关闭时不要求该字段 | 时间未填时定位错误,不清空其他字段 | 显示条件、必填规则和错误提示 |
| 点击保存 | 按约定校验;提交中防重复操作 | 失败后保留输入并允许重试 | 提交中、成功、失败三个状态 |
| 有修改时返回 | 按约定保留草稿或提示放弃 | 取消返回后继续填写 | 是否存在二次确认及对应入口 |
主路径按“列表—详情—表单—保存成功”逐步检查;异常路径分别从空内容、预约时间缺失、保存失败、无权限和中途返回进入。用同一组练习数据跑完,才能判断差异来自状态设计,还是输入变化。模型无法观察的结果,应由人在演示中操作或向产品负责人确认。

第五步:交付说明,同时留下缺口和修改入口
最终交付建议保留三份材料:页面目录、交互说明表、待确认/待补状态清单。每个问题写成“页面+组件+条件+后果+建议动作”,例如:“填写跟进/保存按钮/网络失败/输入可能丢失/补失败提示与重试状态”,比“体验不够顺畅”更容易被设计和研发接手。
现在根据已核对内容生成交互说明。
已观察、人工确认、待确认分列;每行保留画布定位。
不要把推断转为事实。对缺少的失败、返回和权限状态,另列修改清单。
输出按页面排序的 Markdown 表格,便于回到墨刀标注和评审。
如果需要继续改 AI 生成任务,应先查找原任务、确认状态,再决定是否使用 continue_task。这与读取原型是两件事:get_proto_details 不会直接改画布,也不把原型自动转成生产代码。真实接口、服务端权限、存储与性能仍需工程实现和测试。
读取失败或结果不完整,先定位在哪一层
| 现象 | 先检查 | 恢复动作 |
|---|---|---|
| 服务存在但没有工具 | HTTP地址、modao-token Header、环境变量是否被客户端读取 | 刷新/重启后只读查账号;不反复新建任务 |
| 找不到团队里的项目 | 是否本人创建、是否为支持的原型类型、是否重名 | 确认账号与创建者;不要承诺令牌可读所有团队资产 |
| 有目录但内容不对 | project_cid、target_key与画布名称是否匹配 | 回到目录取Key,只重读目标画布 |
| 文字有了,交互说不清 | 原型是否有对应状态/交互,返回是否包含细节 | 补人工演示记录,结论标待确认,不让模型补剧情 |
| PNG链接失效 | 返回有效期与导出画布是否正确 | 重新导出该画布,保存新链接,不重建项目 |
第一次实践只选一条客户跟进流程:读目录、核对一个画布、补齐一张交互表,再回到 墨刀原型 添加标注并分享评审。完成这一小段后,再扩展到其他模块,团队得到的会是一份能继续推进的设计说明。