chore(tools): add bypos-collector (条码批量采集器源码备份) #19

2026-06-24T10:24:45+08:00

lixu commented

2026-06-24 10:24:45 +08:00

Summary

把"中心库商品采集器"源码独立归档到 tools/bypos-collector/,作为代码备份并方便后期迭代。不改动主服务、不影响 CI、不入库任何二进制或采集数据。

该工具是单文件本地程序(自带 go:embed 的 Web 控制台),按条码批量查询云店「新增商品」所用的同一中心库 zc.bypos.net,把商品档案(品名/规格/单位/产地/进价/零售价)落地为 JSONL,供后续导入天工/goods。

不影响 CI:它是独立 Go module(自带 go.mod, module byposcollector),与 api/ 互不依赖;CI 的 Go 作业 working-directory 为 api/,不会编译 tools/。

tools/bypos-collector/
  main.go        # 本地 HTTP 服务 + 浏览器自启 + /api/{start,stop,stats,download,export.csv}
  collect.go     # 签名(md5 sparm)、EAN-13 校验位、范围/清单枚举、并发+限速、JSONL 落库、断点续采
  web/index.html # 内嵌控制台 UI
  build.sh       # 交叉编译 windows/amd64 .exe + linux 测试二进制
  README.md      # 设计说明 + 接口逆向备忘
  使用说明.md     # 使用者操作说明
  .gitignore     # 排除 *.exe / *.jsonl / *.csv / *.log

注意:中心库账号 id(sdogid)目前作为默认值写在 collect.go(可用 -sdogid 覆盖)。若仓库公开建议改为从环境变量读取。

## Summary 把"中心库商品采集器"源码独立归档到 `tools/bypos-collector/`,作为代码备份并方便后期迭代。**不改动主服务、不影响 CI、不入库任何二进制或采集数据。** 该工具是单文件本地程序(自带 go:embed 的 Web 控制台),按条码批量查询云店「新增商品」所用的同一中心库 zc.bypos.net,把商品档案(品名/规格/单位/产地/进价/零售价)落地为 JSONL,供后续导入天工/goods。 **不影响 CI**:它是独立 Go module(自带 go.mod, module byposcollector),与 api/ 互不依赖;CI 的 Go 作业 working-directory 为 api/,不会编译 tools/。目录: ``` tools/bypos-collector/ main.go # 本地 HTTP 服务 + 浏览器自启 + /api/{start,stop,stats,download,export.csv} collect.go # 签名(md5 sparm)、EAN-13 校验位、范围/清单枚举、并发+限速、JSONL 落库、断点续采 web/index.html # 内嵌控制台 UI build.sh # 交叉编译 windows/amd64 .exe + linux 测试二进制 README.md # 设计说明 + 接口逆向备忘使用说明.md # 使用者操作说明 .gitignore # 排除 *.exe / *.jsonl / *.csv / *.log ``` 注意:中心库账号 id(sdogid)目前作为默认值写在 collect.go(可用 -sdogid 覆盖)。若仓库公开建议改为从环境变量读取。

lixu added 1 commit 2026-06-24 10:24:45 +08:00

chore(tools): add bypos-collector (条码批量采集器源码备份)

CI / Python (ingestion) (pull_request) Successful in 12s

Details

CI / Migrations (postgres) (pull_request) Successful in 23s

Details

CI / Go (api) (pull_request) Successful in 48s

Details

e746b9cd31

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

lixu merged commit a2ef7319e9 into main

2026-06-24 10:27:15 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: lixu/goods#19