You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

2.5 KiB

裁剪基础能力

配置入口

app.config.json 中的 capabilities 是启动时固定的部署配置,默认全部启用:

{
  "capabilities": {
    "files": true,
    "storage": true,
    "credentials": true,
    "updates": true
  }
}
开关 关闭后的行为
files 不构造 FileService;隐藏文件导航,直接进入文件路由会回到首页
storage 不构造 StorageService,不打开 SQLite;隐藏笔记与 JSON 草稿演示
credentials 不构造 SecretService;隐藏凭证面板
updates 不构造 UpdateService,不注册 updater 监听;隐藏更新面板

窗口、配置、主题、角色授权和原生基础操作始终保留。storage 当前包含 JSON 与 SQLite,适合模板的演示组合;若产品只需要其中一种,再按真实需求拆开服务。关闭服务不会删除已有用户数据,也不会自动删除依赖或缩减安装包。

最小配置验证

可以修改配置并重新构建,或使用只能关闭能力的启动参数:

pnpm build
pnpm exec electron . --disable-capabilities=files,storage,credentials,updates

启动参数不能开启部署配置已经关闭的能力。未知名称会被拒绝。已打包程序也支持该参数;它不绕过来源、角色或输入输出校验。能力在一次应用运行期间固定,不支持 renderer 动态开关。

类型与授权

API 的类型结构保持稳定,不让每个能力组合都产生一套客户端类型。禁用能力的 API 会经过正常角色和输入校验,再返回 PRECONDITION_FAILED / DISABLED,不会创建服务。对应订阅也拒绝建立。

app.info 的 capabilities 由实际构造出的服务生成,renderer 据此展示功能。moduleIds 只展示本次启用的路由组。配置不是方法授权清单;方法权限仍定义在所属 procedure。

新增可选能力

需要资源的能力使用 optionalService 在入口构造,立即登记 Scope 清理;所属 router 通过 requireCapability 显式取得服务。只有真正需要部署选择的能力才添加开关,普通业务接口不需要自动升级为插件。

验证至少包含:关闭时构造函数不执行、调用与订阅被拒绝、界面不创建对应功能、开启后行为正常、退出释放资源。真实 Electron E2E 已覆盖默认组合及全部可选能力关闭的组合。