跳转到内容

概览

qialike 是基于 DeepSeek Harness 构建的编程 Agent 终端 TUI,支持 Linux、macOS、Windows。

qialike 是基于 DeepSeek Harness 构建的编程 Agent 终端 TUI:
支持系统:Linux、macOS、Windows,全屏、会话恢复、沙箱执行、单文件二进制、任意模型、插件化设计。

Terminal window
cd ~/my-project
qialike

能做什么

  • 在项目目录里启动它:用自然语言说清要做什么,它自己读代码、改文件、执行命令,并把每一步与模型的流式输出实时显示在同一屏上。
  • 接着上次继续:会话自动持久化——qialike resume 接续当前目录最近一次会话,/sessions 列出历史会话,可搜索、改名、置顶、删除。
  • 模型自己挑:暂无默认 provider;/models 的 + Add provider 列出中国主流供应商,含内置的 DeepSeek 官方端点(配好 DEEPSEEK_API_KEY 即可用),如通义千问 Qwen、智谱 GLM、Kimi、MiniMax、阶跃星辰、火山引擎(豆包)、小米 MiMo、蚂蚁百灵,以及硅基流动、七牛等聚合网关;选中即接入(以 OpenAI 兼容协议为主),Ctrl+T 循环切换推理强度。
  • 操作集中在 /:输入 / 弹出补全面板——/models、/sessions、/theme、/export、/plan、/goal、/compact、/sidebar 等,↑/↓ 选择、Enter 执行。
  • 也能开在浏览器里:qialike web 启动 DeepSeek Harness 自带的 Web 界面——把整条调用原样转发给已安装的 dsh CLI(dsh web,即 dsh --profile web 的官方别名)。该界面由 harness 自己提供,qialike 不复刻它;所需的 dsh 前提见 环境要求摘要。两端共用同一份会话存储:同一工作区下,web 里开的会话可直接用 qialike resume 接续,qialike 的会话也会出现在 web 里(启动时挂到对应工作区以便分组)。
  • 有边界地动手:bash / pwsh 在 OS 级沙箱内运行;.env、.git 内部路径与凭据文件一律拒绝读取;执行器无内核隔离时,每次 shell 调用逐次审批。详见 沙箱与权限。
  • 装上就能跑:Linux / macOS / Windows 各一个单文件可执行体,运行时既不需要 node_modules,也不需要 harness 检出(Windows 的 npm 渠道只在安装时需要 Node.js)。
  • 扩展不用重编译:放入 skills 目录或挂上 MCP server 即可生效,无需构建、无需安装。

快速导航

我想……去哪里
装上 qialike安装
跑通第一次会话快速开始
查命令行参数与斜杠命令命令
升级到新版本更新
记住面板里的按键交互与快捷键
选择或接入模型模型
理解沙箱与权限沙箱与权限
改配置文件与环境变量配置
排查问题故障排除
在 Windows / WSL 上使用Windows 与 WSL

环境要求摘要

  • 平台:Linux(含 WSL)、macOS、Windows;各 x64 / arm64,共六个发布目标。Windows 上安装为原生的 qialike.exe,在 Windows Terminal 应用里直接运行——不必经 WSL(WSL 同样可用);原生环境没有 bash,所以安装走 npm i -g @qialike/cli(需 Node.js ≥ 18)或手动解压 zip,见 Windows 与 WSL。
  • 终端:需要真正的 TTY——全屏界面、流式输出与鼠标交互都以交互式终端为前提。最小 14 行;宽 ≥110 列时自动显示右侧 Steps 面板。
  • 内存:建议 ≥1 GB;512 MB 可用但偏紧,低于 512 MB 不受支持。
  • 磁盘:下载归档约 45–58 MB(因平台而异),解包后的单文件约 96 MB。
  • 模型凭据:任意已配置 provider 的 key(DeepSeek 官方端点用 DEEPSEEK_API_KEY,可来自环境变量、~/.dsh 设置或 .env)。key 由各提供商自行签发,qialike 不代申请、也不内置任何 key。
  • 沙箱:三个平台都开箱即用——Linux 优先用宿主的 bubblewrap,没有则落到 qialike 自带的 Landlock(需内核启用该 LSM,≥5.13);macOS 用系统 Seatbelt;Windows 用 harness 的 ACL restricted-token runner。沙箱无法强制时,workspace-write / read-only 下的 bash 直接 fail-closed(报 SANDBOX_UNAVAILABLE)。详见 沙箱与权限。

许可证与上游关系

  • qialike 以 MIT 许可发布。版本以实际安装的为准,用 qialike --version 查看。
  • qialike 基于 DeepSeek Harness 构建,是独立的社区项目,与深度求索不存在隶属、合作、授权或背书关系。“DeepSeek Harness” 是深度求索公司的注册商标,此处仅用于准确说明技术来源及与上游软件的关系。
  • harness 的核心源码未被修改:本项目的贡献是一个 bundle 与一个 Bun 编译的单文件启动器。harness 的插件扩展点、会话持久化、压缩(compaction)、plan/goal 等能力均来自上游。
  • 名称与字标不在许可证授权范围内:MIT 授予的权利只覆盖软件本身,不包含对 qialike 名称或字标的任何授权——它们仅用于标识本项目。