53 Commits

Author SHA1 Message Date
liufumingren
ed063db9f4 桌面端补上「通道改名」:已添加的通道不用再删了重加
之前通道一旦添加就只能删掉再添加来改名,而删除会让服务器软删该通道、
解绑工作台,还容易把通道号换掉。

- 扫码通道页新增「重命名」按钮(选中一行才可用),弹 RenameChannelWindow:
  只改名字、通道号不动
- ScanService.RenameChannelAsync:名字落本机 channels.json 后用普通推送同步服务器
  (POST /api/scan/channels 按 channelId 更新 channelName,不走 replace 全量对账);
  名字没变就不推服务器
- 可选「同时把名称写入设备」(SYS.HostName,默认勾选,设备 IP 未知时禁用):
  与添加通道一致,写失败只提示、不回滚本机改名
- 服务模式下本机只写通道文件,后台服务发现文件变化会自己重载并重连
- 删除通道按钮同样改成「选中才可用」,避免点了没反应

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:39:28 +08:00
liufumingren
fd2ed16033 多路回放/预览改为以最长的那一路为准收尾
各路是从自己的关键帧起推的,同样 8 秒的请求,20fps 那路只有 8.0 秒、
25fps 那路有 9.0 秒。按请求窗口统一截断会把长的那段尾巴切掉,
不截断又会一直往后播。

- 预览窗口:按「队列空了 + 1.5 秒没再收到新帧」判定这一路播完,
  且必须播过窗口 80% 才认(中间网络卡一下不能当播完);
  先播完的定格最后一帧,等全部播完再释放设备会话;
  另有 Window + 15 秒硬上限,防止录像机一直推流
- 标题显示「回放结束(Xs)」,X 是最长那路的实际时长
- 合并下载:总时长取各段真实时长中最长的一段(读 ffmpeg 的 Duration:),
  短的那格在 overlay 里定格最后一帧

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:38 +08:00
liufumingren
41063761f7 主码流实时预览改走 UDP + 关掉流分析与重排缓冲
主码流走 RTSP over TCP 时,一旦设备发送缓冲/交换队列有排队,延迟只会越堆越高
且永远追不回来(TCP 不丢帧),现场表现就是「越看越慢」。

- Open() 默认低延迟:-rtsp_transport udp,外加
  -analyzeduration 0 -max_delay 0 -reorder_queue_size 0 -avioflags direct
  -fflags nobuffer -flags low_delay -fps_mode passthrough
- 4 秒还收不到帧就杀掉进程、改用 TCP 重开一次(部分网络禁 UDP,
  不能让用户因此看不到画面);重开只做一次,并用 RestartGate 串行化
- 复用键带 |ll 后缀,实时预览与回放(OpenUrl 默认 lowLatency=false)不会串流;
  回放仍走 TCP,因为回放靠时间戳对齐,丢包会算错延迟
- 补两行日志:ffmpeg 实际用的传输方式、首帧耗时(ms)
- README 补齐子码流/主码流两条链路的延迟差异与排查日志

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:29 +08:00
liufumingren
8c83275719 本机 HTTP/WS 改用自建 TcpListener,不再依赖 HTTP.sys
现场机器上 HTTP 服务被安全软件/系统优化禁用或卡在 STOP_PENDING 时,
HttpListener.Start() 抛「句柄无效(6)」,HTTP 17300 与 WS 17301 会同时起不来
(2026-10-23 升级 1.0.113 后的现场故障)。

- 新增 LoopbackHttpServer:TcpListener 直接监听 127.0.0.1 + ::1,自己解析 HTTP/1.1 请求,
  Host 不是回环地址的直接断开;不需要 urlacl / 管理员权限
- LocalHttpServer 改用它,请求处理不再直接摸 HttpListener 类型
- LocalWsServer 在同一层自己完成 WebSocket 握手(Sec-WebSocket-Accept),
  再交给 WebSocket.CreateFromStream;关闭时 CloseReceived 也回一帧 Close,
  避免浏览器报「未完成关闭握手」
- 启动失败的提示改成按 SocketError 判断(端口占用 / 无权限)
- 已回过响应后不再兜底写 500(否则一条连接上会出现两个响应头)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-23 21:30:25 +08:00
liufumingren
950b16a0dd 选路细节只进日志,界面只留结果
现场反馈「校验完成了还显示【选路】是什么意思」。那些行本来是给排障用的
(局域网设备管理服务 → 云端 → 本机直连 三级降级),操作员看只会困惑,
而且降级链一长,结果和过程就混在一起。

- [选路] / [时钟] 全部改写日志([route] / [playback])
- 界面只保留:正在校验第 N 路、[有录像]/[无录像]/[失败]、校验完成总结

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:34:28 +08:00
liufumingren
7b4705c73c 走设备管理服务时本机不再登录录像机
校验循环里在判断 peer 之前就调了 _playback.ClockOffset(),而它内部会
初始化 HCNetSDK 并登录 NVR —— 于是「走设备管理服务」之后本机又登了一次,
既出现「明明检查过又检查一遍」的观感,也正好抵消了共用会话池的意义
(海康并发登录通常只有 6~16)。

- 时钟对齐挪进 peer is null 的本机分支
- 走边端时结果行标注「(设备管理服务)」,本机不碰录像机

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:32:48 +08:00
liufumingren
85db722384 修复:A→B 的 POST 全部无效(JsonContent 不带 Content-Length)
边端是手写的 HTTP 读取,只认 Content-Length;而 A 侧一直用
JsonContent.Create(),它产生的是 chunked 请求 —— 边端把 body 读成空,
/check 直接 400,界面就显示「设备管理服务无响应,改由本机校验」。
也就是说局域网共用取流池这条路,用真实客户端从来没成功过,
此前只有 curl 验证过所以一直没暴露。

- EdgeClient 改用 StringContent(显式 Content-Length)
- 边端遇到 chunked 请求时明确记一行,不再让调用方看到「空 body」的怪错误

实测:JsonContent → 400 contentLength=null;StringContent → 200 contentLength=186

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:28:58 +08:00
liufumingren
63b70c6ad5 补上边端取流的请求级日志,并让 A 侧连接失败自动重试一次
现场表现:查询提示「设备管理服务无响应,改由本机校验」,但边端和 A 侧
都没留下任何痕迹 —— /check 这条路径原来只在异常时记一行,成功完全静默,
A 侧拿到非 2xx 也只返回 null。

- 边端 /check 每次记一行(通道、时间窗、hasRecord、帧数、来源、耗时)
- 主体不符被拒时记录路径、原因和本体主体
- A 侧 EdgeClient:非 2xx 记录状态码+响应体;传输层异常(worker 重启后
  连接池里的死连接)自动重试一次,取成片同理

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:24:41 +08:00
liufumingren
f38bf082f1 修掉「本机明明有设备管理服务却走云端」
现场表现:更新/重启后头几十秒里本机查询都提示「改问云端」。原因是
hik-worker 的懒启动被安排在 20 秒后,而 UDP 17310 应答由 worker 提供;
A 探测不到就只能走云端,偏偏是云任务反过来才把 worker 拉起来,形成死循环。

- worker 自检从启动后 20 秒提前到 3 秒(实测 UDP/TCP 约 5 秒内就绪)
- 局域网应答的 UDP 绑定加 30 次重试(约 60 秒),上一条日志里它在重启后
  没绑上且没有任何痕迹;现在失败会记「第 N 次重试」和最终放弃
- AppLog 改为独占写 + 失败落本进程旁路文件 log_<日期>.p<pid>.txt,
  避免并发写把行写截断(FileShare.ReadWrite 会撕裂行)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:19:09 +08:00
liufumingren
49681b7bdd 加固日志:写入不再静默丢失 + 心跳每 5 分钟落一行
上次现场排查发现 16:28-22:47 六小时日志全丢,但同一时间上报和
scan-records.json 都正常 —— 原因是 File.AppendAllText 按 FileShare.Read
打开,日志文件被别的程序占着时每次都抛 IOException,又被 catch{} 吞掉。

- AppLog 改用 FileShare.ReadWrite|Delete 打开并重试一次,仍失败则累加丢弃计数
- agent-status.json 暴露 LogDropped / LogLastDroppedAt,现场能看出日志是否完整
- 心跳日志改为每 5 分钟一行(含在线通道数、待上传条数),持续失败也每 5 分钟补一行
- 通道断开日志沿用原有节流(前 3 次 + 每 10 次),配合心跳行可定位断点

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 03:12:14 +08:00
liufumingren
fbcbd80acc 修复两个会导致软件无法使用的启动/校验缺陷
1) 提权重启无限循环:内置 Administrator 没有 UAC 分离令牌,自愈重启后
   仍是提权,于是每秒自我重启一次,窗口永远出不来。加 30 秒时间戳防抖,
   第二次直接留在提权状态运行并记录原因。
2) 自动校验静默卡死:ValidatePlaybackAsync 内部 await ConfigureAwait(false)
   之后仍直接写 WPF 控件,抛出的异常又被 fire-and-forget 吞掉,界面停在
   「正在校验 N 路回放…」。UI 更新统一切回 Dispatcher,并给入口加 try/catch
   把异常写进日志、显示到界面上。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 02:39:22 +08:00
liufumingren
c280e94b9a 加固局域网询问应答:主体 + 后端身份双校验
主体 id 在各环境的库里都从 1 开始,光比 subjectId 挡不住跨环境串台
(开发库和生产库的测试仓库都是 1),旧机器只要 agent.json 还在就会一直应答。

- 询问必须带 subjectId>0 和 server,缺任一项不应答
- 应答回带 server,A 侧也校验一致;不一致直接丢弃
- 多台应答按 (SN, 主机) 去重,并优先本机地址
- 版本号提到 1.0.105

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 01:27:49 +08:00
liufumingren
9075a1f4f3 desktop: 选路结果落日志 + 云端校验结果带帧数
- ValidatePlaybackAsync 记录最终选路结论(云端/本机、有没有录像、给了哪些按钮),
  现场排障不用再靠猜;跨网时也能直接从日志看出走没走云端。
- EdgeCheckOutcome 增加 Frames,与本地校验的展示保持一致。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 01:00:08 +08:00
liufumingren
9d3ad422de desktop: 边端监听地址可配置(YUNCANG_EDGE_BIND)
默认 0.0.0.0(局域网可发现、可直连);设成 127.0.0.1 时只给本机用,
不把取流端口暴露到局域网 —— 既方便同机多实例测试,
也适用于"这台机器只服务自己、不让同网段其它查询机发现"的部署。

配合已有的 YUNCANG_EDGE_UDP_PORT / YUNCANG_EDGE_HTTP_PORT 使用。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:50:48 +08:00
liufumingren
993c7acd30 跨公司下载:云端中转成片(分片上传 + Range 下载)
A(查询机)和 B(仓库)不同网络、B 无公网 IP。B 出站领任务后把成片传回云端中转,
A 再从云端取回本地 —— 全程不需要任何一方有公网入口。

云端
- POST /api/web/edge/download      建任务(按主体选在线设备 → 下发 download)
- GET  /api/web/edge/download/:id  查进度(queued/uploading/done/failed)
- GET  /api/web/edge/download/:id/file  取成片,支持 Range(浏览器播放要拖动进度条)
- POST /api/scanner/tasks/:id/upload  设备分片上传(原始字节流,不是 base64)
- bodyParser 对该上传路由禁用:否则原始请求体会被解析掉
- 成片落 run/edge-files(run/ 属部署保留目录,不会被发布覆盖)
- 每次建任务顺手清理过期文件;元数据按主体校验,越权一律 404

桌面端
- AgentHost 新增 download 任务执行:worker 拉流合并 → 分片上传 → 传完删本地临时文件
- 失败时把 uploadTaskId 带回云端,立刻落 failed,查询机不用干等到超时
- ApiClient 新增建任务 / 查状态 / 取文件 / 分片上传
- PlaybackDownloadService 改为三级选路:
  LAN 设备管理服务 → 云端中转 → 本机直连

实测(真实 NVR)
  建任务 → 设备拉流 1.9MB → 上传 → 下载:7.5 秒,字节数一致,ftypisom
  Range: bytes=0-99 → HTTP 206 + Content-Range 正确

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:30:09 +08:00
liufumingren
290f29e547 跨公司取流:云端边缘任务通道 + 三级降级
场景:查询机 A 和打包仓库 B 在不同网络,B 没有公网 IP。
B 只能主动出站,所以云端从不反向连它 —— 复用设备出站链路做任务通道。

云端(backend)
- 新增 edge_task 服务:Redis List 做队列、短 TTL 存结果,
  多实例共享,不依赖 sticky session
- POST /api/scanner/tasks/poll:设备长轮询领任务(挂 20 秒,
  有任务立刻返回,没任务 204)
- POST /api/scanner/tasks/:id/result:设备回结果
- POST /api/web/edge/check:查询机问「这段有没有录像」,
  云端按主体选出在线扫码服务 → 下发 check → 等结果(默认 8 秒)
- 不阻塞共享 Redis 连接:任务用短间隔轮询而非 BLPOP
  (egg-redis 是共享连接,阻塞命令会卡住其它请求)

桌面端(desktop)
- AgentHost 新增边缘任务循环:长轮询领任务 → 交 worker 执行 → 回结果,
  与扫码链路完全解耦,异常只退避重试
- worker 新增 check 能力(复用 HikPlaybackService.CheckAsync)
- ApiClient 长轮询单独用不限时客户端(共享 HttpClient 的 15 秒超时会掐断)

三级降级(桌面端校验)
1. 局域网有设备管理服务 → 交给它(共用 NVR 会话池)
2. 没有 → 问云端;云端确认有录像时**隐藏预览、只显示下载**
   (跨网拉流成本高,短片段/下载更合适)
3. 云端也判断不了 → 本机自己校验(仓库内操作员的常规路径)

实测(真实 NVR 192.168.8.241 通道 34)
  设备心跳 → 领任务 → worker 校验 → 回结果 → 网页拿到结论
  端到端 2.17 秒(其中 NVR 拉流约 2 秒)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-22 00:26:27 +08:00
liufumingren
6f8095913b desktop: 选路改为「有设备管理服务就统一走它」
之前的判定是「本机连不上 NVR 才走 B」,导致同 LAN 多台机器各连各的,
录像机并发登录数照样被打满,设备管理服务的会话池闲置。

选路(StreamGateway)
- 新增 StreamGateway:广播询问(带 NVR 地址)→ 有应答就用它,
  没有才本机直连;结果缓存 15 秒(含"没找到"的负结果)
- 转发失败时 Invalidate,下次重新探测
- 广播询问带 nvrHosts:对端实测连不上该 NVR 就不应答

校验走设备管理服务
- B 侧新增 POST /check,复用 HikPlaybackService.CheckAsync
  (真拉一小段,语义与桌面端本地校验一致)
- 桌面端校验改为优先交给设备管理服务;服务无响应则降级本机并重新探测
- 并发上限 4,避免多台查询机同时校验把 NVR 打满

下载走设备管理服务
- PlaybackDownloadService 去掉 CanReachNvrAsync 判定,改用 StreamGateway
- 服务端(hik-worker)自身不装网关,永远本地执行

其他
- 边端端口支持 YUNCANG_EDGE_UDP_PORT / YUNCANG_EDGE_HTTP_PORT 覆盖
  (同机并行跑两个实例测试时用,与 YUNCANG_LOCAL_WS_PORT 同思路)
- SDK 校验路径不数帧(返回 -1),界面只在有帧数时显示"试拉 N 帧"
- 顺带修复:下载临时文件名未对 CameraName 做 Sanitize,
  摄像头名含 ? : * 等字符时会整段下载失败

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 23:51:54 +08:00
liufumingren
46e4f12802 desktop: 取流子进程隔离 + 局域网询问应答 + 跨网下载
把海康取流从扫码服务主进程拆到 --hik-worker 子进程,原生 SDK 崩溃
不再连带扫码收码;新增局域网询问-应答与跨网下载通道。

隔离与守护
- 新增 HikWorker(子进程):独占 HCNetSDK 与 NVR 会话池
- 新增 HikWorkerSupervisor(主进程):懒启动、管道通信、
  5 分钟内失败 3 次熔断 10 分钟
- 管道协议为 [4 字节长度][JSON],进程退出即知,不占端口
- ServiceInstaller 复制 native(HCNetSDK/ffmpeg),先删后拷,
  避免 SDK 升级残留旧 DLL;安装时放行 TCP 17311 / UDP 17310

局域网询问-应答(不是主动公告)
- UDP 17310 收询问,只回同 subjectId;带了 nvrHosts 时先实测可达,
  连不上就不应答,让查询机继续走本机
- 应答带 TCP 17311,查询机一次连接即可判定是否同 LAN

跨网下载
- TCP 17311 提供 /health、/probe、/download、/download/{id}
- 除 /health 外均要求 X-Edge-Subject 且与配置主体一致
- 成片在传输完成后立即删除,另有 done 10 分钟 / failed 15 分钟
  TTL 兜底,避免现场磁盘被临时文件吃满

桌面端选路
- DownloadAsync 先探 NVR 8000(600ms):通则沿用原有本机直连,
  不通才广播找取流服务,取回后落到本机录像目录
- DownloadByPlanAsync 拆分:不查库、不需要用户令牌,
  供只有设备令牌的服务端复用

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 22:48:09 +08:00
liufumingren
000a45d6cb 拉取通道补回通道名(走 8000 私有协议,不依赖 ISAPI)
- 新增 NET_DVR_GET_PICCFG_V30(1002):结构体头部 DWORD dwSize + char sChanName[32] 即通道名,GBK 编码;
  实测 DS-7932N-R4 32 路约 250ms,中文(团购复核区1 / 单号:xxx)正常
- 只查 enabled 通道(空槽位回 err=4 直接跳过),失败只写日志,不影响其他字段
- ISAPI 降级为兜底:PICCFG 一个名字都拿不到时才读 ContentMgmt/InputProxy/channels
  (先 500ms TCP 探测,依次试 80/443/8443,按 IP 匹配、再按 id 推)
- 新增 HikSdk.DecodeGbk:注册 CodePagesEncodingProvider 后按 GBK(936) 解码,注册失败退回 ASCII
- 桌面端 README 更新通道名来源说明

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 14:21:32 +08:00
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
e5a6558eb5 feat(desktop): NTP 校时同时同步摄像头(IPC)时钟
录像机与摄像头各有一块钟:只写录像机的话,画面里烧的 OSD 时间还是旧的
(现场有摄像头比录像机快 13 小时)。校完录像机后逐个通道 SET_TIMECFG,
单通道失败不影响其它通道,结果汇总到该录像机的进度行。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 00:47:37 +08:00
liufumingren
7b11f7052d feat(subject): 主体到期暂停设备上报,新增续期订单与支付回调
- 主体状态缓存(Redis 优先、进程内兜底):设备心跳与上报判断不再查库,续期/停用后主动失效
- 上报写接口按缓存校验期限:过期 403 subject_expired、停用 subject_disabled、主体缺失 subject_missing
- 心跳与 /api/scanner/me 返回 subject 状态,桌面端据此暂停推送并在续期后自动补传积压
- 新增续期订单(subject_orders)与接口,支付回调 POST /api/pay/notify 幂等、支持 HMAC 签名,
  另提供内部令牌模拟支付用于联调
- 顺带提交工作区中已完成的「登录协议」后端改动(agreement):与本次改动共用 router.js / config.default.js

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-20 18:55:57 +08:00
liufumingren
c68ec63e91 桌面端:托盘退出加确认 + 后台服务 .NET 环境兜底(1.0.75)
- 托盘「退出」改为 ConfirmExitFromTray:弹「退出确认」,默认按钮为取消;
  文案按状态区分(服务模式提示后台 Windows 服务仍会继续扫码,普通模式提示扫码与查询都会停)。
  登录取消等内部路径仍直接退出,不弹框
- ServiceInstaller:
  - StartCore 启动前调用 EnsureServiceDotnetEnvironment(框架依赖版服务写 DOTNET_ROOT,
    自包含版自动清理),避免 LocalSystem 找不到用户目录里的 .NET 8 而表现为「后台服务启动超时」
  - 用 RuntimeEnvironment.GetRuntimeDirectory() 取运行时目录,消除单文件发布下的 IL3000 警告
    (typeof(object).Assembly.Location 在单文件里恒为空)
2026-10-20 00:55:59 +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
2122c7517b feat(desktop): 支持以 Windows 服务常驻,安装包内置 native 运行库 2026-10-19 22:04:19 +08:00
liufumingren
0b0296cece feat(desktop): NTP 校时与提权校时助手 2026-10-19 22:04:19 +08:00
liufumingren
cb504608a1 feat(desktop): 海康 NVR/摄像机预览、录像回放下载与内置 HCNetSDK 2026-10-19 22:04:16 +08:00
liufumingren
cb511f33ae feat(desktop): 本地 HTTP 服务与扫码通道、扫码记录界面 2026-10-19 22:04:12 +08:00
liufumingren
c3cae69e6e feat(desktop): 主体切换与登录、主界面及日志留存改造 2026-10-19 22:04:10 +08:00
liufumingren
2573404981 chore: 忽略内置 ffmpeg 可执行文件并更新各端 README 2026-10-19 22:03:59 +08:00
liufumingren
79f89ec392 feat(desktop): 「重启软件」移到工具菜单
- 工具:测试查询 / 打开日志目录 / 清理日志 / 清理更新缓存 / 重启软件
- 服务:只剩只读的「服务状态:运行中|未启动」
2026-10-17 18:28:00 +08:00
liufumingren
62ab25e6fe feat(desktop): 主界面/托盘不再显示服务地址与运行状态
- 主界面移除整行「● 本机服务 运行中 · http://…」,顶部只留「已登录:xxx / 退出登录」
- UpdateServerState 只刷新菜单「服务 → 服务状态」,不再碰界面控件
- 托盘菜单的状态项改成固定的「本机服务」(原来是「服务:<地址>」),
  UpdateStatus 只传「运行中 / 未启动」;TrayIconService 构造不再需要 serverUrl
- 运行状态统一在菜单里看,界面不再重复展示内部实现细节
2026-10-17 18:23:55 +08:00
liufumingren
e7ff6ed784 fix(desktop): 菜单贴紧标题栏,去掉顶部空隙
- 外层 Grid 不再加 18 边距:行 0 = Menu(Padding 10,3,0,3,紧贴标题栏),
  行 1 = 内容区(Margin 18,10,18,18),标题/查询卡改到内容区 Grid 的 row 0/1
- 原来的 Margin="-6,0,0,8" + Grid 18 边距会让菜单离标题栏多出 18px
2026-10-17 18:16:03 +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
457fbd6c9e 新增 test-update.ps1:一条命令验证「启动旧版 → 自动更新」(不卸载重装)
用法:
    cd desktop\installer
    .\build.ps1 -Environment Development -Version 1.0.7   # 发布更高版本
    .\test-update.ps1                                     # 启动旧版,等它自己升级

脚本流程:
1. 从后端 /download/version.json 读目标版本,和当前安装版本比较(已是最新直接退出);
2. 关掉运行中的软件(单文件自解压出来的真实进程);
3. 设 YUNCANG_AUTO_UPDATE=1 启动**旧版本**(更新窗口自动开始下载);
4. 每 3s 轮询安装目录 ProductVersion,直到等于目标版本或超时;
5. 检查本机服务 17300 响应与进程是否恢复,输出 ✔/✘ 与耗时。

实测(本次):
    当前安装版本:1.0.6
    后端目标版本:1.0.7
    [3s] 1.0.6 → [10.4s] 1.0.7
    ✔ 自动更新完成:1.0.6 → 1.0.7(耗时 10.4s)
    ✔ 本机服务 17300 有响应(HTTP 401)
    ✔ 软件进程已恢复(PID 12024)
    随后日志显示「已恢复登录:管理员」。

README:新增「验证自动更新(不卸载重装)」小节(命令、脚本行为、输出示例、
每次需打更高版本的提醒)。
2026-10-17 12:47:49 +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
21e8c6a5ec 更新改为软件内下载(进度条)+ 下载完成自动安装;修复 version.json 与包版本不一致导致的无限提示
一、需求:更新不要跳浏览器
- 新增 UpdateWindow(弹窗):显示新版本 / 当前版本 / 包大小 / 更新说明;
- 点「立即更新」→ 软件内流式下载(ProgressBar + 百分比 + 已下载/总大小)→ MD5 校验
  → 启动安装(等 3 秒让本进程退出,再 msiexec /passive)→ 装完自动重新打开;
- 下载目录 %TEMP%\YuncangTraceUpdate\,文件名取 downloadUrl 里的真实文件名
  (原来用 version.json 的 version 命名,配错时会误导)。

二、修复「更新不了一直提示 1.0.2」
- 原因:测试数据里 version.json 写 1.0.3,但 downloadUrl 指向 1.0.2 的包;
  装完仍是 1.0.2 → 下次启动又提示,永远循环。
- 修复(防御):解析 downloadUrl 里的包版本(YuncangTraceSetup-x.y.z.msi),
  若包版本 <= 当前版本则直接忽略更新 —— 以后 version.json 配错/漏传包也不会无限弹窗。
- 同时把环境打成一致:真实打包 1.0.3(version.json 与包都是 1.0.3)并安装。

三、build.ps1
- 自动设置 DOTNET_ROOT(wix 是 dotnet 全局工具,apphost 不认 PATH,只认 DOTNET_ROOT):
  之前在无该环境变量的终端里打包会报「You must install .NET to run this application」。

四、验证
- 安装 1.0.3 + version.json 1.0.3 → 启动无更新窗口、日志无「发现新版本」✅
- 伪造 version.json=1.0.4 但包仍是 1.0.3 → 启动**不弹窗**(防御生效)✅
- 恢复 version.json 为 1.0.3。
- 更新窗口 UI 已通过截图确认(新版本/当前版本/包大小/说明/稍后/立即更新)。
- 新增 YUNCANG_AUTO_UPDATE=1 测试开关:弹窗后自动开始下载,便于无 UI 自动化环境回归。

五、README
- 「自动更新怎么工作」改为软件内下载+自动安装,补充下载位置、安装时机、版本一致性防护与测试开关。
2026-10-17 12:27:05 +08:00
liufumingren
81a5a8888d 打包:开发/生产环境配置 + 版本号 + 自动更新(version.json)+ 保留5个包
一、打包配置(desktop/installer/package.config.json)
- 两个环境各自的域名:Development = http://127.0.0.1:7300,Production = 占位正式域名(发布前替换)。
- keepVersions = 5。
- build.ps1 -Environment Production 自动用生产域名打 exe 与下载地址;-ServerBaseUrl 可临时覆盖。

二、build.ps1
- 新增 -Environment / -Version / -Keep / -ReleaseNotes;版本默认取 csproj,可覆盖,
  通过 -p:Version 注入程序集(AssemblyVersion/FileVersion 一起变)。
- 打完后:算 MD5、写 version.json(version/downloadUrl/md5/size/publishedAt/buildId/environment/releaseNotes),
  复制 MSI → backend/app/public/download/,version.json → backend/app/public/version/。
- 本地 out/ 与后端目录各只保留最近 5 个安装包(按版本号排序清理)。
- 补丁版保护:后端已有更高版本时,不覆盖 version.json(避免补打旧版把版本降回去)。

三、后端静态分发 + 缓存(关键)
- Egg 的 static 生产默认强缓存一年,version.json 若走静态会**永远检测不到更新**。
  且实测 koa-static 命中文件后**不再 next()**,后置中间件改不了它的响应头(先写了 middleware 验证不可行,已删)。
  → version.json 放到 app/public/version/(不在静态目录),由路由 GET /download/version.json 提供:
    Cache-Control: no-store, no-cache, must-revalidate, max-age=0 + Pragma/Expires,且不产生 ETag/Last-Modified。
- MSI 仍走 egg-static(prefix /download/,maxAge 31536000),文件名带版本号可长缓存。
- middleware/frontend.js 放行 /download/*,否则会被 SPA 入口接管。
- 实测响应头:version.json 无 ETag/Last-Modified、cache-control: no-store…;
  MSI cache-control: public, max-age=31536000。

四、桌面端自动更新(Services/UpdateChecker.cs + App)
- 启动登录后后台请求 {后端}/download/version.json?t=毫秒时间戳(带 no-cache 头),
  比较程序集版本;有新版则弹窗(版本/说明/大小),点是 → 浏览器打开 downloadUrl。
- 失败静默(网络问题不打扰);日志记录发现新版本/已打开下载。
- 实测:安装 1.0.1 → version.json 1.0.1 不提示;改成 1.0.2 后重启 →
  日志「发现新版本 1.0.2(当前 1.0.1.0)→ 已打开下载」。

五、.gitignore
- 忽略后端分发产物:backend/app/public/{download,version}/* 但保留 .gitkeep。

⚠️ backend/config/config.default.js 本次提交同时带入了该文件里已有的未提交改动
   (后端默认端口 7001 → 7300 及注释),因为 static 配置必须写在同一个文件里;
   其它 backend/extension/frontend 的未提交 WIP 未包含在本次提交中。
2026-10-17 12:07:13 +08:00
liufumingren
77b5713d02 新增 MSI 安装包:安装即注册 yuncang:// 协议,卸载自动取消注册
需求:打包安装包;协议在**安装时**注册(不依赖先启动软件一次);卸载能清掉注册。

实现(desktop/installer/):
- Product.wxs(WiX 5):
  - Scope=perUser(免管理员、无 UAC),安装到 %LOCALAPPDATA%\Programs\YuncangTrace;
  - Component 里写 HKCU\Software\Classes\yuncang(默认值 / URL Protocol / shell\open\command),
    注册表项属于 MSI 组件 → **卸载时自动删除**,即「取消注册」;
  - 开始菜单快捷方式(RemoveFolder On=uninstall);
  - MajorUpgrade(升级替换、拒绝降级);用户数据 settings/session.json 不在安装目录,卸载保留。
  - 版本号用 $(var.Version) 由构建命令注入,避免和 csproj 两处维护。
- build.ps1:读取 csproj 的 <Version> → dotnet publish(自包含单文件)→ wix build
  → out\YuncangTraceSetup-<版本>.msi。
  ⚠️ 脚本保存为 UTF-8 with BOM:PowerShell 5.1 读无 BOM 脚本会按 GBK 解析,中文注释会让语法报错。
- 工具链:`dotnet tool install --global wix --version 5.0.2`
  (WiX v7 会要求接受 OSMF 付费维护费协议,改用 v5)。

实测(perUser 静默安装 → 协议 → 唤起 → 卸载):
- 安装:文件落到 %LOCALAPPDATA%\Programs\YuncangTrace,HKCU 协议立即指向安装目录
  (安装前指向 desktop\publish,安装后被正确覆盖),开始菜单快捷方式已创建;
- **不启动软件**,直接 Start-Process "yuncang://open?code=INSTALLTEST":
  进程路径 = 安装目录 exe,日志显示 "已恢复登录:管理员 → 收到启动协议 → 查询:INSTALLTEST";
- 卸载:安装目录删除、HKCU 协议删除、开始菜单删除,均无残留;
- build.ps1 完整跑通,产物 54.1 MB(cab 压缩)。

.gitignore:忽略 desktop/installer/out/ 与 *.wixpdb。
desktop/README.md:新增「打安装包(MSI)」章节(构建命令、安装范围、协议注册/卸载行为、
perMachine 改法、BOM 提醒)。
2026-10-17 11:49:26 +08:00
liufumingren
65a4fd86f1 插件兜底判定改用「探测本机服务」,消除软件已在跑时的误报
现象:点「查看打包视频」后,软件其实已经被唤起/本来就在跑,却弹出
「没打开本机软件?可能还没安装…」。

原因:原判定只看「4 秒内页面有没有失焦」。但
1. 软件已经在跑时,协议只是把参数转给已有实例,主窗口不一定抢焦点;
2. 冷启动(单文件自解压 + 恢复登录)可能超过 4 秒;
两种情况页面都还聚焦 → 被误判为失败。

修复:
- manifest 增加 host_permissions(http://localhost:17300/*、http://127.0.0.1:17300/*),
  让 background 能探测本机服务(不受页面 CSP 影响)。
- background 新增 pst:probe:fetch GET /api/query/,**任何 HTTP 响应(200/400/401)都算在线**;
  服务端本来就回显 Origin,chrome-extension:// 来源也已验证可通(实测回
  Access-Control-Allow-Origin: chrome-extension://…)。
- content.js launchProtocol 改为:
  - 触发协议后每 0.7s 探测一次,最长 8 秒(给冷启动足够时间);
  - 探测到服务 → 判定成功,什么都不做(软件已在跑时第一次探测就成功,不再误报);
  - 8 秒都探测不到 → 才弹兜底卡片(在网页中查看 / 下载安装 / 关闭);
  - 页面失焦仍保留为「快速判定成功」的辅助信号。
- options 页与 desktop/README 的兜底说明同步(4 秒 → 约 8 秒 / 探测本机服务)。

验证:manifest JSON 合法(v3 + 两个 host 权限);content.js / background.js node --check 通过;
带 chrome-extension:// 来源请求本机接口能拿到 Access-Control-Allow-Origin 回显。
2026-10-17 11:28:35 +08:00
liufumingren
cae0440fa1 插件「打开方式」新增协议唤起(openMode=app),协议模板与网页模板分离
- 原来「协议唤起」是靠把 URL 模板写成 yuncang:// 来隐式表达的,用户在界面上看不到、
  也不好在「唤起软件」和「开网页」之间切。
- 现在「点击后打开方式」有三个值:app(直接唤起本机软件,默认)/ window(独立小窗)/ tab(新标签页)。
  - openMode=app 时用新增的 appUrlTemplate(默认 yuncang://open?code={code}),规则级的网页模板不参与;
  - openMode=window/tab 时仍用 urlTemplate(默认 http://localhost:7301/local?code={code})。
- 配置版本 3 → 4:v3 曾把协议模板当作 urlTemplate 的默认值,升级时把网页模板还原、
  并设置 openMode=app,行为保持不变;用户自定义过的模板不动。
- 兜底不变:4 秒内页面没失焦 → 右下角「在网页中查看」(fallbackUrl)+「下载安装」(downloadUrl)。

验证(options 页跑 PSTRules):
- 默认 { openMode: app, urlTemplate: http://localhost:7301/local?code={code},
  appUrlTemplate: yuncang://open?code={code} };
- v3 配置 { version:3, urlTemplate:'yuncang://open?code={code}', openMode:'window' }
  升级后 → { openMode: app, urlTemplate: http://localhost:7301/local?code={code} };
- 自定义网页模板 + openMode=tab 保持不变;window 模式仍可正常保存。
- 插件脚本 node --check 全通过。

桌面端 README:更新「和前端 / 插件怎么配合」与「插件直接唤起与兜底」两节,
说明打开方式、两种模板与配置迁移。
2026-10-17 11:22:04 +08:00
liufumingren
c12ea3b197 移除探活接口:状态合进 /api/query;插件支持直接协议唤起 + 失败兜底
一、本机服务(桌面端)
- 删除 GET /api/health(说明页同步)。
- GET /api/query/{code} 合并状态,一次请求就能决定「展示结果」还是「提示唤起」:
  200 { ok, state:"ok", code, loggedIn, user, env, server, data }
  401 { ok:false, state:"need-login", ... } / 400 "bad-request" / 404 "not-found" / 500 "error"
  不论成败都带 loggedIn/user/env/server;只有网络层失败才代表「软件没启动」。
  原因:探活通过 ≠ 查询时软件还在(用户可能中途退出),两次请求之间状态会错位。

二、前端 /local
- api/local.ts:删 localHealth / checkLocalHealth / waitForHealth / waitForLoggedIn;
  新增 queryLocal()(非 2xx 但带 state 的 JSON 也正常返回)与 waitForQuery()(轮询同一接口)。
  request() 改为先读 body,这样 401 能拿到 state 而不只是状态码。
- LocalServiceView.vue:状态机改为单接口驱动
  连不上 → offline(下载/启动提示);need-login → 自动 activate-login + 轮询 query 等登录;
  ok → 展示;其它 → 展示错误。
  「重新查询」也走同一逻辑:用户中途退掉软件时点重查会**直接落到「服务暂不可用 + 可唤起」提示**,
  不再是一个莫名其妙的失败。
- 空 code 也发一次请求(服务端回 400 bad-request + 登录状态),所以没有 code 时同样能驱动页面状态。

三、Chrome 插件(extension/,工作区改动,暂未提交 —— 与另一会话的 WIP 混在同几个文件里)
- 默认目标模板改为 yuncang://open?code={code}:点击「查看打包视频」**直接唤起本机软件并带参**,
  不再先开网页;旧的 http 默认模板在配置升级(v2→v3)时自动换成协议模板,用户自定义的不动。
- content.js:按协议分流(http(s) → background 开标签页;其它 → 本页用户手势内用隐藏 iframe 触发)。
- 唤不起的兜底(浏览器不会告诉网页协议是否成功,必须超时猜):
  4 秒内页面没失焦 → 右下角卡片「没打开本机软件?」+「在网页中查看」(fallbackUrl)+「下载安装」
  (downloadUrl)+ 关闭。
- 新增配置:fallbackUrl(默认 http://localhost:7301/local?code={code})、downloadUrl(留空不显示下载按钮);
  options 页与使用说明同步。

四、验证
- /api/health → 404;/api/query/ABC123 → 200 state:ok + data;
  /api/query/ → 400 state:bad-request + loggedIn/user/env/server。
- 浏览器 /local?code=ABC123:正常展示;**杀掉软件后点「重新查询」→ 立即显示
  「服务暂不可用 / 本地打印服务未启动,请下载安装后再试」+ 下载按钮 + 已安装启动按钮**。
- 插件脚本 node --check 全通过;PSTRules.buildUrl 输出 yuncang://open?code=YT1234567890,
  v2 旧配置升级后模板自动变为协议、fallbackUrl/downloadUrl 就位。
- 前端 vue-tsc + vite build 通过;桌面端 0 警告 0 错误。

五、文档
- desktop/README.md:接口表改为两个接口 + 状态码/state 对照表 + 响应示例;
  「和前端/插件怎么配合」改为插件直接唤起;新增「插件直接唤起与唤不起时的提示」一节。
2026-10-17 11:10:34 +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
fb896272f4 桌面端接入 .NET 8 SDK 并首编译通过;服务地址改为构建期环境配置(开发/生产)
一、工具链
- 本机没有 .NET,微软域名又被网络阻断,改用 curl 从 builds.dotnet.microsoft.com 拉
  dotnet-sdk-8.0.426-win-x64.zip,解压到 %LOCALAPPDATA%\Microsoft\dotnet(免管理员),
  并写入用户 PATH / DOTNET_ROOT / DOTNET_CLI_TELEMETRY_OPTOUT。

二、首次编译暴露的两个真实缺陷(都已修复)
- ProtocolHelper.cs 缺 using System.Collections.Generic(ImplicitUsings=disable 后
  IEnumerable<string> 找不到)。
- App.xaml 少了 BgBrush,LoginWindow/MainWindow 用 StaticResource 引用它 → 编译期查不出,
  运行期一弹登录窗就 XamlParseException 直接退出(事件日志里能看到)。
  已补 BgBrush=#F5F7FA 并注明「缺一个就会运行时炸」。
- 顺带把 WFAC010(WinForms 建议 DPI 改走 ApplicationHighDpiMode)压掉并写明原因:
  本程序宿主是 WPF,走不到 WinForms 的 ApplicationConfiguration,DPI 只能由 manifest 决定。

三、服务地址 = 构建期环境(对齐前端 VITE_BACKEND 的思路)
- csproj:Debug → AppEnvironment=Development、ServerBaseUrl=http://127.0.0.1:7300;
  Release → Production、占位 https://packs.example.com;用 -p:ServerBaseUrl= 覆盖;
  两者通过 AssemblyMetadataAttribute 写进程序集,exe 自带「我是哪个环境」。
- 新增 Services/BuildInfo.cs 读元数据(带兜底,绝不抛)。
- AppSettings:默认值改为 BuildInfo.DefaultServer;等于内置默认值时不落盘(换构建能自动跟随),
  老版本已把默认值写进 settings.json 的也识别为"没改过";新增 UseServer() 支持运行时临时覆盖。
- App:解析 --server=xxx / -s xxx,其次 YUNCANG_SERVER 环境变量,写在构建默认值之前。
- 登录窗:「服务器地址」改叫「服务地址」,右侧显示"开发环境/生产环境"(只展示,由构建决定),
  输入框 ToolTip 说明留空即用当前环境默认地址。
- /api/health 增加 env(Development/Production)与 server(当前后端地址),排障一眼看出装错没有。

四、验证
- Debug / Release / Release+域名覆盖 三种构建均 0 警告 0 错误;
- Debug:health 返回 env=Development、server=http://127.0.0.1:7300;
- Release:env=Production、server=https://packs.example.com;
  Release 加 -p:ServerBaseUrl=https://trace.yuncang.cn 后 server 随之变化;
- 带 --server=http://10.0.0.9:7300 启动:server 被覆盖,settings.json 未被污染;
- health / 未登录 query(401) / activate-login(200,登录窗弹出) / OPTIONS 预检(204+CORS) 全部正常。
- 注意:改 -p: 属性必须 -t:Rebuild,否则 MSBuild 不会重新生成 AssemblyInfo。

五、README
- 新增「环境配置(开发 / 生产)」:构建矩阵、发布时覆盖域名、优先级、默认值不落盘的原因、
  settings.json/session.json 的行为;补了本机 SDK 装在用户目录、需要 DOTNET_ROOT 的说明;
  行为表新增「网页请求唤起登录」一行;health 返回字段更新。
2026-10-17 10:48:11 +08:00