设置指南 (Settings Guide)
本章节将为您详细介绍 Sharp Stock 设置面板中的各项功能与配置。
点击左侧导航栏上方的 ⚙ 图标 即可开启设置面板。面板采用标准的侧边导航结构——左侧为 功能分类，右侧为对应的 配置详情区。
1. 界面偏好
本页面用于配置软件的外观与显示方式。
- 界面语言：支持 简体中文、繁體中文、English 和 Español。切换后界面文字将立即生效。
- 主题方案：提供 跟随系统、深色模式 (Dark) 和 浅色模式 (Light) 三种视觉方案。
2. 资产规范
本页面可配置针对特定资产格式的验证与警示规则，协助团队维护项目资产的统一规范。
- 默认 Spine 版本：用于版本一致性检测。当开启此项（如设为 "3.8"）后，若库中的 Spine 文件版本与设定值不符，系统将在右侧详情面板显示警告，提醒修复版本冲突。
- .skel.bytes 文件警告：部分游戏引擎对
.skel.bytes后缀的支持存在差异。开启此项后，系统会将该后缀文件标记为“存在兼容性风险”，方便开发人员及时调整。
3. 资产库状态
本页面用于查看当前资产库的核心元数据及连接状态。
- 当前资产库路径：显示当前已加载库在本地硬盘中的完整路径。
- 定位：点击按钮可直接在资源管理器中打开该目录。
- 库唯一标识 (ID)：当前资产库的全局唯一 ID，用于确保在团队协作中精准定位。
- 更改/关闭资产库：
- 更改：重新选择另一个本地文件夹作为资产库。
- 关闭：断开当前库连接并返回欢迎界面。
4. 维护与优化
本页面提供了资产库数据的维护工具，用于确保数据库、缩略图及标签系统的健康运行。
深度扫描
执行全量扫描 (Deep Scan)，重新遍历资产库中的所有文件并更新数据库索引。
- 适用场景：当您在外部（如资源管理器）进行了大规模的文件移动或重命名操作后，建议执行此操作。
清理标签
自动检测并删除所有“未被任何资产引用”的标签，保持标签系统的简洁性。
重建缩略图
一键清理冗余的缩略图缓存并重新生成缺失项。完成后系统会反馈验证、新生成及已删除的统计数据。
5. AI 模型配置
本页面用于配置 AI 辅助标签及自动描述功能。支持为 图像资产 与 音频资产 配置独立的识别模型。
- API 地址：指定兼容 OpenAI 格式的 API 接口地址。
- 模型名称：指定调用的模型标识符（如
qwen-vl等）。 - 访问令牌 (API Key)：填写用于身份验证的加密密钥。
- 最大分辨率：设置上传至 AI 模型进行分析时的图像长边像素上限（默认为 256px），以平衡识别速度与准确度。
6. 图像处理服务
本页面用于集成外部图像优化服务。
- TinyPNG 压缩：在此填写您的 TinyPNG API Key，即可在主界面对 PNG 图像执行一键云端压缩。
7. 诊断与调试
本页面用于系统排错及运行日志查阅。
- 实时运行日志：展示最近的系统操作记录，便于定位异常问题。
- 快捷操作：支持刷新日志、复制内容至剪贴板，或直接打开日志存储文件夹。
8. 反馈与建议
您可以通过此入口向开发团队提交功能建议或问题反馈。
- 详细描述：请尽可能清晰地描述您遇到的问题或需求（必填）。
- 图片附件（可选）：支持点击上传或通过 Ctrl+V 粘贴 剪贴板中的截图；已有截图时，可点击截图区域右上角的 × 移除。
- 提交：完成上述内容后，在表单底部点击 「发送反馈」。
9. 关于产品
查看软件当前版本、更新记录及联系方式。
- 版本检查：系统在启动时会自动检测更新。若有新版本发布，设置图标将出现提示标记。您也可以手动点击按钮前往应用商店下载最新版本。
- 更新日志 (Release Notes)：建议您定期阅读 版本更新历史，了解新功能与改进项。
