安装 q

使用 Go 安装 q，或从源码构建，然后在目标工作区启动。

查看 Markdown

要求

安装 q 前，请确保具备以下条件：

Task 是可选的。所有必要的构建和测试命令都能直接通过 Go 运行。

从 Go 模块直接安装 q：

powershell

go install github.com/snowmerak/q/cmd/q@latest

可选的 q-mcp 伴随程序也可以同样安装：

powershell

go install github.com/snowmerak/q/cmd/q-mcp@latest

Go 将二进制文件写入 GOBIN；未设置时写入 GOPATH/bin。请确保该目录位于 PATH 中。

如果要构建当前源码或参与 q 开发，请克隆仓库：

powershell

git clone https://github.com/snowmerak/q.git
cd q
go install ./cmd/q ./cmd/q-mcp

这会从已检出的源码安装两个命令，而不是通过 Go 模块代理解析 @latest。

在源码检出目录中直接启动 q：

powershell

go run ./cmd/q

仓库还包含常用开发任务的 Task 目标：

powershell

task run
task build
task test

切换到 q 应视为工作区的仓库或目录，然后运行：

powershell

cd C:\path\to\project
q

首次启动会打开提供商设置。分配模型后，像平常一样输入请求，或输入 / 浏览命令。