粤公网安备 44011302004783号 RM应用发布实操：3步极速搞定全球共享应用
各位跨境实战精英们，大家好！作为一名深耕跨境领域多年的老兵，我深知大家在出海路上不仅要懂市场、会运营，更要能将自己的奇思妙想付诸实践，甚至将其产品化、社区化。今天，咱们就来聊聊如何把你的Reachy Mini应用想法，变成一个能让全球用户一键安装的共享应用，真正实现技术与社区的共赢！
这篇教程是为谁准备的呢？很简单，如果你脑子里已经有了一个Reachy Mini应用的初步构想或者原型，并且渴望把它分享给更广阔的社区，那么，恭喜你，这正是为你量身定制的指南。我们这里会以Python SDK为例，手把手教你如何高效地打包、测试并发布你的应用。当然，如果你更偏爱Web API或JavaScript模板，那也是可行的路子，原理上是相通的。
是不是觉得有点茫然，不知道从何下手？别担心，不妨先去看看社区里已有的Reachy Mini应用，寻找一些灵感。你会发现，很多精彩的互动和行为都是从这里开始，并被大家分享出来的。
将你的想法转化为可共享的应用
要把你的Python代码变成一个Reachy Mini应用，核心就三步：
首先，你需要将应用的核心逻辑封装到一个特定的 run 方法里。这样一来，系统就能根据需要随时启动或停止你的应用。
其次，得把它包装成一个标准的Python包。只有这样，其他用户才能轻松地安装和使用你的应用。
最后，也是最激动人心的一步，就是把它发布到一个“空间”（Space）里，与整个社区共享你的创意！
听到这里，你可能会觉得手动搭建这些很麻烦，是不是？别怕！Reachy Mini应用助手（App Assistant）就是来帮我们解决这个问题的。它能自动生成所有必要的项目框架代码，大大简化你的发布准备工作！
咱们这就开始实战演练！
创建应用项目模板
在动手之前，我们先确保你的Python环境中已经安装了 reachy-mini 这个包。如果还没搞定，记得先参照官方文档把它装好。
Reachy Mini应用助手工具其实就包含在 reachy-mini 的安装包里。所以，要为你的应用创建所需的一切文件，你只需在终端里敲入这行命令：
reachy-mini-app-assistant create
运行之后，它会引导你输入一些信息，比如你的应用叫什么名字、想把项目放在哪个路径等等。
~$ reachy-mini-app-assistant create
$ What is the name of your app ?
? > reachy_mini_hello_world
$ Choose the language of your app ?
> python
$ Where do you want to create your app project ?
? > ~/my_reachy_mini_apps/
✅ Created app 'reachy_mini_hello_world' in ~/my_reachy_mini_apps/reachy_mini_hello_world/
看到上面的反馈，就说明你的应用项目已经成功创建了！
项目生成后，你会看到一个清晰的文件夹结构：
reachy_mini_hello_world/
├── index.html
├── pyproject.toml
├── reachy_mini_hello_world
│ ├── __init__.py
│ └── main.py
├── README.md
└── style.css
这里面有几个关键部分。首先是你的Python应用包本身（就是那些带有 > 符号的文件）。这正是你未来添加应用核心逻辑的地方。你会看到Python的入口文件，以及一个可选的网页文件，可以作为你应用的设置页面。这些细节，我们后面会逐步展开。
reachy_mini_hello_world/
├── index.html
├── pyproject.toml
├── reachy_mini_hello_world
│ ├── __init__.py
│ └── main.py
├── README.md
└── style.css
还有，这些文件是为你Hugging Face Space项目准备的首页和一些元数据，能让你的应用更容易被发现。
reachy_mini_hello_world/
>├── index.html
├── pyproject.toml
├── reachy_mini_hello_world
│ ├── __init__.py
│ └── main.py
>├── README.md
>└── style.css
编写你的应用逻辑
你的应用需要继承自 ReachyMiniApp 这个基类。当它从仪表盘启动时，会作为一个后台线程运行。记住，要利用好提供的 stop_event，这样才能确保应用在停止时能够干净利落地退出。
import threading
from reachy_mini import ReachyMini, ReachyMiniApp
from reachy_mini.utils import create_head_pose
class ReachyMiniHelloWorld(ReachyMiniApp):
# 可选：应用的自定义配置页面URL
# 例如: http://localhost:5173
custom_app_url: str | None = None
def run(self, reachy_mini: ReachyMini, stop_event: threading.Event):
# 你的代码写在这里
# ReachyMini实例已经初始化并连接
# 检查 stop_event 来优雅地退出循环
# 示例:
# import time
# import numpy as np
#
# t0 = time.time()
#
# while not stop_[event.is]_set():
# t = time.time() - t0
#
# yaw = 30 * np.sin(2 * np.pi * 0.5 * t)
# head_pose = create_head_pose(yaw=yaw, degrees=True)
#
# reachy_mini.set_target(head=head_pose)
#
# time.sleep(0.01)
print("这是你应用逻辑的占位符。")
这段代码模板已经给你搭好了骨架，你只需要把自己的精彩想法填进去。记住， ReachyMini 对象已经准备就绪，你可以直接调用它来控制机器人。循环里一定要检查 stop_event.is_set()，这是保证应用平稳退出的关键。
为你的应用打造一个网页UI
如果你想让你的应用拥有一个酷炫的网页界面，比如设置页面、数据可视化，甚至是一些开关功能，那完全可以实现！你只需要在你的应用中设置一个 custom_app_url（默认是 None）。一旦设置了它，你的应用就会启动一个FastAPI的Web服务器，专门用来提供你Python模块中 static 目录下的静态文件。
reachy_mini_hello_world/
├── index.html
├── pyproject.toml
└── reachy_mini_hello_world
| ├── __init__.py
| ├── main.py
| └── static
| ├── index.html
| ├── main.js
| └── style.css
├── [README.md]
└── style.css
当你使用助手工具创建新应用时，我们已经为你准备了一个最小化的示例，展示了它是如何工作的。你也可以去查看这个模板应用 https://huggingface.co/spaces/pollen-robotics/reachy\_mini\_template\_app，看看它实际运行的效果。
发布前的充分测试
在正式发布你的应用之前，充分的测试是必不可少的，这能帮助我们避免很多不必要的麻烦。
第一步，你可以直接在你的环境中手动运行 main.py 文件。这样能快速检查你的应用逻辑是否有基础性的错误。
第二步，也是非常重要的一步，就是通过仪表盘进行本地测试。这能模拟用户实际使用的场景，帮助你发现潜在问题：
- 首先，确保你的Reachy Mini Python环境已经激活。然后，进入你的应用项目目录，运行
pip install -e .这条命令，把它作为可编辑模式的本地包安装。 - 接着，启动守护进程：
reachy-mini-daemon。 - 在你的浏览器中，打开
http://127.0.0.1:8000/。 - 此时，你的应用应该会出现在已安装的应用列表里，你就可以点击运行，看看它表现如何了。
发布你的应用
经过了严格的测试，现在是时候把你的心血结晶分享给社区了！
~$ reachy-mini-app-assistant publish
$ What is the local path to the app you want to publish?
? > ~/my_reachy_mini_apps/reachy_mini_hello_world/
$ Do you want your space to be created private or public?
? > private
✅ App published successfully. You should now see your app on your HuggingFace account https://huggingface.co/spaces/hf_username/reachy_mini_hello_world
运行 reachy-mini-app-assistant publish 命令，它会询问你的应用本地路径，以及你希望你的空间是公开（public）还是私有（private）。根据你的需求选择即可。成功发布后，你就能在你的Hugging Face账号下看到你的应用了。是不是很激动？
申请加入官方应用列表
如果你觉得你的应用已经非常成熟，达到了“生产就绪”的水平，并且希望它能出现在Reachy Mini仪表盘的官方应用列表里，那就可以提交申请！提交前请务必确保你的应用空间是公开的。
只需运行：
~$ reachy-mini-app-assistant publish --official
这条命令会为你创建一个Pull Request（PR），提交到官方数据集。提交时，记得简要地说明你的应用是做什么的，这能帮助Pollen和Hugging Face团队更好地审核你的请求。
仪表盘UI概览
新媒网跨境获悉，Reachy Mini的仪表盘界面设计得非常直观，能够大大提升我们的管理效率。
上图清晰地展示了仪表盘的两个主要区域：
- 从Hugging Face安装 (Install from Hugging Face): 这个区域列出了官方推荐的应用，你可以直接点击“安装”按钮，一键将它们部署到你的Reachy Mini上。
- 已安装的应用 (Applications): 这里显示的是你本地已经安装的所有应用。
- 每一个应用方块都会清晰地标明当前状态，并提供“运行”和“停止”等操作按钮。
- 当某个应用正在运行时，你可以点击其旁边的齿轮 ⚙️ 图标，这将打开应用的图形用户界面（GUI），方便你进行配置或查看实时状态。
风险前瞻与时效提醒
作为资深导师，新媒网跨境提醒大家，在将应用分享到社区的过程中，有几个点我们必须提前考虑：
1. 代码质量与维护： 发布应用后，你就是这个应用的“负责人”。用户可能会提出改进意见或遇到Bug。确保你的代码质量过硬，并承诺一定的维护周期，这对于建立良好的社区声誉至关重要。一个长期不更新、不维护的应用，很容易失去用户的信任。
2. 用户体验： 虽然技术上可行，但应用的用户界面（如果有的话）是否直观易用？交互设计是否合理？这些都会直接影响用户对你应用的评价和使用意愿。
3. 依赖与兼容性： 你的应用依赖的库和Reachy Mini平台本身都在不断迭代。随着时间的推移，可能出现API变更或库版本不兼容的情况。发布时说明应用的兼容版本，并适时更新你的应用以适应最新平台，是确保应用时效性的关键。定期检查Reachy Mini的官方文档和社区公告，能够帮助你预见潜在的变化。
4. 平台规则与合规性： 在Hugging Face Space发布应用时，务必遵守其平台的使用协议和内容规范。确保你的应用内容积极健康，不包含任何违反规定的信息。
记住，分享你的创作不仅是一种贡献，也是一种责任。持续学习，积极维护，你的应用才能在社区中焕发长久的生命力！
新媒网（公号: 新媒网跨境发布），是一个专业的跨境电商、游戏、支付、贸易和广告社区平台，为百万跨境人传递最新的海外淘金精准资讯情报。
本文来源：新媒网 https://nmedialink.com/posts/rm-app-publish-3-steps-fast-global-share.html
