跳转到内容
Qialike
首页文档

安装

一键安装 qialike，或直接下载发布归档。

qialike 的发布形态是按平台交叉编译的归档，解包后是单个可执行体：安装即得到 qialike 命令，运行时不需要 harness 检出、pnpm 或 node_modules。

一键安装

Terminal window
curl -fsSL https://qialike.cn/install | bash

适用于 Linux、macOS、WSL，以及 Windows 上的 Git Bash / MSYS2 / Cygwin——各含 x64 与 arm64，共六个发布目标，均已发布。需要 bash 与 curl；Linux 用系统 tar 解包，macOS 与 Windows 的 .zip 另需 unzip。

Windows 原生环境里没有 bash（PowerShell 与 cmd 都不是 bash），所以上面这条安装命令用不了——用 npm i -g @qialike/cli 安装，或手动下载解压、自行配置环境变量：见 Windows Terminal。注意这只影响安装，装好后的 qialike.exe 是原生程序，在 Windows Terminal 里照常运行。

装到 ~/.dsh/bin。安装器会把该目录写进 shell profile，但当前这个 shell 里还没生效——按它打印的提示 source ~/.bashrc（zsh 用 ~/.zshrc），或直接重开终端；之后任意目录都可直接执行 qialike，用 qialike --version 校验。

六平台与产物名

目标归档解包工具
linux-x64 / linux-arm64qialike-<target>.tar.gztar
darwin-x64 / darwin-arm64qialike-<target>.zipunzip
windows-x64 / windows-arm64qialike-<target>.zipunzip

解包工具由归档名决定（而非平台名），两者不会各说各话。Windows 上安装为 qialike.exe；其余平台是裸名 qialike。不支持的目标会在写入任何东西之前按名字明确报错。

Windows Terminal

请在 Windows Terminal 这个应用里运行 qialike，不要用直接启动 cmd.exe / powershell.exe 得到的旧控制台窗口。 两者是不同的东西：cmd.exe / PowerShell 是 shell（解释你输入的命令），Windows Terminal 是 终端（负责画界面）。qialike 的界面要求 24 位真彩、鼠标事件、备用屏、括号粘贴与 emoji 回退（品牌标记用 ▀▄█ 半块字符、权限条用 🔒/🔓），旧控制台窗口在这些方面都明显更差。Windows 11 已自带 Windows Terminal；Windows 10 可以安装：

Terminal window
winget install Microsoft.WindowsTerminal     # 或从 Microsoft Store 安装

装好后在它里面开一个 PowerShell 或 cmd 标签页即可 —— shell 仍然是你习惯的那个。

Windows Terminal 里没有 bash，上面那条 curl | bash 用不了。两条途径：

npm —— 需要先有 Node.js（它自带 npm），再用一条命令装 qialike：

Terminal window
winget install OpenJS.NodeJS.LTS     # 或到 https://nodejs.org/zh-cn/ 下载 LTS 安装包
node --version                       # 装完 Node 请重开终端，再用这两条确认
npm --version
npm i -g @qialike/cli
qialike --version

要求 Node.js ≥ 18（LTS 版即可）；装完 Node 必须重开终端，它的 PATH 才生效。Windows 上 npm 的全局前缀是 %APPDATA%\npm（位于你的用户目录，Node 安装器会把它加进用户 PATH），因此装 qialike 不需要管理员权限。不需要自己选架构：该包为每个 Windows 目标声明了一条由 os/cpu 限定的可选依赖，npm 只会下载与本机匹配的那一份（x64 或 arm64）。这个渠道仅限 Windows —— Linux 与 macOS 用上面的安装器。

该渠道装的就是 qialike-windows-*.zip 里那份载荷（原样不改）；它能自动更新（补丁版静默装，见 更新），卸载要两步，见 卸载。

手动安装 —— 不想装 Node.js 时：

  1. 从 Releases 下载 qialike-windows-x64.zip（ARM 设备选 -arm64；镜像站点见 gitcode.com/qialike/qialike/releases）。

  2. 解压得到单个 qialike.exe，放进 %USERPROFILE%\.dsh\bin\（安装器的默认目录）。注意 qialike uninstall 会保留这个 bin\ 目录与其中的 exe——它只清理 home 下的其它内容，并打印手动删除该目录的命令，见 卸载。

  3. 把该目录加入用户 PATH（系统设置 → 环境变量，或用下面这条 PowerShell），然后重开终端。

    Terminal window
    [Environment]::SetEnvironmentVariable('Path',
      "$env:USERPROFILE\.dsh\bin;" + [Environment]::GetEnvironmentVariable('Path', 'User'), 'User')

  4. 启动后用 /models 添加提供商。

校验：qialike --version。手动这条路仍然保留，因为联网安装器只在 bash 下运行；qialike uninstall 会保留安装目录（并打印删除它的确切命令），要移除 qialike.exe 需手动删除。这样装的副本不会自动更新，升级要自己下载新 .zip 替换，见 更新。

安装选项

-h, --help              display this help message
-v, --version <version> install a specific version (e.g. 0.6.0 or v0.6.0)
    --no-modify-path    don't modify shell config files (.bashrc, .zshrc)
    --source <name>     gitcode | auto (default auto)
    --base-url <url>    use exactly this releases directory, no fallback
    --dry-run           print what would be done, then change nothing
Terminal window
# 指定版本，且不改动 shell 配置
curl -fsSL https://qialike.cn/install | bash -s -- --version 0.6.0 --no-modify-path


# 只打印计划，不做任何改动（适合先看清楚会动什么）
curl -fsSL https://qialike.cn/install | bash -s -- --dry-run

版本号接受带或不带 v 前缀（0.6.0 与 v0.6.0 等价）。注意本地 git tag 是带 v 的（v0.6.0），而发布 tag 不带（0.6.0）——下载 URL 只认后者，安装器会自动归一化。

下载源与回退

发布挂在 gitcode.com/qialike/qialike。本站在中国大陆，GitCode 的下载 CDN 在境内会被限速到基本不可用，因此安装器只从 GitCode 取：

  • GitCode 可达 → 直接下载，不探测、不比速
  • GitCode 不可达 → 停止：不下载、不写入，已安装的 qialike 继续可用（退出码 3）

第三种情形（停止）连临时目录都不会创建，这正是”已安装版本不受影响”能成立的原因。

连通性只认 curl 的 000（无任何响应）为不可达；主机回了 404 也算可达——那是”这个平台没发布”的真实故障，不该被误报成网络问题。

Terminal window
# 跳过策略，只用其中一个源
curl -fsSL https://qialike.cn/install | bash -s -- --source gitcode


# 完全自定义 releases 目录（无回退）
curl -fsSL https://qialike.cn/install | bash -s -- --base-url https://my.mirror/releases

环境要求

  • 平台：Linux（含 WSL）、macOS、Windows；各 x64 / arm64，共六个发布目标。运行只需对应的原生可执行体（Windows 上即 qialike.exe）；只有 curl | bash 那条安装命令要 bash，故 Windows 原生环境需经 Git Bash / MSYS2 / Cygwin，或改用 npm 渠道（npm i -g @qialike/cli，仅限 Windows）。
  • 终端：需要真正的 TTY——全屏界面、流式输出与鼠标交互都以交互式终端为前提。Windows 上指的是 Windows Terminal 应用，而不是直接启动 cmd.exe / powershell.exe 得到的旧控制台窗口（见 Windows Terminal）。最小 14 行；宽 ≥110 列时自动显示右侧 Steps 面板。
  • 无需预装运行时：产物是单一可执行文件，运行时不需要 Node.js、bun、pnpm、node_modules，也不需要一份 harness 检出。唯一例外是 Windows 的 npm 渠道：它安装时需要 Node.js ≥ 18（npm i -g @qialike/cli），装好后的程序本身仍然什么都不需要。
  • API key：跑真实会话至少需要一个提供商的 key——在 /models 里选择提供商并设置 key；DeepSeek 官方端点用 DEEPSEEK_API_KEY（也可来自环境变量、~/.dsh 设置或 .env）。key 一律由各提供商自己签发，qialike 不代申请、也不内置任何 key。
  • 工作区：默认当前目录（cwd），或用 --workspace 指定；会话状态、设置与凭据存放在 ~/.dsh。
  • 磁盘：下载归档约 45–58 MB（因平台而异），解包后的单文件约 96 MB。
  • 内存：建议 ≥1 GB，512 MB 可用但偏紧（超长转录无 swap 余量），低于 512 MB 不支持。
  • qialike web 另需：系统里已装 dsh CLI（在 PATH 上，或设 $QIALIKE_DSH 指向它），且版本不低于本构建内嵌的 harness——见 无头 / 远程访问。

直接下载归档

不想跑安装脚本的话，从 下载页 或 gitcode.com/qialike/qialike/releases 取对应平台的归档，自行解包：

Terminal window
# Linux
tar -xzf qialike-linux-x64.tar.gz
install -m 755 qialike ~/.dsh/bin/qialike


# macOS / Windows：用 unzip 解包，Windows 得到 qialike.exe
unzip qialike-darwin-arm64.zip

模型凭据

跑真实会话需要一个模型 key。qialike 暂无默认 provider——在 TUI 里输入 /models，按 provider 归类选择模型并填入 key：

/models

key 可以来自三处：环境变量、~/.dsh 下的设置/凭据、或工作区里的 .env 文件。见 模型。

卸载

永远是两步，顺序不能反：① qialike uninstall 清掉状态；② 再删程序本身。第 ① 步四条安装路径都一样，差别只在第 ② 步：

你是怎么装的① 清状态② 删程序
Linux / macOS（shell 安装器）qialike uninstall运行它打印的 rm -rf "<home>/bin"
Windows · npmqialike uninstallnpm uninstall -g @qialike/cli
Windows · 手动解压 zipqialike uninstall运行它打印的 Remove-Item -Recurse -Force "<home>\bin"
从源码安装（bash scripts/install、检出构建）qialike uninstall同样落在 ~/.dsh/bin，用 ① 打印的那条

第 ① 步每次都会把第 ② 步的确切命令打印出来，直接粘贴即可 —— 所以你不必记住上表：

qialike: kept /home/you/.dsh/bin — that is the program itself; delete it by hand to remove qialike completely:
qialike:   rm -rf "/home/you/.dsh/bin"
qialike: removed PATH entry from /home/you/.bashrc
qialike: uninstalled — user state cleared

它会清空 bin/ 以外的整个 qialike home（与 dsh 共用；$DSH_HOME，默认 ~/.dsh）——config、日志、主题、settings.yaml、会话、profiles、storages、attachments、exports、缓存与凭据 .credentials.yaml——并移除安装器追加到 ~/.bashrc / ~/.zshrc 的 PATH 导出行（连同 # qialike 标记）与 ~/.local/bin/qialike 开发软链。qialike 的源码检出不会被碰。

  • 为什么保留 bin/：程序本体就在里面，而 Windows 上正在运行的可执行体无法删除，所以它被刻意保留，并打印当前平台的手动删除命令（Unix 是 rm -rf "…"，Windows 是 Remove-Item -Recurse -Force "…"）。
  • npm 装的为什么要走 npm：那条渠道把程序放在 harness home 之外（npm 全局前缀，Windows 上是 %APPDATA%\npm\node_modules\@qialike\…），qialike uninstall 删不到它——所以它会额外打印 npm uninstall -g @qialike/cli，第 ② 步执行那一条。
  • ⚠️ 别先做第 ② 步：程序没了就跑不了 qialike uninstall，~/.dsh 里的设置、会话、附件与凭据会全部留在盘上（只能手动 rm -rf ~/.dsh）。真到那一步：rm -rf ~/.dsh 即可，它整棵都是可再生的用户状态。

若你是按 Windows Terminal 的手动步骤把该目录加进系统的「用户 PATH」，qialike uninstall 不会动那一项（它只改 ~/.bashrc / ~/.zshrc），需自己去系统设置里移除。想先看清它会做什么而不删任何东西：qialike uninstall --help。

下一步