用于 Windows 桌面管理的工作区实用工具

PowerToys 工作区是一个桌面管理器实用工具,可帮助你单击一下即可将应用程序启动到自定义位置和配置。 此Windows桌面管理工具可让你更快地进入任何项目或活动的理想桌面状态。 可以使用编辑器将桌面状态捕获为新工作区,将参数添加到应用以在启动时配置其状态,并将工作区固定为快速启动的桌面快捷方式。

启用

若要开始使用工作区,在“设置”中 PowerToys 启用它。

创建一个新工作区

通过从PowerToys工作区设置中选择“启动编辑器”或使用快捷方式 ⊞Win+ Ctrl+` 打开编辑器。

工作区编辑器界面的 PowerToys 屏幕截图,其中显示了工作区创建选项。

单击“+ 创建工作区”以调用捕获体验 - 在此视图中,桌面功能完全正常,并且你能够打开、关闭和重新定位应用,使应用进入所需的布局。 请先按照您喜欢的方式排列应用,然后选择“捕获”。

显示应用排列选项的 PowerToys 工作区捕获体验的屏幕截图。

捕获后,将输入编辑器,可在其中命名工作区、调整窗口大小、添加命令行接口 (CLI) 参数、删除应用和创建桌面快捷方式,然后最终保存工作区。

捕获后显示工作区编辑选项的 PowerToys Workspaces 编辑器界面截图。

启动工作区

通过从编辑器中的工作区列表中选择“启动”来启动工作区,或者在最初保存工作区时选择创建工作区时使用桌面快捷方式启动工作区。 还可以将快捷方式固定到任务栏,方便启动。

工作区的使用方法

当工作区启动时,PowerToys 将显示一个对话框,其中显示了每个应用的状态。 每个应用将具有以下状态之一:

符号 状态
绿色对勾 应用已成功启动并重新定位。
加载圆圈 应用正在启动并移动到正确的位置。
红色 X 应用无法启动。

一旦所有应用都正确启动并排列在所需的位置,对话框就会自行关闭。 也可以随时自行关闭对话框,或使用它取消启动。

命令行接口(预览版)

重要

工作区 CLI 在 PowerToys 预览版本中提供,其中包括 PowerToys.Workspaces.CLI.exe。 不要假设已安装的稳定版本包含它。 有关预览更新选项,请参阅 PowerToys 更新通道。

使用 CLI 列出保存的工作区、检查其配置或启动一个工作区。 它不会捕获、创建、导入、编辑或删除工作区。 若要创建或更改布局,请使用 Workspaces 编辑器。

在运行PowerToys或之前,先在launch中启用工作区。 组策略将覆盖用户设置。 CLI 不会启用该模块,并且在启用 Workspaces 时,PowerToys 无需运行。 即使禁用模块,帮助和版本命令也能正常工作。

安装程序将 PowerToys 安装目录的 bin 文件夹添加到 PATH。 安装后打开新终端,然后运行:

PowerToys.Workspaces.CLI.exe --help
PowerToys.Workspaces.CLI.exe --version
PowerToys.Workspaces.CLI.exe list

如果 Windows 找不到命令,请检查预览版安装是否包含 bin\PowerToys.Workspaces.CLI.exe。 不要将安装根或 WinUI3Apps 文件夹添加到 PATH;这些文件夹包含应用程序和运行时 DLL。

选择并启动工作区

使用 list 查找工作区名称和 ID。 对于所选工作区,请准确指定 --name 或 --id 其中之一。 名称与整个保存的名称匹配,忽略大小写。 如果多个工作区具有相同的名称,请使用 ID。 GUID 可接受大写或小写,带或不带大括号。

以下示例使用名为 的已保存工作区。 将其替换为您的工作区名称。

PowerToys.Workspaces.CLI.exe list --name "Development" --details --json
PowerToys.Workspaces.CLI.exe launch --name "Development" --timeout 120 --json

您可以使用 --id "{workspace-guid}" 返回的 ID,将 list 替换为 --name "Development"。 该 --details 选项需要选择器,并且仅适用于 list。 详细信息输出包括保存的路径和命令行参数,因此请保护保存或共享的任何输出。

启动将等待引擎的最终结果。 默认超时为 120 秒; --timeout 接受 1 到 600 秒。 启动使用保存的 移动现有窗口 和每应用管理员设置。 它禁止编辑器和启动进度 Windows,但应用程序 Windows、Windows UAC 提示和工作区签名确认对话框仍会显示。 在交互式桌面会话中运行它,而不是假定不会出现提示的无人参与操作。

按 Ctrl+C 请求取消。 已启动的应用保持打开状态,窗口位置不会回滚。 不要自动重试超时启动:结果可能未知,另一次尝试可以打开其他应用。

JSON 输出和错误

将list添加到launch或--json,用于一个 UTF-8 JSON 文档。 成功的列表具有顶级 view 和 workspaces 属性。 该 workspaces 数组对于所选工作区仍然是一个数组,如果没有已保存的工作区,则为空。 失败的查询返回错误,而不是空的成功列表。

启动响应和错误使用一种封装结构,其中包含 state、schemaVersion、command,以及 result 或 error。 在脚本中,检查进程退出代码和 error.code,而不是匹配本地化消息。 在 PowerShell 中,命令后立即读取 $LASTEXITCODE 。

退出代码 Meaning
0 操作已完成。 对于启动,引擎确认了每个应用的配置;这并不确认文档或选项卡已完成加载。
2 命令、选项或选择器语法无效。
3 没有工作区与选择器匹配。
4 该名称与多个工作区匹配。 请改为按 ID 选择。
6 工作区因用户或策略被禁用、策略查找失败,或所需组件不可用。 检查 error.code,例如 disabledByUser 或 disabledByPolicy。
9 截止时间已过期或结果未知。 不要自动重新打开。
10 一个或多个应用程序操作失败、已跳过或没有已确认的窗口排列。
12 已确认取消。

其他非零退出代码也表示失败。 有关完整的退出代码和输出协定,请参阅GitHub上的 Workspaces CLI 参考。

编辑工作区

首先启动编辑器并选择要编辑的工作区。 在该布局的编辑视图中,可以删除应用,通过每个应用的下拉菜单手动修改窗口位置,或选择“启动和编辑”以启动布局并重新输入与首次创建时相同的捕获体验。

注意

已调整的工作区将进行彻底的重新捕获,之前的所有 CLI 参数和设置都将被删除。 可以在必要时还原重新捕获以返回到原始工作区。

向应用程序添加 CLI 参数

若要启动处于所需状态的应用,可以在其各自的下拉菜单中将 CLI 参数添加到每个应用。 这些参数特定于应用本身,并在启动时与应用一起调用。 在下面的例子中,Visual Studio Code (VS Code) 被启动到路径中提供的文件,而终端被启动到“Ubuntu”配置文件。

编辑器中的 CLI 参数

可以在下面找到有关 VS Code 和终端 CLI 参数的详细信息:

提示

每个应用都有自己的一组命令行参数,可用于修改启动行为,但许多应用使用类似的模式。 例如,尝试将 URL 列表以逗号分隔传递给 Edge 和其他浏览器,以便启动浏览器并打开这些选项卡,或者将文件路径传递到 Office 应用程序、文本编辑器或 IDE 直接打开该文件。

以管理员身份启动应用

若要以管理员身份启动应用,请在相应应用的下拉菜单中选择“以管理员身份启动”框。 启动时,将为每个设置为以管理员身份启动的应用显示用户帐户控制 (UAC) 对话框。

如果设置为以管理员身份启动的应用是 EXE 文件,并且 PowerToys 无法验证其数字签名(例如,因为该文件未签名,其签名与其内容不匹配,或者证书已被吊销),则 Workspaces 会在启动之前请求确认。 “ 以管理员身份运行此应用?” 对话框显示应用、其位置以及无法验证签名的原因。 选择以下选项之一:

  • 跳过此应用 (默认值):工作区不会启动应用,在启动状态对话框中显示为 “跳过” ,并继续在工作区中启动其他应用。 按 Esc 或关闭对话框也会跳过该应用。
  • 无论如何运行:Workspaces 仅限本次以管理员身份启动该应用。 系统不会记住你的选择,因此下次启动工作区时,系统会再次询问你。

展开 “详细信息 ”以查看应用的命令行参数和 Windows 验证状态,然后选择 “复制详细信息 ”以将此信息复制到剪贴板。 你的选择不会替换用户帐户控制,因此 Windows 仍可能要求管理员权限。 不会检查不是 EXE 文件(如打包的应用)的应用。

重要

有一个已知问题,即以管理员身份启动的应用无法重新定位到所需的布局。 团队正在积极为即将发布的版本制定修补程序。

打开新窗口与重新定位现有窗口

如果桌面上已经打开了应用程序的现有实例,则不同的应用在启动时的行为可能不同-某些应用将重新定位现有实例,而其他应用则默认可能会启动新实例。 如果为工作区启用了“移动现有窗口”选项,则任何现有应用将移动到工作区中所需的位置,其余应用会照常启动。 为了根据用户首选项进行定制,建议通过可用的 CLI 参数处理启动行为。

例如,VS Code 默认将启动一个新窗口,但如果用户更喜欢移动现有窗口, --reuse-window CLI 参数可以添加到 VS Code 的 CLI 参数。

注意

某些应用是“单实例”应用程序,这意味着一次可能只有一个活动应用实例打开。 其中一个示例是 Windows 设置。 默认情况下,这些应用(如果已处于活动状态)将重新定位,并且无法启动新实例。

常见问题

以下是有关 PowerToys 工作区的一些常见问题和解答:

  • 为什么应用窗口启动后会跳到我保存的位置上?

    PowerToys 无法让应用启动到特定位置。 我们可以先启动应用程序,然后指示将其移动到某个位置并调整其大小。 但是,这会导致用户明显看到屏幕上的过程。 为了帮助解决这一限制,我们在启动过程中添加了对话框,显示了每个应用的启动状态。

  • 保存工作区时,我的窗口已对齐,但当我从初始状态启动工作区时,它们并没有对齐。 为什么会这样?

    PowerToys 在底层使用公开可用的 API 和 FancyZones 引擎来放置应用。 遗憾的是,这不包括吸附功能。

  • 如何将工作区固定到任务栏?

    可以先为工作区创建桌面快捷方式,然后将其固定到任务栏。 目前不支持将工作区直接固定到任务栏。

设置

设置 说明
激活快捷方式 若要更改默认热键,请单击该控件并输入所需的组合键。

安装 PowerToys

此实用工具是面向电力用户的 Microsoft PowerToys 实用工具的一部分。 它提供了一组有用的实用工具来优化和简化 Windows 体验,以提高工作效率。 若要安装 PowerToys,请参阅安装 PowerToys。