技能介绍

ETV 屏幕发布常要跨多个 HTTP 接口：鉴权、拉设备列表、选屏、推网页/图片/字幕，手动写 curl 容易漏参数、搞错 clNo/clSn，还可能误投到真实屏幕。

解决什么问题

接口分散：POST /etv/getAuthToken.json、pushWebPageProgramMould.json 等接口路径和入参难记；
环境差异：默认服务 http://nps.dell.4dbim.cc:60192/ 不能适配所有部署，换环境要手动改 --base-url 或 ETV_BASE_URL；
敏感操作：投放到真实屏幕不可逆，Agent 直接执行有误投风险；
素材混乱：图片、视频等素材若错用 PagePilot 当素材库，后续在 ETV 侧无法统一管理；
重复登录：账号密码每次都要输入，Token 无缓存导致频繁鉴权。

技能如何工作

核心能力

封装 scripts/quick_publish.py，覆盖登录、选屏、推网页、推图片、轮播、字幕全流程，不用手写 curl；
自动把用户给的 clSn 转成快捷接口需要的 clNo；
本机缓存账号密码，30 分钟内复用 Token，不用重复登录；
按内容类型提供快捷命令：push-web 推网页、push-image 推单图、push-carousel 推轮播、push-subtitle 推字幕。

标准流程

登录：已记住账号时只问「还是用账号吗？」；首次输入账号密码；
拉设备列表：获取屏幕名称、SN、在线状态、横竖屏和分辨率；
用户选屏：从真实设备列表里选目标屏幕，不凭空指定；
内容确认：用户给现成内容时，展示 URL/图片列表/字幕内容和目标屏幕；用户要求设计海报、HTML 时，先按屏幕分辨率设计并预览；
二次确认：目标屏幕、内容摘要、接口动作都确认后，Agent 执行命令；
回查状态：下发后查任务或设备状态，确认任务已挂到目标屏。

适用边界与注意点

适用场景：快速推网页、单图、多图轮播、字幕/插播到 ETV 屏幕；
不适用场景：复杂画布布局（多控件、Web+图片混排）、互动节目（按钮跳转、触控触发）；
注意事项：

- 所有真实投放操作必须等用户二次确认，Agent 不自行执行；
- 素材优先上传 ETV 素材库，拿到 mtId 或 ETV URL 后再下发；
- 远程指令下发后必须回查状态，确认指令执行情况；
- 设备离线时可以下发，但要提示后台可能等待设备上线后同步；
- 不打印 Token、密码、私钥或完整敏感凭据。