扩展工坊用于浏览和安装标题画面、存读档界面、好感度系统和小游戏等扩展。你也可以把自己制作的扩展上传到工坊,分享给其他创作者。
v1.9.0 改版:「扩展市场」升级为「扩展工坊」,从个性化模块中独立出来,成为顶部导航的一级模块,并持续加入评论、赞踩、消息、用户资料卡、更新和卸载管理。
入口在顶部导航的 扩展工坊,位于「个性化」和「发布游戏」之间。进入后左侧视角栏分为:
  • 工坊:浏览、安装扩展,查看详情与评论。
  • 我发布的:管理自己上传的扩展,查看审核状态、提交新版本。
LetsGal Studio 扩展工坊概览与扩展安装状态

浏览与安装

使用顶部搜索框按名称、说明或作者查找扩展。搜索框下方的分类会按工坊当前数据动态生成,最右侧的「仅看开源」开关可以只显示开放源码的扩展。 点击卡片进入详情页;点击卡片上的「安装」则直接执行下载和兼容性检查。 带盾牌「官方」徽章的扩展由官方维护。安装前仍建议查看扩展说明、版本和所需 SDK 范围。 安装后的卡片会同时显示本机版本与当前项目状态:
  • 当前项目正在使用:先从项目移除,才能卸载;
  • 当前项目未使用:可以直接从卡片卸载;
  • 有新版本:显示「更新到 vX.Y.Z」,更新时保留项目引用;
  • 自定义图标:扩展配置过工坊图标时,列表和详情都会显示;加载失败会回退到默认图标。
工坊列表顶部有时会显示公告横幅,点击「查看」阅读全文;公告内容更新后会自动弹出一次。

无法安装

  • SDK 不兼容:扩展要求的 SDK 版本超出当前 Studio 支持范围;升级 Studio 或选择兼容版本。
  • 网络或工坊服务异常:页面会显示错误状态,可以稍后重试。
  • 已经安装:按钮显示「已安装」,无需重复操作。

扩展详情页

详情页展示扩展的完整信息:
区块内容
顶部信息图标、名称、版本、简介、作者、安装量和官方徽章
截图画廊作者上传的界面截图
扩展信息版本、分类、所需 SDK 范围和风险等级
版本历史各版本的发布记录
安装状态本机版本、当前项目是否使用、更新或卸载入口
LetsGal Studio 扩展工坊详情页与评论区
安装按钮下方的「有用 / 没用」用于给扩展投票,帮助其他创作者判断质量。再点一次可以取消。

评论区

登录创作者账号后可以发表评论、插入表情、回复他人(一层)、点赞点踩和举报不当内容。单条评论最多 1000 字,发言有频率限制。 评论区用户名旁可能出现彩色小勋章,由官方运营颁发,鼠标悬停可查看说明。扩展作者的发言会带「作者」标识。 鼠标停在扩展作者名或评论头像上,会打开用户资料卡,显示用户号、加入时间、勋章和已发布扩展。资料卡不会显示邮箱。

工坊消息

登录后,Studio 标题栏账号头像旁会显示「工坊消息」入口和未读数量。以下互动会进入消息中心:
  • 有人评论你的扩展;
  • 有人回复你的评论;
  • 有人赞了你的评论。
点击一条消息会打开对应扩展详情,并滚动到评论区或目标评论。成功跳转后消息会标记为已读。

官方扩展

官方维护的扩展带盾牌「官方」徽章。v1.9.0 当前可直接从工坊安装的新增扩展包括:
  • 角色名字和对话主题色:分别设置名字牌与对白正文颜色,可跟随角色预设色或使用自定义颜色;
  • 用语辞典:登记和解锁世界观词条,提供分类、未读标记和玩家换色;
  • 角色档案图鉴:登记、解锁并随剧情更新角色资料。
完整用法见官方扩展

上传自己的扩展

切换到「我发布的」视角,点击「提交新版本」打开提交表单:
1

选择扩展目录

目录中需要有 extension.json 和已构建的产物(先在扩展目录执行 yarn build)。名称、版本号和 SDK 版本会从 extension.json 自动读取。
2

选择源码开放方式

「开源」会把源码随产物一起上传,用户可以下载查看,通过审核后获得「开源」标记;「闭源」只上传构建产物。
3

填写分类与介绍

从当前可用分类中选择一项,填写一句话简介(显示在工坊卡片上,建议 30 字以内),可补充详细介绍、截图和源码仓库地址。
4

提交审核

提交后由管理员人工审核,通常 1–3 个工作日出结果,结果会通过邮件和站内通知告知。每次更新版本都需要重新审核。
提交后可以在「我发布的」列表中查看状态:审核中(可撤回)、已上架(显示安装、赞和评论数据,可自行下架)、未通过(拒绝原因直接写在行内)。自己下架的扩展可以重新上架;下架后新用户无法搜索到它,已安装的用户不受影响。
请确认你拥有所提交内容的权利。包含恶意代码、侵权素材或冒用他人身份的提交将被拒绝,情节严重的会封禁账号。

安装后的管理

安装的扩展在 个性化 → 项目设置 的扩展树中管理。扩展分为两组:
  • 本项目:已加入当前项目的扩展。行尾徽章区分来源:「内置」「本地」「工坊」。右侧开关控制启用状态,停用不会删除已安装文件。
  • 本机的其它扩展(全局):装在这台电脑上、但没有加入当前项目的扩展。悬停点击「加入」即可加入项目并启用。
同一个扩展在不同项目可以有不同的启用状态;安装发生在本机,加入和启用状态跟随项目。

移除的三种方式

操作适用对象效果
从项目移除本项目组的扩展只解除当前项目的依赖,扩展回到全局组,随时可重新加入
卸载扩展工坊安装的扩展删除本机安装内容,以后可以再次从工坊安装
彻底删除本地开发的扩展源码移入系统回收站,项目发行物一并清理,需多次确认
工坊卡片只在当前项目未使用扩展时提供直接卸载。扩展树中右键工坊扩展还可以选择「打开文件夹」,查看只读安装目录;它没有可编辑源码,不能在 Studio 中重新构建。

工坊扩展只读

工坊扩展作为成品安装,源文件和程序不能直接编辑。它包含的可视化界面仍可以在项目中修改:
  1. 在扩展树中展开工坊扩展的「界面」;
  2. 打开目标界面;
  3. Studio 为当前项目创建可编辑副本;
  4. 需要时可以恢复扩展原始版本。
也可以将界面复制到本地扩展中独立维护。
如果项目的系统插槽、剧本或其他界面正在引用某个扩展,停用、移除或卸载它会让引用失效。标题、存档和读档会回退到默认游戏壳,其他普通 UI 或扩展方法则可能无法执行。
想自己制作界面或程序,继续阅读扩展是什么可视化界面编辑器