Path Management
One of Sharp Stock's core values is the efficient management of file locations on physical disks and their logical associations within the system. A deep understanding of path management logic will help you maintain large-scale resource libraries more robustly.
1. Path Reference Logic
- Absolute Path: Refers to the true physical location of an asset in the computer's file system. Example:
D:\Projects\GameA\assets\ui\button.png. - Relative Path: Refers to the asset's path relative to the "Library Root." In the above example, the relative path is
ui/button.png.
Core Design Standard: Sharp Stock prioritizes storing relative paths in the database. This means that as long as the internal directory structure of the library remains unchanged, you can freely move the entire library folder between different disk partitions or even different computers. After reloading the library root, all tags, notes, and other metadata will automatically re-associate.
2. Convenient Positioning Tools
To help you quickly find targets in complex folder hierarchies, the software provides multi-dimensional positioning functions:
View-Linked Positioning (Locate)
- Operation: Right-click an asset in the grid view and select "Locate Folder" (shortcut Ctrl + G).
- Interaction Feedback: The left navigation tree will automatically and recursively expand all directory levels and precisely jump to the target folder, highlighting it.
External File Explorer Positioning
- Operation: Right-click an asset and select "Show in File Explorer."
- Interaction Feedback: Immediately brings up the Windows File Explorer (or macOS Finder) window and precisely selects the corresponding physical file. This is very efficient for file sending or external editing.
3. Path Clipboard Functions
The context menu provides various path copying options to meet the needs of development, planning, and daily communication:
| Function | Format Example | Typical Use Case |
|---|---|---|
| Copy Asset Link | sharp-stock://open?path=hero.png | Native app jumps, system run box rapid positioning. |
| Copy Disk Path | D:\Project\assets\hero.png | Script batch processing, opening directly with external software. |
| Web Redirect Link | https://sharp-stock.games/redirect.html... | References in online documents like Lark or Notion; click to launch the app via a browser. |
4. Path Change Maintenance
Performing file system operations outside Sharp Stock (e.g., directly in File Explorer) can have the following effects on library files:
- External Deletion: After a full scan, the database record for that path will be marked as invalid.
- External Rename/Move: The system will identify this as "an old asset disappearing and a new asset appearing."
- Operation Suggestion: To ensure the integrity of metadata like tags, notes, and unique IDs, always perform rename or move operations within Sharp Stock. Dragging assets within the software allows the system to intelligently synchronize path records and retain all associated information.