指定一个快速( 交互式终端)

安装麦克风录音机 PATH 在启用语音前 : winget install ffmpeg 在窗口上, brew install ffmpeg 在macOS上,或您的发行量 ffmpeg linux 上的软件包。 Linux 也可以使用 pw-record 或者说 arecord 当可用时。 安装后重新启动终端( 如果已安装) PATH 未更新。 然后登录到指南针并运行 /voice on 在诺瓦. /voice status 显示活动记录器; /voice off 禁用此会话的拼写 .

第一个用途要求您承认音频被发送到 Compass , 用于使用您组织配置的密钥的 OpenAI Whisper 校对 。 Nova在抓取后删除临时的本地 WAV, 绝不自动提交生成的文本, 并记住您在用户- 全球配置中的确认( 而非打开/ 关闭设定) 。 您的组织必须配置 OpenAI 密钥 。 语音输入在打印模式,管会话,SDK/ACP,守护进程,以及AG-UI客户端中都是不可用的.

磁带 缩写+ 空间 或者说 备选+V 以开始录制;再次点击以停止并插入光标上的记录. 英格兰 取消录音。 如果代理转弯正在进行中,则记录会排队,直到提示准备好; Esc 丢弃已排队的文本. 检查草稿,按你自己输入。 一些终端截取Ctrl+Space;取而代之的是Alt+V(macOS终端/iTerm2可能需要作为Meta选项). 单位 config.json, (中文(简体) ), voice.keybindings 可以选择其中之一或两者兼具。 沉默或非常短的片段被丢弃而不上传. 120秒后录音停止;转录不直播.

Dictation使用会话的响应语言,或者在第一次实质性请求之前使用英语. 用另一种语言来支配,使用 /voice language pt-PT· ; /voice language default 恢复会话语言. voice.windowsDevice, (中文(简体) ), voice.linuxInput,以及 voice.silenceThresholdDb 是用户-全球记录器/静态偏好。 v1没有下载记录器.

隔离更改

nova --worktree

开始于管理中的 Git 工作树和使用 nova worktrees 检查或管理它。 合并或抛弃孤立的工作是单独的动作,而不是启动会话的副作用.

为了编译和尝试那条工作树上的Nova CLI,打开一个单独的PowerShell终端并运行:

Set-Location -LiteralPath '<worktree path shown by nova worktrees>'
npm ci
npm run build
npm start

npm start 运行工作树的编译 dist/cli.js,没有安装 nova 命令。 在编辑源文件后, 停止运行的 CLI, 用 npm run build,然后重新开始 npm start。该建筑写给 dist 在工作树上, 离开原始的退房建筑独自一人.

在脚本中使用 Nova

nova --print "Summarise the staged diff. Do not modify files or create a commit."
nova --model gpt-5.6-luna --print "Inspect this workspace and suggest the next step."

打印模式运行一个单一的非交互查询,只写完成的最终答案到stdout. SDK 流回调和所积累的遗产 content 嵌入客户仍可获得结果; finalText 包含已完成的答案。 运行失败不打印部分答案 .

对于自成一体的写作任务,选择一个单一的文本补全. 在提示中提供完整的源材料;此路径不会读取寄存器,加载对话历史,或曝光工具. 需要一个具体的模型.

nova --completion --model gpt-5.6-luna --system 'Return only a conventional commit message.' --max-tokens 120 --print 'Describe this supplied diff: ...'

嵌入客户端可以打电话 runSDKCompletion({ prompt, model, system, maxTokens, abortSignal })。结果包含 text、象征性使用、成本、停止理由和准备/提供/总时间。 CLI 仅写完成的文本来 stdout. --completion 拒绝会话、代理、附件和工具选项; --system 财务报告和审定财务报表 --max-tokens 仅适用于补全模式. 现有的 SDK 主机可能通过 --unleash;完成模式接受兼容性,而忽略它,因为这个路径没有工具或批准流.

--model <model> 选择用于打印引用的模型 ID 或别名,同时保留 Nova 的正常系统提示 。 它在不改变已保存的默认情况下, 覆盖代理和复会模式偏好 。 后端路由和故障失效仍然适用; 3; --model auto 请求自动路由.

nova --print 'Return only JSON describing this project. Do not modify files.' --validate-json --progress

--validate-json 在释放 stdout 之前验证整个最终答案; 无效或空的 JSON 以非零退出和 stderr 诊断失败 。 它不强迫模型生成JSON,去除Markdown栅栏,或验证一个计划. --progress 在 stderr 中添加标签状态更新 . --reasoning-summary 在 Stderr (目前为 OpenAI Response) 中只添加有明确提供者支持的公开摘要; 无法获取的摘要不会产生产出, 原始思维永远不会被替换 。 工具诊断默认无声; --tool-output compact 或者说 --tool-output verbose 让他们在板上。 打印输出也会去掉标有的提供者推理前缀 <think>, (中文(简体) ), <thinking>,或 <reasoning>,包括当关闭标记识别前缀时缺失的打开标记.

对于融合客户, nova tools-rpc 曝光内部的 JSON- RPC stdio 工具服务器; 使用 nova tools-rpc --help 用于其明确的允许列表选项。 互动计划-生命周期工具没有打印模式.

让会议互相交谈

在交互式终端中使用 /tag backend 来命名一个对等会话,然后询问另一个会话: Ask @backend about progress类型 @ 以选择活端; 完整的 ID 、 独有的 8 字符 ID 前缀, 并引用诸如 @"Backend API" 还有工作 解决的提及开启了本届会议的对等消息,直到 /peers refuse 或离开。 未知或模棱两可的提法显示错误. @ 不再自动完成或隐含文件;取而代之的是使用普通路径或明确附件.

让工作流程可重复

创建 .nova/commands/review.md 在您的项目中使用 .compass/commands/review.md 相反, 如果遗留目录活动 :

---
description: Review the current diff
---

Review the current diff for correctness, regressions, and missing tests.
Read the surrounding code. Report actionable findings with file references.
Do not modify files, stage changes, or create a commit.

然后运行 /review 在诺瓦 个人命令属于活动 ~/.nova/commands 或者说 ~/.compass/commands 目录.

不离开工作流程的可见度

在开始会话前启用活事件 。 单位 动力壳数字 :

$env:NOVA_OBSERVABILITY = "1"
nova

在另一个终端,来自同一项目:

nova dashboard

Nova打开本地直播仪表板并打印其地址,连续性-视图地址,以及事件文件位置. 使用 nova doctor 用于诊断性健康检查;修理是分开的、经确认的行动.

在会场内: /help, (中文(简体) ), /model, (中文(简体) ), /plan, (中文(简体) ), /agents, (中文(简体) ), /mcp, (中文(简体) ), /context, (中文(简体) ), /compact, (中文(简体) ), /tokens, (中文(简体) ), /usage, (中文(简体) ), /ask, (中文(简体) ), /export,以及 /exit。 。 。 .

新负载项目指令 AGENTS.md后退为 NOVA.md 何时 AGENTS.md 缺席。 相同的选择独立地适用于活动项目和全球状态目录( Q).nova 遗产 .compass) (中文(简体) ). 如果两个文件都存在于一个位置,则仅 AGENTS.md 已装入, 即使为空; 合并或删除 NOVA.md 这取决于你。 个人 NOVA.local.md 和 国家指南 rules/*.md 继续装入 。 自动发现覆盖了这些位置,而不是嵌入子目录.