名称： samsung-smart-tv
描述： 通过 SmartThings 控制三星电视（OAuth 应用 + 设备控制）。
主页： https://developer.smartthings.com/docs
元数据： {"clawdbot":{"emoji":"📺","requires":{"bins":["python3","npx"]},"install":[{"id":"python-brew","kind":"brew","formula":"python","bins":["python3"],"label":"安装 Python (brew)"},{"id":"node-brew","kind":"brew","formula":"node","bins":["node","npx"],"label":"安装 Node.js (brew)"}]}}

Samsung Smart TV (SmartThings)

此技能用于配置 SmartThings OAuth 应用，并为 Clawdbot 存储凭据。

初始设置（一次性）

• 使用个人访问令牌（PAT）以无头模式创建 SmartThings OAuth 应用，并生成一个手机登录链接（仅提供纯文本说明）。
• 在手机上打开该链接并登录，然后从重定向页面复制 code 查询参数，重新运行命令以交换令牌。
• 如果 PAT 创建应用失败（403 错误），请在普通设备上使用 SmartThings CLI 登录流程创建应用，然后在运行代码交换步骤前，在 .env 文件中设置客户端 ID 和密钥。
• 重新运行命令以刷新凭据：使用纯文本描述操作步骤（不包含代码片段）。

功能说明

• 创建一个显示名称为 smartthings-clawdbot 的 OAuth-In SmartApp。
• 使用 r:devices:* 和 x:devices:* 权限（读取 + 执行命令）。
• 重定向 URI 默认为 https://httpbin.org/get（可通过 redirect-uri 选项覆盖）。
• 将 SMARTTHINGS_APP_ID、SMARTTHINGS_CLIENT_ID、SMARTTHINGS_CLIENT_SECRET 及 OAuth 令牌写入 ~/.clawdbot/.env（或 CLAWDBOT_STATE_DIR/.env）。
• 当提供 PAT 时，使用 SmartThings CLI 创建 OAuth 应用。
• 通过直接 HTTPS 请求向 SmartThings 交换 OAuth 代码以获取令牌（不通过 CLI）。

设备设置

• 使用 SmartThings CLI 以 JSON 格式列出设备，并找到电视的设备 ID。
• 将其存储为 SMARTTHINGS_DEVICE_ID 到同一个 .env 文件中。

常用操作（仅纯文本）

• 通过 SmartThings CLI 列出设备及其功能。
• 检查设备状态。
• 向电视设备发送开关、音量、静音等命令。

应用启动（Netflix/Prime Video）

• 应用启动功能因设备而异；请在设备功能中查找 applicationLauncher 或 samsungtv。
• 在设备状态的 supportedApps 或 installedApps 字段中查找应用 ID。
• 使用 SmartThings CLI 和电视对应的 appId 启动应用。
• 示例 ID 并非通用；请使用您电视上列出的 ID。

应用发现（当用户要求打开特定应用时）

1. 首先，在电视上手动打开目标应用。
2. 然后查询设备状态，查找 tvChannelName、installedApps 或 supportedApps 等字段，以提取当前 appId。
3. 保存该 appId 以备后用；部分 ID 是设备特定的。
4. 已知的应用 ID 模式（示例）：
   • 标准/全局应用（通常稳定）：
     • Netflix: org.tizen.netflix-app
     • Amazon Prime: org.tizen.primevideo
     • 模式：org.tizen.[app-name]
   • 设备特定应用（因电视而异）：
     • YouTube: {random}.TizenYouTube
     • Joyn: {random}.ZAPPNVOLLTVFREIGESTREAMT
     • 模式：{random}.{PackageName}
   • 避免猜测；务必从电视的状态响应中确认 appId。

注意事项

• 脚本默认以无头模式运行，不会打开浏览器。
• 通过 SMARTTHINGS_TOKEN（或 SMARTTHINGS_PAT）环境变量提供 PAT 进行身份验证。
• 在此处创建 PAT：https://account.smartthings.com/tokens
• OAuth 流程：在手机上打开打印的 URL，登录后从重定向页面复制 code 查询参数，然后使用 auth-code 重新运行命令。
• 默认重定向使用 https://httpbin.org/get 以在 URL 中显示代码；如不想使用 httpbin，可切换至自己的重定向 URI。
• 重新运行设置是安全的；它会原地更新环境变量条目。
• 响应风格：请勿包含代码块或内联命令片段；仅使用纯文本步骤说明。