ContextMenu Manager Plus 排错指南快速定位前后端连接失败、服务安装失败等常见问题【免费下载链接】ContextMenuMgrContext Menu Manager Plus 是一个强大的实用程序它可帮助您管理 Windows 上的右键菜单并避免第三方向你的右键菜单里塞屎项目地址: https://gitcode.com/gh_mirrors/co/ContextMenuMgrContextMenu Manager PlusContextMenuMgr是一款 Windows 右键菜单管理工具采用后端服务 前端界面 托盘宿主的架构。当它出现前后端连接失败、服务安装失败、托盘图标消失等问题时本指南帮你快速定位原因并给出修复方向。核心思路只有一条先看日志再动手——日志文件位置与常见问题对照表见下文。 第一步找到 ContextMenu Manager Plus 的日志文件排查任何问题前先确认日志目录。日志路径由包类型决定安装包版与便携版不同路径定义见 RuntimePaths.cs包类型日志目录安装包版Installer%ProgramData%\ContextMenuMgr\Logs便携版Portable应用目录\Data\Logs主要日志文件一览日志文件记录内容frontend-debug.log前端启动、导航、管道pipe调用等frontend-crash.log前端未处理的异常崩溃backend.log后端服务、注册表操作、Win11 菜单、监控trayhost.log托盘进程、通知、后端断开事件 小提示旧版本可能把数据放在%LOCALAPPDATA%\ContextMenuMgr等旧位置排查历史安装时可顺带检查这些目录。 快速对照表症状 → 最可能的原因不确定属于哪一类问题时先按这张表对号入座完整细节见官方排错指南症状最可能的原因优先查看的日志前端提示后端不可达 / 一直转圈服务未安装或未运行、管道未启动frontend-debug.log、backend.log安装/修复服务失败、UAC 后无反应用户取消 UAC、便携版文件被 Windows 锁定frontend-debug.log前端启动后退出、页面空白后端返回异常、JSON 状态损坏frontend-crash.log、backend.log托盘图标缺失、没有通知服务未能在用户会话中启动 TrayHosttrayhost.log、backend.log登录后没有托盘服务启动模式与随 Windows 启动设置不一致backend.log编辑菜单项报注册表保护错误注册表写保护Registry Write Protection开启backend.log️ 前端无法连接后端ContextMenu Manager Plus 连接失败怎么办现象前端显示后端不可达、加载占位数据、或等待管道超时。常见原因按概率排序Windows 服务未安装或未运行UAC 安装弹窗被取消服务实际没装上管道Named Pipe服务未启动服务程序路径配置错误排查步骤打开设置页确认服务状态显示为运行中若服务异常尝试安装/修复服务确认系统服务中ContextMenuManagerPlus.Service.exe路径正确查看frontend-debug.log与backend.log中的引导bootstrap结果记录。涉及的关键源码BackendServiceManager.cs、NamedPipeBackendClient.cs、NamedPipeBackendServer.cs。⚠️ 后端服务安装/修复失败UAC 被拒绝、没有响应现象弹出 UAC 后仍无法安装服务或直接返回失败码。可能原因用户取消了 UAC、服务路径无效、权限不足、结果文件写入失败。特别常见的一种情况——便携版文件被 Windows 锁定Mark-of-the-Web从浏览器下载的便携版压缩包可能带有来自网络的标记Windows 有时会把该标记传播到解压后的.exe/.dll文件上文件属性页会显示此文件来自其他计算机可能已被阻止。此时通过 UAC 启动服务安装器可能表现为UAC 被拒绝、没有结果文件、或等待超时。推荐修复方式最简单右键下载的 zip 压缩包 →属性勾选解除锁定Unblock→ 应用重新解压再执行安装也可以对已解压的目录用 PowerShell 一行解锁Get-ChildItem -LiteralPath 便携版目录 -Recurse -File | Unblock-File如果应用自身检测到该问题设置页的服务区域会显示便携版文件阻止警告并提供解除便携版文件阻止并重试按钮。涉及的关键源码BackendServiceBootstrapper.cs、AutoStartService.cs。 前端退出、页面空白或报 JSON 错误现象前端启动后退出、页面空白、快照加载失败或出现 JSON 解析错误。重要判断技巧如果Ping成功但读取菜单快照时报 JSON 错误例如 JSON 未闭合说明服务与管道本身仍然可用不要急于重装或强力修复服务。更常见的原因是本地状态文件context-menu-state.json损坏后端会自动把损坏文件隔离到Quarantine\corrupt-state-...目录若存在有效的.bak备份会自动恢复没有备份时会从当前注册表安全重建基线到backend.log中确认ContextMenuStateCorruptionDetected、ContextMenuStateRecoveredFromBackup等记录即可。涉及的关键源码ContextMenuWorkspaceService.cs、ContextMenuStateStore.cs。 TrayHost 托盘图标不出现怎么办现象系统托盘没有图标新增菜单项没有通知。可能原因服务没有在你的用户会话中启动 TrayHost随 Windows 启动相关策略关闭会话Session识别错误TrayHost 启动后连接后端失败排查步骤查看trayhost.log与backend.log确认服务是否拿到了你当前登录的活动会话不要在服务会话里尝试显示托盘界面这是无效操作。涉及的关键源码FrontendAutostartLauncher.cs、TrayHostRunner.cs、BackendWindowsService.cs。 开机启动不生效登录后没有托盘现象服务启动模式或随 Windows 启动设置看似正确但登录后托盘不出现。排查思路把用户意图设置项与系统实现SCM 服务 管道分开检查查看backend.log中的ConfiguredStartType、CurrentStatus、StopReason等记录若出现StopReasonStartupFailure检查服务是否按失败恢复策略自动重启服务程序位于非系统盘/网络盘时后端会自动使用延迟自动启动来规避开机早期磁盘不可用的问题只有服务真正 Running 且 Ping 成功后开机策略才会被提交。涉及的关键源码ServiceLifecyclePolicy.cs、SettingsPageViewModel.cs。 Win11 新菜单禁用后刷新状态又丢了现象在 Windows 11 新菜单页禁用某项后短暂生效刷新快照后又显示为启用。可能原因写入了错误的用户注册表 hive、用户上下文userContext丢失、CLSID 规范化不一致。修复方向确认写入路径应为HKEY_USERS\用户SID\Software\Microsoft\Windows\CurrentVersion\Shell Extensions\Blocked且快照读取必须携带同一用户上下文。相关日志关键词Win11ContextMenuSetEnabled、Win11UserBlockedRead。 编辑菜单项报注册表保护错误现象启用、禁用或删除菜单项时报注册表保护错误。原因Registry Write Protection注册表写保护处于开启状态阻止了对受保护菜单注册表路径的写入——这是软件自身的保护功能在生效不是系统故障。正确做法️到设置页暂时解锁并确认切换成功后再操作完成后重新开启保护即可。切勿把它与 ShellNew 顺序锁等其它 ACL 机制混淆也不要手工修改保护设置 JSON。相关切换日志关键词RegistryProtectionTransitionStarted/RegistryProtectionTransitionCompleted。详见 registry-model.md。 深度分析Deep Analysis报错ProbeHost 缺失或架构不匹配现象深度分析返回MissingX86ProbeHost、MissingX64ProbeHost、ProbeHostNotFound或ArchitectureMismatch等错误。可能原因原生 ProbeHost 未构建/未复制到ProbeHost\架构目录或发布包缺少目标架构x86 / x64 / arm64。重要提醒深度分析是尽力而为的辅助功能它的失败通常不影响普通菜单管理无需紧张。可按实现说明检查对应架构目录下的ContextMenuMgr.ProbeHost.exe是否存在。涉及的关键源码ContextMenuDeepAnalysisService.cs、ProbeHost 源码。 第三方软件装不上先别急着归因安装第三方软件或驱动时出现问题不要默认归因到 ContextMenu Manager Plus。建议的归因顺序确认注册表写保护或 ShellNew ACL 锁是否开启找到对应时间点的backend.log/frontend-debug.log记录确认目标注册表路径是否属于本项目的保护范围没有 Access Denied 日志或路径证据时不做结论必要时可临时关闭保护做 A/B 验证。详细流程见 AI 与维护者接手 Playbook。 提交 Issue 前建议附上的材料遇到本文未覆盖的问题提 Issue 时附上以下信息会大大加快排查Windows 版本与软件版本出问题的菜单项名称 / 注册表路径三份日志frontend-debug.log、backend.log、trayhost.log复现步骤 截图 延伸阅读docs/troubleshooting.md —— 完整排错指南含全部 19 类问题docs/developer-guide.md —— 开发者指南docs/process-and-privilege-flows.md —— 进程、权限与用户上下文链路docs/registry-model.md —— 注册表模型与右键菜单实现原理【免费下载链接】ContextMenuMgrContext Menu Manager Plus 是一个强大的实用程序它可帮助您管理 Windows 上的右键菜单并避免第三方向你的右键菜单里塞屎项目地址: https://gitcode.com/gh_mirrors/co/ContextMenuMgr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
