LG WEBOS · DEVELOPER PREVIEW

LG webOS 安装指南

独立 IPK 桌面，非 Root 和已有 Root 模块。AI 安装、手动安装、一行命令、还原，以及默认关闭的天气卡片。

已提供 0.1.0 测试 IPK；未做 LG 实机测试，不是稳定版，不接管 Home。下载包无需自行编译。

下载 LG webOS 0.1.0 测试 IPK ↗ · 完整操作说明：校验、配对、安装、更新、卸载与测试反馈 ↗

测试项：安装启动、方向键/OK/返回、设置弹窗、应用/HDMI、可选天气、原厂 Home、待机与重启。请在 GitHub Issues 写明型号、webOS/固件和逐项结果，勿公开配对码。更新使用新 IPK 执行 ares-install 覆盖；无需先卸载。

1 · 连接前准备

电视上开启 LG Developer Mode 与 Key Server；电脑安装 Node.js 和官方 @webos-tools/cli，使用 ares-setup-device 添加设备，再用 ares-novacom --getkey 获取密钥完成配对。它通过 SSH/Luna 通信，不是 Android ADB。

npm install -g @webos-tools/cli
ares-setup-device
ares-setup-device --list
ares-novacom --device myTV --getkey
ares-device --system-info --device myTV

默认 Developer Mode SSH 通常为 prisoner@电视IP:9922。myTV 是 CLI 中配置的电视别名，不是电视 IP。勿公开 SSH 私钥、配对码。

LG 官方 CLI 文档

2 · AI 安装（推荐）

发给能在本地执行命令的 AI。预检必须先于安装，禁止以 SSH 成功冒充 Home 接管成功。

请先识别我的电视是否为 LG webOS。读取 https://github.com/lesnolie/Tigris/blob/main/docs/WEBOS_AI_INSTALL.md 和 https://github.com/lesnolie/Tigris/blob/main/webos/README.md。不要用 ADB；使用官方 LG Developer Mode、Key Server、@webos-tools/cli 与 SSH/Luna。先进行只读预检并报告设备、固件和 Home Helper 是否真正可用。提示我完成配对；保护 SSH 私钥。经我批准后再构建/安装 webOS 预览 IPK。不得 Root、刷机、改写 LG Home 或启用未验证的按键辅助程序。安装后实机测试方向键、OK、应用启动、天气（仅在启用后）、原厂 Home 恢复；没有测试的不得声称通过。

完整 AI 安装和安全探针规范

3 · 一行命令

先配置设备并做只读预检。确认后才从 main 源码打包普通 IPK。此入口构建源码预览，尚非稳定包下载。

只读预检

curl -fsSLo tigris-webos.sh https://raw.githubusercontent.com/lesnolie/Tigris/main/webos/install.sh && sh tigris-webos.sh --device myTV --preflight

确认后安装预览版

sh tigris-webos.sh --device myTV --install

macOS/Linux POSIX Shell 适用。不会 Root、修改 LG Home 或启用未经验证的 Helper。

4 · 手动安装

下载测试版 IPK 和校验文件，核对 SHA-256 后，在下载目录执行。无需克隆或打包；Windows PowerShell 同样适用。

npm install -g @webos-tools/cli
ares-setup-device
ares-setup-device --list
ares-novacom --device myTV --getkey
ares-device --system-info --device myTV
ares-install --device myTV org.tigris.webos_0.1.0_all.ipk
ares-launch --device myTV org.tigris.webos

5 · 两个适配模块

非 Root

Developer Mode 普通桌面、Luna 应用与输入源、遥控器、可选天气。Home Helper 尚未交付，快捷启动可用 LG Quick Access。

已 Root

仅检查现有 Homebrew/Root 能力，不负责 Root、不闪存、不修改系统。高级 Home 接管需要独立安全测试才能交付。

6 · 天气（默认关闭）

Open-Meteo；手动选择城市后开启，约每 30 分钟更新，最多保留 6 小时的有效缓存。关闭后不发天气请求，也不进行 IP 自动定位。

7 · 卸载和还原

sh tigris-webos.sh --device myTV --uninstall
# or: ares-install --device myTV --remove org.tigris.webos

仅移除 Tigris 的 webOS 应用。此预览版未修改 LG Home；LG 快速访问快捷键需在电视端自行取消。