VSD Craft 操作

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install vsd-craft-operations
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 vsd-craft-operations。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

VSD Craft Operations 指导 AI 代理在 VSD Craft、VSDinside 和 StreamDock 中配置按键、旋钮、场景和页面。它帮助区分内置操作与插件功能，在正确位置安装或更新插件，并排查 USB 或 KVM 恢复问题。
该工作流程强调经过确认的步骤、目标版本和设备差异、备份以及基于证据的验证。作为 Openclaw Skills 的一部分，它还包含只读数据清单脚本和验证表，使更改更安全、可追溯且更容易回滚。

应用场景

使用已安装应用版本提供的操作配置按键或旋钮。
判断所需行为需要内置操作，还是需要自定义插件实现。
安装或更新插件，同时保留用户设置、场景、手动标题和其他插件。
在基于文件进行更改或恢复之前，备份场景、插件和选择状态配置。
按分层故障排查流程诊断 USB 重新连接、设备显示或 KVM 往返问题。
检查应用数据目录，而不暴露配置内容或日志。
准备交接记录，说明已验证的行为、未知事项、备份位置和恢复步骤。

工作原理

将请求分类为内置操作配置、插件安装或更新，或恢复；首先查阅已确认的工作流程和型号差异。
记录应用版本、操作系统、设备型号、连接路径、目标场景或页面，以及应用数据位置。通过 Settings > General > Open Application Folder 确认位置。
检查所选控件可用的操作。对于观察到的基本热键操作，检查独立的左旋、右旋和按下字段。区分原生场景和页面与插件内部虚拟页面。
导出目标场景。基于文件进行更改或恢复之前，正常退出应用，并为目标插件、相关场景和选择状态配置创建带时间戳的副本。
应用所需更改；设置优先使用 UI。安装插件时，使用已确认的 plugins/.sdPlugin 位置，并通过正在运行的可执行文件以及 UI 中显示的路径确定当前安装目标。
仅在需要时重启应用，然后分别验证渲染、物理输入、设备显示、USB 重新连接和 KVM 往返。按应用与设备连接、插件进程、WebSocket 注册和显示上下文的顺序追查恢复失败。
交接更改摘要、验证结果、未知事项、备份路径和恢复步骤。不要将未执行的检查报告为通过，也不要在共享材料中包含个人配置文件、日志、设备 ID 或凭据。

配置指南

在能够访问随附参考资料和脚本的环境中使用此 skill。SKILL.md 未指定通用的 skill 安装命令；请遵循宿主代理添加 skills 的说明。在 VSD Craft 中，检查或更改文件之前，通过 Settings > General > Open Application Folder 确认应用数据文件夹。
当需要只读结构摘要时，使用已确认的数据根目录运行随附的清单脚本：
python3 scripts/inspect_data.py --root
进行更改之前，请阅读 references/operations.md；如果需要记录验证证据，请将 references/verification.md 复制到工作目录。未指定 VSD Craft 或其插件的命令行安装流程；请使用应用 UI 和已确认的插件位置。

数据架构

此 skill 不定义新的应用数据格式。它处理现有的 VSD Craft 数据，并使用以下位置和材料：
数据或材料 用途和处理方式
应用数据根目录 通过应用的 Open Application Folder 命令确认；将其与 Elgato 的独立文件夹区分开。
plugins/.sdPlugin 已确认的插件安装位置。更新期间保留旧插件版本和用户设置。
场景和页面 更改之前导出目标场景。区分原生场景和页面与插件内部虚拟页面。
选择状态配置 基于文件进行更新或恢复之前，与相关插件和场景一并备份。
带时间戳的备份目录 单独存储可读副本，并记录原始路径到恢复路径的映射。
验证表 将 references/verification.md 复制到工作目录，并记录检查项目和证据。
清单输出 scripts/inspect_data.py 汇总目录结构和插件清单；不包含配置内容和日志。
随附测试 scripts/test_inspect_data.py 使用临时测试数据检查只读行为、内容省略和链接排除。不要分享个人配置文件、日志、设备 ID 或凭据。

高级特性

感知版本和型号的流程：复用已记录的发现，仅调查未经验证的行为或相关目标差异。
安全回滚规划：基于文件进行更改之前，导出场景、创建带时间戳的副本并记录恢复映射。
只读清单：汇总目录结构和插件清单，不输出配置内容或日志。
受控插件更新：确定当前安装目标，并保留现有设置和无关插件。
分层 USB/KVM 诊断：依次检查应用与设备连接、插件进程、WebSocket 注册和显示上下文。
基于证据的验证：分别测试应用渲染、物理输入、设备显示、USB 重新连接和 KVM 往返。
可复用的交接记录：记录更改、已验证行为、未知事项、备份和回滚步骤，同时排除敏感材料。

name: vsd-craft-operations description: "Configure keys, knobs, scenes, and pages in VSD Craft / VSDinside / StreamDock (also spelled VDS Craft); choose built-in actions; install or update plugins; back up settings; and diagnose USB/KVM recovery. For new plugin implementation or Elgato ports, use vsd-craft-plugin-development."

VSD Craft Operations

Read the confirmed workflows and model differences, then classify the request as built-in action configuration, installation/update, or recovery. Reuse recorded findings; investigate only unverified behavior or differences in the target version or model. Done when the target operation and applicable procedure are identified.

Identify the application version, OS, model, connection path, and target scene/page. Confirm the data location through the application's Settings > General > Open Application Folder command. If needed, inspect its structure with python3 scripts/inspect_data.py --root . Resolve relative paths from this skill's directory. Done when the application version and data path are recorded and the target is distinguished from Elgato's separate folders.

For built-in configuration, select the relevant key or knob and inspect its available actions. The observed basic hotkey action has separate fields for left rotation, right rotation, and press. Investigate additional behavior only when requirements such as state detection or long press demand it. Keep native scenes, native pages, and plugin-internal virtual pages distinct. Done when built-in coverage and any required custom implementation are explicit.

Export the target scene before making changes. For file-based updates or recovery, quit the application normally, then copy the target plugin, related scenes, and selection-state configuration into a separate timestamped directory. Follow backup and restoration and record the mapping between originals and restoration destinations. Done when the copies are readable and the previous layout and settings can be restored.

Apply the requested changes. Prefer the UI for settings; install plugins into the confirmed plugins/.sdPlugin location. Preserve the old version and user settings during updates, and avoid editing profiles directly while the application is running. If several automatic installation targets exist, use the running executable's location and the path shown in the UI to identify the active one. Done when only the intended targets changed and existing scenes, manual titles, and other plugins are preserved.

Restart VSD Craft only when needed and complete the applicable rows of the verification sheet. Check application rendering, physical input, device display, USB reconnection, and KVM round trips separately. Trace recovery failures through application/device connectivity, the plugin process, WebSocket registration, and display contexts, in that order. Done when the requested behavior is observed and unperformed checks are not reported as passes.

Hand off a brief summary of changes, verified behavior, remaining unknowns, backup locations, and restoration steps. Exclude personal profiles, logs, device IDs, and credentials from shared artifacts. Done when others can reuse the procedure and the current change can be rolled back.

Bundled Resources

Operations and findings: Built-in features, folders, model differences, recovery, and sources.
Verification sheet: Evidence template; copy it into the working directory before filling it in.
Read-only data inventory: Directory structure and plugin manifest summaries for a supplied root; excludes configuration bodies and logs.
Inventory test: Temporary fixtures check read-only behavior, content omission, and link exclusion.
User-facing README: Installation and example requests, in Japanese.

VSD Craft Plugin Development

Dynamic Workflow