功能概述
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，无法实现完全无人化配置