What makes MacCheck notable?

1.7K downloads. Trust evidence available

How should MacCheck be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

agentCLAWHUBUnverified

MacCheck

An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report. Skill: MacCheck Owner: iluoyao Summary: An Agent Skill for checking a Mac. It automatically inspects system and device information, opens a local page for guided hardware checks, and generates a downloadable inspection report. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-08-12T07:22:13.694Z | auto Initial release of mac-check-skill. - Launches a full, local hardware and system check for Mac devices, covering dev

OpenClaw

View on ClawHub Homepage

Rank

Safety

Downloads

1.7k

Updated

Oct 10, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.

Avoid when

Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor: Clawhubvendor · observed Oct 10, 2026
Protocol compatibility: OpenClawcompatibility · observed Oct 10, 2026
Adoption signal: 1.7K downloadsadoption · observed Oct 10, 2026
Latest release: 0.1.0release · observed Aug 12, 2026
Handshake status: UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s177w5h70hgnd1y6bqhat70s698caga7:mac-check-skill

Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-iluoyao-mac-check-skill/snapshot"

Documentation

CLAWHUB

16,600 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: mac-check-skill
description: 用于 Mac 验机。在当前 Mac 上进行一次完整的本地检测任务，可检测设备、系统、电池、安全、存储、网络等系统信息，以及内置页面工具可检测键盘、屏幕、声音、麦克风、摄像头、触控板和接口等信息。权限只读、数据本地、不联网，检测结果支持下载为 MD、PDF、PNG 报告。适用于 Mac 日常健康检查、新机或整备机验收、维修后复检、购买或出售前检查及故障排查。检测结果仅反映可观察到的状态，不构成 Apple 官方诊断、质量保证或交易承诺。
version: 2.0.1
author: Eddy
---

# Mac 验机助手

为用户启动一次完整、只读、默认离线的 Mac 检测。自动检测完成后，以本地 Session App 作为唯一操作界面；用户可在页面完成硬件检查、查看结论并直接下载报告。

## 使用边界

- 用户表达“验机”“Mac检测”“全面检查”“设备体检”“收货/维修验收”“购买或出售前检查”等完整检查意图时使用。
- 当前版本固定创建完整 Session；若用户只想了解某个单项，应直接回答或说明该项能力，不要悄悄启动整套流程。
- 支持能够在目标 Mac 上运行本地脚本并打开本地 HTML 的兼容 Agent 桌面宿主，不依赖特定产品、回调协议或对话持续运行。
- 根据当前对话选择 `zh-CN` 或 `en-US`；无法判断时使用 `zh-CN`。

## 无 Agent 终端运行

本项目也可以在没有 Agent 桌面端的情况下直接运行。下载或解压项目后，用户可打开“终端”，进入项目根目录并执行：

```bash
cd /path/to/mac-check-skill
/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN
```

英文界面将 `zh-CN` 改为 `en-US`。系统检测完成后会自动打开本地硬件检测页面；如果页面未能自动打开，可使用终端输出中的 `SESSION_HTML` 路径手动打开。此方式与 Skill 执行流程复用同一入口，不需要 `chmod`、`sudo`、清除隔离属性或安装额外依赖。

当 Agent 正在执行验机任务时，仍按下方“执行流程”直接调用入口，不要额外要求用户改用终端；仅在用户询问无 Agent 使用方法时提供上述说明。

## 执行流程

1. 简短告知用户：将运行只读系统检测，不使用管理员权限、不修改系统设置；默认不联网，也不上传序列号或结果。
2. 用户同意后，读取 [architecture.md](references/architecture.md)、[privacy.md](references/privacy.md) 和 [agent-runtime.md](references/agent-runtime.md)。
3. 必须显式使用 zsh 执行入口；不要依赖压缩包保留可执行权限，也不要要求用户 `chmod`：

```bash
/bin/zsh scripts/run-full-check.sh --output-root ./mac-check-output --locale <LOCALE>
```

4. 入口依次执行环境检查、Session 创建、系统采集、事实规范化、确定性规则判断、单文件 Session App 构建与打开。
5. 成功后只需说明：系统自动检测已完成，检查页面已经打开；请用户在页面继续硬件检测并下载报告。
6. 若系统不允许自动打开页面，向用户提供脚本输出的 `SESSION_HTML` 绝对路径。不要等待或要求用户把结果复制回聊天。

测试或用户明确不希望打开页面时：

```bash
/bin/zsh scripts/run-full-check.sh --output-root <DIR> --locale <LOCALE> --no-open
```

## 正确性与安全

- 只运行 [detection-catalog.md](references/detection-catalog.md) 中的只读命令；不使用 `sudo`、下载脚本、绕过锁定或修改系统的命令。
- Collector 只记录事实；Normalizer 只规范化；只有 [rule-spec.md](references/rule-spec.md) 的确定性规则可以生成结论。读取失败必须标为 `UNKNOWN`，不能伪装成通过。
- Session App 不执行 Shell、不读取相邻文件、不依赖 CDN、localhost、MCP、AI 回调或外部服务。Apple 保修入口只能由用户主动点击，页面不能后台提交序列号。
- 浏览器无法可靠观察的 Touch ID、物理接口、Force Touch 和感官质量必须采用清晰的引导验证，不得冒充自动检测。
- 不生成缺乏依据的综合评分，不写“放心购买”，不声称 Apple 官方检测或保证不存在任何管理与锁定风险。
- 系统数据必须序列化和转义后注入 HTML。完整序列号只保存在本地 Session 与报告中，页面不得把它发往网络；用户主动前往 Apple 官网查询保修时自行决定是否提交。

## 页面与报告

- 状态以页面当前内存为准，`localStorage` 仅作尽力恢复；页面不写回 `session.json`。
- 报告遵循 [report-spec.md](references/report-spec.md)。在线风险查询、支付、性能测试、硬盘测速和 AI 评估不属于当前阶段，相关 feature flag 保持关闭。

## 失败处理

- 单项命令失败：继续其他检测，将对应结果标为“无法读取/需要确认”。
- 设备身份完全无法读取：停止构建页面，保留诊断文件并说明原因。
- 页面构建失败：保留 `facts.json` 与 `system-results.json`，不要由 AI 临时拼接替代页面或报告。
- 麦克风或摄像头权限失败：页面标为“无法确认”并允许重试，不能直接判断硬件损坏。

README.md

# MacCheck Skill

[简体中文](README.md) | [English](README.en.md)

一款用于 Mac 检查的 Agent Skill。运行后会自动检测系统与设备信息，并打开本地页面，引导你完成键盘、屏幕、声音等硬件检查，最后生成可下载的验机报告。

## 能做什么

- 自动检查机型、系统、电池、存储、安全状态、网络和外设等信息。
- 引导检查键盘、屏幕、声音、麦克风、摄像头、Touch ID、触控板和接口。
- 自动识别不同 Mac 机型的硬件能力，并为未知新机型提供安全回退。
- 下载 Markdown、PDF 或 PNG 格式的验机报告。
- 支持简体中文和英文。

## 使用方法

下载或克隆本仓库，或在 Releases 中下载 `mac-check-skill.zip` 并解压，然后选择以下任一方式启动。

### 通过 Agent 使用

1. 在你使用的 Agent 桌面端（例如 WorkBuddy、Claude、Codex、Cursor 等），将本仓库作为 Skill 安装或导入。
2. 对 AI 说：

   > 帮我检查这台 Mac。

AI 会创建本次验机任务、自动完成系统检测，并打开硬件检测页面。按照页面引导完成检查后，即可直接下载报告。

### 通过终端使用

不使用 Agent 时，打开“终端”，进入解压后的项目根目录并运行：

```bash
cd /path/to/mac-check-skill
/bin/zsh ./scripts/run-full-check.sh --output-root ./mac-check-output --locale zh-CN
```

请将 `/path/to/mac-check-skill` 替换为实际项目路径。系统检测完成后会自动打开本地硬件检测页面；如果未能自动打开，请在终端输出中找到 `SESSION_HTML` 路径并手动打开。检测数据保存在项目根目录的 `mac-check-output` 中。

## 隐私说明

- 默认在本机离线运行，不主动上传检测数据。
- 系统检测均为只读操作，不会修改系统设置。
- 检测结果与报告保存在本地；公开分享前请留意序列号等设备信息。

## 使用提示

受浏览器和 macOS 权限限制，Touch ID、屏幕坏点、声音质量、触控板手感和接口物理状态等项目仍需用户配合确认。检测结果仅供参考，不替代 Apple 官方诊断。

## 致谢

本项目的部分产品思路与设计灵感来源于 [MacCheck](https://github.com/andyhuo520/MacCheck)，感谢原作者及贡献者的优秀工作。

_meta.json

{
  "ownerId": "kn77991za3nvfyfaq0fcgre66s8ca9xh",
  "slug": "mac-check-skill",
  "version": "0.1.0",
  "publishedAt": 1786519333694
}

references/agent-runtime.md

# Agent 桌面运行环境

P0 将真实 `Darwin` 主机视为可检查环境。运行 `scripts/runtime-check.sh <runtime.json>`，验证 `/usr/sbin/system_profiler`、`/usr/bin/osascript`、`/usr/bin/open` 等本地能力是否存在。

兼容宿主可能从压缩包、缓存目录或沙箱工作区安装 Skill，因此不能假设文件保留 Unix 可执行位。所有对项目内 shell 文件的调用都必须显式使用 `/bin/zsh <script>`；入口本身也必须由 Agent 以 `/bin/zsh scripts/run-full-check.sh ...` 启动。不得用 `chmod` 作为正常运行步骤。

文件系统沙箱本身并不等于系统信息不可读。每个只读 Probe 独立执行并记录 `OK / EMPTY / ERROR / TIMEOUT / SKIPPED`；一个命令受限时继续其他命令，并将相应事实标为 `UNKNOWN`。仅当设备身份完全不可用时才终止。

`/usr/bin/open` 不可用或 GUI 被宿主阻止时，仍生成完整 Session App，并把 `SESSION_HTML` 绝对路径交给用户手动打开。页面打开后不依赖 Agent 会话、宿主品牌或任何回传协议。

references/architecture.md

# 架构与会话

## 运行链路

```text
完整验机意图 → Runtime Guard → Session → Collector → Facts → System Rules
→ Self-contained HTML → Guided Hardware Flow → 页面报告
```

AI/Skill 只负责页面打开前的工作。页面打开后不需要 Result Token、AI 回调、localhost、MCP 或相邻文件读取。

## 目录

```text
<session>/
├── raw/
│   ├── <probe>.out
│   ├── <probe>.err
│   └── <probe>.meta.json
├── runtime.json
├── facts.json
├── system-results.json
├── session.json
└── MacCheck-<session-id>.html
```

## 状态

`SYSTEM_COLLECTING` → `SYSTEM_READY` → 页面内 `INTERACTIVE_IN_PROGRESS` → `READY_TO_REPORT` → `COMPLETED`。后四个页面阶段不写回磁盘 Session；浏览器状态只在内存和 best-effort `localStorage` 中维护。

## 设备能力匹配

`assets/data/device-capabilities.json` 将 `metadataOverrides` 与硬件能力规则分开：少量精确 Model Identifier 仅补充已验证的营销名称和年份，产品族、架构、芯片与代际规则才决定内建设备和接口能力。规则覆盖 MacBook Air、MacBook Pro、MacBook、Mac mini、iMac/iMac Pro、Mac Studio 与 Mac Pro；未来或无法识别的型号进入 notebook/desktop 保守回退。

macOS 没有稳定公开接口可读取所有空闲物理端口及机身位置。只有高置信规则可以声明完整接口布局；其余型号只列出有把握的接口，并增加“其他物理接口”人工检查项。未知值不得按 `true` 处理，也不得为了填满页面虚构 HDMI、SD、MagSafe 或接口数量。

## 控制权红线

- Shell 不判断健康状态。
- 页面不执行 Shell。
- LLM 不判断 `PASS/WARNING/BLOCKER`。
- 系统结果与交互结果使用同一 CheckResult 语义。
- P0 的 `featureFlags.riskChecks` 固定为 `false`。

Github ReposUpdated 13h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW

Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW

Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.