bug.n 窗口管理工具安装与运行指南

bug.n 窗口管理工具安装与运行指南

bug.n Tiling Window Manager for Windows 项目地址: https://gitcode.com/gh_mirrors/bu/bug.n

系统要求与准备工作

bug.n 是一款基于 AutoHotkey 开发的 Windows 窗口管理工具，它可以将你的 Windows 桌面转变为类似平铺式窗口管理器的体验。在开始使用前，请确保你的系统满足以下要求：

最低系统配置：

• 操作系统：Windows 2000 或更高版本
• 运行脚本版本需要 AutoHotkey 1.1.10 或更高版本

获取与安装

bug.n 采用绿色免安装设计，获取方式有两种：

1. 稳定版本：推荐大多数用户使用，经过充分测试
2. 开发版本：包含最新功能，但可能存在不稳定因素

下载后你会得到一个压缩包，解压后包含以下内容：

• 可执行文件 (bugn.exe)
• 源代码目录 (src)
• 文档目录 (doc)

安装步骤极其简单：

1. 将压缩包解压到你喜欢的任何目录（需有写入权限）
2. 建议位置：C:\Program Files\bugn 或用户目录
3. 可创建快捷方式到开始菜单或任务栏方便启动

数据存储与配置

bug.n 默认会将以下数据存储在用户的应用数据目录中：

• 配置文件
• 窗口布局状态
• 运行日志

典型路径示例：C:\Users\你的用户名\AppData\Roaming\bug.n

自定义数据目录： 你可以通过命令行参数指定数据存储位置：

bugn.exe 你的自定义路径

注意：必须对指定目录有写入权限

运行方式

方法一：直接运行可执行文件

双击 bugn.exe 即可启动，适合大多数用户

方法二：通过 AutoHotkey 运行脚本

1. 确保已安装 AutoHotkey
2. 打开包含 Main.ahk 的目录
3. 右键点击该文件选择"用 AutoHotkey 运行"

管理员权限注意事项

在 Windows Vista 及以上系统中，如果你需要管理以管理员权限运行的应用程序窗口（如某些系统工具），则 bug.n 也需要以管理员权限运行。

设置方法：

1. 右键点击 bugn.exe
2. 选择"属性"
3. 切换到"兼容性"选项卡
4. 勾选"以管理员身份运行此程序"

开机自启动设置： 若需要 bug.n 随系统启动并以管理员权限运行，需通过任务计划程序创建任务：

1. 打开任务计划程序
2. 创建基本任务
3. 设置触发器为"当用户登录时"
4. 操作为"启动程序"，选择 bugn.exe
5. 在任务属性中勾选：
   • 仅在用户登录时运行
   • 使用最高权限运行

安全性与行为说明

bug.n 使用 AutoHotkey 的 ahk2exe 工具编译为可执行文件，其工作原理是将脚本与 AutoHotkey 解释器打包，运行时解压到内存执行。这可能导致某些安全软件误报，因为：

1. 使用了键盘钩子（用于实现快捷键）
2. 调用了 shellhook DLL（用于监控窗口创建/关闭）

这些行为都是 bug.n 正常功能所需，并非恶意行为。如果你担心安全性，可以：

1. 自行审查源代码
2. 使用提供的构建脚本重新编译
3. 验证文件哈希值是否匹配

常见问题解答

Q: 为什么我的杀毒软件报毒？ A: 这是误报，因为 bug.n 使用了系统钩子技术，你可以将程序添加到杀毒软件的白名单中。

Q: 如何确认我下载的是官方版本？ A: 可以校验文件的 SHA 指纹，或自行从源码编译。

Q: 运行后没有效果怎么办？ A: 请检查是否以管理员权限运行，特别是当你需要管理系统工具窗口时。

通过以上步骤，你应该已经成功安装并运行了 bug.n 窗口管理器。接下来可以开始探索它强大的窗口管理功能，提升你的 Windows 工作效率。

bug.n Tiling Window Manager for Windows 项目地址: https://gitcode.com/gh_mirrors/bu/bug.n