海关编码查询

English

面向 macOS 与 Windows 的离线中国海关编码检索工具。应用可按 8 位税则号、10 位商品编码、13 位组合编码或中文商品名称查询，并明确区分官方记录、名称匹配和同义词候选。

本项目不是中国海关或中国国际贸易“单一窗口”的官方软件。查询结果仅供检索和初步参考，不能替代专业归类意见或海关审核。

功能

• 输入 8 位税则号，展示数据库中真实存在的 10 位子码；不会机械追加 00。
• 精确查询统一窗口 10 位商品编码及其 8 位父项。
• 接受 13 位输入，仅核验前 10 位，并将末 3 位标记为未经当前数据库核验的 CIQ 附加码。
• 支持官方商品名称、匿名同义词及模糊候选检索。
• 显示计量单位代码、监管标记、数据年度、父项状态和数据来源。
• 查询记录仅保存在本机，可随时清空；应用运行时不上传查询内容。

下载与安装

测试安装包位于 GitHub Releases。当前构建未进行商业代码签名：

• macOS：提供 Apple Silicon 与 Intel 版本；首次打开可能出现 Gatekeeper 提示。
• Windows：提供 x64 安装程序与便携版；SmartScreen 可能提示未知发布者。

请从 Releases 页面核对版本和 SHA-256，不要从不明镜像下载。完整操作说明见使用文档。

本地开发

需要 Node.js 24 或更高版本。

npm install
npm run dev

验证与构建：

npm run typecheck
npm test
npm run build
npm run package

仓库已包含经过脱敏处理的发布数据库，普通开发和构建不需要原始数据源。维护者如需重新生成发布数据库，需显式提供合法取得的源数据库路径：

python3 scripts/build_release_db.py --source /path/to/source.sqlite

数据与隐私

当前数据快照日期为 2026-07-27，包含 12,079 条官方 10 位商品编码和 8,956 条 8 位税则记录。发布数据库不含报关单、发票、企业商品号、历史映射、用户账号、会话、凭据或本地绝对路径。

代码使用 MIT License。MIT 许可证只适用于本项目代码，不代表对第三方或政府来源数据授予许可。数据来源、处理边界和再分发说明见数据与隐私说明。

文档

• 中文使用文档
• English user guide
• 数据与隐私说明
• 安全政策
• 更新记录

参与开发

欢迎提交问题和改进建议。涉及商品归类的修改必须提供可核验的公开依据；模糊相似度或经验判断不能作为自动确认编码的唯一依据。详见贡献指南。