使用说明
功能模块

工作区与终端

多工作区管理、内置终端、定时任务与跨工作区全文搜索。

工作区把不同项目的文件、对话和终端相互隔离。每个工作区绑定一个目录,AI 在其中读写文件、执行命令;内置终端和定时任务让它能干真正的活;跨工作区全文搜索帮你找回任何一次对话或计划。

工作区:对话、Review 与底部终端同屏协作

多工作区

NewMax 支持多个工作区,每个工作区关联一个本地文件夹路径。

工作区隔离

每个工作区拥有独立的:

  • 对话历史
  • 长期计划/项目
  • 定时任务
  • 技能配置
  • 默认对话模型(可选)

工作区路径

工作区路径是 AI 文件操作的默认目录。AI 可以在此目录下读写文件、执行命令;你也可以明确指定其它项目路径并要求修改,相关操作仍遵循当前权限设置。

使用场景提示:可以将工作区路径设置为剪映素材库、代码项目目录、写作文件夹等。

普通对话中由 NewMax 保存的粘贴附件、图片、文档解析文件和交互式可视化,会放在工作区的隐藏目录 .newmax/conversations/ 中。文件管理器默认不显示该目录,需要查看时可点击「显示隐藏文件」。旧版本保存在工作区根目录 conversations/ 下的文件会在应用启动后安全迁移;发现待迁移文件时,主界面右上角会显示不会自动消失的整理提示,迁移完成后提示会更新结果,点击「知道了」或右上角关闭按钮才会关闭。迁移期间可以继续使用 NewMax。如果目标位置存在同名但内容不同的文件,旧文件会保留,不会被覆盖。对话正文仍保存在 NewMax 的本地数据库中,不依赖这个附件目录。

如果发送消息时提示「工作区路径不可用」,通常是外接磁盘已断开、磁盘处于离线状态,或 Windows 盘符发生了变化。先恢复原磁盘连接和盘符;如果文件夹已经移动到新位置,可在左上角重新打开该文件夹后再发送消息。这个提示与模型或 Claude Code 核心组件无关,无需因此重装组件。

操作步骤:跨项目编辑

  1. 在当前对话中写明目标项目的路径和需要修改的内容,例如「同时修改 /projects/mobile 和 /projects/server,让两端接口保持一致」
  2. AI 会先检查目标项目的规则,再按任务范围执行;遇到权限审批时,核对目标路径与操作后批准
  3. 无需移动项目、修改现有工作区路径或创建共同父目录工作区
  4. 当前对话的 Review 与一键撤销只覆盖当前工作区。外部项目的改动请根据回复中的路径和验证结果,在对应项目中核对;Git 项目可查看各自的 diff

操作步骤:创建/添加新工作区

  1. 在主区域顶部找到工作区标签栏(显示当前已打开的工作区标签)
  2. 点击标签栏右侧的 + 按钮
  3. 弹出「添加工作区」对话框,有两个选项:
    • 打开文件夹:选择一个已有的本地文件夹作为工作区
    • 创建新工作区:输入工作区名称,可从扩展图标库选择标签图标,再点击「存放位置」下方的目录卡片选择 NewMax 可读写的文件夹;确认后会在该位置新建同名文件夹
  4. 选择或创建文件夹后,新工作区标签出现在标签栏中
  5. 自动切换到新工作区

操作步骤:切换工作区

  1. 在主区域顶部的工作区标签栏中
  2. 直接点击目标工作区的标签名称即可切换
  3. 切换后,侧栏的对话列表、项目列表等都会更新为该工作区的内容
  4. 侧栏中长期计划、最近对话、收藏、用户分组和归档的展开/收起状态及「加载更多」显示数量会按工作区分别记忆;切换回来后恢复上次状态,重启应用后展开/收起状态保留,但最近对话的显示数量回到默认 5 条。普通长期计划和对话不再提供时间子分组。对话列表没有其他分组时直接显示;显示收藏、Claude Code 导入或用户分组时,未分组对话统一放在「最近」分组中,可以独立展开/收起,加载更多也在该组内。将对话拖入「最近」可移出原自定义分组。归档内部的「长期计划」与「对话」采用相同的分组样式,点击标题可分别展开/收起,状态也按工作区记忆。当前工作区没有归档的长期计划或对话时,整个「归档」模块自动隐藏;归档首条内容后重新出现,恢复或删除最后一条后再次隐藏,原有展开/收起状态保留

操作步骤:关闭/管理工作区标签

  1. 将鼠标悬停在工作区标签上
  2. 点击标签右侧出现的 X 关闭按钮
  3. 也可以右键工作区标签,在菜单中选择「关闭工作区」;同一菜单还可进入「编辑工作区」
  4. 关闭标签只是从标签栏移除,不会删除工作区数据
  5. 拖拽标签可调整工作区顺序

英文界面中,Close workspace 只关闭标签;编辑弹窗的 Remove workspace 会先切换为 Remove from NewMax,再次点击才移除 NewMax 中的工作区记录,不删除磁盘上的文件夹和文件。普通本地对话按工作区组织,同步导入的历史则可跨工作区查看。

工作区模型旁的 Use app default 表示清除工作区覆盖、继续使用 NewMax 的应用默认模型和思考强度,不是恢复操作系统设置,也不会修改应用默认值。

操作步骤:修改工作区名称 / 路径 / 图标 / 默认模型

  1. 在主区域顶部的工作区标签栏中,右键目标工作区标签 → 「编辑工作区」(也可从工作区列表进入)
  2. 弹出编辑面板,可修改:
    • 名称:工作区显示名
    • 路径:点击「修改」弹出文件夹选择器,选择新路径;确认后会把原工作区文件迁移到新目录
    • 图标:点击工作区名称输入框左侧的图标按钮,从与创建工作区一致的图标库中选择,作为标签栏上的视觉标识
    • 工作区默认模型:默认「跟随系统」,选择器会显示当前系统默认的模型和思考强度;手动选择后会固定为工作区默认,点击选择器旁的还原图标可重新跟随系统
  3. 如需删除工作区,点击弹窗左下角的「删除工作区」;按钮会原位切换为「确认删除」,再次点击才会执行删除
  4. 保存后立即生效

工作区默认模型和思考强度用于该工作区之后新建的普通对话、主窗格草稿和工作台侧边对话。「跟随系统」会持续使用系统当前默认值,不会把还原当时的模型固化到工作区。已经单独选择过模型或思考强度的对话保持原选择,不会因修改工作区默认而被批量改写。长期项目自动任务若设置了「任务默认模型」,项目模型优先;未设置时继承工作区默认模型,再回退到全局默认,思考强度继承工作区设置。所选模型之后被停用或删除时,对话会按当前可用模型列表回退。

说明:更改路径迁移文件时,如果新目录中已有同名文件或文件夹,会保留新目录现有内容并跳过同名项,避免覆盖。

如果之前已经把工作区路径改到了一个空目录,再次修改路径时会提示选择“旧目录”。选择原来保存文件的目录后,NewMax 会从这个旧目录迁移文件到新的工作区路径。

操作步骤:调整工作区标签顺序

  1. 在工作区标签栏中,按住目标标签
  2. 在标签栏内左右拖拽(被锁定在水平方向)
  3. 松开鼠标,新顺序立即保存

操作步骤:调整侧栏和文件列表宽度

  1. 将鼠标移到左侧侧栏的右边缘,或右侧文件工作台的左边缘
  2. 光标变成左右拖拽样式后,按住边缘拖动
  3. 右侧工作台未打开文件时只显示文件列表单栏,宽度使用文件列表自身的记忆值,不会撑满预览侧栏;打开文件后工作台才扩展到预览宽度。预览宽度尚未保存时会与主内容区按 1:1 平分可用宽度;文件列表和文件预览分别记忆各自宽度,预览中的文件列表固定在右侧时,也可拖拽列表左边缘单独调整宽度
  4. 当主窗口因系统分屏或窄屏显示变小时,应用会自动折叠侧栏或收起右侧文件列表,优先保留中间对话/编辑区域;窗口恢复足够宽后,自动收起的区域会恢复显示
  5. 窗口最左侧是常驻的单列导航栏:顶部是 Logo,下面从上到下依次是首页(默认选中,从其它功能页点它回到对话)、定时任务、浏览器、扩展、每日回顾、本地应用,底部是帮助菜单和头像(点击头像进入设置)。窗口顶部、红绿灯右侧依次是「返回」「前进」「折叠 / 展开侧边栏」按钮;导航栏右侧的侧栏第一行是「对话」标题,标题栏最右侧是搜索按钮,下一行是「新建对话」,下面是长期计划、最近对话和归档;侧栏折叠后完全隐藏,导航栏仍保留,功能入口一直可用,「展开侧边栏」按钮停在原来的位置(红绿灯右侧),点击它或使用侧栏快捷键(macOS 为 ⌘←,Windows 为 Ctrl+←)即可恢复。在窄窗口中展开侧栏或点击「展开文件列表」时,对应侧栏会以浮层方式覆盖在内容上方;点击侧栏外侧可关闭浮层,点击侧栏「对话」标题右侧的「取消浮动」会将侧栏固定展开

「扩展」使用第二栏按顺序显示 Skills、插件、MCP、连接器四个页面,顶部侧栏开关和快捷键可收起或展开第二栏;窄窗口中选择页面后,浮动侧栏自动收起。本地应用首页不显示第二栏,也不显示顶部的侧栏展开按钮,内容区直接接在最左侧导航栏右侧;本地应用页的侧栏快捷键不会改变首页的展开状态。点击「首页」或通过全局返回回到首页后,会话侧栏按原来的收起/展开状态恢复。定时任务、浏览器、每日回顾仍保留各自的功能侧栏。

操作步骤:返回或前进到之前的位置

  1. 点击窗口左上角、侧栏开关左边的「返回」箭头,回到本窗口此前访问的工作区、对话、长期计划或功能页。本地应用的首页和开发页也分别记录:从列表进入某个应用的开发页后,返回先到列表,前进恢复该应用;直接从搜索进入开发页时,返回到搜索前所在的页面
  2. 进入长期计划后,自动打开最近会话或创建空白对话只算一次访问;点击一次「返回」即可回到进入计划前的位置,点击「前进」恢复刚才的计划会话。在计划内手动切换会话仍会分别记录。返回后点击「前进」箭头,可以重新回到刚才的位置;没有可访问记录时,对应按钮会置灰。也可使用快捷键:macOS 按 ⌘[ 返回、⌘] 前进;Windows / Linux 按 Ctrl+[ 返回、Ctrl+] 前进,按钮悬浮提示中也会显示
  3. 返回后打开新的位置,原来的前进记录会清空。已删除的目标和已关闭的文件、网页或终端标签会自动跳过
  4. 访问历史仅在当前窗口内保留,重启或切换隐私模式后清空。这两个按钮不控制网页内部的浏览历史,也不记录搜索、设置弹窗和功能页内部筛选

操作步骤:调整文件排序

  1. 在右侧或底部工作台打开文件管理器,并切换到「所有文件」
  2. 点击文件视图右侧的「更多」,进入「排序」
  3. 选择「名称」「文件类型」「修改日期」「创建日期」或「大小」
  4. 选择「升序」或「降序」。文件夹始终排在文件前;按大小排序时,文件夹按名称排列,文件按实际大小排列
  5. 排序选择会自动记住,并应用到当前已展开的目录和之后打开的工作区

操作步骤:在新窗口打开文件

  1. 在右侧或底部工作台的文件列表、文件搜索结果、已经打开的文件预览标题或文件标签上点击右键
  2. 选择「在新窗口中打开」;也可以按住文件项、回复下方「编辑了 N 个文件」卡片中的文件行,或已经打开的文件标签,把它拖到所有 NewMax 主窗口之外再松开
  3. NewMax 会在松开位置所在的屏幕创建一个新的主窗口;窗口按 760px 内容宽度加左右各 64px 留白计算目标宽度,高度按当前屏幕的推荐阅读高度计算,不会沿用源窗口的最大化或填充尺寸;随后自动切换到文件所属工作区并直接打开该文件。如果操作的是已打开的文件标签,无论使用右键菜单还是拖出窗口,该标签都会在新窗口创建成功后从原窗口移除,相当于移动标签;如果它是源窗口最后一个内容标签,源窗口会自动关闭,不弹出任务关闭确认,运行中的任务继续执行。拖到另一个已有主窗口时也遵循这一规则;手动关闭窗口仍保留任务确认保护
  4. 所选文件的新窗口默认收起侧边栏;其中的临时标签和分屏调整不会覆盖主窗口下次启动时恢复的布局,关闭新窗口也不会关闭其他主窗口。只有通过 Command+Shift+N(Windows / Linux 为 Ctrl+Shift+N)直接创建的普通新窗口默认显示侧边栏

从文件列表或变动文件卡片拖出文件,或在这些列表/卡片上使用「在新窗口中打开」,不会关闭原窗口中已有的同一文件标签;在已打开的文件标签上使用「在新窗口中打开」或直接拖出标签,则采用移动语义。把文件标签拖到另一个 NewMax 主窗口,会把它加入目标窗口当前聚焦的窗格并从源窗口移除;松开位置落在目标窗口已展开的右侧或底部工作台上,或落在主窗格对应的右侧、底部边缘提示区时,标签会进入该工作台而不是主窗格;目标窗口会在需要时自动切换到文件所属工作区。拖拽在原窗口内结束时只执行原有的文件移动、标签排序或工作台移动,不会额外创建窗口或移除源标签;按 Esc 可取消本次拖拽。文件夹不会通过拖出窗口打开。

操作步骤:在文件管理器中移动文件或文件夹

  1. 在右侧或底部工作台打开文件管理器,并切换到「所有文件」
  2. 按住文件或文件夹,将它拖到目标文件夹;拖到文件列表空白区域则移到工作区根目录
  3. 目标文件夹高亮后松开鼠标,移动成功后文件列表和已打开的文件标签会同步更新
  4. 点击时产生的轻微鼠标抖动不会触发移动;拖回原目录、把文件夹拖入自身子目录,或目标目录已有同名项目时也不会移动

工作区标签栏右侧同时提供底部工作台和右侧工作台按钮。两者可以一起展开,并分别保留自己的标签和当前内容;但当前工作区只允许一个文件管理器实例,右侧或底部已经打开文件管理器时,从另一处再次打开会直接展开并定位到原来的文件管理器,不会创建第二个「工作区文件 / 项目文件」标签。底部工作台覆盖左侧导航之外的主内容区域底部,第一次打开空白底部工作台时会直接创建终端;拖拽顶部边缘可调整并记忆高度,通过标签栏「+」可继续添加文件预览,或新建对话、绘图、文档、终端和网页浏览。主窗格标签栏的「+」提供相同的五种新建能力;文件预览是工作台按状态额外显示的入口。文件、对话、终端和网页标签可在主窗格、右侧工作台与底部工作台之间直接拖拽移动;普通对话也可从全局「最近对话」列表拖入,项目对话可从项目左侧对话列表拖入。项目对话拖到主对话中央时会整区高亮,松开后在当前位置打开;拖到右侧或底部边缘时,则在对应工作台打开。长期项目的主对话区是单对话位置,工作台里的项目对话标签拖回中央时会从工作台移除并切换为项目主对话。从主窗格或对话列表拖拽时,尚未展开的右侧工作台由内容区右侧边缘提示,尚未展开的底部工作台由底部边缘提示,不再通过内容区拖拽创建分屏。工作台已经展开时,主窗格不再重复显示对应代理高亮,只有拖进实际工作台区域才会高亮并接收标签。拖入空工作台时整个可放置区域会高亮,放下后目标区域会立即选中该标签。主窗格标签栏最右侧的下箭头菜单会先列出当前窗格已打开的全部标签,点击即可快速切换,当前标签使用选中底色;下方列出当前工作区最近关闭的标签,点击即可在当前窗格恢复。标签较多时列表区域可滚动,底部关闭操作保持可见。终端和由 Agent 临时接管的网页不会进入可恢复列表。点击标签栏最右侧的关闭按钮只会收起底部工作台,原有标签、草稿和终端会话会继续保留。工作台隐藏后会释放网页、终端和预览等渲染资源;重新展开时恢复当前标签,终端会话继续运行,网页可能按当前地址重新加载。

从侧栏拖入工作台时,已打开的主区域对话标签会移到工作台而不是复制;尚未打开的对话会直接在目标工作台打开。可放到工作台内容区、标签栏空白处、普通标签或文件管理器占位标签的两侧。即使拖走的是当前主对话或最后一个主标签,放下后目标工作台仍会立即展开并选中该对话。

右侧和底部工作台按当前对话分别保留打开状态、标签和内容,普通对话与长期项目对话都互不共享。切换到另一个对话时只显示该对话自己的工作台状态;切回后会恢复此前的展开位置、标签和当前内容。如果目标对话本身已在某个已收起的工作台中打开,从对话列表定位该对话时仍会展开对应工作台并选中原标签。Markdown 文件切换到卡片预览时,会自动收起预览右侧已展开的文件浏览器,为卡片画布和模板面板留出空间;需要时仍可从文件标签栏重新打开。

在长期项目中从右侧或底部工作台选择「新建对话」时,会创建归属当前项目的项目对话;空对话不会立即显示在项目对话列表中,发送内容后才会出现。普通工作区中仍创建普通对话。

绘图编辑器沿用顶部横向工具栏,并在宽窄布局下始终保持同一套 NewMax 样式,不会在画布变宽后切回 Excalidraw 原版外观。画布菜单固定在最左侧,点击后会在按钮下方展开;锁定、手型、选择和绘图工具集中在中间主工具栏,其中手型与选择是相邻的互斥工具按钮;右侧只保留素材库。三块工具栏采用一致的 4px 内边距,按钮保持 32px,分组按钮间距为 1px。绘图区域会先随工作台缩窄;低于 560px 时自动收起次要绘图工具,只有紧凑布局继续缩窄到约 336px、工具栏确实无法完整显示时,才横向滚动整个画布。此时触控板横向滚动会让画布内容和三块工具栏一起移动,中间工具栏本身不会单独滚动。矩形、菱形、椭圆、箭头和线条集中在带下拉箭头的「绘图工具」按钮中:点击形状图标会直接继续使用当前形状,只有点击右侧箭头才会展开形状菜单,形状与箭头是两个相邻的完整圆角按钮且不使用分隔竖线。紧凑布局下,缩放、重置缩放、撤销和重做会组成单列工具组,固定显示在右侧素材库下方,避免与底部属性菜单重叠;画布菜单不在底部重复显示,只有选中画布元素后才会在底部居中显示加宽后的属性操作。

  1. 点击工作区右上角的右侧工作台按钮时,如果工作台完全为空且底部工作台没有文件管理器,会直接显示文件管理器单栏;此时不显示类型选择或空白预览区,宽度只使用文件列表自身的记忆值。Git 工作区默认选中「Git 变动」,即使暂时没有未提交改动也一样;非 Git 工作区若当前对话有产出文件,会切换到「对话文件」,否则显示「所有文件」。点击文件后,工作台才扩展到预览宽度并显示文件标签和预览区;文件列表固定在预览右侧时,顶部不再重复显示「工作区文件 / 项目文件」占位标签。收起预览右侧的文件列表时,占位标签会重新出现;关闭工作台最后一个内容标签时会直接收起整个工作台,不会切换到文件管理器。如果底部工作台已经拥有文件管理器,则改为展开并定位到底部原实例,不会在右侧创建第二个文件管理器;Git 工作区的底部原实例同样优先选中「Git 变动」;非 Git 工作区当前对话有产出文件时,则切换到「对话文件」。如果右侧工作台已有文件、对话、终端、网页或「工作区文件 / 项目文件」标签,则重新展开时保留原来的标签和当前内容,不会补入或强制切换到文件浏览器。

    单栏文件管理器顶部仍保留工作台标签栏:Git 工作区直接显示仓库名(仓库根目录名),普通工作区显示「工作区文件」,长期项目显示「项目文件」。文件列表下一行的工具栏左侧,普通工作区显示「对话文件 / 所有文件」,Git 工作区依次显示「Git 变动 / 文件变动 / 所有文件」;「文件变动」与普通工作区一样直接预览当前对话产出的文件,不要求文件仍有未提交的 Git 改动。国内版和国际版在同一行右侧统一最多显示「搜索」和「更多」两个操作;新建、排序、显示隐藏文件、切换目录、打开所在文件夹及刷新均从「更多」菜单进入,具体可用项随当前视图和目录状态变化。宽度不足时搜索也会收进「更多」,优先保留左侧文件视图标签,极窄时可在标签区域横向滚动。进入文件搜索后,「文件名匹配」和「内容匹配」中的每条结果都可直接点击打开;悬停结果并点击右侧「更多」,或在结果上右键,可使用与普通文件列表一致的打开、加入对话、定位、重命名、复制、移动和删除等操作。文件管理器标签已经存在时,标签栏「+」提供「新建对话」「新建绘图」「新建文档」「新建终端」和「网页浏览」,不再重复显示「文件预览」;没有文件管理器标签时,仍可从「+」选择「文件预览」。新建标签会按创建顺序追加在已有标签右侧。即使同一工作台已有对话、终端或网页标签,切回「工作区文件 / 项目文件」仍只显示收窄的文件列表,不显示空白预览区;只有打开并选中真实文件后才展开预览。选择「新建绘图」或「新建文档」会在当前工作区创建对应文件并直接在当前工作台打开。选择「新建对话」时,同一工作台若已有尚未发送的普通草稿,会直接切换并聚焦该草稿;没有草稿时会直接在当前工作台创建新对话,不会切换主编辑区或收起工作台。选择「新建终端」会以当前工作区目录创建独立终端会话;选择「网页浏览」会打开带地址栏的内嵌浏览器。空白页会显示网址输入引导;地址栏默认只显示「输入网址」占位文字,悬停时显示底色和「在外部浏览器打开」按钮,点击后文字会平滑移动到左侧并切换为输入状态。输入网址后外部打开按钮会立即启用,可直接打开尚未在内嵌浏览器访问的地址;按回车则在内嵌浏览器中访问。网页加载后,标签会自动显示当前网站标题和 favicon,并在站内跳转时同步更新;标题或图标不可用时会保留浏览器默认显示。网页中的链接如果要求打开新标签,新标签会留在发起点击的同一主窗格、右侧工作台或底部工作台,不会跳到其他区域。点击地址栏右侧的「更多」按钮,可切换自动适应,并执行缩小、重置为 100% 或放大;菜单会同时显示当前缩放比例。

    「更多」菜单还提供页内查找、打印、设备尺寸预览和保存网页截图;浏览器资料入口可导入 Cookie 或浏览器导出的密码 CSV、管理内嵌浏览器保存的账号、打开下载目录、清除 Cookie 或浏览历史,以及进入浏览器设置。密码管理器只显示网站与账号,密码由系统安全存储加密;开启自动填充后,页面加载完成会为来源完全相同的网站填入匹配账号。浏览器设置还可控制网页是否默认自动适应。所有内嵌网页标签共用一套独立的持久化 Cookie、网站登录态和密码设置,与 NewMax 自身登录态及「浏览器」自动化 Profile 隔离;导入或清除数据只作用于这套内嵌浏览器会话,不会退出 NewMax。

    即使已有对话或其他标签,打开文件浏览器也会新增或选中「工作区文件 / 项目文件」占位标签,而不是把文件列表附加到当前标签。切换到其他标签不会关闭该占位标签;它会保留在标签栏中,点击即可返回文件列表。文件列表只属于该占位和真实文件预览,对话、终端和网页浏览不会显示文件列表按钮或文件树。在文件占位状态点击文件夹按钮只会收起或展开文件列表,不会关闭占位标签;只有点击占位标签自身的关闭按钮才会移除它。关闭时若有其他标签会返回此前标签。从文件列表打开真实文件后,文件列表会固定到预览右侧,顶部占位标签在这段时间隐藏,避免同一文件管理入口重复出现;收起右侧文件列表时占位标签会重新出现,关闭最后一个真实内容标签则会直接收起工作台,不恢复占位标签。从对话或项目入口打开文件时,预览同样进入当前工作区内容区右侧的工作台,但不会自动携带文件浏览器占位标签。右侧标签位于工作区标签栏下方,是当前工作区的二级标签,不会与工作区标签并列,并与主区域标签一样支持拖拽排序和中键关闭。右键工作台或主窗格中的文件标签,都会先显示与文件列表一致的打开、加入或引用到对话、定位、复制、重命名、创建副本、移动和删除等文件操作,下方保留关闭当前、关闭其他、关闭右侧和关闭全部标签;标题悬停只显示原有关闭按钮,不额外显示「更多」。右键已保存的对话标签时,会在重命名、在新窗口中打开之后,提供与左侧对话列表一致的复制对话、复制深度链接、置顶、移动到分组 / 移出分组,下方是关闭、关闭其他、关闭右侧、关闭全部,最底部为归档对话和删除对话(删除需再点一次确认);导入的 Claude Code 只读历史只显示复制类操作。终端、网页和 Review 标签右键时仍只显示标签关闭操作。主区域中的文件、普通对话、终端或网页浏览标签也可以直接拖到右侧工作台,拖入后会从原窗格移走而不是复制。收起右侧工作台只会隐藏其中的标签;之后从左侧对话列表或文件入口再次打开同一项,会自动展开右侧并定位到原标签。只有关闭右侧标签后,再次打开时才会进入当前聚焦的主窗格。真实文件预览中,点击标签栏最右侧的文件夹按钮可打开或关闭固定在预览右侧的文件列表。窗口空间不足时,整个右侧工作台会按窄屏规则以浮层显示

英文文件工具栏的 Open workspace folder 打开当前工作区或独立文件面板的根目录;具体文件右键菜单的 Show in containing folder 则定位该文件所在目录,两者不是同一个目标。

对话产出很多时,「对话文件 / 文件变动」及回合审阅文件树会随滚动按需显示行,文件总数和目录计数不会截断。文件检查或新增产出不会重新展开你手动折叠的目录;文件行可用上下方向键及 Home / End 在大列表中定位,Enter 打开。重命名过程中滚动列表不会使编辑行消失或自动提交。文件存在检查在后台限量执行,收起或切走后停止未开始的旧检查,不影响已打开的真实文件。

Git

工作区目录本身位于 Git 仓库中时(子目录也算),NewMax 会把 Git 状态直接长在现有界面上,不单独提供 Git 面板。打开或切换到 Git 工作区后,文件管理器默认选中「Git 变动」;首次检测尚未完成时,会在确认是 Git 仓库后自动选中。你仍可手动切到「文件变动」或「所有文件」,后续 Git 状态刷新不会抢回页签;检测期间已手动选择页签或从文件卡片进入指定视图时,也会保留你的选择。普通文档工作区、Git 不可用或读取状态超时的工作区不会显示任何 Git 元素。

变更很多时,Git 变动列表和审阅文件列表会随滚动按需显示文件行,不会减少文件总数。全选、提交和整组暂存仍按当前范围的完整文件集合执行,不仅针对屏幕上可见的几行。大列表中的文件行获得键盘焦点后,可用上下方向键移动,Home / End 定位首尾,Enter 打开文件;进入审阅时会定位当前选中的文件。

审阅会优先读取当前文件;超过 32 个文件时不再预读所有正文,靠后的文件同样可以直接打开。大集合的未提交审阅头部不显示尚未完整统计的仓库总增删行数,当前文件名旁仍显示该文件的统计;历史提交的总数仍来自 Git 的完整提交统计。切换文件、工作区或关闭面板会停止过期的排队读取,普通文件视图不会启动对话归属核验。

大量文件的暂存、取消暂存或丢弃可能分批执行,不会因为列表只显示几行就漏掉其他文件。若中途失败,已完成的批次不会自动撤销;界面会报告错误并刷新实际状态,不会自动重试写操作。

分支状态条

  1. 对话输入框正上方会出现一条状态条:左侧依次是工作区名、「工作在」段(主仓库里显示「本地」,worktree 对话里显示「本地 worktree」)和当前分支名;分支处于游离 HEAD 时显示提交短 sha(由「新建本地 worktree」建出的树直接显示「main」,悬停可见「基于 main 的游离 HEAD · 短 sha」)
  2. 分支比远程领先或落后时在分支名后显示「↑N」「↓N」,悬停可看具体数量;正在合并、变基、拣选、回退或二分查找时会显示对应的黄色状态标签
  3. 有未提交改动时右侧显示「N 个未提交」,点击会展开右侧工作台的文件列表并切换到「Git 变动」视图的「全部」
  4. 隐私模式开启、输入框处于 /help 帮助预览时状态条会隐藏;切换到非 Git 工作区时状态条会沉回输入框后面并消失

操作步骤:从状态条切换工作区

  1. 点击状态条左侧的工作区名,弹出工作区列表,顶部可输入名称或路径过滤,当前工作区右侧带勾
  2. 点击其他工作区后,NewMax 会切到该工作区并直接开始一条新对话:如果当前对话还没有发送过消息,输入框里已经打好的内容会原样带到新对话里(相当于「把这条新对话放到那个工作区去做」);如果当前对话已有消息,它仍留在原工作区,只是到目标工作区开一条空白新对话。列表底部「新建工作区」会打开新建工作区对话框
  3. IM 机器人等内部工作区和没有路径的占位工作区不会出现在列表中

操作步骤:在 worktree 里并行工作(对齐 Codex 的 Work in)

  1. 点击状态条上的「本地」(在 worktree 对话里这一段固定显示「本地 worktree」,悬停可看目录),弹出「工作在」列表,只有两项:「本地」是仓库本体,「新建本地 worktree」表示这条新对话要在一棵新树里跑;当前的选择右侧带勾。列表不罗列已有的 worktree——worktree 对话就在当前工作区的对话列表里(条目右侧带一个和「新建本地 worktree」相同的 worktree 图标),打开那条对话即回到那棵树
  2. 点「新建本地 worktree」不弹窗、不用起名,而且和「新对话」一样只是一个临时状态:点完只会把状态条的「工作在」段切成「新建本地 worktree」(悬停提示「发送第一条消息时会先开出新的 worktree」),此时什么都还没建;改主意就再点回「本地」,或者直接关掉这条草稿,不会留下任何目录。真正发出第一条消息时,NewMax 才在 ~/.newmax/worktrees/<仓库目录名>/<4 位短码>(例如 k3f9)执行 git worktree add --detach main,基于默认分支(origin/HEAD 指向的分支,通常是 main)的最新本地提交建出一份副本——不管当前工作区停在哪个分支,新树都从主线出发;仓库没有默认分支时才用当前 HEAD。接着把主仓库里被 gitignore 的 .claude/skills、.claude/mcp.json、.claude/settings*.json 复制过去,然后这条消息照常发出(附件、划词批注和已选的 Skill 照常生效)。和 Codex 一样不新建工作区:对话留在当前工作区的对话列表里,只是 AI 在这棵树里读写文件、运行命令;打开这条对话时,分支状态条、「Git 变动」视图和改动审阅都显示这棵树的状态;大仓库建树可能要几秒,这期间先不要重复点发送。已经发过消息的对话里选「新建本地 worktree」,会先开一条带着这个选择的新草稿。新树和 Codex 一样是「游离 HEAD」、不自动开分支:状态条分支段显示「main」(起点分支;main 不能同时在两棵树里检出,所以底下并没有真的切到 main),悬停提示「基于 main 的游离 HEAD」,改动可以直接提交;要推送或发布时,先在分支名弹层底部「新建分支…」起一个名字(Git 视图的「发布分支」按钮在此之前是禁用的,副标题会提示)。起点固定是默认分支,不提供从别的分支开树的选项;要在别的分支基础上并行,可在新树里用分支名弹层切过去。建树失败会以 Git 原话提示,草稿和这个选择都保留,停留在当前工作区,改好后再发一次即可。node_modules 这类依赖不会复制,需要时在这棵树里自行安装(也可以直接让 AI 在对话里装)
  3. 在 worktree 对话里点列表里的「本地」,会在当前工作区开一条在仓库本体里运行的新对话(草稿同样带走);已有对话的运行位置不会改变
  4. 在 worktree 里改完想合回主分支:先在这棵树里「新建分支…」把提交挂到一个分支上,再切回「本地」,用分支名弹层底部的「选择分支合并到 <当前分支>…」选那个分支合并即可
  5. 和 Codex 一样,worktree 没有单独的删除按钮,它跟着对话走:在侧边栏归档这条 worktree 对话时,NewMax 会先把这棵树里的改动(包括未提交的修改和新文件)存成快照,再删除目录;取消归档,或在这条对话里继续发消息时,会在原位置把树建回来,改动恢复成未提交状态,之前自己建的分支也会重新检出。被 .gitignore 忽略的文件(例如 node_modules)不在快照里,恢复后需要重新安装。对话还在运行时归档,或同一棵树上还有别的未归档对话时,不会删树。如果在终端里手动删掉了 worktree 目录(没有快照),继续这条对话会提示「worktree 已不存在」,新开一条对话即可。旧版本建出的、单独占一个工作区的 worktree 不受影响,需要时可在终端用 git worktree remove 删除
  6. worktree 是普通的 Git 工作树:同一分支不能同时在两棵树里检出,在其中一棵里切到另一棵正在用的分支时 Git 会拒绝

操作步骤:切换、新建或合并分支

  1. 点击状态条上的分支名(或 Git 视图顶部的「当前分支」按钮),弹出分支列表(对齐 GitHub Desktop):分「默认分支 / 最近分支 / 其他分支」三组——默认分支是远程 origin 的主分支(没有远程时取本地 main / master),最近分支是你最近切换过的分支(最多 5 条),其余按最近提交时间排序;每行右侧显示最近一次提交的时间,当前分支带勾;顶部搜索框可按关键字过滤,空组自动隐藏
  2. 点击其他分支即执行切换,成功后状态条、文件树角标和「Git 变动」视图自动更新。若工作树里的改动会被目标分支覆盖,会弹出「有改动会被目标分支覆盖」确认框并列出这些文件:点「暂存改动并切换」会先 git stash(含未跟踪文件)、切换后自动恢复到新分支;点「取消」则不切换。恢复时若与目标分支冲突,会提示改动仍保留在 git stash 中,请在终端执行 git stash pop 处理冲突。其他失败原因仍以 Git 原话提示
  3. 本地没有的远程分支也会列在「其他分支」里,显示为 origin/分支名;点击会自动创建同名本地分支并跟踪远程分支,再切换过去。已有同名本地分支或已被本地分支跟踪的远程分支不会重复出现;新推到远程的分支要先「抓取 origin」才会出现
  4. 点击弹层最底部的「新建分支…」,搜索行会变成分支名输入框(搜索框里已有的关键字会预填进去),输入后按回车基于当前 HEAD 创建并立即切换;按 Esc 或右侧的 × 取消。搜索没有匹配时列表里还会直接给一条「新建分支「关键字」」,点它同样进入输入。分支名不合法或已存在时以 Git 原话提示
  5. 点击列表底部「选择分支合并到 <当前分支>…」会关掉分支列表、打开「合并到 <当前分支>」弹窗(对齐 GitHub Desktop):顶部搜索框,下面是同样分组的分支列表(当前分支不在候选里),点一行只是选中,弹窗底部会立刻显示预演结果——「将把 <来源> 的 N 个提交合并到 <当前分支>」(能快进时注明不会产生合并提交)、「<当前分支> 已包含 <来源> 的全部提交」(按钮禁用)、「合并 <来源> 会有 N 个文件冲突」(只是提醒,仍可合并)、「没有共同历史,无法合并」(按钮禁用);git 版本太旧无法预判冲突时会注明。确认无误后点底部「合并到 <当前分支>」按钮才真正合并:能快进就快进,否则直接生成合并提交。本地未提交改动与来源分支碰同一文件时合并会被拒绝并列出文件(弹窗保留),请先提交或暂存再合并;合并停在冲突时仓库进入「合并中」,从状态条进入会直接跳到 Git 视图,从 Git 视图进入会直接弹出冲突弹窗,处理方式与拉取冲突完全相同(见下文「Git 视图」第 5 条)。游离 HEAD 状态下没有合并入口

文件树中的改动标记

  1. 打开右侧或底部工作台的文件管理器,切换到「所有文件」
  2. 有未提交改动的文件在文件名右侧显示字母角标:M 修改、A 新增、D 删除、R 重命名、U 未跟踪、! 冲突;悬停可看含义
  3. 包含改动文件的文件夹在名称右侧显示一个小圆点,展开后可继续定位到具体文件

操作步骤:查看未提交改动并逐文件看 diff

  1. Git 仓库工作区里,文件管理器顶部依次显示「Git 变动 / 文件变动 / 所有文件」。点击「Git 变动」查看未提交差异(也可点分支状态条右侧的「N 个未提交」直达);点击中间的「文件变动」直接预览当前对话产出的文件,提交后仍存在的文件也会保留,点击文件即可查看当前内容,不会进入 Git diff。标签只显示名称,不显示文件数量;「所有文件」仍是完整目录树。视图最上面一行是两个双行按钮:左边「当前分支 / 分支名」,点击弹出与状态条相同的分支切换列表;右边是动态同步按钮(对齐 GitHub Desktop):分支尚未发布时显示「发布分支」;远程有新提交时显示「拉取 origin」(向下箭头图标),副标题位显示 N ↓(本地也有待推送时是 N ↑ N ↓);只有待推送时显示「推送 origin」,副标题位显示 N ↑;有计数时副标题后面还跟着上次拉取时间;已与远程同步时按钮变成「抓取 origin」(无下拉箭头),副标题显示上次拉取时间(「N 分钟前」会随时间自动更新,不需要刷新面板)。右侧箭头展开下拉菜单收纳次级操作,每项都是「标题 + 一行说明」:「抓取 origin」(从远程获取最新改动,不改本地分支;只领先时下拉里只有它一项);本地与远程都各有新提交(分叉)时还会出现「强制推送」,按钮上直接写着警告,点击后需要再确认一次,且使用 --force-with-lease——远程在你上次抓取之后又有新提交时会拒绝而不是覆盖。下面是「变动 N / 历史」两个页签切换内容
  2. 「变动」是一张不分组的平铺列表(不区分已跟踪 / 未跟踪 / 已暂存),每行依次是勾选框、文件图标、目录/文件名(目录淡色)和右侧状态图标(方框中的点 = 修改、加号 = 新增、减号 = 删除、箭头 = 重命名、感叹号 = 冲突)。列表头显示「本对话 · N 个改动文件」或「全部 · N 个改动文件」,点一下就在「本对话 / 全部」之间切换(悬停会预告另一范围的文件数)(列表头常驻,切换范围时更新计数和下方列表):「本对话」只显示能够确认当前未提交改动来自本对话的文件;仅在历史对话中改过同一路径,不会把后来其他任务的改动算入本对话。通过终端命令写入的文件,在能识别写入目标且当前内容与该轮记录一致时,也会列入「本对话」;上述终端写入即使缺少修改前内容,也不会仅因无法撤销或统计本轮增删行数而被隐藏。无法确认归属的文件,请切到「全部」查看;进入「Git 变动」或从状态条「N 个未提交」进入时先显示「全部」,之后可在该视图内手动切换范围。本对话改过但已经提交的文件不再出现在 Git 列表里,可切到中间的「文件变动」直接预览,也可在「所有文件」或回复下方的文件卡片里找到;「文件变动」不受 Git 范围过滤影响。非 Git 工作区仍显示「对话文件 / 所有文件」,行为不变
  3. 点击文件行会在右侧工作台打开「未提交改动」审阅标签,顶部与「历史」里点开一条提交的详情同款两行:第一行标题「未提交改动」,第二行左侧是当前 Git 提交身份的头像与名字(来自 Git 配置,未配置时不显示)、紧跟带分支图标的当前分支胶囊(游离 HEAD 时显示 7 位短 SHA),右侧是全部未提交改动的增删总行数;这个标题栏没有「更多」和「打开 Git 终端」按钮。下一行是当前选中文件名及它相对最近一次提交的增删行数,正文为行级 diff(只显示变动及其上下各 3 行,其余折叠成「N 行未修改」,可按 20 行向上/向下展开或全部展开;超过 512KB 的大文件同样只显示有变动的部分,不会再提示「超大文件不支持」,仅当改动本身超过 1 MB 才提示改动太多,并提供「打开文件」在文件预览中查看当前内容)。图片(PNG、JPG、GIF、WebP、SVG 等)会并排显示「修改前 / 修改后」两张图(新增、删除的图片只显示一张),图片下方标出像素尺寸,点击图片可放大查看,超过 20 MB 的图片只显示大小不预览;PDF、Office、音视频、压缩包等其他二进制文件无法逐行比较,会显示前后文件大小和「打开文件」按钮,在文件预览中查看当前内容;图片和其他二进制文件的文件名旁不显示行数统计,也没有「更多」菜单(自动换行、单词级差异、显示空白字符只作用于文本 diff);同一工作区只保留一个该标签。审阅期间右侧文件面板与查看一条提交时同款:不再显示分支、同步按钮、「变动 / 历史」页签、勾选框和底部提交表单,而是换成全部未提交改动的纯文件列表(标题「未提交改动 N」;每行文件图标、目录/文件名、状态图标),点文件在原标签内切换 diff;要勾选文件、提交或撤销提交,先关闭或切走该审阅标签让面板恢复为 Git 视图;关闭「未提交改动」审阅标签时右侧工作台不会跟着收起,而是留在仓库标签上(即使它是最后一个标签),与关闭提交审阅一致。在 Git 视图里悬停文件行会在状态图标左侧显示「打开文件」(在文件预览中打开)和「丢弃改动」
  4. 文件名那一行最右侧的「更多」菜单与本轮 Review 相同,可切换自动换行、单词级差异和空白字符显示(提交审阅标签同一位置也有);这里的 diff 始终是「最近一次提交 ↔ 当前文件」,与是否已暂存无关
  5. 「历史」页签列出最近 50 次提交:标题、作者头像与名字、相对时间,右侧带向上箭头小标签的表示尚未推送到远程。打了 tag 的提交在标题右侧显示 tag 名小标签(对齐 GitHub Desktop):只显示第一个 tag,其余折叠成「+N」,悬停可看完整 tag 列表;只有本地已有的 tag 会显示,远程新打的 tag 需要先抓取(git fetch --tags)。头像来自 GitHub 或 Gravatar,加载时显示圆形骨架占位,同一作者的查询全部结束且所有来源都失败后才显示作者首字母。同一次应用运行中,已加载成功的头像会复用缓存,切换页签或返回历史列表时直接显示。桌面端会先复用本机 GitHub CLI(gh)已有的登录状态,查询不到时再尝试当前仓库的 Git HTTPS 凭据(由 Git 配置的凭据助手管理),以获取有访问权限的私有仓库作者头像,无需在 NewMax 中重复登录。此过程不会主动发起登录,也不会修改 Git 凭据配置;凭据不可用时仍尝试公开头像来源。仅配置 Git 的姓名、邮箱或 SSH key 不能用于此类 API 授权;头像加载失败时,Git「历史」页顶部会显示「连接 GitHub」入口;头像正常显示或仍在加载时不显示此提示。点击「连接 GitHub」:应用会打开浏览器授权页,并在面板显示一次性验证码;点击「复制验证码」,将验证码输入 GitHub 页面并完成授权。验证码与「复制验证码」显示在同一行;等待授权时不再显示重复的「连接 GitHub」按钮。下方同一操作行提供「取消连接」和「打开授权页」:浏览器未打开时可点「打开授权页」重试,或点「取消连接」结束本次等待。授权完成后头像自动刷新,无需重启。若提示未安装 GitHub CLI,点击「安装 GitHub CLI」前往官网安装,再回来连接;授权失败或超时后可重试。也可自行在终端执行 gh auth login。尚未推送的提交可复用同一仓库其他提交已获取的同作者头像;网络或授权失败不会永久阻止后续查询
  6. 点击「历史」里的任意一条提交,会在右侧工作台打开这条提交的审阅标签(对齐 GitHub Desktop 点开一次提交):顶部默认只显示一行提交标题(过长时右缘渐隐),标题最右侧有一个小箭头按钮,点开后显示完整标题和提交说明(小字)、再点收起;折叠时标题下面一行是作者头像与名字,名字后面紧跟带提交图标的 7 位短 SHA 胶囊(点击胶囊任意位置即复制完整 SHA,成功后胶囊尾部的复制图标短暂变成对勾),不显示提交时间,右侧是增删总行数;展开后这一行换成三行详情(对齐 GitHub Desktop):作者名字与邮箱、带提交图标的完整 SHA(同样点一下即复制)、「新增 N 行」「删除 N 行」;这个标题栏没有「更多」和「打开 Git 终端」按钮,「更多」(自动换行 / 单词级差异 / 空白字符)在下方文件名那一行的最右侧。下方是选中文件相对其父提交的行级 diff(与「未提交改动」同款折叠/展开,大文件也只显示有变动的部分),图片同样并排显示这次提交前后的两张图(点击可放大),其他二进制文件只显示前后大小;提交审阅看的是历史版本,因此不提供「打开文件」。审阅提交期间,右侧文件面板不再显示分支、同步和「变动 / 历史」页签,而是换成这条提交改动的文件列表(标题「提交改动 N」;每行文件图标、目录/文件名、状态图标),点文件切换工作台里的 diff。同一工作区只保留一个提交审阅标签,再点其他提交会在原标签内切换并自动选中第一个文件;关闭或切走该标签后文件面板恢复为 Git 视图,可再从「历史」页选别的提交;关闭提交审阅标签时右侧工作台不会跟着收起,而是留在仓库标签上(即使它是最后一个标签)

操作步骤:提交、撤销提交、推送、拉取

  1. 勾选框决定哪些文件进入本次提交(对齐 GitHub Desktop):新出现的改动默认全部勾上,列表头的总勾选框可全选 / 全不选;有冲突的文件不能勾选,需先解决冲突(合并中的冲突处理见第 5 条)。提交时 NewMax 会把勾选文件的完整内容放进 index、把没勾选的从 index 拿出来,所以日常不需要手动暂存;仍想手动管理 index 的话,悬停文件行有「+ 暂存」,列表头有「全部暂存」。一旦有已暂存的文件,列表会像 VS Code 一样分成「已暂存 / 变动」两段(同一文件两边都有改动时两边都列出),段标题可收起 / 展开,右侧是「全部取消暂存」或「全部丢弃 / 全部暂存」和文件计数,已暂存段的文件行提供「− 取消暂存」
  2. 提交标题左侧显示当前 Git 提交身份的头像,悬停、点击或键盘聚焦头像可打开身份卡片,查看头像、姓名和邮箱;鼠标移开后卡片自动收起。点击「Git 设置」卡片标题或右侧箭头可展开、收起表单,选择「当前仓库」或「全局」,填写姓名和邮箱后点击「保存」;保存后收起表单,点击「取消」也可收起且不保存改动。当前仓库配置优先于全局配置,Git 环境变量也可能覆盖配置。Git 提交身份与 GitHub 登录账号独立。若提示「Git 设置尚未就绪」,重启应用后重试。头像复用历史列表的加载与缓存,未配置身份时不显示。 在列表底部填写「提交标题(必填)」和可选的「描述」,点「提交 N 个文件到 <分支>」,或在输入框里按 Command+Enter(Windows / Linux 为 Ctrl+Enter);标题和描述之间会自动空一行。变基等操作进行中或(非合并状态下)存在冲突文件时按钮禁用;合并进行中按钮变成「提交合并」,见第 5 条。成功后会提示提交的短 sha
  3. 提交后最下方会出现「上次提交 · 多久前」+ 提交标题 + 「撤销」,点击撤销会执行 git reset --soft HEAD~1,改动回到列表里(已勾选状态);这一栏只在该提交尚未推送时显示,推送后自动消失,已推送的提交不提供撤销
  4. 「丢弃改动」(行悬停或列表头右侧的「全部丢弃」)会先弹确认框:已修改文件恢复到最近一次提交或已暂存的内容,未跟踪文件会被删除,不可撤销
  5. 点击「推送」会先抓取远程最新状态:发现远程有新提交时,先拉取合并到本地,确认成功且没有冲突后,再自动推送当前分支;远程没有新提交则直接推送。抓取或拉取失败、合并冲突、暂存恢复冲突都会停止,不会继续推送。分支尚未关联远程时按钮显示「发布分支」,直接推送并建立跟踪,不自动拉取;「强制推送」仍是单独确认的操作,不走自动拉取;「拉取」对齐 GitHub Desktop:能快进就快进,本地和远程各有新提交(分叉)时直接合并并生成一个合并提交,不再弹确认。合并遇到冲突时会弹出「解决冲突后再合并到 <分支>」:逐个列出冲突文件和剩余冲突数(悬停可「打开文件」到编辑器),在编辑器里删掉 <<<<<<< / ======= / >>>>>>> 标记并保存后,该行会自动变成「已解决」(不需要手动 git add);全部解决后点「提交合并」即完成合并,或点「放弃合并」回到拉取前的状态。关掉弹窗后,「变动」列表顶部会常驻一条「合并有冲突:解决后提交即可合并到 <分支>」横幅,点「查看冲突」可再打开弹窗;提交标题会预填 Git 的合并信息(如 Merge remote-tracking branch 'origin/main'),底部提交按钮变为「提交合并」,冲突未解完时禁用,解完后变绿提示直接提交。二进制文件等无法识别冲突标记的会标「需手动处理」,请在终端解决后再提交合并。在终端里执行 git merge 停在冲突时也会出现同样的横幅和弹窗。本地未提交的改动与远程更新碰到同一文件时,会弹出「有改动会被拉取覆盖」确认并列出这些文件,点「暂存改动并拉取」会先 git stash 再拉取,拉完自动恢复(含已暂存状态);恢复时如果冲突,改动仍在 git stash 里,提示会带「在终端打开」让你手动 git stash pop;若拉取本身停在合并冲突,暂存的改动会保留在 git stash 里,冲突弹窗会提醒提交合并后执行 git stash pop 取回。推送前自动拉取碰到本地改动会被覆盖时,也会先弹「暂存改动并拉取」确认;确认后重新同步最新远端,成功且改动恢复无冲突后才继续推送,点「取消」则停止。等待确认时如果切换了分支或上游,原推送不会继续。拉取停在合并冲突时不会推送,按冲突弹窗解决并提交合并后再点「推送」即可。如果同步完成后、真正推送前远端又有新提交,仍会提示「远程有新提交,先拉取再推送」,可点提示上的「拉取并推送」重试。完整推送流程期间按钮保持进度反馈并禁止重复点击,分支按钮也暂时禁用;成功不弹提示,失败才提示(只有需要输入凭据这类必须交互的失败才带「在终端打开」)。没有配置远程仓库时同步按钮禁用 点击「抓取 origin」,或「推送」开始时的抓取阶段,遇到网络抖动、连接超时或远端暂时不可用会自动重试:依次等待 1、2、4 秒,最多重试 3 次。期间按钮保持加载状态,不会因首次断连立即提示你去终端;恢复后继续原操作,重试仍失败才显示错误。账号、权限、证书或仓库配置错误会直接提示,不盲目重试。此机制只重试抓取,不会重复执行推送、拉取合并或暂存操作。
  6. 推送或拉取需要输入账号密码、SSH 口令等交互时,NewMax 不会弹出输入框,而是立即失败并在错误提示里提供「在终端打开」;在终端里完成一次后,系统的凭据缓存会让这里的后续推送直接成功
  7. 需要在终端处理时(凭据、无法识别标记的冲突),失败提示里的「在终端打开」会以仓库根目录打开内置终端,也可从工作台「+」新建终端;文件管理器工具栏的刷新按钮会同时重新读取文件树和 Git 状态。在终端里执行 checkout、commit、add 等命令后,状态条、角标、列表和历史会自动更新,无需手动刷新

终端

内置终端功能,无需切换到外部终端。

操作步骤:打开终端面板

  1. 在工作区标签栏右侧点击底部工作台按钮
  2. 底部工作台为空时会直接创建并打开一个终端
  3. 也可以在主区域、右侧工作台或底部工作台的标签栏点击 +,选择「新建终端」

操作步骤:管理终端会话

  1. 终端打开后会显示为普通标签
  2. 点击标签栏中的 + 并选择「新建终端」可继续创建会话(每个工作区最多 9 个)
  3. 点击不同标签切换终端会话
  4. 拖拽标签可调整顺序
  5. 可把终端标签拖到主窗格、右侧工作台或底部工作台;目标区域会立即选中同一个终端会话并保留已有输出。从主窗格拖入后,点击主窗格不会收起工作台;手动收起再展开仍可继续使用该终端。切换到另一对话时仍显示该对话自己的工作台,切回原对话后恢复终端标签
  6. 右键终端标签选择「在新窗口中打开」,或把标签拖到另一个 NewMax 主窗口、拖出所有主窗口,可把同一个终端进程移动到目标窗口;目标接管成功后源标签才会移除,不会另起空 Shell
  7. 点击标签上的 X 关闭该终端
  8. 拖拽终端面板顶部边缘可调整面板高度

操作步骤:插入文件或文件夹路径

  1. 从工作区文件列表或系统文件管理器拖拽文件、文件夹
  2. 移到终端内容区任意位置;整个终端区域高亮后松开
  3. 终端会插入经过 Shell 转义的路径并保留一个尾随空格,不会执行命令,也不会移动原文件或文件夹

操作步骤:关闭终端面板

  1. 再次点击工作区标签栏右侧的底部工作台按钮
  2. 底部工作台收起隐藏,终端标签和会话状态会保留,界面渲染资源会在收起后释放;重新展开时终端会恢复此前输出。也可以只关闭对应终端标签来结束该会话

定时任务

定时任务页:新建任务与执行记录

独立于长期计划的轻量级定时任务系统。

操作步骤:进入定时任务管理

  1. 点击左侧导航栏第三个按钮「定时任务」(时钟图标)
  2. 第二栏切换为「定时任务」标题、筛选和任务/执行列表,替换原来的会话列表;右侧显示选中项详情,不再额外占一栏或重复显示页面标题。浏览器、每日回顾也采用这种布局。顶部全局侧栏开关可以收起或展开当前功能栏,窄窗口以浮层打开,选择条目后关闭浮层。点击窗口顶部全局「返回」回到上一个位置,或点击左侧导航「首页」恢复会话列表和对话。该页面不归属任何工作区,也不会占用工作区标签栏
  3. 点击第二栏「定时任务」标题行最右侧的「更多」(⋯),在菜单中选择「全部工作区」或指定工作区;当前范围在菜单中高亮,也可悬停「更多」查看

操作步骤:创建定时任务

  1. 点击定时任务独立页左侧栏说明文字下方的通栏「新建任务」按钮,打开结构化配置对话框;弹窗宽度与「创建长期计划」保持一致
  2. 手动配置对话框内也可以点击「通过对话一步步创建」,随时切换为通过对话创建任务
    • 通过对话创建只负责辅助填写并确认与手动配置相同的字段;确认后复用同一套存储、调度、执行和结果展示,不会创建另一种任务或改变执行方式
    • 入口会立即打开正常对话,自动替你发送「帮我创建一个定时任务」,再由 AI 回复并询问任务描述;你只需回复一个简单诉求,AI 会自行补全任务名称、执行提示词和执行计划,不会按表单字段逐项提问。只有关键歧义无法合理推断时,才会在汇总前最多追问一次
    • 对话创建也支持每月重复,例如「每月 1 日上午 9 点提醒我还款」或「每月 1 日和 15 日提醒我整理账单」。可选择每月 1–31 日中的一个或多个日期,当月不存在的日期会跳过;确认汇总后创建。也可以在对话中修改已有任务的每月日期或重复方式
    • 对话创建的默认设置与手动创建一致:未说明时间或重复方式时使用每天 09:00,不启用额外 Skill、使用默认模型、立即启用、推送到已配置的机器人;AI 会展示一次完整汇总,确认后才创建,也可以选择继续修改
  3. 手动配置时填写以下内容:
    • 任务名称:给任务起个名字
    • 执行内容:描述 AI 要执行的操作(提示词)。输入卡与「创建长期计划」保持一致,Skill 和模型选择都集中在输入卡底部
    • 绑定技能(可选):点击输入卡左下角的 Skill 按钮,或直接输入 / 搜索 Skill;选中的 Skill 会以行内引用显示在执行内容中,可直接删除引用来移除
    • 执行模型与思考强度:在输入卡右下角选择该任务使用的模型;模型和思考强度只作用于当前定时任务,不会修改普通对话的当前模型或全局「思考模式」。支持思考强度的模型会在模型名称旁显示“自动 / 低 / 中 / 高”等当前档位,并可在同一个模型菜单中调整;新建任务时以全局档位作为初始值,之后随任务独立保存;任务详情的「执行模型」与对话输入框一致,显示模型名称和当前思考强度。如果任务所选模型的服务商在「设置 → 模型」中被删除或停用,任务会自动改为跟随默认模型,之后默认模型变化时任务也随之变化,任务详情直接显示当前默认模型的名称;需要固定使用某个模型时,编辑任务并在模型菜单中重新选择后保存
    • 执行工作区:选择任务运行时使用的工作区(默认为当前工作区)
    • 重复方式:选择执行频率
      • 单次执行:选择具体日期和时间,只执行一次
      • 每天执行:设置每天的执行时间(如 09:00)
      • 每周执行:选择星期几和执行时间(支持多选,如每周一、三、五 09:00)
      • 每月执行:在「重复类型」选择「每月」,选择每月 1–31 日中的一个或多个日期及执行时间;默认选择 1 日。当月不存在的日期会跳过,例如选择 31 日时,2 月不会执行。每月任务也支持在选定日期内开启「周期内重复」
    • 立即启用:保存后立即按计划执行;关闭时只保存任务配置
    • 推送到机器人:将任务执行结果推送到已配置的 IM 机器人
    • 定时任务会根据执行内容自动判断是否使用已启用的 NewMax Provider 连接器:指定账号作品、笔记列表、点赞/收藏/评论、榜单、分页等平台结构化数据会优先使用连接器;宽泛的行业动态或多来源社交讨论会使用当前可用的搜索能力。需要强制使用时可明确写出「使用 XX 连接器」或「通过 XX API 获取……」。这条规则适用于所有执行模型
    • 需要打开网页操作时:定时任务会使用 NewMax 内置浏览器完成,例如登录后台、翻页、填表、抓取页面内容。任务里可以直接写「打开 XX 后台看今天的订单数」,不需要也不允许它自己去启动 Chrome、Playwright 等外部浏览器。需要登录态时,先在「浏览器」页里用对应身份手动登录一次,定时任务会复用该身份;存在多个身份时在提示词里点名要用哪个
  4. 点击「保存」保存手动配置的任务

操作步骤:管理已有定时任务

  1. 在任务列表中找到目标任务
  2. 可进行的操作:
    • 开关切换:点击任务列表项右侧的开关会立即保存启用状态;关闭后会立即取消当前执行,停止尚未开始和之后的自动调度,并收起到列表底部的「已关闭」分组;已关闭任务仍可通过「立即执行」手动运行一次
    • 手动触发:点击「立即执行」按钮,不等定时触发直接运行一次
    • 编辑任务:修改任务名称、提示词、工作区、执行时间、重复规则、模型或技能后保存
    • 查看执行记录:切换到「执行」页签查看历次执行尝试,记录按时间从新到旧连续排列,不再按「今天」「最近 7 天」等时间段分组,每条记录右侧保留执行时间。默认先加载最近 10 条并选中最新一次执行,需要时点击「加载更多」继续查看;从完成通知进入时则选中通知指定的那次执行。正常运行可打开关联对话;如果模型或工作区校验在创建对话前失败,该次尝试仍会保留。执行记录不提供普通对话的「继续 / 重试」、重新生成、编辑后重发或「在新对话中继续」(Fork)入口;需要重新运行时,使用记录顶部的「再次执行」,以保留新的任务状态和执行日志。失败空状态会用简短文案说明模型不可用、默认模型缺失或工作区不可用等原因,并提供「编辑任务」入口。任务详情里的「上次执行」也会同时标明成功、失败或已取消
    • 预览与审阅执行文件:执行回复产出文件后会显示统一的「编辑了 N 个文件」卡片。点击单个文件行会在定时任务独立右栏预览当前内容;有文本变动时,点击卡片标题或「审阅文件」会在同一右栏打开本轮 diff。不支持行数统计的文件不显示行数或「无法统计行数」,也不会遮住其他文件的正常增删汇总。图片和其他二进制文件的标题下方改为显示格式或类型摘要;单文件可从头部直接预览,多文件需选择下方具体文件。历史执行记录若保存了 Write 内容或完整 diff,会自动恢复真实增删行数;无法恢复内容的文本文件不显示行数统计,也不再回退到旧文件卡片。该右栏只展示任务产出的文件预览、Review 或回复中的网页,不显示执行工作区的完整文件管理器、工作区文件占位标签、文件夹按钮或新建其他工作台标签的 + 入口。没有预览内容时,页面头部不显示右栏按钮;打开任一预览后按钮会自动出现,可用于收起或重新展开。每个任务和执行记录分别保留右栏的打开状态、标签和内容,切换后互不影响,返回时恢复;只有关闭最后一个预览标签时才会自动收起并隐藏按钮
    • 不可统计文件摘要:如果某次执行产出的所有文件都不支持行数统计,文件变动卡片标题下方默认显示「文件已更新」,悬停时在原位置切换为「查看变动」
    • 删除任务:先点击任务详情右上角的「编辑」(执行记录顶部为「编辑任务」),再点击编辑弹窗左下角的「删除」。按钮会在原位置变成「确认删除」,再次点击才移除任务,不会另开确认弹窗;移开鼠标、将焦点移到其他控件或关闭后重开弹窗,会取消确认。新建任务弹窗不显示删除。删除成功后弹窗关闭;删除失败则保留弹窗并显示错误,可重试。任务详情右上角不再直接提供删除按钮
  3. 点击第二栏标题行最右侧的「更多」(⋯),可按工作区筛选任务和执行记录
  4. 每个任务会显示下次执行时间

定时任务执行说明

  • 任务在设定时间自动启动,在后台创建独立对话执行
  • 如果设定时间客户端未运行,任务会在客户端下次可用时补执行一次;如果到点执行因网络等临时错误失败,会保留该次补执行并稍后重试
  • 执行过程中可以实时查看流式输出(含 AI 思考过程和工具调用详情),点击任务行弹出执行窗口
  • 每次执行尝试都会记录到执行日志。已经创建对话的执行可查看完整过程;模型不可用、工作区不存在等发生在创建对话前的失败也会保留在「执行」列表。点开失败记录后会看到简短原因和「编辑任务」入口
  • 执行记录不显示会改写或分叉当次执行历史的消息级入口:普通对话的「继续 / 重试」、重新生成、编辑后重发或「在新对话中继续」(Fork)。点击顶部「再次执行」会通过定时任务服务创建一次新执行,并正确记录成功、失败或取消状态
  • 定时任务右栏复用普通对话的文件预览、Review 与网页预览能力,但使用独立状态且不提供完整工作区文件管理器。点击执行记录中的产出文件行会直接打开当前内容预览;有文本变动时,点击变动卡片标题或「审阅文件」会在同一独立右栏打开该轮 Review diff,图片和其他二进制文件则统一打开文件预览,回复中的网页链接也会自动在这里打开。右栏不会显示「执行工作区」文件占位标签、文件夹按钮、「变动文件 / 所有文件」列表或新建其他工作台标签的 + 入口。没有预览内容时不显示右栏按钮;打开预览后按钮出现,手动收起时预览和按钮会保留以便重新展开,关闭最后一个预览标签后自动收起并隐藏按钮。每个任务和执行记录分别保存右栏状态,切换不会把其他任务的右栏带过来,返回时会恢复原有标签、内容和展开状态。定时任务执行记录暂不提供消息选区的「添加到对话」「详细解释」或「在侧边对话中提问」,避免跳出定时任务独立页。定时任务右栏不会改变普通工作区当前打开的文件或 Review 标签。已打开的 TXT、Markdown、CSV、PDF、DOCX、PPTX、XLSX、图片等支持格式会继续跟随磁盘修改自动刷新
  • 执行中的内置浏览器:正在查看某次执行记录时,任务调用的内置浏览器会在该执行页右侧工作台打开,不会跳到普通对话页。切换到其他执行记录或离开任务页后,后台浏览器不会抢走当前页面;回到对应执行记录,可用页面头部的右栏按钮展开查看。手动收起工作台后,后续浏览器操作不会反复将它打开
  • 执行失败会在日志中记录错误信息,并在任务详情的「上次执行」旁明确标记「失败」,不会只显示一个容易误解为成功的时间
  • 任务运行时,侧栏「定时任务」导航、定时任务独立页和对应执行记录会显示运行圆点;执行完成且结果尚未查看时,这些入口会改为未读圆点提示。定时任务页面本身跨工作区(默认列出所有工作区的任务),因此这两种圆点也跨工作区:只要任意工作区有任务在跑或有结果未查看,当前工作区的侧栏导航和「定时任务」标签就会亮起,不必先切换到任务所属工作区

执行记录支持单独删除:将鼠标移到记录上,点击「更多 → 删除」,再点击「确认」。模型不可用等未生成对话的失败记录也可以删除;删除执行记录不会删除定时任务或改变后续执行计划。

操作步骤:配置定时任务的完成通知

  1. 在创建/编辑定时任务的对话框中找到「完成通知」区域
  2. 可选择推送方式(多选):
    • 桌面系统通知:弹出系统级通知
    • IM 机器人:推送到已配置的飞书 / 企微 / 自定义 Webhook 频道
  3. IM 频道在「设置 → 通知」中统一管理,新建后所有定时任务和项目通知共用

搜索

全文搜索:跨工作区搜索对话、长期计划与项目

操作步骤:全文搜索对话

  1. 点击侧栏「对话」标题栏最右侧的「搜索」(放大镜图标);侧栏收起时可先展开,也可使用搜索快捷键(默认 macOS 为 ⌘K,Windows 为 Ctrl+K)
  2. 弹出搜索对话框
  3. 在搜索框中输入至少 2 个字符后,会搜索所有工作区的普通对话、长期计划项目和项目内对话;可匹配对话标题与正文,也可匹配项目标题与计划正文,包括归档内容
  4. 输入关键词后,结果按「标题匹配」「正文匹配」分组,标题匹配优先,每组内按更新时间倒序;正文命中时会显示包含关键词的摘要并高亮关键词,长期计划结果会显示类型标识,非当前工作区的结果会显示所属工作区名称
  5. 点击搜索结果即可自动切换到对应工作区,并打开对话或长期计划

操作步骤:当前对话内查找

  1. 在任意对话页面中按 Cmd+F(Mac)或 Ctrl+F(Windows)
  2. 页面顶部弹出查找栏
  3. 输入要查找的文字
  4. 页面中匹配内容高亮显示;长对话里还没展开的更早消息、以及收起的深度思考和执行过程也在查找范围内
  5. 查找栏显示「当前第 X 个 / 共 Y 个匹配」;正在补齐更早历史时先显示「搜索中…」,匹配数会随之增加
  6. 点击上/下箭头或按 Enter 在匹配项之间跳转
  7. 按 Esc 关闭查找栏

本页目录