帮助中心功能说明设置
设置
功能说明

设置

这是什么

QU Studio 的设置分三处:

在哪管什么
项目设置(项目的「⋯」)每个项目各管各的:流程、原型、开发版、定时任务、盯着的地方……
小去 › 设置(小去那页顶上那排最后一个)小去的名字形象、主动程度、早报周报、要不要先问你、模型、记忆
软件设置(⌘, 或左下角)语言外观、通知、电脑、Agent、关于

这一篇还讲:添加项目、关掉窗口也在跑、更新、通知、导出数据、出问题时。

什么时候用

大部分设置不用动,默认就能用。常见要改的是:

  • 第一次接原型、登记开发版:项目设置,见 原型与验收。
  • 小去太吵或太安静:小去 › 设置。
  • 换模型、加预设:设置 › Agent,见 用量与额度。

怎么用

添加项目

左栏「添加项目」:

  • 打开电脑上的文件夹:选一个代码仓文件夹(最好是 git 仓库)。也能直接把文件夹拖进左栏。
  • 从 Git 克隆:用你自己的 git 和登录方式克隆,不覆盖已有文件夹。

项目名按文件夹名起,可以改。「新项目」「导入去设计原型」这一版还没做好。

全部项目页一页看所有项目的状态、还没做完的任务、放在哪台电脑。

项目设置

项目的「⋯」里能改名字、换图标(会自动找代码仓里的网站图标)、改任务号前缀、置顶、归档、标成客户项目、暂停这个项目(先搁一搁:不排新任务,盯着的地方、监工都停)。归档的项目在「全部项目」里能恢复。

项目设置里还有这些:

项管什么
规矩需求怎么走、哪几步小去和原型会话能替你看、「改完就上线」。见 原型与验收、版本与发布
小去直接验小改动做完、条件全满足时替你验收。见 原型与验收
原型接原型
运行和预览登记开发版的启动命令
在哪几台上这个项目在哪几台电脑上各有一份代码
派给哪些电脑和 Agent这个项目能派给哪些「电脑 + Agent」、默认哪个。见 多台电脑
检查登记 pnpm test 这类检查,批过以后在任务里能一键跑
数据源登记项目那台电脑上的本地数据库(目前只支持 SQLite),给另一台电脑上的 Agent 只读查询
盯着的地方见 定时任务与外面来的事
定时任务同上
每一轮推到任务分支每一轮把已有的提交推到远端,电脑离线时别的电脑能接着做
把 .env 链接进工作区另开工作区时,把没进 git 的 .env 这类配置文件链接过去,项目才跑得起来;只建链接,不读内容
工作区自动清理合进去的任务留下的代码副本什么时候清。打开前先列出会清几个、多大、哪些留着、为什么留
把项目约定写进 AGENTS.md见 记忆

工作区清理时,没进 git、又不能重新生成的文件(比如 .env.local、手写笔记)会留着;你点「清掉」时先列出会一起删的;没合进去的分支一律不删。

小去 › 设置

形象、名字、主动程度、早报周报和免打扰、要不要先问你、外面来的活、模型、记忆、「跟小去说一句」的快捷键,都在这里改。见 小去。

软件设置

分区里面有什么
通用语言、外观(浅色 / 深色 / 跟随系统)、字号、聊天内容宽度、启动时显示、会话在跑时你发的话、会话里的过程、额度恢复后自动接着做、你说一句话后会话之间最多来回几次、任务做完自动清掉它的代码副本、跟小去说一句的快捷键
通知桌面通知、通知声音、要你批的事怎么提醒、必须马上知道的事忽略免打扰
小去一行入口,去「小去 › 设置」
记忆与隐私客户项目单独隔开、健康政治宗教默认不记、空闲时整理记忆、整理记忆用的模型、导出数据
电脑关掉窗口以后、登录时启动后台服务、有会话在跑时不让电脑自己睡着、允许别的电脑打开这台的终端、中继服务器
Agent模型预设、检测到的 Claude Code / Codex、更多 Agent、猜下一句、自动起任务名和它们用的模型
关于版本、自动更新、数据目录、退回上一版、新手引导、帮助、第三方许可

关掉窗口也在跑

会话不在窗口里跑,在每台电脑的 QU 后台服务里跑。

  • 关掉窗口、更新 App,都不打断会话。
  • 窗口关着时,菜单栏里的 QU 能看在跑的会话、处理批准、全部暂停。
  • 退出 App 时会问:「只退出,会话照常跑」,还是连这台的会话一起停。
  • 有会话在跑时,电脑闲着也不会自己睡着;会话都停了就照常睡。
  • 合上盖子、手动睡眠照常睡。睡着时会话暂停,醒了接着做。想合盖也一直跑,把活派到一台一直开着的电脑上,见 多台电脑。

(这几项在「设置 › 电脑」和「设置 › 通用」里。)

更新

  • 自动查新版本。下载好了,左下角出一张提示,列出这一版改了什么,可以「重启并安装」。不点也会在下次打开时装上。
  • 有会话在跑时,看得到哪些还在跑,可以先不装。
  • 升级前自动备份。升级后出问题,在「设置 › 关于」里能「退回上一版」。
  • 更新包来自 GitHub 上的 gavinguo521/qustudio 发布页。连不上 GitHub 时检查网络或代理;QU Studio 不会改你的网络设置。

通知

  • 系统通知由 App 发,主窗口关着也能弹。点通知会打开到对应的会话、话题或等你处理。
  • 桌面、屏幕角小框、看板、Dock 图标上的「等你」是同一个数。
  • 一小时内通知太多,后面的先攒着,等你开口时一起看。

导出数据

「设置 › 记忆与隐私 › 导出数据 › 导出…」把记忆、看板、会话记录、设置打包成一个 ZIP:里面是 JSON 和 Markdown,带一份说明。导出时照常干活。

  • 不导出:代码(本来就在你的代码仓里)、Agent 的登录凭据(QU 从不读取)。
  • 对话里像密钥的内容会打码(常见密钥、私钥、带密码的连接地址、「密码 / password / token」后面的值)。按格式认,写法太随意的可能认不出,发给别人前自己再看一眼。
  • 数据都在主力机上,只能在主力机上导出。

帮助

「设置 › 关于 › 帮助」:使用说明、从哪开始、装好登录 Agent 在浏览器里打开;快捷键、这一版的新东西、重新走一遍新手引导、打开日志文件夹在 App 里直接开。

出问题时

  • 看连接:「电脑」页里连不上的那台,会分段写清断在哪、怎么办,带「复制诊断信息」。
  • 版本信息:「设置 › 关于」里点版本号,复制完整的版本信息,报问题时贴上。
  • 日志:在数据目录的 logs 文件夹里,一般是 ~/Library/Application Support/QuStudio/logs。「设置 › 关于 › 帮助 › 打开日志文件夹」能直接打开。

常见问题

我的数据存在哪? 看板、记忆、对话都存在你自己的主力机上,不上我们的服务器。代码在你自己的代码仓里。

能退回上一版吗? 能,在「设置 › 关于」里。

设置改错了怎么办? 大部分设置随时能改回。小去替你改的项目规矩,写着谁哪天改的,能撤。