常见问题 (FAQ)

本章节汇总了在使用 Sharp Stock 过程中的常见技术疑问及其标准解决方案。

---

Q: 网站底部的版权与备案信息是什么？

A: 为履行法定公示义务，本站（含首页与全部文档页）底部均展示运营主体的版权声明，以及 ICP 备案、公安联网备案 的案号与查询入口；点击案号可前往主管部门公示页面核验。

Q: 为什么部分 Spine 资产无法显示缩略图？

A: 请按以下步骤进行排查：

1. 关联文件检查：确保 .skel 骨架文件与其配套的 .atlas 图集及纹理图片存放在同一目录下。
2. 版本规范核对：Sharp Stock 目前深度支持 Spine 3.7 至 4.1 版本。若导出版本过低或过高，可能导致预览引擎无法解析。
3. 强制刷新：您可以尝试在资产卡片上右键点击“重构预览”，或在 [设置] → [维护与优化] 中执行“深度扫描”。

Q: 如何快速在目录间移动资产？

A: 您可以直接在 主视图网格 中选中目标资产，将其 拖拽 至左侧导航树的指定文件夹节点。系统将同步执行磁盘位移与数据库索引更新，确保资产的备注与标签信息不丢失。

Q: AI 智能功能提示错误该如何处理？

A: 若您使用的是 Steam 版本，详情面板中的 AI 自动标签/描述及设置中的「AI 模型配置」因平台审核政策暂未提供，请改用 Microsoft Store 或 App Store 版本。其他版本请按以下步骤排查：

1. 服务连通性：检查 [AI 模型配置] 中的 API 地址是否可正常访问（如本地 Ollama 服务是否已开启）。
2. 模型匹配：确认设置中的模型名称（Model Name）拼写无误，且该模型已在服务端部署。
3. 配额与权限：若使用商业云服务（如 OpenAI），请检查 API Key 是否有效及账户余额是否充足。
4. 日志排查：可在 [诊断与调试] 面板中查阅详细的错误堆栈信息，以便精准定位原因。

Q: 执行“清理缩略图”操作会误删原始资源吗？

A: 绝对不会。该操作仅针对软件内部生成的预览缓存文件（位于 thumbnails 目录），旨在释放冗余空间。清理后，系统将在您下次浏览资产网格时自动重新生成缺失的预览图。

Q: 为什么在 macOS 沙盒版（App Store 版本）下，SVN 提示“当前非 SVN 工作副本/工作目录”或状态显示为灰色/无法检测改动？

A: 这是由于 macOS App Sandbox（应用沙盒）的安全访问限制导致的：

1. 沙盒访问边界：在沙盒模式下，应用程序只能访问您在文件夹选择对话框中明确选中的目录（资产库根目录）。
2. SVN 工作副本路径限制（.svn 目录不在当前目录）：SVN 依靠在当前目录及父目录中寻找 .svn 文件夹来确定工作副本。如果您的 .svn 文件夹位于您选择的资产库根目录的上一级目录/外部目录中（例如，您把 /Users/b1gm0use/SharpStockDemo/trunk 选为了资产库，但 .svn 在 /Users/b1gm0use/SharpStockDemo/.svn），沙盒会阻止 SVN 命令行工具读取父目录。这会导致应用提示 “当前非 SVN 工作副本/工作目录”，从而无法检测改动。
3. 解决方法：
   • 请确保选中的资产库根目录本身就是 SVN 工作副本的根目录（即 .svn 文件夹必须存在于您选择的资产库目录内，例如 /Users/b1gm0use/SharpStockDemo/trunk/.svn 存在）。
   • 或者使用本应用的“从远程 SVN 检出库”功能直接将工作副本检出到该目录下。
4. 账号密码保存问题（Keychain 限制与本地备份）：在 macOS 沙盒环境中，内置的 SVN 工具无法与系统 Keychain（钥匙串）交互以保存或读取凭据。为了解决这一限制，并在 Windows 等平台上提供可靠的密码备用方案，本应用已实现完全自动化处理：
   • 当您在应用内的“从远程 SVN 检出”对话框中填写用户名和密码并开始检出时，应用会自动为内置 SVN 指定沙盒隔离的配置目录（--config-dir）。
   • 此外，本产品内置了应用层凭据加密缓存管理器。它会使用系统提供的安全存储（Electron safeStorage）对您的 SVN 账号密码进行高强度加密，并将其持久化存储在应用的本地私有数据中（Windows 和 macOS 平台均已一并支持）。
   • 后续不管是通过哪个入口触发的 status、update、commit 等操作，系统都会在后台自动匹配并安全地注入对应的用户名和密码凭据，彻底避免了频繁要求输入账号密码的弹窗，在任何环境下都能无缝、高效地协同工作。