---
locale: zh-cn
title: 简介
description: 了解 q 的职责、运行位置以及如何选择第一个工作流。
sectionLabel: 指南
toc:
  - id: 什么是q
    label: 什么是 q
  - id: 选择工作流
    label: 选择工作流
  - id: q会保留什么
    label: q 会保留什么
  - id: 下一步
    label: 下一步
---

## 什么是q

q 是面向终端、原生融入工作区的编码代理。在代码仓库或项目目录中启动它，即可通过一个 Go 二进制文件使用对话、文件工具、Shell 命令、模型提供商、规划、子代理、审查和持久历史。

工作区是 q 文件工具的操作边界。Shell 命令也从这里启动，但它们**不是操作系统沙箱**。请像审查本地开发 Shell 一样审查命令和审批。

## 选择工作流

如果请求范围明确，希望 q 直接检查或编辑，请使用普通对话。

如果工作需要澄清、明确的方案、执行前审批或可恢复的检查点，请使用 `/plan`。q 会依次经过 Griller、Scout、Planner、执行和 Planner 审查。

如需在没有交互审批步骤的情况下运行同一规划工作流，请使用 `q sprint`。

```powershell
q sprint implement the requested feature
```

用 `/subagent` 将一个范围明确的请求交给专门代理。当另一个可信进程需要通过 HTTP 使用相同的会话与代理运行时，请使用 `q remote`。

## q会保留什么

每个工作区都可以保存多个持久会话。可见对话、压缩后的模型上下文、任务生命周期、规划检查点和可搜索的工作区历史分别存储。长时间工作时，无需每轮都发送全部过去内容，也能检查过程。

q 还支持 Agent Skills。技能元数据按需搜索；只有代理加载适用技能后，完整的 `SKILL.md` 才会进入模型上下文。

## 下一步

通过 `go install` 或源码检出安装 q，然后在希望 q 理解的项目中启动它。