STEP 01
打开扩展管理页
复制下面的地址，粘贴到浏览器顶部地址栏，按 Enter。
chrome://extensionsEdge 使用：
edge://extensions地址要放在顶部地址栏，不是网页里的搜索框。
首次安装
适用于 Chrome / Edge · macOS / Windows推荐：让助手准备安装文件。
从个人网站下载对应系统的「安装与更新助手」，macOS：打开 PKG，在「目的宗卷」选择 Macintosh HD，完成助手安装；这里不能选具体文件夹。随后在 Finder →「应用程序」中打开 Page Annotator Installer，再选择插件文件夹。Windows：解压助手 ZIP 并运行安装程序。选择插件文件夹后，助手会创建 Page Annotator 文件夹，自动下载、校验和解压插件，并配置以后的一键更新。无需复制扩展 ID。
随后会自动打开引导页，显示你的具体安装路径。按图开启浏览器的开发者模式，加载该文件夹即可。插件 ZIP 无需手动下载或解压。
已有用户请选择原插件文件夹，助手只连接原位置，不覆盖原文件。下载助手来自 zhengyangli.com/made。私人云同步版仍使用下方手动安装流程。
打开助手，选择文件夹助手自动准备文件
浏览器加载按自动打开的指引操作
手动安装：先解压，再加载。
将下载的 ZIP 解压到「文档」等长期保留的位置。安装后请保留这个文件夹，不要移动、改名或删除。
下载的 ZIP先解压
固定文件夹之后从这里加载
STEP 02
打开开关，加载扩展
先打开「开发者模式」，再点击「加载已解压的扩展程序」。
Chrome 通常在右上角开启开发者模式。Edge 的开关可能位于左侧栏，按钮名称也可能显示为「加载解压缩的扩展」。
英文界面：
Developer mode → Load unpacked
STEP 03
选中正确的文件夹
选择直接包含 manifest.json、src、icons 的那一层文件夹，然后确认。
选的是整个文件夹：不要选 ZIP，也不要选单个 manifest.json 文件。
如果打开后只看到另一个同名文件夹，请再进入一层检查。
manifest.json。图中的文件夹名称仅为示例。看到「页面标注」卡片，就安装好了。
可在工具栏的扩展菜单中固定图标；刷新安装前已打开的网页。
更新已有版本
个人网站下载 · macOS / Windows · Chrome / Edge配置一次，以后点一下就好。
离线版新增更新助手。无需每次导出 JSON：助手自动备份，在原文件夹安装更新，学习数据保留在原浏览器。私人云同步版仍采用下方手动覆盖方法。
立即更新下载 · 校验 · 自动备份
重启浏览器更新完成后操作
首次配置 / 01
打开插件里的「更新」
点击浏览器工具栏的页面标注图标，在顶部找到「更新」，进入更新页面。
没有「更新」入口，或助手提示旧版不支持连接？请先按下方「手动更新」覆盖一次新版，再连接助手。保留原路径，不卸载插件；原有学习数据继续保存在浏览器中。
首次配置 / 02
运行安装与更新助手
从官网下载对应系统的助手。macOS：运行 PKG，在「目的宗卷」选择 Macintosh HD 完成助手安装，再从 Finder →「应用程序」打开 Page Annotator Installer；此时才选择插件文件夹。Windows：解压助手 ZIP，打开「安装更新助手.cmd」。选择浏览器正在使用的原插件文件夹。助手会自动关联，无需复制扩展 ID。
macOS 安装包已完成 Developer ID 签名和 Apple 公证。Windows 尚未完成代码签名，可能出现 SmartScreen 提示，尚待实机验证。无需安装 Python 或 Node。
返回更新页面，点击「重新连接」。
看到「更新助手已连接」即完成。使用同一个安装目录时，Chrome / Edge 无需分别输入 ID。
以后更新 / 01
点击「立即更新」
检查更新，阅读本次变更后点击按钮。后台会下载、校验并自动备份。
以后更新 / 02
等待「更新完成」
可以关闭更新页面，但更新期间请不要退出浏览器。失败时会说明原因，不把下载成功当成安装完成。
以后更新 / 03
重启浏览器
退出整个浏览器，再重新打开。原标注与学习记录保留，无需导入文件。
首次接入或助手不可用：手动更新
- 将新插件解压，覆盖原安装文件夹
在官网展开「其他方式：手动下载插件 ZIP」获取新版。将 ZIP 内的文件复制到浏览器正在使用的原插件文件夹并替换同名文件；不是把新版文件夹再套进原文件夹。保留原路径和 manifest.json 层级，不要移动原目录或移除原扩展。覆盖更新不会主动删除浏览器内的学习数据。
- 重新加载原扩展
在扩展管理页点击原「页面标注」卡片的环形箭头，然后重新打开网页。首次增加更新助手权限时，按浏览器提示确认。再运行助手，选择同一个原插件文件夹，返回插件的「更新」页点击「重新连接」。
自动备份保存在本机。
位于原插件文件夹的
位于原插件文件夹的
.pa-updater/backup-时间戳/，包含旧版文件与学习数据 JSON。更新不会上传你的学习数据。网络或校验失败不会替换插件；写入失败会尝试恢复旧文件。意外关闭后，重新连接助手会先恢复未完成的更新。不要通过卸载来更新。每一次变化，都有记录。
版本 · 日期 · 更新内容同版本补充更新归入对应版本；下次升级会新增记录，并保留已有历史。
离线版 0.10.5
- 复习前检查原页面是否已删除；页面内容变更时提供处理提示。已标记页面移出复习队列，历史资料继续保留。
- 学习历史支持查看已标记页面、导出单页历史资料，以及确认后彻底删除该页；复习队列按最久未更新排序。
- 同版本界面更新：弹窗精简为同步、开始学习、操作说明和学习历史四部分，较少使用的快捷键可展开查看。
- 同版本说明更新：明确选中文字即可唤出标注工具，补充删除规则、复习掌握条件和保留数据的更新步骤。安装包新增独立更新记录。
- 同版本文档更新：安装与更新、使用方法拆成两份可离线阅读的 HTML；加入地址栏、开发者模式、文件夹选择、重新加载与选词标注图示。版本记录并入安装说明，不再提供 Markdown 说明文件。 修正窗口图示标题与左上角三个圆形按钮重叠的问题，标题统一置于按钮右侧。
- 新增个人网站一键更新入口：首次连接 macOS / Windows 更新助手后，自动校验签名、备份数据并更新原文件夹，完成后重启浏览器。
- 助手升级为安装与更新助手：首次选择安装位置后自动下载、校验和解压插件，自动关联扩展 ID，并打开带安装路径和图示的浏览器加载指引。
- 同版本安装引导更新：macOS PKG 介绍页和中日英说明明确区分助手安装磁盘与插件文件夹；完成安装后从 Finder 的应用程序打开 Page Annotator Installer，再选择插件位置。
- 同版本说明统一：插件更新页面、安装说明、助手中日英指引和网站统一为已公证的 Mac PKG 流程；补充手动解压版保留原路径、一次覆盖与重新加载、连接助手的接入步骤。
安装遇到问题？
提示找不到 manifest 文件
确认 ZIP 已解压，选择的文件夹里直接有 manifest.json。如果当前目录里只有另一个文件夹，通常需要再进入一层。
覆盖文件后，看到的还是旧界面
在扩展管理页点击原扩展卡片的「重新加载」，并重新打开网页。只下载 ZIP 或只覆盖文件，不会让已经运行的页面立即使用新代码。
安装完成，但选中文字没有反应
刷新安装前已经打开的网页，确认扩展已启用并拥有该网站的访问权限。浏览器内部页、应用商店和 PDF 等受限页面不支持。其他用法见使用说明。
扩展失效，提示文件不存在
检查原安装文件夹是否被移动、改名或删除。先恢复原来的位置，再尝试重新加载；保留数据备份，不要先卸载。