通过 SmartThings OAuth 控制三星智能电视，支持开关、音量、应用启动等功能，需自行配置 PAT 和设备 ID。
说明：
## 功能概述
Samsung Smart TV Skill 是一套基于 SmartThings 平台的 OAuth 认证与设备控制方案，允许用户通过 Clawdbot 远程操控三星智能电视。该技能采用 OAuth-In 架构，需用户先在 Samsung 账户中创建个人访问令牌（PAT），随后完成 OAuth 应用授权流程，最终获取设备控制能力。
### 核心用法
**初始化配置（一次性）**
1. 访问 https://account.smartthings.com/tokens 生成 PAT
2. 运行技能创建 OAuth 应用（smartthings-clawdbot），获取 client ID/secret
3. 在手机端打开授权 URL，登录 Samsung 账户后复制 redirect URL 中的 code 参数
4. 重新运行技能完成 token 交换，凭证自动写入 ~/.clawdbot/.env
5. 使用 SmartThings CLI 查询设备列表，将电视的 device ID 存入环境变量
**日常控制**
– 设备状态查询（电源、音量、当前输入源等）
– 基础控制指令：开关机、音量调节、静音切换
– 应用启动：需先手动打开目标应用，从设备状态中提取 appId 后保存复用
### 显著优点
– **官方生态集成**：基于 Samsung 第一方 SmartThings API，非破解或逆向方案
– **细粒度权限控制**：OAuth 范围限定为设备读取（r:devices:*）与执行（x:devices:*），最小权限原则
– **无浏览器依赖**：默认 headless 模式，适合服务器/自动化场景
– **凭证持久化**：token 自动存储，支持刷新续期
### 局限性与缺点
– **配置门槛高**：需用户自行处理 PAT 创建、OAuth 流程、设备 ID 查询等多步骤，无图形化引导
– **应用 ID 不通用**：第三方应用（如 YouTube）的 ID 因设备而异，必须逐台电视手动 discovery
– **依赖外部服务**：默认使用 httpbin.org 作为 OAuth redirect endpoint，虽可自定义但增加复杂度
– **CLI 工具依赖**：设备发现与管理依赖 SmartThings CLI，非纯 API 方案
### 适合人群
– 拥有三星 Tizen 系统智能电视的技术用户
– 已使用 SmartThings 生态并希望实现自动化脚本的家庭用户
– 愿意投入时间完成 OAuth 配置以获得稳定官方 API 支持的开发者
### 常规风险
– **凭证泄露风险**：PAT 和 OAuth token 以明文形式存储于本地 .env 文件，需确保文件权限安全（建议 600）
– **Token 过期**：OAuth token 有效期有限，需定期重新授权或使用刷新机制
– **API 变更**：SmartThings API 为 Samsung 私有平台，存在接口变更或弃用风险
– **设备兼容性**：部分旧型号三星电视或特定地区型号可能不支持 SmartThings 集成
– **手动操作依赖**：应用启动流程要求用户先手动操作电视以获取 appId，无法实现完全无人化配置
