知了扩展 — 安装说明
版本：0.1.0
适用浏览器：Google Chrome / Microsoft Edge（Manifest V3）

——————————————————————————————
一、解压说明
——————————————————————————————
1. 将本压缩包解压到一个固定目录（建议路径不含中文与空格），例如：
   - Windows：D:\extensions\zhiliao
   - macOS：~/Applications/zhiliao-extension
2. 解压后顶层应能看到 manifest.json、sidepanel.html、background.js 等文件。
3. 安装后请勿移动或删除该目录，否则扩展会失效，需重新加载。

本包为「已解压即用」产物，包含：
  - manifest.json      扩展清单
  - background.js       后台服务脚本
  - sidepanel.html      侧边栏入口页面
  - assets/             JS / CSS / 字体等静态资源
  - icons/              扩展图标（16/48/128）
  - images/             内置图片资源
  - readme.txt          本说明文件

——————————————————————————————
二、在 Google Chrome 中安装
——————————————————————————————
1. 打开 Chrome，地址栏输入：chrome://extensions
2. 右上角打开「开发者模式」
3. 点击「加载已解压的扩展程序」
4. 选择本包解压后的文件夹（包含 manifest.json 的那一层）
5. 安装成功后，点击工具栏「知了」图标，即可打开侧边栏

——————————————————————————————
三、在 Microsoft Edge 中安装
——————————————————————————————
1. 打开 Edge，地址栏输入：edge://extensions
2. 左下角打开「开发人员模式」
3. 点击「加载解压缩的扩展」
4. 选择本包解压后的文件夹（包含 manifest.json 的那一层）
5. 安装成功后，点击工具栏「知了」图标，即可打开侧边栏

——————————————————————————————
四、版本更新
——————————————————————————————
方式 A（推荐，可尽量保留登录态）：
  1. 解压新版本覆盖到原安装目录
  2. 打开扩展管理页，点击该扩展的「重新加载」

方式 B（全新安装）：
  1. 在扩展管理页先「移除」旧版
  2. 按上文步骤重新「加载已解压的扩展程序」

——————————————————————————————
五、常见问题
——————————————————————————————
1. 侧边栏空白 / 打不开
   - 确认加载的是含 manifest.json 的目录，而不是上一层压缩包目录
   - 在扩展管理页点击「重新加载」后再试

2. 登录后接口报错 / 无法连接服务
   - 确认电脑可访问知了服务域名
   - 公司网络若拦截，请联系管理员放行相关域名

3. 能否直接拖拽 .zip / .crx 安装？
   - 现代 Chrome / Edge 默认不允许从本地直接拖拽安装未签名扩展
   - 请按本文「加载已解压」方式安装

4. 浏览器重启后扩展消失
   - 多为开发者模式关闭，或安装目录被移动/删除
   - 重新打开开发者模式，并确认安装目录仍在

5. 「带入本页 / 带入选中」失败
   - 浏览器内置页（chrome://、扩展商店等）无法读取，请换到普通网页
   - 安装或更新后需在扩展管理页点「重新加载」，并允许读取网站数据
   - 划选后再点「带入选中」；也可在网页上右键「发送到知了探讨」

——————————————————————————————
六、卸载
——————————————————————————————
在 chrome://extensions 或 edge://extensions 中找到「知了」，点击「移除」即可。
也可一并删除本机解压目录。
