跳到主内容
BULK REGISTER · 批量登记

一张表,一次传完

机房盘点、租卡商上架、经销商收货:手里本来就是一张表,不该逐台点提交。把序列号粘进来(或直接拖 CSV),浏览器本地算哈希,明文序列号不出这台电脑,一次最多 100 台,失败的行单独告诉你错在哪。

01

贴清单

02

量大要走密钥

公开自助

100 台/次 · 300 台/小时

不用注册、不用付费。几百台以内够用——按 100 台一批,分几次传完即可。每批之间不用等待,超了会明确告诉你还差多久。

运营方密钥

500 台/次 · 5000 台/小时

机房与租卡商规模,写邮件说明台数即签发:hi@cvin.org。拿到密钥后粘在下面,存在本标签页里,不会写进浏览器存储以外的地方。

一次性 5000 台+

走命令行

仓库里的 scripts/bulk-declare.js 支持断点续传:中断后重跑会跳过已入链的行,不会重复写。批次大小、并发、重试都可调。

提交前先体检。「体检」用 dry_run 只校验不写链——账本只增不减,第一次提交就在里面留下一批错行的话,谁都改不回来。所以顺序永远是:体检 → 拿错误表改干净 → 正式提交。
03

三个会被追问的问题

序列号真的不上传吗?不上传。上传的是 cvin:厂商.型号.形态.显存:16位哈希——哈希在你这台机器的浏览器里算完,服务端只收到哈希。能看到的是「有这张卡、型号是什么」,看不到「序列号是多少」。CVIN 的全部意义就在这:可核验,但不可反推你的资产清单。

中途断了怎么办?重跑同一张表即可。同 CVIN + 同来源在 10 分钟内只受理一条,已进去的行会被判为 duplicate_write 并跳过,不会重复入链、不会污染履历。响应里 idempotent: true 就代表「你重提的这一批本来就已经在里面」。

同型号但序列号写错了一台?错的会进错的地方——所以体检必须做。体检输出的是逐行 index + 错误原因,直接对着你的原表格行号看。真要撤销,走 异议通道标注,而不是删除(账本删不掉,这是设计不是缺陷)。

只要查不要写?→ 批量自查(买方/尽调视角,50 台一次)。要照着做一遍的步骤说明?→ 登记操作手册。要通过 API 接进自己的系统?→ 接入指南 的 POST /v1/declare/batch。