# BiliIndex 扩展版本策略（demo1）

## 当前版本：demo2.0.3（V2.0.3 · 当前开发基线）

| 项 | 值 |
|----|-----|
| **代号** | demo1 |
| **manifest 版本** | `2.0.3` |
| **产品对外版本** | **V2.0.3**（与 admin、API 一致） |
| **状态** | **当前开发基线**；新功能在此版本上递增 patch（2.0.4…） |
| **上一产品基线** | demo2.0.0（`2.0.0`） |
| **上一冻结基线** | demo1.2.11（`baseline/demo-1.2.11/`） |
| **市场上架回滚** | demo1.0.10（`baseline/demo-1.0.10/`） |

---

## 历史冻结：demo1.0.10（市场上架基线）

| 项 | 值 |
|----|-----|
| **代号** | demo1 |
| **manifest 版本** | `1.0.10` |
| **状态** | **已冻结**（2026-05-22），功能完善，见 `baseline/demo-1.0.10/FROZEN.md` |
| **首选回滚基线** | **demo1.0.10**（`1.0.10`，见 `baseline/demo-1.0.10/`） |
| **终极回滚基线** | **demo1.0.0**（`1.0.0`，见 `baseline/demo-1.0.0/`） |
| **商店上架** | [STORE_RELEASE.md](./STORE_RELEASE.md) + `scripts/build-store.ps1` |

控制台应看到：`[BiliIndex] 2.0.3 已注入`  
`document.documentElement.getAttribute("data-biliindex-version")` → `"2.0.3"`

### 回滚顺序（重要）

```
当前开发版出问题
    ↓ 先回滚
demo1.2.11  （baseline/demo-1.2.11/）— V1.2.12 批次确认前的扩展快照
    ↓ 仍不行
demo1.0.10  （baseline/demo-1.0.10/）— 市场上架基线
    ↓ 仍不行
demo1.0.0   （baseline/demo-1.0.0/）— 最早 demo
```

---

## 版本号规则

采用 [语义化版本](https://semver.org/lang/zh-CN/)，**只改 `manifest.json` 的 `version`**（扩展 UI 与 `data-biliindex-version` 自动读取 manifest）。

| 变更类型 | 示例 | 何时升 |
|----------|------|--------|
| **补丁** | 2.0.0 → 2.0.1 | Bug 修复、性能、文案，无新功能 |
| **次版本** | 2.0.x → 2.1.0 | 向后兼容的新功能 |
| **主版本** | 1.x → 2.0.0 | 不兼容变更或重大产品里程碑 |

建议节奏：**一次 PR / 一次对话只升一档**（优先 2.0.1、2.0.2…），避免大跳变。

---

## 回滚操作

### 第一步：回滚到 demo1.2.11（V1.2.12 批次内）

1. 在 `baseline/demo-1.2.11/` 执行 `README.txt` 中的 PowerShell 脚本。
2. 在 `chrome://extensions` 重新加载 unpacked 扩展。
3. 确认版本为 **1.2.11**。

### 第二步：回滚到 demo1.0.10（市场上架）

见 `baseline/demo-1.0.10/README.txt`。

---

## 基线目录

| 目录 | manifest | 用途 |
|------|----------|------|
| `baseline/demo-1.2.11/` | 1.2.11 | **V1.2.12 批次扩展回滚**（屏蔽、滑块验证码等） |
| `baseline/demo-1.0.10/` | 1.0.10 | **市场上架回滚** |
| `baseline/demo-1.0.0/` | 1.0.0 | 最早 demo |

---

## 发版检查清单

- [ ] `manifest.json` → `version` 已递增且与 API `product_version`、admin 品牌版本一致
- [ ] B 站视频页：评论区 4 槽、推荐/搜索封面遮罩
- [ ] 弹窗：登录/注册/打标/设置/公告
- [ ] 注册须勾选隐私协议
- [ ] 更新本文件底部 **变更记录**
- [ ] 若定为新基线：更新 `baseline/demo-x.y.z/` 快照

---

## 变更记录

| 版本 | 日期 | 说明 |
|------|------|------|
| **demo2.0.3** (`2.0.3`) | 2026-06-01 | **V2.0.3**：打标员 B 站账号/Cookie 与视频 UID 爬取；路人判定粉丝>100 不入库、路人库粉丝>1000 清理与后台慢速排查；列表/打标性能优化；播放量未知按路人；灰页 overlay 修复 |
| **demo2.0.0** (`2.0.0`) | 2026-05-22 | **V2.0.0 产品基线**：站点公告；注册隐私协议必选；性能优化（评论/标签 LRU、节能扫描分布式锁）；模块拆分与打标修复 |
| **demo1.2.20** (`1.2.20`) | 2026-05-22 | **V1.2.20 产品基线**：BUG 提交每日 1 次、500 字、可选 1 张图（≤1MB）；积分会员超级讨厌限制；标签池/Emoji 布局 |
| **demo1.2.12** (`1.2.12`) | 2026-05-22 | **V1.2.12 产品基线**：版本号与 admin/软著对齐；冻结 1.2.11 回滚点 |
| **demo1.2.11** (`1.2.11`) | 2026-05-22 | **已冻结**：评论区屏蔽补扫；视频封面遮罩 90% 灰；见 `baseline/demo-1.2.11/` |
| demo1.1.11 (`1.1.11`) | 2026-05-22 | 会员评论区屏蔽；推荐/主页视频封面遮罩；滑块验证码；积分流水校验 |
| demo1.0.11 (`1.0.11`) | 2026-05-22 | （开发号，已并入 1.1.11）滑块验证码、积分到账校验 |
| **demo1.0.10** (`1.0.10`) | 2026-05-22 | **冻结 · 市场上架基线**：30×10 标签树；弹窗 L1/L2/风格/Emoji 四槽打标；三级可折叠、Emoji 悬停显名；使用说明/作者的话/BUG/大窗口；站点内容 API；图标与 `build-store.ps1`；含空间头图、限流、积分会员等 |
| demo1.0.9 | 2026-05-22 | 空间头图挂载修复（`.nickname`、URL mid、禁区清理） |
| demo1.0.8 | 2026-05-22 | 空间头图初版；风格标签预置 |
| demo1.0.7 | 2026-05-22 | 打标频率限制 8 次/分钟、2 完整 UP |
| demo1.0.6 | 2026-05-22 | 重置密码；打标记录打标数 |
| demo1.0.5 | 2026-05-22 | 粉丝量 API 拉取；清空打标测试按钮 |
| demo1.0.4 | 2026-05-22 | 粉丝量链路（扩展 + API） |
| **demo1.0.3** (`1.0.3`) | 2026-05-22 | 国旗 Emoji：API/Admin/扩展预载与 US→🇺🇸 修正 |
| **demo1.0.2** (`1.0.2`) | 2026-05-22 | 仅穿透评论 Shadow；移除 document 级悬停拦截；顶栏禁区加强 |
| **demo1.0.1** (`1.0.1`) | 2026-05-22 | 评论 Shadow 穿透；标签槽挂载 |
| **demo1.0.0** (`1.0.0`) | 2026-05-22 | 初始 demo |
