安装与首次启动¶

GhostClickAI 尚未正式发布，当前开发版暂未提供公开下载器、安装向导或最低硬件配置。本页说明已经取得完整 Windows 桌面构建后的首次准备流程。

适用范围

以下步骤适用于你已经从获准渠道取得的完整 Windows 桌面构建。若当前没有可用构建，应等待项目提供正式获取方式，不要从不明来源下载同名程序。

前置条件¶

一份完整的 GhostClickAI 桌面构建，而不是单独复制出来的可执行文件。
一个允许当前 Windows 用户写入数据的位置。
一组不会影响重要文件、账号或外部设备的测试数据。
如果要登录、检查更新、使用云端内容或获取可选组件，需要可用网络连接；本地编辑的首次初始化不以登录为前提。

操作步骤¶

1. 保持程序目录完整¶

如果当前构建以目录形式提供，请保留目录内的程序、资源和随附组件，不要只移动主程序。缺少随构建提供的文件时，设置页可能显示“内置组件缺失”，对应功能也无法正常使用。

当前文档不要求把程序放进某个固定系统目录。首次启动时，软件会优先尝试使用程序旁边的 data 目录；该位置不可写时，会改用 Windows 提供的应用数据位置。

2. 首次启动¶

启动 GhostClickAI 后，主窗口会居中打开。第一次初始化会准备软件管理的数据目录，并确保以下基础数据存在：

当前用户资料；
与系统语言对应的默认语言；
默认蓝图分类；
新蓝图模板；
至少一个基础 App 工作区；
保存界面选择、快捷键、任务记录和资源缓存所需的位置。

软件不会因为程序旁边不可写就删除已有数据；它会改用系统应用数据位置保存本次初始化内容。

3. 等待初始状态加载¶

主界面出现后，软件会依次读取用户资料、界面选择、自动运行预设、App 与自动化列表，以及通过启动参数传入的 .gcbp 或 .gcbps 文件。

部分可选功能会在界面出现后继续检查运行环境。如果初始化失败，界面会提示“运行环境加载失败，请重启软件后重试”。遇到该提示时，先保存能够保存的内容，再关闭并重新启动一次；不要反复点击尚未就绪的功能。

4. 完成最小安全准备¶

首次创建或运行自动化前，建议依次完成：

进入设置页，确认语言和主题。
暂时不要开启“自动运行预设列表”。
保持“删除蓝图确认”为“弹窗询问”。
如果显示器启用了 HDR，按实际显示环境决定是否开启“截图与录屏 HDR 模式”。
在文件管理中创建测试自动化，不使用唯一一份重要文件。
第一次运行前先用 Debug 验证目标和范围。

“开机自动启动”和“启动后自动后台运行”目前仍属于开发中界面项，不能作为已经接入 Windows 的可靠启动策略。

5. 可选：关联蓝图文件¶

设置页提供“关联 gcbps/gcbp 文件”。该功能只在 Windows 上可用，用于把当前程序与两种文件格式建立关联。

完成关联后，通过文件参数启动软件时，.gcbp 和 .gcbps 会被导入文件管理。文件关联不是首次启动的必要步骤；也可以直接在文件管理中导入。

结果¶

首次准备完成后，你应该能看到主工作区，可以打开文件管理和设置页，并能创建测试自动化。此时还不代表所有可选组件都已安装，也不代表外部操作目标已经配置。

常见问题¶

程序能打开，但功能提示组件缺失¶

先确认取得的是完整构建，再到设置页的组件中心查看状态。内置组件缺失时需要重新取得完整构建；可选组件没有本地安装内容或当前平台不支持时，按钮会保持不可用。

程序旁边没有出现 data 目录¶

这不一定是故障。程序旁边不可写时，软件会使用 Windows 应用数据位置。不要在软件运行期间移动或删除正在使用的数据目录。

启动后自动执行了自动化¶

设置页的“自动运行预设列表”可能已经启用，并选中了自动化。先在任务管理中停止任务，再回到设置页关闭该功能或取消对应自动化。

双击蓝图文件没有打开软件¶

文件关联不是默认安装前提。可以先从文件管理导入，或在设置页手动执行“关联 gcbps/gcbp 文件”。

首次启动后界面显示为空¶

先等待初始化完成并观察通知。如果出现运行环境加载失败，重启软件；如果本地数据曾被移动或清空，确认当前用户对程序目录或 Windows 应用数据位置具有写入权限。