帮助 — Maestro

Maestro 帮助

Maestro 使用专门模块审校 .docx 文档。审校意见会作为 Word 评论写入文件，由您逐条判断是否采用。整个流程以“编排”为核心：一组模块从互补角度审阅同一文本。

使用模式

首次启动时选择基础或高级模式。之后可在设置中切换。已有安装保持高级模式。

基础模式使用 OpenAI：模块和报告使用 GPT-6 Luna；助手、编辑器和最终审阅使用 GPT-6.1 Sol。请在设置中保存密钥；初始指引提供 OpenAI 门户和教程入口。无需密钥也可以创建和编辑本地内容。

基础模式支持直接和批处理。新请求默认开启最终审阅、关闭报告，两个复选框均可更改。切回高级模式会恢复原有技术设置。基础模式导出采用 OpenAI 配置，不修改原始记录。

入门

基本流程分为九步：

在所选付费提供商控制台购买点数或启用 API 计费。
在设置中保存至少一个 API 密钥。
查看现有模块，或创建自己的模块。
如果机密数据不能发送给 AI 模型，请创建保护筛选器。
自行组合所需模块，或使用创建助手生成编排。
打开新任务并选择编排。
添加一个或多个 .docx 文档。
确认任务并跟踪处理进度。
打开结果，审核建议并下载文件。

更新应用不会删除目录、编排、历史记录或已保存文档。

可从侧边栏打开教程，通过应用中的真实页面完成上述流程。教程提供最短路径；本帮助说明细节、限制和故障处理方法。

API 密钥与服务商

Maestro 支持 OpenAI、Anthropic、Gemini 和 DeepSeek。请在设置 → API 密钥中配置需要使用的服务商。一个编排可以组合多个服务商；可用模型请查看应用中的模型选择器。

Maestro 已停用 Kimi 和 MiMo：对这些服务商的新调用已被阻止。现有历史记录和结果仍可读取。提交新任务时，请选择可用模型。

创建密钥并不等于充值。聊天机器人订阅不能代替 API 付费。不同账户可能采用预付费、账单结算或免费配额。Maestro 不收款、不查询余额，也不会续充配额。

OpenAI: 管理密钥 · 余额与账单.
Anthropic: 管理密钥 · 余额与账单.
Gemini: 管理密钥 · 余额与账单.
DeepSeek: 管理密钥 · 余额与账单.

链接会在浏览器中打开官方网站，可能需要登录。DeepSeek 请进入控制台的账单页面。请确认账户或项目正确；购买和付款仅在服务商网站完成。

文件、网页搜索、批处理和加速功能取决于模型与处理方式。Maestro 根据能力目录提供兼容组合；同一服务商的不同模型也可能支持不同功能。

导出模块和编排时，会包含自定义模块的参考文件。导入会创建独立的本地副本，不包含发送者的密钥、历史记录或远程文件关联。如需将参考文件存入自己的账户，请勾选将文件存储在服务商处，并在详情中上传、更新或删除远程副本。远程存储不可用时，Maestro 会在每次兼容请求中发送本地副本。模型选择器会显示文件支持情况。

加速功能默认不启用。在设置中启用评论助手优先速度后，才允许兼容模型使用 Fast/Priority；费用可能更高。否则使用普通模式。WebSocket 传输不等于加速计费。

确认余额不足时显示充值，账单限制显示查看账单与限额，密钥被拒绝时显示管理密钥。临时限流和免费配额耗尽不一定意味着缺少资金。技术信息可在更多详情中查看。打开控制台不会购买额度或重新发送任务。

在设置中，已审校文本的文件夹位于顶部。任务完成时通知默认开启，显示取决于系统权限。开发者部分仅在开发模式下显示；点击**目录详情…**可查看分发目录。

模块

模块是一位编辑专家，包含目标、指令、提供商和模型。内置模块分别审校文体、语法与字词规范、可读性、论证和篇章结构。您也可以创建自己的模块；自定义内容始终保持原文，界面不会自动翻译。

创建或编辑模块时，助手可以改进指令草稿。建议仍可编辑，只有保存后才会替换原提示词。

如果有效的模块、格式模板或保护筛选器已使用同名项目，Maestro 会保留两者，并给新项目添加第一个可用后缀：-1、-2 等。编辑现有项目时仍禁止重名，以免发生意外重命名。

模块可以设置最多生成多少条评论。Maestro 不会按字符数截断诊断或建议；验证提供商回答后，完整评论会保存到结果和 DOCX。有效措辞不会被缩短，也不会被添加省略号。被截断的回答视为未完成，不会保存成半条评论。

部分模型可接收 PDF、DOCX、TXT 或 MD 文件作为参考材料。每次运行模块时，文件都会发送给提供商。尽量使用简短、相关且不含多余信息的材料。20 MB 是技术上限，不是推荐大小。

也可以填写以 https:// 开头的公共网址。Maestro 不自行下载页面：OpenAI 使用限定域名的搜索，Anthropic 使用 Web Fetch，Gemini 使用 URL Context。没有文档化原生访问能力的模型（包括当前 DeepSeek 模型）不会显示此项。每个模块只选择一种来源：文件或网址。

可用的法律模块

可用视图分别提供 LGPD — 编辑分诊 和 GDPR — 编辑分诊 模块。它们随 Maestro 提供，但只有选择启用后才会出现在已启用中。启用后，卡片会离开可用视图。内部记录会在安装仍然有效时防止创建重复副本。

LGPD 和 GDPR 都属于专业编辑预览：它们不作出合规声明，也不能替代法律意见。商业分发或作出法律决定前，必须由相关司法管辖区的律师审核。

格式模板

格式模板描述文档结构，例如标题、正文、注释、表格和其他部分。在模块中选择 创建模板，指定 .docx 文档并命名，然后决定只评论差异，还是同时应用安全的格式调整。

不使用 AI 时，源文档必须一致地使用 Word 样式。只有结构主要依赖可见格式时，才应启用 AI 辅助。AI 会收到结构化样本和短片段，但不会收到完整文档或文件名。

批量处理前，请先用有代表性的文档测试模板。

保护筛选器

保护筛选器会在内容发送给提供商之前，于本地对机密数据进行化名处理。每项标准包含名称、类别、识别说明、正则表达式、标志以及正反示例。一次执行中，同一对象始终使用同一化名，使模型能够在文档、指令和来源之间识别它。

在模块中创建筛选器。可在高级中填写和检查正则表达式，也可让 AI 提出规则。 AI 只会收到标准的名称、类别、说明和虚构示例；不会收到工作文档。生成的方案可以编辑，必须由您审核。

筛选器可用于多个编排。修改只影响这些编排之后的新任务。确认前，Maestro 会在本地预览数量和文本片段。如果没有匹配项，您可以明确继续，也可返回修改规则。

模型输出中的原值会在本地恢复。结果页的化名替换显示原值、化名、类别、规则、正则表达式和标志。该表含有机密数据，因此默认收起。

编排

编排决定哪些模块参与审校。先选择少量互补领域，只在需求明确时添加专家。模块越多，处理时间和提供商费用通常越高。

可用视图包含十一种专业组合。启用前，每张卡片都会显示用途、组成和语言。请只对所需专业选择启用。Maestro 会核验清单、哈希值和包结构，复用内置模块，并且只创建必要的专业模块。

启用编排绝不会更改默认编排。新组合会出现在已启用中，只有明确选择设为默认后才会成为默认编排。受保护的系统编排保持不变。

每个示例也是标准的 .maestro.orchestra 包。因此，您可以通过导入编排载入它，检查并修改名称、提示词、模型、限制和图标，以后还可导出另一份副本。重复导入会使用新 ID 并为名称添加后缀，不会替换旧副本。之后更改应用语言不会翻译已经安装的副本。

示例中的自定义模块起初不含参考文件或网址。导入后，每个模块可添加一个兼容文件或一个公开网址，不同来源也可分配给不同模块。后来添加的材料属于您的内容，且只在运行该模块时发送。请只发送您有权使用并与所选服务商共享的材料。

创建助手分为四步：工作说明与标准、背景材料、示例文档与保护、模型与发送授权。您输入的每项标准都会生成必选模块；文档和材料可以建议额外模块。额外建议可删除，所有名称和提示词在保存前都可修改。请务必亲自审核：没有人比您更了解自己的工作。

助手最多接收五个 DOCX 示例文档，以及文件和网址合计五份背景材料。发送前必须明确授权。提供商会收到从示例中提取的文本、文件内容和网址，且不会应用为后续审校创建的保护筛选器。本地路径和文件名不会发送。带注释的保护示例只能使用虚构数据。

创建或编辑编排时，可以选择可复用保护筛选器。旧版内嵌策略会在下次保存时转换为可复用筛选器，标准不会改变。

保存前请确认所需模块已启用、密钥已配置，并且高费用模块确有必要。

删除会把编排移至最近删除。模块和以往审校记录会保留，编排也可恢复。永久删除无法撤销，但不会删除共享模块或既往审校。如果删除默认编排，“标准”会重新成为默认选择。

新任务

选择编排，添加文档并核对摘要。可使用系统文件对话框，也可把文件拖到文档区域。

调整本次提交的模块不会修改模块或编排。请使用清晰的文件名，并避免重复添加同一文档版本。

发送前，摘要会显示文档、编排、模型、拆分策略、覆盖范围和预计 AI 调用次数。模型不可用的模块必须先选择模型。可用时加速只会请求兼容模型，且可能收费更高。

可选编辑报告提供整体概览，但不能代替逐条阅读文档评论。确认后，Maestro 会创建本地工作副本，并只向各提供商发送所选模块需要的内容。

批处理通常较便宜，但可能等待更久；直接处理会并行发起兼容请求。批处理任务中不支持批处理的模型会按直接模式的价格和等待时间执行。本地模块不会向 AI 提供商发送内容。

选择批处理时，批处理失败时改用直接处理会继承全局设置，但可仅针对本次提交更改。超时或状态不确定不会触发回退：OpenAI 必须关闭该批次并确认没有执行任何请求， Maestro 还必须验证同一个远程文件。系统会在首次直接调用前保存这一转换。远程状态不明确时仍会保持暂停，以避免重复计费或重复生成评论。

使用保护筛选器时，请先核对本地预览，再选择确认并开始。发送授权只有在此之后才生效。

长文档

Maestro 会按模型分别计算安全容量，为提示词、参考材料、邻近上下文和结构化回答预留空间。发送前的审校计划显示覆盖范围、分段和预计调用次数。

有三种策略：

**自动 — 必要时拆分：**能完整处理时使用整个文档，只有模型限制要求时才拆分；
**拆分处理：**使用所选的 2 至 20 个部分，只有模型限制要求时才增加；
**一次分析完整文档：**不主动拆分，但仍不得超过模型技术限制。

即使文档能在一次调用中处理，拆分也可能为推理、指令和评论留出更多空间，但会增加调用次数。各部分略有重叠，并带有邻近上下文摘要；最后 Maestro 会合并意见，同时保留覆盖范围和位置关联。

上下文摘要模型只在拆分时使用，默认采用编辑报告模型。单次任务可以覆盖设置中的默认策略。

跟踪任务

状态页显示总体进度和每个模块的状态：

**正在准备：**验证文档与编排；
**审校中：**模块正在处理内容；
**正在合并：**汇总各项意见；
**正在生成报告：**准备输出文件；
**已完成：**结果可用；
**需要留意：**某个阶段需要检查；
**失败：**无法继续处理。

进度只在可验证的阶段完成后变化，不按时间自动增加。

中断后，Maestro 会区分“提供商远程结果不确定”的任务和“确定尚未开始”的任务。 继续安全任务只会重新启动后一类。结束任务保留已确认结果并取消其余内容；远程结果不确定的任务不会被盲目重复。

主页的进行中的任务汇总所有有效审校。打开任务详情可查看覆盖范围、提供商、模块进度和可用的继续方式。

提供商错误

持续显示的错误卡片会说明原因、未完成部分和建议操作。Maestro 可识别密钥被拒、权限或余额不足、配额耗尽、临时限制、请求无效、模型不可用、内容过滤、回答中断、取消、连接失败、超时、过载和提供商内部错误等情况。

更多详情可显示阶段、请求的模型、HTTP 状态、代码、类型、请求 ID、建议等待时间和技术消息。密钥、令牌和授权数据会替换为 [已遮蔽]。提示词、文档、请求头、完整 JSON 和堆栈跟踪不会显示。

如果 DeepSeek 在自动修复后仍返回无效格式，请重试；问题持续时，可选择其他模型或简化模块提示词。

直接执行可对临时连接错误、超时、过载、速率限制或无效回答进行重试，最多额外三次，并遵守提供商建议的等待时间。计数会在重启后保留。密钥、权限、计费、请求、上下文、内容、取消和模型错误不会自动重试。

批任务查询中的临时错误不会结束任务。Maestro 不会暗中增加付费重试，也不会自动换模型。

结果

结果页显示审校后的文档、可选报告、编辑摘要和各模块结果。评论只是建议；最终决定始终由您作出。

点击已完成模块，或按 Enter、Space，即可在下载前阅读评论。每次显示十条， 再显示 10 条会逐步展开其余评论。可同时打开多个模块。无评论或失败的模块不能展开。

结果和 Word 中的 **诊断：与编辑建议：**会加粗。只有建议替换的具体文本会放入引号并显示为斜体。诊断应简明指出问题，建议可以按需要充分说明。Maestro 会完整保留两部分，不会替您接受任何建议。

编辑摘要使用实际执行时编排快照中的模块名称，包括自定义名称，而不是技术标识符。等待中、失败或取消的模块不会计入“有评论”或“无评论”模块。

使用保护筛选器时，化名替换可检查整个执行过程，每次显示二十项。打开此处不会再次运行规则，也不会改变结果；原值已在本地恢复。

查看报告会打开 Maestro 的独立全屏滚动窗口。下载 DOCX 报告会在本地生成包含相同内容的 Word 文档，不会再次调用 AI。然后打开审校后的文档，保留适合的评论，舍弃其余评论。

预计费用

费用依据记录的使用量和可用价格估算，不替代提供商账单。未知价格绝不会显示为免费；实际金额请在提供商控制台核对。

金额以美元显示六位小数，例如 US$ 0.002000。US$ 0.000000 表示已确认的免费使用； 等待中表示任务未结束，价格不可用表示缺少可靠的使用量或价格，未使用 AI 表示所有处理都在本地完成。失败或取消的任务也可能已经产生费用。

历史记录

历史记录保存任务并可重新打开结果。“模型”按钮显示每个模块实际使用的模型；文档拆分时，也会显示上下文摘要模型。由助手创建的编排会标明来源。长列表会逐步加载，顺序保持不变。

清除历史记录会删除内部工作文件，但不会删除已经复制到交付文件夹的文档。任务运行期间不能清除历史记录；该操作需要确认，且无法撤销。

设置

审阅文本文件夹位于顶部。打开文件夹可查看已完成 DOCX 的保存位置。如果可以选择其他文件夹，该选择仅影响后续任务，不会移动已有结果。

在发送选项中，设置报告和最终审阅的默认模型、长文档策略及通知。审阅语言可跟随每份文档或固定为一种语言，并在检测不确定时使用备用语言。界面语言单独设置。更改语言不会翻译以前的结果。

数据保护确认和语言确认是独立的可选项。关闭确认后会直接使用已保存的配置，不会禁用保护过滤器。

在文档编辑器选项中，选择助手默认模型、是否始终引用完整文档以及是否优先提高速度。加速取决于模型，费用可能更高。

在价格区域可查看价格表和更新时间、手动更新或开启自动更新。“最便宜”标记只考虑密钥已验证的兼容模型，不会更改已保存的选择。

在密钥区域验证并保存密钥，或移除本地副本。打开提供商文件管理以管理远程参考资料。开发者区域仅在开发模式下显示，用于选择随应用分发的目录内容。

选择模型

目录只显示与任务兼容的模型。更大的模型可能更贵，但对简单指令未必更好。请根据编辑任务、隐私、费用、耗时和文档化能力选择。Maestro 不会在未告知您的情况下自动更换模型。

隐私与存储

设置、历史记录、化名映射和工作副本保存在应用的本地存储中。输出文件会复制到设置中选择的审校后文本文件夹。密钥保存在系统安全存储中。

只有确认任务后，文档才会发送给编排所需的提供商。创建助手另有独立授权：它可发送提取的示例文本、文件内容和所填网址，但不会发送本地路径或文件名。为未来审校创建的筛选器不会自动保护这些示例。恢复原值的映射会与本次执行一起保存，直到相应历史记录被删除。

提供商隐私

各提供商的数据保留和处理规则不同。发送机密文档前，请查看最新条款和账户设置。 Maestro 无法改变外部平台的规则。

故障排除

模型列表为空或缺少模型

在设置的 API 密钥区域验证并保存提供商的密钥。列表仅显示密钥已验证、且支持当前任务和处理模式的模型。密钥被接受并不保证拥有所有模型的访问权限或足够余额。

如果旧配置显示需要选择模型，请手动选择并保存。旧的自动选择最便宜模型选项现在需要明确选择具体模型。

“最便宜”是什么意思？

此标记仅比较当前列表中密钥已验证、价格已知且符合要求的模型。标记随价格和处理模式更新，不会更改您的选择，也不保证任务的最终费用。

价格没有更新

在设置中打开价格表，查看上次更新时间。检查网络连接并手动更新。查询失败时，Maestro 保留上一个有效目录。价格更新不会向应用添加新模型。

密钥被拒绝

检查提供商是否正确、是否有多余空格以及密钥是否仍然有效。打开相应账户的密钥管理页面。不要在截图或求助信息中包含密钥。

提供商拒绝了请求

按照错误卡片中的操作处理。“充值”对应已确认的余额不足；查看账单和限额用于了解财务限制。遇到临时限额时，请等待提示的时间。未明确说明的配额问题不代表余额不足：充值前先查看提供商控制台。

发生超时或断线后，先查看历史记录和任务状态，再决定是否重新发送。结果可能仍在等待中。已接受的批处理应继续跟踪，直到状态得到确认。

无法导入模块或乐团

查看导入摘要，并确认选择了正确的包类型。如果提示当前版本不支持某个内置模块，请在旧版本中复制该模块，然后导出自定义副本。仅修改扩展名无法解决问题。

对于无效或不完整的包，请从原版本重新导出。导入的参考文件是本地副本；不会继承发送方的密钥或远程关联。

文档或 PDF 无法准备

确认原文件能正常打开且不需要密码。PDF 必须先准备，再进行审阅。查看该文件的错误；其他文档可以继续处理。从请求中移除文件不会删除原件。修复问题后再添加。

模块、报告或最终审阅失败

打开结果，查看受影响的步骤及建议操作。部分失败不代表所有步骤都失败。保留已完成的结果，使用可用的恢复操作继续待处理步骤。重新发送整个请求前，先确认任务状态。

发送前出现确认提示

在设置中检查数据保护确认和语言确认选项。二者相互独立。关闭数据保护确认不会禁用已配置的过滤器。

应用似乎停住了，或者没有通知

查看各文档的进度以及是否有需要处理的步骤。批处理等待时间也取决于提供商。启用完成通知，并检查系统的通知权限。

所选文件夹中没有文档

打开结果。如果目标位置不可用，请查看警告和内部存储中保留的文件。在设置顶部检查审阅文本文件夹。更改目标位置不会重新复制已完成的任务。

建议不合适

检查模块指令和参考资料，避免相互矛盾的目标，并尝试适合该任务的模型。应用前逐条判断评论；最终审阅同样需要您的评估。

需要更多帮助

访问 maestroapp.site。反馈问题时，请提供 Maestro 版本、操作系统、尝试的操作及显示的消息。使用不含个人信息的示例，并从截图和技术详情中删除密钥、保密文本及其他敏感数据。

中文可读性

中文不使用英语 Flesch 公式。模块会报告结构性概况，包括句数、汉字数和平均句长。这些指标描述文本表面结构，不代表理解程度、事实质量或适用年级，也不能替代编辑判断。

键盘与导航

Tab 和 Shift+Tab 在控件之间移动焦点。
Enter 或 Space 激活所选项目。
Esc 关闭对话框且不保存。
⌘K 打开帮助搜索。
⌘1 打开主页，⌘N 打开新任务。
方向键可在支持键盘导航的组和列表中移动；Home 与 End 跳到开头和结尾。
文件、模块、模板、编排、审校、视图、跳转、窗口和帮助菜单提供相同功能。

应用许可证

关于 Maestro

Maestro 是一个尊重隐私的独立项目。它协调针对同一文本的多项编辑审校并返回建议，让最终决定始终掌握在您手中。

教程

配置密钥

了解模块

保护敏感数据

使用助手组建乐团

选择编排

准备任务

跟踪处理进度

查看结果