Skip to content

feat(map): MapTrackerMove 尊重最后路径朝向#1529

Merged
isHarryh merged 4 commits intoMaaEnd:v2from
isHarryh:v2
Mar 22, 2026
Merged

feat(map): MapTrackerMove 尊重最后路径朝向#1529
isHarryh merged 4 commits intoMaaEnd:v2from
isHarryh:v2

Conversation

@isHarryh
Copy link
Copy Markdown
Member

@isHarryh isHarryh commented Mar 22, 2026

概要

此 PR 向 MapTrackerMove 节点添加了尊重最后路径朝向的功能,使得相机可以朝向最终路径方向。

此外,添加了精细进近模式下的角度抵达判据,使得精细进近对朝向更加鲁棒。

Summary by Sourcery

MapTrackerMove 中尊重路径的最终方向,使摄像机在到达时朝向最后一段路径方向,并优化移动/朝向处理,以实现更健壮的导航。

New Features:

  • 新增选项,在到达最后一个路径目标时可以跳过强制应用最终摄像机朝向。

Enhancements:

  • 调整中间路径点的旋转预测,并确保在导航完成时摄像机与最终路径方向对齐。
  • 收紧旋转精度与移动速度之间的联动,包括疾跑限制,以及在精细接近阶段始终保持行走。
  • 通过引入与普通接近模式类似的基于朝向的启发式方法,改进精细接近模式下的到达检测。
  • 延长 Windows 平台上的摄像机滑动操作持续时间,并在激进的移动重置后更精确地重置内部移动状态。

Documentation:

  • 在英文和中文的开发者文档中补充 no_ensure_final_orientation 新参数的说明,并澄清 fine_approachmap_name_match_rule 的行为。
Original summary in English

Summary by Sourcery

Respect the final path direction in MapTrackerMove so the camera faces the last segment upon arrival and refine movement/orientation handling for more robust navigation.

New Features:

  • Add an option to skip enforcing the final camera orientation when reaching the last path target.

Enhancements:

  • Adjust rotation prediction at intermediate waypoints and ensure the camera aligns with the final path direction upon completing navigation.
  • Tighten the interaction between rotation accuracy and movement speed, including sprint gating and always walking during fine approach.
  • Improve arrival detection in fine-approach mode by incorporating orientation-based heuristics similar to ordinary approach.
  • Increase the duration of camera swipe actions on Windows and reset internal movement state more accurately after aggressive movement resets.

Documentation:

  • Document the new no_ensure_final_orientation parameter and clarify the behaviors of fine_approach and map_name_match_rule in both English and Chinese developer docs.

Copilot AI review requested due to automatic review settings March 22, 2026 15:23
Copy link
Copy Markdown
Contributor

@sourcery-ai sourcery-ai bot left a comment

Choose a reason for hiding this comment

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

你好——我已经审查过你的改动,一切看起来都很棒!


Sourcery 对开源项目是免费的——如果你觉得我们的评审有帮助,欢迎分享 ✨
帮我变得更有用!请在每条评论上点 👍 或 👎,我会根据你的反馈改进后续评审。
Original comment in English

Hey - I've reviewed your changes and they look great!


Sourcery is free for open source - if you like our reviews please consider sharing them ✨
Help me be more useful! Please click 👍 or 👎 on each comment and I'll use the feedback to improve your reviews.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

此 PR 为 MapTrackerMove 增加“抵达最后目标点后对齐到最后一段路径方向”的能力,并在精细进近(fine approach)中引入基于角度变化的到达判据,以提升到达鲁棒性与相机朝向一致性。

Changes:

  • 新增 no_ensure_final_orientation 参数,用于控制是否跳过最终朝向校正,并在到达点逻辑中加入最终朝向对齐与中间点“预旋转”。
  • 调整精细进近的到达判据:除距离/时间外,新增“按旋转猜测到达”的分支。
  • 更新 MapTrackerMove 文档(中英),补充新参数与 map_name_match_rule 的说明结构。

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 7 comments.

File Description
docs/zh_cn/developers/map-tracker.md 增补 no_ensure_final_orientation 与重排/扩展 map_name_match_rule 文档说明
docs/en_us/developers/map-tracker.md 同步英文文档新增参数与 map_name_match_rule 的说明结构
agent/go-service/pkg/control/adaptor_win.go 调整 Windows 端相机旋转滑动时长,并修正 aggressive movement reset 后的内部状态
agent/go-service/map-tracker/move.go MapTrackerMove 增加最终朝向对齐/预旋转、精细进近角度到达判据、并重排参数校验逻辑

@isHarryh
Copy link
Copy Markdown
Member Author

急急急,合!

@isHarryh isHarryh merged commit fda81e8 into MaaEnd:v2 Mar 22, 2026
9 checks passed
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.

2 participants