
return_rp
io.github.karlmoriaty/return_rp
Axure RP 9/11 toolkit and MCP server: read, edit, and generate native .rp projects.
Documentation
给 AI 一张自由画布。
把设计带回 Axure。
用 RP/1 写下设计,让 AI 起稿、你来精修,交付可继续编辑的 .rp。
Axure RP 9 / RP 11 · AI 原生画布 · CLI 与 MCP
栖羽 / QIYU 从探索、鸟种详情,到留下自己的观鸟手记。
9 页原生原型示例 · 文字、按钮与输入保留为独立元件 · 识别与统计使用演示数据 · 素材与案例说明
00 30 秒了解 return_rp
一句话:把截图、需求描述或 RP/1 源码,变成可继续编辑的 Axure 原生工程,而不是一张原型截图。
| 你给它 | 它交给你 |
|---|---|
| 一张截图、一段需求、一份 PRD,或一份 RP/1 源码 | 原生 .rp、浏览器预览、HTML / CSS / JS 导出,以及检查报告 |
AI 起稿,人来定稿:
| AI 起稿 | 人来精修 | 原生交付 |
|---|---|---|
| 用自然语言或 RP/1 生成多页流程,按图层与语义局部改稿。 | 在 Studio 里双击改字、框选、拖拽、测距、撤销重做。 | 文字、按钮与输入框保持独立元件,在 Axure 中继续编辑。 |
它不是又一个 UI 生成器:
| 对比项 | 多数截图转代码工具 | return_rp |
|---|---|---|
| 输出物 | HTML、图片或不可编辑稿 | 原生 .rp,也可导出 HTML / CSS / JS |
| 设计源码 | 一次性生成,难以 diff 与回改 | RP/1 文本源码,可版本管理、按图层局部修改 |
| Agent 协作 | 往往只能整页重来 | 按图层、语义与范围查询,改具体对象 |
| Axure 版本 | 通常只覆盖一个版本 | RP 9 / RP 11 双向能力对齐 |
| 验证方式 | 看截图 | 结构检查 + 浏览器交互 + Axure 保存重开 / 预览 |
01 一条链路,从想法到 Axure。
- 把意图写成源码。 截图走临摹管线,需求与 PRD 直接写成 RP/1;页面、组件、变量、交互都在同一份文本里。
- 在画布里推敲。 Agent 搭第一版,你直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。
- 在交付前验证。 真实截图、交互场景、结构检查分别运行,确认跳转、状态与保存回显。
- 带回 Axure。 生成原生工程,或导出浏览器可运行版本;继续编辑、继续迭代。
02 在画布里,把设计推敲到位。
Studio 是一块 AI 和人都能编辑的自由画布。让 Agent 搭好第一版,再直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。
AI 起稿。 RP/1 或命令创作,按图层、语义和范围查询,局部改稿。
人来精修。 双击改字、Shift 框选、Option / Alt 悬停测距,撤销重做。
一起验证。 查看真实截图、运行交互场景,再交付原型。
03 设计意图,有自己的源码。
RP/1 把页面、布局、组件、变量和交互写在一起。AI 改动有明确目标,设计也能保留结构、版本和继续迭代的起点。
rp/1 target=9 name="下一次相遇" domain=mobile theme=mobile-hifi
page #home name="发现" device=iphone-17-pro
phone-shell #shell title="去自然里,遇见飞羽。" gap=16
card #bird [fillxhug] title="今天,认识一只翠鸟" body="从水边的一抹蓝绿,开始你的观鸟手记。" actionText="记下这次遇见" goto="notes"
page #notes name="手记" device=iphone-17-pro
phone-shell #shell title="我的第一篇手记" gap=16
input #note [fillx44] value="今天在水边遇见了它。"
button #back [fillx44] "返回发现" goto="home"
从一个页面到完整流程,revise_prototype 继续改稿;已有原生修改也能在支持范围内合并回源码。
04 交到 Axure,仍然握得住设计。
生成原生 .rp,在 Axure 中继续修改支持的文字、控件和布局。页面、变量、动态面板与跳转可以一起交付,源稿、预览和检查报告也一并保留。
| 从哪里继续 | 可以做什么 |
|---|---|
| Studio | 和 AI 共用设计文档、事务与撤销历史 |
| Axure | 打开原生工程,继续编辑元件与支持的交互 |
| 浏览器 | 运行预览;也可导出独立 HTML / CSS / JS |
| 交付物 | 说明 |
|---|---|
原生 .rp | 默认目标 RP 11;target=9 或 AXURE_TARGET_VERSION=9 切到 RP 9 |
| 浏览器预览 | 真实交互场景,可复现点击、跳转与状态变化 |
| 代码导出 | 独立 HTML / CSS / JS,便于评审或嵌入 |
| 结构与验收报告 | 三零检查(未解析记录、悬空引用、问题数均为 0)、浏览器断言与 Axure 往返结果分开记录 |
05 RP 9 与 RP 11,走同一条流水线。
两个版本共用同一套 CLI、MCP 与 Studio。任一版本能做的事,另一版本不会以 unsupported 收场;缺口必须登记,并在运行时告警或写入前明确诊断,绝不静默丢参数。
| 能力 | RP 9 | RP 11 |
|---|---|---|
| RP/1 原生编译与场景写入 | 支持 | 支持 |
| 空白模板检测、裁剪与动态面板克隆 | 支持 | 支持 |
| 原生表单控件与状态样式 | 支持 | 支持 |
| 原生中继器与数据操作 | 支持 | 支持 |
| 核心交互、动作与自适应视图 | 支持 | 支持 |
| Studio 局部 RP/1 创作 | 支持 | 支持 |
| 自动 Axure 预览(Swift / PowerShell 宿主) | 支持 | 支持 |
| 图片离线生成原生工程 | 支持 | 支持 |
已登记的边界集中在以下几处:RP 11 没有面板注册链模型;RP 9 的缩放锚点、切换启用、应用样式与 RP 11 专属事件/函数没有对应结构,写入前显式诊断;RP 9 的过滤组合类型与按行号删除中继器行按等价规则改写,标记为部分支持。
开始使用
| 依赖 | 版本 | 用途 |
|---|---|---|
| Node.js | 18+ | CLI、MCP、Studio 与测试 |
| Python | 3.10+ | 原生编译与图片处理 |
| Axure | RP 9 或 RP 11 | 原生生成、保存重开与自动预览(可选) |
git clone https://github.com/karlmoriaty/AxurePR-return-rp.git
cd AxurePR-return-rp
python3 -m venv .venv
source .venv/bin/activate
python -m pip install -r requirements.txt
npm ci
Windows PowerShell:
git clone https://github.com/karlmoriaty/AxurePR-return-rp.git
cd AxurePR-return-rp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
npm ci
也可以直接从 Releases 下载 return_rp-<version>-share.zip,解压后在目录内执行 npm ci --ignore-scripts。分享包不含测试与私有素材;原生生成仍需要本机 Axure 和一份你自己保存的空白工程。
只用 CLI / MCP 时,也可以直接从 npm 运行,无需克隆仓库(原生生成与图片处理仍需要上面的 Python 依赖):
npx -y -p return_rp return_rp --help
npx -y -p return_rp return_rp-mcp
MCP 客户端配置可以直接写 "command": "npx", "args": ["-y", "-p", "return_rp", "return_rp-mcp"]。
MCP 工具列表依赖可选依赖
@modelcontextprotocol/sdk(npm ci会一并安装)。只跑 CLI 不装也能用;缺少依赖时 MCP 启动会提示在项目目录执行npm ci --ignore-scripts,而不是静默返回空工具列表。
连接你的 MCP 客户端 · 展开配置
将下面的绝对路径换成自己的安装目录、Python 环境和空白工程:
{
"mcpServers": {
"return_rp": {
"command": "node",
"args": ["/absolute/path/AxurePR-return-rp/bin/mcp.mjs"],
"env": {
"PATH": "/absolute/path/AxurePR-return-rp/.venv/bin:/usr/local/bin:/usr/bin:/bin",
"AXURE_BLANK_TEMPLATE_RP9": "/absolute/path/my-rp9-blank.rp",
"AXURE_BLANK_TEMPLATE_RP11": "/absolute/path/my-rp11-blank.rp"
}
}
}
}
PATH 应包含安装了依赖的 Python;Node 不在默认路径时,command 也使用绝对路径。空白工程用你自己在对应版本 Axure 中保存的单页文件;只用一个版本时,保留对应的 AXURE_BLANK_TEMPLATE_RP9 / RP11 即可。安装更新后重新连接 MCP。
接好后,调用 studio_open_project,在浏览器打开返回的 url:
{ "projectDir": "/absolute/path/my-first-prototype" }
然后把任务交给 Agent:
做一个观鸟 App,包含探索、鸟种详情和手记。先在画布里设计,验证跳转和保存回显,再导出可编辑的
.rp。
给 Agent 的入口与运行边界
Agent 从 studio_describe({"topic":"workflow"}) 开始。导入已有 RP/1 可为 studio_open_project 指定 sourcePath;完整原生生成使用 generate_prototype。截图临摹走 generate_from_image 或 scripts/trace.mjs,局部创作和完整编译的支持范围分别记录。
原生生成默认目标 RP 11,也可用 target=9 或 AXURE_TARGET_VERSION=9 切到 RP9。宿主证据覆盖 macOS + Axure RP9,以及 Windows + Axure RP9 / RP11(GUI 保存重开与预览往返)。部分效果采用嵌入位图,字体和预览可能受宿主影响。任意小数缩放清晰度、单画板海量节点仍有边界。
结构检查、浏览器行为与 Axure 保存重开分别验证。能力范围 · RP9 / RP11 能力对齐 · 验收层级 · 故障排查
常见问题
必须安装 Axure 吗?
不必须。只使用 Studio、浏览器预览或代码导出时,Node.js 与 Python 依赖就够了。生成原生 .rp、离线图片工程、保存重开与自动预览需要本机 Axure;首次使用请自己保存一份单页空白工程,并通过 AXURE_BLANK_TEMPLATE_RP9 / AXURE_BLANK_TEMPLATE_RP11 指定。
Windows 上能用吗?
可以。Windows 走 PowerShell 宿主,RP 9 / RP 11 都已实测打开、保存命令、关闭、重开与预览;macOS 走 Swift 宿主。GUI 相关能力需要桌面会话和本机 Axure,无桌面会话的服务器环境只能使用非 GUI 部分。
MCP 连上了,为什么工具列表是空的?
通常是缺少可选依赖 @modelcontextprotocol/sdk。在项目目录执行 npm ci --ignore-scripts,重启或重连 MCP 客户端。启动时会给出明确提示,不会静默返回空列表。
为什么宿主返回 `saved: false`?
Axure 对未修改的文档可能跳过写盘。此时宿主如实返回 saved: false,并单独记录 saveCommandIssued: true;任务验收以保存命令已执行为准,是否真正写入由文件 mtime 判断。这比把保存键一律当成成功更接近真实行为。
生成的原型能 100% 还原设计吗?
文字、按钮、输入框与布局会写成独立原生元件,支持的交互一起交付。部分视觉效果使用嵌入位图;字体、预览与渲染受宿主影响;任意小数缩放的清晰度、单画板海量节点也有边界。建议按「结构检查 → 浏览器行为 → Axure 保存重开」三层分别验收。
默认生成哪个 Axure 版本?
默认 RP 11。需要 RP 9 时在 RP/1 头部写 target=9,或设置 AXURE_TARGET_VERSION=9。两个版本共用同一批 CLI / MCP 工具。
项目结构
| 目录 | 作用 |
|---|---|
bin/ | return_rp CLI 与 return_rp-mcp MCP 入口 |
scripts/ | RP/1 编译、原生装配、宿主往返、截图临摹与发布工具 |
studio/ | Studio 画布前端与本地服务 |
references/ | RP/1 语言、能力边界、工作流与故障排查手册 |
examples/ | 可直接运行的 RP/1 与场景示例 |
test/ | 结构、浏览器、版本对齐与跨平台回归 |
docs/ | 设计流程、验收层级与版本对齐说明 |
Node 源码以 TypeScript(*.mts / studio/web/*.ts)编写,npm run build 生成同路径 .mjs / .js;仓库与发布包同时包含源码和生成后的运行时文件,直接使用不需要先构建。
Agent Skill / 贡献指南 / 变更记录 / Releases / MIT License
问题反馈
- 原作者 / 维护者:karlmoriaty(GitHub:github.com/karlmoriaty)
- 问题反馈:GitHub Issues 或 QQ 邮箱:3070687583@qq.com
- 如果这个项目帮你省下了画原型的时间,欢迎 Star、分享给同事,或带着真实案例来提 Issue。
由 karlmoriaty 独立开发 · 与 Axure 无隶属关系 · 第三方案例照片按各自许可与署名使用
return_rpnpm install return_rp