komorebi：Windows 上的平铺窗口管理器 #

komorebi 是什么？ #

komorebi 是一款运行在 Windows 10 及以上系统的平铺窗口管理器（Tiling Window Manager），它以 Microsoft 桌面窗口管理器（Desktop Window Manager, DWM）扩展的形式工作，而不是替换或接管整个桌面环境。

它允许你通过命令行工具 komorebic.exe 控制应用程序窗口、虚拟工作区和显示显示器，并可与 AutoHotkey 等第三方软件配合，实现完全由键盘驱动的窗口布局——窗口会按照预设的布局规则自动铺满屏幕，不再需要手动拖拽和调整大小。komorebi 默认对操作系统和桌面环境做尽可能少的修改，所有个性化调整都是用户在自己的配置文件中主动开启的可选项。对于习惯 Linux 平铺桌面（如 i3、bspwm）效率、又必须使用 Windows 的用户，komorebi 提供了一套可靠且高度可定制的替代方案。

komorebi 有哪些亮点特色？ #

• 作为 DWM 扩展运行，改动极小：komorebi 不替换 Windows 桌面环境，而是以窗口管理器的扩展形式接入，默认状态下几乎不修改系统设置，所有增强能力均由用户配置主动开启，降低了对系统的侵入性。
• 纯命令行驱动，快捷键自由定义：核心操作全部由 komorebic.exe 提供，官方文档列出了从窗口聚焦、移动、堆叠、调整尺寸到工作区与显示器管理的上百条子命令，可任意绑定到 whkd 或 AutoHotkey 的快捷键上。
• 虚拟工作区 + 多显示器支持：每个显示器可独立配置工作区与布局，支持 monitor-info 查看显示器序列号，并通过 display_index_preferences 把特定配置稳定绑定到特定显示器，多屏用户的布局不会因插拔或重启而错乱。
• 内置 7 种平铺布局：内置 BSP、VerticalStack、HorizontalStack、UltrawideVerticalStack、Rows、Grid、RightMainVerticalStack 等布局，可用 change-layout、cycle-layout 随时切换，并能针对特定工作区或特定窗口单独设置布局规则。
• 深度可定制的外观系统：支持边框颜色、宽度、偏移与边框样式定制，支持窗口透明度与透明度调节，还提供动画时长、动画帧率、动画风格等参数，让窗口切换与移动过程更顺滑。
• 自带状态栏 komorebi-bar.exe：官方提供一个与平铺窗口管理器深度集成的简洁状态栏，支持多种小部件与主题，可通过 komorebic bar-configuration 独立配置。
• 安装方式灵活：既可通过 Scoop、WinGet 等包管理器一键安装，也支持源码编译与离线安装，升级路径清晰，适合不同环境的用户。
• 个人免费、商业授权清晰：项目采用 Komorebi 2.0.0 许可证（基于 PolyForm Strict 1.0.0 分支），个人使用免费且可以自由地为自己做修改或向上游提交 PR，但禁止再分发与商业使用；需要在工作中使用的用户可购买 Individual Commercial Use License。

免费下载 komorebi #

以下为 komorebi 夜间构建（nightly）的各平台安装包，按处理器架构分为 ARM64 与 x86_64 两套，每套均提供 ZIP 压缩包与 MSI 安装包两种形式，点击链接即可下载。

提示：普通 64 位 PC 请选择 x86_64 版本；搭载骁龙等 ARM 芯片的 Windows 设备请选择 aarch64 版本。上述文件均为夜间构建版本，更新时间以页面标注为准。

komorebi 如何使用？ #

komorebi 的日常使用围绕「配置一次、长期生效」的思路展开，新手可按以下流程逐步上手：

1. 启动窗口管理器：安装完成后，在终端执行 komorebic start 启动 komorebi，此时窗口管理器开始接管新打开的应用程序窗口，并按布局规则自动平铺排列。
2. 生成示例配置：执行 komorebic quickstart 命令，它会为新用户生成一套示例配置文件（主要是 komorebi.json），其中已经包含显示器与工作区的基础结构，你可以在其基础上逐步修改。
3. 编辑配置文件：打开生成的 komorebi.json，在 "monitors" 字段中定义每个显示器下的工作区名称与布局，例如 "name": "I", "layout": "BSP"。需要多显示器时，为每台显示器各写一份工作区配置，并保证工作区名称互不重复。
4. 绑定快捷键：komorebi 本身不处理按键绑定，需要配合热键守护进程使用。可以在安装时一并安装 whkd，用它在 whkdrc 中把 komorebic.exe 命令映射到快捷键；如果你需要用到包含 Windows 键的组合键，官方建议使用 AutoHotkey 来处理，因为它绕开了 Microsoft 对 Win 键组合的限制。
5. 日常窗口操作：之后你只需用快捷键调用命令即可，例如 focus、move 切换焦点与移动窗口，stack / unstack 管理窗口堆叠，resize-edge、resize-axis 调整尺寸，move-to-workspace、send-to-workspace 在虚拟工作区之间搬运窗口，change-layout、cycle-layout 切换布局，border、transparency、animation 调整外观。
6. 设为开机自启：确认配置满意后，执行 komorebic enable-autostart，它会在 shell:startup 目录生成 komorebi.lnk 快捷方式，实现开机自动启动。该命令还支持 --whkd、--ahk、--bar、-f/--ffm 等参数，用于同时自启热键守护进程、AutoHotkey 脚本、状态栏，或启用 komorebi 自带的焦点跟随鼠标实现。

komorebi 的常见问题？ #

komorebi 和 whkd、AutoHotkey 是什么关系？ komorebi 是一款平铺窗口管理器，而不是热键守护进程，komorebi.exe 与 komorebic.exe 都不负责处理按键绑定。whkd 是一个简单轻量的热键守护进程，官方推荐新手先用它把 komorebic.exe 命令绑定到快捷键上。但 whkd 未针对 Microsoft 对 Win 键组合的限制提供变通方案，如果你的快捷键需要用到 Windows 键，官方建议改用 AutoHotkey。

komorebi 可以在公司电脑上使用吗？ 不能直接使用。komorebi 采用 Komorebi 2.0.0 许可证，个人使用免费，但不允许任何形式的商业用途（例如在工作中使用）。如需在工作场景中使用，需要购买专门的 Individual Commercial Use License，该许可仅在有效付费订阅期内、且仅对被许可的个人授予「商业使用」权限，其余条款与限制仍然适用。

为什么终端提示找不到 komorebi 相关命令？ 按官网说明，这类问题几乎都源于包管理器没有正确配置 $PATH 环境变量，导致已安装的可执行文件无法被终端识别。官方明确表示此类问题不应作为 bug 提交到 GitHub 仓库或 Discord 服务器，请先检查并修正 $PATH 配置。

多显示器下如何让固定配置始终作用于指定显示器？ 先在终端执行 komorebic monitor-info，它会列出所有已连接显示器的 id、name、device、device_id、serial_number_id 与分辨率信息。找到目标显示器的 serial_number_id 后，通过 display_index_preferences 即可把某套显示器配置固定绑定到指定显示器上，避免因插拔或重启导致配置错位。

使用 komorebi 前需要做哪些系统准备？ 官方强烈建议在安装前以管理员身份运行命令 Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name 'LongPathsEnabled' -Value 1 启用 Windows 长路径支持。同时建议在「控制面板 > 轻松使用 > 轻松使用中心 / 使计算机更易于查看」中勾选「关闭所有不必要的动画（如果可能）」，以获得最佳性能表现。

komorebi 会不会大幅修改我的系统？ 不会。komorebi 的设计目标是默认对操作系统和桌面环境做出尽可能少的修改，而且它并不是热键守护进程或系统美化套件。用户可以在自己的配置文件中做各种个性化设置，但这些改动始终是可选且默认关闭的，不会在未配置的情况下改变系统行为。

komorebi 如何安装？ #

komorebi 主要由两个核心可执行文件构成：包含窗口管理器本体的 komorebi.exe，以及用于向窗口管理器发送命令的 komorebic.exe；另外还附带一个状态栏程序 komorebi-bar.exe。官方提供多种安装途径，可按需选择。

安装前的准备工作（Windows 通用） #

1. 以管理员身份打开终端，执行以下命令启用 Windows 长路径支持：

   Set-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\FileSystem' -Name 'LongPathsEnabled' -Value 1
   

2. 在「控制面板 > 轻松使用 > 轻松使用中心 / 使计算机更易于查看」中，勾选「关闭所有不必要的动画（如果可能）」，以提升 komorebi 的运行表现。

方式一：通过 Scoop 安装 #

1. 确认已安装 Scoop，并且已安装的可执行文件位于 $PATH 中。
2. 添加 extras 存储桶：

   scoop bucket add extras
   

3. 安装 komorebi 与 whkd：

   scoop install komorebi whkd
   

4. 安装完成后，继续获取示例配置（komorebic quickstart）。

方式二：通过 WinGet 安装 #

1. 确认已安装最新版本的 winget，并且已安装的可执行文件位于 $PATH 中。
2. 通过 WinGet 安装 komorebi 与 whkd：

   winget install komorebi whkd
   

   如未直接命中，可先用 winget search komorebi 查找对应的包 ID 后再安装。

方式三：使用本页提供的安装包手动安装 #

1. 根据你的设备架构下载对应的安装包：64 位 Intel/AMD 电脑选择 x86_64，ARM 设备选择 aarch64。
2. 下载 .msi 安装包后双击按向导安装；下载 .zip 压缩包则解压到自定义目录，并将该目录加入系统 $PATH，以便在终端中直接调用 komorebi.exe 与 komorebic.exe。
3. 如需状态栏，可在配置完成后单独启动 komorebi-bar.exe，或使用 komorebic enable-autostart --bar 让其随 komorebi 一起自启。

方式四：从源码构建 / 离线安装 #

官网文档同样提供了「从源码构建（Building from source）」与「离线（Offline）」两种安装路径，适合需要自行编译或在内网、无外网环境中部署的用户；升级（Upgrades）章节则说明了后续版本更新的处理方式。

komorebi 如何卸载？ #

卸载 komorebi 的方式取决于你当初采用的安装途径，建议先关闭正在运行的 komorebi、komorebi-bar 与 whkd 进程，再进行卸载操作。

通过 Scoop 安装的卸载方式 #

1. 在终端执行以下命令卸载主程序与热键守护进程：

   scoop uninstall komorebi whkd
   

2. 如果还安装过其他相关包（例如状态栏或自选组件），可一并使用 scoop uninstall <包名> 移除。

通过 WinGet 安装的卸载方式 #

1. 在终端执行卸载命令，或先在 winget list 中确认包 ID 再卸载：

   winget uninstall komorebi whkd
   

2. 也可以打开「设置 > 应用 > 已安装的应用」，找到 komorebi / whkd 后点击卸载。

通过 MSI 安装包安装的卸载方式 #

1. 打开「控制面板 > 程序和功能」或「设置 > 应用 > 已安装的应用」。
2. 找到 komorebi，点击卸载并按向导完成操作。

清理残留配置与自启动项 #

1. 删除开机自启快捷方式：如果曾执行过 komorebic enable-autostart，请到 shell:startup 目录（即「运行」中输入 shell:startup 打开的启动文件夹）删除 komorebi.lnk，否则重启后可能出现找不到程序的报错。也可以在执行卸载前先运行 komorebic disable-autostart。
2. 删除配置文件：komorebi 的配置文件（如 komorebi.json、状态栏配置、whkdrc 等）通常保存在由 KOMOREBI_CONFIG_HOME 环境变量指定的配置目录中，卸载程序一般不会自动清理。如果不再使用，建议手动删除该目录，避免残留配置影响日后重装。
3. 恢复系统相关设置（可选）：安装时若修改过长路径支持或系统动画选项，可按个人需要决定是否还原；这两项属于系统级设置，保留通常不会带来副作用。