x11-window-check

X11 窗口截图取证技能。可枚举窗口、按标题匹配抓取 PNG，并输出元数据供 GUI 可视化自检。

仓库: ShouxinZhang/agent-game-j2me
最近来源活动: 2026年3月8日 15:56
检测到的 SKILL.md 语言: 中文
星标: 1
分支: 0

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

检查来源文件

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

返回搜索返回安装

name	x11-window-check
description	X11 窗口截图取证技能。可枚举窗口、按标题匹配抓取 PNG，并输出元数据供 GUI 可视化自检。

X11 Window Check Skill

这个技能用于在当前 X11 桌面会话里，对窗口做可复验的截图取证，支撑 FreeJ2ME 和后续工具界面的视觉检查。

何时使用

运行 FreeJ2ME 后，需要确认窗口是否真正出现。
自动化步骤完成后，需要抓取窗口证据供 agent 自检。
需要保存一份可追溯的 GUI 现场快照。

命令

1) 列出当前可见窗口

python3 .agents/skills/x11-window-check/scripts/x11_window_check.py list

2) 按标题抓取窗口

python3 .agents/skills/x11-window-check/scripts/x11_window_check.py capture --title "FreeJ2ME"

3) 指定输出文件

python3 .agents/skills/x11-window-check/scripts/x11_window_check.py capture \
  --title "FreeJ2ME" \
  --output docs/visual-checks/freej2me.png

4) 按窗口 ID 精确抓取

python3 .agents/skills/x11-window-check/scripts/x11_window_check.py capture \
  --id 0x800868 \
  --output docs/visual-checks/freej2me.png

依赖

xwininfo
import 或 xwd
ImageMagick（当前实现优先使用 import）

说明：

默认输出到 docs/visual-checks/<timestamp>/。
本技能只做抓图和元数据记录，不自动判断业务是否成功。