欢迎页

type: "welcome"（格式 1.1）。第一次用扉阅时，装好会打开设置页的“总览”，最上面有一块“先做这几步”，下面有一句练习句，让人直接按触发键走一遍。欢迎页包换的就是这一块：有哪几步、每步怎么说，和里面那句练习句。给初中生换一句简单句、先练再配模型，给备考雅思的人换一句学术长句，第一眼就对得上。

同时只用一个。三个文件各自可选（至少写一个），没写的用扉阅自带的（feyxo/welcome-default）。它不进设置页的下拉：在“扩展包”页的已装列表里关掉或卸载它，就回到自带的。组合能在 use 里指定用哪一套欢迎页，所以“初中组合配简单句”不需要新格式。

能改什么

练习句（practice.json）：一句英文、把它切成几块（每块是主干还是修饰、修饰挂在谁身上），和一句中文大意（节奏 zhExit 打开、给整句中文时才用）。回答是写死的：不用配模型、没有网也能练。
引导的步骤（steps.json）：“先做这几步”这一块的标题、开头一段、最后一行，和 1 到 6 步，每步的标题、说明、放什么（一个按钮、练习句的框、一排组合按钮、按练什么分组点选常用网站），以及做完以后显示什么。顺序你定，没写的字段用自带的。
- 从上往下第一个没做完的步骤亮着；写了“做完的条件”的步骤全做完，这一块就收起来。一步都没写条件的话，这一块一直在。
- 练习句只在有“练习句的框”的那一步里出现；步骤里没放这个框，练习句就不显示。
推荐去读的网站（sites.json，2026-10-12 加）：按“练什么”分组（自带的是初中、高中、雅思、考研、日常），每组最多 12 个网站，每个写域名、网站名、一句为什么适合、大概多难（1 到 5）、要不要付费。第一次用那一步“开启要读的网站”、“网站、暂停与触发键”页的点选，都读这一份；一组写了组合，用户正在用那个组合时就默认翻到这一组。字段写法见 SDK 说明。

改不了什么

只放数据，不带代码、不带网址：引导步骤里的“条件”“动作”“控件”各有一张名单，名单里没有的名字退回默认。推荐网站只写域名（不带 http://、路径），用户点了照样是浏览器问权限那一套，扩展包不能替他打开哪个网站。
总开关是用户自己的事：扩展包不能偷偷改它。引导步骤里能放“打开总开关”的按钮，但必须是用户自己点了才做，而且只能放在“做完的条件是总开关开着”的那一步里。
练习句也要过检查：块不能重叠、不能越界、主干要连得上，检查器会一句人话说哪里不行。

字段参考

字段和检查的完整写法，在 SDK 的说明里：给扩展包作者。样例 welcome-junior（初中版：简单句、先试一下再配模型）：

文件夹 welcome-junior/ 里有：

feyxo-plugin.json
practice.json
steps.json

{
  "format": "1.1",
  "type": "welcome",
  "id": "sample/welcome-junior",
  "version": "1.0.0",
  "name": "初中版欢迎页",
  "description": "先练一句带修饰的简单句（一个主谓、没有从句），再配模型、开启要读的网站、打开扉阅。",
  "author": "sample",
  "license": "AGPL-3.0-only",
  "audience": ["junior"]
}

{
  "intro": "读英文卡住的时候，选中那一句，按 {copyKey}。先在下面这一句上练一练，不用任何设置。",
  "steps": [
    {
      "id": "try",
      "title": "先在这一句上试一下",
      "body": "这句已经替你选好了，直接按 {copyKey}。按一下看句子的主干，再按一下划出“修饰的那一段”，读懂了就按 Esc。",
      "tip": "按 Esc 收起，页面跟原来一模一样。",
      "control": { "name": "practice" }
    },
    {
      "id": "model",
      "title": "再配上你的大模型",
      "body": "扉阅直接问你配的模型：填接口格式、地址、密钥、模型名四样，点“试一下”看通不通。",
      "control": { "name": "button", "caption": "去配模型", "action": "openSettings" },
      "done": {
        "when": "modelConfigured",
        "status": "配好了",
        "control": { "name": "button", "caption": "改设置", "action": "openSettings" }
      }
    },
    {
      "id": "sites",
      "title": "开启你要读的网站",
      "body": "扉阅默认哪个网站都不出来。去要读的英文网站，点右上角的双页图标，再点“在这个网站用扉阅”；也可以在这里直接写网址。",
      "control": { "name": "sites" },
      "done": { "when": "siteOpened", "status": "已开启" }
    },
    {
      "id": "popup",
…（后面还有 11 行）

{
  "sentence": "The girl next to me is very good at maths.",
  "chunks": [
    { "tokens": [0, 1], "role": "trunk", "center": 1 },
    { "tokens": [2, 4], "role": "modifier", "center": 4, "modifies": 0, "attach": 1 },
    { "tokens": [5, 9], "role": "trunk", "center": 7 }
  ],
  "gist": "我旁边的那个女孩数学很好。"
}