技能介绍

要解决的问题

在桌面端调试播放器行为时，通常需要手动点按界面按钮、来回拖动进度条、逐个切换字幕轨道。当需求变成批量验证播放逻辑、自动化回归测试，或者希望把播放器接入自己的脚本流水线时，纯 UI 操作就显得笨拙且不可编程。SHPlayer Controller 就是为此设计的：它把搜狐影音的常见控制能力封装成一组 MCP 工具，让 Agent 或自动化脚本可以通过协议直接驱动本地播放器。

工作原理与核心能力

技能通过 Streamable HTTP 连接到本地 MCP 服务 https://localhost.tv.sohu.com:7981/mcp，无需额外认证。使用前需确保搜狐影音已启动，且本地 MCP 服务在运行——通常随软件一起拉起。

它共暴露 11 个工具，覆盖以下场景：

播放控制（control_playback）：执行播放/暂停、切集、从头播放，以及弹幕开关、自动跳过片头片尾、无痕模式的批量切换。
进度与倍速（adjust_playback）：通过 seek 传入目标秒数（如 "600"），也支持 +30 / -30 这类相对值；speed 支持 0.5 到 3.0 共 7 档倍率。
媒体与搜索：play_media 直接播放本地视频，search_media 检索搜狐在线片库。
字幕与截图：manage_subtitle 管理字幕轨道——注意 list 返回的 subtitle_id 仅供后续 select 使用，不应直接展示给用户；take_snapshot 无参数截取当前帧。
画面与系统：transform_video 处理旋转/翻转，manage_wallpaper 将当前画面设为动态壁纸，configure_system 处理换肤、开机自启、缓存清理、设为默认播放器等操作。
导航与历史：navigate_to_page 页面跳转，query_user_history 读取观看历史。

典型调用流程很直接：先确认播放器和 MCP 服务在线，再按场景组合工具——例如搜索在线片库 → 播放 → adjust_playback 跳到目标位置并开启倍速 → manage_subtitle 切换字幕 → take_snapshot 取证。

适用边界与注意点

依赖本地环境：所有能力都建立在搜狐影音已运行且 MCP 服务可达的前提下，无法远程驱动或操控未安装该软件的机器。
工具参数细节有限：SKILL.md 只列出工具名与大致用途，具体字段约束、错误码和返回结构需要查阅 references/tools.md，接入前应先把这份文档通读一遍。
弹幕/跳过/无痕等开关是瞬时的：调用 enable_danmaku 这类动作只会翻转开关状态，不会持久化配置到用户账户，重启播放器后状态需重新确认。
截图仅捕获当前帧：take_snapshot 不提供时间戳参数，要截取指定画面必须先 seek 到目标位置再调用。

整体上，这套工具适合本地自动化测试、播放器行为回归，以及需要把播放控制嵌入 Agent 工作流的工程场景，而不是面向终端用户的通用遥控器。