Skip to content

最佳实践 (Best Practices)

本章节汇总了在团队协作中高效使用 Sharp Stock 的核心建议,涵盖资产组织、版本控制及日常维护等多个维度。


1. 资产组织与项目结构

清晰且规范的目录结构是实现高效检索与自动化管理的基础。

统一分类逻辑

建议团队根据项目规模,统一采用按类型分类按功能模块分类的组织方式,并保持层级结构的一致性:

  • 按类型(推荐)Assets/Characters, Assets/UI, Assets/Audio
  • 按功能模块ProjectA/Characters, ProjectB/UI

保持资产独立性

  • 单一职责:尽量避免在一个文件夹内混杂多种不同类型的资产(例如将音频文件与 3D 模型混放)。
  • 目录隔离:建议为每个复杂资产(如包含多个关联文件的 Spine 动画)建立独立的子文件夹。这有助于软件更准确地进行资产分析。

2. 版本控制规范

由于 Sharp Stock 采用中心化数据库(assetlib.db)管理元数据,规范的版本控制习惯能有效预防协作冲突。

仓库管理建议

  • 专用仓库:强烈建议为资产库建立独立且专用的 SVN 仓库。
  • 职责分离:建议将资产库(即将进入引擎的资源)与底层代码、大型美术原始工程稿(如超大 PSD)分仓管理,以确保资产定位的准确性与更新速度。

必须配置的忽略项 (Ignore)

为了确保数据库的完整性并减少操作冲突,必须在资产库根目录中配置以下 SVN 忽略项:

  • *.db-shm
  • *.db-wal

IMPORTANT

这些是数据库运行过程中产生的临时日志文件,仅在本地有效且变动频繁。请务必不要将其提交至仓库,否则会导致其他团队成员无法正常打开或更新资产库。

变更监控范围

Sharp Stock 会自动实时监控以下路径的变更状态:

  • assets/ 目录(原始资源文件)
  • thumbnails/ 目录(缩略图缓存)
  • assetlib.db 文件(资产库核心数据库)

操作一致性准则

  • 避免外部操作:请尽量避免在操作系统的资源管理器(如 Windows Explorer)中大规模移动、重命名或删除 assets/ 目录下的内容。
  • 推荐在软件内操作:所有的资产重命名、移动、属性编辑及缩略图更新都应通过 Sharp Stock 界面完成。这能确保磁盘物理文件与底层数据库(标签、备注、唯一标识等)始终保持同步,防止出现“失效链接”或数据丢失。

3. 日常维护建议

  • 手动扫描:若因特殊原因在外部进行了少量手动操作,建议立即在软件内执行“手动扫描”,以同步数据库状态。