开始之前
安装完成后，只需三步：激活、填写 AI 密钥、开始归类。前两步各需两三分钟，完成后即可随时归类。
软件的五个页面
左侧导航自上而下依次为：
| 页面 | 用途 |
|---|---|
| 案件 | 日常工作区：归类、查看结果、导入 Excel |
| 查税则 | 税则树，按类、章、品目、子目逐级展开，查看编码位置与条文。无需联网 |
| 导入税则 | 仅在海关发布新年度税则时使用 |
| 设置 | 填写 AI 密钥，调整归类参数 |
| 关于 | 激活、续期、查看版本号 |
一、激活
激活需联网，不支持离线激活。
- 启动软件，待税则导入完成。
- 案件页顶部显示红色提示「未激活」，点击右侧的激活按钮。
- 在激活窗口复制本机机器码（CNHS- 开头），发给作者（微信 hsai2099），作者将回复激活码。
- 将激活码粘贴至输入框，点击激活。显示「激活成功」即完成；下方如有到期日，即为授权有效期。
图示为激活失败时的界面，以软件实际为准
激活失败的处理
窗口中的红字即为原因，请对照下表处理：
| 提示 | 处理方法 |
|---|---|
| 激活码无效，请核对后重试。 | 多为复制时带入空格或换行，删除首尾空白后重试 |
| 该激活码不属于本机，请联系作者。 | 激活码对应的是其他电脑的机器码，请联系作者重发 |
| 该激活码已被使用。 | 一个激活码只能用一次 |
| 本机已激活，如需重新激活请联系作者。 | 本机已完成激活 |
| 需要联网激活，请检查网络后重试。 | 检查网络后重试 |
| 操作过于频繁，请稍后重试。 | 稍候再试 |
| 激活已在服务器完成，但凭证未能保存到系统钥匙串，请联系作者。 | 激活实际已成功，请勿重复输入激活码，直接联系作者 |
关于页同样提供激活入口，激活后变为续期；点击左上角的软件图标亦可进入。
- 案件页顶部的红色提示消失
- 右上角的新归类按钮可以点击。仍为灰色时，见下文「按钮无法点击」
二、配置 API
点击左侧的设置，进入 AI 配置。未激活时也可填写，但归类需激活后方可使用。
| 字段 | 填什么（以 DeepSeek 为例） |
|---|---|
| base URL | https://api.deepseek.com |
| 模型 | deepseek-flash |
| API token | 你的 DeepSeek 密钥 |
测试连接
无需先保存，直接点击「测试连接」，结果显示在按钮下方。显示「连接正常」后，点击右下角的保存，底部状态变为「已保存」。
| 结果 | 原因 | 处理方法 |
|---|---|---|
| 连接正常 | 地址、模型名、密钥都对 | 保存 |
| API key 无效 | 密钥错了或已失效 | 在服务商后台重新复制，注意不要带入空格 |
| 端点或模型名不对 | 地址或模型名拼错 | 逐项核对，模型名须完整 |
| 连不上 | 网络不通或地址不可达 | 检查网络与代理，地址须以 https:// 开头 |
| 未配置 AI 模型 / 未配置 API key | 对应字段是空的 | 补全后重试 |
其他设置
| 设置项 | 建议 | 说明 |
|---|---|---|
| 模型支持图片 | 打开 | 默认关闭。未开启时，归类窗口中不显示选择图片按钮 |
| 思考档位 | 先用中 | 求快选低，疑难商品选高。两段归类共用同一档位 |
| 单案用量上限 | 保持默认 | 默认 100 万 token，防止单条用量失控。填 0 表示不限 |
| 单批上限 | 按需 | 默认 50 行。Excel 超出该行数将整批拒绝，需自行拆分 |
软件仅支持 OpenAI Responses 格式的接口。服务商若只提供 /chat/completions，将无法连接；DeepSeek 两者均支持。请勿填写 http:// 开头的地址，否则密钥将以明文传输。
- 测试连接显示连接正常
- API token 下方显示已配置
- 底部状态显示已保存
三、首次归类
- 点击左侧的案件，再点击右上角的新归类。
- 在商品描述框中粘贴描述。材质、用途、形状、加工工艺、是否涂层等信息越完整，结果越准确。例如：纯棉白色针织T恤 男式 圆领 短袖 未涂层
- 如需附图，点击「选择图片…」，支持 jpg、png、webp，一次至多 9 张。未见该按钮时，请在设置中开启「模型支持图片」。
- 点击开始归类。窗口随即关闭，归类在后台进行，进度显示于案件列表与右上角的队列胶囊。
- 通常 20 秒至 1 分钟出结果。期间请勿重复点击新归类，以免生成重复案件。
进度
案件状态依次显示为解析属性中、查类注中、查章注中、查品目注中、查子目注中、检索注释中、检索裁决中、查历史裁决中、读历史详情中、查归类决定中、生成推荐中。状态持续变化，即表示运行正常。
点击右上角的队列胶囊，可查看各条进度或暂停队列。暂停后，当前进行中的一条会完成，之后不再启动新任务。
查看与使用结果
点击案件所在行，右侧打开详情，内含 1 至 3 张候选卡片。卡片收起时显示编码、推荐标记、置信度与复制按钮；展开后可见归类路径（类、章、品目、子目）、申报要素、理由与依据标签，如 GRI 1。
| 操作 | 方法 |
|---|---|
| 复制编码 | 点击候选卡右侧的复制图标 |
| 采纳首选结果 | 点击正确，案件即告定案 |
| 首选有误 | 点击错误，填写正确的 10 位编码与理由，点击保存改判 |
| 均不采纳 | 点击改判，填写编码与理由后保存 |
依据标签中的 GRI 1、GRI 6，指《商品名称及编码协调制度》的归类总规则。复核存疑编码时，依据比编码本身更有参考价值。
- 案件状态由解析属性中推进至完成
- 详情里有 1 至 3 张候选卡片
- 展开卡片可见归类路径、申报要素、理由与依据
四、批量归类
建议先完成单个商品归类，再进行批量。批量按行扣积分，也按行消耗 AI 额度。
- 在案件页点击右上角的导入 Excel（注意区别于左侧的导入税则）。
- 点击下载模板，获取「批量归类模板.xlsx」，建议直接在模板中填写。
- A 列填写商品信息，自第 2 行起，每行一个商品。B 列放置图片，可整列留空。
- 点击选择 Excel，核对预览中的「有效 N 行」，无误后点击确认导入。
- 队列面板显示进度。完成后，可在批次页导出、下载或删除。
| 要求 | 说明 |
|---|---|
| 列名 | 须为「商品信息」与「图片」。若写作品名、描述等其他名称，不会报错，但显示有效 0 行 |
| 文件格式 | 仅支持 .xlsx，不支持 .xls 与 .csv |
| 图片 | 每行至多 9 张，单张不超过 4 MB，支持 png、jpg、webp、gif |
| 行数 | 不得超过单批上限（默认 50 行），超出将整批拒绝，需在 Excel 中拆分 |
失败的行可点击续跑单独重跑，不支持整批重试。因此首次批量建议仅放约 5 行，确认无误后再处理完整表格。批量完成的案件同样需逐条裁决。
- 预览中的有效行数与实际填写一致
- 队列显示全部完成
- 批次页能导出 Excel
按钮无法点击
请先查看案件页顶部的提示，再对照下表处理：
| 提示 | 处理方法 |
|---|---|
| 未激活 | 点击提示右侧的激活，见第一步 |
| 套餐已过期，请续费后点「刷新」。 | 联系作者续费后，点击刷新授权 |
| 无法确认授权状态，请联网后点「刷新」。 | 确认网络正常后，点击刷新授权 |
| 时间校验失败 | 校准系统时间并开启自动同步，再点击刷新授权 |
| 积分不足，请充值或等待下次重置后点「刷新」。 | 充值，或待积分重置后点击刷新授权 |
| 索引未建 | 刚安装时请稍候；持续出现时，在导入税则页重新导入 |
| 数据包过旧，请导入新版数据包。 | 向作者索取最新的 .hspkg 文件，见下文「更新税则」 |
| 未配置 API key | 在设置中填写 API token 并保存。仅锁定归类，查税则与导入 Excel 不受影响 |
| 当前无网络 | 恢复网络连接，归类需联网 |
| 无法读取系统钥匙串，请重试。 | 重启软件；仍无法解决时，联系作者 |
| 该设备已被禁用，请联系作者。 | 联系作者 |
常见问题
长时间显示处理中
展开队列胶囊，确认队列是否已暂停；如已暂停，点击开始。单条通常 20 秒至 1 分钟完成，数分钟无变化多为网络问题。
结果不准确
先检查描述中的材质、用途、工艺、涂层与配件，补全后重新归类。改判时理由为必填项，完成后请点击保存改判。
未显示选择图片按钮
在设置中开启「模型支持图片」，保存后重新打开归类窗口。
测试连接正常，归类却失败
测试连接仅发送很短的请求，归类请求要长得多。常见原因为账户余额不足或模型名拼写有误，DeepSeek 的模型名均为小写。以归类时的报错为准排查，比测试结果更可靠。
查找历史案件
案件页列出全部案件。批次页位于查税则旁，每个批次均可导出为 Excel。
更新税则
软件使用安装时内置的税则，不会自动更新。海关发布新年度税则后，顶部将提示「数据包过旧，请导入新版数据包。」，届时再行更新。
- 向作者索取最新税则数据包，文件后缀为 .hspkg。
- 点击左侧的导入税则。
- 点击选择 .hspkg 数据包，或直接拖入文件。
- 进度依次经过验签、开库、落盘、建索引，全程自动完成。
- 提示导入成功后返回案件页，顶部的过旧提示随即消失。
导入后如提示索引未建，说明导入未成功，请重新导入。
名词对照
| 名词 | 释义 |
|---|---|
| 税则、税则数据包（.hspkg） | 海关商品编码的规则库，安装包内置，日常无需处理 |
| 归类 | 确定商品对应的 10 位编码 |
| 10 位编码、申报码 | 报关单上申报的编码 |
| GRI | 《商品名称及编码协调制度》的归类总规则，依据标签中的 GRI 1 即规则一 |
| 候选、推荐项 | 软件给出的 1 至 3 个编码，首个标记为推荐 |
| 裁决、改判 | 对结果的判断：正确、错误，或改为你认定的编码 |
| 待裁决 | 尚未确认的案件 |
| 队列胶囊 | 右上角显示排队状态的按钮，展开可查看进度、暂停队列 |
| 续跑 | 继续处理未完成或失败的单个案件 |
| 思考档位 | AI 查证的细致程度，分低、中、高；档位越高，越慢也越准 |
本手册依据软件 v1.1.1 编写，引号内文字为界面原文，可搜索定位。图示仅作说明，并非软件截图，操作以实际界面为准。