发布应用
CodeCraft Hub 是应用发布与复用的地方。你可以浏览社区作品、克隆项目继续开发,也可以发布自己的应用,让别人直接部署。
浏览与复用社区作品
Section titled “浏览与复用社区作品”所有已发布的应用都列在 CodeCraft Hub 应用社区,发布自己的作品也在同一个页面完成。

如何使用 CodeCraft Hub
| 参与方式 | 怎么做 | 适用场景 |
|---|---|---|
| 浏览与复用 | 克隆:复制一个已发布的项目,在副本上继续修改 | • 快速体验开发板或传感器 • 基于已有案例做二次修改 • 将官方案例改造为教学或展示项目 |
| 创建与发布 | Publish app → or 分隔线下方 → Publish manually → Create a new app in editor | • 展示创意,收获社区反馈 • 贡献范例,供他人参考学习 • 积累作品集,提升个人影响力 |
发布前请准备好以下内容:
| 准备项 | 具体要求 | 备注 |
|---|---|---|
| 项目图片 | • 建议作为封面图 • 推荐比例 4:3• 大小 < 2MB• 清晰、美观,直观展示项目效果 | 必须 |
| 项目名称与介绍 | • 名称简洁有吸引力 • 可包含设备关键词(如 Wio Terminal、XIAO ESP32S3 Sense) | 必须 |
| 固件文件 | • 格式:.bin 或 .hex• 必须在真实设备上测试通过,确保正常运行 • Wio Terminal、XIAO ESP32S3 Sense 等常用 .bin• Grove Beginner Kit 常用 .hex | 必须 |
| 源代码文件 | • 例如 .ino 文件• 可选上传,便于他人学习或二次修改 | 可选 |
应用创建分为四个步骤,你可以随时通过顶部导航栏在它们之间切换。
点击 Publish app。对话框默认打开 AI 页面;在 or 分隔线下方选择 Publish manually,再点击 Create a new app in editor。在这个对话框中填写 Application Name,然后点击 Confirm,应用即被创建并进入编辑器。

如果想从已有的作品出发,在 CodeCraft Hub 打开任意一个已发布的应用,点击 Clone 即可。
进入编辑器后,更改会自动保存,导航栏会实时显示保存状态。
步骤 1:应用信息
Section titled “步骤 1:应用信息”这是他人了解你的应用的第一个入口,值得花时间填写。
应用名称和描述
Section titled “应用名称和描述”为你的应用起一个清晰的名称,让他人一眼就能看出它的用途,并用简洁的语言概括核心场景、技术、设备等信息。
应用名称限制为 60 个字符,描述限制为 300 个字符。
为你的应用选择最合适的分类标签,它会影响应用被发现和获得推广的机会。
可选场景:Maker/DIY、Smart Home、Industrial、Agriculture、Security、Education、Healthcare、Retail、Other。
在这里设置你的许可证,包括他人是否可以复制和修改你的作品,以及是否允许商业使用。
- 允许他人复制和修改你的应用:他人可以将你的应用复制为他们自己的新可编辑项目,其中包括所有图片、文档、模型、代码和配置。如果关闭此选项,他人仍然可以查看和部署你的应用,但不能创建自己的副本。仅当你拥有项目中每一项资源的再分发权利时,才应启用此选项。
- 允许你的作品被用于商业目的:他人可以在商业产品、付费服务或其他创收场景中使用你的应用以及基于它创建的任何衍生作品,而无需向你支付版税或额外取得许可。
第一张图片默认用作封面。你最多可以上传 16 张图片;每个文件大小必须不超过 2MB。推荐使用 4:3 的宽高比。
步骤 2:文档
Section titled “步骤 2:文档”这是你的应用的核心:详细的应用介绍和部署流程。使用右上角的按钮随时显示或隐藏实时预览,从其他用户的视角检查部署流程。
使用 Markdown 编辑
Section titled “使用 Markdown 编辑”文本编辑器使用 Markdown。在编辑时输入 / 可以打开快捷菜单,用于插入标题或工具模块(将在未来更新中提供)。
用自由文本描述项目的背景、原理和设计。本节不能添加调用 SenseCraft 能力的工具模块。
按步骤描述你的部署流程,以便他人可以复现你的应用,包括每一步的前置条件。点击 + 控件添加部署步骤,保持步骤顺序合理、说明足够详细,并用实时预览检查他人是否能够按照你的步骤完成部署。
使用工具模块
Section titled “使用工具模块”在部署流程中,你可以一键插入 SenseCraft AI 集成功能。
可用的工具模块:
- AI Vision — 在支持的硬件上部署用于目标识别、检测和分类的视觉模型。
- AI Audio — 在支持的硬件上部署语音识别模型。
- AI Vibration — 通过学习正常振动模式并标记偏差来检测振动异常。
- Node-RED — 为 reCamera 构建并部署可视化逻辑流程。
- Aily Blockly — 将在 Aily Blockly 可视化环境中构建的程序烧录到边缘设备。
- Deploy container app — 将容器化应用部署到支持的硬件。
- Flash firmware — 一键将固件镜像烧录到设备。
- 调试工具 (即将推出) — 在部署过程中检查和排查设备行为。
有关每个工具模块的完整配置详情,请参见 工具模块。
步骤 3:物料清单(BOM)
Section titled “步骤 3:物料清单(BOM)”列出复现你的应用所需的一切。
来自 Seeed Studio
Section titled “来自 Seeed Studio”直接搜索并添加 Seeed 官方硬件。
对于非 Seeed 的部件(紧固件、特殊线缆、3D 打印件等),请提供名称、简短描述和数量。购买链接会很有帮助。
软件和平台(即将推出)
Section titled “软件和平台(即将推出)”列出所需的软件或平台——例如 Arduino IDE、Home Assistant 或 Edge Impulse。
步骤 4:预览和发布
Section titled “步骤 4:预览和发布”像终端用户一样检查完整的应用。点击 Publish 之前,确认必填项已填写完整,并同意 CodeCraft Hub 发布声明——你需要在其中确认自己有权分发代码和资源,且不包含任何机密或违法内容。
发布后,应用草稿将被送审,在审核完成之前无法编辑该草稿。如果暂时还不准备发布,可以直接退出编辑器,进度仍会自动保存。
管理员会检查以下方面:
-
内容与安全
-
**版权和开源许可证:**你必须拥有或取得所有代码、模型、图片和资源的使用权,或严格遵守上游许可证(MIT、Apache 等)。
-
**隐私和数据安全:**尤其是在使用摄像头或麦克风时,不得存在隐藏的数据外传、未授权上传或后门。
-
**法律与社区标准:**不得包含商业机密、违法内容、恶意软件,或暴力、色情、仇恨内容。
-
-
模型质量与硬件适配
-
**模型可用性:**自定义模型必须能够在平台上正确加载和解析。
-
**准确性:**实际表现应与文档描述相符,不得夸大效果。
-
**硬件匹配:**模型大小和逻辑必须适配你声称支持的开发板。
-
-
文档与可复现性
-
**基础信息清晰:**名称、摘要、标签和封面图片准确且不具误导性。
-
**BOM 准确:**列出的硬件应与部署步骤中实际使用的硬件一致。
-
**部署可复现:**步骤顺序合理,并清晰写明引脚连接、阈值设置、MQTT 配置等具体细节。
-
-
社区规范
- **禁止垃圾信息:**不允许无意义的重复内容或没有技术价值的广告。
审核通过后,你的应用会显示在 CodeCraft Hub 应用社区中。你可以复制应用链接,分享到社交媒体、社区论坛或项目文档,让更多人发现并使用它。
管理已发布版本
Section titled “管理已发布版本”每个应用都有两个可能随时间逐渐分离的状态:
- 草稿 — 你正在编辑的工作副本。始终为私有,仅你可见。
- 已发布版本 — 当前在 CodeCraft Hub 应用社区中可见的快照。只有当新的草稿通过审核后才会更新。
你可以从两个入口管理一个应用,可用操作取决于你正在操作的是哪一个副本。
从 CodeCraft Hub 进入
Section titled “从 CodeCraft Hub 进入”当你从 CodeCraft Hub 打开自己已发布的应用时,所执行的操作会作用于已发布版本。
-
**Duplicate:**基于已发布版本创建一个新的独立项目。适合从已知稳定版本分支开发。
-
**Edit:**进入该应用草稿的编辑器(与从 My Applications 打开相同)。
-
**Unpublish:**将应用从 CodeCraft Hub 下架并将其状态切换回私有。草稿不受影响。
从 My Applications 进入
Section titled “从 My Applications 进入”这里的操作会作用于你的草稿。
-
**Edit:**在编辑器中打开草稿。在你再次发布之前,更改不会影响已发布版本。
-
**Duplicate:**基于当前草稿创建一个新的独立项目。
-
Publish / **Publish update:**提交草稿进行审核。第一次按钮显示为 Publish,之后显示为 Publish update。审核通过后,新版本会替换 CodeCraft Hub 应用社区中现有的公开条目。
-
**Unpublish:**将一个公开应用从 CodeCraft Hub 下架并恢复为私有状态。
- **Delete:**永久删除该应用。
发布前常见问题
Section titled “发布前常见问题”| 问题 | 回答 |
|---|---|
| 固件缺失怎么办? | - 固件是必须的文件,缺少则他人无法运行你的项目 - 请先在真实设备上烧录测试,确认正常运行后再上传 - 若未自动生成,可对 CodeCraft AI 说:「Please provide a .bin firmware file.」 |
| 封面和文档内是否支持上传 GIF? | - 封面和文档内都支持 GIF - 动态作品用 GIF 作封面效果更直观,推荐使用 - 注意控制文件大小,避免影响页面加载速度 |
| 文中是否支持插入视频? | - 支持,可直接嵌入视频链接 - 目前兼容 YouTube、哔哩哔哩、抖音等主流平台 - 粘贴链接到文档编辑器,即可自动识别并显示播放窗口 |