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

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

## 一、系统要求

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

安装脚本会自动准备 **OpenCode 2.x**（AI 引擎，npm 包 `@opencode/cli`）：Mac 优先用官方 2.x 安装器、失败回退 npm；Windows 用 npm（npmmirror 镜像）安装。

> **引擎版本要求：OpenCode 2.x（npm 包 `@opencode/cli`，实测 2.2.7）。**
> 从 v1.4 起工作台桥接层走 2.x 的 `/api/*` REST 契约（Basic 鉴权），**装 1.x 会不可用**：表现为「左侧会话列表为空 / 对话报 `Request is not supported by this version of OpenCode Server`」。
> 实测兼容性：**2.2.7 ✅ · 2.2.5 ✅ · 1.18.30 ❌ · 1.19.5 ❌**。安装脚本检测到 1.x 会自动升到 2.x，若升级失败会给出提示。
> 手动升级：`npm i -g @opencode/cli` 或 `curl -fsSL https://opencode.ai/v2/install | bash`。

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

### 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 2.x → 下载工作台 → SHA256 校验 → 安装 → 建快捷方式 → 启动。

## 三、手动下载安装

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

### macOS

```bash
curl -fL -o lanyue.zip https://mirror.zxtech.info/upload/lanyue-1.4.2611121240-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.4.2611121240-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.4.2611121240-alpha-mac-arm64.zip | `05be11845eb1203ef41ff62813dc0922cc185edebb161dd95298b49988ef3eed` |
| lanyue-1.4.2611121240-alpha-win-x64-portable.zip | `6a4f63dc8a78c2ec662fdb80b4226786df9d743afdde39f3e0984d0b5cd5e155` |

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

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

## 五、常见问题

- 右侧终端打不开 / 找不到 opencode：`which opencode`；macOS 常见位置 `~/.local/bin`、`~/.opencode/bin`，加入 PATH 后重启应用。
- 会话列表一直空 / 对话报 `Request is not supported by this version of OpenCode Server`：装成了 OpenCode 1.x。改装 2.x：`npm i -g @opencode/cli`（或 `curl -fsSL https://opencode.ai/v2/install | bash`），随后重启应用（`opencode --version` 应显示 2.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` 及桌面快捷方式。

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