导入与管理拓展
拓展管理页在 设置 → 拓展。刚装好的拓展一律是禁用状态,看完权限再启用。
导入
两种方式都支持一次装多个:
| 方式 | 操作 | 说明 |
|---|---|---|
| 按钮导入 | 点「导入拓展」,在文件对话框里多选 | 接受 .tmlext 和 .jar |
| 拖拽导入 | 把文件直接拖进启动器窗口 | 拓展页内两种格式都收;其它页面只拦 .tmlext,.jar 仍按 Mod 处理 |
拖进拓展页时会出现全页提示「松开鼠标,导入拓展」,松开就开始安装;夹在里面的非拓展文件会被忽略,并提示忽略了几个。 以管理员身份运行时,窗口拖放走的是另一条系统通道,.tmlext 也一样会被接住,不会当成 Mod 装进游戏目录。
TIP
导入只是把包放进数据目录的 extensions/,不会立刻运行。先点「详情」看它申请了什么,再决定要不要启用。
页面上的信息
顶部一行是概要:已安装、已启用、出错、缺少运行环境各有多少。下面每个拓展一张卡片:
- 名称、版本、状态徽标(已启用 / 已禁用 / 出错 / 缺少运行环境)。
- 作者、运行时、包格式、是否已解包。
- 描述,以及申请的权限和订阅的事件。
每个卡片三个按钮:
| 按钮 | 作用 |
|---|---|
| 详情 | 标识、版本、作者、运行时、入口、支持平台、权限、订阅事件、SHA-256、解包目录、私有数据目录;出错时还会显示错误原因 |
| 启用 / 禁用 | 启用前弹出权限清单让你确认;禁用会停掉独立子进程,文件保留 |
| 卸载 | 二次确认后删除拓展包与它的私有数据 |
页面顶部另有「刷新」(重新扫描 extensions/)和「打开拓展目录」。
权限确认与自动启动
- 首次启用会列出这个拓展申请的权限,确认后才会拉起独立子进程。
- 同一个包确认过一次就会记住,之后再启用不再重复弹窗;换了包或包内容变了(SHA-256 对不上)才会重新问一次。
- 上次退出时处于启用状态的拓展,下次启动会自动拉起。
- 启用状态与信任记录写在
extensions/trusted.json;包内容被改动会提示「拓展已被修改」并拒绝加载。
出错时
| 现象 | 处理 |
|---|---|
| 缺少运行环境 | 装好对应解释器 / 运行时后点「刷新」;启动器不会自动下载运行时 |
| 导入了但列表里没有 | 清单 JSON 语法错,或 id 和已装的重复,看 logs/ext-*.log |
| 卡片显示「出错」 | 点「详情」看错误信息 |
| 拖进去没反应 | 确认扩展名是 .tmlext(拓展页内也支持 .jar),且拖的是文件不是文件夹 |
