Skip to content

ColorVision.UI.Desktop ​

UI/ColorVision.UI.Desktop/ 是桌面侧辅助壳层功能集合,包含设置、向导、菜单管理、插件市场、下载、第三方应用入口、反馈和崩溃诊断。它不是整个产品主入口;真正主程序在 ColorVision/。

先查什么 ​

现象第一检查点
设置页为空或少项设置发现与缓存:Provider/特性、程序集视图、类型缓存和当前搜索范围
自定义设置 View 不显示页面生命周期:ViewType、无参构造、失败内容缓存与绑定
向导步骤不出现向导发现:IWizardStep、程序集视图、反射/构造失败和排序
插件市场 README/CHANGELOG 空白WebView2 初始化、Markdown CSS、内容是否为空
下载失败或卡住Assets/Tool/aria2c.exe、当前 RPC 端口、任务错误及目标目录权限;端口被占用时选择其他端口,只停止本管理器启动的进程
DLL 版本窗口缺少条目目标程序集是否已加载到当前进程
第三方应用打不开SystemAppProvider / 自定义应用路径、权限和系统工具是否存在
Dump 设置失败ColorVisionServiceHost 是否已安装且为当前版本、Diagnostics/CrashDumpConfiguration.cs 的 HKLM 目标项和保存目录

当前能力 ​

能力当前入口说明
设置窗口Settings/SettingWindow.xaml.cs侧栏、搜索、活对象编辑与关窗保存,不是 Tab 或取消事务
向导流程WizardManager、WizardWindow、WizardWindowConfig步骤发现、应用、初始化与完成标记,完成不等于所有组件健康
菜单显示覆盖MenuItemManagerConfig、MenuItemManagerInitialized启动时加载可见性、顺序与父级配置
插件市场MarketplaceWindow、MarketplaceClient、MarketplacePackageDownloadService展示市场内容、Markdown、下载和安装入口
下载管理Aria2cDownloadManager、DownloadWindow使用内置 aria2c.exe 管理下载
系统工具SystemAppProvider控制面板、组策略、网络连接、注册表编辑器
第三方应用CustomAppProvider、ThirdPartyAppsWindow自定义应用和磁盘 Treemap 入口
主程序工具贡献ColorVision/ToolPlugins/ThirdPartyApps/通过 IThirdPartyAppProvider 向第三方应用窗口补充主程序工具;“上网网卡选择”可读取 IPv4、DNS、网关和 Metric,修改所选接口的 Metric,或将 DNS 设为 114.114.114.114 后刷新缓存
崩溃诊断Diagnostics/CrashDumpSettingsControl、CrashDumpConfiguration通过通用属性反射生成 WER LocalDumps 设置,由后台特权服务写入 HKLM;支持手动保存当前进程 Dump 和反馈包收集
反馈诊断Feedback/、Feedback/Collectors/WindowsEventLogCollector、ColorVision.UI/LogImp/Collectors/ConfigurationSnapshotCollector打包应用日志、系统信息、脱敏配置快照、Dump 和 Windows Application/System 警告或错误;可从反馈窗口清理旧的应用、更新、服务日志和 ColorVision Dump
诊断窗口ViewDllVersionsWindow查看已加载程序集版本、产品版本和路径

“应用与工具”支持搜索、分类筛选、添加自定义应用和快捷脚本。双击启动,右键显示可用操作。列表和启动命令均检查应用角色。

“常用工具”中的 SSCOM 从 %APPDATA%\ColorVision\Tools\SSCOM\sscom5.13.1.exe 启动,使用同一目录保存 sscom51.ini 等设置。启动时先以安装目录 Assets\Tool 的 EXE 核对 %APPDATA%\ColorVision\PackageCache\Tools\SSCOM 的备份,再使用备份补齐或修复运行目录的 EXE。随备份保存的 SHA-256 可在安装目录缺少该 EXE 时校验备份。安装源和可校验的备份均不可用时,启动会提示修复安装。校验和修复只涉及 EXE 与备份摘要,运行目录已有的设置文件保留。

首次双击 SSCOM 时,ColorVision 在运行目录创建缺失的 sscom51.ini,预置 PG 常用指令和 ARVR Pro TCP/JSON 指令,打开即可在「多条字符串发送」中看到。已有配置继续使用其现有指令和设置。右键 SSCOM 选择「调试预设」,可把 PG 常用指令、当前已加载的通用传感器模板或 ARVR Pro 指令添加到空槽位,再打开 SSCOM。选用 ARVR Pro 时,可填写 IPv4、端口和测试 SN,并设置 TCP 客户端。新增槽位的循环顺序为 0,首次启动和应用 TCP 预设时关闭自动连接。每条指令需要手动发送。文件使用 CP936 和 CRLF,发送栏使用 HEX 保留实际字节,单个文件最多 99 条。

“内部工具”提供“CVRAW 批量导出 TIFF”(ColorVision/ToolPlugins/CvRawExport/)。选择文件夹后点击“执行”,后台递归检索 .cvraw(扩展名不区分大小写,不跟随目录链接),将原始图像导出为同目录、同主文件名的 .tif;已有目标直接跳过,不覆盖、不重新编码。并发数可选 1~32,默认使用 CPU 逻辑处理器数的一半,最低 1、最高 4;大图像可降低并发以减少内存占用。保留位深、通道、像素值及既有 TIFF 图像参数,单文件失败后继续处理并列出文件和原因。界面显示成功、跳过、失败与总进度;取消或关窗会停止后续任务,等待正在进行的读取/编码返回,已完成文件保留。Engine/ColorVision.Engine/Media/Export/CvRawBatchExporter.cs 先写同目录临时 TIFF,完成后以不覆盖方式移入目标,避免中断残留被下次误认为已导出。

下载任务与文件保护 ​

Aria2cDownloadManager 按任务串行处理启动、暂停、恢复和删除。取消或删除会立即使旧操作失效;即使 addUri 响应晚到,也会清除已提交的 GID,避免记录删除后后台下载继续运行。暂停和取消的任务可恢复,不触发完成回调;删除是终态,尚未报告结果的任务以 DownloadStatus.Deleted 回调一次,等待方不会悬挂。暂停任务保持同一模型和 GID,重新加载记录不会丢失恢复状态;重启只自动恢复等待或下载中的记录,明确暂停的记录由用户恢复。GID 已失效时重新提交并保留断点文件,RPC 错误作为错误处理,不能把文件打开失败当作缓存损坏而删除文件。

新建普通下载写入任务独有的 .cvdownload-<GUID>.part,完成后检查实际路径、大小和 SHA-256,再移动到预留的最终路径;已有最终文件不会被覆盖,任务启动时最终路径已被占用会改用新文件名。旧记录仍沿用原路径及 .aria2 断点文件。取消和失败保留下载文件;清空全部或已完成记录只删除操作开始时的相应记录并停止对应任务,保留文件。删除记录时仅在用户选择删除文件后清理相应普通文件、工作文件及断点文件,目录不会递归删除。完成提示和自动打开由 DownloadCompletionNotifier 处理,与下载窗口是否打开无关,只作用于无回调的手动下载。完成回调异常单独记录,不触发重新下载或删除已成功的文件。

AddDownload 保持原有调用契约;调用方可通过 AddVerifiedDownload 提供预期 SHA-256,市场下载会传入包元数据的哈希并继续执行市场自己的包校验。复用本地文件必须与调用方提供的哈希或服务器 Digest / Content-Digest 中的 SHA-256 匹配,复制过程也校验内容;文件大小相同、同 URL 历史完成记录或 ETag 本身不足以证明内容可复用。缺少可信摘要时正常联网下载。

同名任务在提交前预留不同路径;URL 和磁力链接的文件名被规范化为单一文件名。磁力任务使用独立目录,跟随 aria2 的 followedBy 子任务,并在完成后保存实际文件或目录路径。下载认证以 Windows 当前用户的 DPAPI 保护,旧的 Base64/明文记录在初始化时迁移;迁移保留任务 ID、路径与状态。受保护凭据不能直接由另一 Windows 用户解密,迁移数据时需要重新提供认证。

RPC 只连接回环地址,后台进程使用随机的实例密钥;启动等待 RPC 就绪,不会为了回收端口而终止其他 aria2 进程。活动任务每批最多 64 个 GID 查询状态,历史完成记录不参与轮询;本地校验/复制受 MaxConcurrentTasks 限制。分页查询和文件检查在后台执行,取消旧分页请求可避免过期结果覆盖当前页;这些限制减少请求和 UI 阻塞,不构成吞吐量指标承诺。

运行链路 ​

帮助菜单的“商店”和“反馈”入口支持菜单访问键,见帮助菜单键盘入口。插件市场进入后聚焦列表,Esc 优先收起详情并回到列表,再次按下关闭窗口。反馈窗口初始聚焦正文输入框,保留多行 Enter 换行及原有默认发送、Esc 取消行为;Tab / Shift+Tab 在窗口内循环。

链路关键路径
设置链MenuOptions → SettingWindow/controller → 元数据与编辑器 → 菜单返回后保存
向导链App 分流 → WizardManager 发现 → WizardWindow 的 Refresh/Apply/initializer → 标记与保存
市场链MarketplaceWindow -> MarketplaceClient -> Markdown/WebView2 -> 下载/安装服务
下载链DownloadWindow -> Aria2cDownloadManager -> aria2c.exe / RPC daemon
崩溃诊断链SettingWindow 的“配置 → 崩溃转储” -> CrashDumpSettingsProvider -> 通用属性编辑器 -> ColorVisionServiceHost / WER LocalDumps / DumpHelper
反馈收集链FeedbackWindow -> IFeedbackLogCollector -> 应用日志、系统信息、脱敏配置快照、Dump、Windows 事件日志 -> 匿名 /api/feedback
菜单覆盖加载MenuItemManagerInitialized → ApplySettings → 更新覆盖并按需重建菜单
DLL 诊断链ViewDllVersionsWindow

反馈主窗口固定显示诊断项摘要、日志范围、打开来源目录、清理历史文件和打包入口,附件区滚动不会带走这些操作。“选择项目”打开独立的紧凑列表,支持按名称或说明搜索、全部选中/取消和恢复默认选择;这些批量操作作用于全部项目,不受搜索过滤影响,关闭或按 Esc 保留选择。范围统一应用于实现 IFeedbackLogTimeRangeCollector 的日志和数据库来源,目录菜单也仅列出该接口提供的目录,不支持的来源保持自己的收集规则。清理与打包勾选独立,仅交给实现 IFeedbackDiagnosticCleanupSource 的来源;无对应能力时禁用入口。打包期间禁止修改诊断选项或启动清理,避免修改正在使用的收集器。

Engine 提供默认勾选的“MVS 日志”来源,沿用统一天数范围,把本机已有的海康 SDK 与客户端 .log(含数字轮转后缀)复制到 ZIP 的 MVS/ 下。SDK 来源优先读取日志服务安装目录的 Path.ini,只访问其中指定根目录下的 MvSDKLog;同时检查 Windows/当前用户临时目录和应用目录下的 MvSDKLog,以及用户目录、ProgramData 下的 MVS/Log,不扫描整个临时目录或相机图像目录。服务的 Path.ini、LogServer.ini 不按日志天数过滤。单文件最多 50 MiB、总日志最多 200 MiB;活动日志允许共享读取,只复制打开时的长度,属于尽力采集,不保证跨文件一致快照。MVS/collection.json 记录采集时间、来源路径、日志查看器位置、缺失目录、访问/复制失败和大小限制跳过原因。收集不提权、不连接相机、不修改日志设置,也不参与“清理历史文件”;SDK 系统日志无读取权限时仍附状态说明,其他诊断项继续打包。 实现见 Engine/ColorVision.Engine/Services/Devices/Camera/Diagnostics/MvsLogCollector.cs。

“当前进程内存转储”是独立的诊断来源,默认不勾选;手动选择后,由 Feedback/Collectors/CurrentProcessDumpCollector.cs 在打包时抓取运行中进程的完整内存快照。它不读取或修改 WER 崩溃转储配置,也不按日志天数或历史 Dump 的 100 MiB 上限筛选。快照写入临时文件后直接以最高 ZIP 压缩级别写入反馈包的 ProcessDump/,不会生成嵌套 ZIP;压缩率取决于内存内容。打包结束会清理临时快照,采集失败会清理未完成文件并尽量加入 ProcessDump/collection-error.txt,其他来源继续打包。服务器确认提交成功、上传文件流释放后,反馈窗口清理本次生成的诊断 ZIP;失败或取消上传时保留 ZIP 以便重试或离线复制,用户手动添加的原始附件不在清理列表内。 在实际应用中确认原生快照能够生成,且服务器接收成功后正确清理。

打开物理相机管理时,通过 SDK 环境变量、MVS 安装注册表信息和系统 Program Files 目录定位 LogViewer,优先 Win64、其次 Win32。找到时,工具栏显示“MVS 日志”。启动时以查看器所在目录作为工作目录,并保留厂商程序要求的管理员权限;取消 UAC 不报告启动错误。该入口与反馈收集共用 MvsDiagnosticsPaths 的安装位置发现,但收集文件不依赖成功打开查看器。

反馈窗口从帮助菜单、启动恢复或 Copilot /feedback 打开时均使用非模态 Show(),保留 Owner 与居中定位。打包和上传期间可最小化反馈窗口、切回其他窗口继续操作;打包仍在后台任务中执行,HTTP 上传仍异步等待。Copilot 附带的临时会话文件保留到反馈窗口关闭,不能在 Show() 返回时提前清理。

点击“发送反馈”后匿名提交。本地 RBAC、Windows 用户名和机器名仅用于诊断信息,不构成 Web 账号归属。客户端同时提交结构化 machineName、clientSubmittedAt,日志包实际完成时才提交 diagnosticsCollectedAt;后续查看和下载见反馈归属、查询与诊断附件下载。

默认选中的配置收集器把当前 ConfigHandler.ConfigFilePath 读取为 JSON,在反馈 ZIP 中写为 Config/ColorVisionConfig.json。“流程前后处理配置”同时收集 PreProcessConfig.json、PostProcessConfig.json;加载 ProjectARVRPro 后,“ARVRPro 流程配置”按项目实际配置目录收集 ProjectARVRProProcessGroups.json,保留流程组、切图等待、相机覆盖参数与 Recipe。配置始终采集当前已保存文件,不受日志天数或文件修改时间限制,也不扫描历史备份、其他项目、认证文件或整个配置目录。

配置收集统一使用 FeedbackConfigurationSnapshot,支持对象、数组和 ConfigJson 等嵌套 JSON 字符串;只解析 JSON 数据,不实例化 $type 指定的类型。它保留诊断字段,但递归遮盖名称表示密码、Token、Secret、API Key、连接字符串、凭据或 Cookie 的值;嵌套 JSON 字段无法解析时遮盖该字段,整份文件无效时仅附不含原始内容的 .collection-error.txt,其他文件继续收集。可选文件不存在时跳过,原始文件不直接进入反馈包。

本地运行数据库通过同一 IFeedbackLogCollector 发现链加入诊断项,默认勾选、最近 7 天,在主窗口统一选择 1/3/7/14/30 天。“流程与节点耗时记录”导出 FlowNodeRecords.db,“Socket 通信记录”导出 SocketMessages.db,“MQTT 服务通信记录”导出 MsgRecords.db 中按发送、接收、创建或更新时间命中的请求、响应和超时状态,保留完整正文;加载 ProjectARVRPro 后还会出现“ARVRPro 测试与阶段耗时记录”,导出 ProjectARVRPro.db。路径来自各模块当前配置,不依赖固定安装目录;收集器不会初始化业务管理器或迁移源数据库。

数据库按记录自身的本地时间/UTC 字段筛选,保留关联运行、节点、事件、异常、模板快照和结果,因此部分关联记录可以早于所选起始时间。输出是反馈 ZIP 的 Database/ 下可直接查询的独立 SQLite 文件,保留原字段、ID、索引及完整压缩正文,不跟随结果中的图片路径收集图片。源库以只读模式在单个读取事务中访问,包含读取快照时 WAL 中已提交的数据;不同数据库之间不提供统一事务快照,尚未落库的写入队列不属于导出范围。

每个数据库附带同名 .export.json,记录所选时间范围(含时区)、各表条数、缺失表和失败原因。旧库缺少新诊断表时仍导出可用表并标为 partial;无法识别时间字段或数据库不可读时只附错误说明,不回退为全库收集。导出逻辑与模块筛选分别位于 UI/ColorVision.Database/SqliteFeedbackCollector.cs 和各模块的反馈收集器 打包与发送沿用反馈窗口入口,附件上传按流读取。离线时可选中压缩包并打开所在目录。

“清理历史文件”先要求用户确认,再调用实现 IFeedbackDiagnosticCleanupSource 的诊断来源。应用和服务日志保留各活动目录中最新的文件,其他来源只返回点击清理前已经存在的历史文件;删除失败的占用或无权限文件会计入跳过数量。清理仅删除来源明确声明的文件,不删除目录、配置、数据库、反馈附件或已经打包的 ZIP;共享的 WER Dump 目录中也只匹配当前 ColorVision 进程命名的 .dmp。

发布验收 ​

检查 ColorVision.UI.Desktop.csproj 的目标框架与包内 README、WebView2/Markdown 依赖,以及 Assets/css/github-markdown.css、Assets/Tool/aria2c.exe 的输出路径。共用流程见UI DLL 发布。

边界 ​

  • 本项目的 App.xaml.cs 为空实现,App.xaml 未设置 StartupUri;MainWindow.xaml 仅有空 Grid,构造器只调用 InitializeComponent()。声明 WinExe 不代表包含完整产品启动、单实例、首次向导或 AvalonDock 主窗口;真正的宿主启动链在 ColorVision/。
  • 普通用户模式下,写入或清除 HKLM\SOFTWARE\Microsoft\Windows\Windows Error Reporting\LocalDumps 由 ColorVisionServiceHost 执行;管理员模式可直接写入,手动保存 Dump 不修改系统配置。
  • PluginLoader 跳过残留的 EventVWR 插件。
  • 特权服务的 registry-set-values / registry-delete-key 是通用 HKLM 写入接口,不限制到 WER 路径,并支持显式选择 32/64 位注册表视图;所有调用仍须通过调用方身份校验、单次 Broker Ticket,并写入不含值数据的审计日志。
  • 这里是窗口和管理工具集合,不是所有菜单、插件或配置运行时的唯一中心。

关键文件 ​

任务先看
设置窗口Settings/SettingWindow.xaml.cs、Settings/SettingWindowController.cs
向导流程Wizards/WizardWindow.xaml.cs、Wizards/WizardWindowConfig.cs
菜单显示覆盖MenuItemManager/MenuItemManagerInitialized.cs、MenuItemManagerService.cs
插件市场和下载Marketplace/、Download/、WebViewService.cs
第三方应用ThirdPartyApps/SystemAppProvider.cs、ThirdPartyAppsWindow.xaml.cs
主程序网卡工具ColorVision/ToolPlugins/ThirdPartyApps/InternalAppProvider.cs、NetworkAdapterPriorityService.cs、NetworkAdapterPriorityWindow.xaml.cs
崩溃与反馈诊断Diagnostics/、Feedback/、ColorVision.Common/NativeMethods/DumpHelper.cs

验证入口与缺口 ​

实际 P2P、代理环境、大文件吞吐量或窗口交互应在目标环境验收。外部联网下载、HKLM 写入、DNS 修改和反馈上传需要明确授权。

基于 MIT License 发布。