1.摘要:
使用solo搭建了一个智能硬件数据手册解析工具,用户上传数据手册,选择使用的MCU和编程语言,网站后台调用AI进行分析,然后给出相应的信息和两个主要的驱动函数代码和一个初始化函数代码以及必要的中文注释。可以帮助开发人员快速上手硬件。
2.背景:
我是一个电子信息相关专业的大三学生,在日常生产活动(例如嵌入式开发)中,我经常会接触到硬件数据手册,但是好多都是英文的,或者很长很多信息,需要花费大量的时间来阅读才可以上手这个硬件。日常的AI助手每次使用都要写详细的提示词,并且他返回的信息是在一起,所以我就需要一个在线的硬件数据手册分析工具。但是我只会嵌入式相关的C语言开发,对于计算机方面的编程不太了解,所以我选择使用trae solo来制作这个工具。
3.实践过程:
3.1.拆解任务:
首先我先选定了我要部署的环境,基于对自身的认识,以及此前曾经使用过的Edgeone pages部署静态宣传网页的经验,我选择使用Edgeone pages来部署。其次我选择了使用哪款大模型API,初期我选择的是智谱的API接口,后因网络问题,切换至OpenRouter。随后,我开始思索如何编写提示词,然后开始使用trae solo进行初次项目构建,随后上传到GitHub仓库,部署在Edgeone pages,最后进行测试,并将测试结果返回到trae solo进行改进。
3.2.使用的solo的能力:
1.GitHub mcp:帮我将代码推送到GitHub仓库并且检查仓库与本地项目内容是否一样。
2.context7 mcp:这个mcp可以帮助trae solo来查看官方开发文档。
3.独自项目构建能力并且可以调用命令行或者创建测试文件自己测试。
4.在遇到关键问题时,trae solo会向你提问。(这个好像是最近更新的功能)
5.理解测试结果,并且自己去查看相关文件来确定问题所在。
3.3.关键prompt:
请使用 Context7 MCP 工具,严格按照 EdgeOne Pages、openrouter 官方文档生成完整可直接部署的项目。项目应确保可靠有效运行。如果技术方面我的叙述有不合理的地方,你可以更改为合理的方法。
项目用途:硬件分析师 —— 自动解析硬件芯片数据手册 PDF,生成两个最主要的驱动函数代码、一个初始化函数代码、硬件信息解析。
========== 【项目功能完整需求】 ==========
【前端用户页面】
1. 第一步界面:
- 上传硬件数据手册 PDF 文件
- 选择使用的 MCU(输入框)
- 选择使用的编程语言(C / Arduino / STM32 HAL / Python 等)
- 上传 → 解析按钮
2. 第二步后端逻辑(由 EdgeOne 边缘函数处理):
- 接收上传的 PDF
- 提取文本
- 调用open router大模型 API 进行分析
- 存储调用记录到 KV
3. 第三步结果展示页面(分块卡片展示):
- 芯片基本信息(型号、用途、供电、温度范围、通信方式、引脚说明)
- 工作原理简介
-两个最重要的驱动函数代码示例(对应所选 MCU + 语言)
-一个完整的初始化步骤代码示例
-示例代码风格用最通用最实用的风格
- 使用注意事项
- 全部内容使用卡片分块展示,UI 专业、清晰、现代化
【后台管理页面(带密码登录)】
路径:/admin
1. 密码登录页面(密码存在 KV 中,可修改)
2. 后台功能:
- 查看 API 调用总次数(可以设置年或月或日为单位),设置每日调用次数上限
- 重置api调用次数
- 设置/修改API Key
- 填写使用的模型
- 修改管理员密码
========== 【技术栈与部署要求 强制遵守】 ==========
1. 部署环境:EdgeOne Pages
2. 必须使用 EdgeOne Pages 边缘函数(Worker)作为 API 中间层
3. 必须使用 EdgeOne KV 存储:
- KV 名称:AI_HARDWARE_TOOL
4. 前端:纯静态 HTML + CSS + JS(无需框架)
5. PDF 解析:使用前端库或边缘函数简单提取文本
6. open router API 调用:必须在边缘函数内发起,绝对不能暴露在前端
7. 所有密钥、配置全部存在 KV 中,不硬编码
8. UI 风格:简洁、专业、工程师向、深色模式优先
========== 【输出要求】 ==========
1. 输出完整项目结构
2. 输出所有文件代码,可直接部署到 EdgeOne Pages
3. 严格按照 EdgeOne Pages 官方规范
4. 严格按照open router官方规范
5. 不要编造不存在的 API
6. 不要省略代码
7. 确保可直接运行、部署、使用
8.输出完整的部署步骤
3.4.中间踩过的坑:
1.第一次提示词没给好,得到了一个需要搭云服务器的带完整后端的版本,在后面的摸索中我才发现可以使用kv存储和云函数来实现简单的后端服务。
2.苦恼于trae solo不了解Edgeone pages或OpenRouter的开发文档,我截图或者把文档网站给他,但是效率很低,后来发现可以使用context7 mcp。
3.刚开始用的是智谱的API服务,但是改了好多次,都不能正常运行,我一直以为是代码的问题,后来发现是这个API对海外节点有访问限制。
4.成果展示:
成功把网站部署上线,并且成功跑通流程。
网站地址:https://hardware.tbit.xin
5.效果与总结:
5.1.trae solo对我提效了多少:
提效我认为有百分之九十吧,如果没有trae solo,我就无法完成这个项目。但是在完成项目期间,我也承担了一些找资料,部署以及测试的功能,但trae solo是主攻手,我算是个助手。
5.2.trae solo在我的流程中做了什么:
程序员的任务,从0构建项目,根据测试结果修改bug或改进性能。
5.3.可复用的方法:
1.一定要注重第一次构建项目的提示词质量。
2.主动询问trae solo需要什么信息。
3.关注有没有可用的mcp。
4.如果项目的改进发展方向走入死胡同,及时推到重做。
5.在生产过程中,有不明白的地方及时问trae solo,或者进行阶段性总结并清理历史冗余文件(例如测试脚本)。



