CodeNomad 帮助

设置与布局

打开设置并识别范围

  1. 使用标签栏（macOS 桌面应用中为标题栏）或主页上的打开设置齿轮打开设置。模型选择器中的管理提供商、任务面板齿轮或通知历史中的设置齿轮等快捷入口会直接打开相应部分。
  2. 选择部分。本地 Electron 和 Tauri 窗口会打开或聚焦唯一的原生偏好设置窗口；浏览器和远程视图使用内嵌设置界面。
  3. 离开前检查设置范围及所有保存操作。

大多数选择立即生效，包括任务偏好，它会在你每次更改时立即保存。语音、自定义调色板颜色和配置文件保留显式的保存。保存失败不确认更改已生效；重试前请重新打开或刷新相关部分。说明位于设置标题旁的 i 后面：悬停或聚焦它，或在触摸屏上点按它。

状态 控制内容
CodeNomad 配置 使用该配置的客户端的界面偏好、语音、SideCar 和服务器设置。没有徽章的偏好也不会按设备存储；服务器设置标记服务器端配置，例如语音、SideCar、远程控制和环境变量。
窗口/项目标签页布局 打开的面板、所选标签页、阅读器状态和可恢复草稿/布局。它们不是 OpenCode 配置。
全局/项目 OpenCode 设置 在显示范围内的原生插件/配置更改。项目控件要求活动项目/Location。
桌面数据配置文件 原生窗口、恢复状态和浏览器存储，独立于配置文件和共享 OpenCode 服务。参阅桌面窗口与数据。

统计涵盖整个已连接的 OpenCode 服务（所有项目、独立克隆和子会话），而不仅是已打开的文件夹，时间范围为最近 7、30、90 或 365 天。它需要打开一个项目，显示的是 OpenCode 记录的令牌和费用，而非提供商账单或订阅额度；刷新期间可能显示先前保存的总计。计划配额属于用量状态部分。

更改显示偏好不会重启 OpenCode 或重放提示词。原生配置、服务维护和凭据有各自影响：参阅 OpenCode 设置、提供商和集成。

语言与外观

  1. 在常规中选择语言：英语、西班牙语、法语、俄语、日语、简体中文、希伯来语、德语、尼泊尔语或土耳其语。
  2. 在配色方案中选择模式：自动、深色或浅色。自动跟随操作系统。
  3. 为显示的外观选择调色板。浅色和深色选择独立保存；自动使用相应选择。
  4. 自定义颜色时，使用色块和保存；重置恢复内置调色板的颜色。使用新建为独立调色板命名，使用删除移除你创建的调色板。

界面更新无需重启对话。希伯来语使用从右到左布局；代码和技术值仍按各自方向保持可读。语言选择更改界面文本，不改变现有消息或智能体指令的语言。CodeNomad 窗口加载完成后，原生桌面菜单会切换为界面语言。

颜色难以辨认时，选择内置调色板或重置所编辑的调色板。切换调色板可能询问是否丢弃未保存颜色编辑；不会丢弃对话草稿。

面板与状态部分

  1. 使用标题栏外角的左侧面板和右侧面板，或 View 菜单中的对应条目，显示或隐藏面板。
  2. 在右侧面板打开自定义右侧面板。使用复选框选择内置标签页和状态部分；至少一个状态部分须保持可见。
  3. 拖动右侧面板标签页重新排序。使用重置恢复内置布局选择。

状态包含 Token 信息、Yolo 模式、提供商用量、后台 Shell、MCP 和插件。隐藏部分不会禁用服务或撤销权限。窄布局让面板浮于对话之上，而非挤压对话；打开一个浮动面板会关闭另一个。

内置布局属于窗口布局，而非项目修改。扩展复选框不同：它们会为使用该配置的全部项目激活代码。重置不改变扩展同意。参阅面板扩展。

对话详情与输入框尺寸

  1. 打开聊天选择对话详情默认值。预设为 无、精简、均衡 和 全部；单项更改会产生 自定义。
  2. 为思考、诊断、工具输入、令牌、系统消息和每种工具类型设置各行的默认状态（隐藏、折叠或展开），或使用对话的消息内容弹出框，它共享这些选择。
  3. 在常规中按需勾选显示消息时间线、拆分显示工具调用的差异和将已发送的提示加入队列（会话工作时将发送的提示加入队列，而不是引导它）。
  4. 使用尺寸调整控件调整输入框；长草稿在字段内部滚动。

时间线为对话中显示的每个回复、推理、工具、压缩和系统上下文各显示一个标记，顺序相同。标记遵循消息内容：在其中隐藏某种工具类型、推理或系统消息也会隐藏其标记（有待处理权限的工具除外），无会隐藏全部工具标记。可见性和展开设置只改变呈现。不会移除存储的工具/推理或压缩模型上下文。破坏性操作请参阅历史与清理。

输入框高度跟随可见对话，包括软件键盘：最小 8%，下限 44 px，最大 60%。手动高度按比例记忆；窄宽度和长文本不会提高限制。展开权限/问题会暂时最小化输入框，不改变保存高度或草稿。收起或处理请求后可恢复调整尺寸。

通知与徽章

  1. 打开通知。为每类通知勾选其显示位置：屏幕（临时气泡）、历史（保存在标签栏铃铛的通知历史中，macOS 桌面应用中铃铛位于标题栏）和系统（操作系统通知）。
  2. 勾选系统复选框时，如有需要会请求权限。在系统通知下，缺少权限时请求会再次请求。
  3. 启用应用获得焦点时也通知，以便在此窗口获得焦点时仍显示系统通知。否则，只要窗口没有焦点，即使仍在屏幕上打开，也会显示系统通知。

默认情况下，会话正在等待你的回复和会话已结束只发送到系统，因此短暂的会话状态不会堆积在历史中；它们涉及主会话而非子智能体，你自己停止的会话不会被通知。无论表格如何设置，错误始终显示在屏幕上并记入历史，简短的进度消息只显示在屏幕上。

浏览器/操作系统权限属于设备和应用来源；保存的偏好无法覆盖拒绝。被阻止时，请在浏览器或操作系统设置中启用通知，再返回此处。不受支持的环境保持系统列禁用。

铃铛/历史未读数量（只统计路由到历史的通知）驱动浏览器网站图标圆点和原生应用徽章。原生徽章汇总活动主窗口；不是运行会话数量，也不证明操作系统通知已送达。此功能不提供 PWA 启动器徽章。

高级选项

  1. 打开高级。
  2. 只勾选或取消勾选需要的选项；每项更改都通过 CodeNomad 偏好保存。要更改会话执行环境，请展开末尾折叠的环境变量组。
  3. 检查结果视图或下一次发送，而非猜测性重启共享服务。
选项 影响与注意事项
自动清理空会话 创建新会话时清理空会话；想保留时请关闭。
保留子智能体 idle 标记 未查看空闲标记保留至查看，而非五秒后隐藏。
再次启动时聚焦现有窗口 仅原生桌面；更改再次启动窗口行为，而非标签页创建。
提供商额度余额 在用量中显示补充余额；不购买额度或切换账户。
隐藏仅空白的更改 从更改及批量操作中省略仅空白/行尾更改的未暂存文件；已暂存文件保持可见。参阅文件。
暂停跟随较长的助手回复 流式回复超过视口时停止自动跟随。
环境变量 在每条提示词或会话命令前由服务器端应用；读取不会更新已运行执行。参阅 OpenCode 设置。

键盘配置参阅键盘快捷键；语音控件参阅语音输入与播放。启动恢复和桌面数据配置文件参阅桌面窗口与数据。