Settings Guide
This chapter provides a detailed explanation of each configuration item in the Sharp Stock settings panel.
Click the ⚙ icon above the folder area in the left sidebar to open the settings panel. The panel uses a standard sidebar navigation structure—the left side contains functional categories, and the right side contains the corresponding configuration details.
1. Interface Preferences
This page is used to configure the software's appearance and display.
- Interface Language: Supports Simplified Chinese, Traditional Chinese, English, and Spanish. Interface text will update immediately after switching.
- Theme Scheme: Offers three visual options: Follow System, Dark Mode, and Light Mode.

2. Asset Standards
This page allows for configuring validation and warning rules for specific asset formats, assisting teams in maintaining project asset standards.
- Default Spine Version: Used for version consistency detection. When enabled (e.g., set to "3.8"), if a Spine file version in the library does not match the set value, a warning will be displayed in the right detail panel to remind you to fix the version conflict.
- .skel.bytes File Warning: Some game engines handle the
.skel.bytesextension differently. Enabling this item will mark such files as "Compatibility Risks," allowing developers to adjust them in time.

3. Library Status
This page is used to view the core metadata and connection status of the current asset library.
- Current Library Path: Displays the full path of the currently loaded library in the local file system.
- Locate: Click the button to open the directory directly in the file manager.
- Library ID (GUID): The unique ID of the current asset library, used to ensure precise positioning in team collaboration.
- Switch/Close Library:
- Switch: Re-select another local folder as the asset library.
- Close: Disconnect from the current library and return to the welcome screen.

4. Maintenance & Optimization
This page provides maintenance tools for library data to ensure the health of the database, thumbnails, and tagging system.
Deep Scan
Performs a full scan, re-traversing all files in the asset library and updating the database index.
- Use Case: Recommended after performing large-scale file moves or renames externally (e.g., in File Explorer).
Clean Tags
Automatically detects and deletes all "unreferenced tags" (tags not associated with any asset) to keep the tagging system clean.
Rebuild Thumbnails
Clears redundant thumbnail caches and regenerates missing ones with one click. Upon completion, the system provides statistics on validation, new generation, and deletion.

5. AI Model Configuration
This page is used to configure AI-assisted tagging and auto-description functions. Independent recognition models can be configured for Image Assets and Audio Assets.
- API Address: Specify an API endpoint compatible with the OpenAI format.
- Model Name: Specify the identifier of the model to call (e.g.,
qwen-vl). - Access Token (API Key): Fill in the encrypted key used for identity authentication.
- Max Resolution: Set the pixel limit for the long edge of images uploaded for AI analysis (default is 256px) to balance recognition speed and accuracy.

6. Image Processing Services
This page is used to integrate external image optimization services.
- TinyPNG Compression: Enter your TinyPNG API Key here to enable one-click cloud compression for PNG images in the main interface.

7. Diagnostics & Debugging
This page is used for system troubleshooting and viewing execution logs.
- Real-time Execution Logs: Displays recent system operation records to help locate abnormal issues.
- Quick Actions: Supports refreshing logs, copying content to the clipboard, or opening the log storage folder directly.

8. Feedback & Suggestions
You can submit functional suggestions or bug reports to the development team through this entry.
- Detailed Description: Please describe the problem or requirement you encountered as clearly as possible (required).
- Image Attachments (optional): Supports clicking to upload or pressing Ctrl+V to paste screenshots from the clipboard. When a screenshot is present, use the × button at the top-right of the preview area to remove it.
- Submit: When ready, click Send feedback at the bottom of the form.

9. About Product
View the current software version, update records, and contact information.
- Check for Updates: The system automatically checks for updates on startup. If a new version is released, an indicator will appear above the settings icon. You can also manually click the button to go to the app store and download the latest version.
- Release Notes: We recommend periodically reading the Changelog to learn about new features and improvements.
