---
read_when:
  - 更新 macOS Skills 设置 UI
  - 更改 Skills 门控或安装行为
summary: macOS Skills 设置 UI 和基于 Gateway 网关的状态
title: Skills
x-i18n:
  generated_at: "2026-02-03T10:08:09Z"
  model: claude-opus-4-5
  provider: pi
  source_hash: ecd5286bbe49eed89319686c4f7d6da55ef7b0d3952656ba98ef5e769f3fbf79
  source_path: platforms/mac/skills.md
  workflow: 15
---

# Skills（macOS）

macOS 应用通过 Gateway 网关展示 gensparx Skills；它不会在本地解析 Skills。

## 数据来源

- `skills.status`（Gateway 网关）返回所有 Skills 以及资格和缺失的要求
  （包括内置 Skills 的允许列表阻止情况）。
- 要求来源于每个 `SKILL.md` 中的 `metadata.gensparx.requires`。

## 安装操作

- `metadata.gensparx.install` 定义安装选项（brew/node/go/uv）。
- 应用调用 `skills.install` 在 Gateway 网关主机上运行安装器。
- 当提供多个安装器时，Gateway 网关仅展示一个首选安装器
  （如果可用则使用 brew，否则使用来自 `skills.install` 的 node 管理器，默认 npm）。

## 环境变量/API 密钥

- 应用将密钥存储在 `~/.gensparx/gensparx.json` 的 `skills.entries.<skillKey>` 下。
- `skills.update` 更新 `enabled`、`apiKey` 和 `env`。

## 远程模式

- 安装 + 配置更新发生在 Gateway 网关主机上（不是本地 Mac）。
