From 2f05950e923a760ca00b856092dd6c0ae56f3219 Mon Sep 17 00:00:00 2001 From: Ji Mao Cai <44921326+jinghero@users.noreply.github.com> Date: Thu, 5 Nov 2026 21:54:40 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=E5=85=BC=E5=AE=B9=E6=80=A7?= =?UTF-8?q?=E5=8F=8D=E9=A6=88=E5=85=A5=E5=8F=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/develop/adapt-game.md | 2 +- docs/develop/index.md | 2 +- docs/develop/overview.md | 2 +- docs/develop/package.md | 2 +- docs/develop/testing.md | 2 +- docs/en/develop/adapt-game.md | 2 +- docs/en/develop/index.md | 2 +- docs/en/develop/overview.md | 2 +- docs/en/develop/package.md | 2 +- docs/en/develop/testing.md | 2 +- docs/en/guide/feedback.md | 2 +- docs/guide/feedback.md | 2 +- 12 files changed, 12 insertions(+), 12 deletions(-) diff --git a/docs/develop/adapt-game.md b/docs/develop/adapt-game.md index 2a69b9e..ff4e784 100644 --- a/docs/develop/adapt-game.md +++ b/docs/develop/adapt-game.md @@ -54,7 +54,7 @@ ## 第五步：适配好以后 {#after} -- 在「兼容性报告」帖里记一笔：游戏、渠道、版本、怎么跑起来的、帧率大概多少。 +- 在 ModAVD 仓库的 [Issues](https://github.com/ModAVD/ModAVD/issues) 新开 issue，附上「复制配置信息.bat」的输出，记下游戏、渠道、版本、怎么跑起来的、帧率大概多少。 - 有自动化脚本、又有不耗资源的任务的，维护者会把它加进发版回归，并存下帧率基准。 ## 规矩 diff --git a/docs/develop/index.md b/docs/develop/index.md index 6e8071d..85a8280 100644 --- a/docs/develop/index.md +++ b/docs/develop/index.md @@ -9,7 +9,7 @@ ModAVD 只有一个维护者，回复可能要几天。大一点的改动请先 维护者只在一台 Windows 11、AMD CPU、NVIDIA 独显的电脑上测过。最缺这些配置的实测：Intel CPU，AMD 或 Intel 显卡，笔记本双显卡，Windows 10，16 GB 内存。 1. 照[安装](../guide/install)装好，在 AUTO-MAS 里添加，开机后跑一轮日常任务。 -2. 双击文件夹里的「复制配置信息.bat」（0.35.0 起包里有），把输出贴到 Issues 里置顶的「兼容性报告」帖，补完最后三行，再写一句能不能跑。 +2. 双击文件夹里的「复制配置信息.bat」（0.35.0 起包里有），在 ModAVD 仓库的 [Issues](https://github.com/ModAVD/ModAVD/issues) 新开 issue，附上输出，补完最后三行，再写一句能不能跑。 这份输出不带用户名、电脑名、完整路径和游戏账号，可以直接公开贴。详见[游戏实测和兼容性报告](./testing)。 diff --git a/docs/develop/overview.md b/docs/develop/overview.md index 5f55f90..fce6f67 100644 --- a/docs/develop/overview.md +++ b/docs/develop/overview.md @@ -16,7 +16,7 @@ ModAVD 是 AOSP Android Emulator 加一批补丁，WHPX 加速，gfxstream 渲 | 发版前回归（端到端测试） | [ModAVDE2E](https://github.com/ModAVD/ModAVDE2E) | PowerShell、Python | 中 | 语法解析、隐私扫描；回归本身不跑 | Sonnet 5.5 / GPT-6.1 Sol | | [文档和本站](./docs) | 本站仓库 [modavd.github.io](https://github.com/ModAVD/modavd.github.io)，各仓库的 README | Markdown | 低 | 编译站点、查死链、隐私扫描 | Sonnet 5.5 / GPT-6.1 Terra；机械改动用 Haiku 5.5 / GPT-6 Luna | | [AUTO-MAS 对接](./automas) | [AUTO-MAS](https://github.com/AUTO-MAS-Project/AUTO-MAS) | Python、前端 | 中 | 按 AUTO-MAS 自己的 CI | Sonnet 5.5 / GPT-6.1 Sol；审查用 Opus 5.5 / GPT-6 Astra | -| [游戏实测、兼容性报告](./testing) | 置顶的「兼容性报告」issue | — | 低到中 | 不能 | 看日志 Sonnet 5.5 / GPT-6.1 Terra；整理 Haiku 5.5 / GPT-6 Luna | +| [游戏实测、兼容性报告](./testing) | [新开 issue](https://github.com/ModAVD/ModAVD/issues)，附配置信息 | — | 低到中 | 不能 | 看日志 Sonnet 5.5 / GPT-6.1 Terra；整理 Haiku 5.5 / GPT-6 Luna | | [适配新游戏](./adapt-game)（起不来、跑不好） | 查清原因后落在执行桥、本体或自动化脚本 | 看原因 | 中到高 | 不能 | 分类看日志 Sonnet 5.5 / GPT-6.1 Sol；查转译层、图形的根因 Opus 5.5 / GPT-6 Astra | ## 所有分区都适用的要求 diff --git a/docs/develop/package.md b/docs/develop/package.md index 004ee97..fd290d4 100644 --- a/docs/develop/package.md +++ b/docs/develop/package.md @@ -6,7 +6,7 @@ | --- | --- | --- | | `补全组件.bat` → `fetch-components.ps1` | 先显示 Google《Android 软件开发套件许可协议》，同意后从官方渠道下载 adb 和系统镜像，校验 SHA-1 后装进 `sdk\`；能断点续传，镜像按顺序回落 | 37.2.10-mas30 | | `收集问题信息.bat` → `collect-info.ps1` | 在桌面生成问题包，见[反馈问题](../guide/feedback) | 37.2.10-mas30 | -| `复制配置信息.bat` → `report-config.ps1` | 把电脑配置和各实例装的游戏包整理成一段文字，复制到剪贴板，贴到「兼容性报告」帖 | 0.35.0 | +| `复制配置信息.bat` → `report-config.ps1` | 把电脑配置和各实例装的游戏包整理成一段文字，复制到剪贴板，在 [Issues](https://github.com/ModAVD/ModAVD/issues) 新开 issue 反馈时附上 | 0.35.0 | | `modavd-bridge.ps1` | 给一台实例装上、卸掉或核对 arm64 执行桥，见[开发：arm64 执行桥](./bridge#怎么装进实例) | 0.36.0 | ## 写法上的规矩 diff --git a/docs/develop/testing.md b/docs/develop/testing.md index 4483a1d..06c8304 100644 --- a/docs/develop/testing.md +++ b/docs/develop/testing.md @@ -5,7 +5,7 @@ 在你自己的电脑上照[安装](../guide/install)装好，在 AUTO-MAS 里跑一轮日常，然后： 1. 双击「复制配置信息.bat」； -2. 把输出贴到 ModAVD 仓库 Issues 里置顶的「兼容性报告」帖，补完最后三行； +2. 在 ModAVD 仓库的 [Issues](https://github.com/ModAVD/ModAVD/issues) 新开 issue，附上输出，补完最后三行； 3. 再写一句能不能跑。 最缺这些配置：Intel CPU、AMD 或 Intel 显卡、笔记本双显卡、Windows 10、16 GB 内存。兼容性报告最想要的反而是低配机器，只要满足[适用环境](../guide/#适用环境)就欢迎来测。 diff --git a/docs/en/develop/adapt-game.md b/docs/en/develop/adapt-game.md index f2f6171..97237ba 100644 --- a/docs/en/develop/adapt-game.md +++ b/docs/en/develop/adapt-game.md @@ -54,7 +54,7 @@ Try approaches that need no recompiling first, and settle the direction before y ## Step 5: After it works {#after} -- Add a note in the pinned "兼容性报告" (compatibility report) issue: the game, channel, version, how you got it running, and roughly what frame rate it gets. +- Open an issue in the [ModAVD repository](https://github.com/ModAVD/ModAVD/issues). Include the output of `复制配置信息.bat`, the game, channel, version, how you got it running, and roughly what frame rate it gets. - If the game has an automation script and tasks that do not use many resources, the maintainer will add it to the pre-release regression tests and record a frame-rate baseline. ## Rules diff --git a/docs/en/develop/index.md b/docs/en/develop/index.md index 1f84ac7..e2a30ab 100644 --- a/docs/en/develop/index.md +++ b/docs/en/develop/index.md @@ -9,7 +9,7 @@ To see what environment and hardware each area needs, and which models to pick w The maintainer has tested on only one computer: Windows 11, AMD CPU, NVIDIA discrete GPU. What is missing most is testing on these configurations: Intel CPU, AMD or Intel GPU, laptops with dual GPUs, Windows 10, and 16 GB of RAM. 1. Install by following [Installation](../guide/install), add the instance in AUTO-MAS, start it, and run one round of daily tasks. -2. Double-click `复制配置信息.bat` (copies your system and game info) in the folder (it is in the package from 0.35.0). Paste the output into the pinned "兼容性报告" (compatibility report) issue in Issues, fill in the last three lines, and add one sentence on whether it runs. +2. Double-click `复制配置信息.bat` (copies your system and game info) in the folder (it is in the package from 0.35.0). Open an issue in the [ModAVD repository](https://github.com/ModAVD/ModAVD/issues) and include the output. Fill in the last three lines and add one sentence on whether it runs. This output does not contain your user name, computer name, full paths or game accounts, so you can post it publicly as it is. For details, see [Testing on real games and compatibility reports](./testing). diff --git a/docs/en/develop/overview.md b/docs/en/develop/overview.md index 2b73f13..d2add6f 100644 --- a/docs/en/develop/overview.md +++ b/docs/en/develop/overview.md @@ -16,7 +16,7 @@ For how to take part (credit, licensing, how to submit), [Contributing to ModAVD | Pre-release regression tests (end-to-end tests) | [ModAVDE2E](https://github.com/ModAVD/ModAVDE2E) | PowerShell, Python | Medium | Syntax parsing, privacy scan; the regression run itself is not run | Sonnet 5.5 / GPT-6.1 Sol | | [Documentation and this site](./docs) | This site's repository [modavd.github.io](https://github.com/ModAVD/modavd.github.io), and the READMEs of the repositories | Markdown | Low | Builds the site, checks dead links, privacy scan | Sonnet 5.5 / GPT-6.1 Terra; Haiku 5.5 / GPT-6 Luna for mechanical changes | | [AUTO-MAS integration](./automas) | [AUTO-MAS](https://github.com/AUTO-MAS-Project/AUTO-MAS) | Python, front end | Medium | AUTO-MAS's own CI | Sonnet 5.5 / GPT-6.1 Sol; Opus 5.5 / GPT-6 Astra for review | -| [Testing on real games, compatibility reports](./testing) | The pinned "兼容性报告" (compatibility report) issue | — | Low to medium | Nothing | Sonnet 5.5 / GPT-6.1 Terra for reading logs; Haiku 5.5 / GPT-6 Luna for tidying up | +| [Testing on real games, compatibility reports](./testing) | [Open an issue](https://github.com/ModAVD/ModAVD/issues) with the configuration output | — | Low to medium | Nothing | Sonnet 5.5 / GPT-6.1 Terra for reading logs; Haiku 5.5 / GPT-6 Luna for tidying up | | [Making a new game work](./adapt-game) (won't start, runs poorly) | Once the cause is found, it ends up in the bridge, the emulator itself or the automation scripts | Depends on the cause | Medium to high | Nothing | Sonnet 5.5 / GPT-6.1 Sol for sorting logs; Opus 5.5 / GPT-6 Astra for root causes in the translation layer and graphics | ## Requirements for all areas diff --git a/docs/en/develop/package.md b/docs/en/develop/package.md index 2e4c78c..bd55e3d 100644 --- a/docs/en/develop/package.md +++ b/docs/en/develop/package.md @@ -6,7 +6,7 @@ | --- | --- | --- | | `补全组件.bat` (fetches the Google components) → `fetch-components.ps1` | First shows Google's Android Software Development Kit License Agreement. After you agree, it downloads adb and the system image from the official channels, checks the SHA-1 and installs them into `sdk\`. It can resume downloads and falls back to the next mirror in order | 37.2.10-mas30 | | `收集问题信息.bat` (collects a problem report) → `collect-info.ps1` | Makes a problem report on the desktop; see [Reporting problems](../guide/feedback) | 37.2.10-mas30 | -| `复制配置信息.bat` (copies your system and game info) → `report-config.ps1` | Puts the computer's configuration and the game packages installed in each instance into one block of text and copies it to the clipboard, to paste into the compatibility report issue | 0.35.0 | +| `复制配置信息.bat` (copies your system and game info) → `report-config.ps1` | Puts the computer's configuration and the game packages installed in each instance into one block of text and copies it to the clipboard, to include in a new issue in [Issues](https://github.com/ModAVD/ModAVD/issues) | 0.35.0 | | `modavd-bridge.ps1` | Installs, removes or checks the arm64 execution bridge on an instance; see [Development: arm64 execution bridge](./bridge#installing-into-an-instance) | 0.36.0 | ## Writing rules diff --git a/docs/en/develop/testing.md b/docs/en/develop/testing.md index 131a82e..90e382a 100644 --- a/docs/en/develop/testing.md +++ b/docs/en/develop/testing.md @@ -5,7 +5,7 @@ Install on your own computer by following [Installation](../guide/install), run one round of daily tasks in AUTO-MAS, and then: 1. Double-click `复制配置信息.bat` (copies your system and game info); -2. Paste the output into the pinned "兼容性报告" (compatibility report) issue in the Issues of the ModAVD repository, and fill in the last three lines; +2. Open an issue in the [ModAVD repository](https://github.com/ModAVD/ModAVD/issues), include the output, and fill in the last three lines; 3. Add one sentence on whether it runs. These configurations are missing most: Intel CPU, AMD or Intel GPU, laptops with dual GPUs, Windows 10, and 16 GB of RAM. For compatibility reports, low-end machines are in fact the most wanted. As long as you meet the [requirements](../guide/#requirements), you are welcome to test. diff --git a/docs/en/guide/feedback.md b/docs/en/guide/feedback.md index 86d1875..93a74c0 100644 --- a/docs/en/guide/feedback.md +++ b/docs/en/guide/feedback.md @@ -51,4 +51,4 @@ When `补全组件.bat` (fetches the Google components) fails, attaching `logs\f ## Tell us when it works, too -If a round of daily tasks runs through on your computer, double-click `复制配置信息.bat` (copies your system and game info), paste the output into the pinned "兼容性报告" (compatibility report) issue in Issues, fill in the last three lines, and add a sentence saying whether it works. This output has no user name, computer name, full paths or game accounts, so you can post it publicly as it is. See [Testing on real games and compatibility reports](../develop/testing). +If a round of daily tasks runs through on your computer, double-click `复制配置信息.bat` (copies your system and game info). Open an issue in the [ModAVD repository](https://github.com/ModAVD/ModAVD/issues) and include the output. Fill in the last three lines and add a sentence saying whether it works. This output has no user name, computer name, full paths or game accounts, so you can post it publicly as it is. See [Testing on real games and compatibility reports](../develop/testing). diff --git a/docs/guide/feedback.md b/docs/guide/feedback.md index 5472c53..884b043 100644 --- a/docs/guide/feedback.md +++ b/docs/guide/feedback.md @@ -51,4 +51,4 @@ ## 能跑起来也欢迎说一声 -在你的电脑上跑通了一轮日常的话，双击「复制配置信息.bat」，把输出贴到 Issues 里置顶的「兼容性报告」帖，补完最后三行，再写一句能不能跑。这份输出不带用户名、电脑名、完整路径和游戏账号，可以直接公开贴。见[游戏实测和兼容性报告](../develop/testing)。 +在你的电脑上跑通了一轮日常的话，双击「复制配置信息.bat」，在 ModAVD 仓库的 [Issues](https://github.com/ModAVD/ModAVD/issues) 新开 issue，附上输出，补完最后三行，再写一句能不能跑。这份输出不带用户名、电脑名、完整路径和游戏账号，可以直接公开贴。见[游戏实测和兼容性报告](../develop/testing)。