新用户快速上手

开发你的
第一个
应用程序

本页是 HEC AI Studio 新用户快速上手指南:按最短路径先下载 HECAS Manager 完成安装,再创建一个 x64_win 新项目,直接使用模板确认需求, 让 AI 生成应用,最后执行下载验证。建议约 30–60 分钟先用 Windows x64 项目跑通流程, 再切换到 HEC 设备项目会更容易。

01 下载 Manager

点击页面中的 HECAS Manager 下载按钮,得到 hecas_manager.zip。在文件上右键 → 解压到此处,再双击 hecas_manager.exe 运行。它是后续安装、升级和启动 HEC AI Studio 的统一入口。

02 安装并启动软件

双击运行 Manager,点击「升级」或「全部升级」安装 HEC AI Studio 与必要组件;完成后点击「启动 HEC AI Studio」。

03 创建项目

在 HEC AI Studio 面板中点击「1a 创建项目」,项目类型选择 x64_win,项目名可先用 first_app

04 确认需求

为了快速上手,可以不改需求,直接使用模板进入下一步;如果想体验定制,再用中文改成自己的小目标。改完需求后可先点击「3 澄清需求」让 AI 补全技术细节,再点击「4 生成应用」。

05 生成应用

点击「4 生成应用」。平台会根据需求生成规格与 Rust 代码,并自动构建;如果构建失败,会进入自动修复迭代。

06 下载验证

执行「5 下载验证」。在 x64_win 项目中先验证本机生成结果;熟悉流程后,再改用 HEC 设备项目下载到现场硬件。

先下载 HECAS Manager

新用户只需要先获取这一个管理工具。HECAS Manager 会负责检测、下载、安装和升级 HEC AI Studio 以及 Rust 交叉编译工具链,避免手动查找多个安装包。

HECAS Manager · Windows x64 · 免安装

hecas_manager.zip

下载后在文件上右键 → 解压到此处,再双击 hecas_manager.exe 运行。 第一次使用时,按 Manager 界面提示完成全部组件安装或升级,然后点击「启动 HEC AI Studio」。

下载 HECAS Manager

首次运行可能出现 Windows 安全提示

解压后双击 hecas_manager.exe,若 Windows Defender SmartScreen 弹出"已保护你的电脑"对话框,点击「更多信息」,再选择「仍然运行」即可。该文件来源为 download.hecas.online,可以放心运行。

跟着截图一步步完成

下方截图按真实操作顺序排列。第一次使用时,重点看每张图下方的防错提示: 不要跳过安装状态检查,不要选错目标机型,也不要在生成过程中关闭窗口。

01

安装 Manager 管理的全部组件

先让 Rust Portable Cross 和 HEC AI Studio 都变成“已是最新”,再启动工作台。

HECAS Manager 安装前界面,Rust Portable Cross 和 HEC AI Studio 都显示未安装并可点击安装
安装前:两个组件都要安装 如果看到“本地版本 未安装”,分别点击 Rust Portable Cross 和 HEC AI Studio 右侧的「安装」。此时「启动 HEC AI Studio」是灰色,说明还不能开始开发。
HECAS Manager 安装后界面,组件显示已是最新并可启动 HEC AI Studio
安装后:确认可以启动 两个组件都显示“已是最新”后,再点击左下角「启动 HEC AI Studio」。如果按钮仍不可用,先点击「全部升级」或重新打开 Manager。
02

创建第一个 Windows x64 项目

第一次练习建议选择 x64_win,这样不用连接现场硬件也能生成并运行应用。

VS Code 中打开 HEC AI Studio 侧边栏,点击 1a 创建项目并输入项目名称
点击 H 图标,再点「1a 创建项目」 在顶部输入项目显示名称,例如 win_app_01。不要直接手动创建文件夹,项目结构由工作台自动生成。
项目目标机型选择列表中选中 x64_win,用于开发 Windows 程序
目标机型选择 x64_win 下拉列表默认可能停在 HEC 设备型号。开发第一个 Windows 应用时,必须选中图中的 x64_win
需求.md 文件已打开,可以直接使用模板或修改 Windows GUI 应用需求文档
可以直接使用模板需求 第一次使用建议不改 需求.md,直接进入下一步点击「4 生成应用」。如果要修改,只改目标、界面和可验证行为,先不要追求复杂功能。
03

生成应用并等待自动修复

点击「4 生成应用」后,AI 会先写规格和任务,再生成代码并编译。中途出现编译错误是正常情况,工作台会自动修复。

HEC AI Studio 中点击 4 生成应用,终端开始根据需求生成代码
点击「4 生成应用」 终端开始读取项目上下文并生成 proposal、design、tasks/spec。根据需求复杂度和网络情况,可能需要等待 10 到 30 分钟,首次运行含依赖下载时间。
AI 正在根据需求创建 OpenSpec 文档和规格文件
先生成各种文档 看到多个 Wrote file successfully 是正常状态。此时不要关闭 VS Code,也不要手动改生成中的文件。
终端显示正在创建 Todos 任务列表并开始写 Cargo.toml 和源码
再生成任务列表和源码 任务列表会把需求拆成可执行项,然后开始写 Cargo.toml 和 Rust 源码。保持等待即可。
tasks.md 中部分任务已被标记为完成
已完成的任务会自动打勾 看到 [x] 表示对应任务已经完成。不要手动勾选任务,避免让后续生成步骤判断错误。
第一批任务完成后,生成应用进入第二批任务
进入下一批任务 复杂一点的应用会分批实现。看到“正在启动第 2 批”说明流程仍在继续,不是卡住。
代码生成完成后开始调用 build.ps1 编译 Windows x64 应用
代码完成后开始编译 第一次编译会下载或锁定依赖,等待时间可能较长。不要手动执行 cargo build,让工作台流程继续。
第一次编译发现代码错误,HEC AI Studio 自动写入修复指引并开始自动修复
如果编译报错,等待自动修复 图中红色错误不代表失败。看到“即将进行第 1 次自动修复”后,工作台会读取错误摘要并修改代码。
全部编译错误已修复,工作台开始第二次编译
修复完成后会再次编译 看到”全部编译错误已修复”后继续等待。流程会自动重新运行构建,不需要手动重新点击「4 生成应用」。
第二次编译成功,生成应用 win_app_01 完成
看到绿色“完成”就是生成成功 终端显示 Finished release 和”生成应用”完成后,再进入下一步「5 下载验证」。
04

下载验证并运行第一个应用

x64_win 项目的下载验证会在本机运行生成的 Windows 应用,用来确认流程已经跑通。

点击 5 下载验证后,生成的 Windows 分形演示器应用已经启动运行
点击「5 下载验证」并确认应用窗口出现 看到生成的 Windows 窗口正常打开,就说明第一个应用已经生成并运行。之后可以回到 需求.md,继续用「7 增加功能」或「6 修复问题」迭代。

第一个应用程序检查清单

按顺序完成这些动作,就能熟悉 HEC AI Studio 的主线开发流程。

建议 30–60 分钟(视网络情况)
Manager 已安装 HEC AI Studio,VS Code 中能看到 HEC AI Studio 侧边栏。 环境就绪
新项目目标平台为 x64_win,项目目录和需求文档已经创建。 项目就绪
需求文档已经打开;可以直接使用模板,也可以改成一个清晰、简单、可验证的小功能。 需求确认
点击「4 生成应用」后,规格、代码和构建结果已经生成。 应用生成
执行「5 下载验证」后,能看到验证成功结果或应用运行结果。 流程跑通
第一次建议: 为了最快跑通流程,可以不改需求,直接使用模板并点击「4 生成应用」。 目标不是做复杂功能,而是熟悉创建项目、确认需求、生成应用和下载验证这一整条链路。
完成后继续练习: 如果第一个应用程序成功生成并运行,可以继续尝试「6 修复问题」描述运行现象并让 AI 修改, 或使用「7 增加功能」提出一个新功能,体验从已有应用继续迭代的流程。

上手前先看清这三件事

把路径、平台选择和下载入口说清楚,避免第一次安装就卡在环境或机型选择上。

新用户第一次应该做什么?

先下载并运行 HECAS Manager,安装 HEC AI Studio 与 Rust Portable Cross,再创建 x64_win 项目,使用模板需求点击「4 生成应用」,最后执行「5 下载验证」。建议约 30–60 分钟先在 Windows 本机跑通,再切换到 HEC 设备项目。

为什么第一个项目建议选 x64_win?

x64_win 在本机生成并运行 Windows 应用,不依赖现场设备连接、IP 或 CAN 烧录,便于先熟悉创建项目、确认需求、生成应用和下载验证主线流程。

HECAS Manager 从哪里下载?

官方下载地址为 https://download.hecas.online/hecas_manager.zip。下载后右键解压,再运行 hecas_manager.exe;首次可能出现 Windows SmartScreen 提示,选择「更多信息」→「仍然运行」即可。

普洛电气公司公众号二维码

长按关注普洛电气

探讨电控系统优化解决方案

图解AI编程公众号二维码

长按关注图解AI编程

一起快乐做开发