合集和组合

这一页是字段参考。想先看这一类能改什么、改了什么样、改不了什么，见组合。

type: "bundle"，文件 bundle.json、plugins/<作者>/<名字>.json。一次装好一批并按建议开关。

• 要装哪几个、什么版本，写在清单的 needs 里。
• 除了扉阅自带的（feyxo/ 开头），每一个都要打进来：plugins/<作者>/<名字>.json 就是那个扩展包打好的包（feyxo pack 出来的内容）。
• 合集里不能再套合集。

bundle.json：

{ "note": "一句说明", "switches": { "chapters": { "vocab": false }, "use": { "look": "sample/look-night" } } }

• switches.chapters：建议关掉、打开哪几章。
• switches.use：建议换上哪一套外观、讲法、节奏、界面语言、导出模板、提示词（那个扩展包要在合集里或者扉阅自带）。
• 装的时候里面的一个个查、一个个装：已经装了一样的、更新的不动；有一个装不了，整个都不装。
• 卸载合集只卸它这张清单，里面装上的留着。

组合

“组合”（按阶段 / 考试配好一套语法开关）就是一个合集，没有另外的类型：格式跟上面一样，用户自己做的组合也走这条路。扉阅自己的四套（初中、高一必修、高二高三选必、雅思）id、作者用的是 feyxo/、“扉阅”，装的时候跟扉阅自带的语法包一个待遇——这两个字段别的作者不能用，所以 SDK 不收它们当样例，照搬名字改一改内容发不出去，自己取别的作者名、id。

合集多了三个字段（次版本只加，老合集不受影响）：

{
  "switches": {
    "exact": true,
    "chapters": { "subjunctive": false },
    "points": { "feyxo/grammar-inversion#than-as": false },
    "reasons": { "subjunctive": "虚拟语气规则多、容易混，先关掉" }
  }
}

• switches.points：语法点的完整名字 → 开不开（跟 chapters 一样，不写是 {}）。
• switches.exact：true 才是“完整快照”——套用时先把全部章、语法点都回到默认开，再按 chapters、points 盖一遍，没提到的也会变成开，这才是“照着设成一样”；不写、或 false 还是原来的“建议开关”（只管写了 false 的，没提到的保持原样）。完整快照这一版 needs 可以是空的（纯粹改开关、不装扩展包也合法）。
• switches.reasons：为什么这样开关，章的代号 → 一句话（≤ 60 字，给人看，不参与套用逻辑）；这套适合谁用由 audience、description 说，不在这里重复。

装好以后能在“已装的”里再点“套用”（不用卸了重装）、能“一键退回”到套之前的样子。

最简单的做法：导出

不用手写。在扉阅里把开关调成你要的样子，到“扩展包”页“备份与换电脑”里点“导出我的设置”，就得到一份标准的合集文件（装了的扩展包 + 全部开关）。想改理由、名字再手改。

样例：examples/bundle-starter/（一次装好夜墨和时间状语从句、先不练生词，是生成的）。