Repository avatar
Other Tools
v1.4.5
active

return_rp

io.github.karlmoriaty/return_rp

Axure RP 9/11 toolkit and MCP server: read, edit, and generate native .rp projects.

Documentation

return_rp · AI-native canvas. Editable Axure RP 9 / RP 11 output.

给 AI 一张自由画布。
把设计带回 Axure。

用 RP/1 写下设计,让 AI 起稿、你来精修,交付可继续编辑的 .rp。

Axure RP 9 / RP 11 · AI 原生画布 · CLI 与 MCP

开始使用 · 30 秒了解 · Studio · RP/1 · 版本对齐 · 常见问题 · English

Release Checks Axure RP 9 | 11 MIT


栖羽 QIYU:由 return_rp 生成的探索首页、鸟种详情和观鸟手记,完整案例共九页

栖羽 / 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。

工作流:需求或截图 → RP/1 源码 → Studio 画布 → 原生 .rp → Axure 与浏览器
  1. 把意图写成源码。 截图走临摹管线,需求与 PRD 直接写成 RP/1;页面、组件、变量、交互都在同一份文本里。
  2. 在画布里推敲。 Agent 搭第一版,你直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。
  3. 在交付前验证。 真实截图、交互场景、结构检查分别运行,确认跳转、状态与保存回显。
  4. 带回 Axure。 生成原生工程,或导出浏览器可运行版本;继续编辑、继续迭代。

02 在画布里,把设计推敲到位。

Studio 是一块 AI 和人都能编辑的自由画布。让 Agent 搭好第一版,再直接点选、改字、调整布局;也可以把局部交还 AI,继续探索另一种构图。

真实 Studio 界面:另一版栖羽设计、独立图层、文字选择框与可编辑的位置尺寸属性

AI 起稿。 RP/1 或命令创作,按图层、语义和范围查询,局部改稿。
人来精修。 双击改字、Shift 框选、Option / Alt 悬停测距,撤销重做。
一起验证。 查看真实截图、运行交互场景,再交付原型。

画室工作流 ↗ AI 创作指南 ↗ 验收层级


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 继续改稿;已有原生修改也能在支持范围内合并回源码。

RP/1 手册 ↗ 完整示例 ↗ 原生往返


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 9RP 11
RP/1 原生编译与场景写入支持支持
空白模板检测、裁剪与动态面板克隆支持支持
原生表单控件与状态样式支持支持
原生中继器与数据操作支持支持
核心交互、动作与自适应视图支持支持
Studio 局部 RP/1 创作支持支持
自动 Axure 预览(Swift / PowerShell 宿主)支持支持
图片离线生成原生工程支持支持

已登记的边界集中在以下几处:RP 11 没有面板注册链模型;RP 9 的缩放锚点、切换启用、应用样式与 RP 11 专属事件/函数没有对应结构,写入前显式诊断;RP 9 的过滤组合类型与按行号删除中继器行按等价规则改写,标记为部分支持。

完整能力矩阵 ↗ 能力与验证边界 ↗ 故障排查


开始使用

依赖版本用途
Node.js18+CLI、MCP、Studio 与测试
Python3.10+原生编译与图片处理
AxureRP 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 无隶属关系 · 第三方案例照片按各自许可与署名使用

NPM
return_rp
Install Command
npm install return_rp