Skip to content

docs: update quick start guide with architecture and packaging sections#1252

Merged
MistEO merged 7 commits intoMaaXYZ:mainfrom
NtskwK:docs/exe
Apr 18, 2026
Merged

docs: update quick start guide with architecture and packaging sections#1252
MistEO merged 7 commits intoMaaXYZ:mainfrom
NtskwK:docs/exe

Conversation

@NtskwK
Copy link
Copy Markdown
Contributor

@NtskwK NtskwK commented Apr 7, 2026

Summary by Sourcery

更新快速入门指南,为基于 MaaFramework 的项目添加高层架构背景和打包说明。

文档:

  • 在快速入门指南中添加 MaaFramework 项目架构概览以及各组件的角色说明。
  • 记录项目打包方案,包括社区项目模板 CI 工作流的使用方式,以及通用 UI 打包文档的参考说明。
Original summary in English

Summary by Sourcery

Update the Quick Start guide with high-level architecture context and packaging instructions for MaaFramework-based projects.

Documentation:

  • Add an overview of MaaFramework project architecture and component roles to the Quick Start guide.
  • Document project packaging options, including use of the community project template CI workflow and General UI packaging docs.

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.

Hey - 我在这里给出了一些整体性的反馈:

  • 请再次检查你新增的图片和链接路径(例如:/docs/static/architecture.png/README_en.md#general-ui)是否正确,并且与其他文档引用静态资源和 README 的方式保持一致(相对路径 vs 绝对路径),以确保它们在所有构建/部署环境中都能正确渲染。
给 AI 代理的提示
Please address the comments from this code review:

## Overall Comments
- Double-check the new image and link paths (e.g., `/docs/static/architecture.png`, `/README_en.md#general-ui`) are correct and consistent with how other docs reference static assets and the README (relative vs absolute paths) so they render properly in all build/deploy contexts.

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

Hey - I've left some high level feedback:

  • Double-check the new image and link paths (e.g., /docs/static/architecture.png, /README_en.md#general-ui) are correct and consistent with how other docs reference static assets and the README (relative vs absolute paths) so they render properly in all build/deploy contexts.
Prompt for AI Agents
Please address the comments from this code review:

## Overall Comments
- Double-check the new image and link paths (e.g., `/docs/static/architecture.png`, `/README_en.md#general-ui`) are correct and consistent with how other docs reference static assets and the README (relative vs absolute paths) so they render properly in all build/deploy contexts.

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.

Comment thread docs/zh_cn/1.1-快速开始.md Outdated
Comment thread docs/zh_cn/1.1-快速开始.md Outdated
@NtskwK
Copy link
Copy Markdown
Contributor Author

NtskwK commented Apr 12, 2026

@neko-para 修了

Comment thread docs/en_us/1.1-QuickStarted.md Outdated
Comment thread docs/zh_cn/1.1-快速开始.md Outdated
@@ -1,5 +1,13 @@
# 1.1 快速开始

一个基于 MaaFramework 开发项目通常包含`MaaFramework本体`、`UI`、`项目资源`、`agent`几个部分。其中,`项目资源`定义做什么,`本体`负责执行,`agent`用于扩展自定义逻辑,`UI`提供交互界面并通过[ProjectInterface协议](./3.3-ProjectInterfaceV2协议.md)读取资源和进行操作。
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.

项目资源定义具体业务逻辑 这样会不会好点?

Comment thread docs/zh_cn/1.1-快速开始.md Outdated
@@ -1,5 +1,13 @@
# 1.1 快速开始

一个基于 MaaFramework 开发项目通常包含`MaaFramework本体`、`UI`、`项目资源`、`agent`几个部分。其中,`项目资源`定义做什么,`本体`负责执行,`agent`用于扩展自定义逻辑,`UI`提供交互界面并通过[ProjectInterface协议](./3.3-ProjectInterfaceV2协议.md)读取资源和进行操作。
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

感觉不太对,一上来说这个,没接触过的小白更听不懂了,不要一上来就抛出一堆概念

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

那丢到1.2-术语解释?

@MistEO MistEO merged commit 5e1753b into MaaXYZ:main Apr 18, 2026
1 check 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.

3 participants