设置指南
本章节详细介绍 Sharp Stock 设置面板中的每一项配置。
点击左侧栏底部的 ⚙ 设置 图标即可打开设置面板。设置面板采用左右分栏布局——左侧为 Tab 导航栏，右侧为对应的 配置内容区。
1. 资产库 (Library)
此页签用于查看和切换当前资产库的根目录。
当前资产库路径
显示当前已加载的资产库所在的文件系统路径（只读显示）。
- 切换：点击右侧「切换」按钮，在弹出的文件夹选择对话框中选择新目录。应用会自动扫描新目录并重建索引，所有界面数据将刷新为新库的内容。
TIP
如果你经常在多个项目之间切换，可以将不同项目的资源根目录记在白板上，方便快速定位。
2. 资产库管理 (Management)
此页签提供了资产库数据的维护工具，用于确保数据库、缩略图及标签系统的健康状态。
扫描资产库
执行全量扫描 (Deep Scan)，重新遍历当前资产库的全部文件，更新数据库中的索引记录。
- 适用场景：
- 大量资产通过外部工具批量更改后，需要刷新索引。
- 数据库缓存与实际文件系统出现不一致时。
- 扫描过程中按钮会变为「扫描中...」状态，无法重复点击。
清理未引用的标签
自动检测所有「没有被任何资产引用」的孤儿标签。
- 点击「清理」后，应用会先列出所有待清理标签供确认。
- 确认弹窗中会详细展示标签名称列表，点击「确认」后执行批量删除。
- 安全保障：仅删除标签定义，不影响任何资产文件。
清理缩略图
一键清理多余的缩略图缓存并补充缺失的缩略图。
- 完成后会展示三项统计：
统计项 说明 验证 (Verified) 已确认有效的缩略图数量 新生成 (Generated) 本次新创建的缩略图数量 删除 (Deleted) 本次清理掉的多余缩略图文件数量
NOTE
当资产被移动、重命名或删除后，其缩略图不会立即清除。通过此功能可以释放这部分磁盘空间。
3. AI 模型 (AI Settings)
此页签配置 AI 辅助标签和自动描述功能所依赖的大语言模型 (LLM) 后端。
Sharp Stock 支持两套独立的 AI 模型配置——分别用于图形资产和音频资产的智能分析。
图形资产自动描述
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 模型 API 地址 | 大语言模型的 HTTP API 端点 | http://127.0.0.1:11434/ |
| 模型名称 | 要调用的模型标识符 | qwen3-vl:8b |
| Token | 如 API 需要鉴权，填写访问令牌 | （空） |
| 最大上传分辨率 | 上传给模型的图片最大长边像素 | 256 |
- 最大上传分辨率：为了控制 API 调用开销和延迟，上传前会将图片等比缩放至指定分辨率以内。默认 256px 即可满足大多数场景的识别准确度。
音频资产自动描述
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 模型 API 地址 | 音频分析模型的 HTTP API 端点 | http://127.0.0.1:11434/ |
| 模型名称 | 要调用的模型标识符 | qwen3-vl:8b |
| Token | 如 API 需要鉴权，填写访问令牌 | （空） |
IMPORTANT
配置完成后请务必点击「保存配置」按钮，否则更改不会生效。AI 模型推荐使用本地部署的 Ollama 服务，默认端口 11434。
4. 图像处理 (Image Processing)
此页签配置图像相关的外部服务集成。
TinyPNG 压缩
- API Token：填写从 TinyPNG 开发者页面 获取的 API Key。
- 目前仅支持 PNG 格式图片的云端无损压缩。
- 配置完成后点击「保存配置」按钮保存。
TIP
TinyPNG 免费账户每月有 500 次压缩额度，对于中小型项目通常完全够用。
5. 诊断与调试 (Diagnostics)
此页签提供了完整的系统日志查看和导出功能。
系统日志
- 自动加载最近 100 条 系统日志记录，使用等宽字体展示。
- 日志区域可上下滚动浏览，进入时自动滚动到最新位置。
操作按钮
| 按钮 | 功能 |
|---|---|
| 刷新日志 | 重新加载最新的日志数据 |
| 复制当前日志 | 将当前显示的日志文本复制到系统剪贴板 |
| 打开 Log 所在文件夹 | 在系统文件管理器中打开日志文件所在目录 |
TIP
如遇到应用异常，可先「刷新日志」→「复制当前日志」，然后将日志内容提供给技术支持，方便快速定位问题。
NOTE
所有设置均自动持久化到本地数据库，下次启动时会自动恢复。