手机截图

功能概述

在 AI 聊天软件中说"手机截图"，自动通过 WebSocket 通知手机（AutoJS）截屏，手机将图片二进制数据直接传回电脑，保存为 PNG 文件后打开查看。图片传输为二进制直传，不转 base64。

环境说明

技能目录：$SKILL_DIR 指代本技能所在目录（包含 SKILL.md 的文件夹）。⚠️ $SKILL_DIR 仅为文档占位符，不是环境变量，执行命令时必须替换为实际绝对路径。
端口：固定使用 9421（HTTP + WebSocket 共用）
脚本目录：$SKILL_DIR/scripts/
截图保存目录：$SKILL_DIR/screenshots/
Node.js：需要已安装 Node.js（>= 18），若未安装则提示用户安装后结束任务
本技能运行命令时采用条件执行（前一条成功才执行下一条）：
- bash/zsh（Linux/macOS）：cmd1 && cmd2
- PowerShell 5（Windows）：cmd1; if ($?) { cmd2 }
- PowerShell 7+：&& 和 ; if ($?) { cmd2 } 均可
- 禁止单 &

前置条件

条件	说明
电脑已安装 Node.js >= 18	运行 `node -v` 检查，未安装则提示用户安装
手机已安装 AutoJS	需开启截图权限和无障碍服务
电脑与手机在同一局域网	手机通过 WiFi 连接到电脑同网段
手机 AutoJS 脚本已运行	手机端运行 `autojs-client.js`，需配置电脑 IP
中继服务器已启动	电脑端运行 `node server.js`

AutoJS 简介

当需要向用户提及 AutoJS（如提示安装、运行脚本时），若用户可能不了解它，应简短介绍并附上官网链接。

AutoJS 是什么：一款安卓（Android）设备的自动化工具，支持用 JavaScript 编写脚本，模拟点击、滑动、截屏等手机操作，无需 root。
官网：https://docs.autojs6.com/#/
适用场景：本技能通过它在手机端运行一个连接脚本，接收电脑指令完成截屏并回传图片。

介绍示例（供 AI 参考语气）：

AutoJS 是一款安卓自动化工具，可以用 JavaScript 脚本控制手机完成截屏、点击等操作。本技能需要它在手机端配合运行。官网文档：https://docs.autojs6.com/#/

执行步骤

意图判定

用户消息特征	执行动作
包含"手机截图"/"截屏手机"/"截取手机屏幕"/"phone screenshot"	进入【获取手机截图】流程
包含"关闭手机截图"/"停止手机截图"	进入【关闭服务器】流程

获取手机截图

步骤	执行动作	具体命令/操作
1	环境检查：Node.js	运行 `node -v`。若命令不存在，提示用户安装 Node.js 18+，任务结束。
2	环境检查：依赖	检查 `$SKILL_DIR/scripts/node_modules/ws` 目录是否存在。若不存在，运行 `cd "$SKILL_DIR/scripts" && npm install`。
3	检测服务器状态	运行健康检查命令（见下方【服务器检测命令】）。返回 `{"status":"ok"}` 说明已运行；连接失败说明未启动。
4	判断是否需要启动	若步骤 3 返回 `{"status":"ok"}`，跳到步骤 6。若连接失败，继续步骤 5。
5	启动服务器	将 `$SKILL_DIR` 替换为实际绝对路径，运行 `cd "$SKILL_DIR/scripts"; if ($?) { node server.js }`。必须使用非阻塞方式执行，因为服务器是长驻进程。
6	等待服务器就绪	运行 `Start-Sleep -Seconds 2`（Windows）或 `sleep 2`（Linux/macOS），等待服务器完成启动。然后再次运行步骤 3 的健康检查确认就绪。
7	检查手机连接	从步骤 3/6 的健康检查返回中读取 `phone` 字段。若为 `disconnected`，按【手机未连接提示】向用户介绍 AutoJS 并引导在手机上运行 `autojs-client.js` 脚本，任务结束。
8	触发截图	运行 `node "$SKILL_DIR/scripts/trigger.js"`。脚本输出图片的绝对路径。
9	打开图片	拿到图片路径后，必须调用 `image-pixel-viewer-yashu` 技能打开该图片。若用户电脑未安装该技能，先运行 `npx skills add https://github.com/steelan9199/wechat-publisher/tree/main/skills/image-pixel-viewer-yashu` 安装，安装完成后再调用该技能打开图片。

服务器检测命令

平台	命令
Windows (PowerShell)	`try { (Invoke-WebRequest -Uri "http://localhost:9421/health" -UseBasicParsing -TimeoutSec 2).Content } catch { "连接失败" }`
Linux/macOS (bash)	`curl -s --max-time 2 http://localhost:9421/health \|\| echo "连接失败"`

手机未连接提示

当健康检查返回 phone: "disconnected" 时，按以下要点回复用户：

简短介绍 AutoJS：参考【AutoJS 简介】中的介绍示例，说明它是什么、本技能为何需要它。
附上官网：给出链接 https://docs.autojs6.com/#/ ，便于用户下载安装与查阅文档。
引导运行脚本：告知用户在手机端 AutoJS 中运行 $SKILL_DIR/scripts/autojs-client.js，并需在其中配置电脑的局域网 IP。
前置条件须满足：手机与电脑在同一局域网、AutoJS 已开启截图权限和无障碍服务。
提醒截图权限弹框的同意按钮：脚本中有一段被注释的代码（约第 18-21 行），用于自动点击截图权限弹框的"同意"按钮。不同手机的按钮文案可能不同（如"立即开始"、"允许"、"同意"等），如果用户希望自动点击同意按钮，需要根据自己手机实际的按钮文案修改 text("立即开始") 中的文字，并取消该段代码的注释；若文案不匹配会导致自动点击失效。对代码不熟悉的用户也可保持注释状态，每次手动点击同意即可。

关闭服务器

步骤	执行动作	具体命令
1	终止占用 9421 端口的进程	Windows: `Get-NetTCPConnection -LocalPort 9421 -ErrorAction SilentlyContinue \| Select-Object -ExpandProperty OwningProcess \| ForEach-Object { Stop-Process -Id $_ -Force }`；Linux/macOS: `lsof -ti:9421 \| xargs kill`
2	确认已关闭	再次运行【服务器检测命令】，确认返回"连接失败"

输出格式

获取成功：告知用户截图已完成，并告知图片路径及已打开查看
手机未连接：按【手机未连接提示】向用户介绍 AutoJS 并引导运行手机端脚本
服务器未启动：提示正在启动服务器
Node.js 未安装：提示用户安装 Node.js 18+

错误处理

错误场景	错误表现	处理方式
Node.js 未安装	`node` 命令不存在	提示用户安装 Node.js 18+
ws 依赖未安装	`Cannot find module 'ws'`	运行 `cd scripts && npm install`
手机未连接	健康检查返回 `phone: "disconnected"`	按【手机未连接提示】介绍 AutoJS 并附官网链接，引导运行手机端脚本
截图超时	trigger.js 返回超时错误	检查手机 AutoJS 是否在前台运行、截图权限是否已授权
端口被占用	服务器启动报 `EADDRINUSE`	提示用户端口 9421 被占用，可先关闭旧服务器再重启

全业务脚本索引清单

脚本	功能
`$SKILL_DIR/scripts/server.js`	PC 端 WebSocket + HTTP 中继服务器（端口 9421），接收手机连接，提供截图触发接口
`$SKILL_DIR/scripts/trigger.js`	AI 触发脚本，调用服务器 HTTP 接口获取截图，输出图片路径
`$SKILL_DIR/scripts/autojs-client.js`	手机端 AutoJS 脚本，连接服务器，收到指令后截屏并发送二进制图片
`$SKILL_DIR/scripts/package.json`	npm 依赖配置（ws 库）

phone-screenshot-yashu