# BiliIndex 扩展 — 插件市场上架指南（demo1.0.10）

当前 **demo1.0.10** 已冻结为首选基线（`baseline/demo-1.0.10/`），manifest 版本 **1.0.10**。

## 上架前必做

### 1. 部署公网 API

扩展依赖 **biliindex-api**（登录、标签、打标、积分、BUG、站点内容等）。本地 `127.0.0.1:8000` **不能**给商店用户使用。

1. 将 API + 数据库部署到 HTTPS 域名（如 `https://api.你的域名.com`）。
2. 配置 CORS 允许扩展来源（`chrome-extension://<扩展ID>`）。
3. 同域或子域部署 **biliindex-admin**（可选，用户也可只用扩展弹窗）。

### 2. 打商店 zip 包

在项目根目录 PowerShell：

```powershell
cd C:\Users\X99\Projects\biliindex-extension
.\scripts\build-store.ps1 -ApiBase "https://api.你的域名.com"
```

生成：

- `dist\biliindex-1.0.10-store.zip` — 上传到商店
- `dist\store-package\` — 解压目录，可先「加载已解压的扩展程序」自测

自测清单：

- [ ] 弹窗能注册/登录（连的是你的 HTTPS API）
- [ ] 视频页评论区出现标签槽，能选标签打标
- [ ] 空间页昵称旁 4 槽正常
- [ ] 控制台 `[BiliIndex] 1.0.10 已注入`

开发环境仍可直接加载项目根目录（默认 `http://127.0.0.1:8000`）。

### 3. 商店素材

| 项 | 要求 |
|----|------|
| **图标** | 已含 `icons/icon128.png`（可换成正式 Logo） |
| **截图** | 至少 1 张，建议 1280×800 或 640×400，展示 B 站页面 + 弹窗 |
| **简短说明** | ≤132 字，说明打标、需账号、需服务端 |
| **详细说明** | 功能列表、登录方式、积分/会员说明 |
| **隐私政策** | **必填** — 见 `store/PRIVACY.md` 模板，发布到可公开 URL |

### 4. 权限说明（审核用）

在商店「隐私实践 / 权限理由」中填写：

| 权限 | 用途 |
|------|------|
| `storage` | 保存登录 token、API 地址、标签缓存 |
| `tabs` | 「读取当前页」获取 UP 主 UID |
| `host_permissions`（你的 API + bilibili.com） | 调用 BiliIndex API；读取 B 站公开接口辅助粉丝数 |
| `content_scripts` on bilibili.com | 在评论/推荐/空间页注入标签槽 UI |

**单一用途**：仅在哔哩哔哩相关页面为 UP 主提供社区标签展示与打标，不收集与打标无关的浏览历史。

---

## Chrome 网上应用店

1. 注册 [Chrome Web Store 开发者](https://chrome.google.com/webstore/devconsole)（一次性注册费，以 Google 当前政策为准）。
2. **新建项目** → 上传 `dist\biliindex-1.0.10-store.zip`。
3. 填写商店信息、隐私政策链接、分类（建议「社交」或「生产力」）。
4. 选择可见范围：先「不公开」或「仅信任测试人员」内测，再转公开。
5. 提交审核（通常数个工作日）。

文档：<https://developer.chrome.com/docs/webstore/publish>

---

## Microsoft Edge 加载项

1. 扩展内 **已移除**「检查更新 / 下载安装包 / update_url」（符合商店禁止侧载更新要求）；版本仅通过商店发布。管理后台「扩展发布」保留供运营内测。
2. 运行 `.\scripts\build-edge-submission.ps1 -ApiBase "https://api.你的域名.com"` 生成：
   - `dist\biliindex-<版本>-store.zip` — 上传到 Partner Center
   - `dist\biliindex-edge-submission-<版本>.zip` — 含文案、权限说明、图标、截图
3. 步骤与素材说明见 `store/edge/README_SUBMIT.md`。
4. [Partner Center](https://partner.microsoft.com/dashboard) → Edge 扩展 → 上传 store zip，填写 `store/edge/listing/` 中文文案与隐私政策 URL。

文档：<https://learn.microsoft.com/microsoft-edge/extensions-chromium/publish/publish-extension>

---

## 版本与回滚

- 商店上架版本号须与 `manifest.json` 的 `version` 一致，每次更新递增（当前为 `2.0.3`）。
- 开发回滚到本 demo：见 `VERSIONING.md` 与 `baseline/demo-1.0.10/README.txt`。

---

## 常见问题

**Q：审核说权限过宽？**  
商店包已去掉 `localhost`；勿在 zip 里保留 `http://127.0.0.1:8000/*`。

**Q：用户没装 API 能用吗？**  
不能。扩展是前端，必须连你部署的 BiliIndex 服务端。

**Q：想换图标？**  
替换 `icons/icon16.png`、`icon48.png`、`icon128.png` 后重新运行 `build-store.ps1`。
