Skip to content

ColorVision 源码知识 ​

自动生成的源码目录。修改主题 Markdown 的 code_paths 后运行 node docs/.vitepress/scripts/knowledge.mjs generate;不要手工编辑。

返回知识总入口。只读与当前模块有关的主题,再核对其中的源码、测试和状态;规划、历史不代表当前能力。

以下关联用于按源码定位和变更复核,不是完整调用图或主题所有权。跨模块链接保留在地图中,网页侧栏只列地图入口。

ColorVision/ 根目录与跨模块关联 ​

  • 桌面交付制品与责任路由 — delivery.deployment 区分完整安装器、主程序更新、插件项目包和独立在线下载工具;ColorVisionSetup以Framework 4.8单文件查询并下载最新版,实际安装仍由完整安装包负责。

  • 安装、构建与运行入口 — delivery.start 克隆代码后的源码问答、本地构建、安装和运行分流;只问Codex不需要先启动程序。

  • 架构设计 — platform.architecture 按启动、跨模块调用、流程、模板与权限问题定位架构契约。

  • 模板编辑入口与菜单契约 — algorithms.template-menus 从模板菜单、算法面板或应用搜索打开模板;说明选择索引、流程设计器直达和菜单发现的边界。

  • Copilot 输入、命令与活动呈现 — copilot.interactions Copilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。

  • Copilot 技能:发现、调用与排障 — copilot.skills Copilot 技能的项目/用户/内置发现路径、显式调用、同名选择、开关、按需加载、使用统计和 MCP 依赖配置。

  • Backend Operations 中继与只读概览 — delivery.backend-operations Backend Operations 的接口、身份与任务回执;区分在线、排队和执行完成,并说明加密快照的下载、消费与过期清理。

  • 更新扫描保护:临时排除项与清理所有权 — delivery.update-scan-protection ServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。

  • CVRAW / CVCIE 图像导出 — engine.cv-image-export CVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。

  • RC 注册与服务快照 — engine.rc-registration RC 默认注册参数、节点令牌、服务目录同步与状态快照。远端删除不清本地令牌和收发主题,更新可能部分生效。

  • 跨模块运行问题定位 — operations.index 从启动、配置、日志、设备、流程和结果现象定位代码责任,区分已完成阶段与待验证阶段,避免用重启或改数据代替诊断。

  • 日志来源、历史读取与筛选 — operations.logs 区分log4net输出、历史文件读取与UI筛选,说明刷新、截断和原生日志采集边界;没有显示不等于动作未发生。

  • 主窗口与入口装配 — operations.main-window 主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。

  • RBAC:登录缓存、会话与权限边界 — platform.rbac 本地RBAC的登录缓存、会话校验和权限同步限制,以及自动登录失败、登出撤销和用户中心统计的实际边界。

  • 启动、初始化与故障恢复 — platform.runtime 启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。

  • 启动失败上报与缺依赖告警 — platform.startup-integrity 主程序启动失败识别、状态上报和后台缺依赖告警;十秒观察不强杀进程,已处理终态抑制重复弹窗,无告警不证明安装完整。

  • 系统职责与跨模块边界 — platform.system 宿主、UI、Engine、插件与项目的职责及调用边界:UI操作不必经过Engine,程序集依赖不是统一执行顺序,构建产物不等于交付制品。

  • 插件装载、依赖门禁与扩展发现 — plugins.model PluginLoader的manifest/依赖门禁、禁用缓存、程序集发现和失败边界;载入不等于provider可用,也不支持隔离卸载。

  • WindowsServicePlugin:选包、本机安装与恢复 — plugins.windows-service WindowsServicePlugin的在线选包与缓存、本机完整安装、数据库版本切换和恢复边界;下载、日志完成、备份与实际服务状态不能互相替代。

  • 关于窗口:视觉展示与光谱展示 — ui.about-exhibition 主程序的图像、色彩与测量展示,以及 Spectrum 的光谱关于页:独立品牌和版本、中英文与繁体资源、不透明深浅配色、原生圆角对齐与关闭释放约束。

  • 桌面宠物 — ui.desktop-pet 桌面宠物的启用、选择、Codex 创建、本地素材导入、精灵表规格、配置与故障定位;创建结果由设置页限时发现。

  • UI 运行时扩展发现与排查 — ui.discovery UI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。

  • 编辑器选择、文档生命周期与停靠布局 — ui.documents 编辑器注册与选择、文档身份、保存重载关闭及外部变更;重置停靠布局保留已打开的编辑器和未保存修改。

  • 快捷键:发现、注册、编辑与释放 — ui.hotkeys 快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。

  • 多图查看、刷新与缩略图缓存 — ui.image-tools ImageTools内置注册、多图列表中的单张预览、刷新与SQLite缩略图缓存;重选不保证重载,关窗不清缓存,缓存关闭也不等于零数据库访问。

  • 界面语言:资源发现、配置与重启 — ui.localization 界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。

  • 菜单:发现、显示、执行与配置 — ui.menus 插件菜单发现、类型缓存、菜单树、显示覆盖与执行权限。启动时加载可见性、顺序和父级配置,快捷键独立注册。

  • 应用搜索:入口、候选与执行 — ui.search 应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。

  • TCP 监听、协议分发与消息记录 — ui.socket-protocol Socket连接管理器的监听配置、窗口关闭与服务停止、防火墙放行、消息查询和JSON/Text分发;清空消息只清列表,重发可能换客户端,Sent不证明对端执行。

  • 工作区创建、资源打开与文件树管理 — ui.solution 工作区创建、打开与最近列表,文件树搜索和引用移除,切换取消及 cvsln 恢复。新建工作区保留已有文件。

  • 状态栏:发现、刷新与宿主生命周期 — ui.status-bar 状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。

  • 存储清理与选择性设置重置 — ui.storage-maintenance 存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。

  • 主题选择、资源应用与窗口外观 — ui.themes 应用主题即时预览,启动页独立选择深色、浅色或跟随软件且下次启动生效;ThemeManager 的资源、系统跟随、窗口外观和保存边界。

  • 配置向导:步骤、应用与完成边界 — ui.wizards 配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。

  • 安装制品与运行输出 — delivery.installation 区分完整安装制品、增量更新和源码输出,定位安装后缺依赖、配置与启动问题。

  • 系统要求与首次构建 — delivery.prerequisites Windows x64 运行与源码构建前提:Desktop Runtime、SDK、C++ 工具集及已有 native DLL 的选择。

  • 主程序启动与最小图像验证 — operations.first-run 主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。

  • ColorVision 概览 — platform.product ColorVision 的设备、流程、图像分析、结果、插件与客户项目能力,以及从任务进入文档的方法。

  • UI 包职责与依赖边界 — ui.package-boundaries UI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。

ColorVision/Copilot ​

  • Copilot Agent Runtime — copilot.runtime ColorVision Copilot 的 Agent Framework 执行层、宿主策略边界和按任务检索的专题路由。

  • 统一图像算法平台 V1 — algorithms.platform 图像编辑器本地算法扩展:Catalog 描述、provider 注册、Invocation 和 Runner 执行;像素预览与应用/取消、几何结果和叠加显示分流,保留所有权与发布门禁;ONNX仅设计。

  • Copilot 设置、持久化与连接诊断 — copilot.configuration ColorVision内置Copilot的设置草稿、配置保存与运行态发布、模型选择和联网诊断;保存失败可能已落盘,Local MCP测试核验会话握手与只读状态调用。

  • Copilot Agent 执行链 — copilot.execution Copilot 请求调度、工具筛选、审批、只读委派与执行证据闭环。

  • Copilot 扩展、MCP 与 Hook — copilot.extensions 业务模块动态上下文、外部 MCP client 和 Hook 如何进入统一宿主权限与生命周期。

  • Copilot 输入、命令与活动呈现 — copilot.interactions Copilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。

  • Copilot 生命周期、预算与项目指令 — copilot.lifecycle Copilot 任务生命周期、恢复预算与项目指令发现的契约;技能发现和调用见独立技能主题。

  • Copilot 任务、恢复与内置工具 — copilot.session-tools Copilot 会话检查点、任务呈现、重试和内置工具的状态恢复与安全边界。

  • Copilot 技能:发现、调用与排障 — copilot.skills Copilot 技能的项目/用户/内置发现路径、显式调用、同名选择、开关、按需加载、使用统计和 MCP 依赖配置。

  • Copilot 工具契约 — copilot.tool-contracts Copilot 工具结果、事件、审批恢复和 Flow 编辑必须遵守的执行契约。

  • Copilot 状态所有权与界面交接 — copilot.view-model Copilot 界面状态的所有权、异步输入交接、检查点提交及会话保存完成边界。

  • CVRAW / CVCIE 图像导出 — engine.cv-image-export CVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。

  • Engine 设备资源与运行装配 — engine.devices 设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。

  • 算法结果交接、展示与导出 — engine.results 算法结果交接、已加载批次主记录查询与叠加显示:区分本地中立 Geometry/Overlay、Engine 历史 handler 和客户业务导出,保留来源与文档/revision 生命周期。

  • Flow 运行诊断、中断恢复与 Incident 处置 — flow.diagnostics Flow本地诊断SQLite快照、节点尝试与Incident事件列表的读写边界;快照不保证包含未保存画布,终态持久化与业务结果分开,中断恢复不续跑节点,心跳不是判死条件。

  • 界面语言:资源发现、配置与重启 — ui.localization 界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。

  • FlowEngineLib 节点扩展 — flow.node-extension 说明服务与本地节点基类、请求与响应扩展点、分支输入隔离、属性编辑和流程完成的边界。

  • ColorVision 本地 MCP — copilot.mcp-server ColorVision 入站本地 MCP 的连接与会话、工具和资源、工作区读取、两阶段确认及菜单写入边界。

ColorVision/FloatingBall ​

  • Copilot 输入、命令与活动呈现 — copilot.interactions Copilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。

  • 桌面宠物 — ui.desktop-pet 桌面宠物的启用、选择、Codex 创建、本地素材导入、精灵表规格、配置与故障定位;创建结果由设置页限时发现。

ColorVision/Guidance ​

  • 主窗口与入口装配 — operations.main-window 主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。

ColorVision/NativeLogging ​

  • 日志来源、历史读取与筛选 — operations.logs 区分log4net输出、历史文件读取与UI筛选,说明刷新、截断和原生日志采集边界;没有显示不等于动作未发生。

ColorVision/Notifications ​

  • 主窗口与入口装配 — operations.main-window 主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。

ColorVision/Recovery ​

  • 桌面交付制品与责任路由 — delivery.deployment 区分完整安装器、主程序更新、插件项目包和独立在线下载工具;ColorVisionSetup以Framework 4.8单文件查询并下载最新版,实际安装仍由完整安装包负责。

  • 检查更新、重新安装与程序备份 — delivery.update 检查更新、重新安装与程序备份入口,以及主程序和插件的检查复用、下载安装、失败回退与启动恢复。

  • 跨模块运行问题定位 — operations.index 从启动、配置、日志、设备、流程和结果现象定位代码责任,区分已完成阶段与待验证阶段,避免用重启或改数据代替诊断。

  • 启动、初始化与故障恢复 — platform.runtime 启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。

  • 应用搜索:入口、候选与执行 — ui.search 应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。

ColorVision/ServiceHost ​

  • Explorer 缩略图读取与 COM 注册 — engine.shell-extension Explorer 的 CVRAW/CVCIE COM provider 如何读取像素、生成非测量用途缩略图,以及源码脚本与 ServiceHost 注册的不同副作用和失败边界。

  • ColorVisionServiceHost:本机权限代理与生命周期 — platform.service-host ColorVision 服务主机的状态刷新、安装修复、日志诊断、身份票据与就绪条件;自动刷新只更新日志,客户端超时不取消命令,服务停止超过两分钟仍等待排空,服务启动成功日志不证明后台清理和启动完整性检查完成。

ColorVision/Settings ​

ColorVision/Startup ​

  • 启动、初始化与故障恢复 — platform.runtime 启动顺序与故障恢复:软件渲染兼容参数在 WPF 窗口前生效;初始化进度和ready不代表全部成功,一次性插件跳过不绕过真实故障。

  • 主程序启动与最小图像验证 — operations.first-run 主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。

ColorVision/Themes ​

  • 主窗口与入口装配 — operations.main-window 主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。

ColorVision/ToolPlugins ​

  • 桌面交付制品与责任路由 — delivery.deployment 区分完整安装器、主程序更新、插件项目包和独立在线下载工具;ColorVisionSetup以Framework 4.8单文件查询并下载最新版,实际安装仍由完整安装包负责。

  • 开发工具管理:检测与安装 Python、Node.js — platform.developer-tools 开发工具管理的Python/Node检测、当前应用与新终端命令路径、官方版本选择和安装校验;下载等待30分钟,关窗停止后续安装但不取消下载或终止安装器。

  • 配置向导:步骤、应用与完成边界 — ui.wizards 配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。

  • ColorVision.UI.Desktop — ui.desktop 桌面辅助壳层而非产品主入口:定位设置、市场下载、第三方工具、反馈和特权崩溃诊断。

ColorVision/Update ​

  • 桌面交付制品与责任路由 — delivery.deployment 区分完整安装器、主程序更新、插件项目包和独立在线下载工具;ColorVisionSetup以Framework 4.8单文件查询并下载最新版,实际安装仍由完整安装包负责。

  • 检查更新、重新安装与程序备份 — delivery.update 检查更新、重新安装与程序备份入口,以及主程序和插件的检查复用、下载安装、失败回退与启动恢复。

  • 更新扫描保护:临时排除项与清理所有权 — delivery.update-scan-protection ServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。

  • Explorer 缩略图读取与 COM 注册 — engine.shell-extension Explorer 的 CVRAW/CVCIE COM provider 如何读取像素、生成非测量用途缩略图,以及源码脚本与 ServiceHost 注册的不同副作用和失败边界。

  • 插件产物、安装与交付 — plugins.getting-started 插件项目构建、HostCopy、市场与本地安装、备份回退和提取插件;DLL目录替换、依赖补回及重启后加载的完成条件,正式打包会上传。

  • 快捷键:发现、注册、编辑与释放 — ui.hotkeys 快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。

  • 存储清理与选择性设置重置 — ui.storage-maintenance 存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。

  • 安装制品与运行输出 — delivery.installation 区分完整安装制品、增量更新和源码输出,定位安装后缺依赖、配置与启动问题。

ColorVision/Windowing ​

  • 主窗口与入口装配 — operations.main-window 主窗口菜单、搜索、状态栏与工作区装配;Windows 11 使用紧凑主窗口,Windows 10 保持原生窗口。

ColorVision/Wizards ​

基于 MIT License 发布。