设置与个性化
账户、钱包、主题、权限、每日回顾、连接器、网络代理与数据管理等全部设置项。
设置把 NewMax 调成你顺手的样子:主题配色、快捷键、提示词优化、权限模式、通知提示音、数据备份、网络代理等一应俱全。这里也是钱包、账户、每日回顾、连接器与企业团队的统一管理入口。

安装前确认系统版本
macOS 版需要 macOS 13(Ventura)或更新版本。在苹果菜单 →「关于本机」查看系统版本;macOS 12 及更早版本无法运行新版,需要先升级系统。
操作步骤:打开设置
在 NewMax 主窗口中按 Command+,(macOS)或 Ctrl+,(Windows / Linux)可直接打开设置;也可以使用下方入口:
- 在左侧导航栏最底部找到用户头像图标
- 已登录:显示用户头像或名字首字母
- 游客模式:显示「G」头像和「游客模式」标签
- 点击头像图标
- 弹出「设置」对话框
- 左侧侧边栏最上方是「搜索设置」输入框,可直接输入关键词快速定位设置项;有搜索内容时显示匹配结果,清空后恢复分组导航
- 左侧入口分为三组,标签仅用于分类,不可点击或折叠;点击具体入口后,右侧显示对应设置内容:
- 账户与偏好:账户、钱包、通用、偏好
- AI 与服务:模型、每日回顾、连接、电脑操作
- 系统信息:数据、关于
- 修改完成后点击右下角「完成」保存
带开关的设置请点击右侧开关本身;点击标题、说明或行内空白不会切换。圆角悬停底色仅提示内容归属,不代表整行可点击。分隔线用于区分不同设置分区,同组设置通过间距区分。
国际版显示钱包(USD、Stripe 充值),不含邀请好友入口。模型及媒体设置只显示当前版本支持的渠道。海外 API、订阅、本地模型、自定义兼容服务,以及「连接 → 网关」里的本地开放 API 功能仍可使用。
个性化
操作步骤:设置用户名称和工作描述
- 打开设置 → 点击左侧「偏好」→ 顶部「个性化」
- 在「姓名」输入框中填入你的名字
- 设置后,首页问候语会显示你的名字(如"Yangyi 晚上好")
- 在「工作描述」输入框中描述你的工作内容
- AI 会根据此信息更好地理解你的需求和习惯
- 在「全局提示词」输入框中添加对 AI 的通用指令(可选)
- 这里的提示词会自动附加到普通对话,并传递给对话中启动的内置或自定义子代理
- 保存后从下一次新回复开始生效;无需退出应用,也不需要写入
CLAUDE.md - NewMax 不会把 Claude Code 的用户级
~/.claude/CLAUDE.md或~/.claude/rules/当作 NewMax 个性化;工作区内显式维护的项目级CLAUDE.md仍会作为该工作区的项目规则生效 - 如需核对当前内容,可以在对话中问「看看 NewMax 设置的全局提示词」。NewMax 只显示你在偏好设置中填写的内容,不显示应用内置系统指令
- 点击「完成」保存
通用设置

操作步骤:切换界面语言(国际版)
- 打开 Settings → General → App(设置 → 通用 → 应用),找到 Language(语言)。
- 在下拉列表中选择语言。目前国际版提供 English 和 Español,后续语言会随翻译完成陆续加入;选择后界面立即切换,并保存在本机。
- 国内版固定使用简体中文,不显示此选项。该设置只改变界面文字,不改变你与 AI 对话时使用的语言。
操作步骤:选择是否参与使用统计与转化测量(国际版)
- 打开 Settings → General → App(设置 → 通用 → 应用)。
- 找到 Usage statistics(使用统计)。这是可选的本机开关,默认关闭,不会从另一台设备的云设置中自动开启;国内版和离线版不显示此项。
- 如愿意参与,主动打开开关。登录后只统计首次观测到登录客户端、首次完成的常规对话任务以及最终任务失败;首次观测不是精确安装时间,游客期间或开启前完成的任务不会补报。
- 发送的内容仅为随机事件 ID、事件名称、时间、应用版本、操作系统平台和概括错误分类,不包含提示词、文件内容、文件路径、原始错误或模型 URL。服务器通过登录凭据关联账号,因此这是账号关联的使用统计,不是匿名统计;不发送对话内容或额外身份字段。
- 随时关闭该开关即可停止新的统计并删除本机待发事件;此前已记录的服务端事件不会因此删除。切换账号或退出登录也会丢弃原账号的待发事件,绝不会转发给新账号。
这只是可选的转化测量,不覆盖所有使用行为;自动任务、循环、子任务回流、等待你回答、取消的任务等不会被计作首次任务成功。本开关不等同于反馈/崩溃报告或手机文件同步授权,也不控制这些独立功能。
Choose whether to share usage statistics (international edition)
Open Settings → General → App → Usage statistics. This optional, device-local setting is off by default and is not enabled through cloud settings. It is not available in the domestic or offline editions.
When you opt in and sign in, NewMax measures the first observed signed-in client, the first completed regular chat task, and final task failures. It sends only a random event ID, event name, time, app version, platform, and broad error category. It never includes prompts, files, paths, raw errors, or model URLs. Events are linked to your signed-in account by the server, so this is not fully anonymous. First observation is not an exact installation time, and earlier guest or opted-out tasks are not backfilled.
Turn the setting off at any time to stop new events and delete unsent events on this device. Events already recorded on the server remain. Signing out or switching accounts also discards the old account's pending events. Automated tasks, loops, child-task returns, cancellations and tasks waiting for your input are not counted as first-task success. This setting does not control separate environment/crash reporting, feedback or mobile file synchronization.
操作步骤:设置全局唤起快捷键
- 打开设置 → 点击左侧「偏好」→ 顶部「快捷键」
- 找到「快捷键唤起小窗」设置项
- 点击当前快捷键显示区域(默认显示 Command+W)
- 按下新的快捷键组合
- 新快捷键立即生效,在任何应用中都可按此快捷键唤起NewMax快速输入窗口
操作步骤:设置语音输入快捷键
- 打开设置 → 点击左侧「偏好」→ 顶部「快捷键」
- 找到「语音输入快捷键」设置项
- 先打开旁边的开关(启用语音快捷键功能)
- 点击快捷键显示区域
- 按下想要的快捷键组合
- 设置完成后,在任何界面中按住该快捷键即可开始录音,松开自动转文字
macOS 上语音快捷键(含默认的 Fn 键)需要「辅助功能」权限。未授权时会收到「需要辅助功能权限」系统通知:点击通知即打开系统设置的「辅助功能」面板并弹出授权助手小窗,把 NewMax 图标拖进列表并打开开关,授权后录音快捷键自动生效,不需要重新开关此功能或重启。若不使用语音快捷键,关闭该开关后就不会再收到这条通知。
操作步骤:设置桌面宠物显示/隐藏快捷键
- 打开设置 → 点击左侧「偏好」→ 顶部「快捷键」
- 找到「桌面宠物显示/隐藏快捷键」设置项(英文 Toggle desktop companion,与 Desktop Companion 功能名称一致)
- 打开旁边的开关
- 点击快捷键显示区域
- 按下想要的快捷键组合
- 设置完成后,在任何界面中按下该快捷键即可显示或隐藏桌面宠物
此处开关只控制快捷键是否启用,不会直接隐藏宠物。若要立即隐藏,请前往设置 → 通用 → 应用,关闭「桌面宠物」。
操作步骤:设置舒适阅读快捷键
- 打开「设置 → 偏好 → 快捷键」
- 找到「切换舒适阅读」,默认启用;macOS 默认 Command+Shift+L,Windows / Linux 默认 Ctrl+Shift+L
- 点击当前快捷键,按下新的组合;需包含 Command / Ctrl / Alt / Super 中至少一个,不能使用普通字符或仅 Shift 的组合,按 Esc 可取消
- 关闭设置回到工作区后,按快捷键即可切换舒适阅读与标准显示;右上角咖啡杯的提示和帮助菜单的快捷键列表会同步更新
关闭此项快捷键只停止按键响应,不会改变当前阅读档位,也不影响右上角咖啡杯按钮。修改立即生效并保存,设置和模态弹窗中不会切换背后的对话排版。
操作步骤:设置规划与目标模式快捷键
- 打开设置 → 点击左侧「偏好」→ 顶部「快捷键」
- 找到「切换规划模式」或「切换目标模式」
- 打开对应开关
- 点击快捷键显示区域,按下想要的组合键
- 回到对话后按下快捷键即可开启对应模式;再次按下会切换回原状态
两项快捷键默认关闭。规划模式快捷键会在开启和退出之间切换;目标模式尚未启动时会开启或退出,运行中会暂停,暂停后会恢复。
操作步骤:设置提示词优化快捷键
- 打开设置 → 点击左侧「偏好」→ 顶部「快捷键」
- 找到「优化提示词」;该快捷键默认开启并使用 Tab
- 点击当前快捷键,直接按 Tab 或按下新的快捷键组合
- 回到对话,输入普通文本后按该快捷键即可优化草稿
空输入时 Tab 保留原有行为,只会填入当前轮换占位提示;
/、@菜单和 Shift+Tab 模式提示也会优先处理各自的 Tab 操作。
操作步骤:开启和更换桌面宠物
- 打开设置 → 点击左侧「通用」→ 顶部「应用」
- 找到「桌面宠物」设置项
- 打开右侧开关即可显示桌面宠物
- 在宠物下拉框中选择想使用的宠物;安装包共内置 5 款:「墨瞳」、Codex 生成的 v2 宠物「小煤球」、OpenPets 的「星角兽 Starcorn」、Hopet 的「Hopi 小海豹」和 UniPet 的「Uni 机器人」。三款第三方宠物均来自近期活跃的开源桌宠项目,采用作者随项目发布的 MIT 原版 Codex 宠物包,不生成、补画或重画姿势
- 拖动「宠物尺寸」滑杆,可在 70%–120% 之间即时调整宠物大小
- 如刚添加了新的宠物包,点击刷新按钮重新扫描
- 点击「导入宠物包」选择
.zip文件即可安装;应用会先检查文件,通过后才写入宠物包文件夹。已有同名宠物时需要先移除旧的再导入。也可以点击「打开目录」,把宠物包文件夹直接放入其中- 选中自己导入的宠物后会出现「移除」,确认后从宠物包文件夹删除;正在使用的宠物被移除时自动回到默认宠物。内置宠物和 Codex 目录里的宠物不可移除
- 宠物包只允许
pet.json、webp / png 精灵图以及 JSON、文本说明;含符号链接、不安全路径、过大文件或与内置宠物重复 ID 的包会被拒绝并提示原因
- 点击「获取更多宠物」会在系统浏览器打开 Codex Pets 宠物目录网站;目录中第三方资源的使用条件与许可请以各自来源页面为准
- 显示桌面宠物后,也可以右键宠物,在菜单中选择「隐藏宠物」
- 按住宠物本体拖动可调整它在桌面上的位置;连接多个显示器时可直接将宠物跨屏拖动,并可将宠物本体贴到屏幕边缘,透明气泡区域不会让宠物提前消失;手动放置后宠物会留在目标屏幕,移动主窗口不会改变宠物位置;在 macOS 上,宠物会显示在所有桌面空间和全屏空间,各桌面空间共用同一位置
- 宠物气泡出现时,可点击气泡打开对应对话;普通回答的完成气泡会直接定位到该次回答开头,无需再点消息目录,想看结尾时可点「回到底部」。旧气泡未记录回答位置或该回答已删除时按原有方式打开;定时任务气泡会打开「定时任务」并定位到对应任务或执行记录。等待问询气泡可点「Reply」在气泡内回复,按 Esc 可取消回复;点击单条气泡左上角关闭按钮可只关闭该条;点击气泡下方的圆形按钮可收起或展开气泡列表
多窗口下点击宠物气泡,会优先回到当前显示该对话或仍接收其回复的窗口。如果对话已切到后台且回复已结束,会回到发出气泡的聊天窗口;来源窗口已关闭时,才在最近使用的窗口打开。定时任务气泡仍定位到对应任务或执行记录。
关闭桌面宠物后再次开启时,宠物会回到 NewMax 主窗口当前所在屏幕的可见区域,避免遗留在其它显示器上找不到。
宠物包需要包含
pet.json和spritesheet.webp。NewMax 也会识别 Codex 宠物目录中的兼容宠物包:优先读取CODEX_HOME/pets,未设置时读取~/.codex/pets。由 Codex 生成且在pet.json中标记spriteVersionNumber: 2的宠物,会在普通待机时使用 16 个方向帧跟随鼠标;工作、拖动、彩蛋和睡眠动画不会被覆盖。开启 NewMax「减少动画」或系统减少动画后,视线跟随会停用。NewMax 只会把许可证明确且已保留许可信息的资源作为内置宠物随安装包分发。「获取更多宠物」仅提供其他第三方资源的来源入口,不代表 NewMax 已审核或重新分发这些资源;下载和使用前请在来源页面确认作者、许可证与适用条件。
操作步骤:配置其他通用选项
- 打开设置 → 点击左侧「通用」
- 在顶部「应用」中根据需要调整:
- 菜单栏:是否在系统菜单栏显示应用图标
- 开机自动启动:是否在电脑登录时自动启动NewMax
- 通知:是否接收任务完成、权限审批和计划审批的系统桌面通知;开启后可分别选择提示音
- 桌面宠物:是否显示桌面宠物,并可选择本机或 Codex 兼容宠物包、拖动滑杆调整宠物尺寸
- 退出时保留文件标签页:开启后,重启应用时保留上次打开的文件标签页(关闭则下次启动只剩对话标签)
- 减少动画:关闭界面过渡动画,降低 GPU 功耗
- 在顶部「任务」中根据需要调整:
- 任务运行时阻止休眠:开启后,对话回复、定时任务或后台任务运行期间会阻止电脑进入闲置休眠,任务结束后自动恢复,适合把窗口切到后台长时间跑任务。注意:无法阻止合上笔记本盖子、手动休眠或关机;电脑已经休眠时定时任务也不会唤醒电脑执行
- Agent 资源调度:默认选择「自动(推荐)」,NewMax 会结合 CPU 和总内存档位统一安排普通对话、长期项目、定时任务和 IM Agent。前台对话优先,后台任务超过容量时会显示「等待本机资源」;排队较久的后台任务会自动提升调度优先级,已经运行的任务不会被强行暂停
- 这组设置只保存在当前设备,不会通过设置云同步复制到算力不同的电脑
- 资源模式:可切换为全速、均衡或省资源;自动与全速模式按 CPU 和总内存使用较高的稳定并发档位,最高 10 个。例如 8 个逻辑 CPU / 16GB 内存默认 8 个,12 个逻辑 CPU / 24GB 内存默认 10 个;不会因窗口失焦或瞬时空闲内存波动降低并发。感觉电脑卡顿时,可手动降低「并发上限」,或切换均衡、省资源模式。窗口失焦时只降低自动进程优先级
- 并发上限:
0表示自动,手动可设为 1–10。后台任务可使用全部空闲名额;自动档已被后台任务占满时,允许一个前台对话临时超出常规上限,避免长期浪费预留名额。手动上限和省资源模式仍是严格上限 - 不同对话即使使用同一个工作目录,也可以按上述上限并行思考、读取和修改不同文件。两个对话通过 Write、Edit 等工具写入同一个文件时,只会让冲突的写入调用依次执行;不会把整段对话加入工作区队列。Bash 命令可能修改无法预先确定的一组文件,因此只在该命令实际执行期间使用工作区写入锁;一个工作区的冲突队列不会阻塞其他工作区。等待工作区写入锁或构建名额的时间不计入工具超时,长任务结束释放资源后,排队中的调用会继续;取消或结束对话会移除尚未执行的排队调用
- Agent 等待你回答问题或手动审批工具时,会临时释放本机并发名额;收到你的决定后会先重新取得名额再继续,不会让无人操作的等待占住运行容量
- 进程优先级:默认自动,也可固定为正常、低或最低;只影响之后启动的本机 Agent 进程,自动模式会在窗口进入后台时降低优先级
- 单对话子代理上限:默认显示「推荐(4)」,也可手动选择 1–8。前台、后台以及子代理继续派生的子代理都计入同一个对话上限;所有对话还共享一个按资源模式和硬件档位计算的全局子代理池,避免多个对话同时派生时把本机压满。超过任一上限的新调用按先后顺序等待,已有子代理继续运行。子代理结束或启动失败后会自动回收名额并启动下一项;取消或结束对话时会清空尚未启动的等待项
- 重型工具与构建并发上限:使用滑块在 1–4 之间调整,新安装默认推荐 3。生图、辅助识图以及 Vitest、Make、Cargo 和 npm 构建/测试命令共享同一个全局并发池;设置修改后会立即作用于已排队任务。构建命令内部还会使用对应的并行参数;如果 Agent 总并发或硬件容量更低,实际并发会随之降低。已有用户手动或历史保存的数值保持不变;你已设置的同名环境变量不会被覆盖
- Skill 工作区选装模式:改为按工作区单独启用技能库中的 Skill
- 会话历史同步:Claude Code、Codex、Qwen Code、WorkBuddy、DeepSeek Harness 统一列在此处,各自显示简短说明和独立开关;公共同步规则只显示一次,来源限制见各行描述。侧栏仅显示已开启的来源;关闭后隐藏对应分组,已同步记录保留,重新开启恢复显示。全部关闭时隐藏「其他客户端对话」分区
- 会话历史同步 → Claude Code:首次开启后导入本机的 Claude Code 历史(所有项目目录,默认同步最近 20 个会话,更多历史可在侧栏来源分组末尾点击「加载更多」按需获取),在侧栏「其他客户端对话」的「Claude Code」分组查看;所有工作区共享同一份,当前工作区目录下的会话排在前面,在任何工作区点开都留在当前工作区。支持终端和 Claude 桌面版 Code 写入的本地记录,包括从桌面版转到终端继续的会话;不会拉取 Claude 网页聊天或云端历史。之后更新使用侧栏的手动同步按钮。若桌面版记录曾被旧版本漏掉,更新后可手动同步重新检查;旧规则升级时会重新扫描,旧版本中主动清除的导入也可能重新出现。新版正常清除导入后不会因切换工作区自动恢复;清除会删除所有工作区看到的这份导入对话。需要全部重新导入时,关闭再打开此开关。同步与清除导入都不会改写或删除 Claude 原始历史文件
- 会话历史同步 → 其他来源:按名称分别开启 Codex、Qwen Code、WorkBuddy、DeepSeek Harness。由内置 Pinekin 引擎提供,设置中无需另开一个同步区域。NewMax 直接读取本机日志,不需要安装或打开 Pinekin。开启后回到主界面会自动导入一次会话,所有来源规则一致:不按工作目录过滤,所有工作区共享同一份,工作目录在当前工作区文件夹内的会话排在前面(WorkBuddy 没有工作目录,不参与这个排序);新会话放进触发同步的那个工作区,之后更新留在原处,在任何工作区点开都留在当前工作区。清除导入会删除所有工作区看到的这份导入对话。在侧栏与「最近对话」同级的「其他客户端对话」中查看,内部按 Claude Code、Codex、Qwen Code、WorkBuddy、DeepSeek Harness 分组,客户端各自可折叠及加载更多,对话标题不再重复客户端名称;之后更新用「其他客户端对话」标题右侧「⋯」菜单里的「同步历史」。每个来源默认同步最近 20 个会话;展开来源时先显示5条,点「加载更多」再读取下一页,已同步记录展示完后才按每批20个加载更早的本机历史。列表加载失败时,保留已显示的记录,再点「加载更多」可重试。已加载范围会保留,普通同步不会自行扩大范围,旧版已导入记录不会删除;已映射的思考和工具记录只作展示,工具的参数和结果超过 1500 字符会被截断,不会重新执行。DeepSeek Harness 首批仅导入 v4 独立主会话的问答文本,不含推理、工具或附件,也不是 DeepSeek 网页聊天;默认读取
~/.dsh/sessions,也支持DSH_HOME,其他自定义日志目录暂不支持在 NewMax 设置中指定。缺少工作目录的 Harness 会话仍会导入,但不能按工作区排序。Harness 支持普通或 Zstandard 压缩日志;历史压缩、继承、委派、表面替换、多分支及尚未支持的事件会保守跳过,不保证所有 v4 日志都兼容。清除导入后不会被自动导回;要全部重新导入,关闭再打开对应来源。标注「当前系统尚未验证」的来源仍可开启,但读取路径还未在当前系统上验证。同步与清除都不会改写或删除这些客户端的原始日志 - 自动保存浏览器自动化任务:浏览器任务完成后提示保存为自动化任务
- 在顶部「Agent」中配置 AI 执行行为:
- 权限模式:默认使用「完全访问」;也可切换为询问批准(对需要审批的本地工具和自定义 MCP 操作逐次询问;NewMax 自带 API 与其他内置 MCP 的明确只读动作自动通过,变更动作仍会询问)/ 为我批准(低风险操作直接执行,包括调度子代理;只放行子代理启动动作,子代理内部的具体操作仍单独判断;其他未决操作会先结合本轮请求自动判断,只有仍需你决定时才显示审批;支持该能力的默认 Claude 模型使用原生审核,第三方模型使用当前提供商和模型执行 NewMax 审核,失败时回退人工审批;不支持原生审核的旧版默认 Claude 也回退人工审批)/ 完全访问(不受限制地操作电脑文件,联网仍受联网开关控制)。电脑操作仍始终遵循独立的按应用审批,不会被自动审核绕过。更改会在下一次新回复生效
- 自定义子代理:首次使用会提供默认开启的研究员、代码审查员、调试专家和内容编辑四个入门预置,也可创建自己的专业助手。设置页显示已启用数量和总数,点击统计区域或「管理」后可在独立列表中按名称或适用场景搜索,并按启用状态筛选;管理栏统计文字前的复选框可全选当前筛选结果,勾选列表项后可批量启用、停用或删除。可使用与对话相同的模型选择器,为未单独配置的子代理统一选择默认模型和思考强度;预置保存到本机后与自定义子代理完全相同,可关闭、修改名称、适用场景、指令、工具权限、模型和思考强度,也可删除;管理列表与编辑详情会按同一规则显示每个子代理实际采用的模型回退档位与思考强度
- 自动记忆:默认开启。开启时 AI 会在对话中把你的偏好、纠正过的做法和项目背景记到本机记忆库(
~/.newmax/projects/<项目>/memory/,按工作区所在的 git 仓库或目录分开保存),之后在同一项目的对话里自动带上,不需要每次重复交代。保存成功时对话底部会短暂显示「已记住:…」胶囊。关闭后 AI 不再读取或写入记忆,已保存的记忆文件原地保留;开关修改从下一条消息开始生效。默认 Claude 与第三方模型都支持,第三方模型写入记忆的质量取决于模型本身。开关下方的「管理」打开记忆管理面板:按项目查看全部记忆、搜索与按类型筛选、编辑或删除单条、直接编辑MEMORY.md索引,以及头部的「整理」与「⋯」菜单里的「从 Claude Code 导入」「在文件管理器中打开」「刷新」——整理按规则归档过期的项目记忆、修正索引,导入把终端 Claude Code(~/.claude)里的记忆复制进当前项目,已有同名的不覆盖,原文件保留(详见references/chat.md的「查看和整理记忆」) - 自动整理记忆:默认开启,位于「自动记忆」下方。不调用 AI、不花 token:距上次整理超过 24 小时、且期间有 3 个以上对话写过记忆时,在对话结束后自动跑一遍规则整理——带完成标记(已提交 / 已发版 / commit 号)且 14 天没改过的项目记忆、45 天没改过的其他项目记忆、重复文件会移到该项目记忆目录下的
_archive/,索引里的死链清掉、漏掉的条目补上。关于你 / 工作方式 / 参考类记忆不会被自动归档。归档的条目在记忆管理面板「整理 → 已归档」里随时可恢复。关闭后只能在面板里手动点「整理」 - 提示词优化:默认开启;关闭或重新开启后会记住你的选择。开启时,输入框里有普通文本后可按 Tab,或将鼠标移到输入区域并点击紧跟在最后一个字后的优化按钮;空输入时 Tab 仍用于填入轮换占位提示。模型计算完成后,末尾加载图标会消失,结果会以多组词组连续交错、从模糊到清晰的方式逐步改写当前草稿。功能不会自动发送或弹出完成通知。下方会显示实际使用的优化模型,可直接点击切换,并在同一个菜单查看或调整思考强度;首次配置时以全局「思考模式」作为初始值,之后独立保存,调整优化模型的强度不会修改全局设置。建议选择 Gemini Flash、GPT mini 或 Claude Haiku 等响应速度较快的模型
- 思考模式:设置默认思考强度;「极低」仅在当前模型明确支持
minimal时出现在模型菜单中,表示保留最低限度推理,不等同于关闭 - 显示:控制执行过程和工具调用的展示方式
操作步骤:创建自动调用的自定义子代理
- 打开「设置 → 通用 → Agent」
- 在「自定义子代理」区域可先设置「默认子代理模型」。模型和思考强度使用与对话相同的选择器与菜单结构;未单独指定配置的自定义子代理会优先使用这里的模型与思考强度。默认模型也适用于系统内置的通用、探索、规划子代理,以及自动编排时未单独选模的默认子代理;自定义子代理已有的独立模型仍优先。可以选择与主对话不同的服务商,子代理会使用对应服务商的模型与凭证,不改变主对话的模型。指定服务商被删除、停用或模型已失效时,会显示「配置不可用 · 请重新选择」,执行时明确报错,不会悄悄改用其他模型。设置过默认模型后,选择器右侧会出现还原图标,点击即清除默认配置、重新跟随当前对话(与工作区默认模型的还原方式一致);修改或清除后从下一次新回复开始生效,不会中途改变正在运行的子代理模型
- 设置页会显示已启用数量和总数。点击「管理」打开完整列表;子代理较多时,可搜索名称或适用场景,也可切换「全部」「已启用」「未启用」筛选
- 管理栏统计文字前的复选框可一键全选当前筛选结果;只选中部分结果时会显示半选状态。列表包含四个默认开启的通用预置:研究员、代码审查员、调试专家、内容编辑;可直接使用右侧开关启停。点击需要的预置,可修改名称、适用场景、子代理指令、工具权限、模型和思考强度;预置与自己创建的子代理一样可以删除,删除后不会在重启应用时恢复
- 若预置不符合需求,在管理窗口右上角点击「添加」,用一句话描述希望这个助手完成什么,例如“审查代码风险和测试遗漏”
- 点击「AI 生成配置」。NewMax 会使用已配置的提示词优化模型;未单独配置时使用默认模型,自动补全名称、适用场景、子代理指令和建议的工具权限。名称默认生成类似“研究员”“代码审查员”的简短角色名,具体任务范围和触发条件放在“何时使用”中
- 在生成后的检查页确认内容;需要时直接修改任意字段。模型未单独指定时使用「默认子代理模型」,未设置默认配置时跟随当前对话;也可从已配置模型中为该子代理单独指定,并在同一个模型选择器中设置「自动、低、中、高、超高、最高」思考强度。单独指定后,选择器右侧会出现还原图标,点击即改回使用默认子代理模型或跟随当前对话。单独配置可跨服务商使用,已有的独立模型和思考强度优先于默认配置。指定模型被删除或服务商不可用时,请重新选择有效模型;也可点击还原图标,明确改用默认配置或当前对话,不会在执行时自动换模型。建议优先使用「仅只读工具」,确实需要修改文件或执行命令时再选「继承当前对话」
- 点击「保存」并保持该子代理为启用状态。熟悉这些配置时,也可在创建页点击「手动填写」跳过 AI 生成
- 回到普通对话直接描述任务。AI 会根据「何时使用」自动判断是否调用,不需要手动点选
自定义子代理条目仅保存在本机,不属于设置重置项,也不会同步到云端;默认子代理的模型与思考强度属于模型设置,可随模型配置同步。当前版本只在普通对话中自动调用,不用于规划模式、定时任务或导入的 Claude Code 对话。子代理按「单独指定配置 → 默认子代理配置 → 当前对话」选择模型和思考强度,只有未配置才继承下一档;前两项支持与主对话不同的服务商。同名模型也会按你指定的服务商分别执行,并发子代理不会互相改写配置。指定配置失效时,列表与详情提示重新选择,执行明确失败;原生 Claude 未登录或登录过期时也需先恢复登录,原生短别名尚未解析时需刷新默认 Claude 模型列表,不会借用其他服务商的凭证。子代理不会继续创建下一层子代理。编辑、启停、删除或修改默认配置后,会从下一次新回复开始生效。
操作步骤:为不同通知设置提示音
- 打开「设置 → 通用 → 应用」
- 开启「通知」
- 分别为「任务完成音效」「权限审批音效」「计划审批音效」选择
Lite、Food、Quiet、Glass、Bell、Pop、Pulse、Success或「静音」 - 点击每行右侧的音符按钮可试听当前提示音
- 设置立即生效;选择「静音」(英文 No sound)只关闭该类通知的声音,桌面通知仍会显示;各事件可以选择相同或不同的声音,不要求每类都使用不同音效
默认提示音依次为
Lite、Food和Quiet。关闭「通知」总开关后,三类桌面通知及其声音都会关闭。英文 Permission request sound 与 Plan approval request sound 分别提醒你有待处理的权限或计划审批,不表示操作已经获准。
操作步骤:开启提示词优化并选择模型
- 打开「设置 → 通用 → Agent」
- 「提示词优化」默认开启;如曾关闭,可在这里重新开启,应用会记住你的选择
- 查看「优化模型」下显示的具体模型和当前思考强度;如需更换,点击模型选择器并选择提供商和模型,或从菜单底部的「思考强度」二级菜单调整档位。单独选过模型后,选择器右侧会出现还原图标,点击即还原为跟随默认模型。建议选择 Gemini Flash、GPT mini 或 Claude Haiku 等响应速度较快的模型
- 回到对话,在输入框中写好普通文本后按 Tab,或将鼠标移到输入区域并点击末尾出现的优化按钮;快捷键可在「设置 → 偏好 → 快捷键 → 优化提示词」中关闭或修改
- 模型计算完成后,末尾加载图标会消失;优化结果会以多组词组连续交错、从模糊到清晰的方式逐步替换当前草稿并保留在输入框中;动画期间光标隐藏,结束后显示在文末;不弹出完成通知,由你确认后再发送
提示词优化使用这里选择的专用模型;未单独设置时使用应用默认模型,不跟随聊天输入框中的模型切换。优化失败时会显示错误并保留当前草稿,不会把错误信息写进输入框。若提示未登录或登录过期,请检查这里的优化模型:使用默认 Claude 时恢复 Claude 登录,或将「优化模型」切换为已经配置且可用的其他服务商模型后重试。
操作步骤:修复异常模型配置
如果错误页显示 trim is not a function,或对话提示「请重新选择模型」,先不要清空数据或反复重装。
- 能够进入界面:在输入框的模型菜单明确选择一个有效模型;必要时到「设置 → 模型」修正对应提供商的模型列表。模型 ID 应填写非空文本,不是对象或数字。
- 停在「应用程序发生异常」页:点击「修复模型配置」,阅读说明,再点击「备份并修复」。显示修复完成后点击「重新加载」,回到界面重新选择模型。
- 修复前会在本机保存数据库设置与当前窗口设置缓存的原文备份;只隔离异常模型字段,保留密钥、服务地址、对话和项目,不自动更换模型,也不会发起模型请求。
- 有任务运行、备份失败、数据库或缓存无法写入时会提示修复未完成。不要把它当作成功;等待任务结束、检查存储空间后重试,持续失败再提交反馈。不要上传含 API Key 的原始配置。
- 如果页面只有原生「重新加载 / 打开日志 / 退出」按钮,说明应用页面尚未加载,不能使用这个修复入口;按启动失败说明保留日志反馈。
此操作不同于下方的「恢复默认设置」:后者会重置 API Key 等全部设置,不应作为模型格式异常的首选。
操作步骤:恢复默认设置
- 打开设置 → 点击左侧「通用」→ 顶部「应用」
- 滚动到「应用」页面底部的「恢复默认设置」区域
- 查看说明,确认该操作会重置模型、API Key、快捷键、权限、代理等设置
- 点击「恢复默认」按钮
- 在确认弹窗中查看将受影响的设置范围
- 模型供应商、API Key、Base URL 和模型优先级
- 快捷键、权限模式、代理和搜索服务
- 主题、通知、每日回顾、网关和 MCP 相关设置
- 勾选「我知道这会重置模型、API Key、快捷键等设置」
- 点击「确认恢复默认」
- 所有设置恢复为初始值
- 如需取消本次恢复默认,回到同一区域点击「撤销恢复默认」
恢复默认前,NewMax 会在本机保留一份设置快照。「撤销恢复默认」按钮只会在有可还原快照时显示,还原成功后该快照会被清除。
主题设置
操作步骤:切换主题外观
- 打开设置 → 点击左侧「偏好」→ 顶部「主题」
- 选择外观模式:
- 浅色:白天使用的亮色界面
- 深色:护眼暗色界面
- 自动:原「跟随系统」改为按日出日落或自定义时间切换,不再跟随操作系统的深浅模式。默认在当地日出后使用浅色、日落后使用深色;每天按保存城市的位置重新计算,不需要每天联网查询。选中自动后,点击旁边的昼夜曲线图标(「自动时段设置」)打开浮层;默认不展开,不挤动下方背景主题。点击外部、关闭按钮或按 Esc 收起。打开和关闭沿用共享弹层的淡入淡出效果;开启「减少动画」时即时显示和收起
- 首次选择自动且没有保存城市时会查询城市级网络位置;打开浮层可查看城市和「网络估算」来源。不会申请精确定位权限;查询不使用 NewMax 应用内代理,但系统 VPN / TUN 仍可能影响位置。请核对城市,明显与本机时区不符时会先要求确认,不直接采用
- 浮层与设置按钮居中对齐,靠近窗口边缘时自动避让。时段页、城市页、搜索中和查询结果保持相同尺寸,首页曲线区域相应增高;城市结果在内部滚动,查询失败或位置待确认不会撑大浮层。首页只在城市行显示「查询失败」或「待确认」,点击城市行可查看完整说明、重新查询或确认位置;这些提示不会在返回首页后追加到图表下面。窗口较小时,内容在浮层内部滚动以保留操作入口。底部城市行可点击,进入紧凑的城市搜索页,不会在图表下面继续堆叠表单;输入中文或英文名称,点击结果即可返回时段页。左上角返回按钮或 Esc 也可返回,不改当前城市。目录离线检索,不向外部服务发送城市搜索;找不到时可选附近大城市。日出日落模式可点击搜索页的「重新查询」获取网络估算,悬停可查看 VPN 影响说明;应用不会因代理切换每天改掉保存的位置
- 浮层以昼夜弧线展示浅色时段,弧线是时段示意而非真实太阳高度。横轴固定为当天日出前 2 小时至日落后 2 小时(不超出 00:00–24:00),不随自定义时段缩放;例如日出 06:33、日落 17:41,横轴为 04:33–19:41。拖动两个圆点分别调整开始和结束时间,拖动中、松手后及重新打开浮层,坐标均保持不变;拖拽时间限制在横轴范围内,指针移出图表后停在对应边界,不会继续改到图表外的时间。方向键及 Home/End 也遵守相同边界。松开才保存为「自定义」,次日不会被自动日出日落覆盖。更改城市或日期变化时,横轴按新的太阳时间更新;无位置时用临时时段作为固定基准,太阳事件跨午夜或极昼极夜时保留完整日轴。时间按本机时区显示。也可用 Tab 聚焦圆点后按方向键每次调整 5 分钟,按住 Shift 调整 15 分钟
- 主题直接预约下一个切换时间,到点切换,不在后台每分钟检查;日期变化时重新计算日出日落,电脑唤醒或重新聚焦后按当前时间校正。图上的当前时间点仅在时段浮层可见时每分钟更新;收起浮层、进入城市搜索或窗口不可见时停止刷新,返回后立即更新
- 点击「恢复日出日落」重新使用所选城市的每日时间。极昼全天浅色、极夜全天深色;此时可点击「自定义时段」再拖动调整,不显示不存在的日出日落
- 查询失败或尚未设置城市时,会明确显示临时
06:00–18:00,不是查到的真实日出日落;仍可更改城市或直接拖动自定义。位置和自定义时段只保存在本机,不通过设置云同步复制到其它设备;主窗口、快速小窗和桌宠使用同一切换规则,电脑唤醒或重新聚焦后会按当前时间修正
- 升级到支持背景主题的版本后,会继续使用此前保存的颜色主题;只有主动选择内置背景或上传图片/视频时,才会切换到背景主题
- 在「背景主题」中选择 11 个内置主题:新增的五张排在最前面,依次为云隐群峰、晴蓝枝影、深林绿叶、暮光纤草与素蕊流金,后接青崖飞瀑、落日海岸、雾海浮石、粉柳晴空、暮野金穗与黑羽静栖;雪岭秋雾、月映暖筑、湖居秋林、晚霞花影不再提供选择,恢复预置也不会重新加入,但已经使用它们的背景与配色会保留;默认回退主题为云隐群峰,已上传的同图副本也会保留;主题排成一行,鼠标移到卡片上会放大该卡片并显示图片作者;主题较多一行放不下时,两侧边缘会渐隐提示还有更多,点击最左或最右那张卡片、按住这一行左右拖动、在这一行上用触控板左右滑动,或按住 Shift 滚动鼠标滚轮,都可以逐张查看其余主题。也可点击标题栏右侧的上传图标按钮(悬浮提示「上传图片或视频」)选择 JPG、PNG、WebP 图片或 MP4、M4V、MOV、WebM 视频。当前页显示时,也可把这些文件拖入主窗口任意位置,松开即可上传。处理会在后台继续,主窗口右下角显示带动态圆点的进度胶囊,文案会依次显示读取图片、提取视频画面、分析主题配色、保存主题资源、带实际百分比的视频优化和完成视频主题等当前步骤;期间可以关闭设置或继续其它操作。处理成功后胶囊会短暂显示「图片主题已设置」或「视频主题已设置」;失败提示会保留到手动关闭或再次上传。4K 或高帧率视频需要先转码,可能等待几分钟。NewMax 会把媒体副本保存到应用数据目录,以不含扩展名的文件名作为默认主题名称;图片直接取色,视频先自动提取一帧作为海报和缩略图,再生成配套的浅色与深色界面配色,并先降至 30fps 再自动转为最高 1080p/30fps 的 H.264 MP4,降低导入耗时、持续解码、发热和存储开销。视频背景静音循环播放,窗口不可见时自动暂停并在恢复可见后继续;加载或解码失败时保留海报画面,应用内开启「减少动画」或系统开启减少动态效果时不创建视频层,只显示海报。将鼠标移到上传主题卡片上,可点击编辑按钮修改名称,并在海报预览上拖动圆形定位点设置缩放裁切中心。删除时再次点击确认,会一并删除 NewMax 保存的媒体、海报、缩略图和应用内 4K 备份,但不会删除最初选择的外部源文件;内置主题只从列表隐藏,可通过标题栏右侧的恢复图标按钮(悬浮提示「恢复预置」,仅在有隐藏预置时显示)重新显示
- 想用其他照片时,点击「背景主题」标题下方的「找壁纸」链接,前往 Unsplash,在 NewMax 内置浏览器浏览并下载喜欢的壁纸,再通过「上传图片或视频」导入;当前界面无法承载内置浏览器时会回退到系统浏览器
- 背景只在主 Pane 展示;窗口框架、左侧栏、右侧工作台和底部工作台使用画面生成的实体配色,顶部工作区 Tab、对话 Tab 保持实色。标题栏右侧的 Tabbar 可选「模糊」或「覆盖色」:「模糊」会柔化整个视频画面并使用阅读光幕;「覆盖色」保留画面清晰度,在整张背景上叠加半透明主题色,并在正文阅读区域增加向两侧渐隐的浅色衬底,以保证复杂背景上的内容可读性
- 深色模式会统一压暗原图与模糊背景层以保证文字对比度,不会单独重复压暗对话内容区
- 在独立的「颜色主题」中选择随机、墨绿、霁青、极简、Claude 或奢华。选择颜色主题会退出当前背景主题,但已上传的背景主题会保留
- 点「随机」可让系统按 mood × 配色方案抽样生成新主题;随机结果包含明亮中性灰、低饱和、高饱和、暖色等不同风格
- 如需自定义配色,在「自定义」卡片中点击「主色」打开拾色器,可在饱和度/亮度面板和色相轨道中拖动,也可直接输入 HEX 色值。「随主题」默认开启:选色所在的浅色或深色模式会原样使用该主色,切换到另一模式时会在保留色相与色彩特征的同时,自动生成与选色当下相同对比度的对应色;拾色器始终显示当前模式实际应用的颜色,关闭「随主题」时会将该颜色固化为新主色,避免当前界面发生颜色跳变,之后深浅模式都直接使用该颜色。「纯度」调整内容与背景层级的色彩鲜艳程度(降到 0 时生成纯灰内容层级);「对比度」调整主要文字可读性并加强卡片与输入框阴影,将文字和背景的 WCAG 保证对比度调整到 4.5:1–12:1。自定义主题从固定的舒适浅灰基调开始,随对比度提升逐渐减弱背景染色并同步强化主文字、次级文字和辅助文字;拉到最高时,浅色模式的
surface-100和surface-200收敛为纯白,主文字与白色背景的实际对比度达到至少 17:1;深色模式的surface-200收敛到接近黑色但不使用纯黑,其他 surface 在该基准上保持均匀层级,弹窗蒙层使用基于surface-100的半透明颜色。按钮和图标始终保留适配后的主题色。每次修改都会立即应用,自定义与随机及预设主题互斥选中 - 调整聊天字体大小(13-18px,默认 14px)
- 如需减少界面过渡动画,前往「设置 → 通用 → 应用」开启「减少动画」
操作步骤:配置工具调用显示
- 打开「设置 → 通用 → Agent」,在「显示」区域找到执行过程与工具调用选项
- 收起执行过程:默认开启,将整轮思考、问询、工具调用和子任务合并为一条带总耗时的「执行过程」摘要,仍可手动点击展开;AI 返回的普通正文不会根据工具调用位置被收起,始终保持在摘要外;当前待回答的问询会保持可见,回答完成后随历史执行过程收起;关闭后直接展示完整过程,不生成额外的折叠项
- 显示工具调用:开启后可以看到 AI 使用了哪些工具
- 默认展开工具调用:开启后工具调用的输入和输出详情自动展开,无需再次点击
电脑操作(Windows / macOS)
电脑操作用于必须查看或点击图形界面的本机任务。Windows 通过当前活动桌面操作窗口;macOS 通过系统辅助功能操作应用并读取目标窗口画面。两种平台共用电脑操作总开关、按应用审批和「始终允许」列表;操作期间会以不拦截鼠标的蓝色边框标出当前目标窗口,任务结束后自动清除。
操作步骤:启用电脑操作
- 打开「设置 → 电脑操作」
- 在「控制」区域开启「任何应用」
- 在 macOS 上,确认「系统权限」中的「辅助功能」和「屏幕录制」均已授权;未授权时点击「打开系统设置」,NewMax 会跳到对应面板并在屏幕右下角弹出一个授权助手小窗——把小窗里的 NewMax 图标拖进系统设置的列表,再打开右侧开关即可;授权成功后小窗自动关闭,设置页状态同步更新
- 回到对话,明确说明要操作的应用、窗口和流程,例如:「用电脑操作打开记事本,输入会议摘要并保存」或「打开 TextEdit 并整理这段文字」
- AI 首次准备查看或操作某个应用时会弹出审批:
- 点击「允许」只批准当前动作
- 点击「本次会话允许」允许该应用在当前对话继续操作
- 点击「始终允许」会把该应用加入持久授权列表,后续任务无需再次确认
- 点击「拒绝」会停止该次操作
- 需要撤销持久授权时,回到「设置 → 电脑操作」,在「始终允许的应用」中点击「移除」
也可以在「可见应用」列表中直接将应用设为「始终允许」。列表会显示应用名称、稳定标识和应用图标;系统无法读取图标时显示通用电脑操作图标。Windows 使用应用可执行文件标识,macOS 使用稳定的 Bundle ID 保存授权。Windows 中以管理员身份运行的应用不能由普通权限的 NewMax 控制;终端应用以及 NewMax、Codex、ChatGPT 自身同样受保护,不能加入授权列表或被电脑操作控制。
「任何应用」是独立于普通权限模式的电脑操作总开关:关闭后,即使对话使用「完全权限」也不会加载电脑操作能力。总开关开启后,具体应用仍按当前动作、本次会话或始终允许授权。目标窗口不可见、桌面已锁定或窗口发生意外切换时,应停止任务并重新确认现场。文件读取、文件编辑和命令执行仍遵循原有权限与沙箱设置。
模型设置
详见 models.md — 操作步骤:添加 AI 提供商、切换模型、智能路由。
扩展管理
插件、连接器和自定义 MCP 管理已集中到左侧导航栏「扩展」中的二级侧栏,分别点击「插件」「连接器」「MCP」进入;设置的「连接」仍保留搜索、IM 机器人、网关和网络。
MCP 管理
打开「扩展 → MCP」可以添加、编辑、启用、停用或删除自定义 MCP 服务器,支持 stdio、HTTP 和 SSE 连接。点击服务器整行可打开详情进行编辑,删除入口位于详情弹窗左下角。保存启用状态的配置或从列表启用服务器时,NewMax 会先完成 MCP 初始化并读取工具列表;测试失败会保持停用,并提示找不到命令、超时或连接错误,避免异常配置影响后续对话。也可以在对话中明确让 AI 添加 MCP:AI 只会打开一份默认停用的预填配置草案,必须由你检查并点击「添加」后才会保存,不能静默覆盖、编辑或删除现有服务器。缺少 API Key 等密钥不会阻止草案弹出;AI 已知环境变量名称时会保留空值,供你在弹窗内补充。编辑服务器时,「启用此服务器」控制服务器是否可用。已启用服务器的工具定义默认按需加载,AI 搜索到相关工具时再加载,以减少上下文占用;在对话中 @mention 某个服务器时会直接加载其工具,无需单独设置。内置 MCP 由 NewMax 维护,不在管理页显示或编辑。这里是自定义服务器唯一的启停入口;回到主对话或快速输入窗口,输入 / 并选择「MCP 服务器」(或直接输入 /mcp),可以只读查看服务器描述和全局启用状态。
详见 skills-mcp.md — 操作步骤:添加、管理和在对话中查看自定义 MCP 服务器状态。
每日回顾

英文界面中,Unfinished Work 对应未完成事项,Technical Topics 对应已讨论的技术主题;每日摘要覆盖生成时向前 24 小时,不是“昨天”自然日。分析只依据已有对话材料,不表示额外联网研究,也不测量实际工时或工作效率。
NewMax 可以定期自动生成工作洞察报告。每日回顾以独立双栏页面打开——左侧是历史回顾列表(支持 hover 删除),右侧是当前回顾详情,不会占用工作区标签栏;侧栏入口、设置中的开关和首次未配置时的引导都会进入这个页面。
操作步骤:手动生成 / 打开每日回顾
- 点击侧栏「每日回顾」入口(未开启自动生成时也能在这里手动跑一次)
- 第二栏替换为「每日回顾」标题、操作和历史回顾列表,右侧展示选中报告,不再同时显示首页会话列表。顶部全局侧栏开关可以收起/展开功能栏;点击「首页」恢复会话列表
- 点击第二栏「每日回顾」标题最右侧的「⋯ 更多」,在菜单中选择「生成每日回顾」,回顾当前打开工作区最近 24 小时内的对话消息;选择「生成深度分析」可按已配置周期生成阶段回顾,「回顾设置」可调整自动生成和分析模块。选择操作后菜单自动关闭;生成期间再次打开菜单,两项生成操作暂不可用,仍可进入回顾设置
- 报告开头会显示起止时间,按所选模块整理已完成事项、明确待办、待确认状态和下一步建议。点击结论中的原对话链接,可以打开对应对话核对
长对话或大量记录会取近期消息并截取正文,报告可能只覆盖部分素材;完成状态来自对话中的描述。使用统计是全局记录的用量,不是单个工作区的成本,各币种分别展示。
新生成回顾的「重新生成」会复用首次生成时的时间范围、工作区和分析模块,使用当前回顾模型设置。若其中某个工作区未加载或已删除,需要先恢复该工作区。旧回顾没有完整范围记录,会按原标题日期和归属工作区重新生成。
回顾详情输入框默认使用「回顾设置」中选择的分析模型。你在某条回顾的输入框中手动切换模型后,该选择仅对这条回顾的后续聊天生效,切换回顾或重启应用后仍会保留;其他未手动切换的回顾继续跟随回顾设置。输入框切换模型不会修改回顾设置中的分析模型。
在手机上操作每日回顾
使用支持手机回顾操作的桌面端和手机端版本,并保持已配对桌面端在线。在手机底部打开「每日回顾」,点击「生成每日回顾」或「生成深度分析」,由桌面端按其已打开的工作区和回顾配置生成。连接多台桌面端时,先选择执行设备;生成期间可继续查看同一次操作的进度。
点击回顾页的「设置」进入「回顾设置」,可调整自动生成、时间、分析周期与模块、Claude Code 历史范围及回顾模型,点击「保存设置」后以桌面端回执确认成功。生成时间以桌面端所在时区为准。若提示设置已变化,重新读取后再修改。通知渠道和思考预算继续使用桌面端原有设置。
操作步骤:配置每日回顾自动生成
- 打开设置 → 点击左侧「每日回顾」(也可点击每日回顾页标题最右侧的「⋯ 更多」→「回顾设置」)
- 找到「每日回顾」区域
- 开启每日回顾开关
- 设置执行时间(默认早上 8:00)
- 选择要包含的模块:
- 对话摘要:最近 24 小时的工作主线和已完成事项
- 遗漏提醒:明确待办和需要确认的状态
- 使用洞察:全局 Token 用量、各币种成本和模型请求分布
- 代码建议:代码相关讨论、已确认改动和建议
操作步骤:配置深度洞察
- 在 AI 洞察设置中找到「深度洞察」区域
- 设置周期:每周 / 每两周 / 每月
- 选择执行日(星期几或每月几号)
- 选择要包含的模块:
- 路线图分析:项目进展评估
- 趋势分析:使用模式洞察
- 研究摘要:探索的主题总结
- 可选择是否包含 Claude Code 对话历史
- 「分析模型」用于生成回顾和分析。只要它和「启用的模型」列表首位的默认模型不一致,选择器右侧就会出现还原图标,点击即还原为该默认模型(思考强度同时回到「自动」),与工作区默认模型等处的还原方式一致
- 可选择特定模型用于生成洞察;该入口复用标准模型选择器,模型名称旁会显示当前思考强度,也可从同一菜单调整。思考强度首次取全局默认值,之后作为洞察专用设置独立保存,不会反向修改全局「思考模式」
操作步骤:配置外部通知(IM 推送)
- 在 AI 洞察设置的「外部通知」区域
- 弹出已配置 IM 渠道列表(飞书 / 企微 / 自定义 Webhook,统一来源于设置 → 通知频道)
- 多选勾选要推送的渠道,或全不选表示不发送
- 洞察生成后会按选定渠道推送同一份摘要
搜索服务设置
配置 AI 对话中的关键词网络搜索能力。联网开关可独立控制网络访问;Claude、ChatGPT 订阅、OpenAI 官方 Responses 模型、Gemini API、智谱/Z.ai、Moonshot、百炼 DashScope、火山方舟 OpenAI 兼容通道等支持自带联网搜索的模型,开启联网后可直接使用模型侧搜索。Grok 订阅会通过独立 Web Search 工具获取资料,再由当前 Grok 主对话综合回答,并可使用 X Search 查询 X 账号、帖子、讨论串和实时话题。NewMax Gateway、DeepSeek、MiniMax Coding Plan、小米 MiMo 等国内通道可直接使用内置 WebSearch 进行关键词搜索。若搜索结果不稳定或当前模型仍无法搜索,请配置搜索服务提供关键词搜索。
操作步骤:配置搜索提供商
- 打开设置 → 点击左侧「连接」→ 顶部「搜索」
- 支持的搜索提供商:
提供商 说明 Tavily AI 优化搜索(推荐首选) Exa 语义搜索,适合学术内容 Brave Search 隐私友好的通用搜索 腾讯元宝搜索 独立网页搜索,使用腾讯元宝搜索专用 API Key,不限聊天模型 DeepSeek 搜索 独立网页搜索,使用 DeepSeek API Key,不限聊天模型 秘塔搜索 (Metaso) 中文 AI 搜索(无需翻墙) SerpAPI Google 搜索结果 API Serper 快速 Google 搜索 API Bing Search 微软必应搜索(国内可用) Google CSE Google 自定义搜索引擎(需额外配置搜索引擎 ID) Firecrawl 搜索 + 结构化网页抓取 - 找到想要的搜索提供商,打开右侧开关
- 填入 API Key;点击「获取 Key」可打开对应服务商的控制台或官方开通说明。腾讯元宝搜索会打开专用密钥说明:先在腾讯云开通元宝搜索,再创建该服务的 API Key;不要填写混元聊天密钥或 SecretId / SecretKey。配置与聊天模型独立,不会读取模型设置里的凭据,也不需要切换到混元模型
- DeepSeek 搜索使用 DeepSeek 官方 API Key,不会自动读取模型设置中的密钥;无需把当前聊天模型切换为 DeepSeek,也不需要额外的搜索引擎 ID。该服务由 DeepSeek 按搜索请求收费,请确认账号余额
- 可同时启用多个搜索提供商;拖动调整顺序,默认搜索会按此顺序调用,当前服务报错后自动尝试下一项
- 如需在单次对话中指定服务,直接在提问中写明已配置的服务名,例如「使用 Exa 搜索 AI 论文」。指定后本次只调用该服务,失败时不会自动切换;未配置或未启用的服务不能被指定
- 如需在单次对话中绕过全部外部服务,可写「请使用当前模型自带搜索」或「改用厂商原生搜索」。该指令只影响本次提问;当前模型不支持时会明确提示,不会自动回退外部服务。使用前仍需开启联网搜索
腾讯元宝搜索返回标题、链接与摘要,由腾讯云按账号套餐计费,请确认已开通且余额充足。单次最多限定一个域名、排除五个域名,超出会明确报错,不静默忽略限制或拆成多次请求。基础请求兼容极速版,不暴露套餐专属参数;未开通、欠费、鉴权失败、限流及异常响应按既有规则处理:自动模式尝试下一服务,明确指定元宝时不切换。正常空结果不视为故障。
DeepSeek 搜索每次请求 10 条结果,返回标题、链接和摘要,不调用网页抓取接口。搜索词连同站点限制最多 128 个 Unicode 字符,超过时会明确报错;自动模式按顺序尝试下一服务,明确指定 DeepSeek 时不会自动切换。密钥无效、余额不足、限流或接口故障同样遵循该回退规则;正常无结果不会被当作故障。
连接器与视频号搜索
NewMax Provider 提供按次计费的数据接口,覆盖社交媒体、视频、电商、搜索与 SEO、地图、企业信息、金融数据等一百多个平台。目录顶部有分类栏(全部、社交媒体、电商零售、搜索与 SEO……,每项带数量),点选即可只看该类,并可与搜索框叠加筛选;切到第三方 Provider 再切回时保留所选分类。使用前需要登录 NewMax 账号:游客模式下打开该页会提示「前往登录」,登录后目录自动加载。启用「微信视频号」后,AI 除了可以获取指定视频号的主页、作品和评论,也可以直接进行视频号全站关键词搜索,不需要另外启用「微信搜一搜」。
操作步骤:让 AI 全站搜索视频号
- 点击左侧导航栏「扩展」→ 第二栏「连接器」
- 切换到「NewMax Provider」
- 找到并启用「微信视频号」
- 回到对话,直接描述搜索要求,例如:「搜索视频号里与 GEO 相关的内容,优先最多点赞,整理近 30 天的 100 条结果」
- AI 会自动使用新版视频号全站搜索动作,并按需要通过游标继续翻页
- 如果要求的时间范围不是接口原生选项,AI 会在结果中按发布时间二次筛选
视频号全站搜索支持:
- 按关键词检索视频号视频
- 按相关性、最新或最热(点赞)排序
- 筛选最近一天、最近一周或最近半年
- 使用游标继续获取后续结果
指定某个创作者时,AI 还可以使用号内搜索,只检索该视频号发布的作品。旧版全站搜索动作已经停用,NewMax 会自动隐藏并阻止重复调用这些旧动作。
插件管理
打开「扩展 → 插件」可以查看 NewMax 从本机插件目录发现的 Claude Code 插件、包内 Skill 与 MCP 名称,刷新列表并统一启用或停用。卡片按名称简介、能力摘要与来源版本分层显示,点击整卡打开详情弹窗;含 MCP 的插件可在弹窗中点「查看连接」进入 MCP 页。开关与卡片主操作不会同时打开详情,支持键盘打开及 Esc 关闭。插件连接在该页标明来源,点「管理插件」会返回并定位对应卡片,不另设启停开关。手动配置的 MCP 仍单独管理,疑似重复只提示、不自动合并;详见 skills-mcp.md。页面按「推荐插件」「已安装插件」分类,点击顶部简短说明旁的「插件目录」可打开本机目录,悬浮查看路径;当前页面没有直接移除按钮。
「扩展 → 插件」顶部的「推荐插件」提供默认关闭的 Mole · 电脑体检。Mole 是 tw93 维护的第三方开源项目,NewMax 提供调用适配。启用并检测本机 Mole 后,可以从「开始体检」进入普通对话;缺少依赖时打开官方安装指引并自行安装。仅提供检测与历史查询,Windows 另支持清理预览,macOS 预览暂未开放;不会自动清理或安装。它与标准插件缓存独立,详情见 skills-mcp.md 的 Mole 章节。
首次运行环境配置
首次进入「准备运行环境」页面时:
- 点击「开始配置」,NewMax 会从当前安装包准备配套运行环境,完成后自动继续;不需要单独安装 Claude Code。
- 点击「检查内置环境」可重新验证内置组件,成功后显示实际路径并继续。
- 检测失败时,点击「修复内置环境」。聊天中遇到运行环境错误,也可点击错误卡片的「一键修复」,成功后重新发送消息。
- 修复不会删除对话、设置或凭据。若仍失败,请检查安全软件隔离记录,或重新安装完整的 NewMax 安装包;不要清空应用数据。
正式版只使用与当前应用配套的内置 CLI,升级和回退应用时成套切换。系统里的旧版、新版以及历史自定义路径都不参与选择;外部 Claude Code 可供其它工具继续使用,无需卸载。内置文件不可用时明确提示,不会悄悄改用外部版本。安装引导与普通设置页均不提供外部 Claude Code 路径输入;不要在「设置 → 连接 → 网络」寻找此入口。Windows 的 Git Bash 仍作为独立依赖按原流程准备。
网络与代理设置
操作步骤:配置网络代理
- 打开设置 → 点击左侧「连接」→ 顶部「网络」
- 开启代理开关
- 配置代理信息:
- 代理类型:HTTP 或 SOCKS5
- 代理地址和端口
- 认证信息(可选):用户名和密码
- 代理绕过列表:配置不走代理的域名。NewMax 自有服务以及无需代理的供应商域名会自动出现在白名单中;展开“已自动添加”列表后,可修改或删除其中任意一项。修改只影响代理路由,不会改动模型供应商的 Base URL
- 白名单对模型请求、内置浏览器网页抓取、搜索服务,以及对话中执行的终端命令同时生效;填写域名即可(如
mp.weixin.qq.com),粘贴完整网址也会自动收敛成域名
- 白名单对模型请求、内置浏览器网页抓取、搜索服务,以及对话中执行的终端命令同时生效;填写域名即可(如
添加海外平台(如 OpenAI / Anthropic)时,提示里直接给「应用内代理」选项和「网络设置」跳转,无需自己配系统代理也能联通。应用内代理也会用于默认 Claude 的本地配置检测、登录验证和模型查询;如果 NewMax 已从系统代理自动填入配置,点击「验证登录」时会直接复用该配置。
如果代理软件开启了 TUN,使用「规则模式」通常可以自动分流国内服务;「全局模式」仍可能代理自定义中转站。遇到自定义中转连接失败时,先把代理软件从「全局模式」切换为「规则模式」后重试,通常无需手动维护白名单。
内置浏览器如果明确检测到代理服务器无法连接,会停止本轮重复导航,并提示检查「设置 → 连接 → 网络」。此时应先启动代理软件、修正协议或端口;不需要代理的站点可以加入代理白名单,完全不需要代理时可关闭应用内代理,然后重新执行任务。
无法解析模型服务域名(DNS)
如果对话提示「无法解析模型服务域名(DNS)」,或错误详情包含 ENOTFOUND、EAI_AGAIN、ERR_NAME_NOT_RESOLVED,表示 NewMax 没能把模型服务域名解析为 IP。错误外层可能同时显示 502,这只是连接上游失败后的汇总错误,不表示供应商服务端真的返回了 HTTP 502。
- 确认设备可以正常访问其他网站,并尝试切换网络后重试。
- 如果使用 Clash、Surge 等代理,关闭时要同时退出系统代理 / TUN;不要只结束软件进程,避免留下无效的系统代理或 DNS 设置。
- 在系统网络设置中将 DNS 恢复为自动获取,或更换为可用的 DNS 后重试。
- 若其他模型正常、只有一个自定义供应商失败,再到「设置 → 模型」核对该供应商 Base URL 中的域名拼写。
- 网络和 DNS 恢复后直接重试;如果仍使用旧连接,完全退出并重新打开 NewMax。
开放网关设置
详见 models.md — 模型网关和 Claude 代理。
数据管理

操作步骤:导出对话数据
- 打开设置 → 点击左侧「数据」
- 找到「导出」区域
- 选择导出范围:全部数据 / 当前工作区
- 选择导出格式:JSON 或 Excel
- 点击导出按钮,选择保存位置
- 等待导出完成
操作步骤:导入对话数据
- 打开设置 → 点击左侧「数据」
- 找到「导入」区域
- 选择此前导出的 JSON 文件;这里不是恢复
.newmax-backup资料包 - 在冲突提示中选择「跳过已有」或「覆盖已有」,再等待导入结果
英文界面中,这一区域称为 Import and export,导出范围 All workspaces 只表示所有工作区,不是完整应用备份;导入入口是 Choose file,随后在 Import conflicts 中选择已有记录的处理方式。
操作步骤:设置自动备份
- 打开设置 → 点击左侧「数据」
- 找到「资料备份」区域,阅读包含范围
- 设置「备份目录」,不要选在计划资料或 Skill 文件夹内部
- 设置「备份频率」:手动、每天或每周;也可以点击「立即备份」
- 手动和自动备份均生成单个
.newmax-backup文件,常规备份保留最近三份;搬家时带走这个文件即可
备份包含数据库、对话正文与图片快照、长期计划实际资料、受管理的对话附件、NewMax 全局/工作区 Skill(含禁用项)和自动记忆。不包含工作区其它源码、外部附件、外部 Claude Skill 库、插件、浏览器身份、本地应用及下载模型;账号登录也不保证跨机器迁移。
工作区文件夹已删除或移走时,备份照常完成,并在「上次备份」下方列出被跳过的工作区;这些工作区的项目资料和附件不在包内。工作区若在移动硬盘上,请先接好再备份。受管目录里指向备份范围外的链接(包括已失效的链接)不会被跟随或备份,也会被列出,恢复后需要自行重新链接。
资料读取失败或复制期间仍在变化时,备份会报错,不会把缺失部分当成成功;失败原因显示在「上次备份」下方;若提示“有对话或任务正在运行”,说明备份期间资料被写入,请等对话输出结束后重试。「上次备份」的时间只记录最后一次成功的备份。数据库损坏时会跳过手动/自动备份,保护已有好备份;你仍可恢复此前的好备份,原损坏数据库和正文会隔离保留。
操作步骤:从资料备份恢复
- 结束正在执行的任务,打开「设置 → 数据 → 资料备份」
- 在「从备份文件恢复」点击「选择备份恢复」,也可从备份列表选择「恢复」
- 选择
.newmax-backup资料包或旧版.db;文件可位于任意目录,资料包可改文件名但应保留扩展名 - 阅读对应范围提示,确认后系统先保护当前资料、校验并暂存备份;失败不会覆盖现有数据库
- 应用重启,在服务加载前完成恢复;恢复途中发生错误会回滚,不能把「暂存成功」当作已经恢复
新版资料包的工作区文件恢复到应用数据目录下的独立 restored-workspaces 文件夹,并同步迁移受管附件和记忆路径,不覆盖原工作区。外部源码/仓库和其它外部目录需要另行迁移并核对绑定。全局 Skill 只补缺失项,同名内容冲突时会停止,避免覆盖其它副本正在使用的 Skill。
旧 .db 不代表完整资料。 请把同名 WAL、SHM、-conversations 配套内容一并保留,不要只改 .db 名称。没有配套资料或此前漏掉 WAL 的损失无法由数据库校验补回来;确认恢复只表示接受可读取部分。旧工作区路径仍需在「编辑工作区」中调整。
未设置备份目录时,恢复前保护包放在应用数据目录的 backups 中。替换前的原数据库和正文另保留于其中的 restore-previous-* 文件夹,不参与普通三份备份轮转。只恢复你信任的备份,并按私密文件保管备份包。
操作步骤:修复损坏的对话数据库
NewMax 每次启动都会检查本地数据库的完整性。检测到损坏后,主界面顶部会出现红色提示「本地对话数据库已损坏」,新消息会临时保存到对话文件镜像里并在打开对话时自动合并,不会丢失,但需要尽快重建数据库。
- 点击提示上的「去修复」,或打开「设置 → 数据」,找到页面顶部的「修复对话库」区域
- 点击「重建数据库」,NewMax 只读取当前数据库和对话文件镜像来生成一个新库;数据库较大时可能需要几分钟,期间不要退出应用
- 查看重建报告:会显示整理的对话数和消息数,以及在旧库里读不出来、只保留了文件镜像内容的对话;如果报告提示校验未通过,不能应用,可以点「重新重建」再试或联系支持
- 点击「应用并重启」,NewMax 会把旧数据库移到应用数据目录下的
backups文件夹保留,替换为新库并自动重启 - 重启后顶部的损坏提示消失,即修复完成
操作步骤:清理存储空间
- 打开设置 → 点击左侧「数据」
- 在「存储管理」区域查看数据库大小、对话文件大小、对话数量和消息数量
- 如需回收冗余对话文件空间,点击「优化存储」旁的「优化」按钮;这只压缩重复快照,不删除对话
- 如需清理工作区中遗留的空对话附件目录,点击「清理空附件目录」旁的「清理」按钮;系统会同时检查当前使用的隐藏目录
.newmax/conversations和旧版目录conversations,只删除空目录,不删除对话记录或附件文件 - 如需删除旧对话,选择清理范围:1 个月前 / 3 个月前 / 6 个月前 / 1 年前
- 点击「清理」并在确认弹窗中确认后,删除对应时间范围内的旧对话和消息
英文界面在 Settings → Data → Delete older chats 选择时间范围,点击 Delete 后,在 Delete older chats? 弹窗点击 Delete chats 才执行永久删除;删除全部对话则在 Delete all chats? 中再次点击 Delete all chats。这不是无损的存储优化,建议先备份。存储统计中的 Chat files 是文件大小,Chats 是对话数量。
英文备份动作是 Back up now;从备份恢复时,确认按钮为 Restore and restart,会替换资料并重启。当前数据库健康时先备份,损坏时不生成新备份,而是另行保留原数据库和正文。Delete local app data 下的 Delete and quit 会永久删除弹窗列出的本机资料并退出,不等同于删除聊天记录或仅重置设置。
操作步骤:清空本机数据
- 打开设置 → 点击左侧「数据」
- 滚动到页面底部的「清空本机数据」区域
- 点击「删除并退出」
- 在确认弹窗中查看将删除的本机数据范围
- 应用数据目录:对话、设置、备份索引、本地模型、日志
~/.newmax:Skill、插件、设备 ID~/.niumaai与~/.flowagent:旧版残留数据
- 勾选确认后点击「确认删除并退出」
「清空本机数据」等同卸载重装,会删除设置和本机 Skill/插件;如果只是恢复模型、API Key、快捷键等设置,请在设置 → 通用 → 应用底部使用「恢复默认设置」。
数据安全说明
- 所有对话数据存储在本地 SQLite 数据库
- 不上传用户对话内容到服务器
- 支持完全离线使用(配合本地模型)
语音识别设置
操作步骤:下载和配置语音识别模型
- 打开设置 → 点击左侧「模型」→ 顶部「语音识别」
- 页面显示可用的语音识别模型
- 如果模型未下载,点击「下载」按钮
- 等待模型下载完成(模型在本地运行,保障隐私)
- 下载完成后自动启用
- 可查看语音识别历史记录
Windows 本地语音模型使用 .newmax 目录:通常位于 %USERPROFILE%\.newmax\models\sensevoice-small;用户名包含中文等非 ASCII 字符时,改用 %ProgramData%\.newmax\models\sensevoice-small。升级后启动应用会尝试迁移旧 .niumaai 及早期应用数据目录中的完整模型,成功后无需重新下载。若迁移失败,会保留旧模型;不要手动删除旧目录,先确认设置中的模型状态。新目录已有可用模型时不会覆盖,也不会自动删除旧副本。macOS / Linux 的模型存储位置不变。
账户

国际版点击 Settings → Account 后直接显示账户信息,无需再点击 Overview;国际版不提供组织入口。国内版保留账户概览与组织的顶部切换。
操作步骤:查看账户信息
- 打开设置 → 点击左侧「账户」→ 顶部「账号」
- 显示当前用户信息:头像、昵称、邮箱、手机号、用户名
操作步骤:修改头像和昵称
- 打开设置 → 点击左侧「账户」→ 顶部「账号」
- 修改头像:点击头像,选择本地图片(支持 JPG / PNG / GIF / WebP),上传完成后自动生效
- 修改昵称:点击昵称右侧的「修改」,输入新昵称后点「保存」
能不能修改登录邮箱、手机号或用户名?
账号页的邮箱、手机号、用户名是只读展示,应用内没有自助修改入口。需要更换时,请到设置 →「帮助与反馈」提交一条反馈,写明要换成哪个地址,由官方在后台协助更换。
- 更换后用新邮箱 + 原密码登录,密码不需要重设;
- N币余额、订单记录、已安装的 Skill、订阅和激活码都跟随账号,不会丢失;
- 新地址不能是站内已经注册过的账号(邮箱、手机号在平台内唯一);
- 客户端如果处于登录状态,更换完成后请退出重新登录一次。
操作步骤:退出登录
- 打开设置 → 点击左侧「账户」→ 顶部「账号」
- 点击「退出登录」按钮
- 退出后进入游客模式
游客模式说明
- 无需登录即可使用大部分功能
- 以下功能受限:
- 不可查看反馈历史
- 不可发布技能到 Skill 市场
组织与企业套餐
操作步骤:购买、续费或升级企业套餐
- 打开设置 → 点击左侧「账户」→ 顶部「组织」
- 尚未加入团队时,点击页面中的「购买套餐」;已有团队时,可在对应团队的操作区进入购买或续费
- NewMax 会在系统浏览器打开企业购买页,并交接当前账号的登录状态
- 尚未创建团队时,先填写企业名称创建团队
- 已有团队时,选择要购买、续费或升级的企业
- 选择企业基础版或企业专业版,按页面提示完成付款
「购买套餐」进入公开企业购买页,不要求预先存在团队;组织管理后台中的订阅页只用于已有团队的套餐管理。
关于
操作步骤:查看版本信息
- 打开设置 → 点击左侧「关于」
- 页面顶部显示当前应用版本号,点击「访问官网」可在系统浏览器中打开官网
- 更新卡片中可切换「自动检查更新」或点击「检查更新」;卡片下方可「查看更新日志」或「打开日志目录」
- 检测到新版本时,页面仅显示新版提示和可用的下载按钮;具体更新内容请点击「查看更新日志」
- 更新日志弹窗底部点击右侧主按钮「官网下载」,可在系统浏览器打开官网获取安装包;日志不会自动关闭,可继续阅读,或点击左侧「知道了」关闭
Windows 覆盖安装与安装失败处理
- 升级前保存工作并结束正在执行的任务,直接运行新版安装包即可,通常不需要先手动卸载旧版。关闭窗口可能只会收起到托盘;需要手动退出时,在右下角托盘右键 NewMax,选择「退出」。
- 安装器会先检查空间并准备新安装包。系统临时盘(通常是 C 盘)空间不足时,会自动尝试使用安装盘的临时空间,无需手动修改系统环境变量;请确保安装盘有足够空间同时容纳临时文件和程序,系统盘仍需留有启动安装器的少量空间。新包准备完成后,再尝试退出旧版并清理残留程序;如果出现 Windows 管理员授权提示,请确认是刚运行的 NewMax 安装器所触发,再允许授权。覆盖升级会保留对话和设置。
- 若提示无法准备安装目录或替换程序文件,请根据提示检查目录权限、磁盘剩余空间和安全软件的拦截记录,处理后点击「重试」。不需要关闭安全软件;若文件持续被占用,可重启 Windows,在不启动 NewMax 的情况下重新安装。
- 如果提示无法准备新安装包,请提供弹窗中的失败阶段、Windows 错误码,以及列出的日志(如已保存)。日志优先保存在安装目录旁,无法写入时会尝试系统临时目录或安装目录内;日志只记录安装诊断信息,并限制大小;如存在同名
.previous文件,可一并提供。若找不到日志,提供完整弹窗截图即可。其他安装失败可按Win + R输入%TEMP%,将其中的newmax-install.log和newmax-kill-elevated.log(如存在)提供给技术支持。若手动卸载后重装并希望保留数据,请不要勾选删除用户数据。
如果旧版卸载中途被打断(例如卸载超时)或旧卸载程序已丢失,重新运行安装包即可:安装器会把原安装目录里剩下的文件整体移到旁边的 .newmax-backup-* 文件夹,再安装新版;选择其他目录安装时,原目录保持不动。确认新版运行正常前请保留备份。
如果仍提示「无法替换旧版本」,按弹窗中的「处理方法」操作:退出 NewMax,把提示里的旧安装文件夹改名(例如改成 newmax.old,可能需要管理员权限),再重新运行安装包。对话和设置不在安装文件夹里,不受影响;新版运行正常后可删除改名后的文件夹。
如果提示程序清理超时,安装会停止。请重启 Windows 后,在不启动 NewMax 的情况下重新运行安装包。若提示无法恢复旧安装,请保留提示中的备份目录,按提示检查目录权限后恢复到原安装位置;不要删除备份。
若清理超时提示同时列出旧安装备份和未完成的安装目录,表示尚未自动恢复。请保留这两个目录,重启 Windows 后再重新安装或恢复备份;备份位置也会记录在安装日志中。
卸载为所有用户安装的 Windows 版本时,也可能出现管理员授权提示;允许授权后才会检查并清理仍在运行的程序。
启动时显示「应用启动超时」或「应用加载失败」
NewMax 主窗口本次加载如果在清醒运行的 30 秒保护期内仍未就绪,会显示「应用启动超时」页面;这也可能发生在重新加载时,不只发生在首次启动。页面上直接列出当前的「安装位置」和错误代码(-324 - LOAD_TIMEOUT),并提供「重新加载」「打开日志目录」「退出应用」三个按钮。
电脑休眠期间暂停加载超时和健康检查,正常唤醒后再给未完成的加载一个新的保护期,不主动刷新已经正常显示的页面。主界面已经挂载时,不会仅因断网导致图片等非关键资源未完成而显示超时页。如果使用旧版本,或恢复网络后仍停在错误页,先点「重新加载」一次;无需删除历史或关闭休眠功能。
- 超时只表示主界面尚未就绪,不能据此确定是安装位置、安全软件或数据库损坏。先点击「重新加载」一次;每次重试都有独立超时保护,不需要反复点击。
- 仍无法启动时,点击「打开日志目录」,把
main.log和完整页面截图提供给技术支持。日志会记录窗口加载状态,以及数据库初始化各阶段的耗时;目录默认在~/.newmax/logs,Windows 为%USERPROFILE%\.newmax\logs。 - 「应用加载失败」同样要结合具体错误码和日志判断,不代表一定缺文件。没有明确诊断前,不要删除
.newmax、清空聊天记录、重建数据库、关闭安全软件或反复换目录重装。 - 新版将启动时的数据库检查和恢复放到后台工作线程,避免慢操作阻塞窗口子进程;大数据库或慢磁盘仍可能需要等待,不代表历史已丢失。如果技术支持已针对旧版提供临时启动参数,先沿用已验证的方式,安装确认包含修复的版本后再验证普通启动。
设置里的「优化存储」整理的是对话文件的重复快照,不是数据库修复;「清理旧对话」会删除历史记录,不能把它当作通用的白屏修复步骤。