漳州大北农-成本通录入工作流-部署教程
跟着做，解压后双击一次就装好跑起来。适用于 Windows / Mac，不需要写代码，Docker 会自动装。
👀 先搞懂：这是干嘛的？
简单说：你在手机网页上传猪场记录表照片、或把群消息转发进邮箱，系统自动识别、自动填单、自动录入大北农平台——不用你登录平台、不用一格一格打字。你的电脑就是那个「自动干活的小帮手」，在后台安静接单。
✅ 现在就能自动帮你干的活
下面这些是已经真正跑通的单据——你只要拍张记录表照片（或上传 PDF 扫描件 / Excel 电子表）、转发一句文字，剩下的填单、校验、录入平台都自动完成：
| 业务 | 你怎么用 | 系统自动完成 |
|---|---|---|
| 母猪配种 / 分娩 / 断奶 | 拍照上传记录表（PDF 扫描件同样可以） | 识别耳号、日期 → 生成官方导入模板 → 自动录入平台 |
| 母猪历史（登记卡建档） | 拍照上传登记卡（PDF 扫描件、Excel 电子表也可） | 按建账日期规则取行、超期行单列汇总 → 生成官方《母猪历史》导入模板 |
| 母猪死亡 / 生长猪死亡 | 转发一句文字（如「死亡：LY0021 死亡」） | 自动识别耳号 / 批次 → 自动开单 |
| 母猪淘汰单 | 说明耳号、淘汰原因 | 先自动开一张猪只销售单 → 再开淘汰单并绑定，全程不用你操作 |
| 物资采购单 | 拍采购单据 | 识别后套官方模板 → 批量导入平台 |
| 猪只销售单 | 告知头数、单价 | 自动开单 → 提交 → 审核，全程闭环 |
| 物资领用 | 告知领用明细 | 自动填报领用单（教槽料走批次） |
| 费用填报 | 提供费用数据 | 自动归集并填报到成本模块 |
🧩 没有大北农成本通账号、没有邮箱也能用（基础用户模式）
上表的「自动录入平台」需要你有一个大北农成本通账号。如果暂时没有成本通账号、也没有邮箱，一样可以先把活干起来——系统会帮你把单据识别好、生成好官方导入模板 Excel，剩下的录入留给你自己或有账号的人去做。
成品文件会同时出现在两个地方，拿哪个都行：
| 在哪拿 | 位置 |
|---|---|
| 🖥️ 工作机（本机文件夹） | 解压目录下的「输出」文件夹：xlsx\输出\<模块>\（按模块分子目录存放） |
| 📱 手机任务卡片 | 「任务」页对应卡片的文件表最右侧，直接点「下载」即可拿到该 Excel |
· PDF：扫描件直接传，多页会逐页识别（单文件 ≤ 120MB，超 45MB 自动拆分识别）。
· Excel：只有「母猪历史（登记卡建档）」电子表会自动映射成官方导入模板；其他单据的电子表暂不转换，系统会把文件原样发回（等于帮你暂存/取回），你自行整理导入。原因：各场电子表列名格式不一，认错列会生成错误的导入表，宁可原样返还、不猜着做——后续按模块逐步支持。
· Excel + Word 配对（2026-10-15 新增）：把同一份扫描件用夸克同时转出 Excel 和 Word，一起选中上传（1 份 Excel + 1 份 Word）——系统互相比对，逐卡内容相似率 ≥80% 认定同一张卡，用 Word 读出的耳号补齐 Excel 缺失耳号再生成导入模板。Word 不支持单独上传。
1️⃣ 注册账号，等管理员审批
cloudshare.work
拿申请单号
手机或电脑浏览器打开 https://cloudshare.work，登录页点「申请注册」，填写：
| 填写项 | 要求 |
|---|---|
| 用户名 | 2–20 位字母/数字/下划线，之后不可改（你的机器名会由它生成） |
| 姓名 | 真实姓名，方便管理员认人 |
| 登录密码 | 至少 6 位，自己记住 |
提交后页面会给一个申请单号，把这个单号发给管理员，等他点通过。通过后用你的用户名 + 密码登录。
2️⃣ 一键部署
登录网页 → 生成并下载你的专属部署包 → 解压 → 双击一次启动脚本，剩下的全自动。
① 下载部署包
登录 https://cloudshare.work → 底部「设置」→ 点「📦 生成我的部署包」，在弹出的框里填好 2 项必填（大北农成本通账号、密码）即可；QQ 邮箱与 IMAP 授权码为选填，想用「转发邮件收任务」时再补，暂时不填也能正常跑。点「生成并下载」，得到一个 <你的用户名>_dbn_automation.zip。这个包已内置填好的配置（含 .env），解压即用。
② 解压
右键下载好的 zip →「全部解压」：包里自带 dbn_automation 文件夹，解压即得，不用自己先建目录。把整个文件夹放到不含中文、不含空格的位置，比如：
Windows：D:\dbn_automation Mac： /Users/你的名字/dbn_automation
运行用的几个文件夹（quark_profile、download、n8n_debug）启动时会自动创建；Excel 导入模板已随包附带在 xlsx\大北农模板\——都不用你管。
③ 双击启动（全自动）
进解压出来的 dbn_automation 文件夹，找到启动脚本双击它：
| 你的系统 | 双击哪个文件 |
|---|---|
| Windows | 一键部署·更新（Windows）.bat |
| Mac | 一键部署·更新（Mac）.command |
平时不用你管：有新版本时系统会主动通知你这台机器（像手机应用商店的推送），脚本会在你没在干活（没任务在跑、没等审批）的时候自动换上；开机时也会自动核对一次，关机期间错过的更新开机即补上。想先看「这次更新了什么」，到网页「设置 → 本地部署」就能看到本机版本、最新版本与更新内容。想马上拿到新版，随手双击一次即可。
脚本会自己一步步做完，你什么都不用管：
Docker
需要的开关
自动重启
跑起来
报到上线
网页
看到「20 秒后自动重启」的提示属正常：先把手头的东西存一下，让它重启。
重启后它会自己接着把剩下的装完，你不用再双击。想取消这次重启，在窗口里敲
shutdown /a 回车。
（备选）不想双击，用命令行手动启动
在解压目录打开命令行（Windows：地址栏输入 powershell 回车），执行：
docker compose up -d --build
以后改了 .env，需再执行一次让新配置生效。
关于 .env（一般不用动）
整包里 .env 已内置好：机器名、机器密钥、连接令牌，加上你填的个人账号（大北农账号密码、邮箱、授权码都是选填；没有成本通账号就留空，会自动走「基础用户离线模式」），全都写好了——通常什么都不用做。以后要改（比如补上 QQ 邮箱授权码、或换了邮箱），用记事本打开它，改完执行 docker compose up -d --build 重启生效。
.env。用记事本「另存为」时容易变成 .env.txt——保存类型选「所有文件」，别让它多出 .txt。
.env 里都有哪些字段？
| 字段 | 内容 | 示例 |
|---|---|---|
| WORK_NAME | 你的机器名（已自动填好） | zhangsan_WORK |
| AGENT_SECRET | 机器密钥／工牌，防止别人冒你的名领活（已自动填好） | — |
| WS_TOKEN | 连接令牌／系统大门钥匙（已自动填好） | — |
| DBN_USER | 你的大北农成本通账号（选填，没有可留空→走基础用户离线模式） | 你的工号/账号 |
| DBN_PASS | 你的大北农成本通密码（选填，没有可留空） | （只在本机，不外传） |
| MAIL_USER | 你的专用 QQ 邮箱（选填，填了才写） | xxx@qq.com |
| MAIL_PASS | QQ 邮箱 IMAP 授权码（选填，填了才写） | 16 位字母 |
| OCR_RELAY_URL | 识别入口（已自动填好） | — |
②
.env 里有你的密码，不要发到群里、不要截图、不要提交到任何代码仓库。
QQ 邮箱授权码怎么拿？（选填，暂时不用可跳过）
.env 补上这两项即可。
电脑登录 QQ 邮箱网页版 → 设置 → 账户 → 找到「IMAP/SMTP 服务」→ 开启 → 按提示用手机发短信 → 得到一串 16 位字母授权码，填到 MAIL_PASS。
这个邮箱是干嘛的？（选填；用的话只要一个，不用两个）
收任务 + 收结果，一个专用邮箱全包：把纸质记录表拍照转发到这个邮箱，系统自动读取开始开单（等于「邮件就是上传入口」）；每单处理完，系统再自动发结果回执到这个邮箱，手机里随时可查凭证。
为什么建议新注册一个「专门干活的」，不用个人主力邮箱？
| 好处 | 说明 |
|---|---|
| 不误伤私人邮件 | 系统靠读这个邮箱的未读邮件来接任务——专用邮箱里只有工作邮件，不会把你私人邮件里的图片误当任务去识别 |
| 单据好找 | 工作回执和私人邮件分开，月底对账、查历史单据一目了然 |
| 更安全 | 授权码只填给这套系统；万一需要更换，换专用邮箱即可，不影响个人邮箱使用 |
| 合规矩 | 每人一个专用邮箱是平台要求——多人共用一个邮箱会被 QQ 邮箱自动停用（已踩过坑） |
3️⃣ 验收：看到「绿灯」就算成功
登录网页看一眼——机器状态显示 🟢 在线，验收完成！🎉 想自己再核对，命令行执行 docker logs --tail 50 dbn-playwright，在输出里找这两行（大意一致即可）：
✅ 事件总线已连接 ✅ 总线握手确认
📆 日常怎么用？
| 场景 | 会发生什么 |
|---|---|
| 电脑开机 | Docker 自动拉起容器 → 自动连线报到 → 状态变 🟢，无需任何操作 |
| 电脑关机/没网 | 状态变灰，任务自动排队等你；你一开机，积压任务自动补跑 |
| 有新任务 | 任务自动派给你的电脑，网页任务卡片上能看到 5 步进度：受理→解析→预填→待审批→导入 |
| 要停掉助手 | 命令行执行 docker compose down（想再用就再 up） |
| 想看干活日志 | docker logs --tail 50 dbn-playwright |
📤 三种上传方式（都在手机网页「图片/文档」页）
页面上有两个上传区：上面绿色是图片，下面紫色是文件。图片和文件请分开传，不要混在一起选。
| 传什么 | 怎么操作 | 适合场景 |
|---|---|---|
| 📷 图片 | 点绿色「📷 选择图片」→ 可一次多选 → 点「🚀 开始上传所有图片」 | 现场拍记录表；多张合并成一条任务处理 |
| 点紫色「📄 选择文件（PDF / Excel）」→ 选 PDF → 点「🚀 开始上传文档」 | 已经扫描成 PDF；多页逐页识别，单文件 ≤ 120MB（超 45MB 自动拆分） | |
| 📊 Excel | 同上（紫色按钮），每个文件单独一条任务 | 母猪历史（登记卡建档）电子表可直接映射成官方导入模板； 其他单据电子表暂原样发回（不转换），详见图表上方的说明 |
⚙️ 单据默认值设置（配一次，自动补齐）
手写记录表上没写的格子（配种方式、库管、断奶负责人这些），系统不瞎猜——提前在网页上配好默认值，之后每次转单据自动补上：
手机/电脑打开网页 →「设置」→「单据默认值（按单据类型配置）」→ 按你的猪场填：
| 单据类型 | 可配的默认值 |
|---|---|
| 采购单 | 采购员 |
| 领用单 | 库管、领取人 |
| 配种单 | 配种方式、仓库、首配物资 |
| 断奶单 | 断奶负责人、转入批次、转入栋舍 |
📮 把微信群消息转发进系统（3 步）
现场的事已经在微信群里说清楚了（哪栋舍、什么事、数量多少）？不用打字、不用拍照——把群里那条消息直接转发到你的专用工作邮箱，系统读信后自动生成开单任务。全程手机操作，约 1 分钟。
说清楚了
转发成邮件
自动开单
MAIL_USER 那个）。
第 1 步 · 长按那条消息，点「多选」
在群里找到要发送的那条消息，长按它，弹出菜单里点「多选」。
第 2 步 · 勾选消息，点底部「✉ 邮件」
勾上要发的消息（可以选多条一起发），点底部工具栏最右边的信封图标。
第 3 步 · 收件人填专用邮箱，点「发送」
手机会自动弹出写邮件界面：主题、正文都不用改，确认收件人是你的专用工作邮箱，点右上角「发送」即可。
工作沟通群 微信群上的聊天记录如下，请查收。
──────── 2026-10-10 ────────
王五 08:34
保育3栋小猪死亡2头
发送之后，正常会看到：
| 现象 | 说明 |
|---|---|
| 邮件很快变成已读 | 正常——说明系统已收走这封邮件、开始处理了 |
| 手机网页「任务」页出现新任务 | 受理 → 解析 → 预填 → 待审批 → 导入，每一步实时显示 |
| 邮箱收到回执邮件 | 每单处理完，结果自动发回你的邮箱，当凭证留档 |
5 个注意事项：
| 要点 | 说明 |
|---|---|
| 只转发文字消息 | 是微信这个「✉ 邮件」按钮只能带走文字，图片、视频、语音它带不走（微信的限制）。照片系统照样能识别：手写记录表请用手机网页的「图片上传」拍照提交 |
| 一封邮件只说一件事 | 可以多选几条一起发，系统按消息逐条解析；但别把不同栋舍的事混进同一封，避免解析时串 |
| 信息写明白 | 像上面示例那样，把栋舍 + 数量写清楚，识别最准（其他信息有就写、没有不影响） |
| 别夹带无关聊天 | 私人对话、闲聊不要一并勾选，避免系统误识别出错误任务 |
| 发完没动静？ | 先查收件人邮箱是否填对，再确认 QQ 邮箱 App 登录的是专用邮箱 |
🛟 常见问题
分三类查：🚨 机器报错先看速查表，🛠️ 怎么做看操作步骤，🤔 为什么看背后原因。
🚨 报错速查表（先查这里）
| 症状（你看到的） | 原因 | 处置 |
|---|---|---|
| 双击启动后弹「是否允许」的授权框 | 装 Docker 需要管理员授权，属正常 | 点「是」放行即可，一次部署最多弹 1~2 次 |
| 脚本提示「Docker Desktop 自动安装未成功」 | 公司网络到 Docker 官网不通（脚本会先探测官网，不通就自动改用我们自己的服务器下载） | 脚本窗口会给出我们的下载直链（形如 cloudshare.work/downloads/DockerDesktopInstaller-amd64.exe）；浏览器打开下好，改名为 DockerDesktopInstaller.exe 放到脚本同目录，再重新双击一次「一键部署·更新」 |
| 脚本提示「20 秒后自动重启」 | 正常步骤：Windows 上跑 Docker 要开的两个系统开关，开完必须重启才生效 | 把手头东西存一下，让它重启。重启后它会自己接着装，不用你再双击。想取消这次重启，在窗口里敲 shutdown /a 回车 |
| 重启完，脚本没有自己接着跑 | ① 这台电脑「重启就还原」，把文件也清掉了；② 被安全软件拦了 | 先看解压出来的 dbn_automation 文件夹还在不在：不在了，说明这台电脑重启会清空数据、装不了 Docker，请换一台普通办公电脑；还在，就再双击一次「一键部署·更新」 |
| 脚本报「120 秒内未看到『总线握手确认』」 | 容器起来了但连不上系统（多为 .env 里 WS_TOKEN / WS_API 不对） | 核对 .env（WS_API 必须是 https://cloudshare.work），改好后重新双击「一键部署·更新」 |
| 日志报「密钥不匹配 / 握手失败」 | .env 里的 AGENT_SECRET 或 WS_TOKEN 复制错了（多了空格、少了字符） | 重新原样粘贴，然后 docker compose up -d --build 重启 |
| 网页显示我不在线 | 容器没跑起来 / 电脑断网 / 容器不存在 | 按顺序查：① 鲸鱼图标是否在转；② 电脑能否正常上网；③ docker ps 看 dbn-playwright 是否存在。都不行就把这三样截图发给管理员 |
| 改了 .env 不生效 | 配置只在容器启动时读取 | 执行 docker compose up -d --build 重启后生效 |
| QQ 邮箱收不到 / 登不上 | 授权码失效，或错填成了 QQ 密码 | 回 QQ 邮箱网页版重新生成 16 位授权码，重填 .env 并重启 |
🛠️ 怎么做
docker compose up -d --build 即可。同一时间只允许一台电脑用同一个机器名在线。为什么这么做：各猪场的电子表列名、格式不统一，认错列会生成错误的导入表（比不给更麻烦）。宁可原样返还，也不猜着做——后续会按模块逐步支持。
想省事：这类单据用拍照或PDF 扫描件传，就能直接生成导入模板。
🤔 为什么
🔐 最后，三句保密叮嘱
② 业务数据（耳号、头数、批次）只在本系统和平台间流转，不要导出去发给外部任何人；
③ 遇到任何页面报错，先截图 + 复制报错文字一起发给管理员，定位最快。