Skip to content

ChainlessChain 安装部署 ​

2026-11-19 当前安装入口:公开 CLI 0.166.156、Open VSX 0.37.192、JetBrains 0.4.207;两款 IDE 推荐 CLI 0.166.156。最后已核验的历史客户端为 v5.0.3.145,旧安装包下载源当前返回 404,暂不可下载。CLI、Web 与 IDE 可使用;本次不发行新客户端,NOT_PAID_READY / NOT_ADMITTED / HOLD 保留。当前升级指南 · 当前源码仓库。

2026-11-09 历史核对:当时公开组合为 CLI 0.166.145、Open VSX 0.37.181、JetBrains 0.4.198,两款 IDE 推荐 CLI .145;产品 v5.0.3.145 独立发行。以下 .145 文件名、系统要求与旧门禁记录保留历史范围,不证明当前旧下载源仍可用。

概述 ​

先选择需要的入口:终端 Agent 安装 npm CLI;浏览器工作台由 cc ui 启动;IDE 插件另外安装并连接 CLI。桌面与移动客户端需要独立安装包,当前旧下载源不可用,可使用已有且已核验的本地资产或按源码开发说明构建。仅使用 CLI 和云端模型时,不需要先部署整套 Docker 后端。

系统概述 · 本轮升级指南 · 配置说明

核心特性 ​

  • 固定公开版本安装:使用官方 npm registry,区分 CLI、IDE、客户端及共享子包的独立版本。
  • 跨端入口:Windows / macOS / Linux 桌面、Android、iOS、CLI、Web 面板与双 IDE。
  • 按需初始化:cc setup 支持跳过桌面下载和 Docker 配置,先完成模型连接与 CLI 初始化。
  • 环境诊断:cc doctor、cc config validate 检查实际安装与配置状态。
  • 独立升级:CLI / IDE 升级不自动替换已经安装的桌面或移动客户端。

系统架构 ​

text
npm 包 → CLI / Agent → 配置的模型服务
                  ├→ cc ui → 本机浏览器工作台
                  └→ IDE 插件 → 当前工作区的 CLI 宿主

产品 Release → 桌面安装包 / Android APK / iOS IPA
Docker Compose → 按需启动本地模型、向量库和项目后端

系统要求 ​

用途要求
npm CLI / 源码开发Node.js 22.12.0+、npm 10+;源码开发还需要 Git
桌面客户端历史资产按操作系统与架构匹配;当前旧下载源不可用
Android .145Android 9 / API 28+;按设备选择 APK 架构
iOS .145iOS 16.0+;历史 IPA 按 ad-hoc 签名设备范围安装
Docker 后端已运行的 Docker Engine / Docker Desktop 与 Docker Compose;仅在使用相关服务时需要
本地模型内存、显存和磁盘按选用模型及上下文规模准备,不把固定的历史资源数字当作所有模型最低要求

Android / iOS 要求按历史产品 .145 的发行源码核对,不能从源码包版本 .146 推断已经发布了新安装包。

安装 CLI 与 Web 面板 ​

1. 检查环境并安装 ​

bash
node --version
npm --version
npm i -g chainlesschain@0.166.156 --registry https://registry.npmjs.org
cc --version

安装后应显示 0.166.156。若 cc 指向系统 C 编译器或另一个工具,使用完整命令 chainlesschain --version,并核对 npm 全局可执行目录是否在当前终端的 PATH 中。

2. 初始化 CLI ​

bash
cc setup --skip-download --skip-services
cc doctor
cc config validate

按向导选择实际可访问的模型服务、API 模型 ID 和该服务的凭据。向导的 --skip-download 跳过桌面二进制下载,--skip-services 跳过 Docker 配置。当前旧客户端源不可用,请保留这两个选项;若直接运行 cc setup,应拒绝桌面下载提示。配置修改与密钥输入详见配置说明。

3. 打开需要的工作入口 ​

bash
# 终端交互 Agent
cc agent

# 本机浏览器工作台
cc ui

浏览器面板默认使用本机 HTTP 18810、WebSocket 18800,以启动时输出的地址为准。远程访问需要另外配置绑定与认证,不应直接把本机默认服务当成公网部署。

PC 端安装 ​

当前不可下载:最后已核验的历史客户端为 v5.0.3.145,旧 Release 与安装包源返回 404;更换 GitHub 仓库地址不代表镜像安装包存在。本页不提供不可用资产链接。官网桌面状态页显示当前状态,CLI / Web 用户可继续使用上方流程。

下表保留历史资产名称,供已经持有并核验该版本安装包的用户识别,不是当前下载列表。

平台该版本资产示例安装方式
WindowsChainlessChain-Setup-5.0.3-alpha.145.exe运行安装程序,按向导完成安装
Windows PortableChainlessChain-Portable-5.0.3-alpha.145.exe使用便携版本,按其数据目录说明运行
macOS Apple SiliconChainlessChain-5.0.3-alpha.145-arm64.dmg打开 DMG 并复制应用到 Applications
macOS IntelChainlessChain-5.0.3-alpha.145.dmg选择与 CPU 架构匹配的资产
Linux AppImageChainlessChain-5.0.3-alpha.145.AppImage赋予执行权限后运行
Debian / Ubuntuchainlesschain-desktop-vue_5.0.3-alpha.145_amd64.deb用系统包管理器安装本地 DEB
RPM 系统chainlesschain-desktop-vue-5.0.3-alpha.145.x86_64.rpm用对应系统包管理器安装本地 RPM

历史产品标签使用 v5.0.3.145,桌面资产包含 5.0.3-alpha.145,两者是该发行的不同命名形式。当前没有可用下载资产供核对大小;本页不提供未经核验的镜像或 APT 软件源。

仅对已持有并核验的历史 Linux 本地文件,在保存资产的目录执行:

bash
chmod +x ChainlessChain-5.0.3-alpha.145.AppImage
./ChainlessChain-5.0.3-alpha.145.AppImage

# 或安装已下载的 Debian 资产
sudo apt install ./chainlesschain-desktop-vue_5.0.3-alpha.145_amd64.deb

首次启动按应用界面完成身份、存储和模型配置。原生创建、目标移交及模型草稿等新入口仍要求匹配的桌面实现,不能只凭 CLI .156 安装成功认定现有客户端具备这些能力。

IDE 插件安装 ​

IDE当前公开插件安装与配对
VS Code 兼容编辑器Open VSX 0.37.192商店页面,或下载 VSIX后从 VSIX 安装
JetBrains0.4.207Marketplace,按 IDE 兼容范围安装

两款插件均推荐 CLI 0.166.156。安装/升级后重启旧聊天宿主,通过 Doctor 核对实际 CLI 路径。Microsoft Marketplace 尚未发行;VS Code 用户可使用公开 VSIX。详细操作见 IDE 指南。

移动端安装 ​

  • 当前状态:历史产品 .145 的旧下载源返回 404,暂不提供 APK、AAB 或 IPA 下载链接。本次只更新网站与文档,没有发布新移动端安装包。
  • Android 历史资产:已持有并核验的 app-arm64-v8a-release.apk、app-armeabi-v7a-release.apk 或 app-universal-release.apk 按设备架构安装。app-release.aab 是分发构建,不是直接点击安装的 APK。
  • iOS 历史资产:已持有并核验的 ChainlessChain.ipa 仍受 ad-hoc 签名设备范围限制。源码构建需要 macOS、Xcode 及匹配的签名配置,本页不承诺 App Store / TestFlight 全设备可用。
  • 跨设备功能:安装后仍需显式配对、身份确认和相应数据授权。详见 Android 指南 与 iOS 指南。

从源码开发桌面应用 ​

bash
git clone https://github.com/longfa/chainlesschain.git
cd chainlesschain
npm ci --legacy-peer-deps
npm run dev

# 生产构建
npm run build

以上根目录脚本实际进入 desktop-app-vue。也可以在该目录运行 npm run dev、npm run build;主进程单独构建为 npm run build:main。源码安装涉及 Electron 和原生依赖,应按平台提供兼容工具链;不要跳过安装脚本后把缺失的 native 模块当成产品故障。源码构建属于当前 Git 提交,不是已经公开的产品安装包。

按需启动 Docker 服务 ​

在仓库根目录显式指定所用 Compose 文件和服务,避免混淆根目录、backend/docker 与 config/docker 下的不同编排:

bash
docker compose -f docker-compose.yml up -d ollama qdrant postgres redis
docker compose -f docker-compose.yml ps
docker compose -f docker-compose.yml logs --tail=100 ollama

CLI 的对应包装命令为:

bash
cc services up ollama qdrant postgres redis
cc services logs --tail 100 ollama

cc services 从当前工作目录及其明确搜索路径查找 Compose 文件;应在包含目标编排的目录运行。本页不提供未注册的 cc services restart:需要重启时直接使用 docker compose -f docker-compose.yml restart <service>。

根编排中 Ollama 为 11434、Qdrant HTTP 为 6333、PostgreSQL 为 5432、Redis 为 6379。其他服务按所选 Compose 文件核对;部署到服务器时设置实际凭据与监听范围,不沿用开发默认值。

配置参考 ​

配置入口作用
cc setup --skip-download --skip-services只初始化 CLI 与模型配置
cc config list显示脱敏配置和 CLI 配置文件的实际路径
cc config effective --json查看启动配置的脱敏来源诊断
cc config validate校验字段、类型与配置存储权限
cc config set-secret llm.apiKey交互式隐藏输入模型服务密钥
cc start完成 setup 后启动已配置的桌面二进制,不代替安装验证

CLI 默认配置在 ~/.chainlesschain/config.json;桌面端还存在 Electron userData 下的应用和模型配置,它们不是同一个文件。不要把旧的完整 JSON 示例覆盖到新配置中;详见配置路径与字段。

使用示例 ​

更新到本页核对的公开组合 ​

bash
npm i -g chainlesschain@0.166.156 --registry https://registry.npmjs.org
chainlesschain --version
chainlesschain doctor

随后升级到 Open VSX .192 / JetBrains .207 并重启聊天宿主。桌面与移动客户端独立发行;当前旧下载源不可用,不因 CLI 更新而自动更换。

安装后检查模型配置 ​

bash
cc config explain llm.provider
cc config explain llm.model
cc llm providers --json

显式运行 cc llm test 会访问所配置的模型服务,可能产生真实推理用量;只读配置检查不等于模型连通性或任务质量验收。

性能指标 ​

本次未重新测量安装耗时、内存、模型首 token 延迟或 Docker 就绪时间。下载大小以当前资产为准,源码依赖、平台、缓存和网络会影响安装耗时;本地模型资源按模型与上下文选择。本页不提供未经本轮实测的“15 秒安装”或固定覆盖率结论。

测试覆盖 ​

本页根据命令注册、包版本、实际资产、平台构建配置和对应测试文件更新。相关回归包括 packages/cli/__tests__/integration/setup-flow.test.js、__tests__/unit/downloader.test.js、__tests__/unit/service-manager.test.js、__tests__/unit/config-security.test.js 与 __tests__/unit/paths.test.js。

历史公开 .145 的准确发行源已核对 CLI CI 75 成功、1 跳过 / Strict Sandbox 6 成功。这是该发行的记录,不替代本次文档提交的构建,也不代表所有客户端安装、IDE GUI 或真实模型任务已重新验收。NOT_PAID_READY / NOT_ADMITTED / HOLD 保留。

安全考虑 ​

  • 模型密钥用 set-secret 的隐藏输入或受控 stdin;普通 config set 拒绝把密钥放进命令行参数。
  • 保存模式可能是系统密钥存储,也可能是仅当前用户可读的配置文件,不能统称所有平台都在 JSON 内 AES 加密。
  • 下载并核对与操作系统、架构和发行版本匹配的资产;备份前停止相关写入,保留恢复所需的权限、密钥存储与版本信息。
  • CLI 没有通用顶层 backup / restore 命令;使用具体业务的导出/同步/快照入口,不以复制单个 JSON 代替完整恢复。
  • U-Key/SIMKey 的 PIN、驱动和签名方式按设备配置核对,不使用文档假定的通用默认 PIN。

故障排查 ​

现象检查方式
npm 安装 E404 或旧版本核对 --registry https://registry.npmjs.org、固定版本与网络,再重新打开终端检查完整命令
cc 不是 ChainlessChain使用 chainlesschain --version,检查 PATH 中实际命令来源
Electron / native 模块安装失败核对 Node 版本、平台工具链和原始安装日志;不要把镜像或编译失败当作安装完成
cc start 提示未 setupCLI / Web 用户运行跳过下载的向导,再用 cc ui;当前旧安装包源不可用
Docker 提示找不到编排切换到目标目录或直接运行显式 docker compose -f ... 命令
模型返回 401 / 不存在的模型在配置入口核对同一个 provider、Base URL、API 模型 ID 与该端点的凭据
配置权限校验失败先读 cc config validate --json;确认目标是自己的配置目录后再用 --fix 做安全迁移/权限修复

关键文件 ​

  • packages/cli/src/constants.js:CLI 默认值和最低 Node 版本。
  • packages/cli/src/commands/setup.js、doctor.js、start.js、services.js:实际命令和选项。
  • packages/cli/src/lib/paths.js、service-manager.js、downloader.js:目录、Compose 查找与下载。
  • desktop-app-vue/package.json、android-app/app/build.gradle.kts、ios-app/ChainlessChain.xcodeproj/project.pbxproj:构建脚本和平台要求。

相关文档 ​

基于 MIT 许可发布