用途:该技能用于解答 Contentstack Assets(独立数字资产管理产品,部分文档也称 Asset Management)相关问题,帮助团队规划空间与工作区结构、建模元数据、使用 AI 功能、清理重复项,并理解删除或替换资产后的可恢复性。它仅提供只读咨询,不执行上传、移动、删除、恢复或修改操作。
主要能力:
- 空间与工作区:空间是顶层容器,角色、权限和设置按空间管理;工作区是空间内隔离环境,每个空间有主工作区,新工作区继承资产、元数据和配置。建议空间与工作区数量保持精简。删除空间不可逆。
- 文件夹:通过 + New > New Folder 创建,名称必填;建议按团队检索习惯(如活动、资产类别、品牌)建立一致结构。
- 资产类型与元数据:元数据分层为系统元数据(只读)、通用元数据和用户自定义元数据。每种资产类型对应一个 MIME 类型和一个扩展名;自定义字段类型当前包括单行文本、数字、选择、分组,必填字段应少用。用户自定义字段仅存在于 Assets DAM,CMS 堆栈资产库及其 Management API 不读写这些字段,程序读写应使用 Assets API。
- 筛选与保存视图:用户自定义字段可作为筛选条件,筛选组合可保存为视图复用;建议按筛选需求建模字段。
- 本地化:添加语言分两步,先在产品设置中添加语言,再在目标工作区的 Manage Locales 中添加。
- 搜索 API:POST <host>/api/{object_type}/search,需指定区域主机、认证头(Bearer OAuth 令牌或 authtoken,不接受 management token)及 x-cs-api-version;文本搜索字段仅支持 all、title、name、url、category,无法定位用户自定义字段;结构化筛选放在 query 中,使用 $and、$or;用户自定义字段按 user_defined_fields.<group>.<field> 引用,需在自有空间测试;支持 limit、skip、fields 分页与裁剪;默认排除已删除项。
- AI 功能:元数据面板提供 Suggest Tags with AI、Suggest Description with AI,并可提取主色用于颜色筛选;上传自动填充在 Space Settings > AI Settings 配置,仅对图片和新上传生效,写入版本 1,不覆盖上传者已填值;标签最多 10 个,置信度 10%–100%,默认 10 个、80%;Alt 文本仅英文,写入系统 Description 或指定的单行文本字段。
- 重复项管理:仅检测字节完全相同的图片,按工作区配置,默认开启,后台运行;可通过 More Actions > Duplicate Management 处理;调整尺寸、裁剪、重新导出或压缩的副本不会被检测;重复集不能搜索、筛选或排序;选中全部副本会删除图片且无警告;删除副本会移除其所有使用位置。
- 版本:文件或元数据变更以及 Save Assets 都会创建新版本;版本名最多 32 字符;在版本选择器中选择旧版本并点击 Save Asset 可恢复为最新版本;仅编辑权限用户可重命名或恢复。
- 回收站:删除的资产和文件夹进入 Trash,可在 14 天内恢复,之后永久移除;文件夹恢复可选 With Assets 或 without Assets;若 Restore 灰显,需先恢复父文件夹。
- 可视化标记:hotspot 为单点,bounding box 为矩形,均需标题;Suggest Markup with AI 可建议边界框;批量隐藏或删除全部标记需谨慎,删除不可逆。
- CMS 集成:空间可关联一个或多个堆栈;Content Delivery API 的 asset_fields[] 支持 visual_markups 和 user_defined_fields。
使用方式:先确认用户指的是 Assets DAM 还是 CMS 堆栈资产库;识别主题(结构、元数据、AI、重复项、版本、回收站、标记、CMS 集成);用产品术语给出已文档化行为、UI 路径(Menu > Item)、限制和不可逆操作警告;未文档化或可能变化的内容应指向官方文档,不臆测。
适用场景:空间与工作区规划、自定义字段与元数据建模、语言启用、筛选与保存视图、搜索 API 使用、AI 标签与 Alt 文本配置、重复图片清理、版本回滚、误删恢复、可视化标记和 CMS 条目引用资产等咨询。
限制:仅限只读咨询;不执行任何资产或设置变更;不暴露令牌或 API 密钥,示例凭据应使用环境变量;不编造未文档化的 CDN 主机名、URL 格式或行为。
参考文档: https://www.contentstack.com/docs/assets/about-assets https://www.contentstack.com/docs/assets/about-spaces-and-workspaces https://www.contentstack.com/docs/assets/about-asset-modeling https://www.contentstack.com/docs/assets/enhance-asset-management-with-ai https://www.contentstack.com/docs/assets/manage-duplicate-images https://www.contentstack.com/docs/assets/asset-versioning https://www.contentstack.com/docs/assets/restore-an-asset-or-folder https://www.contentstack.com/docs/assets/add-visual-markups https://www.contentstack.com/docs/developers/apis/content-delivery-api/assets https://www.contentstack.com/docs/developers/apis/assets-api https://www.contentstack.com/docs/developers/apis/assets-api/search