packServer/backend/database/migrations/20261019230000-remove-legacy-desktop-channel.js
liufumingren bca8f7270c 本机预览/云台/拉通道全部改走 WebSocket(桌面 1.0.75)
桌面端
- 新增 LocalWsServer(ws://127.0.0.1:17301):hello / ping / get_channels /
  start_preview / stop_preview / open_window / close_window / ptz / ptz_preset,
  一条连接可同时推多路 JPEG 帧(帧头带 sid);慢命令并发派发,云台命令按连接串行,
  页面断开自动清理会话与满帧率窗口
- LocalHttpServer 删除预览(MJPEG/快照/满帧率窗口)、/api/hik/channels、/api/hik/ptz*,
  HTTP 17300 只保留 /api/query/{code}、/api/activate-login、/api/playback/download,
  其余 POST 统一回 404 并提示已迁到 WS;不再依赖 HCNetSDK
- App 自行组装 HikStreamService -> HikPreviewService + HikNativePreviewService 注入 WS
- 后台服务加固:框架依赖(开发版)安装/启动时自动写服务环境变量 DOTNET_ROOT,
  避免 LocalSystem 找不到用户目录里的 .NET 8 而报「后台服务启动超时」

前端
- 新增 api/localWs.ts(连接/断线/请求-响应/二进制帧分发),补 getChannels / openWindow /
  closeWindow / ptz / ptzPreset
- CamerasView 预览只走 WS(保留「唤起本机软件 -> 等待 -> 提示安装」兜底),
  满帧率窗口、云台、预置点改走 WS
- NvrsView 拉取通道改走 WS(连不上时自动唤起一次再重试)
- CameraLayoutCanvas 合成画面 4 路改 WS 推帧
- 删除 createHikPreview/closeHikPreview*/openHikWindow/closeHikWindow*/ptzControl/ptzPreset
  与 isLocalServiceAlive/waitForLocalService

其他
- 移除 cameras.has_ptz(迁移 20261019233000)与相关接口/字段/UI
- 通道号按 struStreamMode 映射(IP 通道空槽导致 51 之后整体错位)
- 扫码 24 小时内只保留最后一次扫描(后上报时间更新时覆盖)
- 清理历史 DESKTOP 占位通道(迁移 20261019230000)
- README / desktop README 补 17301 与 WS 接口说明,修正已删除的 /api/health 描述
2026-10-20 00:47:31 +08:00

46 lines
1.7 KiB
JavaScript
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

'use strict';
/**
* 清理旧版桌面端上报的「本机中控」占位通道(channel_id = DESKTOP)
*
* 背景:
* - 旧版桌面端开启设备服务时,除了真实扫码通道,还会补报一个
* channel_id='DESKTOP'、channel_name='本机中控' 的占位通道;
* - 新版本已经不再上报(见 desktop/Services/DeviceService.cs 的注释),
* 但库里那条记录还在,会一直显示在网页「设备 → 通道」列表里,
* 也会出现在工作台「可绑定扫码通道」里;
* - 它从来没有真实数据(只是在查询框里手动回车时记过 DESKTOP 扫码记录),留着只会误导。
*
* 清理:
* - 物理删除 scan_channels 中 channel_id='DESKTOP' 的行(含已被软删除的);
* - 同步删除 workstation_scan_channels 里指向它的绑定,避免悬挂绑定;
* - scan_records 里的历史流水不动。
*
* 不可逆:down() 不做恢复。
*/
module.exports = {
async up(queryInterface) {
const [ channels ] = await queryInterface.sequelize.query(
"SELECT id FROM scan_channels WHERE channel_id = 'DESKTOP'",
);
if (!channels.length) {
console.log('[desktop-channel] 没有残留的 DESKTOP 占位通道,跳过');
return;
}
await queryInterface.sequelize.query(
"DELETE FROM workstation_scan_channels WHERE channel_id = 'DESKTOP'",
);
await queryInterface.sequelize.query(
"DELETE FROM scan_channels WHERE channel_id = 'DESKTOP'",
);
console.log('[desktop-channel] 已删除 DESKTOP 占位通道 %d 条(含工作台绑定)', channels.length);
},
async down() {
// 历史占位数据,不需要恢复
},
};