Skip to content

docs(maaend): 更新Maaend支持文档 - #30

Open
HarcoChen wants to merge 2 commits into
masterfrom
docs/maaend-0917
Open

HarcoChen wants to merge 2 commits into
masterfrom
docs/maaend-0917

Conversation

@HarcoChen

@HarcoChen HarcoChen commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

Sourcery 摘要

更新 MaaEnd 支持文档,使其与当前配置功能保持一致,并提供更清晰的设置指南。

新功能:

  • 扩展 MaaEnd 配置指南,涵盖快速配置、自动收集、交付、仅每日任务以及任务前后脚本选项。
  • 添加简明的快速入门部分,并记录新的分辨率管理和任务切换设置。

错误修复:

  • 明确支持的 MaaEnd 版本、账号 ID 格式、游戏启动设置、模拟器要求和分辨率限制。

增强功能:

  • 更新 MaaEnd 设置以及用户/任务配置文档,以反映当前行为,包括直接使用配置文件和自动切换账号。
  • 改进有关下载位置、配置恢复、任务处理以及登录文档链接的说明。

文档:

  • 更新 MaaEnd 支持指南日期,并修订面向用户的设置、配置和故障排除说明。
Original summary in English

Sourcery 总结

更新 MaaEnd 支持文档,提供与当前配置功能一致且更清晰的设置指南。

改进:

  • 完善 MaaEnd 配置、用户与任务设置指南,使其与当前功能和行为保持一致。

文档:

  • 更新 MaaEnd 支持文档,新增快速入门、自动采集、送货、每日一次任务及任务前后脚本等配置说明,并补充版本、账号、模拟器、分辨率和故障排查指引。
Original summary in English

Summary by Sourcery

更新 MaaEnd 支持文档,提供与当前配置功能一致且更清晰的设置指南。

Enhancements:

  • 完善 MaaEnd 配置、用户与任务设置指南,使其与当前功能和行为保持一致。

Documentation:

  • 更新 MaaEnd 支持文档,新增快速入门、自动采集、送货、每日一次任务及任务前后脚本等配置说明,并补充版本、账号、模拟器、分辨率和故障排查指引。

@sourcery-ai

sourcery-ai Bot commented Sep 17, 2026

Copy link
Copy Markdown
Contributor

审查者指南

更新 MaaEnd 配置指南以匹配新版 AUTO-MAS/MaaEnd 集成能力,覆盖安装、脚本与用户配置、自动采集和送货等新增任务选项,并补充版本兼容性及分辨率使用说明。

MaaEnd 任务阶段选择流程图

flowchart LR
    Start[开始托管] --> Delivery[送货阶段]
    Delivery --> Daily[日常任务阶段]
    Daily --> Collect[自动采集阶段]
    Collect --> End[任务结束]
    Daily --> End
Loading

文件级变更

变更 详情 文件
更新 MaaEnd 安装与脚本配置说明,以适配新版功能和版本要求。
  • 新增快速上手摘要及 v5.5.0+ 配置版本提示
  • 补充启动/恢复分辨率、任务切换等脚本配置项
  • 调整模拟器版本要求、游戏启动等待时间及配置表述
docs/script-guide/maaend.md
扩展 MaaEnd 用户任务配置文档,说明配置来源与新增自动化阶段。
  • 补充直控配置来源和账号 ID 格式说明
  • 增加快速配置、自动采集、送货、每日一次任务及任务前后脚本说明
  • 明确快速配置依赖 MaaEnd 中已有对应任务,并更新切号说明
docs/script-guide/maaend.md
整理相关使用提示和文档链接,强化分辨率配置指引。
  • 更新森空岛签到页面链接文字
  • 补充分辨率自动设置建议
  • 调整安装路径、任务完成后关机等提示文案
docs/script-guide/maaend.md

提示与命令

与 Sourcery 交互

  • 触发新的审查: 在拉取请求中评论 @sourcery-ai review
  • 继续讨论: 直接回复 Sourcery 的审查评论。
  • 根据审查评论创建 GitHub issue: 回复审查评论,请 Sourcery 根据该评论创建 issue。你也可以回复 @sourcery-ai issue,根据该评论创建 issue。
  • 生成拉取请求标题: 在拉取请求标题的任意位置写入 @sourcery-ai,即可随时生成标题。你也可以在拉取请求中评论 @sourcery-ai title,随时重新生成标题。
  • 生成拉取请求摘要: 在拉取请求正文中你希望摘要出现的位置写入 @sourcery-ai summary,即可随时生成 PR 摘要。你也可以在拉取请求中评论 @sourcery-ai summary,随时重新生成摘要。
  • 生成审查者指南: 在拉取请求中评论 @sourcery-ai guide,即可随时重新生成审查者指南。
  • 解决所有 Sourcery 评论: 在拉取请求中评论 @sourcery-ai resolve,即可解决所有 Sourcery 评论。如果你已经处理完所有评论且不想再看到它们,这个命令会很有用。
  • 忽略所有 Sourcery 审查: 在拉取请求中评论 @sourcery-ai dismiss,即可忽略所有现有的 Sourcery 审查。如果你想通过新的审查重新开始,这个命令尤其有用——别忘了评论 @sourcery-ai review 以触发新的审查!

自定义使用体验

访问你的控制面板即可:

  • 启用或禁用审查功能,例如 Sourcery 生成的拉取请求摘要、审查者指南等。
  • 更改审查语言。
  • 添加、删除或编辑自定义审查说明。
  • 调整其他审查设置。

获取帮助

Original review guide in English

Reviewer's Guide

更新 MaaEnd 配置指南以匹配新版 AUTO-MAS/MaaEnd 集成能力,覆盖安装、脚本与用户配置、自动采集和送货等新增任务选项,并补充版本兼容性及分辨率使用说明。

Flow diagram for MaaEnd task stage selection

flowchart LR
    Start[开始托管] --> Delivery[送货阶段]
    Delivery --> Daily[日常任务阶段]
    Daily --> Collect[自动采集阶段]
    Collect --> End[任务结束]
    Daily --> End
Loading

File-Level Changes

Change Details Files
更新 MaaEnd 安装与脚本配置说明,适配新版功能和版本要求。
  • 新增快速上手摘要及 v5.5.0+ 配置版本提示
  • 补充启动/恢复分辨率、任务切换等脚本配置项
  • 调整模拟器版本要求、游戏启动等待时间及配置表述
docs/script-guide/maaend.md
扩展 MaaEnd 用户任务配置文档,说明配置来源与新增自动化阶段。
  • 补充直控配置来源和账号 ID 格式说明
  • 增加快速配置、自动采集、送货、每日一次任务及任务前后脚本说明
  • 明确快速配置依赖 MaaEnd 中已有对应任务,并更新切号说明
docs/script-guide/maaend.md
整理相关使用提示和文档链接,强化分辨率配置指引。
  • 更新森空岛签到页面链接文字
  • 补充分辨率自动设置建议
  • 调整安装路径、任务完成后关机等提示文案
docs/script-guide/maaend.md

Tips and commands

Interacting with Sourcery

  • Trigger a new review: Comment @sourcery-ai review on the pull request.
  • Continue discussions: Reply directly to Sourcery's review comments.
  • Generate a GitHub issue from a review comment: Ask Sourcery to create an
    issue from a review comment by replying to it. You can also reply to a
    review comment with @sourcery-ai issue to create an issue from it.
  • Generate a pull request title: Write @sourcery-ai anywhere in the pull
    request title to generate a title at any time. You can also comment
    @sourcery-ai title on the pull request to (re-)generate the title at any time.
  • Generate a pull request summary: Write @sourcery-ai summary anywhere in
    the pull request body to generate a PR summary at any time exactly where you
    want it. You can also comment @sourcery-ai summary on the pull request to
    (re-)generate the summary at any time.
  • Generate reviewer's guide: Comment @sourcery-ai guide on the pull
    request to (re-)generate the reviewer's guide at any time.
  • Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
    pull request to resolve all Sourcery comments. Useful if you've already
    addressed all the comments and don't want to see them anymore.
  • Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
    request to dismiss all existing Sourcery reviews. Especially useful if you
    want to start fresh with a new review - don't forget to comment
    @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

  • Enable or disable review features such as the Sourcery-generated pull request
    summary, the reviewer's guide, and others.
  • Change the review language.
  • Add, remove or edit custom review instructions.
  • Adjust other review settings.

Getting Help

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

嘿——我发现了 3 个问题

面向 AI Agent 的提示
请处理本次代码审查中的评论:

## 单独评论

### 评论 1
<location path="docs/script-guide/maaend.md" line_range="51" />
<code_context>
-   | **(PC端)游戏启动参数** | 留空 |
-   | **(PC端)游戏启动后等待时间** | 启动游戏后等几秒再开始操作,默认 60 秒 |
-   | **任务完成后关闭游戏** | 全部用户跑完后要不要自动关掉游戏 |
+   | **(PC端)游戏路径** | 选 `Endfield.exe`**不是**鹰角启动器 | '
+   | **(PC端)启动时设置分辨率** | 启用后,会在运行MaaEnd时将分辨率设为720P,避免不符合分辨率要求 |
+   | **(PC端)结束时恢复分辨率** | 启用后,会在全部任务结束时恢复到设定的分辨率,全屏或指定的分辨率 |
</code_context>
<issue_to_address>
**小问题:** PC 游戏路径表格行的结尾 `|` 后多了一个撇号,因此渲染后的文档会显示多余的 `'`,并且该行与其他表格行相比格式不正确。

**建议修复:** 删除该行末尾的撇号。
</issue_to_address>

### 评论 2
<location path="docs/script-guide/maaend.md" line_range="55" />
<code_context>
+   | **(PC端)启动时设置分辨率** | 启用后,会在运行MaaEnd时将分辨率设为720P,避免不符合分辨率要求 |
+   | **(PC端)结束时恢复分辨率** | 启用后,会在全部任务结束时恢复到设定的分辨率,全屏或指定的分辨率 |
+   | **(PC端)游戏启动参数** | 无需要则留空 |
+   | **(PC端)游戏启动后等待时间** | 无需填写,已由MaaEnd接管 |
+   | **任务完成后关闭游戏** | 用户跑完后要不要自动关掉游戏 |
    | **代理超时限制** | 日志多少分钟没动静就算卡死,默认 10 分钟 |
</code_context>
<issue_to_address>
**问题:** 配置表说明启动等待时间已由 MaaEnd 控制,无需再填写;但故障排除部分仍然告诉用户不要降低默认的 60 秒等待时间。按照更新后的配置指南操作、将 AUTO-MAS 等待时间字段留空的用户,没有明确的方法来应用故障排除建议,并且这两条说明相互矛盾。

**触发条件:** 游戏启动较慢,且用户在将 AUTO-MAS 等待时间字段留空后,按照故障排除部分的说明进行操作时。

**建议修复:** 更新故障排除部分,指出控制等待时间的 MaaEnd 设置;或者删除已经过时的 60 秒调整建议。
</issue_to_address>

### 评论 3
<location path="docs/script-guide/maaend.md" line_range="124" />
<code_context>
-
-
+### 每天仅一次的任务
+顾名思义,添加后每天只会执行一次/
+### 任务前后额外脚本
+与通用脚本一致的功能,支持在任务完成前/后额外执行您指定的程序或脚本。
</code_context>
<issue_to_address>
**小问题:** 新句子以字面上的 `/``每天只会执行一次/`)结尾,因此发布后的文档会包含一个明显的多余字符,句子也不完整。

**建议修复:** 将末尾的 `/` 替换为适当的中文标点,或将其删除。

```suggestion
顾名思义,添加后每天只会执行一次。
```
</issue_to_address>

Sourcery 评估

等待批准。 请先处理 1 个发现的问题。

阻塞性发现:docs/script-guide/maaend.md:55


Sourcery 对开源项目免费——如果您喜欢我们的审查结果,请考虑分享它们 ✨
Original comment in English

Hey - I've found 3 issues

Prompt for AI Agents
Please address the comments from this code review:

## Individual Comments

### Comment 1
<location path="docs/script-guide/maaend.md" line_range="51" />
<code_context>
-   | **(PC端)游戏启动参数** | 留空 |
-   | **(PC端)游戏启动后等待时间** | 启动游戏后等几秒再开始操作,默认 60 秒 |
-   | **任务完成后关闭游戏** | 全部用户跑完后要不要自动关掉游戏 |
+   | **(PC端)游戏路径** | 选 `Endfield.exe`**不是**鹰角启动器 | '
+   | **(PC端)启动时设置分辨率** | 启用后,会在运行MaaEnd时将分辨率设为720P,避免不符合分辨率要求 |
+   | **(PC端)结束时恢复分辨率** | 启用后,会在全部任务结束时恢复到设定的分辨率,全屏或指定的分辨率 |
</code_context>
<issue_to_address>
**nitpick:** The PC game-path table row contains an extra trailing apostrophe after the closing `|`, so the rendered documentation displays a stray `'` and the row is malformed compared with the other table rows.

**Suggested fix:** Remove the trailing apostrophe after the row.
</issue_to_address>

### Comment 2
<location path="docs/script-guide/maaend.md" line_range="55" />
<code_context>
+   | **(PC端)启动时设置分辨率** | 启用后,会在运行MaaEnd时将分辨率设为720P,避免不符合分辨率要求 |
+   | **(PC端)结束时恢复分辨率** | 启用后,会在全部任务结束时恢复到设定的分辨率,全屏或指定的分辨率 |
+   | **(PC端)游戏启动参数** | 无需要则留空 |
+   | **(PC端)游戏启动后等待时间** | 无需填写,已由MaaEnd接管 |
+   | **任务完成后关闭游戏** | 用户跑完后要不要自动关掉游戏 |
    | **代理超时限制** | 日志多少分钟没动静就算卡死,默认 10 分钟 |
</code_context>
<issue_to_address>
**issue:** The configuration table says the startup wait time no longer needs to be filled because MaaEnd controls it, while the troubleshooting section still tells users to avoid lowering the default 60-second wait time. Users following the updated configuration guidance have no clear way to apply the troubleshooting advice, and the two instructions contradict each other.

**Triggers:** When the game starts slowly and the user follows the troubleshooting section after leaving the AUTO-MAS wait-time field empty.

**Suggested fix:** Update the troubleshooting section to identify the MaaEnd setting that controls the wait time, or remove the obsolete 60-second adjustment advice.
</issue_to_address>

### Comment 3
<location path="docs/script-guide/maaend.md" line_range="124" />
<code_context>
-
-
+### 每天仅一次的任务
+顾名思义,添加后每天只会执行一次/
+### 任务前后额外脚本
+与通用脚本一致的功能,支持在任务完成前/后额外执行您指定的程序或脚本。
</code_context>
<issue_to_address>
**nitpick:** The new sentence ends with a literal `/` (`每天只会执行一次/`), so the published documentation contains an obvious stray character and does not read as a complete sentence.

**Suggested fix:** Replace the trailing `/` with the intended Chinese punctuation or remove it.

```suggestion
顾名思义,添加后每天只会执行一次。
```
</issue_to_address>

Sourcery assessment

Approval pending. 1 finding to address first.

Blocking findings: docs/script-guide/maaend.md:55


Sourcery is free for open source - if you like our reviews please consider sharing them ✨

Comment thread docs/script-guide/maaend.md Outdated
Comment thread docs/script-guide/maaend.md
Comment thread docs/script-guide/maaend.md Outdated

@sourcery-ai sourcery-ai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Sourcery assessment

Approved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant