Technical Specifications & Architecture

ZNW 自组网产品型号生成器

基于 Vercel Serverless Function 与多大模型（LLM）驱动的自组网产品型号智能生成与推导系统。

📖 项目简介

ZNW 产品型号生成器（Zero-Configuration Network Wireless Product ID Generator）专为无线宽带自组网（Mesh）、无线图传与专网通信设备打造。用户输入技术参数描述、上传产品规格书或技术方案图纸，系统即可按照自组网标准化命名体系，智能推导出严格规范的产品型号，并给出型号拆解说明与详细推理依据。

系统提供密码鉴权门禁、双主题切换（亮色 / 赛博暗色）、文档本地脱敏提取、历史记录及一键复制等实用功能。

✨ 核心特性

🤖 支持多主流大模型与国产模型（Multi-Provider）：
- Google Gemini：默认推荐 gemini-2.5-flash、gemini-3-flash-preview（速度快、成本低、推理准）
- Anthropic Claude：claude-sonnet-4-5、claude-opus-4-5、claude-haiku-4-5
- 硅基流动 (SiliconFlow)：免海外网络直连，支持 DeepSeek-V3.2、GLM-4.7、Qwen3.5-122B-A10B、Kimi-K2.5、MiniMax-M2.5
- OpenRouter：聚合多种国际先进大模型
- Ollama Cloud：支持云端托管开源大模型
📂 全格式输入与多模态识别：
- 技术文档 / 文本：直接输入或读取 TXT、Markdown 文档
- 规格书与表格：纯前端无依赖通过原生 DecompressionStream 快速解析 .docx 和 .xlsx，提取内容可就地修改
- 图纸与扫描件：支持 .pdf、.png、.jpg、.webp 等多模态视觉大模型直接识别提取
📐 严格内嵌工业级型号规范：
- 内置技术类别、频段代码、功率计算公式与设备形态代码库，输出结构化拆解 JSON
🎨 高质感工业设计界面：
- 默认工控科技风，支持亮色 / 暗黑（Dark Mode）一键无缝切换
- 生成结果以参数胶囊（Chips）直观呈现，并显示技术推导说明
- 历史记录保留在当前会话，支持一键快捷复制
🔐 轻量级私有访问安全：
- 前端门禁鉴权，仅授权用户可访问与调用 API

📁 项目结构

znw-naming/
├── api/
│   └── generate.js     # Vercel Serverless Function（后端多模型适配网关）
├── index.html          # 前端主页面（单文件，包含样式、交互与文档解析器）
├── vercel.json         # Vercel 路由重写与无服务器函数执行时长配置
├── .env.example        # 环境变量模板
└── README.md           # 项目说明文档

⚙️ 环境变量配置

在 Vercel Dashboard → Settings → Environment Variables 或本地 .env 文件中配置：

环境变量名	必填项	说明
`APP_PASSWORD`	是	前端鉴权密码，自定义任意强字符串
`GEMINI_API_KEY`	推荐	Google AI Studio 密钥（默认推荐模型 `gemini-2.5-flash`）
`ANTHROPIC_API_KEY`	可选	Anthropic Claude 密钥（用于 Claude 系列模型）
`SILICONFLOW_API_KEY`	可选	硅基流动密钥（国内直连，用于 DeepSeek、GLM、Qwen 等模型）
`OPENROUTER_API_KEY`	可选	OpenRouter 密钥（用于 OpenRouter 路由的大模型）
`OLLAMA_API_KEY`	可选	Ollama Cloud 密钥（用于调用 Ollama 托管模型）

提示：除了 APP_PASSWORD 必须配置外，其余 API 密钥只需按需配置你打算使用的模型提供商即可。

🚀 部署与使用

方式一：部署到 Vercel（推荐）

将本项目推送到 GitHub / GitLab / Bitbucket 仓库。
登录 Vercel，点击 Add New Project 导入该仓库。
进入 Settings → Environment Variables，根据需要添加环境变量（例如 APP_PASSWORD 和 GEMINI_API_KEY）。
点击 Deploy，部署完成后即可通过分配的域名访问。

方式二：本地开发调试

克隆代码并进入项目目录：

git clone <your-repo-url>
cd znw-naming

创建本地环境变量：

cp .env.example .env
# 编辑 .env 文件，填写你的真实 API Key 和 APP_PASSWORD

使用 Vercel CLI 启动开发服务器：

# 使用 npx 直接运行（无需全局安装）
npx vercel dev

# 或者先全局安装
npm install -g vercel
vercel dev

访问控制台提示的本地地址（通常为 http://localhost:3000）。

📊 支持的文件格式

文件格式	解析方式	适用场景
PNG / JPG / JPEG / WebP / BMP	多模态大模型视觉直接识别	产品外观图、铭牌照片、拓扑图、技术参数图纸
PDF	视觉模型 / 多模态解析	完整产品规格说明书、数据手册（Datasheet）
Word (.docx)	浏览器端解压原生解析 XML	方案设计书、项目技术要求文档
Excel (.xlsx)	浏览器端解压解析共享字符串与单元格	参数对照表、产品清单
TXT / Markdown	前端文本直接读取并支持二次修改	复制的设备参数草稿、纯文本描述

📐 ZNW 自组网型号命名规范

生成的型号格式为：
$$\textbf{ZNW-[技术类别]-[频率代码][功率代码][类型后缀]}$$

ZNW = Zero-Configuration Network Wireless（无线自组网）

1. 技术类别

代码	全称 / 含义
`SDR`	软件定义无线电 (Software Defined Radio)
`WFC`	WiFi 变频 / 无线现场通信
`MOD`	核心板卡 / 模块 (Core Module)
`WIF`	工业 WiFi 网桥
`DSP`	国产芯片方案
`NAR`	窄带 / 蜂群组网
`GWY`	网关设备 (Gateway)
`MESH`	默认通用自组网（技术类别不明确时使用）

2. 频率代码

代码	频段范围
`89`	800 ~ 900 MHz
`14`	1.4 GHz（常见如 1.428~1.448 GHz / 1.4GHz 专网）
`24`	2.4 GHz
`58`	5.8 GHz
`258`	双频 2.4 GHz + 5.8 GHz

3. 功率代码

计算公式：$$\text{功率代码} = \text{单通道功率(W)} \times 10 \times \text{通道数}$$
（计算结果取整，单通道 0.5W 记为 05）

典型配置	功率代码
单通道 0.5W	`05`
双通道 0.5W/ch	`10`
双通道 1W/ch	`20`
双通道 2W/ch	`40`
双通道 3W/ch 或三通道 2W/ch	`60`
双通道 5W/ch	`100`
双通道 20W/ch	`400`

4. 设备类型与修饰后缀

主类型：
- H：手持式 (Handheld)
- S：背负单兵 (Single Soldier)
- B：基地台 (Base Station)
- C：车载式 (Car / Vehicle)
- U：标准 1U 机柜式
- A：机载式 (Airborne / 无人机)
- M：嵌入式模块 (Module)
- T：通用终端 (Terminal)
附加修饰代码（可多选组合）：
- P：大功率（如 PM）
- N：全国产化芯片（如 NM）
- F：FPGA 硬件方案

5. 命名示例

ZNW-SDR-1460M：SDR 方案，1.4GHz 频段，双通道 3W/ch（代码 60），模块型
ZNW-SDR-14400PM：SDR 方案，1.4GHz 频段，双通道 20W/ch（代码 400），大功率模块
ZNW-SDR-1440H：SDR 方案，1.4GHz 频段，双通道 2W/ch（代码 40），手持单兵型
ZNW-WFC-14100U：WiFi 变频，1.4GHz 频段，双通道 5W/ch（代码 100），标准 1U 机架式
ZNW-DSP-1410NM：DSP 国产芯片方案，1.4GHz 频段，双通道 0.5W/ch（代码 10），全国产模块

🔌 API 接口说明

系统内置无服务器端点：POST /api/generate

请求体（JSON）

{
  "password": "your_app_password",
  "model": "gemini-2.5-flash",
  "text": "双通道手持单兵设备，每通道 2W 功率，采用 SDR 技术，通信频段在 1.4GHz...",
  "imageBase64": "",
  "imageMime": "",
  "pdfBase64": ""
}

响应体（JSON）

{
  "ok": true,
  "result": {
    "model": "ZNW-SDR-1440H",
    "parts": {
      "prefix": "ZNW",
      "tech": "SDR",
      "freq": "14",
      "power": "40",
      "type": "H"
    },
    "reasoning": "采用SDR技术，1.4GHz频段代码为14；双通道2W功率计算2×10×2=40；手持形态后缀为H，推导出ZNW-SDR-1440H。"
  }
}

📄 开源许可证

本项目基于 MIT License 开源。

ZNW Mesh Product Model ID Generator

Application & Engineering Screenshots