VR 全景作品管理技能#

What（是什么）#

9kvr-panorama 是一个用于全景 VR 内容生产与管理的操作技能，统一处理从素材入库到作品发布前配置的关键环节，覆盖以下能力：

• 作品管理：创建作品、查看详情、读取场景、更新基础信息
• 素材管理：上传素材、查询素材、更新描述、删除素材、获取下载链接
• 场景管理：场景列表、详情、更新、删除
• 热点管理：查询热点、添加场景跳转热点、添加文本热点、删除热点
• 音乐管理：音乐标签、搜索音乐、智能匹配、挂载背景音乐
• 语音管理：主播列表、语音生成、任务轮询、语音上传、挂载语音
• 评分与诊断：读取作品评分、获取版本与全局上下文
• 账号配置：设置/更新登录 uid 与 token
• 接入开发：小程序/网页/存量系统接入指南与代码生成

Why（为什么）#

该技能的目标不是“命令大全”，而是“面向新手可复用的执行流程”。

• 降低学习成本：按业务动作组织能力，而不是按 API 字段堆砌
• 降低出错概率：强调“先查后改、改后复查”的顺序
• 提升交付效率：同类任务可直接套用流程与命令模板
• 保障可追溯性：每次关键变更都可通过 info/list 再确认

Where（去哪里看详细信息）#

先判定“调用哪个脚本/命令”，再看参数和示例。按此顺序读取：

1. 调用路由（先看）： references/router.md
2. 命令与参数总览： references/commands.md
3. 标准操作流程（SOP）： references/workflows.md
4. 端到端场景示例： references/examples.md

调用原则（给 AI 的执行约束）#

1. 每次收到需求先做“意图分类”，必须落到一个模块： works/media/scenes/hotspot/music/voice/score/develop/info(含账号配置)。
2. 根据模块去 references/router.md 选对应脚本与命令组。
3. 先读后写：优先 list/info/scenes/hotspot list，再执行 create/update/add/delete。
4. 写后复查：任何写入动作后，必须追加一次读取命令验证结果。
5. 涉及删除、覆盖、批量操作时，先复述目标 ID 与影响范围再执行。

使用边界#

• 本技能聚焦“管理与配置”，不包含沉浸式前端渲染开发细节。
• 不确定归属模块时，优先使用 references/router.md 的“最小调用模板”判定。