资源导入与导出 (Import & Export)
Sharp Stock 深度集成系统拖拽交互，旨在简化资产在资产库与外部环境（如资源管理器、专业设计软件）之间的流转流程，实现高效的资源入库与分发。
1. 资产导入操作
通过将文件或文件夹从外部窗口直接拖入 Sharp Stock，即可快速完成资产入库。系统的处理行为取决于您的拖拽落点：
导入逻辑说明
场景一：拖拽至主视图工作区
- 库外文件：将以复制模式导入至当前选中的目录。
- 库内已存在文件：若仅在主网格内拖拽，系统将不执行任何操作。
- 混合导入：系统仅会处理来自库外的资源副本，库内原有资源将保持不动。
场景二：拖拽至左侧导航树中的特定文件夹
- 库外文件：将以复制模式保存至该目标目录下。
- 库内已存在文件：将执行移动操作，资源将被重定向至新目录，不会产生重复副本。
- 目录节点调整：用于在库内调整文件夹的嵌套关系。
导入反馈
导入完成后，主视图网格将即时刷新以展示新资产。资产的显示顺序将受当前全局排序方式的影响。
粘贴剪贴板图片
如果您在外部工具（如浏览器、截图软件、聊天客户端）中复制了图像，可直接在 Sharp Stock 界面（非输入框聚焦状态）按下快捷键 Ctrl+V (Windows) / Cmd+V (macOS)：
- 系统将弹出一个重命名输入框，默认文件名为
pasted_image_YYYYMMDD_HHmmss.png。 - 即使当前已经选中某个资产，也可以直接粘贴，无需先点击空白区域或文件夹。
- 您可以自行修改文件名，确认后系统会将其以 PNG 格式另存并自动导入到您当前选中的资产库文件夹内。
在资产库内剪切、复制和粘贴
在资产网格中选中一个或多个资产后，可以使用右键菜单或以下快捷键整理资产：
- 复制：Windows 使用 Ctrl+C，macOS 使用 Cmd+C。
- 剪切：Windows 使用 Ctrl+X，macOS 使用 Cmd+X。待移动的项目会以半透明状态显示。
- 粘贴：进入目标文件夹后，Windows 使用 Ctrl+V，macOS 使用 Cmd+V；也可以右键目标文件夹并选择“粘贴”。如果右键的是资产，“粘贴”会把内容放入该资产所在的文件夹。
文件夹同样支持右键剪切、复制和粘贴。为避免目录循环，文件夹不能粘贴到自身或自己的子文件夹中。遇到同名项目时，可以选择覆盖、保留两者或跳过；“保留两者”会自动添加递增数字后缀。复制会保留资产的描述和标签，剪切则会将原项目移动到目标位置。
如果在显示子文件夹内容时同时选择了当前目录和子目录中的资产，粘贴后会保留相对于当前浏览目录的原有层级。例如，在 角色 目录中同时复制 主角.png 和 敌人/首领.png 到 备份，结果会是 备份/主角.png 和 备份/敌人/首领.png，不会把两个文件平铺到同一层。
粘贴完成后，Sharp Stock 会自动选中本次新增或移动到目标位置的全部资产，并将资产网格滚动到第一个可见的粘贴结果，便于立即查看并继续执行批量标记、移动或删除等操作。粘贴普通资产时，界面保持在粘贴目标文件夹；粘贴整个文件夹时，界面定位到新文件夹根目录，并同时选中其中本次粘贴的全部资产，不会自动进入某个子文件夹。
当同名文件夹选择“覆盖”时，Sharp Stock 会合并两个文件夹：源文件夹中的同名项目会覆盖目标项目，而目标文件夹中没有同名冲突的原有项目会继续保留。选择“跳过”的剪切项目仍保留在原位置，可以再次选择目标文件夹粘贴。
复制资产时，已有技术信息、描述、标签和缩略图会一并复制到目标位置，源数据保持不变，不会重新分析内容相同的文件；剪切资产时，这些数据会随资产移动。该规则适用于图片、音频、视频、字体、Atlas、3D、Spine 等资产。源缩略图不存在时，图片资产会在粘贴完成后尝试补充生成。
如果复制资产后直接在原文件夹粘贴，Sharp Stock 会自动添加递增数字后缀并创建副本，例如将 hero.png 复制为 hero_1.png，不会弹出同名冲突对话框。
如果剪切资产或文件夹后又粘贴回原来的父文件夹，Sharp Stock 会提示源位置与目标位置相同，不会移动文件，并自动取消这些项目的待剪切状态。
NOTE
Lite / Steam Demo 版本中的复制操作也受 100 项资产总数限制；剪切只改变存放位置，不会增加资产数量。
2. 资产导出操作
复制到其他应用
- 在 Sharp Stock 中选中需要复制的资产或文件夹。
- 使用“复制”或 Ctrl+C（Windows）/ Cmd+C（macOS）。
- 切换到资源管理器或 Finder，打开目标文件夹并粘贴，即可复制原文件。也可在支持粘贴文件的其他应用中粘贴，实际接收方式取决于该应用。
单独复制一张图片时，如果图片超过大小限制，界面会显示约 5 秒的“已复制原文件”提示，说明未复制图片内容，并告知可粘贴到文件夹或支持文件的应用中。这表示原文件已成功复制，不是复制失败。多选文件时仍显示普通复制提示。
多选可以包含图片、模型、音频等不同类型，复制时提供全部所选文件。单独选择一张可读取的静态 PNG、JPEG、WebP、BMP 或 GIF 时，还会提供图片内容，供支持图片粘贴的绘图或聊天应用使用。多选时不会只复制第一张图片，也不会自动拼图。动画、无法解码、超过 4096 × 4096 等效像素（16,777,216 像素）、源文件或供粘贴的图片内容超过 64 MiB 的图片，仅提供原文件，不会为满足大小限制而自动重新编码、压缩或缩小。原文件的内容和格式保持不变；只接受图片内容的应用可能无法粘贴这些超限图片，支持文件的应用仍可接收原文件。
Sprites 会复制组成动画的原始帧文件。Spine、Atlas 和带外部贴图的模型，请同时选择相关文件，或直接复制包含它们的文件夹，以免缺少依赖。外部粘贴不携带 Sharp Stock 中的标签、描述或虚拟动画设置，也不保证保留多选项目在库内的目录层级；需要保留目录结构时请复制文件夹。
剪切仅用于 Sharp Stock 库内移动，不能在外部应用中粘贴为文件。复制后请保持源文件可访问，直到外部粘贴完成；移动、删除源文件或断开磁盘可能导致粘贴失败。Lite / Demo 的 100 项限制针对库内新增资产，复制到外部不会增加库内资产数量。
在网格视图中选中一个或多个资产，将其拖拽出 Sharp Stock 窗口至目标位置释放，即可完成分发。
常见导出目标
- 系统目录：导出至资源管理器或桌面。
- 专业工具：直接拖入 Photoshop、Unity、Unreal Engine 或 Cocos Creator 等软件。
- 协作平台：作为附件直接拖入飞书、钉钉或企业微信聊天窗口。
NOTE
对于 Spine 等包含关联文件的资产，系统在导出时会一并处理相关的配套文件。
3. 支持的核心文件类型
| 类别 | 常见格式 | 说明 |
|---|---|---|
| 图像 | PNG, JPG, WebP | 自动生成高清缩略图并解析分辨率。 |
| Spine | .skel, .json, .atlas | 自动关联描述文件与纹理图集。 |
| 多媒体 | WAV, MP3, OGG, WebM | 导入后可在软件内直接试听与观看。 |
| 三维模型 | FBX, GLB, GLTF | 支持 360 度交互式预览。 |
| 文件夹 | — | 支持批量导入整个目录结构。 |
4. 重要注意事项
- 库内整理建议：若需调整已入库资源的存放位置，请务必将其拖拽至左侧导航树的目标文件夹，以确保数据库同步。
- 规范命名：导入前建议采用合法的命名规范。若检测到操作系统不支持的非法字符，软件将尝试进行规范化处理。
5. 导入冲突解决机制
当您导入的资产与目标文件夹中已有的资源发生重名冲突时，Sharp Stock 会主动拦截并弹出同名冲突解决模态框。
解决选项
- 覆盖 / 替换：用新导入的资产替换库中原有的同名文件（如果遇到同名类型冲突如文件与文件夹重名，则不支持覆盖）。
- 保留两者 / 重命名：保留原文件，并将新导入的文件进行自动递增重命名（如原文件为
character.png，新文件将被自动保存为character_1.png；若_1也已存在，则尝试_2，以此类推）。 - 跳过：放弃导入该冲突资产，保持原有文件不变。
单个冲突与批量冲突处理
- 统一列表展现规范：Sharp Stock 所有操作确认与冲突解决对话框均遵循统一 UI 规范。所有涉及的文件名与磁盘/资产路径均不会直接塞入段落描述语中，而是统一展示在下方独立的“冲突文件”或“目标文件”滚动列表区域内，确保文本简洁易读。
- 单个冲突模式：当仅产生 1 个冲突资产时，模态框直接显示“替换/覆盖”、“保留两者/重命名”及“跳过”三个直达操作按钮。只需点击其中任意一个按钮，即可一键完成冲突处理并执行导入。
- 批量冲突模式：当产生 2 个及以上冲突资产时，对话框将展示冲突列表：
- 默认状态：列表中的项目初始处于未预选状态，底部的“确定”按钮保持禁用状态。
- Header 批量操作栏：对话框在冲突列表框的顶部 Header 区域集成了批量控制工具栏，提供“全部替换”、“全部保留两者”及“全部跳过”按钮。点击按钮可一键将所选规则应用到列表中的所有项目，并即刻激活“确定”按钮。
- 逐项点选与确认：您也可以在列表中为每个冲突资产单独点选处理规则。当列表中的所有项目均完成选择后，“确定”按钮将变为可用状态，点击“确定”即可完成批量导入。
NOTE
图片压缩与 AI 抠图对比预览保存冲突：在使用图片压缩 (Tinify) 或 AI 智能抠图后打开的新旧对比对话框中，点击 [保存全部 (Save All)] 时，系统同样会自动检查拟生成的目标文件名（如 hero.tinified.png 或 hero.transparent.png）在库中是否已存在。若存在重名冲突，会触发本同名冲突解决模态框，供您选择覆盖、保留两者（自动递增追加后缀 _1）或跳过；而选择 [替换全部 (Replace All)] 则直接覆盖原图。
TIP
针对大批量的资源导入任务，建议在操作完成后执行一次 [⚙ 设置] → [维护与优化] → [深度扫描]，以确保数据库索引的完整性。
6. 浏览器扩展 (Sharp Stock Clipper) 一键剪藏与导入
除了直接拖拽与粘贴截图以外，Sharp Stock 还支持搭配官方浏览器扩展 Sharp Stock Clipper 实现网页资源的一键剪藏与直接导入：
使用步骤
- 启动桌面端 App：在浏览器中发起剪藏前，请确保 Sharp Stock 桌面应用处于运行状态（若应用未启动，扩展会尝试通过
sharp-stock://协议唤醒应用）。 - 快捷导入图片：在网页图片上按住 Alt 并单击鼠标右键，可以直接导入当前图片；也可以使用浏览器右键菜单中的 使用 Sharp Stock Clipper 导入。
- 从扩展面板导入：打开扩展面板后，可以分别查看页面中的图片和音频。既可以点击单个资源的导入按钮，也可以选择多个图片或音频后批量导入。
- 自动传输与解析：扩展会将获取到的图像或音频直接发送给桌面 App，App 接收后会自动保存至指定目录（默认保存至
Clippings文件夹），并生成该类资产支持的缩略图与元数据。 - 即时状态感知与批量进度 Toast：
- 单素材导入：桌面端会立即在顶部弹出加载状态 Toast（显示旋转动效）。素材写入并显示在资产列表后，提示才会原地切换为成功状态（3.5 秒后自动淡出）；若发生错误则原地切换为失败原因提示（5 秒后自动淡出）。
- 多素材批量导入：桌面端为每个批次使用一个聚合 Toast 进行原地进度更新，展示实时进度条与当前正在导入的素材名称（例如
正在批量导入 (1/5): xxx.png...），避免为每个素材重复弹出提示。批次处理完毕并刷新资产列表后，提示才会原地切换为最终汇总状态（全部成功显示导入总项数；部分失败显示成功与失败项数量）。同时运行多个批次时，各批次会分别显示进度。
NOTE
- Lite / Steam Demo 版本的剪藏导入同样受 100 项总资产数量限制。达到上限后，扩展导入时会提示超限失败。
- 剪藏导入过程完全在本地磁盘环回（loopback）网络通信中完成，并通过 Origin 来源校验仅允许 Chrome 或 Firefox 浏览器扩展发起请求，第三方网页和缺少 Origin 的请求会被拒绝；素材不会上传到云端。
- 扩展支持网页中的普通链接、内嵌图片/音频以及临时
blob资源。导入前会确认资源确实是受支持的图片或音频；如果网页返回登录页、错误页或类型不匹配的文件，扩展会显示导入失败，并且 Sharp Stock 不会保存该内容。 - 单个资源、Alt + 右键和浏览器右键菜单导入都会显示成功或失败结果。若高分辨率原图不可用，扩展会自动尝试该网站可用的备用图片地址。
- 通过扩展导入后，如果素材网页地址或实际下载地址可用，可在资产右侧 当前文件基本信息 中查看并点击打开。后续扫描不会清除这两项来源信息。临时
data:/blob:地址不会保存为下载地址。