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.interactionsCopilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。Copilot 技能:发现、调用与排障 —
copilot.skillsCopilot 技能的项目/用户/内置发现路径、显式调用、同名选择、开关、按需加载、使用统计和 MCP 依赖配置。Backend Operations 中继与只读概览 —
delivery.backend-operationsBackend Operations 的接口、身份与任务回执;区分在线、排队和执行完成,并说明加密快照的下载、消费与过期清理。更新扫描保护:临时排除项与清理所有权 —
delivery.update-scan-protectionServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。CVRAW / CVCIE 图像导出 —
engine.cv-image-exportCVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。RC 注册与服务快照 —
engine.rc-registrationRC 默认注册参数、节点令牌、服务目录同步与状态快照。远端删除不清本地令牌和收发主题,更新可能部分生效。跨模块运行问题定位 —
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.modelPluginLoader的manifest/依赖门禁、禁用缓存、程序集发现和失败边界;载入不等于provider可用,也不支持隔离卸载。WindowsServicePlugin:选包、本机安装与恢复 —
plugins.windows-serviceWindowsServicePlugin的在线选包与缓存、本机完整安装、数据库版本切换和恢复边界;下载、日志完成、备份与实际服务状态不能互相替代。关于窗口:视觉展示与光谱展示 —
ui.about-exhibition主程序的图像、色彩与测量展示,以及 Spectrum 的光谱关于页:独立品牌和版本、中英文与繁体资源、不透明深浅配色、原生圆角对齐与关闭释放约束。桌面宠物 —
ui.desktop-pet桌面宠物的启用、选择、Codex 创建、本地素材导入、精灵表规格、配置与故障定位;创建结果由设置页限时发现。UI 运行时扩展发现与排查 —
ui.discoveryUI 扩展发现与入口缺失排查:AssemblyHandler 的程序集过滤、类型缓存和 provider 构造;刷新程序集不重建所有消费者,入口可见不证明初始化或业务完成。编辑器选择、文档生命周期与停靠布局 —
ui.documents编辑器注册与选择、文档身份、保存重载关闭及外部变更;重置停靠布局保留已打开的编辑器和未保存修改。快捷键:发现、注册、编辑与释放 —
ui.hotkeys快捷键的发现、多组绑定、窗口/全局注册与搜索编辑;同一操作共享作用域,未分配操作保留展示,确认后立即保存,注册或持久化失败按结果补偿。多图查看、刷新与缩略图缓存 —
ui.image-toolsImageTools内置注册、多图列表中的单张预览、刷新与SQLite缩略图缓存;重选不保证重载,关窗不清缓存,缓存关闭也不等于零数据库访问。界面语言:资源发现、配置与重启 —
ui.localization界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。菜单:发现、显示、执行与配置 —
ui.menus插件菜单发现、类型缓存、菜单树、显示覆盖与执行权限。启动时加载可见性、顺序和父级配置,快捷键独立注册。应用搜索:入口、候选与执行 —
ui.search应用搜索窗口的入口、关键词匹配、候选来源、缓存刷新与命令执行;Ctrl+F 按焦点执行局部查找,Ctrl+Shift+P 打开应用搜索。TCP 监听、协议分发与消息记录 —
ui.socket-protocolSocket连接管理器的监听配置、窗口关闭与服务停止、防火墙放行、消息查询和JSON/Text分发;清空消息只清列表,重发可能换客户端,Sent不证明对端执行。工作区创建、资源打开与文件树管理 —
ui.solution工作区创建、打开与最近列表,文件树搜索和引用移除,切换取消及 cvsln 恢复。新建工作区保留已有文件。状态栏:发现、刷新与宿主生命周期 —
ui.status-bar状态栏的插件发现、活动文档通知、绑定更新、控件重建和关闭生命周期;刷新不保证发现新provider,隐藏不等于保存偏好或停止采样。存储清理与选择性设置重置 —
ui.storage-maintenance存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。主题选择、资源应用与窗口外观 —
ui.themes应用主题即时预览,启动页独立选择深色、浅色或跟随软件且下次启动生效;ThemeManager 的资源、系统跟随、窗口外观和保存边界。配置向导:步骤、应用与完成边界 —
ui.wizards配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。安装制品与运行输出 —
delivery.installation区分完整安装制品、增量更新和源码输出,定位安装后缺依赖、配置与启动问题。系统要求与首次构建 —
delivery.prerequisitesWindows x64 运行与源码构建前提:Desktop Runtime、SDK、C++ 工具集及已有 native DLL 的选择。主程序启动与最小图像验证 —
operations.first-run主程序启动的配置、实例和服务副作用,远程白屏的软件渲染兼容入口,以及隔离测试环境中的最小本地图像验证。ColorVision 概览 —
platform.productColorVision 的设备、流程、图像分析、结果、插件与客户项目能力,以及从任务进入文档的方法。UI 包职责与依赖边界 —
ui.package-boundariesUI类库的职责、依赖与目标框架/版本兼容;包版本可独立于主程序,ScottPlot与SkiaSharp保持已验证的资产组合。
ColorVision/Copilot
Copilot Agent Runtime —
copilot.runtimeColorVision Copilot 的 Agent Framework 执行层、宿主策略边界和按任务检索的专题路由。统一图像算法平台 V1 —
algorithms.platform图像编辑器本地算法扩展:Catalog 描述、provider 注册、Invocation 和 Runner 执行;像素预览与应用/取消、几何结果和叠加显示分流,保留所有权与发布门禁;ONNX仅设计。Copilot 设置、持久化与连接诊断 —
copilot.configurationColorVision内置Copilot的设置草稿、配置保存与运行态发布、模型选择和联网诊断;保存失败可能已落盘,Local MCP测试核验会话握手与只读状态调用。Copilot Agent 执行链 —
copilot.executionCopilot 请求调度、工具筛选、审批、只读委派与执行证据闭环。Copilot 扩展、MCP 与 Hook —
copilot.extensions业务模块动态上下文、外部 MCP client 和 Hook 如何进入统一宿主权限与生命周期。Copilot 输入、命令与活动呈现 —
copilot.interactionsCopilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。Copilot 生命周期、预算与项目指令 —
copilot.lifecycleCopilot 任务生命周期、恢复预算与项目指令发现的契约;技能发现和调用见独立技能主题。Copilot 任务、恢复与内置工具 —
copilot.session-toolsCopilot 会话检查点、任务呈现、重试和内置工具的状态恢复与安全边界。Copilot 技能:发现、调用与排障 —
copilot.skillsCopilot 技能的项目/用户/内置发现路径、显式调用、同名选择、开关、按需加载、使用统计和 MCP 依赖配置。Copilot 工具契约 —
copilot.tool-contractsCopilot 工具结果、事件、审批恢复和 Flow 编辑必须遵守的执行契约。Copilot 状态所有权与界面交接 —
copilot.view-modelCopilot 界面状态的所有权、异步输入交接、检查点提交及会话保存完成边界。CVRAW / CVCIE 图像导出 —
engine.cv-image-exportCVRAW/CVCIE 原生导出的窗口、命令行参数、通道和命名规则,以及覆盖、部分失败和退出码边界。Engine 设备资源与运行装配 —
engine.devices设备工厂、资源重载、显示装配与详情视图按需初始化;旧对象释放、集合重建和显示替换并非一个事务,记录存在、界面可见、服务在线和动作完成分别判断。算法结果交接、展示与导出 —
engine.results算法结果交接、已加载批次主记录查询与叠加显示:区分本地中立 Geometry/Overlay、Engine 历史 handler 和客户业务导出,保留来源与文档/revision 生命周期。Flow 运行诊断、中断恢复与 Incident 处置 —
flow.diagnosticsFlow本地诊断SQLite快照、节点尝试与Incident事件列表的读写边界;快照不保证包含未保存画布,终态持久化与业务结果分开,中断恢复不续跑节点,心跳不是判死条件。界面语言:资源发现、配置与重启 —
ui.localization界面语言的资源发现、系统语言回退、设置绑定和重启切换;语言下拉框不证明插件翻译完整,修改配置值不等于刷新窗口。FlowEngineLib 节点扩展 —
flow.node-extension说明服务与本地节点基类、请求与响应扩展点、分支输入隔离、属性编辑和流程完成的边界。ColorVision 本地 MCP —
copilot.mcp-serverColorVision 入站本地 MCP 的连接与会话、工具和资源、工作区读取、两阶段确认及菜单写入边界。
ColorVision/FloatingBall
Copilot 输入、命令与活动呈现 —
copilot.interactionsCopilot 命令目录、输入与引用、会话导航及消息/桌宠呈现;本地入口不等于无副作用。桌面宠物 —
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-extensionExplorer 的 CVRAW/CVCIE COM provider 如何读取像素、生成非测量用途缩略图,以及源码脚本与 ServiceHost 注册的不同副作用和失败边界。ColorVisionServiceHost:本机权限代理与生命周期 —
platform.service-hostColorVision 服务主机的状态刷新、安装修复、日志诊断、身份票据与就绪条件;自动刷新只更新日志,客户端超时不取消命令,服务停止超过两分钟仍等待排空,服务启动成功日志不证明后台清理和启动完整性检查完成。
ColorVision/Settings
存储清理与选择性设置重置 —
ui.storage-maintenance存储分类占用与模块扩展接口、独立文件确认清理,以及配置页的恢复点和选择性下次启动重置。设置、流程与结果的导入导出边界 —
operations.exports按软件设置备份、流程、图像和项目结果定位导入导出入口,说明备份恢复范围、文件验收与迁移边界。
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-protectionServiceHost提供的主程序增量更新临时Defender排除项、目录准入和清理所有权;启用失败不阻断更新,服务停止或保护超时不保证排除项立即恢复。Explorer 缩略图读取与 COM 注册 —
engine.shell-extensionExplorer 的 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
- 配置向导:步骤、应用与完成边界 —
ui.wizards配置向导的步骤发现、初始化时序、前进应用和完成标记;关闭不回滚,完成标记不证明组件健康或重启成功。
