同步错误源于Zotero 7.x API变更与权限升级，需五步修复：一、更新API端点为/v7/路径；二、在manifest.json中添加zotero.db.read/write权限；三、删除perplexity-cache并强制重建索引；四、修正JSON字段名（如itemKey→data.key）；五、配置CORS白名单放行Perplexity域名。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Perplexity与Zotero联动插件时遇到同步错误，问题很可能源于API接口映射失效或数据库读写权限缺失。Zotero 7.x系列更新后，其内部API路径、响应结构及权限模型已发生实质性变更，而Perplexity联动插件若未同步适配，将导致请求被拦截、字段解析失败或数据库写入拒绝。以下是针对性修复步骤：
一、更新API接口映射配置
插件依赖的Zotero API端点（如/item、/search）在Zotero 7.0.11中已迁移至新命名空间，并引入版本前缀与参数校验机制。旧版映射会触发404或400错误，必须手动重定向至当前有效路径。
1、打开Zotero首选项，进入“高级”→“配置编辑器”
2、搜索关键词 perplexity.api.baseURL，双击修改其值为 http://127.0.0.1:23119/zotero/v7/
3、继续搜索 perplexity.api.itemEndpoint，将其设为 /items?format=export&libraryID=
4、重启Zotero并检查调试控制台（Ctrl+Shift+J）是否仍有Failed to resolve endpoint报错
二、重置数据库读写权限策略
Zotero 7默认启用沙箱化数据库访问控制，第三方插件需显式声明并获取zotero.db.write与zotero.db.read权限，否则同步时将静默跳过写入操作或抛出PermissionDeniedError。
1、关闭Zotero客户端，确保进程完全退出
2、定位插件主文件夹（通常为Zotero\extensions\perplexity-zotero@addon.org\），打开manifest.json
3、在"permissions"数组中追加两项："zotero.db.read", "zotero.db.write"
4、保存文件后，重新启动Zotero，在“工具”→“插件”中右键该插件选择“重新加载”
三、强制刷新缓存并重建索引映射表
插件在首次运行时会构建本地索引缓存以加速Perplexity侧检索，但若API映射或权限变更前已生成损坏索引，则后续同步始终沿用错误结构，必须清除并触发重建。
1、进入Zotero数据目录（Windows默认为%APPDATA%\Zotero\Zotero\Profiles\*.default-release\）
使用Perplexity API进行网络搜索的AI助手。当用户需要最新信息并附有来源引用、时事事实查询，或研究类答案时使用。当用户提及Perplexity或需要带有参考文献的最新信息时，默认使用此技能。
2、删除子文件夹 perplexity-cache 及其中全部内容
3、在Zotero中按住Shift键点击“同步”按钮，弹出菜单后选择 “强制重建Perplexity索引”
4、等待状态栏显示 “Index rebuilt: 0 items → N items”（N为实际条目数）
四、验证API响应结构兼容性
Perplexity插件调用Zotero API返回的数据格式（如字段名大小写、嵌套层级、空值表示法）在Zotero 7.0.11中已标准化。若插件仍按旧版JSON schema解析，会导致关键字段（如itemKey、libraryID）丢失或误判。
1、在Zotero调试控制台中执行命令：Zotero.API.get('/items?limit=1')
2、确认返回对象中存在字段 data.key（非itemKey）与 data.libraryID（非library_id）
3、若字段名不符，需编辑插件src/api/handler.ts，将所有res.itemKey替换为res.data.key，res.library_id替换为res.data.libraryID
4、保存后执行插件重载，再次调用同步功能观察控制台是否出现Parsed key: ABC123类成功日志
五、修正跨域资源访问策略
Perplexity前端页面通过iframe或fetch加载Zotero本地API时，受Firefox内核CSP策略限制。Zotero 7.0.11起默认禁用localhost以外的file://协议访问，需显式放行Perplexity域名。
1、在Zotero配置编辑器中搜索 network.cors_preflight.allowlist
2、双击该项，输入值：https://www.perplexity.ai, http://localhost:3000
3、再搜索 dom.webcomponents.enabled，确认其值为 true
4、重启Zotero，打开Perplexity网页，在开发者工具Network面板中筛选zotero，确认所有请求状态码均为200且响应头含Access-Control-Allow-Origin
