Zotero连接器在Chrome中显示“未安装”或无法识别浏览器

Question

Zotero连接器在Chrome中显示“未安装”或提示“无法识别浏览器”，是用户最常遇到的集成故障之一。典型表现为：Zotero桌面端状态栏图标呈灰色、右键菜单无“保存到Zotero”选项，且Chrome扩展管理页中虽显示Zotero Connector已启用，但Zotero主程序仍报错。常见原因包括：① Chrome与Zotero版本不兼容（如新版Zotero 7要求Chrome 110+）；② 扩展被企业策略/组策略禁用（尤其在Windows域环境或学校/公司设备）；③ Zotero桌面端未运行，或运行但未监听默认IPC端口（需检查首选项→高级→网络设置）；④ 浏览器沙盒限制或第三方安全软件拦截本地通信。值得注意的是，Chrome的“允许访问文件网址”权限缺失、扩展被误设为“仅在特定站点运行”，或使用了非官方打包版Zotero（如某些Linux发行版仓库版本），亦会导致识别失败。该问题非单纯重装可解，需系统性验证通信链路与权限配置。

Answer 1

```html

一、现象层：确认故障表征与基础状态校验

首先验证Zotero Connector在Chrome中是否真实“可见但不可用”：打开 chrome://extensions，确认Zotero Connector状态为「已启用」且版本号非灰色（如显示v6.0.31）；同时检查Zotero桌面端右下角系统托盘图标——若呈灰暗无响应态、右键无「Save to Zotero」菜单、主界面顶部「File → Save to Zotero」置灰，则表明IPC通信链路已中断。此阶段不操作、不重装，仅做可观测性断言。

二、兼容性层：跨版本握手协议校验

Zotero 7.x 要求 Chrome ≥110（含M110+稳定版），而Zotero 6.x 最高兼容至 Chrome 109。可通过以下命令快速验证：

chrome://version  → 记录「Google Chrome」版本
zotero --version（Linux/macOS终端）或「帮助→关于Zotero」→ 查看构建号

关键点在于：Zotero Connector扩展与Zotero桌面端通过JSON-RPC over HTTP本地IPC通信，其底层依赖Chrome的nativeMessaging API，该API在Chrome 110+中重构了权限模型与清单v3适配逻辑。若版本错配，Zotero主程序日志（Help → Show Log）将出现Native application not found: zotero错误。

三、策略层：企业级管控穿透分析

在Windows域/EDU/Corp设备中，常见组策略路径：Computer Configuration → Administrative Templates → Google → Google Chrome → Extensions → Configure extension installation allowlist。若该策略启用且未显式添加efaidnbmnnnibpcajpcglclefindmkaj（Zotero Connector官方ID），则Connector会被静默禁用——此时扩展页仍显示“已启用”，但Chrome进程实际拒绝加载其native host manifest。

检测项	Windows命令	预期输出
策略是否生效	gpresult /h gp.html && start gp.html	查看「Google Chrome Extension Installation Allowlist」条目
Native Host注册状态	reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Google\Chrome\NativeMessagingHosts\zotero"	应返回REG_SZ值指向zotero.json绝对路径

四、通信层：IPC通道全链路诊断

Zotero Connector与Zotero桌面端通信依赖三层结构：① Chrome调用chrome.runtime.sendNativeMessage → ② Chrome启动zotero native host进程（由zotero.json声明） → ③ 该进程向Zotero监听的http://127.0.0.1:23119（默认端口）发起HTTP POST。任一环节断裂即导致「未安装」假象。验证流程如下：

flowchart TD A[Chrome扩展] -->|sendNativeMessage| B[Native Host zotero.exe] B -->|HTTP POST| C[Zotero Desktop IPC Server] C -->|Response| B B -->|JSON-RPC| A style A fill:#4CAF50,stroke:#388E3C style C fill:#2196F3,stroke:#1976D2

五、权限层：沙盒逃逸与安全软件干预

Chrome的--no-sandbox参数虽可绕过部分限制，但属高危操作，不推荐生产环境使用。更稳妥方案是检查三项关键权限：

1. 在chrome://extensions中点击Zotero Connector「详情」→ 开启「允许访问文件网址」
2. 确认扩展运行范围为「在所有网站上」而非「仅在特定网站上」
3. 临时禁用Windows Defender「基于信誉的保护」或第三方杀软（如McAfee、Kaspersky）的「Web防护」模块，因其常拦截zotero.exe与chrome.exe的本地socket通信

六、分发层：非官方包陷阱识别

Ubuntu/Debian仓库中的zotero包（如apt install zotero）、Arch AUR中非zotero-bin包、或国内镜像站提供的「绿色版」，普遍存在以下风险：

• 缺失zotero.json native messaging manifest文件
• 打包时未签名，触发Chrome v111+的Manifest V3严格校验失败
• IPC端口被硬编码为23118等非标准值，与Connector内置端口不匹配

解决方案：卸载系统包，从zotero.org/download下载官方签名安装包（SHA256校验值公开可验）。

七、日志层：结构化排障证据链构建

必须采集三方日志形成交叉验证：

• Zotero Log（Help → Show Log）：搜索NativeMessaging、IPC server started、Failed to connect
• Chrome Extension Log：按F12 → Console，过滤zotero，观察native port error类报错
• Native Host Stderr（Windows）：运行zotero.exe --verbose，捕获进程启动时的DLL加载失败或端口拒绝连接信息

```