Codeb — PC 端桌面客户端

官网 / 下载：https://code.btluo.com/ （Windows / macOS / Linux 安装包，网页内直接下载）

Codeb 的跨平台桌面客户端（Windows / macOS / Linux），基于 Electron 构建，配合 Codeb 后端服务使用：

• 一键配置 20 种主流 AI 编程 CLI 工具 — 自动安装、API 密钥注入、模型设置、配置文件写入
• 统一接入 9 家厂商 19 款模型 — 模型目录由后端动态下发，客户端内一键切换
• 密钥管理、PTY 终端、环境检测、系统托盘、中英双语界面、自动更新

支持的 CLI 工具（20 种）

每种工具均提供：一键安装（npm / pip / 安装脚本，按工具而异）、API 密钥环境变量自动注入、模型参数配置、常用命令与斜杠命令速查。

支持的模型（19 款 · 9 家厂商）

模型目录由后端服务统一维护并通过 /api/models 动态下发，客户端按当前可用模型展示并支持一键切换。官方服务当前收录：

• 模型实际可用性以后端渠道配置为准；自部署后端可自定义模型目录与收录范围。
• 模型单价在客户端模型选择器中随模型展示，官方服务统一按量计费，价格以个人中心「计费说明」为准。

核心功能

技术栈

• Electron — 跨平台桌面应用（Windows / macOS / Linux）
• contextIsolation + preload — 安全的 IPC 通信架构
• 原生 HTML/CSS/JS — 渲染进程 UI（深色主题）
• node-pty — 伪终端会话管理（支持交互式 TUI 程序）
• xterm.js — 终端渲染（多标签页）
• electron-builder — 跨平台打包

目录结构

.
├── package.json              # 依赖与脚本
├── electron-builder.yml      # 打包配置（Win/macOS/Linux）
├── LICENSE                   # MIT 许可证
├── .npmrc                    # 国内镜像配置
├── build/                    # 打包资源（应用图标）
├── scripts/
│   ├── build-and-publish.js  # 构建与发布脚本
│   └── regen-icons.ps1       # 从 logo 重新生成应用图标
└── src/
    ├── main/                 # 主进程（Node.js 环境）
    │   ├── index.js          # 窗口创建 + OAuth + 托盘 + 快捷键 + 入口
    │   ├── ipc.js            # IPC 处理器注册
    │   ├── api.js            # 后端 API 客户端
    │   ├── config.js         # 本地配置持久化（加密存储）
    │   ├── env-detect.js     # 本地环境检测（Node.js + 各 CLI 工具）
    │   ├── config-runner.js  # 一键配置执行（安装/环境变量/模型/配置文件）
    │   ├── pty-runner.js     # PTY 终端会话管理（交互式 TUI 支持）
    │   ├── tray.js           # 系统托盘
    │   ├── updater.js        # 自动更新检查
    │   └── window-state.js   # 窗口状态持久化
    ├── preload/
    │   └── index.js          # contextBridge 安全暴露 API
    └── renderer/             # 渲染进程（UI）
        ├── index.html        # 应用骨架
        ├── styles.css        # 深色主题样式
        ├── app.js            # 路由 + 视图逻辑
        ├── code-tools.js     # 20 种 CLI 工具目录（命令 / 文档 / 配置类型）
        ├── i18n.js           # 中英双语翻译
        └── terminal.js       # xterm.js 终端封装组件

开发

# 1. 安装依赖（已配置国内镜像）
npm install

# 2. 启动（开发模式，自动打开 DevTools）
npm run dev

# 3. 启动（普通模式）
npm start

首次启动前，需在「设置」中填写后端 API 地址。开发时可将地址指向本地后端服务（如 http://localhost:8787）。

打包

npm run build:win     # Windows NSIS 安装包
npm run build:mac     # macOS DMG
npm run build:linux   # Linux AppImage + deb

输出目录：releases/（见 electron-builder.yml 的 directories.output）

与后端的关系

本仓库仅包含桌面客户端。后端为独立的 Cloudflare Workers 服务，不包含在本仓库中。客户端默认连接官方服务 code.btluo.com，也可在「设置」中修改 API 地址指向自部署的后端实例。官网（注册账号 / 下载安装包）：https://code.btluo.com/

客户端通过 fetch 调用后端 /api/* 接口，账号、密钥、余额、兑换码体系与 Web 端共用。 登录认证通过 OAuth 接口（/api/oauth/desktop-authorize + /api/oauth/desktop-token）实现。 本地命令执行（安装、配置、终端）在客户端主进程完成，不依赖后端。

安全

• contextIsolation: true + nodeIntegration: false + sandbox: false
• 渲染进程仅能通过 window.detstcc.* 调用 preload 暴露的受限 API
• CSP 策略限制脚本来源
• 登录令牌使用 Electron safeStorage 加密存储（OS 级密钥）

许可证

MIT