1. 为什么需要严格的素材命名规范？
在 tapaim 的高阶功能中，我们允许用户将本地设计的 SVG 矢量图或位图素材导入到“自定义准星库”中。由于 tapaim 采用异步文件索引技术，为了确保软件在扫描存储目录时能够毫秒级定位文件，并正确识别文件的渲染属性（如透明通道、层级深度），一套标准的命名规范显得尤为重要。
避免索引冲突：如果不遵循规范，直接使用中文名或特殊符号命名，Android 系统的文件流读取器可能会出现乱码，导致素材在 APP 内显示为“破损的红叉”。
自动属性分配：tapaim 的扫描引擎可以根据文件名后缀，自动为素材分配默认的缩放比例和抗锯齿倍率，省去您手动调优的时间。
2. 基础命名结构：前缀 + 业务名 + 属性词
我们建议所有本地素材遵循以下结构命名：`tap_type_name_attr.ext`
前缀 (tap_)：全局唯一前缀。这能告诉 tapaim 的引擎，该文件是其专属素材，而非系统相册里的普通照片。带有该前缀的文件会被优先加载至高速缓存中。
类型标识 (type)：目前支持 `cs` (Crosshair, 准星)、`ov` (Overlay, 覆盖图层)、`sc` (Script, 宏脚本图标)。
属性词 (attr)：常用的属性词包括 `hi` (High Precision, 高精度渲染)、`no` (No Shadow, 无阴影)、`gl` (Glow, 自带发光效果)。
示例：`tap_cs_val_red_hi.svg` 代表这是一个专为无畏契约（VAL）设计的红色高精度矢量准星。
3. 文件格式与编码强制要求
SVG 文件：必须符合 SVG 1.1 或 2.0 标准。请在导出时确保所有的“文本”已转为“路径（Path）”，否则 tapaim 内部无法渲染非系统字体。编码格式强制要求为 UTF-8，不带 BOM。
PNG 文件：如果必须使用位图，请确保为 32 位真彩色且带有 Alpha 透明通道。建议分辨率不要超过 512x512 像素。过大的分辨率会浪费不必要的显存带宽，甚至导致画面掉帧。
禁止特殊字符：文件名中严禁出现 `* / : < > | ?` 等 Windows 或 Linux 系统的保留字符。空格建议使用下划线 `_` 代替。
4. 存储路径与自动热重载
请将命名规范的文件放置在以下指定路径：`/Android/data/com.tapaim.center/files/custom/`。tapaim 开启了文件观察者（FileObserver）模式。这意味着您无需重启 APP，只需将新文件移动到该目录下，APP 内部的素材列表会即时闪烁并自动刷新，方便您进行快速对比调试。
特别提醒：如果您是从非 tapaim 官网 (tapaim.com.cn) 获取的素材包，请务必先进行病毒扫描。部分恶意软件会将 APK 伪装成素材文件。认准官方格式，认准官方路径，是您畅爽竞技的基础保障。