FAQ

This chapter summarizes common technical questions and their standard solutions encountered while using Sharp Stock.

---

Q: Why do some Spine assets fail to display thumbnails?

A: Please troubleshoot using the following steps:

1. Associated File Check: Ensure the .skel skeleton file and its accompanying .atlas and texture images are stored in the same directory.
2. Version Standards Check: Sharp Stock currently deeply supports Spine versions 3.7 to 4.1. If the exported version is too low or too high, the preview engine may fail to parse it.
3. Forced Refresh: You can try right-clicking "Rebuild Preview" on the asset card, or execute "Deep Scan" in [Settings] → [Maintenance & Optimization].

Q: How can I quickly move assets between directories?

A: You can directly select target assets in the Main View Grid and drag them to a specified folder node in the left navigation tree. The system will simultaneously execute the physical disk move and database index update, ensuring that asset notes and tag information are not lost.

Q: What should I do if AI features prompt an error?

A:

1. Service Connectivity: Check if the API address in [AI Model Configuration] is accessible (e.g., whether the local Ollama service is running).
2. Model Matching: Confirm the Model Name in settings is spelled correctly and that the model is deployed on the server side.
3. Quotas & Permissions: If using commercial cloud services (like OpenAI), check if your API Key is valid and whether your account balance is sufficient.
4. Log Troubleshooting: You can view detailed error stack information in the [Diagnostics & Debugging] panel to precisely locate the cause.

Q: Will executing "Rebuild Thumbnails" accidentally delete original resources?

A: Absolutely not. This operation only targets the preview cache files generated internally by the software (located in the thumbnails directory) to release redundant space. After clearing, the system will automatically regenerate missing previews the next time you browse the asset grid.