资产链接与自重定向
资产链接是 Sharp Stock 提供的一种跨软件、跨文档的深度引用技术,它允许您在笔记、任务管理工具(如 Jira, Notion)甚至网页中直接定位并唤起指定的本地资源。
1. 链接格式体系
内部引用链接 (Internal Link)
- 格式:
/assets/characters/hero_run.skel - 特点:基于库根目录的相对路径。
- 用途:用于在项目配置文件中记录资源位置,保证库物理搬移后链接依然有效。
自重定向协议 (Deep Link)
- 格式:
sharp-stock://action?link=base64_encoded_path - 特点:这是一种系统级注册的协议。
- 用途:在外部文档中点击,可直接唤醒 Sharp Stock 并跳转到该资产的详情界面。
2. 获取方式
在 资产网格 中右键点击任何资产:
- 复制资产链接 (Alt + C):获取纯文本的相对路径。
- 复制自动跳转链接:获取加密后的协议 URL,适合放在 Notion、飞书文档或 Trello 任务卡片中。
3. 应用场景演示
在团队协作文档中
“美术请确认一下这张图的分辨率:点击查看 hero_shield.png”
当协作者点击该链接时,系统会执行:
- 唤起已安装的 Sharp Stock(如果未开启)。
- 解析链接中的资源标识。
- 自动展开文件夹树,并在中网格定位并高亮资产,同时在右侧打开预览。
4. 技术背后的原理
Sharp Stock 在安装时会向 Windows 注册名为 sharp-stock 的 URI Scheme Handler。所有的协议请求都会被路由给主进程,主进程根据 link 参数中的标识符通过 IPC 通知渲染层进行界面跳转。
[App截图:链接复制菜单项展示]
5. 常见问题
- 为什么链接点击没反应?
- 确保当前资产库已正确加载,且链接指向的资源在该库中确实存在。
- 检查是否禁用了系统的 URI Scheme 处理权限。
- 链接在别人的电脑上有效吗?
- 只要对方也安装了 Sharp Stock,且拥有相同的资产(通过 SVN 同步),该链接就是全团队通用的。