> 译文仅供阅读便利。具有规范效力的是英文原文。

# 工具

元宇宙规范的参考工具。这些是最小的参考实现，意在让规范可被核验，而不是要做成产
品。规范以**逻辑命令名**（`mu-fingerprint`、`mu-validate` 等）来称引它们；本目录是
当前的那一份实现。

| 命令 | 文件 | 用途 |
|---------|------|---------|
| `mu-fingerprint` | `mu-fingerprint.ps1` | [MMAS-Interchange](../02-architecture/MMAS-Interchange.md) 所定**语义指纹**规范化的参考实现。 |
| `mu-validate` | `mu-validate.ps1` | 参考 MUIF 校验器：跑那些机器可查的抽象测试规程（V0-V2），并出具一份[校验报告](../schemas/validation-report.schema.json)。若无错误则以 0 退出。 |
| `mu-requirements` | `mu-requirements.ps1` | 从各份规范性文档重新生成 [`REQUIREMENTS-INDEX.md`](../REQUIREMENTS-INDEX.md)。 |
| `mu-spec-index` | `mu-spec-index.ps1` | 重新生成 [`spec-index.yaml`](../spec-index.yaml)，即所有文档的机器可读索引。 |
| `mu-test` | `../tests/run-tests.ps1` | 跑语义测试套件。 |

## 关于实现的一点说明

这些参考工具目前用 **PowerShell Core（`pwsh`）**写成，它在 Windows、macOS 与
Linux 上都跑得起来。之所以选它，是因为这份规范的撰写并不预设有 Node 或 Python 的工
具链。一套**与语言无关的 CLI**（`mu-*`，外加 `mu-diff`）已列入
[路线图](../MATURATION-ROADMAP.md)；上面那些逻辑命令名是稳定的，于是文档与 CI 都不
会依赖实现所用的语言。

## 怎样调用

```text
# logical command                         # current implementation
mu-fingerprint <file>                      pwsh tools/mu-fingerprint.ps1 <file>
mu-validate    <file>                      pwsh tools/mu-validate.ps1 <file>
mu-test                                    pwsh tests/run-tests.ps1
```

例如：

```text
mu-fingerprint examples/minimal-person/person.muif.json
# sha256:a628b2afb96dc673f7e2f9161569e573fc70892d10a6997fad7aaa14b04a639d
```