# 揽月智能工作台 · 安装说明

当前版本：**v1.3.2609142005-alpha**（下载、脚本均托管于 https://mirror.zxtech.info）

## 一、系统要求

| 平台 | 支持情况 | 说明 |
| --- | --- | --- |
| macOS | ✅ Apple Silicon（M 系列 / arm64） | macOS 12+；Intel Mac 暂不支持 |
| Windows | ✅ x64 | Windows 10 / 11（64 位） |
| Linux | ❌ 暂未提供 | 如需请联系管理员 |

安装脚本会自动准备 **opencode CLI**（AI 引擎）：Mac 调用官方安装器；Windows 用 `winget` 装 Node 后 npm 安装。

> **引擎版本要求：OpenCode 1.x（npm 包 `opencode-ai`）。**
> 工作台桥接层用的是 1.x 的 server API，**装 2.x 会不可用**：2.x（npm 包 `@opencode/cli`）的 server API 有破坏性变更且强制鉴权，表现为「左侧会话列表为空 / 对话报 `Request is not supported by this version of OpenCode Server`」。
> 实测兼容性：**1.18.30 ✅ · 1.19.5 ✅ · 2.2.5 ❌**。安装脚本默认装的都是 1.x，并会在检测到 2.x 时给出提示。

## 二、一键安装（推荐）

### macOS（终端）

```bash
curl -fsSL https://mirror.zxtech.info/upload/lanyue-install-mac.sh | bash
```

带模型 Key（可选，装完即可对话）：

```bash
DEEPSEEK_API_KEY=sk-xxxx curl -fsSL https://mirror.zxtech.info/upload/lanyue-install-mac.sh | bash
```

### Windows（PowerShell）

```powershell
irm https://mirror.zxtech.info/upload/lanyue-install-win.ps1 | iex
```

带模型 Key（可选）：

```powershell
$env:DEEPSEEK_API_KEY="sk-xxxx"; irm https://mirror.zxtech.info/upload/lanyue-install-win.ps1 | iex
```

> 若被执行策略拦截：`powershell -ExecutionPolicy Bypass -Command "irm https://mirror.zxtech.info/upload/lanyue-install-win.ps1 | iex"`

脚本自动完成：检测/安装 opencode CLI → 下载工作台 → SHA256 校验 → 安装 → 建快捷方式 → 启动。

## 三、手动下载安装

| 平台 | 安装包 | 大小 |
| --- | --- | --- |
| macOS (arm64) | https://mirror.zxtech.info/upload/lanyue-1.3.2609142005-alpha-mac-arm64.zip | 126.4 MB |
| Windows (x64) | https://mirror.zxtech.info/upload/lanyue-1.3.2609142005-alpha-win-x64-portable.zip | 155.5 MB |

### macOS

```bash
curl -fL -o lanyue.zip https://mirror.zxtech.info/upload/lanyue-1.3.2609142005-alpha-mac-arm64.zip
shasum -a 256 lanyue.zip
ditto -x -k lanyue.zip /tmp/lanyue
cp -R "/tmp/lanyue/揽月智能工作台.app" /Applications/
xattr -dr com.apple.quarantine "/Applications/揽月智能工作台.app"
open "/Applications/揽月智能工作台.app"
```

### Windows

```powershell
Invoke-WebRequest https://mirror.zxtech.info/upload/lanyue-1.3.2609142005-alpha-win-x64-portable.zip -OutFile lanyue.zip
(Get-FileHash lanyue.zip -Algorithm SHA256).Hash
Expand-Archive lanyue.zip -DestinationPath lanyue
# 进入 lanyue\win-unpacked，双击 揽月智能工作台.exe
```

### SHA256

| 文件 | SHA256 |
| --- | --- |
| lanyue-1.3.2609142005-alpha-mac-arm64.zip | `e6a9da92f4d43df1d7e033a06eef1e667ed83156ed25dbc398e1b50317fd5fa2` |
| lanyue-1.3.2609142005-alpha-win-x64-portable.zip | `bb304ee576740b2510c7a73dca25fb7c86fd70ca7d01fc0ed79b25287cfa12b3` |

## 四、首次启动与模型配置

1. 打开应用右上角「设置 → 模型」，填入模型 API Key（DeepSeek 或 OpenCode Zen）。
2. 若安装时已通过 `DEEPSEEK_API_KEY` 传入，通常无需再填。
3. 终端执行 `opencode --version` 能输出版本号即引擎就绪（应为 `1.x`，如 1.19.5）。

## 五、常见问题

- 右侧终端打不开 / 找不到 opencode：`which opencode`；macOS 常见位置 `~/.local/bin`、`~/.opencode/bin`，加入 PATH 后重启应用。
- 会话列表一直空 / 对话报 `Request is not supported by this version of OpenCode Server`：装成了 OpenCode 2.x。改装 1.x：`npm i -g opencode-ai@1.19.5`，随后重启应用（`opencode --version` 应显示 1.x）。
- macOS「无法验证开发者」：右键应用选「打开」，或 `xattr -dr com.apple.quarantine "/Applications/揽月智能工作台.app"`。
- Windows 执行策略限制：`powershell -ExecutionPolicy Bypass -File lanyue-install-win.ps1`。
- 下载慢：本镜像站即加速站，可稍后重试或断点续传。

## 六、卸载

- macOS：删除 `/Applications/揽月智能工作台.app`（可选删除 `~/Library/Application Support/opencode-desktop`）。
- Windows：删除 `%LOCALAPPDATA%\LanyueWorkbench` 及桌面快捷方式。

---
揽月智能 · 医用耗材平台 · 随版本更新维护。
