Skip to content

工作区创建、资源打开与文件树管理 ​

UI/ColorVision.Solution/ 是 ColorVision 的工作区壳层,不是 Visual Studio 解决方案加载器、算法运行时或文件访问权限沙箱。ResourceOpenService 区分工作区激活与文件编辑,SolutionManager 维护一个活动工作区,Explorer 负责项目树与配置;编辑器能读某个文件,不等于它能作为工作区或项目加载。

本页说明工作区的创建、打开、树视图、项目组织与持久化。编辑器选择、文档身份、保存/关闭和停靠布局见编辑器与文档生命周期;脚本和终端执行见终端契约。

公共停靠外观由 Themes/AvalonDockTheme.cs 和同目录 XAML 提供,主程序与 Spectrum 使用同一份深浅色模板、浮窗边框和标签命令资源。引用主题本身不创建工作区或运行初始化器;主题及兼容资源入口见停靠外观与主题边界。

打开或创建工作区 ​

选择打开入口 ​

需要打开的内容界面入口结果
图片、文本等普通文件“打开文件”,默认 Ctrl+O进入文件处理器或编辑器,不必切换工作区
已有文件夹文件 → 打开 → 打开文件夹,默认 Ctrl+Shift+O以该目录为活动工作区,使用用户目录中的私有 .cvsln
.cvsln 或已支持的项目文件文件 → 打开 → 项目/解决方案,默认 Ctrl+Alt+O;在列表窗口点击“打开项目”.cvsln 加载已有配置;项目文件准备私有工作区后激活
最近使用的工作区同一列表窗口中双击记录,或选中后按 Enter尝试打开记录指向的文件夹、项目或解决方案

快捷键可由用户调整,默认值和已有自定义绑定的规则见快捷键。工作区列表还提供“打开文件夹”和“创建工程”;其中“打开项目”的选择器只接受 .cvsln 与已注册 Provider 的项目模式,不能按副标题把它当作任意文件选择器。内置项目格式为 .cvproj、.csproj、.fsproj、.vbproj;后者的解析范围见项目 Provider 小节。

一次只激活一个工作区。选择后窗口显示“正在打开工作区…”并暂时禁用选择区域,点击“取消”或关闭该窗口可取消等待。切换需要关闭旧工作区关联文档,遇到未保存内容按文档提示选择;拒绝关闭会保留旧工作区。取消与准备阶段写入的关系见下文。

创建工程 ​

“创建工程”先建立一个含 .cvsln 的工作区,配置采用 ProjectMode=Explicit,不会直接替你生成某种业务项目。

  1. 在工作区列表点击“创建工程”,填写“项目名称”和“选择项目保存位置”。结果目录为 <保存位置>/<项目名称>。
  2. 使用准备新建的目录名。父目录不存在时,界面询问是否创建父目录。
  3. 点击“创建工程”。窗口关闭后,SolutionManager.CreateSolutionAsync 写入 <项目名称>.cvsln,再尝试切换。需要项目或文件时,在资源树支持的容器节点右键“添加”,选择“新建项目”“现有项目”“新建项”或“现有项”。

解决方案和项目文件使用对应的创建或打开命令。通过“新建项”添加解决方案项时会先校验文件类型,已有的解决方案和项目文件受覆盖保护。登记解决方案项只有在配置保存成功后才更新资源树。保存失败时保留原有登记状态,可以重试。

已有目录可以复用,目录内的文件会保留。存在同名 .cvsln 时提示打开已有解决方案或改名。提交文件时也检查同名占用,即使在点击创建后出现竞争写入,也保留先创建的文件。启动回退优先打开已有默认解决方案。新配置已经写入后取消切换,会保留新文件。

没有可用创建位置记录时,打开新建窗口就会准备 Documents 下的 ColorVision 目录并记录位置。新建窗口自动建议名称,可直接修改“项目名称”。SolutionSetting.DefaultCreatName 保留原配置键和已有自定义值,仅用于生成新建建议名,不重命名已有工作区;不为这一低频默认值提供独立设置窗口或“更多选项”入口。

管理最近列表 ​

列表搜索按名称、完整路径和显示的最后使用时间匹配,空格分隔的关键词需全部命中,不区分大小写。右键可复制路径、固定/取消固定或“从最近列表中移除”;“清空最近列表”有确认并清除全部记录,包括固定项。这些动作不删除磁盘上的工作区。显示“不可用”表示当前路径不能识别为可用工作区,移除记录不修复缺失文件。

资源管理器视图与导航 ​

主窗口以工厂注册解决方案资源管理器面板:布局恢复后首次实际可见,或用户显式显示面板时,才创建 TreeViewControl 并恢复树的展开和选择状态。隐藏或未选中的面板不会提前构造树控件;首次创建后复用实例,不以隐藏为由销毁。新手引导只定位已创建的面板,不为定位而触发加载。此边界只延迟界面:SolutionManagerInitializer、工作区目录/项目模型、文件监视和缓存仍按原有启动流程准备,供模板、文件打开、终端和 Chat 上下文使用,不能据此认为隐藏面板时完全没有目录扫描。

TreeViewControl 在同一个活动工作区内提供“解决方案”和“文件系统”两个视图,切换不会重新调用工作区打开入口:

  • 解决方案保留 Provider 项目模型、显式项目引用、虚拟文件夹和解决方案项。
  • 文件系统以工作区根目录为范围,按需加载真实目录和文件;显示实际项目文件、配置文件和隐藏项,不套用项目包含/排除或虚拟组织规则。它不代表项目引用中的外部目录。根节点不能重命名、删除或剪切,子节点沿用物理文件操作。该视图不建立第二个 Explorer、缓存或监控器;需要更新目录内容时使用“刷新”。
  • 搜索范围限于当前视图的节点名称、完整路径和显示路径。支持空白分隔的关键词及双引号短语,所有关键词都需命中,最多显示 500 项。清除搜索回到当前视图,“在解决方案资源管理器中定位”展开目标节点所在路径。修改关键词会取消上一轮搜索,切换视图或工作区会取消搜索和定位请求。
  • “与活动文档同步”根据文档服务保存的文件路径定位,兼容旧编辑器以路径作为 ContentId 的方式;不把文档的散列 ContentId 当作磁盘路径。未打开文件文档或文档不属于当前视图范围时禁用入口。
  • “全部折叠”清除搜索并折叠已加载的子节点,保留根节点展开;不为折叠而递归加载整个目录。“刷新”针对当前视图根节点。“属性”作用于单个选中节点,设置入口位于“更多选项”。
  • 自动发现模式在后台读取项目,完成后更新解决方案级“运行”和“调试”的可用状态。执行命令时按当前项目文件解析启动项目。

工具栏和树采用紧凑布局;选中行的中性灰圆角背景与左侧主题色标记固定在可见区域,横向滚动长文件名时仍保留标记。滚动条保留主题模板、拖动范围及自动显隐,由局部 ExplorerScrollBarBehavior 调整透明度,不修改全局主题资源。

解决方案树继续保存原有的展开/选中状态;文件系统视图的状态仅在当前控件生命周期保留,不覆盖解决方案状态文件。两种视图的功能边界不同,外观参考 VS 不意味着增加了 .sln 导入、Git 状态或构建/调试支持。

打开入口的区别 ​

CommandInitializer 将 ApplicationCommands.Open 接到普通文件选择器,将 SolutionWorkspaceCommands.OpenWorkspace 接到工作区列表;可配置默认键由各入口的 IHotKey 声明。资源树自己的 SolutionResourceCommands.Open 用 Enter 打开选中项,避免把树内打开混同于全局文件选择器。

将文件拖到主窗口、文档浮窗或工具面板浮窗时,当前内容优先处理拖放。内容没有处理时,窗口将文件交给工作区的统一打开路由,路由的批量失败提示以接收拖放的窗口为父窗口。工具面板的独立窗口和从布局恢复的浮窗也适用。视频文件默认通过系统关联程序打开。

入口实际分流不能混同的结果
ResourceOpenService.Open同步入口仅接受普通文件;先 FileProcessorFactory.TryOpenFileAction,未被处理才交给 EditorManager文件夹、项目、.cvsln 返回失败并要求异步入口;不是同步切换工作区
OpenAsync工作区资源交给 SolutionManager.OpenSolutionAsync;普通文件仍先文件 action 再编辑器action 已处理但失败/取消时不会继续尝试其它编辑器;也不保证编辑器的异步内容已载入
OpenInEditor仅普通文件,直接用配置的工作区编辑器,跳过独立文件 action例如 CVRAW/CVCIE 可进入工作区,而不是走独立预览
OpenWith(path, editorId)明确选择文件或文件夹编辑器,绕过工作区激活和文件 action用文本编辑器打开 .cvsln / .csproj 不会切换工作区
OpenMany / OpenManyAsync去重后逐项处理;多项时将非普通文件记为失败,继续处理其它项不是整批预检拒绝;部分成功不回滚;同步版本即使只剩一个工作区资源也不能异步激活它
OpenManyFromWorkspaceCVRAW/CVCIE 用 OpenInEditor,其它资源沿用普通同步打开与命令行或 Shell 的默认打开路线不同

Classify 先判断目录,再检查文件存在,随后判断 .cvsln 和 Provider 声明的项目模式,其余归为普通文件。未知项目格式可以出现在文本/Hex 编辑器中,不等于有项目 Provider 支持。内置 .sln 导入和 VC++ 项目 Provider 当前不存在。

OpenWith(..., setAsDefault: true) 先打开,成功后才保存默认选择。主应用配置保存失败时返回 Succeeded=true、DefaultEditorUpdated=false 和错误信息,已打开的文档保持打开。默认项缓存仅在保存成功后更新,其他配置提供者的行为见文档生命周期主题。

批量路径去掉空字符串,按绝对路径、去掉结尾目录分隔符、不区分大小写去重,保留第一个传入字符串用于实际打开和报告。这不是解析链接、硬链接或文件系统对象的真实身份。IsComplete 要求非零请求且全部成功;空集合不是全部成功。批量取消在项目前检查,可能抛出取消异常并留下之前已打开项,也可能在末项得到取消失败结果;没有批量事务。

CanOpenTogether 对多项混入工作区的组合返回 false,但 OpenMany* 自身不以此整批拒绝:图片与项目混入同一批次时,项目项记录限制错误,图片仍会尝试打开,已经打开的文件不会撤销。调用方若用 CanOpenTogether 禁用入口,则可能根本不调用打开方法;命令行的“先工作区、后文件”又是下述另一条执行链,不能只凭资源列表推断执行结果。

启动恢复与命令行打开 ​

SolutionManager 构造时接入文件路由、加载最近工作区,并在存在 Application.Current 时向 Dispatcher 安排 RestoreInitialWorkspaceAsync,保存为 InitialWorkspaceOpenTask。它优先用 solutionpath,否则尝试最近一次使用的路径;失败且没有当前/正在打开的工作区时,在用户 Documents 下建立 ColorVision/Default/Default.cvsln 并打开。取消恢复则直接返回,不进入该默认创建分支。

CommandLineResourceOpenRequest 优先选显式工作区;未指定时从资源列表找首个可激活工作区,并从普通资源列表移除同一身份路径。启动与转发使用同一个请求模型,但执行顺序不同:

  • 应用启动:SolutionManagerInitializer 的 Order=1 只安排取得单例,不等待工作区准备完成。StartupResourceOpenInitializer 在主窗口就绪且存在待打开文件时等待 InitialWorkspaceOpenTask;任务正常结束后继续打开文件,不以初始工作区是否成功激活为门槛,也不再次打开请求中的 WorkspacePath。
  • 转发到已运行的主窗口:ForwardedCommandLineHandler 调用 TryOpenCommandLineWithFeedbackAsync,先打开请求中的工作区,失败/取消就不继续打开文件。这是顺序控制,不会撤销已发生的文件操作。

取得 SolutionManager 单例、初始化器返回或转发消息被接收,都不能单独证明工作区与文件内容已经加载完成。

切换顺序与取消边界 ​

OpenSolutionAsync 先检查是否已是当前路径:相同则取消其它待打开请求并返回成功,不重新加载当前工作区。不同路径的请求建立关联 token 和递增版本,取消上一请求;新请求获胜由 token 与版本共同决定,而不是谁先读完磁盘。

正常路径为:解析目标并准备配置/项目引用 → 建候选 Explorer → 核对当前请求 → 请求关闭旧工作区关联文档 → 再核对请求 → Dispose 旧 Explorer → 替换环境、路径与当前 Explorer → 更新 MRU → 触发 SolutionLoaded。候选 Explorer 构造还会初始化 SQLite 树缓存、文件监控并可能后台重建缓存,不只是创建内存对象;缓存初始化失败会降级到文件系统加载。

  • 解析、准备失败或在替换前取消,通常保留旧 Explorer;文档拒绝关闭时释放候选并返回 Canceled=true。
  • “保留旧工作区”不等于磁盘无变化。准备文件夹/项目会生成私有 .cvsln;读取损坏共享配置可能自动从备份修复。后台准备使用 Task.Run(..., CancellationToken.None) 加 WaitAsync(token),取消等待不能回滚或强制停止已经开始的文件读写。
  • 关闭文档的确认/保存也有独立副作用,不能承诺后续取消会撤销已保存文件。具体顺序见文档生命周期主题。
  • 提交后通知不是事务。CurrentWorkspaceChanged、MRU 的 Changed 和 SolutionLoaded 使用同步事件调用;订阅者抛异常可能发生在新工作区已经安装后。部分异常被转换为失败,其它异常可继续向上传播,没有恢复旧 Explorer 的统一补偿。

TryCloseSolution 先取消待打开请求,再请求关闭当前工作区关联文档;拒绝关闭保留当前 Explorer。成功则 Dispose Explorer、清活动路径与环境并发出 SolutionClosed。关联范围来自根目录、配置文件、树中项目目录/项目文件、解决方案项及不可用项目的已解析路径,不简单等于“关闭所有标签页”。外部项目引用也可能属于这个范围。

CreateSolutionAsync 先建目录、写 <目录名>.cvsln 并发出 SolutionCreated,之后才尝试打开;没有“仅当目标不存在”门禁。打开被取消/失败,不撤销已创建或替换的配置。

共享配置与机器私有状态 ​

资料位置和身份当前责任
用户显式 .cvsln用户选中的文件;RootPath 可与配置文件目录不同根路径、项目引用、启动项目、配置/平台、虚拟文件夹和解决方案项
文件树 SQLite 缓存当前 .cvsln 文件路径加 .cache.dbSolutionCache 的目录项缓存;显式共享工作区可在其源目录旁生成,并非一律位于用户私有状态目录
文件夹私有 .cvsln%LOCALAPPDATA%/ColorVision/FolderWorkspaces/<key>.cvsln文件夹激活所需配置,不在源目录新建 .ColorVision.cvsln
项目私有 .cvsln%LOCALAPPDATA%/ColorVision/ImplicitSolutions/<key>.cvsln直接打开项目时建立 Explicit 配置,登记项目并设为 StartupProject
树呈现状态%LOCALAPPDATA%/ColorVision/SolutionState/<key>.json展开节点、选中项、anchor;不是项目定义或文档内容
最近工作区Environments.DirLocalAppData/Solution/recent-workspaces.json最近使用时间与固定项,不是配置备份或当前打开成功的证明
停靠布局与编辑器默认项各自独立存储见文档生命周期与配置主题,不混入 .cvsln

文件树缓存的增量写入与全量扫描使用同一内部文件过滤规则,工作区配置、备份及原子保存临时文件不进入目录项缓存。目录校验遇到旧缓存中的此类文件记录时,仅清除对应缓存行,不删除实际文件或同后缀的真实目录;其它文件系统变化仍会使校验失败。打开已有缓存先轻量核对必需列和主键,结构完整时复用现有表;首次创建或缺少字段时仍执行原有表结构初始化与升级。折叠目录内新建或移入的文件在展开后按实际目录层级显示。

私有工作区 key 来自规范化源路径转大写后的 MD5。WorkspaceSourceKind / WorkspaceSourcePath 保存来源;解析回原路径还要求私有目录、类型、源资源存在和期望文件名同时匹配,不能凭同名字段任意重定向。旧源目录的 .ColorVision.cvsln 可作为兼容输入读取,失败则记录日志并用新配置建立私有文件;不是删除旧文件或把新状态继续写回源目录。

“打开文件夹不新建源目录配置”不能扩大成任何打开都只读:显式 .cvsln 可能被恢复、配置编辑会保存;项目文件 Provider 也有独立契约。工作区 RootPath、项目引用和解决方案项不是权限白名单。

cvsln 版本、保存与恢复 ​

SolutionConfigStore.CurrentSchemaVersion 当前为 4,按 v0→v1 项目模式/配置、v1→v2 虚拟文件夹、v2→v3 解决方案项、v3→v4 平台逐步迁移。正常 Load 在内存迁移和规范化,后续 Save 才写当前结构。未来版本抛 NotSupportedException,不当作损坏文件自动回退旧备份。

Explorer 自动选启动项目和退出保存前,核对磁盘配置是否仍为本次加载或上次保存的内容。内容已更改或移除时跳过自动选项。退出时未改动的配置直接跳过,有本地改动且磁盘已更改时,保留磁盘文件并将本地草稿另存为同目录的 .cvsln.conflict-*,日志记录位置。释放 Explorer 时解除退出订阅。

Save 先规范化传入配置,再写同目录临时文件、Flush 到磁盘;已有主文件使用 File.Replace 留 .bak,平台不支持 Replace 时回退复制备份再覆盖移动。它是单个配置文件的提交,不是配置、项目文件、文档和内存的跨资源事务。

Load 仅在主配置缺失或已读到损坏内容时尝试 .bak。占用、权限等读取错误保留原始诊断。恢复缺失主文件时以新建方式提交,恢复损坏文件时核对已读内容,并在替换时保留 .corrupt-* 原文件。若此时已有其他写入者提交新配置,读取新主文件。成功从备份写回才返回 RecoveredFromBackup=true,原 .bak 保留。备份读取、解析或提交失败会报告错误,内部异常可用于区分故障阶段。

MRU 与树状态 ​

MruPathService 默认容量50,按规范化路径去重;固定项全部保留,非固定项填剩余容量,所以固定项过多时总数可以超过50。Touch 可同时去掉路径别名。更新先改内存,IsStorageException 识别的持久化异常只记日志,之后仍通知 Changed;订阅者正常返回时最终返回 true,它不是“已成功写入磁盘”的返回值。未捕获的存储异常或 Changed 订阅者异常仍会抛出,已更新的内存不回滚。移除历史/清空列表不删除工作区或项目文件。

JsonMruPathStore 用临时文件加覆盖移动保存,没有 .bak 恢复链;未知版本/坏 JSON 返回空列表。SolutionWorkspaceStateStore 则按 .cvsln 绝对路径的 SHA-256 命名状态文件,版本不支持或读取失败也返回未持久化的空状态。这些静默回退不能证明用户从未配置过状态,也不能替代共享配置的失败诊断。

项目 Provider 与扩展归属 ​

ProjectProviderRegistry 扫描 [ProjectProvider] 的 IProjectProvider,并监听新程序集加载。注册按不区分大小写的 Provider Id 替换,优先级降序选择;声明文件模式与实际 CanLoad / Load 是不同门槛,插件未装或类型不匹配会产生可诊断的不可用项目,不应偷偷当普通文件夹使用。

工程 Provider、模板、菜单和编辑器发现会跳过注解无法读取的扩展,并继续注册同一程序集中的其他可用类型。诊断输出给出扩展类型、注解和加载错误。

  • FolderProjectProvider 负责 .cvproj JSON,兼容旧文件缺失的 ProjectType,并支持自己的项目项/依赖修改和命令定义。
  • MsBuildProjectProvider 只读接入 .csproj、.fsproj、.vbproj 的 XML 字面信息,不执行完整 MSBuild import/条件求值,也不提供改写项目文件接口。只读适配器仍可提供生成/运行命令,不能把“只读解析”理解为整个模块绝不会启动进程。
  • SolutionFeatureVisibility.ShowBuildAndDebugUI 当前固定 false,隐藏生成/运行/调试 UI;底层能力和命令仍存在,这不是执行权限沙箱或删除了相关实现。命令提交、退出与业务成功按终端主题分别核实。
  • 新项目/文件模板分别由 Explorer/ProjectTemplate.cs 的 IProjectTemplate / ProjectTemplateAttribute、Explorer/NewItemTemplate.cs 的 INewItemTemplate / NewItemTemplateAttribute 扩展;不是在资源打开路由里添加业务 switch。菜单、项目 Provider 和编辑器是三种不同扩展点。

移除引用、删除文件与撤销 ​

资源树的操作取决于选中节点类型。单选时查看右键菜单的“删除”“从解决方案中移除”或“移除解决方案文件夹”,不要仅凭图标判断磁盘影响。

节点或操作实际影响
Explicit 模式的项目节点、解决方案项从 .cvsln 移除引用,保留项目文件、目录和被引用文件
虚拟解决方案文件夹移除虚拟分组,子文件夹、项目与解决方案项移到上一层,不删除物理目录
普通物理文件/目录、AutoDiscover 模式的可删除项目目录调用 Windows 回收站删除流程,影响磁盘内容;文件系统视图中的项目文件也只是物理文件
多选删除跳过已选祖先下的子项,确认并关闭相关文档后按工作区处理。部分完成时按磁盘状态更新物理节点,并列出未完成项
撤销/重做SolutionOperationHistory 保存最多 100 项配置快照;只恢复被记录的 .cvsln 配置变化,不提供磁盘删除、外部命令或任意项目文件修改的恢复

文件系统视图根节点禁止重命名、删除和剪切,解决方案根节点也有自己的能力限制。物理操作入口集中在 SolutionResourceCommands、SolutionPhysicalItemOperations、SolutionClipboardFileOperations 与 SolutionBatchDeleteService;虚拟组织和配置变更由 Explorer 分部处理。恢复已删除文件应检查实际回收站或备份,不能把配置撤销当作文件恢复。

粘贴或拖放复制文件夹时,复制完整后才在目标目录发布,遇到同名项自动编号。复制失败只尝试清理本次临时目录。复制和移动均保留源文件夹名,路径尾部有分隔符也适用。

通过物理文件夹的“添加现有项”导入文件时,覆盖选项保护本次选中的源文件。已在目标目录中的选中文件直接保留,另一个同名输入会报告冲突。

从资源树剪切后部分移动成功时,剩余剪切项只包含失败路径;再次粘贴不会移动已完成路径上后来创建的文件。剪贴板被占用时,本进程保留剩余项以便重试。操作完成只更新原剪切内容,保留后来复制或剪切的内容。

验证入口与缺口 ​

在实际运行窗口核对点击行为。

工作区切换竞争、同名目录覆盖及配置恢复应使用合成工作区与独立状态目录复核。分别核对返回值、内存状态和实际文件,涉及删除或执行项目命令时使用受控环境。

实际拖放、剪贴板交互和跨卷操作需单独验证。

基于 MIT License 发布。