本地应用

开始开发

1. 选择一个工作区，点击 NewMax 左侧功能导航中的「本地应用」，进入应用首页。
2. 在顶部「想做一个什么应用？」输入框里描述想做什么、给谁用、希望怎样操作。不知道从哪开始时，可以点输入框下方「试试这些」里的示例（记账本、番茄钟、习惯打卡等），它会把一段完整的需求填进输入框，改成自己想要的样子再发送；点示例本身不会创建应用。这个输入框和普通对话的输入框一样，可以在右下角先选好模型和思考强度；模型支持调节时，可点击模型旁的当前档位，或在模型菜单底部的「思考强度」子菜单中选择。按 Enter 或点击右下角的发送按钮（Shift+Enter 换行），这时才会创建新应用，用选好的模型和思考强度进入它的开发对话并自动发送这段描述。
3. 像普通对话一样选择模型、附加图片或文件、查看回复和实际工具执行过程。开发对话和普通对话使用同一套背景主题，设置了图片或视频背景时也会显示在这里。可以先讨论需求，也可以明确提出实现要求；可以停止当前执行，再继续补充要求。
4. AI 写出一个可运行版本后，会检查应用入口并打开独立窗口进行预览，然后查看真实界面截图、操作关键流程并记录验收结果；只打开窗口不会认定开发完成。也可随时从左侧应用组右侧的「打开应用」图标打开。
5. 继续在同一段对话里提出修改要求；AI 修改后刷新应用窗口。已有应用的数据保存在本地。

左侧「本地应用」管理侧栏在首页和开发页都会保留，「我的应用」按应用最近更新时间排列。每个应用的名称前显示图标，对话组默认收起，点击名称或按 Enter/空格可展开、收起；展开后点击具体对话进入编辑，当前对话高亮。组内按对话更新时间排列，先显示五条，可点「加载更多」查看其他历史。展开、收起不会创建对话，也不会清除未读。

鼠标移入应用分组头或用键盘聚焦后，右侧显示「新对话」「打开应用」和「⋯」：点击「新对话」进入这个应用的独立空白对话，不复制应用，原有历史仍保留。和普通对话一样，仅点击新建或输入未发送的草稿不会在左侧增加一行；发送第一条消息后才显示，无需等待模型回复。各段对话共享应用源码和运行数据，修改同一文件时建议顺序进行。「打开应用」运行独立窗口，「⋯」用于设置、收藏、桌面入口和删除等管理操作，不会顺带切换开发对话。没有已开始的历史时组内显示「暂无对话」，可从组头新建。历史读取失败会提示并提供「重试」，不会冒充空历史。草稿或检查未通过的应用不能运行，仍可进入已有对话或新建对话修复。

展开应用后，把鼠标移到某段对话上，点击右侧「⋯」（也可右键该对话）可重命名、复制对话、复制深度链接、置顶/取消置顶或删除。重命名按 Enter 保存、Esc 取消；复制出的对话仍属于这个应用，共享应用源码，但拥有独立聊天历史。置顶只调整该应用组内顺序，不收藏整个应用。对话行圆角与普通对话一致，打开「⋯」后整行保持悬浮反馈。AI 自动更新标题时，旧标题淡出、新标题逐字出现，并短暂高亮该行，与普通对话一致；开启减少动画时直接显示新标题。手动重命名沿用普通对话的直接更新方式。删除沿用原位二次确认：先点「删除对话」，再点红色「确认删除」，确认后菜单立即关闭并执行删除；按 Esc 或点击菜单外关闭会取消确认，运行中的对话不能删除。删除只移除这一段对话，不删除应用、数据或其它历史；删除当前对话后回到应用首页。再次选择原有历史不会把已删除的条目显示成「新对话」；尚未发送任何消息的空对话不会列出，但不会因此删除底层记录。旧通知或入口指向已删除的对话时，会提示重新选择，不自动重建空记录。没有普通对话的移出分组或归档入口，避免丢失应用归属。新建对话或从搜索/通知进入具体对话时，所在应用会自动展开。

常用应用可在「⋯」菜单中选择「收藏」，也可按住「我的应用」中分组头的图标或名称，拖到上方「收藏」区域后松开；「收藏」区域在已有收藏时才出现，第一个应用请用「⋯」菜单收藏。拖动时被拖的图标或卡片保持原样、不移位。将上方收藏图标拖回下方「我的应用」区域即可取消收藏；拖到其他区域或按 Esc 取消拖动不会改变收藏状态。拖动时跟随鼠标的就是原来的图标或卡片本身，移入目标区域后显示高亮底色，不额外插入提示行或虚线框；草稿也支持拖拽收藏。收藏只在侧栏上方的「收藏」区增加紧凑排列的大图标快捷方式，应用仍保留在下方「我的应用」完整列表中，数量与排序不变；点击快捷图标直接打开应用独立窗口。悬停或键盘聚焦图标时显示独立操作卡片，展示应用名称、状态提示，以及底部等宽排列的「打开应用」「编辑应用」「应用设置」「取消收藏」图标按钮；鼠标可移入卡片操作，按钮不会遮挡图标，也不会挤动相邻快捷方式。键盘可用 Tab 或向下键进入卡片操作区，按 Esc 关闭；其他管理操作仍在下方完整列表的「⋯」菜单中。取消收藏只移除快捷方式，不会删除应用。收藏顺序会保存，跨工作区共享；草稿和需要检查的应用暂不能点击运行，仍可通过悬停卡片的「编辑应用」继续完善。

点击管理侧栏标题下方的「＋ 新应用」回到创建首页，只有提交需求才会创建新应用。侧栏沿用其他页面的拖宽、收起和展开操作；窄窗口中以浮层显示，选中应用后收起，正在查看的开发对话不会因此重建。右侧不再重复显示应用标题栏，也不保留空白占位；打开应用和应用设置从左侧应用组操作，源码工作台开关仍在窗口右上角。侧栏收起时，先展开侧栏即可管理应用。

编辑页不在标题旁重复放返回按钮，使用窗口左上角的返回/前进箭头按实际访问顺序切换；点击窄导航栏「本地应用」入口始终回到应用首页。应用及其开发对话跨工作区共享：从任何工作区选择历史对话都会恢复原会话，不切换工作区，也不因工作区不同新建空对话。收藏悬停卡片中的「编辑应用」仍优先恢复最近有内容的一段，原历史保留；需要独立会话时点击应用组头的「新对话」。在编辑页切换工作区不会清掉正在查看的对话。

只点击功能导航中的「本地应用」不会创建应用。应用开发对话会保存，但不会混入普通「最近对话」，可展开管理侧栏「我的应用」中的应用组，点击具体历史进入。用侧栏「搜索」找到开发对话，或点击对应通知，会打开那一段对话，不会改选同应用的另一段历史。切换对话不会停止正在执行的生成：应用组头和对应对话右侧显示运行指示，不覆盖应用图标；左侧主导航的「本地应用」入口只保留未读结果提示。离开时完成，应用组和对应对话显示未读圆点；进入具体对话才清除它的未读，其他对话的未读不受影响。开发状态跨工作区显示。若执行在等待授权或回答，需回到该对话处理。

应用级操作统一在左侧应用组：悬浮或键盘聚焦组头后可点击「打开应用」，或在「⋯」菜单中使用应用设置、收藏/取消收藏、分享到 GitHub、生成/删除桌面入口、打开源码目录和删除应用；用到手机照片的应用还会显示「接收手机照片」。「查看源码」保留在窗口顶栏右上角，与普通对话的右侧工作台开关位置一致。对话行自己的「⋯」只管理这一段对话，不与应用操作混用。不可运行的应用也可以展开应用组并选择具体对话修复。

随应用启动本机后台

已接入后台自动启动的本地应用，点击「打开应用」、桌面入口或开发预览时，NewMax 会先检查后台：已经健康运行则直接复用，尚未运行才启动，确认就绪后再加载界面。普通列表、设置和能力查询不会启动后台。

首次会弹出「允许应用运行本机后台？」：核对程序、参数、应用及数据目录，只对信任的应用选择「信任并允许自动启动」。后台以你的系统账号运行，可读取文件和访问网络，不受应用网页沙箱限制。批准在本机保存，启动配置或入口变更后重新核对；分享不会把批准或外部运行环境传给接收者。

缺少Python等运行环境、程序退出、启动超时或旧进程仍在但无法连接时，会提示具体原因及日志目录，不自动安装软件或反复启动。可把提示交给该应用的开发对话修复。旧应用需要先由开发助手接入启动和健康检查，单纯存在一个后台文件并不会被自动执行；旧版NewMax需更新并重启后才能使用。

关闭应用窗口不会自动停止后台，后台仍遵循你已启用的调度。要停止或删除应用，先使用该应用提供的停止后台操作；服务还在使用数据时，NewMax 会阻止删除。自动启动机制本身不创建采集或收费任务，也不会设置电脑开机自启。

界面设计与验收

开发界面时使用 NewMax 自带的应用设计规范，覆盖布局、文字层级、配色、交互状态和界面验收，无需安装 frontend-design 或其他设计 Skill，也不受 Skill 启停和工作区选装影响。AI 会先确定适合这个应用的设计方向，再实现界面；已有品牌和你明确提出的要求优先，不会强制套用 NewMax 的界面外观。内置资料读取失败时会明确提示，不会假装已加载或擅自安装 Skill 替代。

预览只是可运行版本。AI 还需要查看应用真实截图、操作关键流程，并为约定的每条验收标准记录实际结果；改过代码后需要重新检查。不能执行或尚未验证的内容会明确保留为待验收，不应被描述为完成。应用状态「可运行」仅代表入口通过检查，不代表所有功能已验收。

可以继续在开发对话中提出具体要求，例如「把空看板做成有引导的状态，重新检查添加、编辑、拖动和重开后数据保留」。视觉效果仍受所选模型能力影响；不能理解截图的模型无法独立完成视觉审查。

端到端测试支持使用付费模型、图片/音视频生成、搜索和连接器。在开发对话里说明要验证的付费流程，可同时约定预算或调用次数，例如「测试一次 X 采集，使用真实付费接口，只启动一个任务并检查完成结果」。AI 会在已授权范围内执行并记录真实结果，不为每个步骤反复询问；需要超出范围或约定限额时再确认。应用权限、登录和宿主弹出的执行确认仍照常处理。测试优先创建独立记录，保留已有数据；长任务启动后分次检查进度，脚本超时不代表远端取消，失败或超时不会自动重复提交收费请求。

查看源码

在开发对话的窗口顶栏右上角点击「查看源码」，对话右侧会展开和普通对话一样的右侧工作台，根目录就是这个应用的源码：可以浏览文件、打开预览，「对话文件」里列出这段开发对话改过的文件。再点一次（按钮变为「收起源码」）或点工作台上的关闭按钮即可收起；每个应用会记住上次是否展开。

开发对话里点击回复中的文件、变动文件卡片或「Review」，也会在这个工作台里打开。在文件上右键选「添加到对话」或「在对话中引用」，会放进当前应用的开发对话输入框。这里的根目录是应用源码而不是工作区，所以没有「更换工作区目录」和「在终端打开」。

需要在访达（Windows 为资源管理器）里查看时，在「⋯」菜单点「打开源码目录」，或在工作台文件上右键选「打开所在目录」。

模型和数据

• 创建前和开发对话中都使用普通对话的模型选择器，可选择 NewMax 已配置的提供商、模型及该模型支持的思考强度。未手选时优先使用工作区默认，再使用全局默认；首页手选只用于新建的开发对话，不修改默认设置或已有应用的对话。
• 应用中的 AI 请求默认跟随 NewMax 当前默认模型，也可由应用提供模型选择。视觉输入需要所选模型支持。
• 应用不需要再保存模型密钥。应用数据与源码分开保存在本机，修改界面不需要重建数据。
• 运行中的应用还可调用图片生成、参考图生图、语音合成、语音识别和文生视频，沿用 NewMax 设置里的模型与默认提供商，包括已配置的 NewMax Provider。语音识别可使用已安装的本地模型。没有配置或未安装时会提示不可用，不会自动购买或下载模型。
• 新应用默认允许媒体调用；已有应用可在「⋯」菜单的「应用设置」中开启「允许使用 NewMax 媒体模型」。这只是开放调用能力，不会自动为应用添加录音、朗读或生图按钮；可在开发对话里要求接入，例如「给读书记录添加朗读，用 NewMax 当前的语音模型」。
• 云端调用会发送内容到对应服务商，并可能消耗额度。图片、音频、视频生成后保存在该应用的本地数据目录。生成过程中请等待结果，失败或超时不要连续重复提交，远端任务可能已计费；关闭应用窗口不保证取消远端任务。

宿主能力与依赖检查

激活安装完成后会自动显示「宿主能力与依赖检查」。也可从左侧应用组的「⋯ → 应用设置」查看，点「重新检查」读取当前配置。检查不会调用收费服务、自动授权或下载软件；缺少依赖时应用仍保留，不需要反复安装。

• 已配置：找到了当前默认配置，不代表余额、远端授权、网络和具体模型特性均已验证。
• 需要选择模型或默认项 / 尚未配置：按提示到设置中的模型、图像生成、语音生成、语音识别、视频生成或搜索配置补齐。
• 缺少应用权限：核对应用设置里的相关开关，保存后重新打开检查；没有开关的权限可在开发对话中按实际需求补充，不会自动放开权限。
• 当前未开放：生成应用没有相应运行接口。本地连接器、任意 MCP 和完整 Agent 目前仍不能直接调用；NewMax Provider 托管连接器已有独立接口，使用方式见下文。开发助手能使用其它工具，不代表应用运行时也能直接调用。
• 尚无法确认 / 无法检查：不能当作就绪。订阅和原生 Claude 的登录需到模型设置确认；检查接口不可用时可重试或更新并重启 NewMax。

旧应用可能提示「未声明依赖」：这是信息不完整，不代表全部可用或一定无法运行。可向开发助手说「先检查可用宿主能力，补充这个应用实际需要的依赖声明，再检查缺失配置」。新开发提示会指导 AI 先核对能力目录、优先复用已配置的 NewMax Provider 等宿主渠道，不能编造未开放接口。

检查只覆盖应用声明的宿主能力和当前默认配置，不扫描源码猜测依赖，也不检查外部软件或固定模型特性。允许媒体调用不等于必须配置全部四类媒体服务。分享不会把发布者的账号、密钥、连接器和外部运行环境一起迁移给接收者。

调用 NewMax Provider 连接器

这里指「扩展 → 连接器 → NewMax Provider」中的抖音、视频号、TikTok 等托管 API，不是聊天模型网关。已接入的本地应用可以直接查询平台动作、读取参数说明，并调用实际接口，不需要让模型猜测结果。

1. 使用自己的 NewMax 账号登录，在「扩展 → 连接器 → NewMax Provider」启用所需平台。
2. 在本地应用的「⋯ → 应用设置」核对并开启「允许调用 NewMax Provider 连接器」，保存。新应用默认关闭；分享安装时应核对应用声明的权限。
3. 开关只允许调用，不会自动生成业务界面。可在应用开发对话中要求：「用 NewMax Provider 的视频号搜索接口，给这个应用做关键词查询和结果列表。先查真实动作和参数，不要用模型编造搜索结果。」AI 的开发说明已包含目录查询和运行接口。
4. 在应用里选择动作或填写业务参数，再点击应用提供的执行按钮。NewMax 会弹出宿主确认，展示应用、平台、动作、参数和目录预计 N币；核对后点「确认并执行」，取消不会提交。
5. 应用接收真实接口结果和服务端实报费用。目录价格是估算，不是消费封顶；动作还可能改变外部数据，每次都需确认，包括标为免费或 GET 的动作。

查询动作目录不执行收费操作。执行失败、超时或窗口关闭不保证远端没有扣费/生效；不要连续重试，先核实结果。余额不足需处理余额；提示权限不足时核对应用开关，平台未启用时到连接器页启用，账号变更时重新确认操作。当前每应用一次在途调用，每分钟最多60次目录/执行尝试，每小时最多30个进入确认的执行意图（取消也计入），没有后台自动重试。

应用不会拿到钱包 session 或宿主凭据。分享后，接收者使用自己的登录和平台配置，每次操作仍需确认；发布者的授权和余额不会跟着分享包转移。当前仅开放托管 NewMax Provider，不开放本地连接器、任意 MCP 或完整 Agent。旧应用需由开发助手接入新接口；旧版宿主需更新并重启，单独刷新应用不能启用新主进程功能。

发现网络来源

支持此功能的本地应用可以直接搜索网站来源并由 AI 评估相关性，不需要跳回开发对话。先在左侧应用组的「⋯ → 应用设置」中开启「发现网络来源」并保存；此权限默认关闭，开启不会自动为应用添加搜索界面，可在开发对话中明确要求接入。

在应用中填写需求、检查搜索服务和模型后，明确点击发现按钮才会开始。自动模式优先使用当前所选模型已接入的原生搜索；模型没有可用原生通道时，按 NewMax 全局搜索服务顺序选择已启用且凭据完整的服务，不另建一套配置，也不更换当前模型。原生通道包括 ChatGPT 订阅、使用 Responses 的 OpenAI 和 Grok 订阅；使用 NewMax Gateway 的任意模型时，没有配置搜索服务也可以用 NewMax 搜索（按次计费，记入钱包消耗明细的「联网搜索」），已配置搜索服务时优先用你的服务。具体可选组合由运行中的宿主返回。也可明确选择“内置搜索”跳过独立搜索服务。未接入的模型通道、失效的显式选择或调用失败会明确提示，不会悄悄换服务商或用模型猜测的网址充当搜索结果。查询会发送给选中的搜索服务或模型，搜索证据与需求会发送给模型评估，均可能产生费用。

支持多轮的应用可设置1–30轮搜索上限，一次确认启动整批任务，每轮更换检索方向并累计去重。新版宿主同一批次最多同时执行3轮，不增加总轮数；旧宿主仍可能逐轮执行。轮数是搜索请求及必要评估的轮次，不是保证找到的网站数，也不等于供应商内部搜索工具次数；30轮可能产生多次搜索费用和最多60次模型请求。达到上限自动停止，任一轮失败后不再启动新轮，也不自动重试。可查看实际进度并点击「停止后续搜索」；已提交的最多3轮（含必要评估）仍可能执行和计费，宿主会等待它们结束，再交付正常完成的结果，不会假装远端已经取消。结果按原定轮次排序；失败轮次输出只供查看，不混作成功候选，停止后发生的在途失败也会保留说明。撤销权限后不再交付该批结果；不会自动续跑中断任务。旧宿主缺少多轮或并发能力时需加载新版并重启，不能靠刷新界面启用。

返回的是本次真实搜索得到的候选及证据链接，不会自动添加来源。请核对网页内容、来源可信度与订阅地址后，再在应用中确认。没有匹配结果不是调用失败；若失败或超过预算，请查看提示，不要连续重复点击。每个应用同一时间只允许一项发现任务，每小时最多 12 次；关闭窗口不保证取消已提交的远端计费请求。旧版 NewMax 不支持时需先更新宿主，再使用该能力。

应用若提供「NewMax 全局搜索配置」入口，可以查看完整搜索服务目录（包含未启用项），配置启停、凭证和优先级。填写后点击保存，NewMax 会单独确认这次修改影响所有后续使用该服务的对话和应用；确认后同步到「设置 → 搜索服务」，不修改默认聊天模型。已有密钥只显示配置状态，留空保留，明确勾选清除才删除。若提示其它窗口已修改，刷新后再编辑，避免覆盖新设置。策略自身的搜索/模型选择与全局服务配置是两个作用域。

若发现失败，应用可展示 HTTP 状态、公开错误码/参数和本机诊断编号，不展示密钥或原始上游错误正文。请保留诊断编号供排查，不要把“HTTP 400”直接当作余额或账号问题；也不要连续重复请求。

若提示“搜索已有结果，但模型评估输出……”或 invalid_response，失败的是把搜索结果整理为候选的步骤，不表示搜索没有结果或模型不支持联网。提示会区分 JSON 格式、候选列表结构、证据编号与理由校验，并附任务编号。应用可保留已取得的搜索证据供查看，但失败候选不能直接添加；系统不会自动重试收费请求。正常的空候选不算格式错误，也不能据此认定没有相关网站。新版接口同时提供检索结论、逐条评估理由和搜索阶段回答；模型未说明原因时会明确标注“未提供”，不会代编理由。支持相应界面的应用会展示原始结果，允许将正常完成的真实证据加入“人工待审核”，与 Agent 推荐区分，仍需勾选确认才添加。截断或失败保留部分输出及状态，但不开放失败候选的添加。旧记录中从未保存的回答无法事后恢复；刷新应用不会补做收费搜索，宿主接口更新需重启后生效。

搜索结果保留服务实际返回的标题和描述，直接交给模型评估，不再强制先逐页读取公开网页。缺失字段不会编造，也不把搜索摘要称为完整正文。需要补全时，可使用应用提供的独立补全操作；这与判断网站是否为持续更新入口的核验是两回事。补全会在安全限制内跟随网站重定向或页面刷新跳转，支持的应用显示最终地址并保留原搜索链接。不执行网页脚本、不自动登录或绕过验证；循环跳转、访问失败、超时等逐条保留原因。

支持该界面的应用可在已保存结果中提供「补全标题与描述（不调用模型）」：点击后只访问原有网页，不重新搜索、不调用模型，也不重新评估或自动添加候选。每批最多30条，独立补全每小时最多12次。网页可能已变化，补全显示的是此次读取内容，不是历史快照。旧宿主不支持时需要加载新版并重启；仅刷新面板不能升级接口。

AI 公告采集

已接入此功能的应用可以按你的需求规划搜索并提取公告字段，不只是寻找网站入口。先在「⋯ → 应用设置」开启「发现网络来源」并保存，再在应用中填写关键词、地区、日期、排除条件和需要的字段，检查模型及1–30轮搜索上限，明确点击采集按钮。开启权限不会自动添加界面；没有入口时可在开发对话中要求接入。这个模式复用 NewMax 已配置的搜索和模型，不另存密钥、不修改全局配置。

AI 会先生成本次查询计划，再以最多3轮并发执行搜索和字段提取，进度中逐步累积已完成且通过材料引用检查的结果。当前模型支持原生搜索时优先使用，否则按全局顺序选择已就绪的搜索服务；失败不会自动更换模型、服务或重试。除搜索/提取外，规划本身也会调用模型；30轮最多涉及61次模型请求（原生搜索模式），或31次模型请求加30次外部搜索，实际次数可能更少，均可能计费。轮数不是保证找到的公告数量。

每批最多保留300条去重公告，字段有对应材料引用。搜索摘要不是完整正文；来自模型搜索回答的材料会明确标为未核验并保持待审核，即使其中已提取出字段。材料不足时只保留真实搜索链接和标题，不凭空补齐预算、日期或联系方式。默认按采购机会排除中标、成交、合同等公告，相关性仍需复核。宿主不自动保存公告，应用是否入库以及入库前的复核由该应用负责。

点击停止会阻止新的搜索和提取，但已提交请求仍可能计费；已提交的提取等完成后保留已验证结果。失败也会停止后续派发，部分完成或停止不代表整批成功；搜索真正零结果与提取格式/引用失败会分别报告。每个应用同一时间只有一项采集任务，每小时最多12次；关闭窗口不保证撤销远端费用。撤销权限后宿主清空本批可交付结果，不能收回应用此前已保存的副本。中断任务不会自动恢复，旧宿主需要更新加载新能力，不能仅刷新应用来启用。

名称和图标

在左侧应用组的「⋯」菜单中选择「应用设置」。修改「产品名称」，在「应用图标」下选一个图案、在「配色」里选一组颜色（左上角会预览效果），或点击「上传图片」选择 PNG、JPEG、WebP 图片（不超过 5 MB、1600 万像素），然后保存。图案列表前面是常用图案，往下滚动会继续加载更多，共 500 多个。上传图标会转换为 256 × 256 PNG。取消不保存改动。

新建的应用先用一个通用图案；开发对话里 AI 确定应用名称和用途时，会按应用用途自动换成合适的图案和配色。你在「应用设置」里选过图标后，AI 不会再改，除非你在对话里要求换图标。

名称与图标会同步到应用管理侧栏的分组和收藏快捷方式，已打开的独立窗口会更新标题。应用 id、开发会话、源码目录和本地数据保持不变。应用内部如果写死了标题或 logo，需要在开发对话中要求改成跟随应用元数据。现有桌面入口不会自动改名或替换图标；修改后在「⋯」菜单中先点击「删除桌面图标」，再点击「生成桌面入口」即可更新。Windows 和 macOS 上，重新生成的桌面入口会继承设置中的图案与配色，也支持上传的图片图标；旧版的单色图标名仍使用 NewMax 图标，可在应用设置中重新选择图案与配色。如果 Windows 桌面仍显示旧的 Electron 图标，请在更新 NewMax 后按上述步骤删除并重新生成入口。macOS Dock 图标沿用 NewMax。

应用入口

在管理侧栏应用行右侧点击「打开应用」图标可打开独立窗口；要修改应用，展开应用组并选择已有对话，或从组头点击「新对话」。无需离开当前开发对话即可运行应用；「⋯」菜单中的「生成桌面入口」在 macOS 创建带应用名称和图标的轻量启动器，默认隐藏 .app 后缀，桌面显示应用名称；若 Finder 启用了「显示所有文件扩展名」，仍按系统偏好显示后缀。双击后通过 NewMax 打开该应用的独立窗口，不弹出终端。创建后，同一个菜单项会变成「删除桌面图标」：点击后移除由 NewMax 生成且未被手工改写的桌面入口，菜单项恢复为「生成桌面入口」，不会删除应用、数据或开发会话。旧版 .command 入口在生成新的 .app 时会移除；Windows 和 Linux 仍创建系统快捷方式，也可用同一个菜单项删除。桌面入口依赖本机 NewMax 提供运行和模型能力，不是可脱离 NewMax 的独立安装包。可通过 GitHub 分享给其他 NewMax 用户，操作见下文「分享与安装」。

如果应用运行窗口提供「继续编辑」或修改入口，点击后会优先回到已打开该应用开发对话的 NewMax 窗口；没有打开时，优先使用仍在接收该应用开发回复的窗口，否则使用最近操作的 NewMax 窗口。只在一个窗口打开开发页，其他窗口不会一起跳转。开发中收到问询时，点击系统通知或应用内「打开对话」也会优先回到已打开该对话的窗口。

打开应用成功只说明入口通过检查并已加载，不代表所有功能都经过完整测试。遇到报错时，把现象或截图发回该应用的开发对话继续修复。

Windows 上若窗口已经出现，却同时提示 localApps:open 和 EPERM ... rename ... newmax.app.json，可能是最近使用时间写入失败，不是模型搜索错误。包含修复的版本会短暂重试文件替换；仍无法更新时间时保留原配置和窗口，只记录诊断，列表排序可能暂时不更新。名称、权限等真正的设置保存失败仍会报告，不能当成已保存。若仍反复出现，请保留完整错误并在开发对话排查，不要删除应用或清空数据；只刷新页面无法加载主进程修复。

分享与安装

分享自己的应用

1. 在左侧应用组点「⋯ → 分享到 GitHub」。应用需要已通过入口检查，正在开发时应先等当前任务结束。
2. 先连接自己的 GitHub 账号，按提示在浏览器完成设备授权。发布需要本机安装 GitHub CLI；若检测到本机已登录，会展示账号头像和用户名，仍需确认使用该账号，也可通过「切换账号」重新授权。
3. 选择已有公开仓库，或填写 GitHub 仓库地址 / owner/repo，当前账号必须能写入该仓库的默认分支；已有空仓库需先初始化，分支保护也可能阻止发布。列表未显示的仓库可手动填写；也可选择新建公开仓库，修改建议名称 newmax-app-shares。新建仅支持当前个人账号下的仓库，不会在检查时创建；已有私有仓库不会被自动公开，不存在的已有仓库也不会自动创建。
4. 点「检查分享内容」，核对发布账号、目标仓库、是否新建、应用名称/版本、声明权限及包内文件清单。也应通过源码工作台自行检查文件内容，确认没有隐私或密钥，并确认同一快照的源码与资源也会公开、仓库根 README 会更新。修改账号或仓库后必须重新检查。
5. 确认后点「确认公开发布」，这时才会创建所选的新仓库（如适用），把应用源码、资源和 newmax.app.json 提交到目标仓库默认分支的 newmax-apps/<应用 ID>/，并新增或更新根 README.md 中该应用的说明区块，再创建对应这次源码提交的 Release。全部完成并验证公开下载后，点「复制分享口令」发给其他 NewMax 用户。成功记录会保存在本机；关闭弹窗或重启 NewMax 后再次打开「分享到 GitHub」，默认显示上次口令、账号、仓库与发布时间，无需重新登录即可复制。
6. 修改应用后，点口令页的「更新到此仓库」，会预填上次仓库。重新确认账号、检查新快照并确认公开发布后，默认分支上的该应用源码和 README 说明会同步更新，新口令替换为本机默认展示的口令；不会改写旧 Release 或资产，旧口令仍下载旧版本，也不会自动更新他人已经安装的副本。更新失败保留上次成功记录，可点「返回分享口令」。更新页仍可修改仓库，最终发布以预览中明确展示的目标为准。旧分享不会自动补写源码；需要再次「更新到此仓库」并确认发布才会同步，仅打开口令页或复制旧口令不会同步。

若「检查分享内容」条件尚未满足，点击按钮会在按钮附近提示需要确认账号、补全仓库或等待加载/授权，不会直接发起检查。账号确认后，选择或修改仓库、切换已有/新建仓库不会取消账号选中状态，但旧内容预览会失效，需要重新检查；刷新或切换账号、重新授权后才需要再点「使用此账号」。激活页未填写口令时，点击「查看应用」会提示粘贴完整口令；操作处理中再次点击检查、确认或取消会提示等待，不重复提交。记录加载失败可点「重新加载分享记录」，不会自动重新上传。若提示远端已发布但本机保存失败，请立即复制口令，不要为保存记录而重复发布。旧版未保存的分享记录不会自动从 GitHub 回填，可在对应 Release 的说明中找回口令。

根 README 中每个应用有独立说明区块，包含介绍、版本、声明权限、源码入口、NewMax 安装步骤、完整分享口令、Release 链接和 [built by newmax](https://newmax.ai)。更新仅维护该应用区块，保留其他应用区块与用户自写正文；应用包内原有 README 会原样保留在应用目录中，不会被替换，也不会自动为应用选择或添加许可证。如果仓库已有优先展示的 .github/README、多个根 README 或非 Markdown README，发布会先停止；请保留原文档并整理为根 README.md，或选择其他仓库，以保证首页能正常展示说明与链接。

若提示目标源码目录冲突、已被修改或 README 管理块损坏，发布会停止，不覆盖远端改动。请先保存远端改动，再处理冲突，或换一个仓库重新检查并发布；不要为重试直接删除远端内容。发布期间仓库分支被其他人更新，也会停止而不是强行覆盖。若提示 GitHub 发布失败，请检查网络、默认分支写权限，以及已有仓库是否已初始化；源码或 README 可能已提交，但 Release 尚未完成，需先检查远端源码目录、根 README 和 Releases，不能把失败理解为没有公开任何内容。

公开分享不是私密传输：任何人都可能在 GitHub 浏览源码或下载安装包，口令不是密码。仅分享应用源码、资源及应用清单，不读取宿主模型密钥、运行数据或开发对话；隐藏目录、依赖目录、常见数据库/日志/凭据文件也会被排除。但自写代码、文档和资源中的敏感内容仍需自行检查，自动检查不能保证全部识别。

本次分享固定为检查时的快照，之后改代码不会改变已分享版本，需要重新分享。每份包最多 2000 个文件、单文件 16 MB、源码合计 32 MB、包体 48 MB。应用应已准备好本地运行资源，接收端不会自动安装依赖或构建项目。

激活并安装别人分享的应用

1. 进入「本地应用」，在左侧管理栏「新应用」下方、收藏上方点击「激活应用」。在应用开发页也能直接使用，不必先回首页；侧栏收起时先展开侧栏。无管理侧栏布局仍在首页右上方显示入口。这是通过分享口令安装 NewMax 本地应用的入口，不是付费许可证激活；不要求选择工作区，也不要求 GitHub 账号或 CLI。
2. 在提示「粘贴完整分享口令，以 NEWMAX-APP:1: 开头」的输入框中粘贴完整口令后，NewMax 会自动下载、校验并显示应用信息，无需手动下载文件。也可点击「查看应用」手动检查或在失败后重试；不会立即安装或运行。首屏说明口令来自他人分享，并提示粘贴后自动加载预览、确认前不会安装，以及仅安装可信来源的应用。
3. 查看来源仓库、名称、版本、文件和权限。安装确认阶段会提醒核对来源和权限，以及使用模型可能产生费用。只安装你信任的来源分享的应用；展开 SHA-256 可查看校验值和说明，校验只能确认文件完整，不能证明代码安全。
4. 点「信任并安装」。完成后应用出现在本地应用列表，可手动打开。每次安装都是独立副本，不覆盖已有应用或数据，不导入分享者的模型配置，运行时使用自己的 NewMax 模型。

预览十分钟后过期；修改口令或取消后需要重新查看。提示无法读取应用信息时，点击「查看应用」重试；仍失败则联系分享者重新发布并提供新口令。提示预览失效时，同样先点击「查看应用」重新加载，确认后再安装。提示安装未完成时，先查看本地应用列表；若应用未出现，再点击「查看应用」重新预览后安装，避免重复安装。内容不符、路径不安全或协议不兼容时会拒绝安装。下载失败时检查网络后点击「查看应用」重试；仍失败则请分享者确认分享仍公开可用，包括是否删除 Release、改为私有或撤销仓库访问。若发布过程最后的下载验证失败，GitHub 上仍可能已有公开发布记录，可在该记录的说明中找到口令；不要假定失败意味着从未公开。删除本地应用不会删除 GitHub 分享；若要停止对应口令下载，需由发布者到 GitHub 删除对应 Release，但这不会移除默认分支上的源码、README 或 Git 历史，需另行检查处理。已经被下载的副本无法收回。

接收手机照片

这个功能用来把手机拍的照片送进某个本地应用，例如「拍书页记读书笔记」「拍小票记账」这类应用。照片保存到该应用自己的本地数据里，由应用读取使用；它不是对话附件，不会发进开发对话。只有在开发时让应用用到了手机照片（应用声明了手机传图能力），「⋯」菜单里才会出现这个入口。

在左侧应用组的「⋯」菜单中选择「接收手机照片」，再点击「开始接收」。电脑会显示二维码和有效时间；手机连接同一可信 Wi-Fi 后扫码，用浏览器拍照或从相册多选图片。多页可反复点击「拍照」，每张图片单独上传，失败后可重试。电脑收到图片后即时显示缩略图，点击可查看原图。

原图保存在该应用的本地数据目录，不上传云端。支持 JPEG、PNG，单张最多 20 MB、5000 万像素；HEIC 请先导出为 JPEG。每次接收限 15 分钟、100 张或 200 MB。手机点击「完成」、电脑停止接收或关闭接收弹窗后，链接失效；已经收到的图片保留，删除应用时一起清理。

默认「局域网传图」使用 HTTP，传输不加密，只应在可信网络使用。手机和电脑需要互相可达，访客 Wi-Fi 隔离、VPN 或系统防火墙可能阻止连接；不要为此关闭整个防火墙，可检查对 Newmax 的局域网访问授权。

接收前还可选择「HTTPS 连续拍摄」。在服务已启用且桌面已登录时，扫码打开安全页面后，点击连续拍摄并授权相机，即可保持取景连续按快门，照片逐张上传；切到后台、关闭相机或完成时会释放摄像头。图片经过 Newmax 中转服务，收到后保存在电脑本地；电脑须保持在线。服务未配置时会提示不可用，不会自动改用其他传输方式。当前生产服务是否开放以实际可用状态为准。实时连拍保存 JPEG 视频帧（最长边 4096 像素）；要保留系统相机原文件请使用相册上传。暂不自动裁边或 OCR。

应用可以通过对话接入同样的能力，例如：「增加手机传图，把收到的图片关联到当前读书记录，并保留原图。」「⋯」菜单里的「接收手机照片」只负责收图，不会自动改变应用自己的界面或业务记录。需要识别时再明确提出 OCR/视觉模型要求；使用云端模型会把图片发送给对应服务商。

删除应用

在左侧应用组的「⋯」菜单中点击「删除应用」，这一项会变成红色的「确认删除」，再点一次才会删除。点菜单外的地方关闭菜单即取消，不会删除任何内容。

删除会关闭该应用窗口，移除应用源码、由应用保存的本地数据、各工作区中关联的开发会话及消息，以及 NewMax 生成且可识别的桌面快捷方式。应用和关联对话也会从应用首页和搜索结果中移除；正在查看该应用的开发对话时，会回到应用首页。此操作不可撤销，不影响其他应用和共享模型配置；不会删除应用目录外的原始文件或自行改写的快捷方式。

开发对话完成、没有后台任务运行时，可直接删除应用，无需重启 NewMax。若还在生成回复或执行后台任务，请先停止或等待完成；若正在整理上下文，请等待结束后重试。仍在执行或清理失败时，页面顶部会显示原因。