Cocainate：开源跨平台命令行防睡眠工具 #

说明：本文档依据项目官方仓库地址（https://github.com/AppleGamer22/cocainate）与官方提供的安装包信息整理。该项目未提供独立的产品官网页面，因此涉及具体命令参数、版本更新日志、系统版本兼容范围等细节，本文标注为“官网未说明”，请以仓库 README 与实际运行时的 --help 输出为准。

Cocainate 是什么？ #

Cocainate 是一款开源、跨平台的命令行防睡眠工具，用于阻止电脑在执行长任务时自动进入睡眠或待机状态。

在下载大文件、编译代码、渲染视频、运行数据处理脚本、进行远程演示或长时间挂机测试时，系统默认的节能策略往往会触发睡眠，导致网络中断、任务暂停甚至执行失败。Cocainate 正是为解决这一痛点而设计：它以极简的命令行方式接管系统的电源空闲判断，让你在需要的时间窗口内保持设备持续唤醒。相比在系统设置中手动关闭睡眠、用完再改回来，Cocainate 的优势在于“按需启用、随时结束、可脚本化调用”，安装在 3～4 MB 量级，几乎不占用系统资源。对于偏好终端操作的开发者、运维人员和自动化场景使用者来说，它比图形化工具更契合工作流。

Cocainate 有哪些亮点特色？ #

• 命令行驱动，天然适配脚本与自动化：Cocainate 以命令行形态运行，可被 Shell 脚本、CI 流水线、定时任务（如 cron、任务计划程序）直接调用，把“保持唤醒”这一动作嵌入到既有的自动化流程中，无需人工点击界面。
• 专注核心场景：阻止系统自动睡眠：工具聚焦单一目标——在需要时阻止设备进入睡眠状态，减少无关功能带来的学习成本与资源开销，适合“下载完就退出”“编译结束就恢复”这类可控时长的任务。
• 安装包轻量，资源占用低：官方提供的安装包体积在 3.4 MB 至 3.8 MB 之间，属于典型的轻量级终端工具，解压即可得到可执行文件，对磁盘与内存的压力几乎可以忽略。
• 覆盖主流平台与双架构：官方同时提供 macOS（amd64 / arm64）与 Windows（amd64 / arm64）四个构建包，兼顾 Intel 与 Apple Silicon Mac、x64 与 ARM64 Windows 设备，无需依赖转译层运行。
• 开源免费，可审计可二次开发：项目以开源形式在 GitHub 托管，源码公开，用户可以自行审查行为逻辑、按需修改或自行编译；同时也意味着没有授权费用与订阅绑定。
• 解压即用的绿色形态：官方分发包为 .tar.gz（macOS）与 .zip（Windows）压缩包，不含安装程序与后台服务，使用完毕后直接删除可执行文件即可完成卸载，不留驻留进程。
• 适合远程与无人值守场景：在远程桌面、远程终端会话、长时间数据同步等无人值守场景下，保持主机唤醒是任务连续性存在的前提，Cocainate 用一条命令即可完成状态切换。

提示：以上亮点基于项目定位与官方分发信息整理。具体支持的参数、可配置的时长、是否包含电池状态感知等细化能力，官网未说明，请以仓库 README 与 --help 输出为准。

免费下载 Cocainate #

以下为官方提供的各平台安装包，点击链接即可前往下载（官方托管于夸克网盘）。请根据你的操作系统与处理器架构选择对应文件：Apple Silicon（M 系列）Mac 选 arm64，Intel Mac 选 amd64；普通 x64 Windows 电脑选 amd64，ARM64 设备（如骁龙平台笔记本）选 arm64。

说明：上述文件版本号统一为 1.1.4，文件时间戳与体积来自官方分发记录。Linux、Android、iOS 等其他平台是否提供构建包，官网未说明。

Cocainate 如何使用？ #

Cocainate 属于“解压即用”的终端工具，使用流程非常短。以下为通用操作路径，具体参数名称请以实际运行 --help 的结果为准。

1. 确认可执行文件位置：下载对应平台的压缩包并解压，得到 Cocainate 的可执行文件。macOS 下为解压后的二进制文件，Windows 下为 .exe。
2. 打开终端：macOS 使用“终端”或 iTerm2；Windows 使用 PowerShell 或 Windows Terminal。建议在可执行文件所在目录打开终端，或先将其加入 PATH。
3. 先查看帮助信息：首次使用建议先执行帮助命令（如 cocainate --help 或 cocainate -h），确认当前版本支持的全部参数与选项，这是了解该工具能力边界最准确的方式。
4. 启动保持唤醒：在终端中运行 Cocainate 的主命令，进入“阻止系统睡眠”状态。此时可以最小化终端窗口，去执行你的下载、编译、渲染等长时间任务。
5. 结束并恢复默认电源策略：任务完成后，在终端按 Ctrl + C 中断进程，或按工具提示的退出方式结束；确认进程已退出后，系统即可按原有节能设置正常进入睡眠。

小贴士：

• 若希望 Cocainate 与具体任务绑定，可写成一行命令链，例如“先启动保持唤醒、再执行任务、结束后退出”，这样无需人工记忆开关状态。
• 在远程 SSH 会话中使用时，请确保会话本身不会因网络断开而终止（可配合会话保持工具）。
• macOS 用户如仅需一次性临时防睡眠，系统自带的 caffeinate 命令也可作为轻量替代；Cocainate 的价值更多体现在可读性、可扩展与跨平台一致性上（具体差异官网未说明）。

Cocainate 的常见问题？ #

Q1：Cocainate 和 macOS 自带的 caffeinate 有什么区别？ macOS 自带 caffeinate 是系统内置的防睡眠命令，无需额外安装；Cocainate 是第三方开源实现，同时提供 Windows 构建版本，便于在 Mac 与 Windows 之间保持一致的命令习惯。两者在具体参数与功能覆盖上的差异，官网未说明，建议对照仓库 README 后再做选择。

Q2：运行 Cocainate 需要管理员权限吗？ 作为用户态的命令行程序，通常不需要管理员权限即可运行；但若你把可执行文件放入系统级目录（如 macOS 的 /usr/local/bin），则写入该目录的步骤可能需要 sudo。程序本身是否请求提权，官网未说明。

Q3：Cocainate 能让屏幕保持常亮吗？ Cocainate 的定位是阻止系统进入睡眠/待机，属于电源空闲层面的控制。是否同时阻止显示器关闭或屏幕保护，取决于其实现的电源断言类型，官网未说明。若你需要屏幕常亮，可结合系统显示设置一并调整。

Q4：Windows 版本与 macOS 版本功能完全一致吗？ 官方为两个平台分别提供构建包，说明项目具备跨平台支持。但不同平台底层电源管理机制不同，功能细节可能存在差异，官网未说明各平台的具体功能对齐情况。

Q5：下载后提示“无法打开，因为无法验证开发者”怎么办？ 这是 macOS 对未签名或未公证应用的默认拦截。可在“系统设置 → 隐私与安全性”中允许该程序运行，或右键点击可执行文件选择“打开”。若你介意来源验证，也可直接从官方仓库获取源码自行编译。

Q6：任务结束后忘记关闭 Cocainate 会怎样？ 设备将持续保持唤醒，可能导致耗电增加、发热上升，笔记本合盖后也不一定进入睡眠。建议养成任务结束即退出的习惯，或在脚本中使用命令链确保自动退出。若不确定是否仍在运行，可在终端或任务管理器中查找对应进程并结束。

Cocainate 如何安装？ #

Cocainate 不提供传统的安装向导，整体属于“解压 + 加入路径”的绿色安装方式。

macOS #

1. 根据芯片类型下载 cocainate_1.1.4_mac_arm64.tar.gz（Apple Silicon）或 cocainate_1.1.4_mac_amd64.tar.gz（Intel）。
2. 双击解压，或在终端执行：tar -xzf cocainate_1.1.4_mac_arm64.tar.gz。
3. 为可执行文件添加执行权限：chmod +x ./cocainate。
4. （可选）移动到系统 PATH 目录，便于全局调用：sudo mv ./cocainate /usr/local/bin/。
5. 验证：在终端执行 cocainate --help，若能看到帮助信息即安装成功。
6. 首次运行如被 Gatekeeper 拦截，前往“系统设置 → 隐私与安全性”点击“仍要打开”，或对文件右键选择“打开”。

Windows #

1. 根据设备架构下载 cocainate_1.1.4_windows_amd64.zip（x64）或 cocainate_1.1.4_windows_arm64.zip（ARM64）。
2. 使用资源管理器或解压软件将压缩包解压到一个固定目录，例如 C:\Tools\cocainate\。
3. （可选）将该目录加入系统环境变量 PATH：设置 → 系统 → 系统信息 → 高级系统设置 → 环境变量 → 编辑 Path → 新建，填入解压目录。
4. 打开 PowerShell 或 Windows Terminal，执行 cocainate --help 验证是否可正常调用。
5. 如遇 SmartScreen 提示“Windows 已保护你的电脑”，点击“更多信息 → 仍要运行”。

Linux 及其他平台 #

官方分发信息中未包含 Linux 构建包，是否支持及安装方式官网未说明。如有需要，可关注项目仓库的构建说明或自行从源码编译。

注意：以上命令示例中的可执行文件名以官方压缩包内实际名称为准；若解压后名称不同，请相应替换。

Cocainate 如何卸载？ #

Cocainate 不写入系统服务、不创建开机启动项（以实际版本行为为准，官网未说明），因此卸载过程主要是删除可执行文件与可能残留的配置。

macOS #

1. 结束正在运行的进程：在对应终端按 Ctrl + C，或执行 pkill cocainate。
2. 删除可执行文件：若安装在系统目录，执行 sudo rm /usr/local/bin/cocainate；若放在自定义目录，直接删除该文件即可。
3. 清理可能的用户级配置文件：检查 ~/Library/Application Support/、~/Library/Preferences/、~/.config/ 下是否存在与 cocainate 同名的目录或文件，如有则手动删除（是否存在配置文件官网未说明，请按实际排查）。

Windows #

1. 结束正在运行的进程：在任务管理器中查找 cocainate 相关进程并结束，或在 PowerShell 执行 Stop-Process -Name cocainate。
2. 删除解压目录：直接删除你放置可执行文件的文件夹（如 C:\Tools\cocainate\）。
3. 清理环境变量：若此前把该目录加入了 PATH，回到“环境变量”设置中删除对应条目。
4. 清理可能的残留配置：检查 %APPDATA% 与 %LOCALAPPDATA% 下是否存在 cocainate 相关文件夹，如有则删除。

通用提示 #

• 卸载后建议重启一次终端，确保 PATH 环境变量中的旧条目不再生效。
• 若你曾通过包管理器或自行编译安装，请使用对应的卸载方式（如删除编译产物或执行 make uninstall，是否存在该目标官网未说明）。
• 卸载完成后，系统将恢复原有的电源与睡眠策略，无需额外还原系统设置。