WidgetWorkshop 领域词汇

统一组件创作、安装、运行和布局管理的用语。“桌面”涉及歧义时必须写出显示器或 Windows 虚拟桌面。

内容与运行

组件（Widget）：由作者创作、以网页呈现并通过平台能力与系统交互的内容单元。 避免：用“窗口”指整个组件作品。

组件包（Widget Package）：某组件某个版本的可安装内容，包含入口页面、描述与资源。 避免：把配置和个人数据当作发布包的一部分。

安装组件（Installed Widget）：用户从特定来源安装的组件，是授权、更新和卸载的管理对象。 避免：仅凭名称判断两个安装是否相同。

开发组件（Development Widget）：用户明确创建或加入开发的组件，拥有独立安装身份与本机源码绑定；不等同于全部本地组件。

组件实例（Widget Instance）：安装组件在一个显示器上的独立配置及运行身份；同一安装组件在同一显示器最多一个。 避免：用“实例”暗示可以在同屏添加同一组件多份。

启用意图（Enabled Intent）：用户希望某实例运行的持久选择，断屏或暂时失败不自动取消它。 避免：将启用开关直接等同于当前进程是否存在。

可见性（Visibility）：实例显示或隐藏的选择，不决定是否继续运行。 避免：把隐藏、暂停和停用互换使用。

空间与分享

显示器（Display）：布局和实例独立管理的物理显示输出目标。 避免：用编号顺序作为显示器的永久身份。

Windows 虚拟桌面（Windows Virtual Desktop）：Windows 任务视图管理的工作空间，首版不按其创建独立布局。 避免：与多显示器混称“多桌面”。

布局（Layout）：一个显示器上的组件、启用/显隐、静音、排布及配置的完整描述；当前显示状态和布局库副本使用同一格式。 避免：把授权或软件全局设置称为布局数据。

恢复快照（Restore Snapshot）：应用布局前保存的目标显示器状态，用于恢复排布和实例配置，不恢复授权。 避免：将其视为可绕过清理的完整个人数据备份。

工坊条目（Workshop Item）：Steam 创意工坊中可订阅的发布对象，内容可以是组件或布局。 避免：把已订阅直接等同于已安装。

授权与配置

Capability：宿主定义的6项可授权能力契约，目录见权限与基础接口。基础接口无需声明或授权，但仍遵守资源绑定和生命周期边界。 避免：把组件声明当作用户已经授权。

授权（Grant）：用户对安装组件使用某能力及相应资源绑定的许可。 避免：从布局、组件默认值或发布者声明自动推导授权。

资源绑定（Resource Binding）：用户在宿主中选择的目录、启动目标或秘密值的受控引用。 避免：把组件自行提供的路径视为已授权资源。

配置字段（Configuration Field）：作者声明、由管理界面呈现、仅保存在显示器布局对应条目中的设置项。 避免：把实例配置与浏览器持久存储或共享授权混为一谈。

共享进度

组件存档（Installation Save）：同一安装的所有实例自动共享的持久进度；独立于显示器布局及其中的配置。 避免：将它当作授权共享、布局快照或跨设备同步。

协作消息（Collaboration Message）：同一安装中实例发布并由其他实例读取的临时业务提示；最新值可以覆盖旧值。 避免：将其当作成功存档、可靠历史或另一实例的授权。