# 插件权限、隐私与故障排查

了解浏览器扩展权限、本地草稿期限、图片缺失及常见采集和安装故障。

官方地址：https://help.citeweave.cn/extension/troubleshooting/

功能标识：`connector.troubleshoot` · 适用版本：0.1.1 · 最近核验：2026-10-28

## Firefox 旧版本兼容问题

若 0.1.0 在正常正文页仍提示检查登录或验证，请先更新至 0.1.1 并重载扩展、刷新原文页。已修复 Firefox 隔离执行环境的两处兼容问题；不要为此导出 Cookie 或反复执行验证码。新提示中的方括号是错误代码，可随浏览器/扩展版本报告。

## 从失败的位置开始排查

| 现象 | 处理方式 |
| --- | --- |
| 无法安装或找不到 Manifest | 解压 ZIP，选择直接包含 `manifest.json` 的目录；检查浏览器版本和包类型。 |
| Firefox 重启后扩展消失 | 本次为未签名临时安装，每次重启后重新加载 Firefox 包。 |
| 浏览器拒绝开发者模式 | 受组织策略管理时联系管理员，不要绕过机构安全策略。 |
| 按钮显示 `!` | 悬停查看原因；确认不是验证码、登录页、内部页面，等待正文加载后再试。 |
| 正文无法定位或过短 | 此页面结构可能暂不支持。先从源站正常打开原文，再尝试；不要连续重试挑战页。 |
| 容量不足或资源超限 | 先完成已有草稿的保存；内容或图片过大时不会无限制采集。最多 4 篇本地草稿，24 小时过期。 |
| 图片未采集 | 原图跨域、未加载、来源不明或过大时会降级；扩展不会代理下载或绕过跨域限制。 |
| 导入页没有交接信息 | 回原文再次点击扩展，保留新打开地址的片段；检查安装的是否为本站默认配置版本。 |
| 页面要求登录 | 在研思网页正常登录。不要向扩展或第三方提供密码、Token 或 Cookie。 |
| 保存结果未知或冲突 | 按[保存流程](https://help.citeweave.cn/extension/use/#%E4%BF%9D%E5%AD%98%E5%BC%82%E5%B8%B8%E5%A6%82%E4%BD%95%E5%A4%84%E7%90%86)继续原请求或重新读取课题。 |

## 权限各自用于什么

| 权限或范围 | 实际用途 |
| --- | --- |
| `activeTab` | 用户点击扩展按钮后，临时访问当前标签页。 |
| `scripting` | 在获准的当前页面提取顶层文章正文。 |
| `storage` | 在浏览器本地保存待交接草稿，不使用同步存储。 |
| `alarms` | 安排过期草稿清理；浏览器暂停或关闭期间不能准点清理。 |
| 研思 `/imports/*` 页面内容脚本 | 只在研思导入流程中交接本次草稿；不会在源文章页面接收此交接。 |

没有请求全站后台读取、浏览历史读取或源站 Cookie 读取权限。Firefox 对网站内容的数据用途有声明。安装时请核对名称、版本及来源。

## 上传与隐私边界

采集先保存在本地。你在研思导入页确认后，正文、来源及可采集的图片等本次内容才上传，用于后台识别。保存到课题需要网页中的研思会话，扩展不读取研思认证凭据。

扩展会尝试清除来源 URL 中常见的凭据参数，但无法承诺识别所有私人信息。正文或普通链接可能仍包含敏感内容，上传前请检查。不要公开本地草稿、交接地址、账号凭据或私人课题内容。

扩展不抓取后台页面，不绕过付费墙、验证码和访问控制；你应遵守源站使用条件。主站和源站异常时，帮助中心仍可独立阅读。

## 报告问题时提供什么

记录浏览器名称和版本、扩展版本、失败步骤及不含私人信息的错误文字。截图请遮盖账号、私人正文和地址中的交接片段。不要公开整份草稿或认证信息。