# CopyIns Chrome 扩展本地安装说明

## 应使用哪个文件

Chrome Web Store 版本上线前，桌面版 Chrome 用户可以通过“开发者模式”安装本地体验包：

`output/copyins-instagram-extension-local-test-0.4.1.zip`

该文件必须先解压。Chrome 的“加载已解压的扩展程序”只能选择文件夹，不能选择 ZIP 本身。

`output/copyins-instagram-extension-0.4.1.zip` 只会在正式反馈域名、支持邮箱等发布配置全部通过门禁后生成。它是 Chrome Web Store 后台上传包，不能在 Windows Chrome 中通过双击、拖入浏览器或“加载已解压的扩展程序”直接安装。

当前网站只分发本地体验 ZIP。商店 ZIP 尚未生成或上传；是否存在更早线上版本应以 Chrome Web Store 后台记录为准。

## 安装步骤

1. 下载 `copyins-instagram-extension-local-test-0.4.1.zip`。
2. 将 ZIP 解压到一个会长期保留的文件夹。Windows 可右键选择“全部解压”；macOS 可双击 ZIP。
3. 打开解压后的文件夹，确认第一层能直接看到 `manifest.json`、`background.js` 和 `content.js`。
4. 在 Chrome 地址栏输入 `chrome://extensions/`。
5. 打开右上角“开发者模式”。
6. 点击“加载已解压的扩展程序”。
7. 选择刚才解压、且第一层包含 `manifest.json` 的文件夹。
8. 打开或刷新 `https://www.instagram.com/`，在符合条件且已显示的媒体上点击 CopyIns 按钮。
9. 如果希望更快打开扩展，可从 Chrome 的“扩展程序”菜单把 CopyIns 固定到工具栏。

## 常见错误

- **清单文件缺失或不可读取**：选中了 ZIP、ZIP 的上一级目录，或者还没有完整解压。应选择第一层直接包含 `manifest.json` 的文件夹。
- **无法加载清单**：把 Chrome 显示的完整错误文字和文件路径发回来，不要只截掉错误详情。
- **没有“加载已解压的扩展程序”按钮**：确认已打开“开发者模式”；如果该开关由组织管理，需要先检查 Chrome 管理策略。
- **扩展已加载但 Instagram 没有按钮**：刷新 Instagram 标签页，并确认地址是 `https://www.instagram.com/*`。

## 更新与卸载

- 本地安装不会自动更新。请保留解压目录；拿到新版 ZIP 后，用新版文件替换原目录内容，再到 `chrome://extensions/` 点击 CopyIns 卡片上的“重新加载”。
- 不再使用时，在 `chrome://extensions/` 找到 CopyIns 并点击“移除”。删除扩展后再删除本地解压目录。
- Chrome 可能持续显示开发者模式相关提示。这是本地加载扩展的正常边界；正式商店版上线后应改用商店安装。

## 发布边界

上述开发者模式适用于愿意手动安装和更新的本地体验用户。面向普通 Windows/macOS 用户的一键安装、自动更新和正式分发仍需发布到 Chrome Web Store；本地 ZIP 或本地 CRX 不能代替商店安装。
