Rust 移植助手 LakoMoor/rustport-skill

rustport

把游戏和应用移植到 Rust，包括兼容的游戏运行时。这些运行时能加载原版地图、资源、脚本和存档。先摸清原版行为，移植出一小块可玩切片，再随项目推进度量兼容性。

一个智能体技能包，适用于 Codex、Claude Code、OpenCode、Pi、DeepSeek Harness（DSH）和 Hermes。安装器不会改动任何模型或 MCP 配置。

安装

需要 Python 3.9+。先克隆仓库：

git clone https://github.com/LakoMoor/rustport-skill.git
cd rustport-skill
python3 install.py --agent all

也可以指定智能体和安装范围：

python3 install.py --agent codex --agent claude
python3 install.py --agent opencode --project
python3 install.py --agent pi --agent dsh --agent hermes --project
python3 install.py --agent all --dry-run

./install.sh 仍是 Bash 入口；不带参数时，它按旧行为为 Claude Code 安装。Windows 上用 py -3 install.py 代替 python3。随附的 shell 辅助脚本需要 Bash（Git Bash/WSL）、Python 3 和 Cargo。GPU/平台支持取决于目标平台和 wgpu 工具链。

已存在且内容不同的文件会保留，除非你显式传入 --force。--root PATH 指定项目根目录；--home PATH 指定另一个用户主目录。参见智能体安装位置与环境变量覆盖。

调用

| 智能体 | 显式命令 |
| Codex | /skills → 选择 rustport，或 $rustport <request> |
| Claude Code | /rustport <request> |
| OpenCode | /rustport <request> |
| Pi | /rustport <request>；也支持 /skill:rustport <request> |
| DeepSeek Harness | /rustport <request> |
| Hermes | /rustport <request> |

OpenCode 会得到一个命令文件；Pi 会得到一个提示词模板。两者加载同一个技能包，并透传你的参数。其他智能体走原生技能发现。Codex 用原生技能选择器，不支持 /rustport 别名。安装后如有需要，重新加载或重启；Pi 有 /reload。Hermes 项目技能需要项目信任（审阅技能包后执行 hermes skills trust）。DSH 需要启用文件系统技能服务商。宿主机的命令/信任设置仍然生效。

示例（按你的智能体使用对应的调用语法）：

/rustport Port ~/games/snake from C++/SDL2 to Rust with wgpu
/rustport Reimplement this game's runtime in Rust, loading my original maps and scripts
/rustport Continue this port: fix save/load compatibility and compare with the original

智能体做什么

- 源码移植： 调研 → 划定范围 → 原版侧黄金测试 → Rust 核心 → 渲染 → 度量对齐程度。
- 兼容运行时： 锁定参考构建，检查真实内容，维护兼容性台账，通过真实游戏循环跑出可玩切片。
- 继续推进： 接着台账往下做，复现行为差异，修复真实运行时路径，更新证据，而不是重开项目。

Horizon/openOMSI 风格的工作，额外的兼容运行时工作流涵盖原始格式与脚本、参考基准、存档与读档、流式处理、确定性场景、智能体控制，以及跨会话的进度。这是开发工作流，并不保证单次运行就能重建完整游戏。

包内容

| 路径 | 用途 |
| SKILL.md | 智能体中立入口与模式选择 |
| references/agents.md | 智能体发现、命令与上游文档 |
| references/compatible-runtime.md | 整游戏运行时重建 |
| scripts/survey.sh | 源码清点与风险提示 |
| scripts/scaffold.sh | 无头核心 + Rust 应用工作区 |
| scripts/parity.sh | 黄金输出比对 |
| assets/wgpu_template/ | winit 0.30 + wgpu 30 起步模板 |
| assets/mappings.md | 语言/库映射与图形说明 |
| assets/PORT_TEMPLATE.md | 持续更新的移植计划 |

如果手上只有已发布的二进制、APK 或 Electron 应用，就用可用的逆向工程与运行时观察工具。REA 集成是可选项；技能必须说明哪些工具不可用、哪些行为尚未验证，不能编造结果。原始游戏内容保留在用户本地安装目录中。

验证与维护

python3 -m unittest discover -s tests -v

安装器测试使用临时 home/项目目录，不会启动 LLM 会话。布局与适配器测试不能证明全部六个客户端中的交互式端到端行为。wgpu 更新后，用 scripts/scaffold.sh 生成临时工作区，并在目标平台上用 Cargo 检查，确认无误后再声称模板可以构建。

许可证

rustport 技能、安装器、辅助脚本、模板、文档与原创示例均按 Apache-2.0 授权，除非文件另有说明。Copyright 2026 LakoMoor and contributors。

由二进制推导出的 openMMD 示例保留了上游 MIT 覆盖的材料及其原始版权与许可声明。这些上游声明仍然适用；仓库许可证不替代第三方条款。署名信息见 NOTICE。REA 与所支持的智能体客户端是独立项目，此处未打包，也未重新授权。

使用 rustport 不会自动把 Apache-2.0 应用到生成的移植版本、原程序或其资源上。请单独为目标项目选择许可证，并保留适用的原始声明。

网站

访问 rustport。
落地页源码在 docs/ 中，包含各智能体的安装命令、工作流细节，以及已记录集成测试的局限。