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 |
|
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 |
|
liufumingren
|
9be56db385
|
前端:/local 页支持「叫醒」已安装的本机软件(自定义协议 + 轮询探活)
网页没法直接执行 exe,只能走「自定义 URL Scheme」(百度云盘 baiduyunguanjia://、迅雷
thunder:// 都是这个套路):浏览器让系统按注册表里的协议去拉起应用。
- api/local.ts 新增 APP_PROTOCOL(VITE_APP_PROTOCOL,默认 yuncang)、appLaunchUrl()、
launchApp()(隐藏 iframe 触发,避免协议没注册时整页报错)、waitForHealth()(1s 一次,
默认最多等 12s)。
- 离线态多一个「已安装,启动本机软件」按钮:点完进 launching 态,轮询 health;
起来了就自动查询原来的 code;12s 还没起来则提示「可能没安装 / 没注册启动协议」,
并保留下载按钮。
- 下载按钮、探活提示与居中布局保持不变。
实测(7301 + 模拟的 17311):先打开显示「服务暂不可用」;点启动后进入「正在启动本机软件…」,
轮询期间把模拟服务起起来,页面自动切到查询结果(4 行)。
|
2026-10-17 10:06:08 +08:00 |
|
liufumingren
|
7198dd1eb4
|
前端:新增不需要登录的「本机软件」公共页 /local?code=
给 Chrome 插件用:点运单号旁的按钮直接打开这一页(插件里的默认目标地址模板已改成
http://localhost:7301/local?code={code},线上换域名即可)。
- 打开即探活 GET http://localhost:17311/api/health:
- 连不上/超时/被 CORS 拦 → 「服务暂不可用」+「本地打印服务未启动,请下载安装后再试」
+ 居中的「下载 云仓视频溯源软件」按钮 + 「重新检测」(页面上也打出探测地址,方便排查);
- 可用 → 用 ?code= 调 GET http://localhost:17311/api/query/{code},把返回按
「项目 / 值」两列展示,另附可展开的原始 JSON(本机软件返回结构未知,做通用渲染)。
- 没带 code 时给一个输入框手动查;提交后把 code 同步进地址栏(命名路由 local-service)。
- 路由 meta.public,并且**已登录时也不被踢回首页**(和扫码确认页一样始终显示,
因为插件/手机是直接打开它的)。
- 本机服务地址可用 VITE_LOCAL_SERVICE 覆盖(换端口或改用 127.0.0.1 时)。
⚠️ 本机软件需要放行 CORS(Access-Control-Allow-Origin),否则浏览器会拦掉跨域请求,
表现和「软件没启动」一样(页面只能提示服务暂不可用)。
实测:7301 前端 + 一个模拟的 17311 本机服务 —— 无服务时提示文案与居中正确;
起服务后 /local?code=321408064481797 自动查出 6 行信息;不带 code 时手动输入可查。
|
2026-10-17 10:02:48 +08:00 |
|
liufumingren
|
407551f86e
|
前端:去掉已弃用的 tsconfig baseUrl(修 IDE 橙色警告)
TypeScript 5.9 起 baseUrl 被标记弃用(TS 7.0 将移除),VS Code 会在 tsconfig.json 里画橙色波浪线。
去掉 baseUrl,paths 改成相对 tsconfig 的写法(TS 4.4+ 支持无 baseUrl 的 paths):
"paths": { "@/*": ["./src/*"] }
Vite 侧的同名别名在 vite.config.ts 里单独配,不受影响;vue-tsc --noEmit + vite build 通过。
顺带在根 .gitignore 里加上 .tmp-*(联调用的临时脚本,跑完即删,不该进仓库)。
|
2026-10-17 09:49:37 +08:00 |
|
liufumingren
|
19f1daf7db
|
前端:接入旧页面的样式体系(登录面板 / 折角切换 / 列表填充高度)
从后端模板迁过来的样式现在真正用上了,并修掉两处不一致:
- 登录页:.panel-switch + .pane-account / .pane-wechat + 右上角 .corner-toggle 三角形切换;
字段改成无 label 的 .field-plain + 悬浮 .tip;验证码用 .input-row 与按钮同行。
- 找回 / 重置密码页:同样换成 .field-plain 紧凑字段。
- 列表页(设备管理 / 扫码记录):AppLayout 支持 fill → 内容区加 .content-fill,
表格包进 .table-wrap → 卡片撑满剩余高度、表头吸顶、只有表格内部滚动、分页贴底。
- 卡片间距交给 .card + .card;测试页结果区改用全局 .json-box 与 .sub-title。
- ⚠️ 修 bug:「注册」标签下注册面板不显示 —— 登录与注册共用 .pane-account,
但 CSS 只写了 .is-login .pane-account / .is-register .pane-register(后者没有对应元素);
同时给 .is-register 补上 padding-top,避免折角三角形压住第一个输入框。
- 顺带去掉不再需要的内联 margin。
验证:vue-tsc + vite build 通过;浏览器实测三个面板都能切换(注册面板 5 个字段可见、
三角形不压输入框),两个列表页 content-fill 生效、整页不滚动、表格内部滚动且表头 sticky。
|
2026-10-17 08:55:32 +08:00 |
|
liufumingren
|
bd2363bf00
|
chore: 初始化仓库(backend / frontend / extension 三块)
- backend/:Egg 3 纯 JSON 接口服务(MySQL 8 + Redis),全部走 header 令牌鉴权;
已彻底去掉服务端渲染(删除 page 控制器 / app/view / nunjucks / session / CSRF),
开发时把页面请求反代到前端 dev server,生产托管 frontend/dist(SPA 回退)。
单测 91 个通过(不需要本机数据库)。
- frontend/:Vite + Vue3 + TypeScript 的 SPA(登录 / 注册 / 找回密码 / 扫码登录与确认 /
首页统计 / 设备管理 / 扫码记录 / 个人中心 / 测试页),vue-tsc 类型检查与构建通过。
- extension/:MV3 浏览器扩展(零构建),注入第三方 WMS 页面识别运单号并打开溯源页。
- 忽略规则统一放根 .gitignore:node_modules、dist、logs / logs-*、run、typings、
.env*、config.local.js(含本机数据库与 Redis 密码,绝不入库)。
|
2026-10-17 08:50:32 +08:00 |
|