版本号和公开名

三种版本号

• 格式版本（清单里的 format）：写成“主.次”，现在是 "1.2"（1.0、1.1 的扩展包照用，不用改；1.2 给清单加了 learns、requires，给提示词包加了 answers、limits，给外观包加了几个文件，给语法包加了通用场地和新起的划一段，节奏、导出模板、网站适配也各加了几样，见各类的字段参考）。
• 题型版本（field@1）：写成“名字@主版本”。
• 扩展包自己的版本（version）：x.y.z，每发一版都要比上一版大。

兼容规则

• 格式版本的次版本只加字段、加选项值，新字段都有默认值；名字一旦公开，含义永远不改。
• 题型也一样：field@1 只加不改，要改就出 field@2，@1 不会马上撤掉。
• 老格式的扩展包在新扉阅上会一步步自动升级（不改你的原文件）。
• 装的时候：1.x 里比扉阅新的次版本照装，不认识的字段跳过、不认识的选项退回默认；主版本比扉阅新的装不上。
• 有的字段跳过了意思就错了：写进清单的 requires，不认得的扉阅就不装、提示先更新。
• 提示词包的 prompt.json 可以写 answers（每一步照哪一版回答格式写的，没写是 1）：扉阅改了哪一步的回答格式，对不上的那一步用内置的，别的步照用。
• minApp 说的是扉阅的版本：浏览器扩展和以后的 App 用同一个版本号，同一个版本号能装的扩展包一样。
• 界面语言包没翻到的字（以后扉阅新加的）：不是中文的先用官方英文，中文的用简体中文。

以后教别的语言

扉阅现在只教英文。以后多教一种语言时，你现在写的扩展包照样能用，不用改：

• 清单里的 learns 说给学哪几种语言用（["en"]）。没写的，语法、提示词、评测句、组合当作只给英文；外观、界面语言、讲法、节奏、导出、网站适配、欢迎页哪种语言都能用。
• 只写了扉阅还不教的语言（比如 ["ja"]），现在装不了，feyxo check 会提醒一句；等扉阅教这种语言了就能装。

一旦公开就不改的名字

下面这些名字，你写进扩展包以后就不会再变含义：

• 清单文件名 feyxo-plugin.json、打包后缀 .feyxo.json、命令名 feyxo、格式版本 1.2。
• 清单里的字段名和 type 的取值。
• 题型代号（下表）。
• 章的代号和语法点的完整名字（扩展包id#语法点id，比如 feyxo/grammar-tense#sequence）。
• 规则卡的 id（章.写法）、格子的代号。

名字里还看得见 plugin，是因为这些是更早定下来的内部名，改了就会让已有的扩展包失效。官网和文档里把它们叫“扩展包”，对照见叫法对照。

公开名和内部名

扉阅内部给这些名字另外起了名字（比如题型 field@1 在代码里叫 grammar）。本体怎么改名只改一张对照表，不动你的扩展包，所以你不用跟着本体改。

题型代号

共 15 种；这份文档讲的是扩展包能用的四种（见语法点）。

代号	名字
field@1	拖进格子
coin@1	翻硬币
span@1	划一段
ladder@1	排阶梯
strip@1	点掉修饰
refer@1	连指代
wh@1	问谁 / 问什么
fill@1	填坑
phrase@1	固定搭配
parts@1	拆词
earlier@1	找旧说法
explain@1	找线索句
scope@1	管到哪
ratio@1	量几倍
concede@1	跷跷板

章的代号

代号	章名	语法点数
tense	时态	4
modal	情态动词	6
subjunctive	虚拟语气	7
passive	被动语态	6
nonfinite	非谓语动词	5
relative	定语从句	3
nominal	名词性从句	4
adverbial	状语从句	2
negation	否定	6
comparison	比较	7
inversion	倒装	4
reference	代词指代	3
aside	插入语与同位语	1
phrase	固定搭配	1
vocab	生词	4
emphasis	强调与省略	4
agreement	主谓一致	1

语法点的完整名字清单：

完整名字	短名
feyxo/grammar-tense#future-ongoing	将来正在做
feyxo/grammar-tense#future-past	那时的将来
feyxo/grammar-tense#present-future	现在时说将来
feyxo/grammar-tense#sequence	先后
feyxo/grammar-modal#be-to	定好的、注定的
feyxo/grammar-modal#certainty	有多确定
feyxo/grammar-modal#needless	本不必做
feyxo/grammar-modal#obligation	该不该
feyxo/grammar-modal#past-guess	对过去的推测
feyxo/grammar-modal#should-have	本该、本可以
feyxo/grammar-subjunctive#as-if	好像、仿佛
feyxo/grammar-subjunctive#but-for	要不是
feyxo/grammar-subjunctive#inverted	省掉 if
feyxo/grammar-subjunctive#its-time	早该、宁愿
feyxo/grammar-subjunctive#mandate	要求、建议
feyxo/grammar-subjunctive#mixed	混合虚拟
feyxo/grammar-subjunctive#unreal	真发生了没有
feyxo/grammar-passive#direction	动作的方向
feyxo/grammar-passive#given	双宾语被动
feyxo/grammar-passive#hidden	藏着的被动
feyxo/grammar-passive#nominalized	名词里的动作
feyxo/grammar-passive#said-to	据说、被认为
feyxo/grammar-passive#to-be-done	非谓语被动
feyxo/grammar-nonfinite#absolute	独立主格
feyxo/grammar-nonfinite#doer	谁在做
feyxo/grammar-nonfinite#for-doer	for 后谁在做
feyxo/grammar-nonfinite#participle-clause	先后和因果
feyxo/grammar-nonfinite#to-result	to 带出结果
feyxo/grammar-relative#modifier	修饰在说谁
feyxo/grammar-relative#prep-which	关系词指谁
feyxo/grammar-relative#which-all	指前面整件事
feyxo/grammar-nominal#noun-that	说的是哪件事
feyxo/grammar-nominal#object	说了什么
feyxo/grammar-nominal#subject-clause	主语从句
feyxo/grammar-nominal#what	what 指什么
feyxo/grammar-adverbial#cause	因果的方向
feyxo/grammar-adverbial#concession	哪一半是重点
feyxo/grammar-negation#double-negative	两个否定
feyxo/grammar-negation#negative	有，还是没有
feyxo/grammar-negation#partial	不是全都
feyxo/grammar-negation#reversed	容易读反
feyxo/grammar-negation#transfer	否定转移
feyxo/grammar-negation#until	直到……才
feyxo/grammar-comparison#ellipsis	省掉了什么
feyxo/grammar-comparison#most	谁排第一
feyxo/grammar-comparison#rather	与其……不如
feyxo/grammar-comparison#superlative	在哪些里比
feyxo/grammar-comparison#the-more	越……越……
feyxo/grammar-comparison#times	几倍
feyxo/grammar-comparison#weigh	哪边重
feyxo/grammar-inversion#concessive	让步倒装
feyxo/grammar-inversion#so-nor	也一样倒装
feyxo/grammar-inversion#than-as	than 后倒装
feyxo/grammar-inversion#word-order	谁对谁做
feyxo/grammar-reference#dummy-it	it 指后面
feyxo/grammar-reference#pronoun	指的是谁
feyxo/grammar-reference#stand-in	代替哪个词
feyxo/grammar-aside#inserted	插在中间的话
feyxo/grammar-phrase#fixed	固定搭配
feyxo/grammar-vocab#earlier	找旧说法
feyxo/grammar-vocab#explain	找线索句
feyxo/grammar-vocab#fill	填坑
feyxo/grammar-vocab#parts	拆词
feyxo/grammar-emphasis#cleft	强调哪一块
feyxo/grammar-emphasis#focus	只、连管到哪
feyxo/grammar-emphasis#gapping	并列里省掉的
feyxo/grammar-emphasis#reduced	省掉的主语
feyxo/grammar-agreement#subject	真正的主语