unity-bookmark

**调用此模块中的任何技能前：**如果你准备根据技能名称或描述猜测参数后调用技能，请停止——先阅读此文件（或通过 GET /skills/recommend?includeSchema=true 获取其架构）。如果你已从 recommend/schema 获取参数定义，则可直接进行 dryRun。

触发条件

• 保存或恢复 Scene View 视角
• 收藏机位
• 在已保存的场景位置间导航
• 保存或恢复场景视角、收藏机位、在已存位置间切换

书签技能

保存和调用 Scene View 摄像机位置。

防护措施

运行模式（v1.9 三层模式）：

• Approval（默认）：只有 bookmark_list 标记为 SkillMode.SemiAuto（纯读），因此在 Approval 模式下可直接执行，无需走 grant 协议。bookmark_set（Operation.Create，写入书签表）与 bookmark_goto（Operation.Execute，改动编辑器选中对象与 Scene View 视角）都有副作用，采用默认的 SkillMode.FullAuto，因此在 Approval 模式下需要 grant。与 workflow 模块文档保持一致（以 C# WorkflowSkills.cs 的特性标注为准）。
• Auto / Bypass：SemiAuto 和 FullAuto 均可直接运行。
• 此模块中 Auto 模式禁止的技能：bookmark_delete（SkillOperation.Delete）。只能在 Bypass 模式下或通过用户管理的 Allowlist 条目调用。grant 流程会返回 MODE_FORBIDDEN。书签仅存于内存中——bookmark_delete 只会移除条目，不涉及资源 I/O。

请勿（常见幻觉）：

• bookmark_save 不存在 → 使用 bookmark_set
• bookmark_load / bookmark_restore 不存在 → 使用 bookmark_goto
• bookmark_remove 不存在 → 使用 bookmark_delete
• 书签保存 Scene View 位置和当前选择对象，而非场景状态

路由：

• 对于工作流快照（对象状态撤销）→ 使用 workflow 模块
• 对于场景保存/加载 → 使用 scene 模块

技能

bookmark_set

将当前选择对象和 Scene View 位置保存为书签。

参数	类型	必填	默认值	描述
bookmarkName	string	是	-	书签名称
note	string	否	null	书签的可选备注

返回： { success, bookmark, selectedCount, hasSceneView, note }

bookmark_goto

从书签恢复选择对象和 Scene View。

参数	类型	必填	默认值	描述
bookmarkName	string	是	-	书签名称

返回： { success, bookmark, restoredSelection, note }

bookmark_list

列出所有已保存的书签。

无参数。

返回： { success, count, bookmarks: [{ name, selectedCount, hasSceneView, note, createdAt }] }

bookmark_delete

删除书签。

参数	类型	必填	默认值	描述
bookmarkName	string	是	-	书签名称

返回： { success, deleted }

精确签名

精确的名称、参数、默认值和返回值由 GET /skills/schema 或 unity_skills.get_skill_schema() 定义，而非此文件。