Skill 的作用
gclight-control 面向支持 Agent Skills 的 AI 客户端，是所有 GC Light 设备族的统一控制入口。当前 gcli 只支持 Mini，因此本版全部可执行操作均使用 gcli mini；这不代表其他设备族已经受支持。后续设备族将在同一 Skill 中扩展，而不是拆分为按设备命名的 Skill。它将自然语言请求转换为有边界、可验证的 gcli 命令，不直接实现串口协议。
它支持：
- 发现明确列出的候选串口；
- 查询设备身份、输出状态、电流、电压、温度、PD 数据和蓝牙状态；
- 设置电流、开启或关闭激光输出；
- 切换蓝牙、执行自检；
- 有界等待设备主动上报。
让 Agent 完成安装
官方 gclight-control Skill 包已发布到 GC-Light OSS，无需访问源码仓库。可将下面整段内容交给支持 Agent Skills 的 AI Agent：
请安装 GC Light 官方 gclight-control Skill 0.1.0，并完成仅文件与命令级的验证；安装期间不要连接或控制设备。
Skill 压缩包：
https://oss.gclight.com/skill/gclight-control/0.1.0/gclight-control-0.1.0.tar.gz
SHA-256 校验文件：
https://oss.gclight.com/skill/gclight-control/0.1.0/SHA256SUMS
下载两个文件，按 SHA256SUMS 校验压缩包；校验通过后解压，并通过客户端原生机制安装完整的 gclight-control 顶层目录。确认安装目录包含 SKILL.md、agents/openai.yaml 和 references/cli.md。优先复用已有 gcli；若不存在，按 GC-Light CLI 快速开始安装 0.1.0 版本。最后报告 Skill 安装位置、CLI 来源、CLI 路径和版本。
手动安装
1. 下载并校验 OSS 包
Skill 0.1.0 与同版本 gcli 配套。Linux 和 macOS：
VERSION=0.1.0
DOWNLOAD_DIR="$(mktemp -d)"
ARCHIVE="gclight-control-${VERSION}.tar.gz"
BASE_URL="https://oss.gclight.com/skill/gclight-control/${VERSION}"
curl --fail --location --retry 3 --output "$DOWNLOAD_DIR/$ARCHIVE" "$BASE_URL/$ARCHIVE"
curl --fail --location --retry 3 --output "$DOWNLOAD_DIR/SHA256SUMS" "$BASE_URL/SHA256SUMS"
(cd "$DOWNLOAD_DIR" && sha256sum --check SHA256SUMS)
tar --extract --gzip --file "$DOWNLOAD_DIR/$ARCHIVE" --directory "$DOWNLOAD_DIR"
SKILL_SOURCE="$DOWNLOAD_DIR/gclight-control"
Windows PowerShell：
$Version = "0.1.0"
$DownloadDir = Join-Path ([System.IO.Path]::GetTempPath()) ([System.Guid]::NewGuid())
$Archive = "gclight-control-$Version.tar.gz"
$BaseUrl = "https://oss.gclight.com/skill/gclight-control/$Version"
New-Item -ItemType Directory -Force -Path $DownloadDir | Out-Null
Invoke-WebRequest -Uri "$BaseUrl/$Archive" -OutFile (Join-Path $DownloadDir $Archive)
Invoke-WebRequest -Uri "$BaseUrl/SHA256SUMS" -OutFile (Join-Path $DownloadDir "SHA256SUMS")
$ChecksumLine = Get-Content (Join-Path $DownloadDir "SHA256SUMS") |
Where-Object { $_ -match " $([regex]::Escape($Archive))$" } |
Select-Object -First 1
if (-not $ChecksumLine) { throw "SHA256SUMS does not contain $Archive" }
$Expected = ($ChecksumLine -split "\s+")[0].ToLowerInvariant()
$Actual = (Get-FileHash -Algorithm SHA256 (Join-Path $DownloadDir $Archive)).Hash.ToLowerInvariant()
if ($Actual -ne $Expected) { throw "Skill SHA-256 verification failed" }
tar --extract --gzip --file (Join-Path $DownloadDir $Archive) --directory $DownloadDir
$SkillSource = Join-Path $DownloadDir "gclight-control"
校验失败，或解压后的顶层目录不是 gclight-control 时，停止安装并重新确认下载来源。
2. 安装完整 Skill 目录
优先使用客户端原生的 Skill 安装或注册功能，将 $SKILL_SOURCE（PowerShell 中为 $SkillSource）注册为 gclight-control。如果客户端只支持本地目录，把整个目录复制到其官方文档指定的 Skills 目录；不要只复制 SKILL.md。
mkdir -p "<SKILLS_DIR>"
cp -R "$SKILL_SOURCE" "<SKILLS_DIR>/gclight-control"
Windows PowerShell：
New-Item -ItemType Directory -Force -Path "<SKILLS_DIR>" | Out-Null
Copy-Item -Recurse -Path $SkillSource -Destination "<SKILLS_DIR>/gclight-control"
<SKILLS_DIR> 必须来自所用客户端的配置或官方文档，不要猜测。若目标目录已经存在，请使用客户端更新机制；不要叠加复制新旧文件。
3. 准备 gcli
先检查当前环境：
gcli --version
退出码为 0 且输出以 gcli 开头即可复用。若尚未安装，请按 GC-Light CLI 快速开始下载与平台匹配的独立程序，并确保启动 AI 客户端的环境可以从 PATH 找到它。
若预编译程序不支持当前平台，当前没有公共源码安装路径。不要尝试访问私有源码仓库，也不要下载架构不匹配的可执行文件。
验证安装
完成前只检查以下项目，不要用发现串口、开关激光、设置电流或切换蓝牙来测试安装：
- 已安装目录同时包含
SKILL.md、agents/openai.yaml与references/cli.md； - AI 客户端已加载名称为
gclight-control的 Skill，必要时按客户端说明重新加载； gcli --version退出码为0；- AI 客户端运行环境中的
gcli路径与安装时验证的路径一致； - 已报告 Skill 安装位置、CLI 安装来源、CLI 路径和版本。
下一步阅读使用与安全规则，然后从指定端口的只读查询开始。