内容
# 一切皆 Maa
一切皆 Maa 是一个专注于 MaaFramework 项目的可重用 AI 技能工具包。其规范内容涵盖了项目创建和发现、流水线编写和生成、选项连接、图形分析、测试、历史审计和受保护的 CLI 操作。
> 状态：预发布开发基准。规范技能、原生插件清单、MCP 配置文件和安装程序已在本地实现和测试；npm 包和 GitHub 仓库尚未发布。
## 安装
在首次 npm 发布后，使用以下命令之一将安装到项目中：
```bash
npx everything-maa@latest install --target claude
npx everything-maa@latest install --target codex
```
对于本地检出，请将 `npx everything-maa@latest` 替换为 `node packages/cli/bin/everything-maa.js`。
在 GitHub 仓库公开后，Claude Code 也可以通过其自主市场安装原生插件：
```text
/plugin marketplace add https://github.com/KhazixW2/Everything-Maa
/plugin install everything-maa@everything-maa
```
默认的 `core` 配置文件安装所有九种技能并配置 MaaMCP。配置文件是显式且版本化的：
| 配置文件 | 已安装组件 |
| --- | --- |
| `skills-only` | 仅 Maa 技能 |
| `core` | Maa 技能 + MaaMCP |
| `authoring` | 核心 + create-maa-project 项目生命周期 MCP |
| `full` | 编写 + 隔离的 Playwright MCP |
有用操作：
```bash
npx everything-maa list
npx everything-maa doctor
npx everything-maa install --target codex --profile authoring
npx everything-maa install --target codex --profile full --dry-run
npx everything-maa uninstall --target codex
```
项目范围是默认的。通过 `--scope user` 可用用户范围技能安装；Claude 用户范围 MCP 合并被故意排除，因为它需要编辑 Claude 的共享全局配置。在这种情况下，请使用 `--profile skills-only`、项目范围或原生插件。
安装程序准确记录了它所拥有的内容。卸载仅在卸载的技能内容仍然与其记录的哈希值匹配时删除，保留无关的 MCP 条目，并将本地修改的内容保留在恢复状态。
## 核心技能
| 技能 | 目的 |
| --- | --- |
| `maa-cli-operate` | 通过 maafw-cli 运行可重复的设备、识别、操作和流水线操作。 |
| `maa-project-create` | 通过 create-maa-project 创建、扩展、诊断和更新 Maa 项目。 |
| `maa-project-init` | 扫描 Maa 项目并生成可重用的 `basic_info.md` 移交文档。 |
| `maa-pipeline-guide` | 设计和审查 MaaFramework 流水线 JSON。 |
| `maa-pipeline-generate` | 生成识别/操作节点和扫描 OCR ROI。 |
| `maa-pipeline-option` | 在 UI、流水线和 Python 之间连接运行时选项。 |
| `maa-pipeline-testing` | 验证资源、识别、自定义连接和运行时流程。 |
| `maa-pipeline-graph` | 映射流水线状态关系和外部 Python 条目。 |
| `maa-pipeline-history-audit` | 从 Git 历史中学习流水线和自定义约定。 |
项目特定的工作流程位于 `recipes/` 下，不作为核心技能安装。
## 仓库布局
- `skills/`：规范的 Maa 技能；每个目录都可以独立安装。
- `recipes/`：可选的项目或任务配方。
- `evals/`：技能评估案例，保存在已安装的技能有效载荷之外。
- `adapters/`：MaaHub 和未来代理程序的发行元数据。
- `distribution/`：每个支持的发布通道的版本状态和路径。
- `integrations/`：MCP 和可选 CLI 工具的运行时路由元数据。
- `mcp/`：版本化的 MCP 服务器目录和配置文件。
- `.claude-plugin/` 和 `.codex-plugin/`：原生插件清单。
- `packages/cli/`：无依赖的 Node.js 安装程序。
- `tests/`：可移植的固定装置和仓库不变量。
- `.github/workflows/`：跨平台 CI 和标签门控信任发布。
已完成的六阶段路线图和剩余的公共发布门控在 [docs/roadmap.md](docs/roadmap.md) 中记录。
## 开发
```bash
python -m pip install -r requirements-dev.txt
python -m pytest
python scripts/validate_skills.py
npm test
npm run release:check
npm pack --dry-run
```
更改 create-maa-project 集成时，还要运行联网的上游烟雾测试：
```bash
npm run smoke:create-project
```
更改 maafw-cli 集成时，运行其非设备上游契约烟雾测试：
```bash
npm run smoke:maafw-cli
```
当前基准支持 Python 3.10 及更高版本和 Node.js 18 及更高版本。不要假设技能已安装在 `.claude/skills`、特定驱动器字母或 Everything Maa 本身之下。
## 范围和依赖
Everything Maa 不提供 create-maa-project、MaaMCP、maafw-cli、Playwright MCP、MaaFramework 二进制文件或 OCR 模型的供应商。MCP 和 CLI 启动契约引用上游包并按 Everything Maa 发布版本固定版本。MaaMCP、create-maa-project 和实验性的 maafw-cli 技能需要 `uvx`；Playwright MCP 需要 `npx`。maafw-cli 按需运行，不会因配置文件而持久安装。
参见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) 获取许可边界，[README.zh-CN.md](README.zh-CN.md) 获取中文文档。
## 许可
Everything Maa 自己的技能、脚本、测试和文档在 [MIT License](LICENSE) 下发布。第三方运行时保留其上游许可。
Everything Maa 是一个社区项目，除非明确说明，否则它不是官方的 MaaFramework 发行版。
MCP 市场