Repository navigation
Releases
v1.4.4 — TypeScript 运行时迁移与 Windows 全功能验证
1.4.4
本版本将 Node 运行时源码迁移到 TypeScript,CLI、MCP、Studio 的入口与调用方式保持不变。
主要变化
bin、scripts、studio、test、benchmarks、examples、tools的源码改为.mts,构建生成同路径.mjs;Studio 前端改为app.ts。- 新增
build.mjs/tsconfig.json,npm install自动构建,CI 校验生成物未过期。 - 修复 Windows 上参考包与标杆文件因 CRLF 被误判为漂移的问题:文本按 LF 归一化比对,二进制保持原始字节。
- 修复
studio-sync-native向 Python 子进程传入 Windows 不可用路径的问题;依赖 POSIX 进程组的异步用例按平台跳过,同步流程完整保留。 - 修复 Studio 异步操作测试在 win32 上泄漏服务的问题。
验证结果
npm test:20/20npm run test:parity:23/23npm run test:studio-ai:153 项,147 通过、0 失败、6 项平台跳过- 15 个 Studio 套件及其余非 GUI 门禁全部通过
- 重复执行
node build.mjs后工作区差异保持不变 - 分享包实测:
npm ci --ignore-scripts后 CLI 正常,MCP 注册 87 个工具,版本报告 1.4.4
使用
npm ci --ignore-scripts
node bin/mcp.mjs # MCP 服务
node bin/axure.mjs --help附件 return_rp-1.4.4-share.zip 为不含测试与私有素材的分享包,解压后同样先执行 npm ci --ignore-scripts。原生生成仍需本机安装 Axure 并提供空白工程模板。
1.3.4 — RP 9 / RP 11 对齐收尾
1.3.4
- 收尾版本:能力矩阵中已无任一方向
unsupported,RP 9 / RP 11 的自动预览、图片离线生成、中继器动作、表单状态样式、Studio 局部创作和 CLI / MCP 入口按同一接口提供。 - 预览文档补齐平台边界:Windows 宿主如实区分「保存命令已执行」与「文件实际写入」,未修改文档被 Axure 跳过写盘时不再记为保存成功。
docs/version-parity.md验证清单加入test/parity-check.mjs,跨平台 baseline 校验与其余对齐检查一起作为发布门禁。- 发布包与分享包重新生成,manifest 覆盖 Windows 宿主脚本与预览测试。
附件 return_rp-1.3.4-share.zip 为分享包,解压后 npm ci --ignore-scripts 即可使用 CLI/MCP。
1.3.3 — 跨平台基线校验
1.3.3
- 修复
test/parity-check.mjs在 Windows 上整批误报内核脚本 SHA 不符:baseline 按 LF 归一化后的源码内容比对,二进制对拍仍使用原始字节。 test/baseline-policy.json的脚本数量从 64 更新为 65,与test/baseline-shas.json及scripts/*.mjs实际数量一致。
附件 return_rp-1.3.3-share.zip 为分享包,解压后 npm ci --ignore-scripts 即可使用 CLI/MCP。
1.3.2 — Windows 原生宿主往返与预览
1.3.2
- Windows 原生宿主:新增
scripts/axure-host.ps1,自动完成打开自有副本 → 保存 → 关闭 → 重开 → F5 预览,并按端口与start.html内容确认预览归属;RP 9 与 RP 11 均已实测往返与预览。 - MCP
gui_roundtrip任务支持 Windows,与 macOS 共用同一套阶段标记、队列与失败清理;host.platform记录宿主平台。 - 自动 Axure 预览在两版均登记为
supported,删除 RP 11 缺口与诊断证据。 - 修复宿主「保存」误报:
saved只有文件确实写入才为真;未修改文档被 Axure 跳过写盘时返回saved:false并记录saveCommandIssued,任务验收以保存命令已执行为准。 - 新增
test/axure-preview-windows-check.mjs(npm run test:preview-windows),两版各跑一次真实宿主往返与预览,缺宿主时 SKIP。
附件 return_rp-1.3.2-share.zip 是去掉测试与 fixture 的分享包,解压后 npm ci --ignore-scripts 即可使用 CLI/MCP。
1.3.1 — 修复分享包缺模块 + import 闭包守卫
1.3.1
修复
- 轻量分享包漏发 scripts/trim-to-single-page.mjs;create-blank-project.mjs 引用它,缺文件会让 CLI 与 MCP 启动直接 ERR_MODULE_NOT_FOUND(客户端表现为“无法取得工具列表”)。
- gen-capabilities.mjs 从未导出的 runRegression 导入;改为读取 test/historical-regression.mjs --json 的公开输出。
- 示例 build-native-demo.mjs 改用 scripts/version.mjs 的 libraryFile,分享包不再引用 test/。
防护
- packRelease / packShare 打包前做相对 import 闭包校验;回归新增第 20 项,分享包已验证 bin/axure.mjs 可启动。
下载说明
- 源码包:GitHub 自动生成的 Source code (zip)。
- 轻量包 return_rp-1.3.1-share.zip:不含 test/、benchmarks/、CI 配置与 .rp 样本,闭包校验通过。
- MCP 工具列表需要可选依赖:在解压目录执行 npm ci --ignore-scripts;只用 CLI 可以不装。
本机验证:parity 10/10,回归 20/20。
1.3.0 — RP 11 离线图片生成 + RP 9 中继器动作对齐
1.3.0
RP 11
- generate_from_image 现在离线直写 RP 11 二进制 .rp,使用本机 RP 11 空白模板,不再需要 GUI 粘贴;guiPaste 仍可显式开启。
- OCR 在非 macOS 平台退化为纯几何分层,不再让整条草稿失败。
- RP 11 自动宿主截图不再误绑定 RP 9;需要截图时显式传 preview=<路径>。
RP 9
- removeAll 排序改写为前置 remove-sort(remove-all) + 排序。
- comboType 无对应键,单条件过滤按顺序(AND)执行,运行时告警留痕。
- 按行号删除/更新中继器行改写为 TargetItem.index 规则,结构已验证。
工具与文档
- 能力矩阵:排序 supported/supported;过滤组合与行号操作 partial/supported 并登记缺口。
- 新增 test/image-generate-versions-check.mjs、test/repeater-action-parity-check.mjs。
- 本机验证:两版图片生成均为 29 个元件、零结构问题;对齐 10/10,回归 19/19。
return_rp 1.2.2 — 原生表单状态样式支持 RP 11
1.2.2
原生表单控件的状态样式(MouseOver / Selected / Disabled / Focused)现在在 RP 11 上也真实写入。此前 RP 11 会整段跳过状态样式补丁,只保留元件、文本与几何。
- 按目标版本读取本机
Default.rplib的DefaultStyle,RP 9 / RP 11 结构一致 examples/rp-language/native-forms.rp1在两版下产出完全一致的 56 个元件、19 个状态样式- 结构自检
problems=0、danglingRefs=0 - 新增
npm run test:form-styles-versions固定这项对齐
对照矩阵 native-form-state-styles 由 partial 升为 supported/supported,docs/version-parity.md 同步更新。
验证
node test/version-parity-check.mjs
node test/native-form-style-versions-check.mjs
node test/regression.mjsreturn_rp 1.2.1 — 原生中继器支持 RP 11
return_rp 1.2.1
原生中继器打通 RP 11:同一个 RP/1 模型现在可以在两个版本上生成结构一致的中继器。
改动
createNativeRepeater读取目标.rp的文件头版本,从该版本安装目录的Default.rplib克隆 Repeater;RP 11 不再以Native Repeater requires RP 9中止。- 能力矩阵
native-repeater的 RP 11 状态提升为supported,同步删除缺口台账与诊断证据条目。 - 新增
test/native-repeater-versions-check.mjs(npm run test:repeater-versions):同一份模型分别构建 RP 9 / RP 11,校验文件头、3 列 3 行数据与三零结构;本机缺少 Axure 或 Pillow 时输出 SKIP。 - RP/1 JSON Schema 的
target同步为9 | 11;能力矩阵与生成资源说明按目标版本表述。
本机验证:RP 9 与 RP 11 各构建一次,problems=0、danglingRefs=0,中继器均为 3 列 3 行。
完整改动:v1.2.0...v1.2.1
return_rp 1.2.0 — 双向对齐与 Windows 兼容
return_rp 1.2.0
本版把「版本对齐」从单向规则升级为双向模型:RP 9 与 RP 11 能做的能力不允许单边缺失,暂时做不到的必须登记为已知缺口并由测试守住。
对齐模型
- 新增
SYMMETRIC_PARITY:任一版本已支持的能力,另一版本不得是unsupported。 - 新增
partial状态与DOCUMENTED_GAPS缺口台账;矩阵、台账与源码诊断文案三方互相校验。 test/version-parity-check.mjs扩展到 10 项检查,覆盖缺口登记与诊断证据。
能力推进
- Studio 局部 RP/1 创作支持 RP 11 文档;
target与文档不一致时以E_RP1_SOURCE_UNSUPPORTED明确拒绝。 - 自动 Axure 预览接受 RP 11 目标(仍需 macOS 宿主)。
跨平台与打包
- Windows 路径守卫改用
path.delimiter,物理消解支持盘符与正斜杠。 - Studio 实例登记改用系统临时目录;Chrome 探测覆盖 Windows 安装路径。
- 发布包补上
scripts/trim-to-single-page.mjs,移除空实现;清单路径统一为/。 - 基线指纹与 SVG 比对按统一换行计算,CRLF / LF 检出不再误报。
完整改动:v1.1.2...v1.2.0
return_rp 1.1.2
首个正式命名版本(原 0.2.1 预发布版本号已停用)。
主要能力
- 截图/图片重建为可编辑 Axure 布局,RP/1 规范编译为原生
.rp(RP 9 / RP 11 版本感知) - Studio 浏览器自由画布:RP/1 与命令双路线创作、事务撤销、交互验证、工程包、三方合并、矢量与离线代码导出
- CLI + MCP 服务:原生读写、交互、表单、中继器、母版、表格、连接线等工具
- RP 9 / RP 11 能力矩阵与对齐门禁(RP 9 ≥ RP 11),
npm test内含版本对齐检查
协议与贡献
- MIT License;欢迎 fork 后提 Pull Request,无 CLA/DCO 要求
- 第三方照片与字体按各自许可使用,署名见
assets/readme/README.md与各参考包CREDITS.md
环境要求
- Node.js 18+,Python 3.10+
- 原生
.rp生成需要本机安装 Axure,并准备一个 RP 9 单页空白工程
安装
git clone https://github.com/karlmoriaty/return_rp.git
cd return_rp
python3 -m venv .venv && source .venv/bin/activate
python -m pip install -r requirements.txt
npm ci
node bin/axure.mjs --help维护者:karlmoriaty · 问题反馈:3070687583@qq.com