# Qoder BYOK 增强版 — 使用说明

本说明适用于从本仓库 **[Releases](https://downloads.pangubox.com/lintel/qoder-limit-unlock/)** 下载的预编译安装包。按操作系统选择对应文件，安装后即可使用，无需其它步骤。

## 当前版本

以 Releases 页面中的**文件名为准**。当前常见对应关系：

| 系统 | Qoder 版本 | 安装包 |
|------|------------|--------|
| Linux（amd64） | **1.27.1** | `qoder_1.27.1-*_amd64.byok.deb` |
| Windows（x64） | **1.28.0** | `qoder_1.28.0_win_x64.byok.exe` |
| macOS（Apple Silicon / Intel） | **1.28.0** | `qoder_1.28.0_darwin_arm64.byok.zip` / `qoder_1.28.0_darwin_x64.byok.zip` |

> 若 Releases 中已有更新文件名，请以新文件为准。版本不一致时，请勿混用官方安装包与本增强包。

---

## 增强内容一览

相对官方安装包，本版主要改进 **BYOK（自带 Key）自定义模型** 体验：

| 项目 | 说明 |
|------|------|
| 更长上下文 | 自定义模型可使用更大上下文上限，并支持多档选择（如 8K、64K、128K、1M 等） |
| 专家团可用 BYOK | 专家团模式下可选择你配置的第三方模型，而不只限于官方自动模型 |
| 隐私模式默认开启 | 社区版默认倾向隐私模式（不共享改进数据） |
| 代码库索引入口可用 | 设置里相关按钮可正常点击；能否真正创建成功仍取决于账号配额 |
| 工具中断自动继续 | 工具调用次数过多或请求超时时可自动点「继续」；可在设置中关闭 |

官方内置模型的日常使用方式与官方版相同；上述增强主要体现在你自行添加的第三方模型上。

---

## 下载前准备

1. 打开 Releases：  
   **https://downloads.pangubox.com/lintel/qoder-limit-unlock/**
2. 按系统下载对应文件（见下表）。
3. **完全退出**本机已运行的 Qoder / Qoder IDE（含菜单栏或托盘图标）。
4. 建议先卸载或移走同版本官方安装，避免两套程序互相覆盖。

| 文件名模式 | 适用系统 | 如何确认自己选对了 |
|------------|----------|--------------------|
| `qoder_*_amd64.byok.deb` | Linux 64 位（Debian、Ubuntu、Deepin 等） | 终端执行 `uname -m`，一般为 `x86_64` |
| `qoder_*_win_x64.byok.exe` | Windows 64 位 | 「设置 → 系统 → 关于」中系统类型为 64 位 |
| `qoder_*_darwin_arm64.byok.zip` | Mac（Apple 芯片：M1 / M2 / M3 / M4 等） | 左上角苹果菜单 → 关于本机 → 芯片为 Apple |
| `qoder_*_darwin_x64.byok.zip` | Mac（Intel 芯片） | 关于本机 → 处理器为 Intel |

---

## Linux 安装（`.deb`）

### 安装步骤

1. 将 `.deb` 下载到任意目录（例如「下载」）。
2. 打开终端，进入该目录后执行：

```bash
sudo apt install ./qoder_1.27.1-*_amd64.byok.deb
```

若 `apt` 不可用，可改用：

```bash
sudo dpkg -i ./qoder_1.27.1-*_amd64.byok.deb
```

3. 安装结束后，从应用菜单搜索 **Qoder** / **Qoder IDE** 启动，或在终端运行 `qoder` / `qoder-ide`（以本机实际命令为准）。

### 安装说明

- 本包会作为系统软件安装；若已安装同版本官方包，通常会被本增强包替换。
- 需要管理员密码（`sudo`）。
- 依赖缺失时，可先执行：`sudo apt -f install`，再重新安装 `.deb`。

### 卸载

```bash
sudo apt remove qoder-ide
```

不确定包名时：

```bash
dpkg -l | grep -i qoder
```

按列出的包名执行 `sudo apt remove <包名>`。

---

## Windows 安装（`.exe`）

### 安装步骤

1. 双击 `qoder_*_win_x64.byok.exe`。
2. 若弹出 **「Windows 已保护你的电脑」** 或智能筛选提示：
   - 点击 **更多信息**
   - 再点击 **仍要运行**  
   （本安装包**没有**微软 / 厂商数字签名，出现该提示是正常现象。）
3. 按安装向导选择目录（可保持默认）并完成安装。
4. 使用桌面或开始菜单中的 **「Qoder IDE BYOK」** 快捷方式启动。

### 默认位置与程序名

| 项目 | 内容 |
|------|------|
| 默认安装目录 | `%LOCALAPPDATA%\Programs\Qoder IDE`  
| | （一般在 `C:\Users\<用户名>\AppData\Local\Programs\Qoder IDE`） |
| 主程序 | `Qoder IDE.exe` |
| 卸载程序 | 开始菜单中的 Uninstall，或「设置 → 应用」里同名项 |

### 安装说明

- 默认安装到**当前用户**目录，一般不需要管理员权限。
- 若本机已有官方 Qoder IDE：建议先卸载官方版，或安装到不同文件夹，避免文件混用导致增强失效。
- 杀毒软件可能拦截未签名安装包，可临时允许后再安装。

### 卸载

- 开始菜单 → **Qoder IDE BYOK** → Uninstall；或  
- **设置 → 应用 → 已安装的应用** → 找到对应项 → 卸载。

---

## macOS 安装（`.zip`）

macOS 增强包以 **zip** 形式提供（内含 **Qoder IDE.app**），不是官方那种可双击挂载的 `.dmg`。请按芯片选择 **arm64** 或 **x64** 文件，不要选错。

### 安装步骤

1. 双击 zip 解压，得到 **Qoder IDE.app**（有的压缩包解压后在一层文件夹里，进入后即可看到）。
2. 将 `Qoder IDE.app` **拖到「应用程序」（Applications）** 文件夹。  
   - 若「应用程序」里已有同名官方版，拖入时选择**替换**。
3. 打开「终端」应用，执行下面两条命令（建议都执行；应用名含空格，请保留引号）：

```bash
xattr -dr com.apple.quarantine "/Applications/Qoder IDE.app"
codesign --force --deep --sign - "/Applications/Qoder IDE.app"
```

第一条用于清除下载隔离标记；第二条为本地重签名，可减少「无法验证开发者」拦截。

4. 从「启动台」或「应用程序」中打开 **Qoder IDE**。

### 若仍然无法打开

系统可能提示「无法验证开发者」或「已损坏」：

1. 打开 **系统设置 → 隐私与安全性**。
2. 向下找到刚才被拦截的应用提示，点击 **仍要打开**。
3. 在确认框中再次选择打开。

也可在 Finder 中对 `Qoder IDE.app` **按住 Control 键再点击** → 选择「打开」→ 在对话框中确认。

### 安装说明

- Apple 芯片 Mac 必须使用 `*_darwin_arm64.byok.zip`；Intel Mac 使用 `*_darwin_x64.byok.zip`。装错架构时可能无法启动或异常卡顿。
- 本包**没有** Apple 公证 / 开发者签名，因此需要上述「清除隔离 + 仍要打开」步骤，属预期行为。
- 首次打开若被系统立刻移到废纸篓，请重新从 zip 解压并完成第 3 步后再启动。

### 卸载

将「应用程序」中的 `Qoder IDE.app` 拖到废纸篓即可。  
（用户配置一般在个人目录下的 Qoder 相关文件夹中，删除应用不会自动清掉账号配置；无需保留时可自行删除。）

---

## 安装后如何使用

1. **登录**你的 Qoder 账号。
2. 在设置中添加 / 配置 **BYOK / 自定义模型**（API Key、接口地址、模型名等按你的服务商填写）。
3. 在普通对话或模型选择处，为自定义模型选择合适的**上下文档位**（例如 128K、1M）。
4. 使用 **专家团** 时，在模型列表中选择你的 BYOK 模型。
5. **工具中断自动继续**（可选）：
   - 打开 **设置 → 会话**
   - 找到与「工具中断 / 自动继续」相关的开关，按需开启或关闭（默认一般为开启）

### 简单自检

安装无误时，通常可以观察到：

- 自定义模型出现多档上下文选项；
- 专家团下拉列表中能选到 BYOK 模型；
- 设置中隐私相关默认更偏向隐私模式；
- 会话设置里能看到自动继续相关选项。

若完全与官方版无差别，请核对本机版本是否与安装包一致、是否被官方在线更新覆盖。

---

## 常见问题

### 安装后增强功能不见了？

常见原因：

1. 安装后又被 **官方自动更新** 覆盖；
2. 下载的包版本与正在运行的主程序版本不一致；
3. Windows / macOS 上同时存在官方安装与增强安装，启动了未增强的那一份。

处理：重新安装对应版本的增强包，并暂时关闭自动更新；启动时确认打开的是刚安装的那套程序。

### Windows 提示不安全 / 未知发布者？

正常。选择「更多信息 → 仍要运行」即可。请只从本仓库 Releases 下载，勿使用来路不明的同名文件。

### macOS 提示已损坏、无法打开？

按上文执行 `xattr` 与 `codesign`，再到「隐私与安全性」中允许打开。确认下载的是与芯片匹配的 arm64 / x64 包。

### Linux 安装时报依赖错误？

执行 `sudo apt -f install` 修复依赖后，再重新 `apt install` / `dpkg -i` 该 `.deb`。

### 专家团能选 BYOK，但发送后报错？

多为账号权限、模型服务商或云端配额问题（例如 Key 无效、地址错误、额度用尽、服务端拒绝转发），与安装是否成功无直接关系。请检查自定义模型配置与套餐状态。

### 代码库索引点了创建仍然失败？

界面入口已可用，但索引由云端按订阅计量；额度不足或服务端拒绝时仍会失败。

### 官方已经发布更新版本，本站还没有对应增强包？

请等待 Releases 更新到对应版本；在此之前建议不要让官方自动升级覆盖当前增强版，或改回官方安装包后再升级。

### 可以同时安装官方版和增强版吗？

不推荐。容易搞混启动入口，也容易被更新互相覆盖。同一台电脑建议只保留其中一套。

---

## 其他说明

- 本安装包基于官方 Qoder IDE 重新打包，仅供个人学习与使用。
- Linux 使用标准 deb 安装；Windows / macOS 包均**无**厂商数字签名或 Apple 公证，系统安全提示属正常现象。
- 请仅从本仓库 Releases 地址下载，避免第三方二次分发带来的风险。
- 功能与版本以各次 Release 说明及文件名为准；本文档随仓库更新，若与某次 Release 附注冲突，以该次 Release 说明为准。