Doubak / doubak-extension / 134

86%

push

github

加一份英文 README (#9)

* docs: 加一份英文 README

英文那边的搜索结果基本是空的（"douban backup"、"export douban to neodb"），
而现在多数人是直接问 AI「怎么备份豆瓣」——被读到的是 README 和结构化的文档，
不是博客。这个仓库此前一个英文字都没有。

不是逐行翻译。中文 README 有 287 行、跟着代码一起动，翻译一份只会立刻开始漂移。
英文这份写的是一个英文读者真正要先知道的东西，并且刻意避开会过期的数字（测试
条数、抓取耗时那些），需要细节的地方指回中文文档，并写明中文那份才是准的。

两条实话放在最前面，因为它们会让人白装一次：

- **界面只有简体中文**。没有 _locales，也没有 default_locale，面板里的字符串
  就是写死的中文。档案格式、导出的数据、生成的站点都与语言无关，但操作扩展本身
  现在需要能读中文。
- **只支持 Chromium**。写档案要 File System Access（showDirectoryPicker），
  抓取跑在 offscreen document 里，Firefox 和 Safari 两个都没有——所以这不是
  「再上一个商店」的事，抓取和导出两条路都得重写。实测过的只有 Chrome 和 Edge，
  别的 Chromium 浏览器写的是「应该可以，但没验过」。

和豆伴的对比也写进去了，每一条都出自它自己的 README，不是试用出来的印象；
最后一行写的是这个项目自己也只支持 Chromium。

中文 README 顶上加了一行语言切换。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BnEiv96BzYrjrivducumjE

* docs(en): 删掉的那八个作品，说法是错的——两个「8」被并成了一句

原文写的是「八个作品豆瓣已经删掉，评论和评分都还在」。实测对着
20260830-canonical 数了一遍，这句话里有两处不成立：

1. **档案里有两组不同的「8」，只重合 1 个。**
   ① 最后一版没有标题的墓碑作品 8 个（7 游戏 1 电影）——豆瓣把条目删了；
   ② 被豆瓣剥光的标记 8 条（有标题，但日期/评分/标签/短评全空）。
   两组只有 movie/11611021 同时属于两边。首页写的是①，英文这份把两组
   混成了一句。

2. **①里没有任何一条标记还带着评分。** 实测：短评 7/8、标签 6/8、
   日期 7/8、**评分 0/8**。活下来的三颗星全部来自广播——广播发出去
   就不能改，所以它冻住了那一天的星；标记只存当前状态，而当前状态跟着
   条目一起没了。首页那段中文一直是对的（「标记本身没有分数，这颗星
   只在广播里」），英文这份把它说反了。

顺带补上「名字才是真正没留住的那样东西」——这是首页整段的落点，
也是「现在抓」与「回头再说」之间的全部区别，英文这份原本没有。

另外给 Letterboxd / Goodreads 补上实话：两个都还没对真实服务跑过一次
往返，所以扩展的导出页只给 NeoDB。README 里并排列出来而不说这件事，
是「按钮即承诺」的弱化版。

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E6dxwcUi4rM3dcKdsqx9xm

---------

Co-authored-by: Claude <noreply@anthropic.com>

3390 of 4077 branches covered (83.15%)

Branch coverage included in aggregate %.

24520 of 28235 relevant lines covered (86.84%)

123.11 hits per line