帮助

快速开始

1. 右上角「注册」：填邮箱和密码（至少 8 位），昵称可选。注册后即可下载。
2. 已有账号点「登录」。从 SNEX 系统跳转过来的链接带一次性票据，打开后自动登录，不用另外注册。
3. 登录后右上角账号菜单可以看今日额度、进入工作台、退出登录。

找素材（浏览与筛选）

• 首页：节日备货（按下一个美国节日倒数排序）、按商品方向找素材、最近入库、近 30 天出单榜（只列有真实出单的图案）、专题。
• 筛选：搜索页点「筛选」展开商品方向、节日、风格、比例。选项与工作台的分类体系同步，地毯、桌布的圆形 / 方形子类直接列在父品类后面（选「地毯」含全部形状，选「圆形地毯」只看圆形）。同一组里多选表示「任一命中」，不同组之间同时满足。「未识别品类」是系统没识别出适用品类的图案。已选条件以标签显示，点 × 去掉，「清空」全部去掉。
• 只筛选、不输关键词：结果是符合条件的全部图案，没有数量上限，显示的数量就是准确总数。
• 缩略图底色：结果区右上角可切换「自动 / 透明格 / 浅底 / 深底」，看透明图案时有用。
• 图案没有名称。卡片和详情页用分类、标签和编号（如 #12345）指代图案；和同事沟通时报编号即可。

关键词搜索

在搜索框输入主题词（中英文都可以），回车或点「搜索」。一次搜索同时做两件事：

1. 关键词匹配：匹配图案的分类、标签和描述。
2. 语义匹配：把文字和图片画面比对，能找到没打对应标签、但画面相符的图案。

不要按文件名、模板名或编号搜：系统不保存来源名称。

以图搜图

• 上传参考图：点搜索框右侧的图片按钮选文件；也可以直接在搜索框里粘贴截图，或把图片拖进搜索框。可以再加一段文字描述。
• 查相似：鼠标移到结果卡片上点「查相似」，或在图案详情点「查相似」。页面顶部会显示参考图，点「取消」退出。
• 以图搜图的结果卡片会显示相似度。相似不等于重复，也不等于同源，只表示画面接近。

排序与相似度阈值

没有检索词时默认「最新入库」，有检索词（文字、参考图或查相似）时默认「综合推荐」。

最低相似度

有检索词时，排序框左边会出现「相似度 ≥ …」下拉框。

• 「综合推荐 / 相关性」排序：可以选「不限相似度」。
• 「近 30 天出单 / 最新入库」排序：必须有阈值，系统预选推荐值：文字搜索 30%、以图搜图 60%。结果 = 相似度达到阈值的图案 + 关键词命中标签的图案，再按出单或最新排。结果太少就调低，太杂就调高。

结果数量

图案详情

• 顶部：适用品类（点击进入该品类）、标签、编号。状态不是「可选用」时会提示：待复核（可以浏览和下载，复核通过前不建议交付生产）或不可用（仅供查看，不能选用或交付）。
• 预览：未登录带水印；登录后为无水印预览。
• 尺寸版本：同一图案的每个尺寸单独一行（尺寸、比例、格式、透明背景、来源、大小），「主版本」是使用最多的那个。点行切换预览；登录后每行可单独下载，或点「下载当前版本」。
• 需要其他尺寸：输入宽、高（像素，至少 16），点「按需拉伸并下载」。没有现成版本时由主版本拉伸生成（最长约 30 秒），放大时会提示倍数，请注意印刷清晰度。生成过的尺寸会出现在版本表里，来源标为「拉伸生成」。
• 右栏：文件与归属（适用品类、标签、尺寸版本、入库时间、近 30 天出单 / 出货 / 上架）、来源、用途建议、同源关系、生产文件（裁片排版图，登录后可查看）。
• 相似图案：按画面相似度推荐，点「查看更多相似」进入查相似。
• 反馈问题（登录后）：选择标签错误 / 重复素材 / 文件问题 / 疑似侵权风险 / 其他，可补充说明，由素材管理员处理。

批量下载

登录后，搜索结果上方有「批量选择」和「下载全部结果」。

1. 挑选：鼠标移到卡片上出现复选框，勾任意一个（或点「批量选择」、在网格上拖动）进入选择模式。勾选跨翻页、换筛选都保留，刷新也不丢。底部浮条显示已选数量和今日还可下载的文件数，可「清空」「加入清单」「下载」。或者直接点「下载全部结果」：下载当前搜索 / 筛选的全部图案（按当前排序）。
2. 选择下载范围（见下表）。
3. 核对预览：对话框显示共多少文件、多大、来自多少图案、跳过了多少图案，以及今日下载额度。
4. 点「下载 N 个文件」，浏览器直接保存 ZIP（边下边存，可在浏览器下载列表看进度）。文件名形如 pattern-<编号>-<宽>x<高>.png。

下载对话框里「跳过我下载过的图案」默认勾选：近 180 天下载过的不再下载、不占额度。下载过的卡片标「已下载」。

停用、已删除和不可用的图案不会下载；「拉伸生成」的版本不计入「全部尺寸」「指定尺寸」。

每日额度

• 按北京时间 0 点重置。
• 查看：右上角账号菜单「今日额度」，显示所属套餐和已用 / 上限（「不限」表示没有上限）。素材管理员等不计额度的账号不显示。
• 批量下载超出剩余额度时不会整包拒绝，而是下到额度用完为止：对话框会提前提示「本次将下载前 N 个文件」。额度已用完时提示明天重置。
• 搜索次数用完后，新的检索会提示额度已用完；翻页和分类浏览不受影响。
• 需要更高额度请联系系统管理员调整套餐。

选图清单、账号与 API key

• 详情页「加入选图清单」或多选后「加入清单」，可选已有清单或新建。清单默认仅自己可见。
• 在工作台「选图清单」里核对、调整顺序、移除、批量下载（账号菜单 →「进入工作台」）。
• 「最近使用」（需登录）：近 180 天下载、选用或交给 OPC 的图案，按最后一次使用排序，可多选或「下载已加载的全部」。再次下载同样计入当日额度。
• 需要用脚本取图：在工作台「API key」创建个人 key（Authorization: Bearer rk_…）。明文只在创建时显示一次；能力不超过账号角色；同样受每日额度约束。

接入方（开发者）

• 接口文档：交互式 OpenAPI 在 /api/v2/docs，机器可读版本 /api/v2/openapi.json；人读摘要见仓库 docs/sdk/HTTP_CONTRACT_V2.md。
• 凭证：服务端对服务端用接入方 HMAC（X-Radar-Key-Id、X-Radar-Timestamp、X-Radar-Nonce、X-Radar-Signature，可选 X-Radar-Account），由系统管理员在工作台「接入方」签发；脚本与 v1 接口用个人 API key。
• HMAC 签名串（各行以 \n 连接）：keyId、毫秒时间戳、随机 nonce、请求方法、原样路径加查询串、body 的 sha256（小写 hex）、代表的终端用户 id（没有就空串）；签名 = HMAC-SHA256(secret, 签名串) 的小写 hex。时间偏差超过 5 分钟拒绝（signature_expired），nonce 10 分钟内重复拒绝（nonce_replayed）。反向代理不得改写路径或查询串。
• 错误：application/problem+json，按 code 判断。429 rate_limited 是每分钟限流；429 quota_exceeded 是每日额度用完，只针对门户登录用户和个人 API key，接入方 HMAC 调用不计额度。
• v1 兼容：旧接口继续可用（/api/v1/search、/api/search、/api/materials、/api/v1/images/:id、/api/v1/images/:id/raw、/api/image/:id/raw、/api/image/:id/thumb），一律需要凭据（API key、HMAC 或会话；匿名调用被拒），通常用 API key；title 字段恒为空串。

常见问题