---
locale: zh-cn
title: Q Studio
description: 通过本地 Web 界面运行会话、查看委派树、审查变更并配置 q。
sectionLabel: 指南
toc:
  - id: 启动-studio
    label: 启动 Studio
  - id: 会话与委派
    label: 会话与委派
  - id: 审查仓库工作
    label: 审查仓库工作
  - id: 设置与运维
    label: 设置与运维
  - id: 本地运行时边界
    label: 本地运行时边界
---

## 启动 Studio

Q Studio 是日常工作的主要界面。q 二进制文件直接提供内置的 Svelte 应用，无需安装单独的 Web 服务。

```powershell
q studio
```

Studio 默认在 `127.0.0.1` 的随机可用端口上监听并打开浏览器。要使用固定的本地 URL，请运行：

```powershell
q studio --host 127.0.0.1 --port 7070
```

要让可信网络中的其他设备连接，请监听所有 IPv4 接口，然后在其他设备上打开 `http://<本机IP>:7070`：

```powershell
q studio --host 0.0.0.0 --port 7070 --no-open
```

`--host` 接受 `127.0.0.1`、`0.0.0.0`、`::1`、`::` 等 IP 地址。端口 `0` 会选择随机可用端口，`--no-open` 会关闭自动打开浏览器。

**Studio 没有内置 HTTP 认证。** Studio 客户端能够以 q 进程的权限执行文件、进程、Git 和配置操作。非回环主机只能用于受信任且有防火墙保护的网络，或放在经过认证的反向代理之后。

启动 Studio 的目录不会限制工作区。每个已注册的根会话都会单独记录代理运行所在的仓库目录。

## 会话与委派

在 **Sessions** 中选择仓库目录，然后注册已有根会话或创建新会话。来自不同仓库的根会话会显示在同一列表中。选择会话后，可以查看聊天、上下文用量、当前运行控制和委派的子会话。

消息以安全的 Markdown 呈现，并带有语法高亮。运行不依赖浏览器连接，刷新页面后 Studio 会重新连接事件流。代理提问、暂停或需要指导时，可在所选运行中回复，也可以暂停、恢复或停止正在执行的工作。

委派以树形显示。选择子节点可查看它自己的对话和嵌套工作。已完成的子节点可从聊天标题栏删除；删除会移除该节点及其所有后代，但保留父对话中已完成的工具交互记录。

## 审查仓库工作

**Changes** 显示整个仓库中已暂存、未暂存、重命名和未跟踪的文件。选择文件后，可以查看带行锚点、大小受限且高亮显示的 diff。

提交工作流会生成一个或多个 Conventional Commit 提案。你可以编辑消息、重新生成提案、选择要创建的提交，并选择是否推送。Studio 会在提交前检查当前索引是否仍与审查时一致。

## 设置与运维

**Settings** 管理全局模型与角色分配、Gateway 提供商、System One 提供商与决策模型、运行时限制、服务、职业型子代理、Agent Skills、MCP、语言服务器和 `.qignore`。字段更改后会自动保存，不需要单独的保存快捷键。

选择工作区后会显示仓库级模型覆盖。提供商变更无需重启 Studio，会从下一轮开始生效。API 密钥按 secret 处理，读取 API 不会返回密钥值。

**Operations** 显示令牌用量、活动与驻留运行、本地服务健康状态、保留数据和受限日志。**Help** 列出 Studio 快捷键，以及兼容命令当前打开的 Studio 页面。

## 本地运行时边界

Studio 默认绑定到回环地址，文件、进程、Git 和配置操作均由本地 q 进程执行。浏览器不会获得直接访问文件系统的权限。Shell 命令仍以本地 q 进程的权限运行，并非操作系统沙箱。使用 `--host` 扩大网络边界时，必须由网络或经过认证的反向代理实施访问控制。

bare `q` 继续作为兼容聊天客户端，`q acp` 继续作为 ACP 服务器入口。`q model`、`q gateway`、`q systemone`、`q subagents`、`q skills`、`q mcp` 和 `q lsp` 等配置命令会打开对应的 Studio 页面。