# MatrixOne Intelligence CLI 0.1.0

此压缩包包含 `moi-cli` 的 macOS Apple Silicon（`darwin/arm64`）可执行文件。

## 要求

- Apple 芯片 Mac。
- 可访问的产品 API 地址，且地址以 `/newmoi` 结尾。
- 具有工作区访问权限的个人访问令牌（PAT）。

## 安装

1. 解压下载包。
2. 在终端进入解压后的目录。
3. 将 `moi-cli` 移到你希望使用的目录，或直接从当前目录运行。

```bash
unzip moi-cli-0.1.0-darwin-arm64.zip
cd moi-cli-0.1.0-darwin-arm64
./moi-cli -version
```

输出 `moi-cli version 0.1.0` 表示二进制可以运行。

## 配置并验证

以下命令只读取当前 PAT 可见的工作区：

```bash
./moi-cli \
  -endpoint 'https://<你的域名>/newmoi' \
  -api-key '<你的个人访问令牌>' \
  -o workspace list
```

成功时会输出 JSON 格式的工作区列表。令牌使用原始值，不要添加 `Bearer` 前缀。

也可以保存常用配置：

```bash
./moi-cli config set-endpoint 'https://<你的域名>/newmoi'
./moi-cli config set-api-key '<你的个人访问令牌>'
./moi-cli config set-workspace '<你的工作区 ID>'
./moi-cli -o workspace list
```

CLI 将配置保存到 `~/.moi-cli.json`，文件权限为仅当前用户可读写。不要将该文件、令牌或包含令牌的终端历史提交到版本库或共享给他人。

## 当前发布限制

此版本仅带 ad-hoc 签名，尚未使用 Apple Developer ID 签名或完成 notarization。它已经通过本地和 QA 连通性验证，但从浏览器下载后，macOS Gatekeeper 可能阻止首次运行。正式对外发布前，请使用已签名并公证的构建替换此包。

## 可用命令

运行以下命令查看当前版本支持的命令与选项：

```bash
./moi-cli -help
./moi-cli workspace --help
```
