行业领域
室内设计 / 建筑可视化 / 3D 数字内容
面向设计团队、效果图公司、3D 素材使用者，管理并分发 3D 模型（.max、.fbx、.rar 等）和 贴图资源（.jpg、.png 等）。
解决的产品问题
痛点 产品方案
素材库庞大，靠文件名/文件夹难以快速找到目标资源
以图搜图 + 关键词搜索，基于 CLIP 语义相似度检索
设计师只有一张参考图，不知道库里有无可复用模型
上传截图或粘贴图片，返回相似度排序的模型/贴图列表
大体积模型（百 MB 级）分散存储，权限与计费难管控
统一资源库 + 积分制下载 + 下载日志
内部素材需控制传播范围
账号体系、JWT 鉴权、管理员后台
非技术人员使用门槛高
Windows 桌面客户端：托盘通知、默认下载目录、一键保存
业务背景
团队内部积累大量 3D 模型与贴图，供学习交流和生产复用。平台将「检索 → 预览 → 扣积分 → 下载」串成闭环，管理员负责上传资源、充值积分、客服沟通；普通用户通过客户端或浏览器搜图、下载素材到本地工作目录。
一、 用户端（主页 + 桌面客户端）
1. 账号体系：邮箱注册与登录，验证码发送与校验，找回密码功能
“记住我”功能，支持长Token自动登录
2. 智能检索：支持模型库与贴图库之间的切换检索，关键词搜索，支持按资源ID和名称进行查找，以图搜图，支持上传图片、拖拽图片或使用Ctrl+V粘贴图片进行搜索
3. 资源预览：搜索结果以卡片形式展示，卡片内容包含预览图、相似度、资源类型以及下载所需的积分
4. 资源下载：下载前进行积分校验，校验通过后生成COS预签名直链进行下载，下载过程显示进度条，支持设置默认下载目录，自动记录下载历史
5. 积分与设置：在界面中展示用户的当前积分余额提供设置功能，允许用户修改默认下载目录
6. 客服消息：支持用户与管理员进行一对一的消息沟通，提供未读消息提醒功能；在桌面端支持系统原生通知
7. 下载历史：用户可以查看历史下载记录，记录列表展示文件名和消耗的积分
二、 管理后台
1. 用户管理
查看用户列表，支持搜索
为用户充值积分
启用或禁用用户账户
2. 充值明细
按月份汇总充值记录
查看详细的充值流水
3. 资源管理
对模型和贴图进行分类管理
支持上传资源（模型附带预览图 / 贴图）
编辑资源的元数据
删除现有资源
4. 索引扫描
手动触发MaterialSearch工具，用于重建预览图索引
5. 数据统计
统计总用户数、总下载量
分析模型和贴图的下载分布情况
统计积分消耗情况
6. 客服工作台
查看所有用户会话列表
选择并回复用户发送的消息
三、 桌面客户端（Electron）
1. 连接与配置
支持配置并连接远程服务器
2. 系统集成
集成系统托盘功能
收到新消息时托盘图标闪烁提醒
3. 下载优化
用户可选择本地下载目录
由主进程直接连接COS进行下载，有效绕过CORS限制
支持大文件流式写入磁盘
4. 打包与分发最终打包为安装程序
存储分层设计：
COS：模型压缩包、贴图原文件（cos:newperspective/models/...）
本地磁盘：预览图（storage/images/），供 MaterialSearch 扫描建索引
SQLite：用户、积分、素材元数据、下载日志、消息
亮点 说明
以图搜图
集成 Chinese CLIP，支持截图粘贴搜相似模型/贴图，降低检索门槛
存储分离
预览图本地索引 + 原文件 COS，兼顾检索性能与存储成本
COS 预签名直链
鉴权/扣积分在服务端，文件从 COS 直下，172MB 级模型下载速度提升明显
大文件上传优化
流式落盘 + asyncio.to_thread 传 COS，避免阻塞 Uvicorn 事件循环
桌面端主进程下载
绕过浏览器 CORS，大文件流式写盘 + 进度回调
积分商业化闭环
模型/贴图差异化扣费、流水、管理员充值、下载审计
一体化交付
后端 + 前端 + 管理后台 + 安装包 + 云部署，可独立运行
难点 解决方案
COS 流式下载只返回 ~1KB，客户端 network error
定位 SDK iter_chunks 误用，改为 body.get_stream()，并恢复 Content-Length 供进度条计算
大文件上传导致服务器卡死
分片上传、线程池 offload、前端上传进度与「正在写入云端」提示
下载经服务器中转带宽瓶颈
改为 prepare + 预签名 URL，客户端/桌面端直连 COS
轻量服务器 CPU 跑 CLIP
模型 CPU 推理 + 启动时/手动扫描索引，检索与上传下载解耦
Python 3.10 兼容
datetime.UTC 改为 timezone.utc
Electron 跨域无法 fetch COS
主进程 Node https 模块下载，IPC 回传进度
私有 COS 浏览器直链 COR
评论