# 天音（讯歌 xunge）KTV 点歌系统 · 远程工具指令手册

> 整理自《远程工具指令20260605》工程笔记，按功能分类。
> 品牌/包名：com.xunge.ktv（讯歌/天音）；服务器路径含 xungeKtv。
> 机型：T6 / T7 / T8（机顶盒）、S7 / S8（服务器）。
> `<data>` `<config>` `<exe>` 为远程工具中的快捷目录符号。

---

## 目录
1. [远程连接方式](#1-远程连接方式)
2. [常用目录结构](#2-常用目录结构)
3. [模块升级（核心）](#3-模块升级核心)
4. [设备信息查询（query 系列）](#4-设备信息查询query-系列)
5. [基础库/内容库检查与升级](#5-基础库内容库检查与升级)
6. [评分数据修复](#6-评分数据修复)
7. [广告图修复](#7-广告图修复)
8. [硬盘/节点检查](#8-硬盘节点检查)
9. [内容更新 / 清理](#9-内容自动更新--删歌)
10. [常见故障处理](#10-常见故障处理)
11. [机型差异速查](#11-机型差异速查)
12. [特殊场景](#12-特殊场景)

---

## 1. 远程连接方式

- **Windows 远程连接 T6**：端口号 `65006`
- **ADB 连接机顶盒**（拉取文件/调试用）：
  ```
  adb connect 192.168.x.x:5555      # 先在配置工具打开 adb
  adb root                          # 获取 root 权限
  adb devices                       # 查看连接设备；多设备用 -s 指定
  adb pull /system/bin/xungeKtv/storage/media/0/xungeKtv/Data/RankingSongs.db
  ```
  > 路径每台服务器可能不同（单盘/双盘），用 `cd ..` 逐层返回 + `pwd` 核对。

---

## 2. 常用目录结构

| 快捷符号 | 实际路径（示例） | 用途 |
|---|---|---|
| `<data>` | T8 迁移至 `<config>/Data` | 内容库 / 评分数据 |
| `<config>` | /data/data/com.xunge.ktv/cache/config 等 | 配置文件 |
| `<exe>` | /system/bin/xungeKtv/... | 可执行/系统 |
| cache | /data/data/com.xunge.ktv/cache | 广告图/资源缓存 |

进入目录：`cd <data>` / `cd <config>`
查看文件及时间：`ls -l`
查看目录信息：`ll`
同步缓存：`sync`
重启机顶盒：`reboot`

---

## 3. 模块升级（核心）

### 3.1 升级指令清单
```
script        // 升级新的脚本版本
libraryex     // 升级新的程序库版本
server        // 升级新的服务程序版本
resource      // 升级新的资源数据
singermain    // 升级歌星图片基础库
singer        // 升级歌星图片差分库
clientex      // 升级新的客户端 app 版本
gift          // 升级新的礼物版本
dbupdate      // 升级数据库（榜单数据等）
osd           // TV 端资源
skin          // 皮肤（公用）资源
skin03        // 皮肤（经典）
skin04        // 皮肤（黑金）
skin05        // 皮肤（生日）
skin08        // 皮肤（缤纷）
apk0          // CCTV 新视听
apk1          // 投屏
apk2          // 微视听
apk3          // 酷狗音乐
apk5          // 全民K歌
```

### 3.2 HTTP 升级接口
```
query vod/doupgrade.html?method=updateModule&module=<模块名>
```
例：升级客户端 app
```
query vod/doupgrade.html?method=updateModule&module=clientex
```
> 机顶盒会推送该等级下的最新版本。
> 注意：融合版和标准版对应 apk 包名可能不同（如融合版酷狗是 apk3，标准版可能是 apk5）。

---

## 4. 设备信息查询（query 系列）

```
query ktv/server_info.html          # 查看服务器实时带点数量
query ktv/client_list.html          # 查看客户端详细列表
query ktv/disk_info.html            # 查看硬盘数量及路径
query stb/debugifo.html             # 客户端调试信息
query stb/debuglog.html             # 查看云服务是否到期、能否正常下载
query stb/scan_media.html           # 远程恢复系统（扫媒体）
query vod/debuglog.html             # 查询执行结果
```

完整 HTTP 形式（带 IP）：
```
query http://192.168.1.x:12080/stb/debugifo.html
query http://192.168.1.x:12080/vod/sound_record?method=getVocalPcm   # 听取录音
```

带点客户端列表（HTTPS）：
```
https://192.168.1.x:12443/ktv/client_list.html
```

对应查询路径：
- `Vod/device` — 设备
- `Ktv/server` — 歌曲下载、硬盘
- `Stb/datasource` — 数据库、大数据

---

## 5. 基础库/内容库检查与升级

1. 进入 data 目录：`cd <data>`（T8：`cd <config>` → `cd Data`）
2. 查看文件及时间：`ls -l`
3. 对应基础库版本：
   - 6.5 基础库主库 → 指定升级 `database7`
   - 6.0 基础库主库 → 指定升级 `databasex`
   - 5.0 基础库主库 → 指定升级 `database`
4. 服务器与客户端校验：`crcsum 基础库名称` — 结果一致即正常
5. 更换硬盘后需强制升级对应板块；升级后重启对应版块 `datasource` 即可

查看服务器中控模板/断电参数：
```
cd <config>
cat controller.conf
```
> 查看调试信息接收到的中控关机码是否正常，不正常则为开机板问题。

---

## 6. 评分数据修复

**现象**：评分数据错误 / 无评分。

1. 客户端及服务器 `data` 目录对比 `ScoreSongIds.db` 文件大小
   - 不一致 → 机顶盒评分有问题
   - 一致但无评分 → 都有问题

2. 删除机顶盒评分文件：
   ```
   cd <data>
   rm ScoreSongIds.db          # 或 EvaluableSongIds.db
   sync
   ls -l                       # 确认删除
   reboot
   ```
3. 删除服务器评分文件：
   ```
   cd /system/bin/xungeKtv/sdcard/xungeKtv/nginx/disks/sda1/Data/XungeDb/
   rm ScoreSongIds.db
   rm EvaluableSongIds.db
   sync
   reboot
   ```

---

## 7. 广告图修复

```
cd /data/data/com.xunge.ktv/cache
cd v1        # 新版界面（v2 为老版）
cd hor       # 横屏
rm moren.png
sync
reboot
```

---

## 8. 硬盘/节点检查

- 进入歌曲文件目录，正确应显示分区硬盘（sda、sdb 为标识；sda1 等为节点）
  - 不显示 sda/sdb → 掉盘
  - 不显示 sda1 等 → 节点问题
- 查看节点/硬盘加载：`mount`
- 查看硬盘总容量：`df`
- 查看硬盘数据（按机型见 [§11](#11-机型差异速查)）

**S7/S8/T6 硬盘状态检查命令**：
```
/system/bin/xungeKtv/x5DeviceSdk -a -d ata /dev/block/sda      # S7/S8
/system/bin/xungeKtv/x5DeviceSdk -a -d sat /dev/block/sda      # T6
```
> 序号 5、197、198、199 对应值不为 0 即硬盘有问题。
> 其中 199 不为 0：先换电源适配器或 SATA 线，更换后 199 仍在增加 → 硬盘已损坏。

查看剩余空间：`df`
只读改可写：`remount`

---

## 9. 内容更新 / 清理

**清理本场所低点击率内容 50 首**：
```
http://192.168.1.x/stb/recycle_media.html?id=设备编号
或 query /stb/recycle_media.html?id=设备编号
```
> IP 为要操作的设备 IP，执行后在监听工具查看删除结果。

**内容自动更新**：
```
query ktv/mediadownload.html?method=auto&id=设备编号&maxCount=100&maxRate=6
```
- `maxCount`：最大下载数量
- `maxRate`：下载速度（M/s，范围 2~8）

**删除派对歌曲**：
```
query ktv/re_partysongs.html
```

---

## 10. 常见故障处理

### 10.1 机顶盒卡在开机画面（T8/通用）
大概率 app 安装失败（如签名不匹配）：
```
pm uninstall com.xunge.ktv
query vod/doupgrade.html?method=updateModule&module=clientex
```

### 10.2 T7 内存不足 / 重复升级
```
df
remount                          # 改为可写
cd /system/preinstall
ls
rm FlaotingBall.apk
rm apk*.apk                      # 删除以 apk 开头的 apk
df
cd <exe>
ls -l
reboot
```
> 也可用：`query vod/storage.html?method=cleanup&level=1`（重新安装全部第三方 APP）

### 10.3 T8 反复重启
```
cd /data/data/com.xunge.ktv/cache/config
# 查看所有者是否为 system，若不是则删除该文件重启
```

### 10.4 T7 酷狗显示未安装
```
cd /system/preinstall
# 若没有酷狗，指定模块升级 → apk3
query vod/doupgrade.html?method=updateModule&module=apk3
```

### 10.5 第三方 app 卡死
```
cd /data/data/com.zbx.ct.tvzhibohd
rm -rf app_*                     # 强制递归删除 app_* 目录
ps -e | grep zbx                 # 查找运行中的进程
kill <pid>                       # kill 正在运行的 app
```

### 10.6 S8 服务器歌星头像只显示几个
```
cd <config>
cd Singer
rm -rf jpeg                       # 删除 jpeg 歌星图片
sync
reboot
```
S8（2.9.203 及以后版本）：
```
query vod/doupgrade.html?method=checkSingerPic
query vod/debuglog.html           # 查询执行结果
```

### 10.7 S8 歌星头像是否正常（判断）
```
cd <config>
cd Singer
du -sh
```
> 返回 149M 为正常，异常会小于 149M。

### 10.8 控制不了房态
查看调试信息，确认调用的是酒水接口的开关房信息，IP 为发送开关房指令的机器 IP。

### 10.9 查看机顶盒后台设置
```
cd /data/data/com.xunge.ktv/cache/config
cat ktv_client.conf
# 自动关机设置：0 关闭 / 1 打开
```

### 10.10 查看场所信息
```
cd <config>
cat server.conf
# 正式版 / -2 单机版 / 0 已过期
```

---

## 11. 机型差异速查

| 项目 | T6 | T7 | T8 | S7/S8 |
|---|---|---|---|---|
| 硬盘数据命令 | `-d sat /dev/block/sda2` | — | — | `-d ata /dev/block/sda` |
| Windows 远程端口 | 65006 | — | — | — |
| 内存/刷机问题 | — | 内存不足易升级失败；刷过机后有 `.firmwareVer` | — | — |
| 固件版本查看 | — | — | `getprop \| grep ro.sw.ver` | — |

**T7 已刷机无法再刷机处理**：
```
cd <config>
ll
cat .firmwareVer        # 查看烧录版本
rm .firmwareVer         # 删除后可再刷
```

**查看 T7 机顶盒温度**：
```
cd <config>
ll
cat a.log
```

**查看机顶盒内存**：`dumpsys meminfo`
> 有此项才能正常播放歌曲，无则需刷机。

---

## 12. 特殊场景

### 12.1 新年倒计时（T7，V3.7.503.2）
手动执行显示 20 秒视频效果：
```
date 123123592026.30
```
格式：`月日时分年.秒`。秒数按视频长度设，20 秒视频不要设成 59，保险起见设 `00`。
> 定时器执行一次后必须重启机顶盒才能生效下次。

**方法二（10 秒倒计时视频，换素材）**：
```
cd /data/local/gift
mv newYearDay.webp newYearDay_.webp
cp springFestive.webp newYearDay.webp
date 021623592026.30
```

### 12.2 S8 清空本地点击率是否成功
```
cd <config>
cat rating.txt
```
> 清空成功则无 `rating.txt` 和 `rating_singer.txt` 文件。

### 12.3 查看场所所连客户端数量
```
https://192.168.1.x:12443/ktv/client_list.html
```

### 12.4 听取录音
```
http://192.168.1.x:12080/vod/sound_record?method=getVocalPcm
```

---

## 附：命令速查（最常用 10 条）

| 场景 | 命令 |
|---|---|
| 重启机顶盒 | `reboot` |
| 同步缓存 | `sync` |
| 升级客户端 app | `query vod/doupgrade.html?method=updateModule&module=clientex` |
| 查看带点数 | `query ktv/server_info.html` |
| 查看客户端列表 | `query ktv/client_list.html` |
| 查看硬盘 | `query ktv/disk_info.html` |
| 内容自动更新 | `query ktv/mediadownload.html?method=auto&id=设备编号&maxCount=100&maxRate=6` |
| 删低点击率歌 | `query /stb/recycle_media.html?id=设备编号` |
| 删派对歌曲 | `query ktv/re_partysongs.html` |
| 卡开机画面修复 | `pm uninstall com.xunge.ktv` + 升级 clientex |

> IP、id（设备编号）、模块名等参数按实际场所替换。