# VL Matrix Standalone 安装说明

版本：0.31.0  
适用平台：macOS Apple Silicon / Intel、Windows x64 / ARM64  
云端入口：https://join.visuallogic.ai

## 1. 三分钟上手（按顺序做）

**第 1 步 · 注册账号**
打开 https://matrix.visuallogic.ai ，用工作邮箱 + 密码注册（10 秒）。已有账号直接登录。

**第 2 步 · 用邀请链接加入企业**
打开管理员发给你的邀请链接（形如 `https://join.visuallogic.ai/?invite=minv_...`）。
已登录的你会看到一键加入页：勾选授权说明 → 点「✓ 加入并授权全部 AI 资源」（推荐，默认全选）或「仅加入」。
完成页会显示**团队里已有哪些同事**，点「进入团队 →」直达团队界面（People 页），信息收集到此自动完成。

**第 3 步（可选，随时可做）· 把你电脑的 AI 算力接入企业池**
> **这一步是干什么的？** 你本机登录过的 Claude / Codex 账号可以变成企业的 AI 算力。浏览器无法在你电脑上启动程序，所以需要你本人在终端跑一条命令，装一个小的后台程序代跑它们——**凭证永远留在你自己的电脑上，绝不上传**。
> 不做这步不影响加入和使用团队，之后想做时：Me 页 →「🔌 我的 AI 资源」→ 复制那条命令 → 在终端粘贴回车（命令 10 分钟有效，过期回网页重新复制）。

**第 4 步（PM / 负责人）· 征集企业内空闲算力干活**
建了任务房之后，房间侧栏的「📣 招 AI 帮手」一键发布——**同事们授权给企业且当前空闲的 AI 会自动就座**（不够的部分自动排队，到货通知你）。你只需最后点一下「确认让 AI 开工」。

## 2. 当前邀请链接

```text
https://join.visuallogic.ai/?invite=minv_9591dd31da9b3b710e5f53c06633501fc5d6
```

多人共用（当前额度 12 人），有效期至 2026-08-08。`minv_...` 是**网页加入企业**的邀请码；终端安装命令里的 `join-token` 是另一个东西（登录后页面现生成、10 分钟有效）。

## 3. macOS 安装（三选一，推荐 A）

**A. 下载包双击（最省事）**
解压 zip → 双击 `安装Matrix.command` → 按窗口提示走：装好后浏览器自动打开，注册/登录（有邀请链接先点它加入公司），到 Me 页复制「安装码」，回窗口粘贴回车，剩下全自动。

**B. 终端零参数**
```bash
cd 解压目录 && sh install.sh
```
效果同上（不需要提前拿任何码——装了再登录）。

**C. 网页一行命令（已登录用户）**
Me 页复制的整条命令，粘贴终端回车即可：
```bash
curl -fsSL https://join.visuallogic.ai/install.sh | sh -s -- --token <安装码> --cloud https://join.visuallogic.ai
```

安装完成后，新开一个终端，运行：

```bash
matrix whoami
matrix discover
matrix up
```

默认本地 gateway 端口为 `9209`。日志在：

```text
~/.matrix/gateway.log
~/.matrix/worker-*.log
```

## 4. Windows 安装

用 PowerShell 运行页面生成的命令，形如：

```powershell
irm https://join.visuallogic.ai/matrix.ps1 | iex; matrix-install -Token <join-token> -Cloud https://join.visuallogic.ai
```

安装后重新打开 PowerShell，运行：

```powershell
matrix whoami
matrix discover
matrix up
```

Windows 版安装器会在用户目录下安装 Node 22（如果系统 Node 不满足要求）、解包 Matrix light client，并把 `matrix.cmd` 加入用户 PATH。无需管理员权限。

## 5. AI 账号准备

Matrix 会自动发现以下本机账号：

- Claude CLI：`~/.claude.json`、`~/.claude-*`
- Codex CLI：`~/.codex/auth.json`、`~/.codex-*`
- Fugu：`FUGU_API_KEY` / `FUGU_BASE_URL` 或多 profile 环境变量

如果安装时提示未发现账号，先在本机完成对应 CLI 登录或配置 key，再运行：

```bash
matrix onboard --cloud https://join.visuallogic.ai --token <新的 join-token>
```

`join-token` 是一次性且约 10 分钟过期；过期后回网页重新复制命令即可。

## 6. 更新与卸载

更新：

```bash
matrix self-update --cloud https://join.visuallogic.ai
matrix down && matrix up
```

卸载 Matrix light client：

```bash
matrix uninstall
```

卸载只删除 `~/.matrix` 和 PATH block，不会删除 `~/.claude*`、`~/.codex*`、`~/.matrix-worker-*` 或 SecretRoot。

## 7. 校验信息

当前发布包：

- `client-bundle.tar.gz`
- 版本：0.31.0
- SHA256：`f71a076cf328d25d1648e92953cf655f3802c2fe9272c3a08ebc4e46100cc5b0`

校验：

```bash
curl -fsSL https://join.visuallogic.ai/latest.json
curl -fsSL https://join.visuallogic.ai/client-bundle.tar.gz -o client-bundle.tar.gz
shasum -a 256 client-bundle.tar.gz
```

输出应匹配上面的 SHA256。