# 零依赖 Node + 一把 PowerShell：我用 200 行代码给政务窗口撸了个"读身份证建档"系统

> 场景很朴素：窗口单位要"读身份证 → 扫材料 → 存档 → 别人能查"。市面上的档案系统要么贵、要么重、要么和特定硬件绑死。这篇文章记录我如何用纯 Node 核心模块 + Windows 自带组件 + 浏览器原生能力，拼出一套能真正跑起来的单人窗口方案。

## 一、需求拆解

先说结论性的架构判断。窗口档案系统本质上是三件事：

![02-dashboard.png](https://developer.qcloudimg.com/http-save/yehe-12702702/e0ecfecd004a690314409fb2f6636982.png)

1. **身份信息采集**——身份证读卡器（华视 CVR-100UC 等）
2. **纸质材料数字化**——扫描仪 + 高拍仪
3. **档案的存储与检索**——这是最简单的部分

最容易踩的坑是把三个难度完全不同的问题当成同一种问题。读卡器需要对接厂商 SDK，扫描仪走系统组件，检索就是 CRUD。分开看，每个都有"最省力路径"。

## 二、读卡器：别慌，厂商早就把活干了

![03-entry.png](https://developer.qcloudimg.com/http-save/yehe-12702702/5a593bb76ab3369ca95467ac98cfafbf.png)

华视这类读卡器的 Web 服务版会随驱动常驻一个本地 HTTP 服务，默认 `127.0.0.1:19196`，三个 GET 接口：

```
GET /openDevice    # 连接设备
GET /readCard      # 读卡，返回 JSON（含 identityPic 芯片照片）
GET /closeDevice   # 断开
```

所以"对接硬件"其实就是服务端转发三个 HTTP 请求。核心代码不到 30 行：

```js
async function readCard() {
  const base = 'http://127.0.0.1:19196';
  await fetch(base + '/openDevice');           // 连接
  const payload = await (await fetch(base + '/readCard')).json();
  fetch(base + '/closeDevice').catch(() => {}); // 无论成败都断开
  return mapCardResponse(payload);
}
```

**真正花时间的是字段识别。** 不同批次的服务返回键名不统一：姓名可能是 `partyName`、可能是 `姓名`、可能是 `name`。我的做法是模糊匹配：

```js
const FIELD_PATTERNS = {
  name:    [/姓名/, /^name$/i, /partyname/i],
  idNumber:[/身份证|证件号/, /^idcard/i, /^cardno/i],
  // ...
};
```

递归遍历 JSON 树，按模式匹配键名。这样同一套代码能兼容华视、精伦、神思等不同厂商，新增品牌只需要加一条正则。

顺带一提：`readCard` 返回里的 `identityPic` 是身份证芯片里的照片 Base64，直接存下来，建档时自动多一份证件照，白捡的功能。

## 三、扫描仪：Windows 白送你一个 SDK

![04-scan.png](https://developer.qcloudimg.com/http-save/yehe-12702702/601cc1167c4f892f835d2ae782cd6024.png)

跨平台库（如 SANE for Linux）先放一边。Windows 上有个很多人不知道的宝贝：**WIA（Windows Image Acquisition）**，系统自带的图像采集组件，PowerShell 直接可调：

```powershell
$dm = New-Object -ComObject WIA.DeviceManager
$device = $dm.DeviceInfos.Item(1).Connect()
$img = $device.Items.Item(1).Transfer()
# 转 PNG 后 SaveFile
```

Node 侧用 `child_process.spawn` 调 PowerShell 脚本，扫描结果直接落盘，全程不需要装任何驱动级依赖。有个细节：`spawn` 要加 `windowsHide: true`，否则每次扫描都会闪一个控制台黑窗，窗口单位的体验瞬间破功。

## 四、高拍仪：根本不需要"对接"

高拍仪 99% 是标准 UVC 摄像头。浏览器一行 `getUserMedia` 直接出流：

```js
camStream = await navigator.mediaDevices.getUserMedia({
  video: { deviceId: { exact: id }, width: { ideal: 2592 } }
});
```

拍照就是 `canvas.drawImage(video)` → `toDataURL('image/jpeg', 0.9)`。支持多摄像头切换（现场拍一个机位、证件拍另一个机位的场景很常见），分辨率拉到 2592 宽——高拍仪的硬件原生分辨率。

## 五、存储：JSON 文件就够了

![06-detail.png](https://developer.qcloudimg.com/http-save/yehe-12702702/b0fb7c77919f942b7d36a3a84e6bcbf0.png)

![07-preview.png](https://developer.qcloudimg.com/http-save/yehe-12702702/05af13415329156db47e48b02e386c60.png)

单窗口、单机、数据量在千级别，上 SQLite 都是杀鸡用牛刀。我的存储层：

```js
function writeJSON(file, obj) {
  const tmp = file + '.tmp';
  fs.writeFileSync(tmp, JSON.stringify(obj, null, 2));
  fs.renameSync(tmp, file);  // 原子写入，防写一半断电
}
```

`records.json` 存档案元数据（含操作日志），`files/` 目录存原始图片文件。备份 = 拷文件夹，移植 = 拷文件夹。**运维成本为零这件事，在基层单位是决定性优势。**

敏感数据两个设计点：身份证号默认脱敏展示（`3301**********0326`），查看完整号码会写一条日志；所有检索、查看行为都留痕。

## 六、登录与权限：三种角色覆盖一个窗口单位的全部关系

- **管理员**：管用户、管设置
- **录入员**（按窗口分账号）：建档、扫描、检索
- **检索员**：只读

关键点：**权限必须在服务端拦，不能只靠前端藏按钮。** 前端 `nav-item.style.display = 'none'` 只是视觉安抚，接口层一个 `if (!isOperator) return 403` 才是真防线：

```js
if (p.startsWith('/api/')) {
  const user = authUser(req);
  if (!user) return json(res, 401, { needLogin: true });
  if (!isOperator && req.method !== 'GET') {
    return json(res, 403, { message: '当前账号为检索账号' });
  }
}
```

密码存哈希不存明文（`sha256(密码 + 盐)`），会话用内存 Map 存 token——单机服务重启后要求重新登录，对政务场景反而是安全加分项。

## 七、避坑清单

最后是踩过的坑，按痛感排序：

1. **bash 里写 PowerShell 单行命令会炸 `$` 变量**——一律写成 `.ps1` 文件再 `-File` 调用；
2. **中文 JSON 经 cmd 管道测试满屏乱码**——不是 bug，用 Node 脚本做集成测试，UTF-8 全程干净；
3. **杀 node 进程后文件夹仍被占用**——你的 shell 自己 cd 进去了，切出去再 move；
4. **前端硬编码的"操作员姓名"要全部替换成 `ME.name`**——权限系统上线前的最后一遍 grep 不能省。

## 写在最后

整套系统：Node 零 npm 依赖、前端一个 HTML 文件、PowerShell 两个脚本。功能覆盖读卡建档、WIA 扫描、高拍仪拍照、文件上传、模糊检索、脱敏、日志、三角色权限。

它当然不是企业级方案——没有并发控制、没有加密存储、没有审计合规。但对"一个窗口、一台电脑、一台读卡器"的真实场景，它是 20% 成本覆盖 95% 需求的那个答案。

工程上的启示就一句：**在动手写代码之前，先问清楚哪些活系统已经替你干了。** WIA 是系统送的，UVC 是标准送的，厂商 Web 服务是驱动送的——你要写的只剩胶水。

（文中所有人名、证件号均为虚构测试数据。）


场景很朴素：窗口单位要"读身份证 → 扫材料 → 存档 → 别人能查"。市面上的档案系统要么贵、要么重、要么和特定硬件绑死。这篇文章记录我如何用纯 Node 核心模块 + Windows 自带组件 + 浏览器原生能力，拼出一套能真正跑起来的单人窗口方案。

零依赖 Node + 一把 PowerShell：我用 200 行代码给政务窗口撸了个"读身份证建档"系统

后端

开发工具

客户端

零依赖Node核心模块+Windows自带WIA组件+浏览器原生能力，200行代码搭建政务窗口身份证建档系统。覆盖读卡器对接、扫描仪调用、高拍仪拍照、档案存储与检索，兼容多厂商设备，支持三角色权限与操作留痕。面向单人窗口场景，以20%成本覆盖95%需求，无需安装额外依赖即可落地运行。

集成测试

代码解释

敏感数据

Windows

SQLite

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

零依赖 Node + 一把 PowerShell：我用 200 行代码给政务窗口撸了个"读身份证建档"系统-腾讯云开发者社区-腾讯云

零依赖 Node + 一把 PowerShell：我用 200 行代码给政务窗口撸了个"读身份证建档"系统

零依赖 Node + 一把 PowerShell：我用 200 行代码给政务窗口撸了个"读身份证建档"系统

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐