资产

资产是 NekoHub 的核心业务对象。每次上传图片时，系统都会把文件存进选定的存储 provider，并创建一条资产记录来追踪文件元数据、公开性、处理状态和 AI 结果。

​

资产字段

​

资产状态

当前系统的常见运行路径是：上传成功后很快进入 ready，然后你可以运行技能、查看派生结果或对外公开。

​

公开与私有

• 公开资产：isPublic=true。会进入 /gallery，也可通过公开内容地址被匿名访问
• 私有资产：isPublic=false。不会进入公开画廊，只能通过受保护的 /api/v1/assets/{id}/content 在已认证上下文中访问

你可以随时在后台或 API 中切换这个标记，但具体是否支持切换，也受底层存储 provider 能力影响。

​

派生文件

派生文件是技能运行后生成的附加文件，例如缩略图。每个派生文件都带有自己的 contentType、尺寸、大小和公开地址。

​

结构化结果

结构化结果是技能运行后附加到资产上的 JSON 数据。例如基础描述技能会生成 caption 等结构化 payload。它们出现在资产详情里的 structuredResults 数组中。