功能说明
设置
这是什么
QU Studio 的设置分三处:
| 在哪 | 管什么 |
|---|---|
| 项目设置(项目的「⋯」) | 每个项目各管各的:流程、原型、开发版、定时任务、盯着的地方…… |
| 小去 › 设置(小去那页顶上那排最后一个) | 小去的名字形象、主动程度、早报周报、要不要先问你、模型、记忆 |
| 软件设置(⌘, 或左下角) | 语言外观、通知、电脑、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。「设置 › 关于 › 帮助 › 打开日志文件夹」能直接打开。
常见问题
我的数据存在哪? 看板、记忆、对话都存在你自己的主力机上,不上我们的服务器。代码在你自己的代码仓里。
能退回上一版吗? 能,在「设置 › 关于」里。
设置改错了怎么办? 大部分设置随时能改回。小去替你改的项目规矩,写着谁哪天改的,能撤。