1. 个人介绍
- 身份：学校专任教师，从事过仪表采集（电、水等）设备开发工作，熟悉Modbus、RS485等工业通信协议及基于国网标准电力设备采集协议(645-07、376.1、698等)
- 参赛形式：个人参赛
- Vibe Coding 年限：通过TRAE从零起步至如今一年
- 创作初衷：结合过往仪表开发经验，希望做一款小程序，让一线运维工程师掏出手机就能完成拍照诊断、报文解析、生成报告，解决现场无PC、无后援的痛点
2. 产品简介
「掌师」是一款面向工业运维工程师的微信小程序，覆盖电力、水务、工控三大行业。核心功能：
完整功能清单与使用路径：
| 模块 | 功能 | 使用路径 |
|---|---|---|
| 拍照诊断 | 拍摄设备铭牌/故障画面 → OCR识别文字 → 匹配故障码库 → 生成置信度候选列表 | 首页「拍照诊断」→ 拍摄 → 开始识别 → 选候选 → 开始诊断 |
| 引导式诊断 | 按设备型号多分支故障树逐步问答 → 动态排除无关路径 → 输出确诊结论与维修建议 | 选候选 → 依次回答排查问题 → 生成结论 → 保存报告 |
| 诊断报告 | 结构化报告含设备信息、诊断路径、排查记录、结论与建议 | 诊断完成 → 查看报告 → 复制编号/保存 |
| 知识库 | 离线预置3个型号(威胜/林洋/海兴)30+条故障码；在线商店可下载10个型号知识包 | 底部Tab「知识库」→ 查看/搜索 → 知识商店下载更多 |
| 设备健康仪表板 | 健康评分、诊断趋势、故障分布、基线预警，支持按设备型号筛选 | 知识库页 → 仪表板入口 |
| 工具箱(8个) | 报文解析器(Modbus/645/376.1)、CRC校验(16/32/CS/XOR)、通信速查卡(RS485/232)、拨码计算器、拍照标注、语音速记、单位换算、维保提醒 | 底部Tab「工具」→ 点击各工具卡片 |
| 团队协作 | 成员统计、案例审批、设备备注、团队知识库 | 我的 → 团队协作 |
相比初赛 Demo 的升级：
- 新增OCR拍照识别：接入微信服务市场OCR服务，从模拟数据升级为真实图片文字识别
- 新增语音速记：原生录音+播放+管理完整闭环
- 新增设备健康仪表板：趋势分析+基线预警
- 诊断引擎完善：支持跳过/回退步骤，分支故障树覆盖F4.E001等核心故障码
- 工具模块功能进行完善
- 全部数据本地持久化，离线可用
- 隐私合规：摄像头/麦克风/相册/剪切板均仅作本地功能性调用，不采集、不上传用户数据
3. 产品演示视频
TRAE完成作品演示_【学习工作】掌师 — 工业设备智能诊断小程序_哔哩哔哩_bilibili
4. 产品创作历程
灵感来源：工作中常遇到RS485通信故障、采集终端无响应等问题，现场排查时往往需要PC端工具和远程技术支持。想到能不能用小程序解决？
初赛Demo阶段：搭建了基础框架——首页、知识库、诊断记录、工具四个Tab，诊断引擎实现了单设备型号的线性问答流程，工具模块有报文解析器和通信速查卡。
复赛打磨：
- 最大难点是 OCR拍照识别。初期用Canvas像素分析，真机上完全不工作。后来切换到微信服务市场OCR服务，但遇到订单支付后未生效、开发版调用限制等问题，最终通过正式版审核后完成验证
- 语音速记原本接入了微信同声传译插件，但因个人主体小程序无法授权该插件，重新调整为原生录音方案，转文字标注为「需企业主体」
- 隐私合规是提交审核时的新挑战：代码中调用了Camera、Record、Album、Clipboard等隐私接口，需逐一在后台声明用途并确保不采集用户数据
5. TRAE 实践过程
开发全流程均由TRAE辅助完成：
- 需求分析与架构设计：通过TRAE对话梳理功能清单、页面路由、数据流，生成PRD级别的任务分解
- 编码实现：所有页面JS/WXML/WXSS、工具函数、诊断引擎、OCR/ASR引擎均由TRAE逐文件生成，人工审查后微调
- 调试与修复：真机测试中发现的Bug（如Tab白屏、按钮事件拦截、头像选择失败、CRC校验错误等），通过TRAE定位根因并修改
- 文档同步：测试计划、测试遗留清单、隐私声明等配套文档也由TRAE协助撰写
关键任务 Session ID（不少于3个）：
2486413017224684:f78d3d92b3002f9b4db84cd7da29db88_6a6a90fceefb63bea7f4203d.6a6beaddaada6bcc0123eb95.6a6beaddaada6bcc0123eb93:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 08:22:53)
2486413017224684:ebc4bc6ed8db9a3830009f647bb90b2b_6a6a90fceefb63bea7f4203d.6a6bec0baada6bcc0123ebbc.6a6bec0baada6bcc0123ebba:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 08:27:55)
2486413017224684:12bd961011854066f828acb1a4d1a6bd_6a6a90fceefb63bea7f4203d.6a6bf9ccaada6bcc0123ed0b.6a6bf9ccaada6bcc0123ed09:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 09:26:36)
2486413017224684:f586bc3f8b449c827fb128d5a4540d6b_6a6a90fceefb63bea7f4203d.6a6bfc54aada6bcc0123ed6e.6a6bfc54aada6bcc0123ed6c:TRAE Work CN.0.1.43.no_sid.no_ppe.T(2026/7/31 09:37:24)
技术栈：微信小程序原生开发（WXML + WXSS + JS），Storage本地持久化，微信服务市场OCR API
后续规划：升级为企业主体后启用真实语音转文字和订阅消息推送；扩展更多设备品牌的故障树；增加故障案例图谱可视化