15 Commits

Author SHA1 Message Date
liufumingren
27482723ff 修复「复制谷歌插件地址」剪贴板占用报错
- Clipboard.SetText 在别的进程持有剪贴板时会直接抛 CLIPBRD_E_CANT_OPEN(0x800401D0),
  改为先 WPF 再 WinForms 两套实现各自重试(3 次 ×150ms)
- 仍失败时提示原因(输入法 / 剪贴板工具 / 远程桌面 rdpclip),并可选择打开记事本显示路径
- 桌面端 README 补充该行为说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 14:03:10 +08:00
liufumingren
228723e0c3 设备端扫码上报 + 桌面端/Android 正式包发布脚手架
AndroidStation(原中控改造为纯设备端)
- 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报
- 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报
- 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满
- 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」
- 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启)
- 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖

发布脚手架
- backend/android_client:Android 正式包构建(build.ps1 + package.config.json)
- backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish
- 桌面端安装包改为 download/desktop,Android 为 download/android_client;
  version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json
- 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」
- git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 05:53:27 +08:00
liufumingren
e8923dbe56 feat(desktop): 多路回放按 OSD 时间对齐,合并时摆回同一时间轴
- 每路下载后读 NET_DVR_GetPlayBackOsdTime 得到真实起播时间,算出相对请求起点的偏移,
  返回 PlaybackClip(Path, StartOffset);合并时按偏移补 -itsoffset,画面不再错位
- 各路都从自己的关键帧起播 → 单路内容多了就裁掉,最后一路固定以收尾时间对齐
- 回放预览改成多路同播:每路独立 FfmpegStream 订阅帧、按第一帧到达时间对齐,
  队列超长时跳到最新帧(追帧),窗口结束即停;去掉「关闭」按钮改由流程自动关闭
- FfmpegStream 支持多订阅者(同一 rtsp 只拉一次),避免多路预览重复解码

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:43 +08:00
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
liufumingren
c3cae69e6e feat(desktop): 主体切换与登录、主界面及日志留存改造 2026-10-19 22:04:10 +08:00
liufumingren
62ab25e6fe feat(desktop): 主界面/托盘不再显示服务地址与运行状态
- 主界面移除整行「● 本机服务 运行中 · http://…」,顶部只留「已登录:xxx / 退出登录」
- UpdateServerState 只刷新菜单「服务 → 服务状态」,不再碰界面控件
- 托盘菜单的状态项改成固定的「本机服务」(原来是「服务:<地址>」),
  UpdateStatus 只传「运行中 / 未启动」;TrayIconService 构造不再需要 serverUrl
- 运行状态统一在菜单里看,界面不再重复展示内部实现细节
2026-10-17 18:23:55 +08:00
liufumingren
21dfc7f651 feat(desktop): 日志改为落文件(软件目录 logs\log_日期.txt),界面移除日志模块
- AppLog:不再做内存缓冲/事件,直接按天追加到 <软件目录>\logs\log_yyyy-MM-dd.txt
  行格式 [yyyy-MM-dd HH:mm:ss] 内容;写失败一律吞掉,不影响主流程
  装到只读目录(如 Program Files)时自动退回 %LOCALAPPDATA%\YuncangTrace\logs
- 新增 AppLog.Clear():删除目录下全部 log_*.txt(当天文件也能删,之后重建)
- MainWindow:删掉「运行日志」ListBox 与整套集合/订阅代码,Grid 行 4→3
  查询卡改成 Grid(结果框自适应高度),窗口 620→460
- 菜单「工具」增加「打开日志目录」「清理日志」
- build.ps1 补 -p:AppEnvironment:原来 Release 发布时环境恒为 Production,
  开发包日志/关于里也显示「生产环境」(现在与 -Environment 一致)
- test-update.ps1:更新完成后轮询 60s 等服务与进程起来,避免误报「无响应」
2026-10-17 18:10:28 +08:00
liufumingren
7fdbe5afc1 feat(desktop): 主界面增加 工具 / 服务 / 帮助 菜单
- 工具:测试查询(聚焦输入框)、清理更新缓存(删 %TEMP%\YuncangTraceUpdate)
- 服务:服务状态(只读,随启停实时刷新)、重启软件
- 帮助:检查更新(复用启动时的检查流程)、关于(版本/环境/服务状态)
- 重启/检查更新通过事件交给 App,避免 MainWindow 直接碰进程与更新逻辑
- 保持界面不出现服务地址 / 协议 / 停止服务 等内部信息
2026-10-17 18:03:59 +08:00
liufumingren
2ab3ad35e5 主界面移除协议状态文字;修复「未登录/网络异常时不会自动更新」与「误清登录令牌」
一、UI
- 主界面删除「已注册 yuncang://(网页可叫醒本软件)」整行(`ProtocolText`),
  行定义 4→3(标题 / 查询 / 日志);删除 `UpdateProtocolState()` 及其调用。
  协议对用户是内部实现,不展示;注册由 MSI 完成、卸载自动删除、启动自动校正。

二、修复(本次测试暴露的真实缺陷)
1. **更新检查提前到登录之前**(`App.OnStartup`):
   原来放在 `ShowMainWindow()` 之后,一旦本地令牌失效/未登录,软件停在登录窗,
   **永远不会检查更新**(实测 1.0.7 → 1.0.8 卡在登录窗 180s 未更新)。
2. **`ApiClient.MeAsync` 不再把网络错误当成"令牌失效"**:
   原来 catch(ApiException) → return null,调用方据此 `SessionStore.Clear()`,
   后端启动中/一时连不上就会**误删 session.json**(本次就丢了登录态)。
   现在只有 401/403 返回 null;超时/连不上/5xx 抛异常 → 登录窗保留令牌并提示,
   下次启动仍可自动登录。

三、验证(标准流程:打包 → 启动旧版 → 自动更新)
- 打包 1.0.9(含修复)并安装(旧版 1.0.7 因缺陷无法自更新,只能手工升级一次);
- 打包 1.0.10 → `test-update.ps1`:
    当前安装 1.0.9(**处于登录窗,未登录**)→ 后端目标 1.0.10
    [4s] 1.0.9 → [10s] 1.0.10
    ✔ 自动更新完成:1.0.9 → 1.0.10(耗时 10.1s)
    ✔ 本机服务 17300 有响应(HTTP 401)
    ✔ 软件进程已恢复
  证明「未登录也能检测并完成更新」。

四、待用户操作:本次测试中 session.json 被旧逻辑误删,需要**重新登录一次**;
   之后的版本不会因为网络抖动再丢登录态。
2026-10-17 16:59:23 +08:00
liufumingren
d32656a2f4 主界面不再显示服务地址(内部协议不需要用户关心)
- MainWindow.xaml:删除「服务地址 / 复制地址 / 在浏览器打开」整块;
  行定义从 6 行缩到 4 行(标题 / 协议状态 / 查询 / 日志)。
- MainWindow.xaml.cs:删除 AddressBox 赋值、CopyAddress_Click、OpenInBrowser_Click
  以及不再需要的 using System.Diagnostics。
- README:补充「主界面不展示服务地址」的说明,托盘菜单文案同步(续 重启软件)。

验证(重点:自动更新全链路,不卸载重装):
1. build.ps1 -Environment Development -Version 1.0.6 → version.json/MSI 落到后端;
2. 当前安装的是 1.0.5,直接启动(带 YUNCANG_AUTO_UPDATE=1 走自动下载):
   → 检测到 1.0.6 → 软件内下载 + MD5 校验 → msiexec /passive 安装 → 进程退出 → 自动重开;
3. 监控结果:安装目录 ProductVersion 从 1.0.5 → **1.0.6**,进程恢复、服务 17300 正常
   (query 200),启动后不再提示更新(version.json 也是 1.0.6);
4. 升级后界面元素只剩:退出登录 / 本机服务状态 / 协议状态 / 测试查询 / 运行日志 ——
   已无服务地址、复制地址、在浏览器打开。

备注:中途遇到一次「看起来没更新」,原因是测试时序错了——启动软件时后端 version.json
还是 1.0.5(打包尚未完成),属于测试操作问题,不是逻辑缺陷。
2026-10-17 12:43:29 +08:00
liufumingren
af3f8abda0 主界面移除「停止服务 / 复制唤醒地址」,托盘菜单新增「重启软件」
需求:服务跟随软件运行,不需要单独的启停;唤醒地址由插件生成,界面不必提供复制。

- MainWindow.xaml:删除「停止服务/启动服务」与「复制唤醒地址」按钮;
  第③行只保留协议状态文字;标题栏的圆点 + 「运行中 · 地址」继续显示服务状态。
- MainWindow.xaml.cs:
  - 删除 StartStop_Click(不再允许手动停服务:停了网页看到的现象和"未安装"一模一样);
  - 删除 CopyLaunchUrl_Click;
  - UpdateServerState 只刷新状态点/文字;移除 ServiceStateChanged 事件;
  - 顺手修复「在浏览器打开」指向了已删除的 /api/health → 改为根路径说明页。
- TrayIconService:菜单新增「重启软件」(打开主界面 / 重启软件 / 服务地址 / 版本 / 退出)。
- App:订阅 RestartRequested → RestartApplication():
  用 `cmd /c timeout /t 2 & start "" "<exe>"` 延迟拉起自己,再走正常退出流程
  (必须先退出,否则新进程会撞单实例检测、把参数转发给正在退出的旧进程后就没了)。
- README:行为表补「托盘右键重启软件」,并说明主界面不提供启停/复制唤醒地址的原因。

验证:打包 1.0.5 安装后,主界面控件只剩「退出登录 / 复制地址 / 在浏览器打开 / 查询」等,
无启停与复制唤醒地址;协议状态文字正常;托盘菜单代码含「重启软件」。
2026-10-17 12:36:48 +08:00
liufumingren
1a61cffaa4 主界面去掉协议注册/取消按钮:协议由安装包注册、卸载自动取消
- MainWindow.xaml:移除「注册启动协议 / 取消启动协议」按钮,仅保留状态文字
  (「已注册 yuncang://(网页可叫醒本软件)」/ 未注册时提示重新运行安装包)。
- MainWindow.xaml.cs:删除 Protocol_Click(含确认框与 Unregister 调用),
  UpdateProtocolState 只更新文案(仍会提示"已注册但指向旧路径,重启会自动校正")。
- ProtocolHelper:注释更新——注册由 MSI 安装包完成、卸载时自动删除,
  启动时由 App.EnsureProtocolRegistered 校正;Unregister 仅供卸载工具/排障。
  理由:UI 上留「取消」按钮容易误点,点了网页就再也叫不醒软件,恢复还得重装。

验证:打包 1.0.4 安装后,界面按钮只剩「停止服务 / 复制唤醒地址 / 查询…」,
状态文字正常;版本 1.0.4 与后端 version.json 一致,启动不提示更新。
2026-10-17 12:32:45 +08:00
liufumingren
30ad162c69 修复唤起:协议自动指向当前 exe + 单实例监听提前 + 自包含发布(不再依赖 DOTNET_ROOT)
现象:网页点「启动本机软件」/双击 exe 弹「You must install .NET Desktop Runtime」,
网页表现为唤起没反应、查询失败。

根因有两个:
1. 协议注册表指向的是 bin\Debug 的 framework-dependent exe,它靠 DOTNET_ROOT 找运行时;
   而浏览器/资源管理器/协议拉起的进程拿不到我们临时设的环境变量 → 直接弹安装提示。
   更糟的是协议只在主窗口手动点按钮才注册,换目录/换构建后注册表一直是旧路径。
2. 单实例的命名管道监听是在「登录完成、主窗口出现」之后才 StartListening,
   用户卡在登录窗期间被协议唤起 → 参数无人接收(第二个实例连不上管道就直接退出了)。

修复:
- App.EnsureProtocolRegistered():每次启动把 HKCU 的 command 校正到 Environment.ProcessPath,
  与当前 exe 一致时跳过(幂等);不一致时重注册并记日志(含原路径,方便排查)。
- _single.StartListening() 提前到启动服务之后、登录之前。
- 登录期间收到唤起:存 pending code 并把登录窗叫到前面,登录完成后自动查询(原有逻辑保留)。
- 抽出 BringLoginWindowToFront(),OnLoginRequested / 第二次双击(不带 URL)也走它——
  以前登录期间再双击 exe 是彻底没反应的。
- MainWindow 的协议状态改为显示「是否指向当前 exe」,指向旧路径时提示重启会自动校正。

分发形态改为自包含:
- desktop/nuget.config 指向华为云 NuGet 镜像(本机访问不了 api.nuget.org),
  自包含发布要下载 Microsoft.*.App.Runtime.win-x64;
- dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
  -p:IncludeNativeLibrariesForSelfExtract=true -o publish → 单文件约 154 MB,双击/协议唤起都能直接跑。
- publish/ 已在 .gitignore 里。

实测(全程清掉 DOTNET_ROOT,模拟用户环境):
- 冷启动:yuncang://open?code=COLD123 → 进程起来 → 恢复登录 → 自动查询 COLD123;
- 已运行时:yuncang://open?code=TEST999 → 管道转发到原实例 → 主窗口前置并查询;
- 注册表自动从 bin\Debug 校正到 publish\...exe(日志有记录);
- 网页 /local?code=ABC123 → 已登录 → 正常展示查询结果(真实桌面端,非 mock)。
2026-10-17 10:58:03 +08:00
liufumingren
51abccbaaf desktop:加登录页、托盘图标、防多开(单实例 + 参数转发)
- LoginWindow:服务器地址 / 账号 / 密码 / 记住账号 → POST /api/web/auth/login 拿 user JWT;
  本地已有令牌时先用 GET /api/web/me 验证,有效就跳过登录(窗口一闪而过),无效清掉令牌留下重登。
- TrayIconService(WinForms NotifyIcon,csproj 开 UseWindowsForms):
  关窗口 = 隐藏到托盘(本机服务继续跑),双击托盘恢复,右键菜单「打开主界面 / 服务地址 / 版本 / 退出」;
  第一次缩到托盘冒一次气泡提示。退出只走托盘「退出」(App 改 ShutdownMode=OnExplicitShutdown)。
- 防多开:SingleInstance(Local\ 命名互斥体 + 命名管道)。第二个实例不抢 17311 端口,
  把 yuncang://open?code=… 转给已运行实例(在托盘里也会被弹出来并按 code 查询)后自己退出;
  还在登录界面时先把 URL 存起来,登录完成后再查。
- 生命周期调整:本机 HTTP 服务与托盘在 App 里创建(登录前就可用),主窗口只管展示与操作;
  日志改成全局 AppLog(窗口没开时的日志也会在窗口打开后补上)。
- 新增 AppSettings / SessionStore:%LOCALAPPDATA%\YuncangTrace\settings.json、session.json
  (服务器地址默认 http://127.0.0.1:7300;换服务器不会复用旧令牌)。
- 新增 ApiClient(登录 / 校验令牌)、MainWindow「退出登录」(清令牌回登录页)。
- 程序/托盘图标:Assets/app.ico + tools/make-icon.ps1(品牌蓝 + 白色播放三角)。
- csproj 关闭 ImplicitUsings:WPF 与 WinForms 同时开启时隐式命名空间会让
  MessageBox / Application / Clipboard 等产生歧义。

⚠️ 本机没有 .NET SDK,无法编译验证;已做 XAML/XML 良构与括号平衡检查。
2026-10-17 10:23:50 +08:00
liufumingren
680fff84df desktop:新增 WPF 本机软件(本机 HTTP 服务 + yuncang:// 启动协议)
给前端 `/local` 公共页与 Chrome 插件对接的本机软件(net8.0-windows + UseWPF):

- Services/LocalHttpServer.cs:HttpListener 监听 localhost:17311(同时注册 127.0.0.1 前缀)
  - GET /api/health      探活(2xx 即认为已启动)
  - GET /api/query/{code} 按运单号查信息,成功时字段平铺返回
  - CORS 全量响应头 + Access-Control-Allow-Private-Network(公网 https 页面访问 localhost 的
    PNA 预检),预检 OPTIONS 直接 204
  - 根路径给一个说明页,方便浏览器里手工排查
- Services/OrderQueryService.cs:★ 接真实数据源的位置(现为演示数据)
- Services/ProtocolHelper.cs:HKCU\Software\Classes\yuncang 注册/反注册、解析
  yuncang://open?code=xxx(免管理员)
- Services/SingleInstance.cs:互斥体 + 命名管道,被协议再次拉起时把参数转给已运行窗口,
  不会去抢 17311 端口
- MainWindow:运行状态、服务地址(复制/浏览器打开)、注册启动协议、测试查询、运行日志
- App.xaml.cs:单实例判断 + 协议参数处理;启动即自动起服务

README 里写了编译/发布命令、接口契约、协议注册(含 reg 命令与打包工具做法)、
接真实数据的示例,以及端口权限(netsh http add urlalloc)/端口占用等常见问题。

⚠️ 本机没装 .NET SDK,无法在这里编译验证;XAML/manifest/csproj 已做 XML 良构校验。
2026-10-17 10:13:09 +08:00