快速入门：配置资产库
欢迎使用 Sharp Stock！在开始管理您的游戏资产之前，首先需要建立一个“资产库”。本章节将引导您完成资产库的初始化，您可以选择打开/创建本地库或从远程 SVN 检出库。
1. 初始化方式选择
首次启动 Sharp Stock 时，您将面临以下两个主要选项：
| 选项 | 适用场景 | 核心特点 |
|---|---|---|
| 打开或创建本地资产库 | 您本地已有项目文件，或计划在本机新建一个库。 | 响应极快，可直接索引现有目录或在空文件夹中初始化。 |
| 检出资产库 (SVN Checkout) | 您加入了已有团队，资源托管在 SVN 服务器上。 | 自动从服务器同步最新资源，支持多人协作与版本追踪。 |
2. 操作指南：打开或创建本地资产库
如果您本地已有资源文件（如图片、Spine 动画等），或准备在本机创建一个新的库，请按照以下步骤操作：
- 启动流程：点击主界面的 [选择本地资产库目录] 按钮。
- 选择路径：在弹出的文件夹选择框中，选择目标目录：
- 打开已有库：定位到项目的根目录（即包含资源文件的顶层目录）。
- 创建新库：选择一个空目录作为库的根路径。
- 系统确认：
- 空目录：软件会提示是否执行初始化，点击“确定”后将自动生成管理所需的数据库及目录结构。
- 非空目录：软件会建立必要的索引文件（不会破坏原有目录结构），并将现有资源纳入管理范围。
- 自动扫描：确认后，系统将自动扫描子目录并生成缩略图。完成后即可开始使用。
3. 操作指南：从 SVN 检出资产库
若需要从团队服务器同步资源库，请执行以下操作：
- 输入地址：在主界面输入框中填入远程仓库的 SVN URL（需以
http://,https://或svn://开头）。 - 身份验证：若服务器设有权限，请在弹出的对话框中输入 用户名 和 密码。
- 有效性预检：系统会自动验证该地址是否为有效的 Sharp Stock 资产库。
- 选择存放位置：验证通过后，在本地选择一个 空文件夹 作为资源存放路径。
- 开始检出：检出时长取决于资源库大小及网络速度。完成后，资产库将自动开启。
TIP
若您更习惯使用外部 SVN 客户端（如 TortoiseSVN、SnailSVN 等），也可以先在本地完成 Checkout，再通过上文的 [选择本地资产库目录] 方式打开该目录。Sharp Stock 会自动识别其中的 SVN 信息，后续仍可正常使用更新与提交等版本控制功能。
4. 两种模式的核心区别
- 协作模式：本地库适合个人管理或项目起步；SVN 库是团队协作的基础，支持通过侧边栏“更新”获取他人改动，或“提交”自己的修改。
- 网络要求：本地库完全离线运行；SVN 库在同步（更新、提交）时需要连接服务器。
- 版本管理：SVN 库天然支持版本追踪，您可以查看文件修改记录或将文件还原至历史版本。
5. 重要注意事项
为了确保您的资产数据安全，请务必留意：
- 管理文件保护：Sharp Stock 依赖根目录下的数据库文件进行资产管理。请勿手动删除 后缀为
.db的数据库文件，否则会导致标签、备注等元数据丢失。 - 读写权限：请确保您对所选的本地路径拥有完整的读写权限。
- 确认初始化路径：首次配置时，请务必确认路径选择正确，因为软件会在该位置生成必要的管理记录。