create-maa-project 3.7.0__tar.gz → 3.7.2__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (204) hide show
  1. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.release/create-maa-project-manifest.json +24 -24
  2. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/CHANGELOG.md +48 -2
  3. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/PKG-INFO +1 -1
  4. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/commands.en.md +23 -2
  5. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/commands.md +20 -3
  6. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/package.json +1 -1
  7. create_maa_project-3.7.2/py-wrapper/create_maa_project/__init__.py +1 -0
  8. create_maa_project-3.7.2/py-wrapper/create_maa_project/release_manifest.py +2 -0
  9. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/pyproject.toml +1 -1
  10. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/skills/create-maa-project/references/commands.md +16 -1
  11. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/android.ts +10 -0
  12. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/assets.ts +64 -14
  13. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/doctor.ts +6 -2
  14. create_maa_project-3.7.2/src/maafw-version.ts +25 -0
  15. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/scaffold.ts +28 -4
  16. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/templates.ts +47 -9
  17. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/update.ts +95 -3
  18. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/.github/workflows/android-build.yml +21 -0
  19. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/Android/README.md +1 -0
  20. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/tools/android-packaging.mjs +65 -22
  21. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/github/.github/workflows/release.yml +8 -0
  22. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/interface.schema.json +32 -0
  23. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/interface_import.schema.json +32 -0
  24. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/schema-manifest.json +2 -2
  25. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/android-addon.test.ts +109 -1
  26. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/android-packaging.test.ts +60 -0
  27. create_maa_project-3.7.2/tests/maafw-version.test.ts +15 -0
  28. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/scaffold.test.ts +173 -0
  29. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/templates.test.ts +47 -0
  30. create_maa_project-3.7.0/py-wrapper/create_maa_project/__init__.py +0 -1
  31. create_maa_project-3.7.0/py-wrapper/create_maa_project/release_manifest.py +0 -2
  32. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.editorconfig +0 -0
  33. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.gitattributes +0 -0
  34. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/cliff.toml +0 -0
  35. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/ci.yml +0 -0
  36. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/deps-audit.yml +0 -0
  37. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/deps-sync.yml +0 -0
  38. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/network-assets.yml +0 -0
  39. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/release.yml +0 -0
  40. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.github/workflows/schema-sync.yml +0 -0
  41. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.gitignore +0 -0
  42. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.prettierignore +0 -0
  43. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/.prettierrc.mjs +0 -0
  44. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/AGENTS.md +0 -0
  45. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/LICENSE +0 -0
  46. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/README.en.md +0 -0
  47. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/README.md +0 -0
  48. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/RELEASING.md +0 -0
  49. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/android-packaging-plan.md +0 -0
  50. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/json-report.en.md +0 -0
  51. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/json-report.md +0 -0
  52. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/mcp.en.md +0 -0
  53. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/docs/mcp.md +0 -0
  54. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/pnpm-lock.yaml +0 -0
  55. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/pnpm-workspace.yaml +0 -0
  56. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/py-wrapper/create_maa_project/__main__.py +0 -0
  57. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/build-sea.mjs +0 -0
  58. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/build.mjs +0 -0
  59. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/changelog-notes.mjs +0 -0
  60. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/check-network-assets.ts +0 -0
  61. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/create-release-manifest.mjs +0 -0
  62. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/create-sbom.d.mts +0 -0
  63. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/create-sbom.mjs +0 -0
  64. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/prepare-pypi-release.mjs +0 -0
  65. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/smoke-cli-artifact.mjs +0 -0
  66. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/sync-release-version.mjs +0 -0
  67. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/sync-schema.mjs +0 -0
  68. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/sync-template-deps.ts +0 -0
  69. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/test-python.mjs +0 -0
  70. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/scripts/update-audit-overrides.ts +0 -0
  71. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/skills/README.md +0 -0
  72. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/skills/create-maa-project/SKILL.md +0 -0
  73. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/skills/create-maa-project/agents/openai.yaml +0 -0
  74. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/skills/create-maa-project/references/json-report.md +0 -0
  75. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/addons.ts +0 -0
  76. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/args.ts +0 -0
  77. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/auto-update.ts +0 -0
  78. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/command.ts +0 -0
  79. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/controllers.ts +0 -0
  80. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/features.ts +0 -0
  81. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/incremental-addons.ts +0 -0
  82. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/index.ts +0 -0
  83. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/lang.ts +0 -0
  84. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/log.ts +0 -0
  85. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/mcp.ts +0 -0
  86. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/node-support.ts +0 -0
  87. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/project-config.ts +0 -0
  88. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/project.ts +0 -0
  89. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/prompt.ts +0 -0
  90. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/report.ts +0 -0
  91. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/semver.ts +0 -0
  92. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/sync.ts +0 -0
  93. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/template-deps.json +0 -0
  94. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/template-deps.ts +0 -0
  95. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/types.ts +0 -0
  96. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/update-targets.ts +0 -0
  97. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/utils.ts +0 -0
  98. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/src/version.ts +0 -0
  99. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/.github/workflows/android.yml +0 -0
  100. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/Android/profile.agent.yaml +0 -0
  101. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/android/Android/profile.pipeline.yaml +0 -0
  102. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/auto-format/.github/workflows/format.yml +0 -0
  103. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/CONTRIBUTING.md +0 -0
  104. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/PULL_REQUEST_TEMPLATE.md +0 -0
  105. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/bug_report.yml +0 -0
  106. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/feature_request.yml +0 -0
  107. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/issue_config.yml +0 -0
  108. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/community/other_issue.yml +0 -0
  109. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dependabot/.github/dependabot.yml +0 -0
  110. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/extensions.agent.json +0 -0
  111. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/extensions.json +0 -0
  112. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/launch.agent.json +0 -0
  113. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/settings.agent.json +0 -0
  114. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/settings.json +0 -0
  115. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/tasks.agent.json +0 -0
  116. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/.vscode/tasks.json +0 -0
  117. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/package.json +0 -0
  118. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/pnpm-workspace.yaml +0 -0
  119. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/dev-tools/tools/validate-schema.mjs +0 -0
  120. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/git-cliff/.github/cliff.toml +0 -0
  121. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/github/.github/workflows/check.yml +0 -0
  122. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/github/.github/workflows/package-smoke.yml +0 -0
  123. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/github/tools/build-release.mjs +0 -0
  124. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/github/tools/sync-runtime.mjs +0 -0
  125. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/optimize-images/.github/workflows/optimize-images.yml +0 -0
  126. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/optimize-images/tools/optimize-images.mjs +0 -0
  127. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/schema-sync/.github/workflows/schema-sync.yml +0 -0
  128. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/addons/schema-sync/tools/sync-schema.mjs +0 -0
  129. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/README.en.md +0 -0
  130. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/README.md +0 -0
  131. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/__init__.py +0 -0
  132. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/agent_runtime.py +0 -0
  133. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/__init__.py +0 -0
  134. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/action/__init__.py +0 -0
  135. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/action/general.py +0 -0
  136. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/reco/__init__.py +0 -0
  137. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/reco/general.py +0 -0
  138. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/custom/sink/__init__.py +0 -0
  139. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/maafw_paths.py +0 -0
  140. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/main.py +0 -0
  141. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/__init__.py +0 -0
  142. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/logger.py +0 -0
  143. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/maa_types.py +0 -0
  144. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/params.py +0 -0
  145. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/pienv.py +0 -0
  146. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/agent/utils/runtime_paths.py +0 -0
  147. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/pyproject.toml +0 -0
  148. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/requirements.in +0 -0
  149. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/requirements.txt +0 -0
  150. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/tools/schema/custom.action.schema.json +0 -0
  151. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/tools/schema/custom.recognition.schema.json +0 -0
  152. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/agent/uv.lock +0 -0
  153. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/.editorconfig +0 -0
  154. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/.gitattributes +0 -0
  155. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/.gitignore +0 -0
  156. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/.prettierignore +0 -0
  157. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/.prettierrc.mjs +0 -0
  158. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/README.en.md +0 -0
  159. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/README.md +0 -0
  160. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/gitignore.tmpl +0 -0
  161. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/interface.json.tmpl +0 -0
  162. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/licenses/AGPL-3.0-or-later.txt +0 -0
  163. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/licenses/MIT.txt +0 -0
  164. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/maatools.config.mts +0 -0
  165. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/resource/base/default_pipeline.json +0 -0
  166. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/resource/base/image/empty.png +0 -0
  167. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/resource/base/model/ocr/manifest.json +0 -0
  168. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/resource/base/pipeline/Tutorial/Tutorial.json +0 -0
  169. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tasks/tutorial.json +0 -0
  170. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/custom.action.schema.json +0 -0
  171. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/custom.recognition.schema.json +0 -0
  172. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/interface_config.schema.json +0 -0
  173. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/templates/base/tools/schema/pipeline.schema.json +0 -0
  174. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/addons.test.ts +0 -0
  175. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/args.test.ts +0 -0
  176. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/auto-update.test.ts +0 -0
  177. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/backup-operations.test.ts +0 -0
  178. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/changelog-notes.test.ts +0 -0
  179. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/child-env.ts +0 -0
  180. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/cli-info.test.ts +0 -0
  181. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/command.test.ts +0 -0
  182. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/doctor-errors.test.ts +0 -0
  183. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/enabled-config.test.ts +0 -0
  184. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/git-initialization.test.ts +0 -0
  185. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/incremental-addons-results.test.ts +0 -0
  186. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/lang.test.ts +0 -0
  187. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/mcp.test.ts +0 -0
  188. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/node-support.test.ts +0 -0
  189. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/ocr-git-registration.test.ts +0 -0
  190. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/package-smoke-workflow.test.ts +0 -0
  191. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/project-config.test.ts +0 -0
  192. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/project.test.ts +0 -0
  193. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/prompt-interactive.test.ts +0 -0
  194. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/prompt.test.ts +0 -0
  195. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/release-smoke.test.ts +0 -0
  196. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/release-workflow.test.ts +0 -0
  197. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/report.test.ts +0 -0
  198. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/sbom.test.ts +0 -0
  199. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/semver.test.ts +0 -0
  200. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/template-deps.test.ts +0 -0
  201. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/test_py_wrapper.py +0 -0
  202. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tests/update-audit-overrides.test.ts +0 -0
  203. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/tsconfig.json +0 -0
  204. {create_maa_project-3.7.0 → create_maa_project-3.7.2}/vitest.config.ts +0 -0
@@ -1,68 +1,68 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "create-maa-project",
4
- "version": "3.7.0",
5
- "tag": "v3.7.0",
4
+ "version": "3.7.2",
5
+ "tag": "v3.7.2",
6
6
  "assets": [
7
7
  {
8
8
  "kind": "sea",
9
9
  "os": "linux",
10
10
  "arch": "aarch64",
11
- "version": "3.7.0",
11
+ "version": "3.7.2",
12
12
  "name": "create-maa-project-linux-aarch64",
13
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-linux-aarch64",
14
- "sha256": "9fa6bd10497d228545a91d29cba77150a7037014b840117ab75049942be25885",
13
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-linux-aarch64",
14
+ "sha256": "433692fa3a105fcf692d861a531ab6883aa6040b13e6da62d2675f9e70c836d1",
15
15
  "size": 124587136
16
16
  },
17
17
  {
18
18
  "kind": "sea",
19
19
  "os": "linux",
20
20
  "arch": "x86_64",
21
- "version": "3.7.0",
21
+ "version": "3.7.2",
22
22
  "name": "create-maa-project-linux-x86_64",
23
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-linux-x86_64",
24
- "sha256": "8419c05d158206668aaf86e9b734575453e2c92729d28ca49d2744311dec02ff",
23
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-linux-x86_64",
24
+ "sha256": "b35dc29a502e6b9120dd855f6225c1d4037825fcf293b41b515444b76171739a",
25
25
  "size": 128257216
26
26
  },
27
27
  {
28
28
  "kind": "sea",
29
29
  "os": "macos",
30
30
  "arch": "aarch64",
31
- "version": "3.7.0",
31
+ "version": "3.7.2",
32
32
  "name": "create-maa-project-macos-aarch64",
33
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-macos-aarch64",
34
- "sha256": "f63ec28a48295c017986c94a2df2a435c78999d63da99ad4824f1707a0f94e26",
35
- "size": 122589888
33
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-macos-aarch64",
34
+ "sha256": "0eb3aea3b1981f3419ec3fe606ce6eb3cbf47da24dd21186317b2f9ad76803ea",
35
+ "size": 122822656
36
36
  },
37
37
  {
38
38
  "kind": "sea",
39
39
  "os": "macos",
40
40
  "arch": "x86_64",
41
- "version": "3.7.0",
41
+ "version": "3.7.2",
42
42
  "name": "create-maa-project-macos-x86_64",
43
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-macos-x86_64",
44
- "sha256": "30e0f68d2a92756cfc005121e0cf0dfe82c0c19e5ee6d3f7feec4538da3bb2fa",
45
- "size": 125074384
43
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-macos-x86_64",
44
+ "sha256": "abdebfaafeeb16a621689a3964bbee4de2eccc987bcfdc36a67a707961126534",
45
+ "size": 125090896
46
46
  },
47
47
  {
48
48
  "kind": "sea",
49
49
  "os": "win",
50
50
  "arch": "aarch64",
51
- "version": "3.7.0",
51
+ "version": "3.7.2",
52
52
  "name": "create-maa-project-win-aarch64.exe",
53
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-win-aarch64.exe",
54
- "sha256": "e7c54ec6f7fe359994af24bcd8793964bb3fc10a57a082a48d3aa18f701743f9",
55
- "size": 83627008
53
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-win-aarch64.exe",
54
+ "sha256": "e2ddc3979c51a3542799cd6978ccd03db18646cf1f8ec157636a6a51d0983f7a",
55
+ "size": 83642880
56
56
  },
57
57
  {
58
58
  "kind": "sea",
59
59
  "os": "win",
60
60
  "arch": "x86_64",
61
- "version": "3.7.0",
61
+ "version": "3.7.2",
62
62
  "name": "create-maa-project-win-x86_64.exe",
63
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.0/create-maa-project-win-x86_64.exe",
64
- "sha256": "7f51e059fccd5e9b14a403d06d47aa91a38ab701bbadc7db795e1d88a2fc0cad",
65
- "size": 95325696
63
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.2/create-maa-project-win-x86_64.exe",
64
+ "sha256": "d5aef836ced86c71bc8bf5c0d9b98aea37bf21c76f8bcc735f2ce41970acb87f",
65
+ "size": 95341568
66
66
  }
67
67
  ]
68
68
  }
@@ -2,6 +2,52 @@
2
2
 
3
3
  create-maa-project 的重要更改记录。格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/),版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
4
4
 
5
+ ## [3.7.2] - 2026-10-17
6
+
7
+ ### 修复
8
+
9
+ - Android 的 beta 配对现在能真正匹配上。预发布版本在三个地方拼写不同:`requirements.txt` 是 uv 导出的
10
+ PEP 440 归一形式(`maafw==5.15.0b1`),内核 tag 是发布原文(`3.13.15-maafw5.15.0-beta.1`),
11
+ MaaFramework release tag 是 `v5.15.0-beta.1`。resolver 的配对正则原先不认 `-`,`5.15.0b1` 会被判成
12
+ "内核还没发配对"而降级回上一个正式版;现在 tag 解析放行预发布后缀,配对、`AGENT_CORE_TAG` 校验以及
13
+ `maa-project.json` / `requirements.txt` 的一致性比较都先按 PEP 440 归一再比,`maafw_tag` 取 release
14
+ 的真实拼写而不是 `v` 加归一版本。`--doctor` 的 android 钉版检查同样归一后再比,`maafw.version` 写
15
+ `5.15.0b1` 或 `5.15.0-beta.1` 不再互相误报。桌面侧 `--update maafw` 把 `maafw.version` 当 tag 查时,
16
+ 归一形式查不到会补试发布拼写(`5.15.0b1` → `v5.15.0-beta.1`)
17
+
18
+ ### 变更
19
+
20
+ - `--update python-deps` 成为 android 项目的版本对齐点。启用 `android` 的 Agent 项目里,它先确定
21
+ MaaFramework 目标版本(`maa-project.json` 的精确 `maafw.version` 优先,为空则按 `maafw.channel` 解析
22
+ 最新发布,`beta` / `alpha` 含预发布),把 `maafw==X` 钉进 `pyproject.toml` 后再 `uv lock` /
23
+ `uv export`,最后校验 `requirements.txt` 导出的是同一版本(PEP 440 归一后比较),不一致直接报错。
24
+ 没有 `android` 的 Agent 项目保持原行为:`maafw` 浮动,由 uv 与 Dependabot 的 `lockfile-only` 更新
25
+ 驱动,不会和自动更新打架。`--add android` 现在也会改写已有的 `maafw` 钉版(原来只填未钉版的依赖),
26
+ `maafw.version` 改了重跑即可
27
+ - 发版 workflow 自己重导 Python 依赖。Dependabot 的 `uv` 更新只动 `uv.lock`,而桌面包与 APK 都从
28
+ `requirements.txt` 装依赖;现在 `release.yml` 在 `pnpm sync:runtime` 之前、`android-build.yml` 在两个
29
+ job 的 `tools/android-packaging.mjs` 之前都会先跑 `uv export --frozen`,从 lock 重新导出工作区里的
30
+ `requirements.txt`。合并 Dependabot 的 uv PR 后不必再手工跑 `--update python-deps` 才能发版;仓库里
31
+ 那份仍是提交物,本地开发想更新时再跑。`--frozen` 在 `pyproject.toml` 与 `uv.lock` 不一致时直接失败,
32
+ 不会悄悄用旧 lock
33
+
34
+ 已有项目:`tools/android-packaging.mjs` 是受管文件,重跑 `create-maa-project --add android` 即更新。
35
+ 要出 beta 包不用再手改 `pyproject.toml`:把 `maa-project.json` 的 `maafw.channel` 改成 `beta`(或把
36
+ `maafw.version` 写成精确版本)后跑一次 `--update python-deps`,它会自己把 `maafw==5.15.0-beta.1` 钉进
37
+ `pyproject.toml`、导出 `requirements.txt`,内核已有 `3.13.15-maafw5.15.0-beta.1` 配对时 APK 就会用它。
38
+
39
+ [3.7.2]: https://github.com/Windsland52/create-maa-project/compare/v3.7.1...v3.7.2
40
+
41
+ ## [3.7.1] - 2026-10-13
42
+
43
+ ### 修复
44
+
45
+ - Android 的 Agent 项目不再因为 vendored 外壳而红。`release.yml` 以 `submodules` 检出子模块,`ruff check .` 会一路扫进 `Android/MaaFwApp/scripts/*.py`,撞上上游脚本的 UTF-8 编码声明(`UP009`)——6 个桌面 `package` job 全挂在 `pnpm check:py`,`release` job 随之 skipped;同一个 commit 上 `check.yml`(不检子模块)反而是绿的。现在 Agent 项目的 `pyproject.toml` 在 `[tool.ruff]` 里带上 `extend-exclude = ["Android/MaaFwApp"]`(用 `extend-exclude` 而不是重写整个文件:`pyproject.toml` 还装着项目自己的 `[project].dependencies`)。启用 `android` 时创建即写入,`--add android` 与重跑 `--add agent` 也会把这行插进项目已有的 `pyproject.toml`;没启用 `android` 的项目逐字节不变
46
+
47
+ 已有项目:跑一次 `create-maa-project --add android`(或 `--add agent`)即补上这行,`--update` 的 8 个目标都不刷新 `pyproject.toml`。手工加等价:在 `[tool.ruff]` 里写 `extend-exclude = ["Android/MaaFwApp"]`。
48
+
49
+ [3.7.1]: https://github.com/Windsland52/create-maa-project/compare/v3.7.0...v3.7.1
50
+
5
51
  ## [3.7.0] - 2026-10-12
6
52
 
7
53
  ### 新增
@@ -17,7 +63,7 @@ create-maa-project 的重要更改记录。格式参考 [Keep a Changelog](https
17
63
 
18
64
  - agent 的多行日志不再丢内容。MFAAvalonia 逐行解析 agent 输出、只认带 level 前缀的行,多行消息的第二行起会被丢进 GUI 内部日志;现在逐行补前缀,并丢掉结尾换行造成的空尾行。loguru 与标准 logging 两条控制台路径合并到唯一渲染分支(`_CONSOLE_FORMAT` 走字段值,避免 callable format 的返回值被再当格式串去解析颜色标记),文件 sink 不再挂控制台 filter;MXU 侧补上转义白名单还原,只放行 `<font color="#RRGGBB">`、其余内容保持转义。`agent/utils/logger.py` 现将与上游 M9A 该版本逐字节一致
19
65
 
20
- 已有项目:`android` 是独立 add-on,要用就执行 `create-maa-project --add android`——它会浅克隆外壳,克隆失败不阻断创建,只登记 `android-submodule` pending 与恢复命令。Agent 项目按上一条把 `maafw.version` 写成精确版本再 `--update python-deps`,否则会一直挂着 `android-version` pending。logger 修复在受管文件里,执行 `create-maa-project --update` 即可获得;tutorial 路径变更不用处理。
66
+ 已有项目:`android` 是独立 add-on,要用就执行 `create-maa-project --add android`——它会浅克隆外壳,克隆失败不阻断创建,只登记 `android-submodule` pending 与恢复命令。Agent 项目按上一条把 `maafw.version` 写成精确版本再 `--update python-deps`,否则会一直挂着 `android-version` pending。logger 修复在受管文件里,重跑 `create-maa-project --add agent` 即可获得(与模板不一致的受管文件会整体重写,手改过先确认;`--update` 的 8 个目标都不刷新 agent 文件);tutorial 路径变更不用处理。
21
67
 
22
68
  [3.7.0]: https://github.com/Windsland52/create-maa-project/compare/v3.6.3...v3.7.0
23
69
 
@@ -27,7 +73,7 @@ create-maa-project 的重要更改记录。格式参考 [Keep a Changelog](https
27
73
 
28
74
  - 发布构建新增 welcome 公告文件的校验与打包。PI 2.10 的 welcome 协议里 `interface.json` 的 `welcome` 条目是 `$Key`,公告 markdown 的真实路径由各语言的翻译文件解析,既有的 resource / import / languages 校验列表都看不到这些文件——发布脚本漏带公告目录时包是静默缺内容的,用户侧表现为 GUI 欢迎页空白。现在 `$Key` 条目会经**全部**语言文件解析成文件路径(每种语言文件名不同、中文文件名均支持),字面量条目直接透传,带 scheme 的远程公告 URL 不是仓库文件、跳过;仓库预检与打包 smoke 都会校验解析出的公告文件存在,缺失则构建失败而不是发坏包;项目存在 `announcement/` 目录时整目录随包(含被公告引用的 `images/` 等子目录,条件包含、不强制建目录)
29
75
 
30
- 已有项目:`tools/build-release.mjs` 为受管文件,执行 `create-maa-project --update` 即可获得该行为;公告不在 `announcement/` 目录的项目把 `releasePackagePaths` 里的目录名改成实际目录即可。
76
+ 已有项目:`tools/build-release.mjs` 为受管文件,重跑 `create-maa-project --add github` 即可获得该行为(`--update` 的目标里没有 github);公告不在 `announcement/` 目录的项目把 `releasePackagePaths` 里的目录名改成实际目录即可。
31
77
 
32
78
  [3.6.3]: https://github.com/Windsland52/create-maa-project/compare/v3.6.2...v3.6.3
33
79
 
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: create-maa-project
3
- Version: 3.7.0
3
+ Version: 3.7.2
4
4
  Summary: 用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects
5
5
  Project-URL: Homepage, https://github.com/Windsland52/create-maa-project
6
6
  Project-URL: Source, https://github.com/Windsland52/create-maa-project
@@ -137,14 +137,22 @@ the files:
137
137
  does not fail creation; it records an `android-submodule` pending action whose command is
138
138
  `git submodule add -b main …`.
139
139
  - `.gitignore` gains `Android/agent-dist/`: the agent runtime is a build artifact.
140
+ - `pyproject.toml` gains `extend-exclude = ["Android/MaaFwApp"]` under `[tool.ruff]` (**Agent
141
+ projects**): `release.yml` checks submodules out, so an unscoped `ruff check .` reads the shell's own
142
+ `scripts/*.py`, trips `UP009`, and fails `pnpm check:py` in every `package` job — which is what keeps
143
+ the release from being created.
140
144
  - An **Agent** project also needs an exact `maafw==X` in `requirements.txt`: the Android Python binding
141
145
  only ships inside the MaaAgentCoreAndroid kernel release (`X-maafwY` tags), which is what pairs the
142
146
  kernel with the native libraries inside the APK. Without it the add-on records an `android-version`
143
147
  pending action. When `maa-project.json` carries an exact `maafw.version`, `--add android` pins
144
- `pyproject.toml` to it as well, and `--update python-deps` exports that pin to `requirements.txt`.
148
+ `pyproject.toml` to it as well; when it is empty, `--update python-deps` resolves `maafw.channel`
149
+ and pins that version instead. Either way `--update python-deps` exports the pin to `requirements.txt`.
145
150
  When upstream ships a patch release before the kernel catches up, CI degrades to the highest pairing
146
151
  at or below the pin and prints a `::warning::` (the APK stays internally consistent, it is just older
147
- than the pin); only a pin older than every kernel pairing is an error.
152
+ than the pin); only a pin older than every kernel pairing is an error. Pre-releases pair too: kernel
153
+ and release tags keep the released spelling (`3.13.15-maafw5.15.0-beta.1`, `v5.15.0-beta.1`) while
154
+ `requirements.txt` carries the PEP 440-normalized form `uv export` produces (`5.15.0b1`); the resolver
155
+ and `--doctor` compare normalized versions, and `maafw.version` accepts either spelling.
148
156
  - Native Python packages (the ones carrying `.so` files) are probed per package against the Chaquopy
149
157
  index, and the resolver emits the downgrade arguments: a desktop pin with no build for the kernel
150
158
  CPython is pinned to the highest version the index has, a package the index does not carry at all is
@@ -237,6 +245,19 @@ leaves local runs working while the built package ships without the new dependen
237
245
  dependency change, commit `pyproject.toml`, `uv.lock`, `requirements.in`, and `requirements.txt`
238
246
  together.
239
247
 
248
+ For an Agent project with the `android` add-on, `--update python-deps` also reconciles the
249
+ MaaFramework version: the target is an exact `maafw.version` from `maa-project.json`, or the newest
250
+ release of `maafw.channel` (`beta` / `alpha` include prereleases) when that is empty. It pins
251
+ `maafw==X` into `pyproject.toml` before `uv lock` / `uv export`, then verifies the exported
252
+ `requirements.txt` still carries the same version (compared after PEP 440 normalization) and fails
253
+ instead of letting the APK and the desktop package use different frameworks. Agent projects without
254
+ the `android` add-on are untouched: `maafw` stays floating, so uv and Dependabot's `lockfile-only`
255
+ updates own the version. The release workflows (`release.yml` for desktop and `android-build.yml` for
256
+ APKs) re-export `requirements.txt` from `uv.lock` with `uv export --frozen` before packaging, so a
257
+ merged Dependabot uv PR needs no manual re-export; `--update python-deps` only keeps the committed
258
+ file current for local development. `--frozen` fails when `pyproject.toml` and `uv.lock` disagree
259
+ instead of silently exporting the old lock.
260
+
240
261
  `--update python-runtime` takes its platform from `CREATE_MAA_PROJECT_RUNTIME_PLATFORM=<os>-<arch>`
241
262
  (one platform per run), downloads the embedded interpreter into
242
263
  `.create-maa-project/runtime/python/<platform>`, and reinstalls from `requirements.txt`; after a
@@ -118,12 +118,19 @@ dev-tools 的产物(Prettier formatter、`tools/schema/*`、`pnpm install`)
118
118
  `submodules: recursive` 检出,缺任一项就只能拿到空目录)。克隆失败**不阻断**创建,登记
119
119
  `android-submodule` pending,命令是 `git submodule add -b main …`。
120
120
  - `.gitignore` 追加 `Android/agent-dist/`(agent 运行时是构建产物,不入库)。
121
+ - `pyproject.toml` 的 `[tool.ruff]` 追加 `extend-exclude = ["Android/MaaFwApp"]`(**Agent 项目**):
122
+ `release.yml` 以 `submodules` 检出子模块,不排除的话 `ruff check .` 会扫进外壳自带的
123
+ `scripts/*.py` 并命中 `UP009`,`pnpm check:py` 在 6 个 `package` job 里一起失败、Release 因此不创建。
121
124
  - **Agent 项目**需要 `requirements.txt` 里的精确 `maafw==X`:Android 的 Python 绑定只随内核
122
125
  (`MaaAgentCoreAndroid` 的 `X-maafwY` tag)发布,CI 按它配对内核与 APK 内的原生库。拿不到精确版本时
123
126
  登记 `android-version` pending;`maa-project.json` 的 `maafw.version` 填了精确版本时,`--add android`
124
- 会把 `pyproject.toml` 的 `maafw` 一并钉住,再跑 `--update python-deps` 让 uv 把钉版导出到
125
- `requirements.txt`。上游发了补丁版而内核还没跟上时,CI 会降级到不高于固定版本的最高配对并打
126
- `::warning::`(APK 内仍是同版本,只是比 requirements 固定得旧);固定版本比内核所有配对都旧才报错。
127
+ 会把 `pyproject.toml` 的 `maafw` 一并钉住;为空时由 `--update python-deps` 按 `maafw.channel` 解析并
128
+ 钉住。两条路径都靠 `--update python-deps` 把钉版导出到 `requirements.txt`。上游发了补丁版而内核还没
129
+ 跟上时,CI 会降级到不高于固定版本的最高配对并打 `::warning::`(APK 内仍是同版本,只是比 requirements
130
+ 固定得旧);固定版本比内核所有配对都旧才报错。
131
+ 预发布版本同样能配对:内核 tag 与 release tag 用发布原文(`3.13.15-maafw5.15.0-beta.1`、
132
+ `v5.15.0-beta.1`),`requirements.txt` 里是 uv 导出的归一形式(`5.15.0b1`),resolver 与 `--doctor`
133
+ 都先按 PEP 440 归一再比较,`maa-project.json` 的 `maafw.version` 写哪种拼写都能匹配。
127
134
  - 带 `.so` 的原生 Python 包由 resolver 按 Chaquopy 索引**逐包探测**后给出降级参数:桌面 pin 在索引上
128
135
  没有当前 CPython 的构建就钉到索引最高可用版,索引上没有该包(纯 Python)不钉,索引有构建但没有
129
136
  当前 CPython 时 CI 直接报错,而不是让 pip 在构建中途失败。
@@ -192,6 +199,16 @@ Agent 项目的 Python 依赖是一条两级链路,改依赖时两步都要走
192
199
  包里没有新依赖。每次改完依赖,把 `pyproject.toml`、`uv.lock`、`requirements.in`、`requirements.txt`
193
200
  一起提交。
194
201
 
202
+ 对启用 `android` 的 Agent 项目,`--update python-deps` 还负责对齐 MaaFramework 版本:目标取
203
+ `maa-project.json` 的精确 `maafw.version`,为空则按 `maafw.channel` 解析最新发布(`beta` / `alpha`
204
+ 含预发布),先把该版本钉进 `pyproject.toml` 的 `maafw==X` 再 `uv lock` / `uv export`,最后校验导出的
205
+ `requirements.txt` 仍是同一版本(按 PEP 440 归一后比较,不一致直接报错,不让 APK 与桌面资产各用一套)。
206
+ 没有 `android` 的 Agent 项目不受影响:`maafw` 保持浮动,由 uv 与 Dependabot 的 `lockfile-only` 更新驱动。
207
+ 发版 workflow(桌面 `release.yml` 与 Android 的 `android-build.yml`)在打包前会用 `uv export --frozen`
208
+ 从 `uv.lock` 重新导出 `requirements.txt`,所以合并 Dependabot 的 uv PR 后不用手工重导;`--update
209
+ python-deps` 只负责把仓库里那份文件同步到最新(本地开发与提交用)。`--frozen` 会在 `pyproject.toml` 与
210
+ `uv.lock` 不一致时直接失败,而不是悄悄用旧 lock。
211
+
195
212
  `--update python-runtime` 用 `CREATE_MAA_PROJECT_RUNTIME_PLATFORM=<os>-<arch>` 指定平台(一次一个),
196
213
  把内嵌解释器下载到 `.create-maa-project/runtime/python/<platform>`,并按 `requirements.txt` 重装依赖;
197
214
  依赖变更后要先跑 `python-deps`,`python-runtime` 才能装到新版本。
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-maa-project",
3
- "version": "3.7.0",
3
+ "version": "3.7.2",
4
4
  "description": "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects",
5
5
  "keywords": [
6
6
  "maafw",
@@ -0,0 +1 @@
1
+ __version__ = "3.7.2"
@@ -0,0 +1,2 @@
1
+ # Filled by the release workflow when publishing the PyPI wrapper.
2
+ RELEASE_MANIFEST_SHA256 = "95a455d81605180d0879a4d446efe536ebbe6b4d457b7a1ee33bb0f87109417d"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "create-maa-project"
3
- version = "3.7.0"
3
+ version = "3.7.2"
4
4
  description = "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects"
5
5
  keywords = ["maafw", "scaffold", "mcp"]
6
6
  readme = "README.md"
@@ -145,10 +145,17 @@ callers that only look at `written`:
145
145
  and creation still succeeds. `--skip-download` is not valid with `--add`, so an offline `--add
146
146
  android` fails the clone and lands in that pending action.
147
147
  - `.gitignore` gains `Android/agent-dist/`.
148
+ - An Agent project's `pyproject.toml` gains `extend-exclude = ["Android/MaaFwApp"]` under
149
+ `[tool.ruff]`: `release.yml` checks out submodules, so an unscoped `ruff check .` lints the vendored
150
+ shell and fails `pnpm check:py` in every package job.
148
151
  - An Agent project needs an exact `maafw==X` in `requirements.txt` (the Android Python binding only
149
152
  ships inside the MaaAgentCoreAndroid kernel release); otherwise the add-on records an
150
153
  `android-version` pending action with `create-maa-project --update python-deps` as its command. With
151
- an exact `maafw.version` in `maa-project.json`, `--add android` pins `pyproject.toml` too.
154
+ an exact `maafw.version` in `maa-project.json`, `--add android` pins `pyproject.toml` too; when it is
155
+ empty, `--update python-deps` resolves `maafw.channel` and pins that version instead.
156
+ Pre-releases pair as well: kernel and release tags keep the released spelling
157
+ (`3.13.15-maafw5.15.0-beta.1`, `v5.15.0-beta.1`) while `requirements.txt` carries the PEP 440-normalized
158
+ form `uv export` writes (`5.15.0b1`); the resolver and doctor compare normalized versions.
152
159
  - With `github` enabled, `release.yml` gains an `android` job that runs in parallel with `package`;
153
160
  `release-assets/*.apk` is published, and the release job's `needs` becomes `[package, android]`
154
161
  (`[package, android, git_cliff]` with git-cliff). A tag release without `KEYSTORE_BASE64` fails.
@@ -169,6 +176,14 @@ interpreter for one platform (`CREATE_MAA_PROJECT_RUNTIME_PLATFORM=<os>-<arch>`)
169
176
  `.create-maa-project/runtime/python/<platform>` and reinstalls from `requirements.txt`, so run
170
177
  `python-deps` first after a dependency change.
171
178
 
179
+ With the `android` add-on, `--update python-deps` also reconciles the MaaFramework version: an exact
180
+ `maafw.version` wins, otherwise the newest release of `maafw.channel` (`beta` / `alpha` include
181
+ prereleases). It pins `maafw==X` into `pyproject.toml` before `uv lock` / `uv export`, then verifies
182
+ the exported `requirements.txt` still carries the same version (PEP 440-normalized) and fails on
183
+ drift. Without `android`, `maafw` stays floating so uv and Dependabot's `lockfile-only` updates own
184
+ it. The release workflows re-export `requirements.txt` from `uv.lock` (`uv export --frozen`) before
185
+ packaging, so merged Dependabot uv PRs need no manual re-export.
186
+
172
187
  ## Common options
173
188
 
174
189
  Command modes are mutually exclusive: one mode per invocation. Options below list the modes
@@ -20,6 +20,16 @@ export const ANDROID_GITIGNORE_COMMENT =
20
20
  '# Agent runtimes for the Android package are built from requirements.txt and must not be committed.'
21
21
  export const ANDROID_GITIGNORE_LINE = `${ANDROID_AGENT_DIST_PATH}/`
22
22
 
23
+ /**
24
+ * The shell is third-party code: CI checks it out into the project (`submodules: true` in
25
+ * `release.yml`), so the project's own linters must not walk into it. Ruff is the one that bites —
26
+ * upstream's `scripts/*.py` carry a UTF-8 coding comment that the generated `UP` ruleset rejects,
27
+ * which fails every release job before packaging starts.
28
+ */
29
+ export const ANDROID_RUFF_EXCLUDE_COMMENT =
30
+ '# Android/MaaFwApp 是 vendored 的外壳 submodule(Aliothmoon/MaaFwApp),父项目不 lint 第三方脚本。'
31
+ export const ANDROID_RUFF_EXCLUDE_LINE = `extend-exclude = ["${ANDROID_SUBMODULE_PATH}"]`
32
+
23
33
  export const ANDROID_PACKAGING_SCRIPT = 'tools/android-packaging.mjs'
24
34
  export const ANDROID_ENTRY_WORKFLOW = '.github/workflows/android.yml'
25
35
  export const ANDROID_BUILD_WORKFLOW = '.github/workflows/android-build.yml'
@@ -193,6 +193,42 @@ export async function resolveProductAssetManifestFromGithubRelease(
193
193
  return parseGithubReleaseManifest(config, release, channel, selectedPlatform)
194
194
  }
195
195
 
196
+ export type ProductReleaseTagRequest = {
197
+ product: string
198
+ channel?: string
199
+ version?: string
200
+ }
201
+
202
+ export type ProductReleaseTag = {
203
+ tag: string
204
+ version: string
205
+ }
206
+
207
+ export type ProductReleaseTagResolver = (request: ProductReleaseTagRequest) => Promise<ProductReleaseTag | undefined>
208
+
209
+ /**
210
+ * Resolves just the release a product selector points at, without downloading its manifest. Callers
211
+ * that have to pin another file to the same release — an Agent project pins its Python `maafw`
212
+ * binding to the MaaFramework release its Android kernel pairs with — use this so the channel is
213
+ * resolved by one implementation rather than by a second copy of the release rules.
214
+ */
215
+ export async function resolveProductReleaseTag(
216
+ request: ProductReleaseTagRequest,
217
+ options: ProductAssetManifestResolveOptions = {},
218
+ ): Promise<ProductReleaseTag | undefined> {
219
+ const config = productReleaseConfig(request.product)
220
+ if (!config) return undefined
221
+ const channel = normalizeReleaseChannel(request.channel)
222
+ const version = request.version?.trim() ?? ''
223
+ const release = version
224
+ ? await fetchGithubReleaseByTag(config, version, options.fetchJson, options.signal)
225
+ : await fetchGithubReleaseByChannel(config, channel, options.fetchJson, options.signal)
226
+ if (!isRecord(release) || typeof release.tag_name !== 'string' || release.tag_name.trim() === '') {
227
+ throw new Error(`Invalid GitHub release payload for ${config.product}.`)
228
+ }
229
+ return { tag: release.tag_name, version: release.tag_name.replace(/^v/i, '') }
230
+ }
231
+
196
232
  export async function downloadManifestAssets(
197
233
  manifest: AssetManifest,
198
234
  options: {
@@ -612,11 +648,6 @@ function isIgnoredArchiveEntry(path: string): boolean {
612
648
  return lower === '.ds_store' || lower.endsWith('/.ds_store') || lower.startsWith('__macosx/')
613
649
  }
614
650
 
615
- /**
616
- * Upstream tags are v-prefixed (`v5.13.1`) while a pinned version is often written without it, so a
617
- * tag that does not resolve is retried with the other spelling. The first failure is the one that
618
- * surfaces when neither resolves, which keeps the message tied to what the config asked for.
619
- */
620
651
  async function fetchGithubReleaseByTag(
621
652
  config: ProductReleaseConfig,
622
653
  tag: string,
@@ -635,17 +666,36 @@ async function fetchGithubReleaseByTag(
635
666
  throw failure
636
667
  }
637
668
 
669
+ /**
670
+ * Upstream tags are v-prefixed (`v5.13.1`) while a pinned version is often written without it, so a
671
+ * tag that does not resolve is retried with the other spelling. Pre-releases add a second axis:
672
+ * `uv export` and PEP 440 write the normalized form (`5.15.0b1`) while the release tag keeps the
673
+ * released form (`v5.15.0-beta.1`), so the expanded spelling is retried too. The first failure is
674
+ * the one that surfaces when none of them resolve, which keeps the message tied to what the config
675
+ * asked for.
676
+ */
638
677
  function releaseTagCandidates(tag: string): string[] {
639
678
  const pinned = tag.trim()
640
- const alternate = /^v/i.test(pinned) ? pinned.slice(1) : `v${pinned}`
641
- return alternate
642
- ? [
643
- pinned,
644
- alternate,
645
- ]
646
- : [
647
- pinned,
648
- ]
679
+ const candidates: string[] = []
680
+ for (const spelling of new Set([
681
+ pinned,
682
+ expandPrereleaseSpelling(pinned),
683
+ ])) {
684
+ candidates.push(spelling, /^v/i.test(spelling) ? spelling.slice(1) : `v${spelling}`)
685
+ }
686
+ return candidates
687
+ }
688
+
689
+ /** `5.15.0b1` / `v5.15.0b1` -> `v5.15.0-beta.1`; anything already in release form is returned as-is. */
690
+ function expandPrereleaseSpelling(tag: string): string {
691
+ const match = /^(v?)(\d+(?:\.\d+)*)(a|b|rc|c)(\d+)$/i.exec(tag)
692
+ if (match === null) return tag
693
+ const prefix = match[1] ?? ''
694
+ const release = match[2] ?? ''
695
+ const kind = (match[3] ?? '').toLowerCase()
696
+ const number = match[4] ?? ''
697
+ const word = kind === 'a' ? 'alpha' : kind === 'b' ? 'beta' : 'rc'
698
+ return `${prefix}${release}-${word}.${number}`
649
699
  }
650
700
 
651
701
  function fetchTaggedGithubRelease(
@@ -3,6 +3,7 @@ import { dirname, join, resolve } from 'node:path'
3
3
  import { stat } from 'node:fs/promises'
4
4
  import { promisify } from 'node:util'
5
5
  import { readProjectConfig } from './project.js'
6
+ import { normalizeMaafwVersion } from './maafw-version.js'
6
7
  import type { MaaProjectConfig } from './types.js'
7
8
  import { normalizeControllerKind } from './controllers.js'
8
9
  import { enabledResourcePacks, hasDevTools, hasGithubAutomation, isAddonEnabled } from './features.js'
@@ -301,7 +302,7 @@ async function checkAndroidPackaging(root: string, config: MaaProjectConfig, lin
301
302
  ok = false
302
303
  } else {
303
304
  const declared = (config.maafw.version ?? '').trim()
304
- if (declared !== '' && declared !== requirementsPin) {
305
+ if (declared !== '' && normalizeMaafwVersion(declared) !== normalizeMaafwVersion(requirementsPin)) {
305
306
  lines.push(
306
307
  `[ERR] maa-project.json pins maafw ${declared} but requirements.txt pins ${requirementsPin}; the APK would mix two versions.`,
307
308
  )
@@ -311,7 +312,10 @@ async function checkAndroidPackaging(root: string, config: MaaProjectConfig, lin
311
312
  ok = false
312
313
  }
313
314
  const pyprojectPin = await requirementPin(join(root, 'pyproject.toml'), /"maafw==([^"]+)"/)
314
- if (pyprojectPin !== undefined && pyprojectPin !== requirementsPin) {
315
+ if (
316
+ pyprojectPin !== undefined &&
317
+ normalizeMaafwVersion(pyprojectPin) !== normalizeMaafwVersion(requirementsPin)
318
+ ) {
315
319
  lines.push(
316
320
  `[ERR] pyproject.toml pins maafw ${pyprojectPin} but requirements.txt pins ${requirementsPin}; uv has not exported the change.`,
317
321
  )
@@ -0,0 +1,25 @@
1
+ /**
2
+ * The same MaaFramework release is spelled two ways across the toolchain.
3
+ *
4
+ * PyPI and `uv export` carry the PEP 440-normalized form (`5.15.0b1`), while GitHub tags — and the
5
+ * Android kernel tags that copy them — keep the released form (`v5.15.0-beta.1`,
6
+ * `3.13.15-maafw5.15.0-beta.1`). `requirements.txt`, `pyproject.toml` and `maa-project.json` can each
7
+ * hold either one, so anything comparing them has to compare these keys instead of the raw strings.
8
+ */
9
+ export function normalizeMaafwVersion(version: string): string {
10
+ const value = version.trim().replace(/^[vV]/u, '')
11
+ const match = /^(\d+(?:\.\d+)*)(.*)$/u.exec(value)
12
+ if (match === null) return value.toLowerCase()
13
+ return `${match[1] ?? ''}${prereleaseKey(match[2] ?? '')}`
14
+ }
15
+
16
+ /** `-beta.1` / `beta.1` / `b1` -> `b1`, `rc.2` / `c2` -> `rc2`, release -> empty. */
17
+ function prereleaseKey(text: string): string {
18
+ const suffix = text.toLowerCase().replace(/^[-_.]+/u, '')
19
+ if (suffix === '') return ''
20
+ const match = /^(alpha|beta|preview|pre|rc|a|b|c)[-_.]?(\d*)(.*)$/u.exec(suffix)
21
+ if (match === null) return suffix
22
+ const word = match[1] ?? ''
23
+ const short = word === 'a' || word === 'alpha' ? 'a' : word === 'b' || word === 'beta' ? 'b' : 'rc'
24
+ return `${short}${match[2] ?? ''}${match[3] ?? ''}`
25
+ }
@@ -22,13 +22,14 @@ import {
22
22
  interfaceResourceItems,
23
23
  maatoolsConfigFile,
24
24
  optimizeImagesFiles,
25
- pinnedMaafwRequirement,
25
+ pinMaafwToVersion,
26
26
  projectCustomSchemaFiles,
27
27
  releaseWorkflowFile,
28
28
  schemaSyncFiles,
29
29
  vscodeFiles,
30
30
  withAgentDebugSession,
31
31
  withAndroidGitignoreSection,
32
+ withAndroidRuffExclude,
32
33
  } from './templates.js'
33
34
  import { ANDROID_SUBMODULE_BRANCH, ANDROID_SUBMODULE_PATH, ANDROID_SUBMODULE_URL } from './android.js'
34
35
  import type { ProjectTemplateInput } from './templates.js'
@@ -578,6 +579,7 @@ async function addAgentLocked(_options: CliOptions, root: string): Promise<Scaff
578
579
  version: config.project.version,
579
580
  displayName: config.project.displayName,
580
581
  maafwVersion: config.maafw.version,
582
+ includeAndroid: hasAndroidPackaging(config),
581
583
  }),
582
584
  ...projectCustomSchemaFiles(true),
583
585
  ].filter((file) => !dependencyPaths.has(file.path))
@@ -589,10 +591,14 @@ async function addAgentLocked(_options: CliOptions, root: string): Promise<Scaff
589
591
  continue
590
592
  }
591
593
  // pyproject.toml also carries project-owned content ([project].dependencies feeds
592
- // `--update python-deps`), so only the requires-python drift is repaired in place.
594
+ // `--update python-deps`), so only the requires-python drift and the vendored-shell lint
595
+ // exclusion are repaired in place.
593
596
  if (file.path === 'pyproject.toml') {
594
597
  const content = await readText(fullPath)
595
- const repaired = syncRequiresPython(content, config.python.requiresPython)
598
+ const repaired = withAndroidRuffExclude(
599
+ syncRequiresPython(content, config.python.requiresPython),
600
+ hasAndroidPackaging(config),
601
+ )
596
602
  if (repaired !== content) repairFiles.push({ ...file, content: repaired })
597
603
  continue
598
604
  }
@@ -657,6 +663,7 @@ async function addAgentLocked(_options: CliOptions, root: string): Promise<Scaff
657
663
  version: config.project.version,
658
664
  displayName: config.project.displayName,
659
665
  maafwVersion: config.maafw.version,
666
+ includeAndroid: hasAndroidPackaging(config),
660
667
  }),
661
668
  ...projectCustomSchemaFiles(true),
662
669
  {
@@ -941,6 +948,7 @@ async function addAndroidLocked(options: CliOptions, root: string): Promise<Scaf
941
948
  const written = new Set(result.written)
942
949
  const pending: PendingItem[] = []
943
950
  if (await syncAndroidGitignore(root)) written.add('.gitignore')
951
+ if (await syncAndroidRuffExclude(root)) written.add('pyproject.toml')
944
952
  await pinMaafwForAndroid(root, config, written)
945
953
  if (options.skipDownload) {
946
954
  pending.push(androidSubmodulePending('The Android shell checkout was skipped with --skip-download.'))
@@ -987,6 +995,22 @@ async function syncAndroidGitignore(root: string): Promise<boolean> {
987
995
  return true
988
996
  }
989
997
 
998
+ /**
999
+ * Keeps the vendored shell out of the project's ruff run. The line lives in the `[tool.ruff]` table of
1000
+ * an Agent project's `pyproject.toml`; a pipeline project has no pyproject and nothing to do.
1001
+ */
1002
+ async function syncAndroidRuffExclude(root: string): Promise<boolean> {
1003
+ const relativePath = 'pyproject.toml'
1004
+ const fullPath = join(root, relativePath)
1005
+ if (!(await exists(fullPath))) return false
1006
+ const current = await readText(fullPath)
1007
+ const next = withAndroidRuffExclude(current)
1008
+ if (next === current) return false
1009
+ await trackProjectPathForBackup(root, relativePath)
1010
+ await writeText(fullPath, next)
1011
+ return true
1012
+ }
1013
+
990
1014
  /**
991
1015
  * Pins `maafw` in `pyproject.toml` when the project declares an exact version, so `uv` cannot
992
1016
  * resolve a different one than the kernel the APK pairs with. `requirements.txt` is what the
@@ -1000,7 +1024,7 @@ async function pinMaafwForAndroid(root: string, config: MaaProjectConfig, writte
1000
1024
  const fullPath = join(root, relativePath)
1001
1025
  if (!(await exists(fullPath))) return
1002
1026
  const current = await readText(fullPath)
1003
- const next = pinnedMaafwRequirement(current, version)
1027
+ const next = pinMaafwToVersion(current, version)
1004
1028
  if (next === current) return
1005
1029
  await trackProjectPathForBackup(root, relativePath)
1006
1030
  await writeText(fullPath, next)