投稿类型：完整案例（拟收录《WorkBuddy 行业应用指南·制造·供应链·工程》章节）
行业：制造业 / 供应链 / 工程　岗位：工艺工程师（兼 QA）
话题标签：#WorkBuddy #AI办公
版本说明：本文所述系统当前迭代至 **v8.0.24**；文中数据均来自真实产线开发与部署。


----
## 引子：起点——产线曾经用 Excel 手工记录（痛点从哪来）

先说清楚"从 0 到 1"的 0 是什么样的——因为反差越大，越能说明问题。
我所在的是一家制造企业的控制器装配产线（以下简称"某控制器产线"），整线 6 个工位、10 台一批流动。在系统上线前，**质量追溯全靠 Excel 手工记录**：
- 每个产品关键零件条码 + 工单，由各工位操作员在 Excel 里一行行敲；

- 绝缘测试（TH2683A）手工测试的绝缘电阻值，**测完手抄进表格**；

- 多工位异步装配，条码分散在工位 1（工单+锚定码+部分零件）和工位 4（补全剩余零件+绝缘），靠人去"拼"完整记录。

这套做法的坑，产线待过的人都懂：

| | | |
|:-:|:-:|:-:|
|痛点|Excel 手工记录时的状态|后果|
|漏扫 / 错序|全凭人眼核对，下班前才发现缺条码|整批返查，半天没了|
|版本不一致|每人一个本地 xlsx，U 盘传来传去|追溯时对不上，谁改的都说不清|
|断电丢数据|没存盘就崩，白记|重录，怨声载道|
|绝缘值手抄|测完笔填，偶尔抄错位数|质量判错，隐患进下工序|
|中断不可续|电脑重启，前面录的全得重来|节拍打乱，线长骂街|
一句话：**记录这件事，占了产线大量隐形工时，还不可信**。这就是我要用 WorkBuddy 解决的"0"。
![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/f9c8bac908226979462dd8c8751b80c9.png)

----
## 一、输入材料（WorkBuddy 拿到什么才开始干）

投喂给 WorkBuddy 的"原料"：
- **现状吐槽清单**：上面那张 Excel 痛点表，就是第一版需求。

- ** 需求明细表**（图02）：把产线的口语化吐槽逐条拆成可执行需求，分 **A. 界面与交互 / B. 部件·总成与数据库 / C. 录入与比对 / D. 工单管理** 等类别，每条标注**来源版本**（初版 / vN）与**状态**（已实现 / 已调整）——这就是贯穿整个项目的"需求台账"，也是后面验证与迭代的对照基线。

- **工单与条码规格说明**（脱敏）：工单号规则、各零件条码位数、锚定码（功率板）定义。

- **工位配置清单**：工位 1 客户端录入、工位 4 服务端兼录入（厂内局域网），支持"单工位 / 多工位"切换。

- **绝缘测试仪通信协议**：TH2683A，串口 COM5 / 9600，8 位字符匹配，读绝缘电阻值。

- **验收标准**：漏扫告警、错序拦截、中断续录、测试门禁全绿才能上线。

![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/4ad738ff2c48233ec356ba64916986fa.png)


----
## 二、WorkBuddy 配置（用了哪些能力）

本案例最能体现 WorkBuddy 价值的点：**工艺工程师不写代码，靠自然语言把 Excel 痛点拆成可执行任务，由 WorkBuddy 生成并维护整套前端 + 服务端代码**。
用到的产品能力：
1. **对话式应用开发**：直接描述"多工位异步聚合 + 服务端单一真相 + 客户端瘦录入"，WorkBuddy 产出单 HTML 前端 + `sync_server.py` 服务端（HTTP:8080 / WS:8765）。

1. **需求拆解与台账管理**：把 66 条需求整理成带状态跟踪的明细表（图02），每轮改动都对得上"哪条需求、何时、改成什么"。

1. **多轮对话修 BUG / 提改进**：在对话里直接贴报错现象与诉求，WorkBuddy 定位根因、给出修复与改进（图03）。

1. **Skill（技能）协同**：- `web-app-post-build-verify`：每次改完网页程序后自动复盘自检（JS 语法、零外部依赖、DOM 引用安全、空状态、数据兼容）。
	- `barcode-html-verify`：针对条码系统的版本特定验证技能，含断言数与版本检查点。

1. **本地文件读写**：直接在工作目录落地 `条码记录系统.html` 与 `sync_server.py`，并做 md5 交叉验证确认改动真正落到发布包。

1. **自动化测试纪律（"发布铁律"）**：多套测试全绿 + dev↔deploy↔通用包 md5 一致 + 端口预检 + bat 文件 CP936/CRLF/无 BOM。这条是和 WorkBuddy 一起固化下来的上线门槛。

![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/2a4d3faee36042026f81d3443a739b3b.png)**公开提示词示例**——工艺工程师的真实用法就自然语言提问反馈，不需要任何代码基础：
【① 首次需求描述】
做一个单文件 HTML 的条码记录系统：三个关键零件（接触器/功率板/电容板）扫码逐条录入并校验位数；
同一工单的条码要聚合到一条记录；断电不丢（IndexedDB + localStorage 兜底）；关键参数出一张 SPC 趋势图。

【② 报 BUG + 要根因（不只要"改好"）】
单机模式下点提交报"锚定码为空"，但协同模式是正常的。
先定位根因——是哪段逻辑取错了值？再给修复方案，并解释为什么产线之前一直没暴露这个问题。

【③ 架构升级】
现在多工位各存各的、聚合要人工拼。改成"服务端单一真相 + 客户端瘦录入"：
新增 sync_server.py（HTTP:8080 / WS:8765），工位1推送工单+锚定码+部分零件，工位4按锚定码调出补全剩余条码+绝缘值再提交。

----
## 三、操作步骤：从 0 到 1，再到持续迭代

### 阶段一：0 → 1（v6.44，第一次把记录搬出 Excel）

- **目标**：先解决"漏扫、丢数据、绝缘值手抄"三件最痛的事，不追求一步到位。

- **做法**：WorkBuddy 生成单 HTML 文件，把 Excel 那张表变成浏览器里的录入界面。

- **关键能力**：- **三层存储容灾**：IndexedDB / localStorage / OPFS，断电不丢，告别"没存盘白记"。
	- **SPC 质量报表**：关键参数自动出趋势，不用再手算。
	- **TH2683A 集成**（Web Serial / COM5 / 9600）：绝缘电阻值自动落记录，**绝缘值不再手抄**。

- **意义**：从"人记 Excel"到"系统记"，第一步迈出去了。但此时还是单机单文件，多工位各自存、靠人工拼——下一个痛点来了。
![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/1cb8f540da4ac87ae13b198c6af87814.png)
### 阶段二：1 → N（v8.0，解决多工位异步聚合）

- **痛点**：单文件各工位各存各的，聚合靠人工拼，和当年拼 Excel 没本质区别。

- **决策**：改为**服务端单一真相 + 客户端瘦录入**。新增 `sync_server.py`，工位 1 录工单+锚定码+部分零件→推送给服务端；工位 4 按锚定码调出记录、补全剩余条码 + 绝缘值→提交。

- **协同规则**：参数设定以工位 4 为准，工位 1 接收推送更新；意外中断重启后提示"未完成工单"，操作员选择继续或重来。

- ![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/0271330201ca768fc5faca0f6db7870d.png)

### 阶段三：持续迭代（v8.0.x → v8.0.24，稳定性打磨）

- 修复 v8.0.8 历史 BUG：删除注释时误把 `getCollab` 模块整段吞掉，靠"分行 + 启动守卫"修复，并固化为发布铁律。

- 修复 P0 BUG「单机模式下提交报『锚定码为空』」：根因是单机数据路径仍沿用协同逻辑取左功率板值 → 改为**单机取自身板号、协同才作定位锚定码**；漏扫仍拒收并提示。这是典型"现场才暴露"的隐患（产线跑了很久协同模式，最近服务端跑单机才触发）。

- UI 改进：绝缘度测量进度条归位到输入区下方、部件库表头 sticky 固定（变种再多也不顶出视野）、TH2683A 回车触发 / COM 口色阶 / 12 秒测量进度条。



----
## 四、产出物（可验收成果）

>**一句话定义：本案例的交付物 = 一套在真实产线连续运行的多工位条码聚合系统 + 配套工程资料（需求台账 / 自动化测试门禁 / 部署包 / 发布文档）。** 按交付物逐项列清，便于对照验收。


| | | | |
|:-:|:-:|:-:|:-:|
|#|交付物|形态|交付 / 验收方式|
|1|多工位条码聚合系统（前端）|单文件 `条码记录系统.html`（三层存储 + SPC + TH2683A 集成）|浏览器直接跑通录入 + 校验 + SPC 出图|
|2|协同服务端|`sync_server.py`（HTTP:8080 / WS:8765，单一真相）|工位 4 启动成功、工位 1↔4 记录自动聚合完整|
|3|通用部署包（免装 Python）|`多工位程序_通用部署包_v8.0.24/`（68 文件，含便携运行时）|拷到任意 Windows 一键启动，同行可直接复现|
|4|产线部署版|`多工位程序_v8.0.24部署版/`（29 文件，含发布说明）|工位 4 实际生产运行|
|5|SPC 质量报表|I-MR 控制图 / 运行图|绝缘值趋势可追溯、可验收|
|6|自动化测试门禁|`verify_v79` / `unit_logic` / `test_server_v78·v79`|496+ 断言全绿（见下方指标）|
|7|需求台账|需求明细表（标注来源版本 + 状态）|逐条可对照"改到哪、为什么改"|
|8|验证 / 发布文档|各版本发布说明 + `barcode-html-verify` 验证技能|`条码记录系统.html` 的 md5 三处一致（dev = 标准包 = 通用包）|
**测试门禁指标（发布铁律 · 全绿可验收）**：`verify_v79` **496/0** · `unit_logic` **49/0** · `test_server_v79` **112/0** · `test_server_v78` **5/0** · `py_compile` 通过；md5 三处完全一致。
![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/68215e0a608a9450831e039eff14a610.png)**改造前后对比（这就是"从 0 到 1"的落地证据）**：

| | | |
|:-:|:-:|:-:|
|维度|Excel 手工时代|v8.0.24 系统|
|记录方式|人敲 + 手抄绝缘值|扫码 + 自动读取|
|数据可靠性|漏扫错序靠人眼|漏扫告警 / 错序拦截|
|断电|白记重录|三层存储容灾|
|多工位聚合|人工拼表|服务端单一真相自动聚合|
|中断|全重来|提示续录|
|上线门槛|无|496+ 断言全绿 + md5 证据链|
**可验收标准**：产线实际连续生产，工单记录 100% 聚合完整、绝缘值可追溯、中断可续录、测试门禁全绿。


----
## 五、可复现部署步骤（同行照做即可搭起来）

环境准备
- 一台跑服务端的电脑（产线工位 4，Windows）；通用部署包已内置便携运行时，免装 Python。
- 录入端任意现代浏览器（Web Serial 需 Chrome / Edge 系）；局域网互通。
文件结构
多工位程序_通用部署包_v8.0.24/
├── 条码记录系统.html       # 单文件前端（三层存储 + SPC + TH2683A 集成）
├── sync_server.py          # 服务端：HTTP:8080 / WS:8765，单一真相
├── 启动服务.bat            # CP936 / CRLF / 无 BOM，端口预检后拉起服务端
├── 打开程序.bat            # 一键在浏览器打开录入界面
├── echarts.min / xlsx.full.min    # 图表 / Excel 导出（已本地化，零外网依赖）
├── verify_v79.js / test_server_v78·v79.py / unit_logic.js   # 自动化测试套
├── 部署工具/  runtime/     # 一键部署工具 + 便携运行时
└── v8.0.xx_发布说明.md     # 各版本迭代留痕
![image.png](https://developer.qcloudimg.com/http-save/yehe-12791416/bf5ad469b305bf9615a5e02b029aba6d.png)
----
## 六、常见问题（FAQ）

**Q1：你不会写代码，这套系统怎么做出来的？**
A：我没有写一行生产代码。我用自然语言把产线痛点和需求描述给 WorkBuddy，由它生成并维护整套前端（`条码记录系统.html`）+ 服务端（`sync_server.py`）；我只在工艺判断、验收标准、现场验证上做决定。工艺工程师当"产品经理 + 验收人"，WorkBuddy 当"开发搭档"。
**Q2：多工位数据会不会丢、会不会各录各的？**
A：不会。架构是**服务端单一真相 + 客户端瘦录入**——数据只在服务端落库，客户端不各存各的；客户端侧再叠三层存储（IndexedDB / localStorage / OPFS）做断电容灾，重启不白记。
**Q3：绝缘测试值怎么自动进系统？不是要手抄吗？**
A：TH2683A 接 COM5 / 9600，通过 Web Serial 读取**绝缘电阻值（MΩ）**自动落记录，测完即存，不再手抄，也避免了抄错位数的质量隐患。
**Q4：上线靠什么兜底，产线凭什么敢用？**
A：靠"发布铁律"——多套测试全绿 + dev/标准/通用包 md5 三方一致 + 端口预检 + bat 编码检查。每次改动都留 md5 + grep 证据链，证明改动真正落到发布包，不是"改好了"口头说。
**Q5：同行能不能直接跑起来？要不要装环境？**
A：能，且**免装 Python**。通用部署包内置便携运行时，拷到任意 Windows，运行 `启动服务.bat` / `打开程序.bat` 即可，零外网依赖（echarts、xlsx 已本地化）。
**Q6：示例里有公司、条码信息，发布安全吗？**
A：指南要求示例脱敏，本文已处理：公司名 / 人员用"某制造企业 / A 产线"代称，内网 IP 用 192.168.0.x 示意；改造前 Excel 截图（图01）已**整列遮蔽序列号**，仅保留表头与日期作真实产线佐证。
**Q7：单工位小批量也能用吗？**
A：能。系统支持"单工位 / 多工位"切换，少量产品时切单工位独立运行，不依赖服务端。
**Q8：后续怎么迭代维护，会不会失控？**
A：66 条需求台账是迭代基线，每次改动都对照"哪条需求、改成什么、状态如何"；过测试门禁 + 出发布说明；验证技能 `barcode-html-verify` 随版本同步更新断言数。改到哪、为什么改，全程可追溯。


----
## 七、经验总结（给同行工艺工程师）

1. **别一上来就想做"大系统"**：我从 Excel 痛点表出发，先用 v6.44 单文件版解决最痛的三件事（漏扫/丢数据/绝缘手抄），跑顺了再迭代架构。0→1 比 0→100 重要。

1. **把需求做成台账**：66 条需求逐条标注来源与状态，改到哪、为什么改，一目了然——这是"可复现"和"可验收"的底气。

1. **制造业案例稀缺，反而好上手**：我们这行不缺真实痛点，缺的是把它变成系统的人。WorkBuddy 让工艺工程师自己当开发者，需求理解零损耗。

1. **验证纪律比功能多更重要**：496+ 项断言全绿 + md5 三方一致，是产线敢用的底线。

1. **中断续录、错序拦截**这类"现场才想得到的细节"，是通用工具替代不了的——正因为是自己写的，才贴着产线长。

投稿类型：完整案例（拟收录《WorkBuddy 行业应用指南·制造·供应链·工程》章节）行业：制造业  供应链  工程　岗位：工艺工程师（兼 QA）话题标签：#WorkBuddy #AI办公版本说明：本文所述系统当前迭代至 v8.0.24；文中数据均来自真实产线开发与部署。

从 Excel 到产线大脑：用 WorkBuddy 把"手工记条码"做成多工位聚合系统

装配产线的工艺工程师，用 WorkBuddy 从零搭起多工位条码聚合系统。产线原先靠 Excel 手工记录，漏扫、丢数据、绝缘值手抄；如今单 HTML 前端 + Python 服务端实现扫码自动采集、工位协同聚合、SPC 质量报表与绝缘测试仪直连。文中给出 66 条需求台账、可复现步骤、发布铁律与 496+ 断言全绿的验证证据，同行可照做。

开发工具

后端

物联网

WorkBuddy助力某控制器产线实现从Excel手工记录到多工位条码聚合系统的数字化转型，通过自然语言配置解决漏扫、丢数据、绝缘值手抄等痛点。v8.0.24系统实现服务端单一真相、三层存储容灾、TH2683A自动采集及SPC质量报表，496项断言全绿验收，工单记录100%聚合完整，可复现部署方案供同行直接采用。

数据库

WorkBuddy 

Windows

容灾

Python

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

从 Excel 到产线大脑：用 WorkBuddy 把"手工记条码"做成多工位聚合系统-腾讯云开发者社区-腾讯云

从 Excel 到产线大脑：用 WorkBuddy 把"手工记条码"做成多工位聚合系统

从 Excel 到产线大脑：用 WorkBuddy 把"手工记条码"做成多工位聚合系统

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐