cli-link 0.0.1 → 0.0.3

package/README.md

@@ -18,11 +18,11 @@ AgentPilot 是一个移动端优先的 AI 编程 Agent 控制台。它把运行
 
 | 对话页面 | 代码页面 |
 | --- | --- |
-| <img src="public/对话页面.png" alt="对话页面" width="280"> | <img src="public/代码页面.png" alt="代码页面" width="280"> |
+| <img src="https://unpkg.com/cli-link@latest/dist/client/%E5%AF%B9%E8%AF%9D%E9%A1%B5%E9%9D%A2.png" alt="对话页面" width="280"> | <img src="https://unpkg.com/cli-link@latest/dist/client/%E4%BB%A3%E7%A0%81%E9%A1%B5%E9%9D%A2.png" alt="代码页面" width="280"> |
 
 | 历史记录 | 设置页面 |
 | --- | --- |
-| <img src="public/历史记录.png" alt="历史记录" width="280"> | <img src="public/设置页面.png" alt="设置页面" width="280"> |
+| <img src="https://unpkg.com/cli-link@latest/dist/client/%E5%8E%86%E5%8F%B2%E8%AE%B0%E5%BD%95.png" alt="历史记录" width="280"> | <img src="https://unpkg.com/cli-link@latest/dist/client/%E8%AE%BE%E7%BD%AE%E9%A1%B5%E9%9D%A2.png" alt="设置页面" width="280"> |
 
 ## 代码页面
 
@@ -73,9 +73,8 @@ RUNTIME
   CLI      codex (codex)
 
 MACOS LONG TASKS
-  手机长时间遥控任务前，建议先开启 Mac 防休眠，避免息屏后任务中断。
-  System Settings > Battery > Options >
-  开启“使用电源适配器供电且显示器关闭时，防止自动进入睡眠”。
+  已启用 caffeinate -i，当前服务运行期间会阻止 Mac 空闲休眠。
+  合盖或低电量等系统策略仍可能中断任务；长时间运行建议接入电源。
 ```
 
 默认行为：
@@ -196,13 +195,15 @@ VITE_ENABLE_PWA_DEV=true AGENTPILOT_HTTPS_KEY=/path/to/key.pem AGENTPILOT_HTTPS_
 
 ### 防止息屏后休眠
 
-如果要离开电脑、从手机继续遥控长任务，建议先打开 macOS 的防休眠选项：
+通过 `npx cli-link` 启动时，AgentPilot 会在 macOS 上自动运行 `caffeinate -i -w <pid>`，在当前服务进程存活期间阻止 Mac 空闲休眠。服务退出后，配套的 `caffeinate` 进程会自动结束。
+
+这个机制主要防止“空闲后自动睡眠”。合盖、低电量、系统强制睡眠或断电仍可能中断任务；如果要离开电脑、从手机继续遥控长任务，建议接入电源，并按需开启 macOS 的防休眠选项：
 
 1. 打开 `系统设置` -> `电池` -> `选项...`。
 2. 开启“使用电源适配器供电且显示器关闭时，防止自动进入睡眠”。
 3. 点击“完成”。
 
-这样电脑接入电源且显示器关闭后，AgentPilot 后端和底层 CLI 仍可以继续运行。
+这样电脑接入电源且显示器关闭后，AgentPilot 后端和底层 CLI 更不容易被系统睡眠中断。
 
 
 ## 安全风险与使用边界

package/bin/agentpilot.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { accessSync, constants, existsSync, readFileSync, statSync } from 'node:fs';
+import { spawn } from 'node:child_process';
 import { randomBytes } from 'node:crypto';
 import { dirname, delimiter, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
@@ -163,6 +164,32 @@ function detectCli() {
   return null;
 }
 
+function resolveCaffeinateCommand() {
+  if (isExecutable('/usr/bin/caffeinate')) return '/usr/bin/caffeinate';
+  if (commandExists('caffeinate')) return 'caffeinate';
+  return null;
+}
+
+function preventMacIdleSleep() {
+  if (process.platform !== 'darwin') return;
+  const caffeinateCommand = resolveCaffeinateCommand();
+  if (!caffeinateCommand) {
+    console.warn('[AgentPilot] caffeinate was not found. macOS idle sleep prevention is disabled.');
+    return;
+  }
+
+  const child = spawn(caffeinateCommand, ['-i', '-w', String(process.pid)], {
+    stdio: 'ignore',
+  });
+  if (child.pid) process.env.AGENTPILOT_CAFFEINATE = '1';
+
+  child.on('error', (err) => {
+    console.warn(`[AgentPilot] Failed to start caffeinate: ${err?.message || err}`);
+  });
+
+  child.unref();
+}
+
 async function main() {
   const options = parseArgs(process.argv.slice(2));
   const pkg = readPackageJson();
@@ -187,6 +214,8 @@ async function main() {
     throw new Error('AgentPilot server build is missing. Run `pnpm build` before using the NPX entry.');
   }
 
+  preventMacIdleSleep();
+
   let cliType = options.cli;
   let cliCommand = options.cliCommand;
   if (cliType && cliType !== 'codex' && cliType !== 'claude') {

package/dist/server/index.js

@@ -15,6 +15,7 @@ const HOST = process.env.HOST || '0.0.0.0';
 const MODULE_DIR = path.dirname(fileURLToPath(import.meta.url));
 const STATIC_DIR = resolveStaticDir();
 const IS_NPX_ENTRY = process.env.AGENTPILOT_NPX === '1';
+const MAC_IDLE_SLEEP_PREVENTED = process.env.AGENTPILOT_CAFFEINATE === '1';
 const AUTH_COOKIE_NAME = 'agentpilot_token';
 const AUTH_TOKEN = (process.env.AGENTPILOT_AUTH_TOKEN || '').trim();
 const AUTH_ENABLED = AUTH_TOKEN.length > 0;
@@ -2026,9 +2027,15 @@ function printMacSleepHint() {
     if (process.platform !== 'darwin')
         return;
     printSection('macOS long tasks');
-    console.log(`  ${colorize('手机长时间遥控任务前，建议先开启 Mac 防休眠，避免息屏后任务中断。', terminalStyle.yellow)}`);
-    console.log('  System Settings > Battery > Options >');
-    console.log('  开启“使用电源适配器供电且显示器关闭时，防止自动进入睡眠”。');
+    if (MAC_IDLE_SLEEP_PREVENTED) {
+        console.log(`  ${colorize('已启用 caffeinate -i，当前服务运行期间会阻止 Mac 空闲休眠。', terminalStyle.green)}`);
+        console.log('  合盖或低电量等系统策略仍可能中断任务；长时间运行建议接入电源。');
+    }
+    else {
+        console.log(`  ${colorize('手机长时间遥控任务前，建议先开启 Mac 防休眠，避免息屏后任务中断。', terminalStyle.yellow)}`);
+        console.log('  System Settings > Battery > Options >');
+        console.log('  开启“使用电源适配器供电且显示器关闭时，防止自动进入睡眠”。');
+    }
     console.log('');
 }
 function printStartupInfo() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-link",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "type": "module",
   "bin": {
     "cli-link": "bin/agentpilot.js"