19 Commits

Author SHA1 Message Date
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
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
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
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
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
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
liufumingren
700394b56f 本机服务端口改 17300,/api/health 带登录状态,网页可唤起软件登录
- 端口 17311 → **17300**(桌面端常量、localhost/127.0.0.1 双前缀、前端 LOCAL_BASE、
  插件默认目标与说明、两个 README 全部同步)。
- `/api/health` 返回值加上 `loggedIn` / `user`(由 App 提供:IsLoggedInProvider、UserNameProvider),
  前端只认 `ok`(探活),再用 `loggedIn` 决定要不要唤起登录。
- 新增 `POST /api/activate-login`:叫本机软件把登录窗(已登录则主界面)带到前台。
  用 POST 而不是 GET,避免被浏览器/聊天工具的链接预取误触发;CORS Allow-Methods 加了 POST。
- `/api/query/{code}` 未登录时返回 401(前端会转去唤起登录)。
- 桌面端:App 记住登录窗引用,收到 LoginRequested 时切回 UI 线程激活它(托盘里也能叫出来)。
- 前端 `/local?code=`:
  - 路由加 alias `/local/`;
  - 新增 need-login 状态:探活到「软件在跑但没登录」→ 自动 POST activate-login →
    每秒探活等登录(30s 上限)→ 登录完成后自动查询;期间有「再叫一次登录窗口」按钮与托盘提示;
  - api/local.ts 增加 localHealth()(online/loggedIn/user)、requestLocalLogin()、waitForLoggedIn();
    waitForHealth() 改为返回状态而非 bool;老版本软件没有 loggedIn 字段时按已登录处理(向后兼容)。
- 实测(7301 + 模拟的 17300):打开 /local/?code=… → 「本机软件未登录 / 正在等待登录…」→
  mock 翻成已登录后自动切到查询结果(5 行);杀掉 mock 后显示「服务暂不可用」且探测地址为 17300。
2026-10-17 10:28:01 +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