create-maa-project 3.7.4__tar.gz → 3.8.0__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 (213) hide show
  1. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/ci.yml +64 -0
  2. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.release/create-maa-project-manifest.json +26 -26
  3. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/CHANGELOG.md +64 -0
  4. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/PKG-INFO +3 -3
  5. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/README.en.md +6 -2
  6. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/README.md +2 -2
  7. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/commands.en.md +22 -0
  8. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/commands.md +20 -0
  9. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/package.json +2 -2
  10. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pnpm-lock.yaml +20 -18
  11. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pnpm-workspace.yaml +2 -0
  12. create_maa_project-3.8.0/py-wrapper/create_maa_project/__init__.py +1 -0
  13. create_maa_project-3.8.0/py-wrapper/create_maa_project/release_manifest.py +2 -0
  14. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pyproject.toml +1 -1
  15. create_maa_project-3.8.0/scripts/test-python.mjs +128 -0
  16. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/SKILL.md +9 -1
  17. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/references/commands.md +23 -0
  18. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/scaffold.ts +2 -1
  19. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/template-deps.json +2 -2
  20. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/templates.ts +24 -2
  21. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/utils.ts +48 -0
  22. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/package-smoke.yml +88 -0
  23. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/release.yml +61 -15
  24. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/tools/build-release.mjs +16 -2
  25. create_maa_project-3.8.0/templates/addons/github/tools/ci/smoke-macos-app.sh +107 -0
  26. create_maa_project-3.8.0/templates/addons/github/tools/macos-app-bundle.mjs +636 -0
  27. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/agent_runtime.py +22 -4
  28. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/action/general.py +1 -1
  29. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/reco/general.py +1 -1
  30. create_maa_project-3.8.0/templates/agent/agent/main.py +48 -0
  31. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/logger.py +81 -5
  32. create_maa_project-3.8.0/templates/agent/agent/utils/runtime_paths.py +120 -0
  33. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/pyproject.toml +1 -1
  34. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/requirements.in +1 -1
  35. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface.schema.json +58 -0
  36. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface_config.schema.json +58 -0
  37. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/pipeline.schema.json +38 -0
  38. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/schema-manifest.json +3 -3
  39. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/android-addon.test.ts +1 -1
  40. create_maa_project-3.8.0/tests/macos-app-bundle.test.ts +292 -0
  41. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/package-smoke-workflow.test.ts +28 -0
  42. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/scaffold.test.ts +25 -6
  43. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/templates.test.ts +155 -0
  44. create_maa_project-3.8.0/tests/test_agent_logger.py +126 -0
  45. create_maa_project-3.8.0/tests/test_agent_runtime_paths.py +120 -0
  46. create_maa_project-3.8.0/tests/utils.test.ts +48 -0
  47. create_maa_project-3.7.4/py-wrapper/create_maa_project/__init__.py +0 -1
  48. create_maa_project-3.7.4/py-wrapper/create_maa_project/release_manifest.py +0 -2
  49. create_maa_project-3.7.4/scripts/test-python.mjs +0 -56
  50. create_maa_project-3.7.4/templates/agent/agent/main.py +0 -35
  51. create_maa_project-3.7.4/templates/agent/agent/utils/runtime_paths.py +0 -50
  52. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.editorconfig +0 -0
  53. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.gitattributes +0 -0
  54. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/cliff.toml +0 -0
  55. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/deps-audit.yml +0 -0
  56. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/deps-sync.yml +0 -0
  57. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/network-assets.yml +0 -0
  58. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/release.yml +0 -0
  59. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/schema-sync.yml +0 -0
  60. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.gitignore +0 -0
  61. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.prettierignore +0 -0
  62. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.prettierrc.mjs +0 -0
  63. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/AGENTS.md +0 -0
  64. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/LICENSE +0 -0
  65. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/RELEASING.md +0 -0
  66. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/android-packaging-plan.md +0 -0
  67. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/json-report.en.md +0 -0
  68. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/json-report.md +0 -0
  69. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/mcp.en.md +0 -0
  70. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/mcp.md +0 -0
  71. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/py-wrapper/create_maa_project/__main__.py +0 -0
  72. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/build-sea.mjs +0 -0
  73. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/build.mjs +0 -0
  74. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/changelog-notes.mjs +0 -0
  75. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/check-network-assets.ts +0 -0
  76. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-release-manifest.mjs +0 -0
  77. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-sbom.d.mts +0 -0
  78. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-sbom.mjs +0 -0
  79. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/prepare-pypi-release.mjs +0 -0
  80. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/smoke-cli-artifact.mjs +0 -0
  81. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-release-version.mjs +0 -0
  82. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-schema.mjs +0 -0
  83. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-template-deps.ts +0 -0
  84. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/update-audit-overrides.ts +0 -0
  85. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/README.md +0 -0
  86. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/agents/openai.yaml +0 -0
  87. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/references/json-report.md +0 -0
  88. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/addons.ts +0 -0
  89. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/android.ts +0 -0
  90. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/args.ts +0 -0
  91. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/assets.ts +0 -0
  92. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/auto-update.ts +0 -0
  93. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/command.ts +0 -0
  94. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/controllers.ts +0 -0
  95. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/doctor.ts +0 -0
  96. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/features.ts +0 -0
  97. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/incremental-addons.ts +0 -0
  98. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/index.ts +0 -0
  99. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/lang.ts +0 -0
  100. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/log.ts +0 -0
  101. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/maafw-version.ts +0 -0
  102. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/mcp.ts +0 -0
  103. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/node-support.ts +0 -0
  104. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/project-config.ts +0 -0
  105. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/project.ts +0 -0
  106. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/prompt.ts +0 -0
  107. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/report.ts +0 -0
  108. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/semver.ts +0 -0
  109. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/sync.ts +0 -0
  110. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/template-deps.ts +0 -0
  111. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/types.ts +0 -0
  112. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/update-targets.ts +0 -0
  113. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/update.ts +0 -0
  114. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/version.ts +0 -0
  115. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/.github/workflows/android-build.yml +0 -0
  116. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/.github/workflows/android.yml +0 -0
  117. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/README.md +0 -0
  118. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/profile.agent.yaml +0 -0
  119. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/profile.pipeline.yaml +0 -0
  120. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/tools/android-packaging.mjs +0 -0
  121. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/auto-format/.github/workflows/format.yml +0 -0
  122. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/CONTRIBUTING.md +0 -0
  123. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/PULL_REQUEST_TEMPLATE.md +0 -0
  124. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/bug_report.yml +0 -0
  125. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/feature_request.yml +0 -0
  126. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/issue_config.yml +0 -0
  127. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/other_issue.yml +0 -0
  128. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dependabot/.github/dependabot.yml +0 -0
  129. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/extensions.agent.json +0 -0
  130. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/extensions.json +0 -0
  131. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/launch.agent.json +0 -0
  132. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/settings.agent.json +0 -0
  133. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/settings.json +0 -0
  134. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/tasks.agent.json +0 -0
  135. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/tasks.json +0 -0
  136. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/package.json +0 -0
  137. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/pnpm-workspace.yaml +0 -0
  138. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/tools/validate-schema.mjs +0 -0
  139. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/git-cliff/.github/cliff.toml +0 -0
  140. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/check.yml +0 -0
  141. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/tools/sync-runtime.mjs +0 -0
  142. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/optimize-images/.github/workflows/optimize-images.yml +0 -0
  143. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/optimize-images/tools/optimize-images.mjs +0 -0
  144. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/schema-sync/.github/workflows/schema-sync.yml +0 -0
  145. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/schema-sync/tools/sync-schema.mjs +0 -0
  146. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/README.en.md +0 -0
  147. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/README.md +0 -0
  148. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/__init__.py +0 -0
  149. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/__init__.py +0 -0
  150. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/action/__init__.py +0 -0
  151. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/reco/__init__.py +0 -0
  152. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/sink/__init__.py +0 -0
  153. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/maafw_paths.py +0 -0
  154. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/__init__.py +0 -0
  155. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/maa_types.py +0 -0
  156. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/params.py +0 -0
  157. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/pienv.py +0 -0
  158. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/requirements.txt +0 -0
  159. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/tools/schema/custom.action.schema.json +0 -0
  160. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/tools/schema/custom.recognition.schema.json +0 -0
  161. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/uv.lock +0 -0
  162. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.editorconfig +0 -0
  163. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.gitattributes +0 -0
  164. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.gitignore +0 -0
  165. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.prettierignore +0 -0
  166. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.prettierrc.mjs +0 -0
  167. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/README.en.md +0 -0
  168. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/README.md +0 -0
  169. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/gitignore.tmpl +0 -0
  170. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/interface.json.tmpl +0 -0
  171. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/licenses/AGPL-3.0-or-later.txt +0 -0
  172. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/licenses/MIT.txt +0 -0
  173. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/maatools.config.mts +0 -0
  174. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/default_pipeline.json +0 -0
  175. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/image/empty.png +0 -0
  176. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/model/ocr/manifest.json +0 -0
  177. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/pipeline/Tutorial/Tutorial.json +0 -0
  178. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tasks/tutorial.json +0 -0
  179. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/custom.action.schema.json +0 -0
  180. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/custom.recognition.schema.json +0 -0
  181. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface_import.schema.json +0 -0
  182. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/addons.test.ts +0 -0
  183. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/android-packaging.test.ts +0 -0
  184. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/args.test.ts +0 -0
  185. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/auto-update.test.ts +0 -0
  186. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/backup-operations.test.ts +0 -0
  187. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/changelog-notes.test.ts +0 -0
  188. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/child-env.ts +0 -0
  189. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/cli-info.test.ts +0 -0
  190. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/command.test.ts +0 -0
  191. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/doctor-errors.test.ts +0 -0
  192. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/enabled-config.test.ts +0 -0
  193. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/git-initialization.test.ts +0 -0
  194. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/incremental-addons-results.test.ts +0 -0
  195. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/lang.test.ts +0 -0
  196. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/maafw-version.test.ts +0 -0
  197. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/mcp.test.ts +0 -0
  198. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/node-support.test.ts +0 -0
  199. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/ocr-git-registration.test.ts +0 -0
  200. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/project-config.test.ts +0 -0
  201. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/project.test.ts +0 -0
  202. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/prompt-interactive.test.ts +0 -0
  203. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/prompt.test.ts +0 -0
  204. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/release-smoke.test.ts +0 -0
  205. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/release-workflow.test.ts +0 -0
  206. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/report.test.ts +0 -0
  207. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/sbom.test.ts +0 -0
  208. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/semver.test.ts +0 -0
  209. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/template-deps.test.ts +0 -0
  210. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/test_py_wrapper.py +0 -0
  211. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/update-audit-overrides.test.ts +0 -0
  212. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tsconfig.json +0 -0
  213. {create_maa_project-3.7.4 → create_maa_project-3.8.0}/vitest.config.ts +0 -0
@@ -149,6 +149,70 @@ jobs:
149
149
  env:
150
150
  CREATE_MAA_PROJECT_RUNTIME_PLATFORM: ${{ matrix.target }}
151
151
  run: node tools/build-release.mjs --release-tag v0.0.0-ci-smoke
152
+ # release.yml ships macOS MXU as a signed .app inside a dmg, so the osx leg exercises the
153
+ # whole bundler chain end to end: enable the MXU runtime, rebuild the packages with it, then
154
+ # bundle, sign, dmg and run the app read-only the way the release does.
155
+ - name: Enable the MXU runtime for the bundle smoke
156
+ if: runner.os == 'macOS'
157
+ working-directory: .ci-package-project
158
+ run: |
159
+ node --input-type=module -e "
160
+ import fs from 'node:fs';
161
+ const project = JSON.parse(fs.readFileSync('maa-project.json', 'utf8'));
162
+ project.runtime = {...project.runtime, mxu: {enabled: true, channel: 'stable', version: ''}};
163
+ fs.writeFileSync('maa-project.json', JSON.stringify(project, null, 4) + '\n');
164
+ "
165
+ - name: Synchronize the MXU runtime
166
+ if: runner.os == 'macOS'
167
+ working-directory: .ci-package-project
168
+ env:
169
+ CREATE_MAA_PROJECT_RUNTIME_PLATFORM: ${{ matrix.target }}
170
+ CREATE_MAA_PROJECT_BIN: node ${{ github.workspace }}/dist/index.js
171
+ CREATE_MAA_PROJECT_OCR_SOURCE: download
172
+ GITHUB_TOKEN: ${{ github.token }}
173
+ run: pnpm sync:runtime
174
+ # build-release.mjs removes every dist/package-* before rebuilding, so this second run both
175
+ # produces package-mxu and keeps the package-mfaa the verify steps below still assert.
176
+ - name: Rebuild the release packages with MXU
177
+ if: runner.os == 'macOS'
178
+ working-directory: .ci-package-project
179
+ env:
180
+ CREATE_MAA_PROJECT_RUNTIME_PLATFORM: ${{ matrix.target }}
181
+ run: node tools/build-release.mjs --release-tag v0.0.0-ci-smoke
182
+ - name: Build and smoke the macOS app bundle
183
+ if: runner.os == 'macOS'
184
+ working-directory: .ci-package-project
185
+ run: |
186
+ set -euo pipefail
187
+ # The project ships no logo.ico; wrap the PNG it does have into one so the bundler's
188
+ # icon conversion path is exercised the way release.yml uses it.
189
+ node --input-type=module -e "
190
+ import fs from 'node:fs';
191
+ const png = fs.readFileSync('resource/base/image/empty.png');
192
+ const entry = Buffer.alloc(16);
193
+ entry.writeUInt16LE(1, 4);
194
+ entry.writeUInt16LE(32, 6);
195
+ entry.writeUInt32LE(png.length, 8);
196
+ entry.writeUInt32LE(22, 12);
197
+ fs.writeFileSync('logo.ico', Buffer.concat([Buffer.from([0, 0, 1, 0, 1, 0]), entry, png]));
198
+ "
199
+ node tools/macos-app-bundle.mjs \
200
+ --package dist/package-mxu \
201
+ --app "dist/CI-Package.app" \
202
+ --version v0.0.0-ci-smoke \
203
+ --executable ci-package \
204
+ --display-name "CI Package" \
205
+ --icon logo.ico \
206
+ --dmg "dist/CI-Package-macos-aarch64-v0.0.0-ci-smoke-MXU.dmg"
207
+ test -x "dist/CI-Package.app/Contents/MacOS/ci-package"
208
+ test -L "dist/CI-Package.app/Contents/MacOS/interface.json"
209
+ test -d "dist/CI-Package.app/Contents/Resources/MXU-portable"
210
+ test -f "dist/CI-Package.app/Contents/Resources/ci-package.icns"
211
+ grep -A1 '<key>CFBundleIconFile</key>' dist/CI-Package.app/Contents/Info.plist \
212
+ | grep -q '<string>ci-package.icns</string>'
213
+ test -s "dist/CI-Package-macos-aarch64-v0.0.0-ci-smoke-MXU.dmg"
214
+ codesign --verify --strict --verbose=2 "dist/CI-Package.app"
215
+ bash tools/ci/smoke-macos-app.sh "dist/CI-Package.app" "$RUNNER_TEMP/ci-package-app-smoke"
152
216
  - name: Verify the package (Windows)
153
217
  if: runner.os == 'Windows'
154
218
  working-directory: .ci-package-project
@@ -1,68 +1,68 @@
1
1
  {
2
2
  "schemaVersion": 1,
3
3
  "name": "create-maa-project",
4
- "version": "3.7.4",
5
- "tag": "v3.7.4",
4
+ "version": "3.8.0",
5
+ "tag": "v3.8.0",
6
6
  "assets": [
7
7
  {
8
8
  "kind": "sea",
9
9
  "os": "linux",
10
10
  "arch": "aarch64",
11
- "version": "3.7.4",
11
+ "version": "3.8.0",
12
12
  "name": "create-maa-project-linux-aarch64",
13
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-linux-aarch64",
14
- "sha256": "1548c1df4b9cbb5adccb7b1f60d5d06948fdce5cbd4e3c5d8e9d16b4d3716b94",
15
- "size": 125111424
13
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-linux-aarch64",
14
+ "sha256": "b213f3aa0634091499901a53137a3deecce98e0d6a3653bb857d4ff22b2da9be",
15
+ "size": 125176960
16
16
  },
17
17
  {
18
18
  "kind": "sea",
19
19
  "os": "linux",
20
20
  "arch": "x86_64",
21
- "version": "3.7.4",
21
+ "version": "3.8.0",
22
22
  "name": "create-maa-project-linux-x86_64",
23
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-linux-x86_64",
24
- "sha256": "3b2a2072769796b637ab17f934f49d45d28c6d2271bd79a5484151067a3bee21",
25
- "size": 128584896
23
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-linux-x86_64",
24
+ "sha256": "3753063d7476a56802d624b87c94602de7407eb69d0241b0cb7ccc28ffe79617",
25
+ "size": 128715968
26
26
  },
27
27
  {
28
28
  "kind": "sea",
29
29
  "os": "macos",
30
30
  "arch": "aarch64",
31
- "version": "3.7.4",
31
+ "version": "3.8.0",
32
32
  "name": "create-maa-project-macos-aarch64",
33
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-macos-aarch64",
34
- "sha256": "6252f03703941fb3269064fa919d0a91bb507aa5f2cfa288158d698fb8fdaf59",
35
- "size": 123301168
33
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-macos-aarch64",
34
+ "sha256": "cb38f1e37697871faa73f9ee773ea539e9d7ae83f591946d54cd57c6a7d88449",
35
+ "size": 123368912
36
36
  },
37
37
  {
38
38
  "kind": "sea",
39
39
  "os": "macos",
40
40
  "arch": "x86_64",
41
- "version": "3.7.4",
41
+ "version": "3.8.0",
42
42
  "name": "create-maa-project-macos-x86_64",
43
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-macos-x86_64",
44
- "sha256": "5b4b584ad660d96c5024f1f9aafe48b89e6da66c3bbaab95a4e0107320763070",
45
- "size": 125144560
43
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-macos-x86_64",
44
+ "sha256": "ebbe51bb03e10289ae342483be6a687eb0d2208bc400e0c71d7c51c9141f4f00",
45
+ "size": 125198224
46
46
  },
47
47
  {
48
48
  "kind": "sea",
49
49
  "os": "win",
50
50
  "arch": "aarch64",
51
- "version": "3.7.4",
51
+ "version": "3.8.0",
52
52
  "name": "create-maa-project-win-aarch64.exe",
53
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-win-aarch64.exe",
54
- "sha256": "1da6686fad85240579d246da26369a5b72ced3925406fc3b3a37b2ae9f554973",
55
- "size": 83973632
53
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-win-aarch64.exe",
54
+ "sha256": "8856a4059c00610d007367c6942afc8466eba0061a3eb7aadaba8a583045f088",
55
+ "size": 84043264
56
56
  },
57
57
  {
58
58
  "kind": "sea",
59
59
  "os": "win",
60
60
  "arch": "x86_64",
61
- "version": "3.7.4",
61
+ "version": "3.8.0",
62
62
  "name": "create-maa-project-win-x86_64.exe",
63
- "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.7.4/create-maa-project-win-x86_64.exe",
64
- "sha256": "c6d2486e5a452de2b38f42577cda95fc1aea9b88d4a658c2d946ef04518a1a76",
65
- "size": 95739392
63
+ "url": "https://github.com/Windsland52/create-maa-project/releases/download/v3.8.0/create-maa-project-win-x86_64.exe",
64
+ "sha256": "c45dacb74ade0694e5b5538dc4c37884f356f154f24b65a5333af27345d2cd47",
65
+ "size": 95792128
66
66
  }
67
67
  ]
68
68
  }
@@ -2,6 +2,70 @@
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.8.0] - 2026-11-17
6
+
7
+ ### 新增
8
+
9
+ - macOS 的 MXU 包发布为签名的 `.app` 应用包 + `.dmg` 镜像。`tools/macos-app-bundle.mjs` 把
10
+ `dist/package-mxu` 组装成 `<DisplayName>.app`(可执行文件留在 `Contents/MacOS`,其余顶层条目经
11
+ `Contents/Resources/MXU-portable` 软链接入),嵌套签名后产出
12
+ `<Artifact>-macos-<arch>-<tag>-MXU.dmg`;MFAA 包保持 `.tar.gz` 不变。生成项目的 release 与
13
+ package-smoke workflow 在 macOS 目标上自动走 dmg 分支,仓库 CI 的 package-smoke osx 腿也全链路
14
+ 跑一遍(启用 MXU → 打包 → 签名 → dmg → 只读运行 smoke)
15
+ - Agent 项目支持 `PI_USER_DATA_DIR`:Client(只读 `.app` 下的 MXU)通过该环境变量交出可写数据
16
+ 目录,Agent 的 `config/`、`debug/` 落到 bundle 外;包内只读顶层条目(`resource/`、`agent/`、
17
+ `interface.json` 等)以符号链接接入数据目录。`tools/ci/smoke-macos-app.sh` 以只读 bundle
18
+ 复刻安装形态做回归
19
+
20
+ ### 修复
21
+
22
+ - `--icon` 图标转换加固:`uv` 可用时改用 `uv run --with pillow`(生成项目不再要求自身 pyproject
23
+ 带 Pillow),`.ico` 且无 uv 时回退到内置 PNG 帧提取,BMP 帧再回退到 Quick Look;图标路径失败
24
+ 不再静默告警而是中止构建。dmg staging 目录在 `hdiutil` 重试终败后也会清理;bundle 软链逃逸
25
+ 检查补上路径分隔符边界
26
+ - `macos-app-bundle.mjs` 先校验入口 / `interface.json` / 版本格式、并用 realpath 拒绝 `--app`
27
+ 与包目录或 cwd 重叠,再删除旧 `.app`;参数写错不再先毁掉输入包或旧产物。`CFBundleVersion`
28
+ 与 `CFBundleShortVersionString` 都写成 1–3 段数字(`v0.0.0-package-smoke` → `0.0.0`),
29
+ 预发布后缀只留在 dmg 文件名里。有 `--icon` 时 package-smoke / 仓库 CI 会核对 icns 文件和
30
+ `CFBundleIconFile` 的值
31
+ - `PI_USER_DATA_DIR` 为相对路径或 `~` 时,Agent 在 `chdir` 前 `expanduser` + 绝对化并写回环境
32
+ 变量,避免数据目录变成 `userdata/userdata`
33
+ - smoke 脚本只放行「完全没有 Agent」的跳过,`python/` 或 `agent/` 缺一即报 partial agent bundle
34
+ - `build-release.mjs` 的产物名契约与 release.yml 实际发布名对齐:macOS MXU 记 `.dmg`,其余目标
35
+ 保持 `.zip` / `.tar.gz`,校验正则同步放行 `dmg`
36
+ - Agent 模板统一为 `from utils.logger import logger`。`from utils import logger` 在已导入
37
+ `utils.logger` 子模块后会拿到 module 而不是 logger
38
+ - 无 loguru 时 `%s` 占位交给标准 logging,`logger.error("DisableNode: %s", error)` 不再打出字面 `%s`
39
+ - Agent 文件日志时间戳带时区偏移;有 `{}` 占位符时附 loguru 0.8 的原始模板(`tpl=`),同一调用点
40
+ 不同参数能聚成一条。新项目 `pyproject.toml` / `requirements.in` 钉 `loguru>=0.8.0`(`record["template"]`
41
+ 是 0.8 新字段)。已有项目:`--add agent` 只刷新 logger,不会改 `[project].dependencies`;请把
42
+ `loguru` 改成 `>=0.8.0` 再 `--update python-deps`。仍停在 0.7 时文件 sink 会丢行
43
+ - 跨卷复制 bundle 时保留嵌套符号链接(`python3 → python3.13` 不再被解成失效绝对路径)。smoke
44
+ 要求数据目录里的 `resource/`、`agent/` 是能解析的目录,断掉的链接不再误报成功
45
+ - `PI_USER_DATA_DIR` 指到项目目录内部时,`link_work_root()` 跳过数据目录自身,避免
46
+ `userdata/userdata → userdata`
47
+
48
+ ### 变更
49
+
50
+ - release artifact 列表新增 `.dmg`:生成项目的 release workflow 只发布 macOS MXU 的 dmg,其余
51
+ 目标/ GUI 后缀不变;发布资产命名校验随之上移为 `(zip|tar.gz|dmg)`
52
+
53
+ ### 不兼容变更
54
+
55
+ - 创建项目时的 slug 校验拒绝与发布布局冲突的保留名(`mxu`、`python`、`resource`、`maafw` 等
56
+ GUI 入口候选与顶层发布路径)。只影响新创建和显式 `--slug`;已有项目不会在 `--add github`
57
+ 时被重验,资源包 slug 仍走原来的字符规则。以前合法的 `create-maa-project --slug python`
58
+ 现在会直接失败,请换一个不与发布包顶层路径冲突的项目 ID。
59
+
60
+ 已有项目:github 的 7 个文件全是受管的,重跑 `create-maa-project --add github` 会写入
61
+ `tools/macos-app-bundle.mjs`、`tools/ci/smoke-macos-app.sh` 并刷新 release / package-smoke
62
+ (`--update` 没有 github 目标)。Agent 的 `PI_USER_DATA_DIR`、数据目录自链跳过、以及文件日志时区/
63
+ `tpl=` 在受管的 agent 文件里,重跑 `create-maa-project --add agent` 即更新;`--add agent` 不会改
64
+ `[project].dependencies`,请把 `loguru` 改成 `>=0.8.0` 再 `--update python-deps`。已有项目的 slug
65
+ 不会在 `--add github` 时被重验。
66
+
67
+ [3.8.0]: https://github.com/Windsland52/create-maa-project/compare/v3.7.4...v3.8.0
68
+
5
69
  ## [3.7.4] - 2026-11-04
6
70
 
7
71
  ### 修复
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: create-maa-project
3
- Version: 3.7.4
3
+ Version: 3.8.0
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
@@ -122,7 +122,7 @@ CLI 内置零干扰的自动更新:最多每 24 小时向 npm registry 查询
122
122
 
123
123
  项目身份拆成两个字段:
124
124
 
125
- - `slug`:ASCII kebab-case ID,用于仓库名、package 名、artifact 名和 `interface.json` 的 `name`。
125
+ - `slug`:ASCII kebab-case ID,用于仓库名、package 名、artifact 名和 `interface.json` 的 `name`。不能用发布包保留名(`mxu`、`python`、`resource`、`maafw`、`agent` 等);只在新创建和显式 `--slug` 时校验。
126
126
  - `displayName`:面向用户的显示名,用于 `interface.json` 的 `label`,可以是中文或其它展示文本。
127
127
 
128
128
  资源结构固定围绕 `resource/base/` 与可选的 `resource/<pack>/`;`interface.json` 的 resource 路径按 `maa-project.json` 中记录的顺序生成,后添加的资源包在 MaaFW 资源查找中有更高覆盖优先级。项目自有文件只在首次创建时写入,之后仅由显式的 `--sync`、`--add`、`--update` 改写对应文件。
@@ -194,7 +194,7 @@ requirements.txt
194
194
 
195
195
  带 GitHub add-on 的项目会包含 check、release 和 package-smoke workflows。发布打包以 Git tag 为准:源码元数据可以保持 `0.1.0`,release staging 会把 tag 版本注入包内的 `interface.json`;`package-smoke` 在 push / PR 时用与 release 相同的目标矩阵先行构建校验,打包问题不必等到打 tag 才暴露。
196
196
 
197
- 默认 runtime profile 面向 [MFAAvalonia](https://github.com/MaaXYZ/MFAAvalonia):`--update maafw` 同步 MaaFramework 资产,`--update runtime:mfa` 同步 MFAAvalonia GUI runtime,生成的 `pnpm sync:runtime` 执行二者(Agent 项目还会同步 Python runtime)。默认 release artifact 覆盖 Windows、Linux、macOS 的 `x86_64` 与 `aarch64`,Windows 使用 `.zip`,Linux 和 macOS 使用 `.tar.gz`。
197
+ 默认 runtime profile 面向 [MFAAvalonia](https://github.com/MaaXYZ/MFAAvalonia):`--update maafw` 同步 MaaFramework 资产,`--update runtime:mfa` 同步 MFAAvalonia GUI runtime,生成的 `pnpm sync:runtime` 执行二者(Agent 项目还会同步 Python runtime)。默认 release artifact 覆盖 Windows、Linux、macOS 的 `x86_64` 与 `aarch64`,Windows 使用 `.zip`,Linux 使用 `.tar.gz`;macOS 的 MFAA 包仍是 `.tar.gz`,启用 MXU 后则以签名的 `.app` 应用包打包进 `.dmg`(`tools/macos-app-bundle.mjs` 产物),Agent 项目顺带获得只读 bundle 下的 `PI_USER_DATA_DIR` 数据目录支持。
198
198
 
199
199
  带 `android` add-on 的项目额外产出 APK:外壳 [MaaFwApp](https://github.com/Aliothmoon/MaaFwApp) 以 Git submodule 接入,`Android/profile.yaml` 是手维护的打包配方,push / PR 出 debug 包,打 tag 时与桌面包一起进 Release(universal + 双 ABI 单包)。Agent 项目要求 `requirements.txt` 里有精确的 `maafw==X`,因为 Android 的 Python 绑定只随内核 release 发布。详见[命令文档](./docs/commands.md#android-写入的文件)。
200
200
 
@@ -148,7 +148,8 @@ default in CI; `=1` forces it on).
148
148
  Project identity is split into two fields:
149
149
 
150
150
  - `slug`: ASCII kebab-case ID used for repository names, package names, artifacts, and
151
- `interface.json` `name`.
151
+ `interface.json` `name`. Names reserved by the release package layout (`mxu`, `python`,
152
+ `resource`, `maafw`, `agent`, …) are rejected on new creates and explicit `--slug`.
152
153
  - `displayName`: user-facing label used for `interface.json` `label`; it may be Chinese
153
154
  or any other display text.
154
155
 
@@ -260,7 +261,10 @@ The default runtime profile targets [MFAAvalonia](https://github.com/MaaXYZ/MFAA
260
261
  `--update maafw` syncs MaaFramework assets, `--update runtime:mfa` syncs the MFAAvalonia GUI
261
262
  runtime, and the generated `pnpm sync:runtime` runs both (agent projects additionally sync the
262
263
  Python runtime). Default release artifacts cover Windows, Linux, and macOS on `x86_64` and
263
- `aarch64`; Windows artifacts are `.zip`, Linux and macOS artifacts are `.tar.gz`.
264
+ `aarch64`; Windows artifacts are `.zip` and Linux artifacts are `.tar.gz`. On macOS the MFAA
265
+ package stays `.tar.gz`, while an MXU-enabled project ships a signed `.app` bundle inside a `.dmg`
266
+ (built by `tools/macos-app-bundle.mjs`); agent projects get `PI_USER_DATA_DIR` data-directory
267
+ support so the Agent also runs from a read-only bundle.
264
268
 
265
269
  Projects with the `android` add-on additionally produce APKs: the
266
270
  [MaaFwApp](https://github.com/Aliothmoon/MaaFwApp) shell is wired in as a Git submodule,
@@ -111,7 +111,7 @@ CLI 内置零干扰的自动更新:最多每 24 小时向 npm registry 查询
111
111
 
112
112
  项目身份拆成两个字段:
113
113
 
114
- - `slug`:ASCII kebab-case ID,用于仓库名、package 名、artifact 名和 `interface.json` 的 `name`。
114
+ - `slug`:ASCII kebab-case ID,用于仓库名、package 名、artifact 名和 `interface.json` 的 `name`。不能用发布包保留名(`mxu`、`python`、`resource`、`maafw`、`agent` 等);只在新创建和显式 `--slug` 时校验。
115
115
  - `displayName`:面向用户的显示名,用于 `interface.json` 的 `label`,可以是中文或其它展示文本。
116
116
 
117
117
  资源结构固定围绕 `resource/base/` 与可选的 `resource/<pack>/`;`interface.json` 的 resource 路径按 `maa-project.json` 中记录的顺序生成,后添加的资源包在 MaaFW 资源查找中有更高覆盖优先级。项目自有文件只在首次创建时写入,之后仅由显式的 `--sync`、`--add`、`--update` 改写对应文件。
@@ -183,7 +183,7 @@ requirements.txt
183
183
 
184
184
  带 GitHub add-on 的项目会包含 check、release 和 package-smoke workflows。发布打包以 Git tag 为准:源码元数据可以保持 `0.1.0`,release staging 会把 tag 版本注入包内的 `interface.json`;`package-smoke` 在 push / PR 时用与 release 相同的目标矩阵先行构建校验,打包问题不必等到打 tag 才暴露。
185
185
 
186
- 默认 runtime profile 面向 [MFAAvalonia](https://github.com/MaaXYZ/MFAAvalonia):`--update maafw` 同步 MaaFramework 资产,`--update runtime:mfa` 同步 MFAAvalonia GUI runtime,生成的 `pnpm sync:runtime` 执行二者(Agent 项目还会同步 Python runtime)。默认 release artifact 覆盖 Windows、Linux、macOS 的 `x86_64` 与 `aarch64`,Windows 使用 `.zip`,Linux 和 macOS 使用 `.tar.gz`。
186
+ 默认 runtime profile 面向 [MFAAvalonia](https://github.com/MaaXYZ/MFAAvalonia):`--update maafw` 同步 MaaFramework 资产,`--update runtime:mfa` 同步 MFAAvalonia GUI runtime,生成的 `pnpm sync:runtime` 执行二者(Agent 项目还会同步 Python runtime)。默认 release artifact 覆盖 Windows、Linux、macOS 的 `x86_64` 与 `aarch64`,Windows 使用 `.zip`,Linux 使用 `.tar.gz`;macOS 的 MFAA 包仍是 `.tar.gz`,启用 MXU 后则以签名的 `.app` 应用包打包进 `.dmg`(`tools/macos-app-bundle.mjs` 产物),Agent 项目顺带获得只读 bundle 下的 `PI_USER_DATA_DIR` 数据目录支持。
187
187
 
188
188
  带 `android` add-on 的项目额外产出 APK:外壳 [MaaFwApp](https://github.com/Aliothmoon/MaaFwApp) 以 Git submodule 接入,`Android/profile.yaml` 是手维护的打包配方,push / PR 出 debug 包,打 tag 时与桌面包一起进 Release(universal + 双 ABI 单包)。Agent 项目要求 `requirements.txt` 里有精确的 `maafw==X`,因为 Android 的 Python 绑定只随内核 release 发布。详见[命令文档](./docs/commands.md#android-写入的文件)。
189
189
 
@@ -29,6 +29,8 @@ Git initialization is enabled by default: when the target is outside an existing
29
29
 
30
30
  Interactive creation defaults: project folder `maa-project` (the project ID is derived from the folder name and only asked for when no valid ID can be derived), display name from the folder name, project type `pipeline`, license `AGPL-3.0-or-later`, control target `Adb`, the All repository preset, and no extra resource pack; Git initialization follows the rule above. `--yes --no-interactive` uses these same defaults.
31
31
 
32
+ The project ID (`--slug`, or derived from the folder name) becomes the GUI executable inside every release package, so it cannot collide with a top-level release path or runtime entry: reserved names such as `mxu`, `python`, `resource`, `maafw`, and `agent` are rejected on **new creates** and explicit `--slug`. Existing projects are not re-checked on `--add github`; resource-pack slugs still use the character rule only.
33
+
32
34
  Add-ons:
33
35
 
34
36
  ```bash
@@ -115,6 +117,26 @@ Scripts in `package.json` follow the enabled add-ons: `check` always chains `for
115
117
  `schema-sync` adds `sync:schema`, `optimize-images` adds `optimize:images`, and Agent projects
116
118
  add `format:py`, `lint:py`, `typecheck:py`, and `check:py`.
117
119
 
120
+ ### Files written by github
121
+
122
+ `--add github` writes 7 files, all `managed` (re-running `--add github` refreshes them; `--update`
123
+ has no github target):
124
+
125
+ | File | Purpose | Refresh |
126
+ | ------------------------------------- | -------------------------------------------------------------------------------------------- | ------- |
127
+ | `.github/workflows/check.yml` | format, typecheck and tests on push / PR | managed |
128
+ | `.github/workflows/release.yml` | tag release: packages the matrix; macOS MXU ships as `.app` inside a `.dmg` | managed |
129
+ | `.github/workflows/package-smoke.yml` | same target matrix as release, on push / PR; macOS MXU also assembles, signs and smokes | managed |
130
+ | `tools/build-release.mjs` | builds the flat release packages; lifts the macOS MXU GUI binary out of `mxu.app` | managed |
131
+ | `tools/macos-app-bundle.mjs` | assembles `dist/package-mxu` into a signed `.app` and packs it into a `.dmg` | managed |
132
+ | `tools/ci/smoke-macos-app.sh` | runs the Agent from a read-only bundle with `PI_USER_DATA_DIR` so data lands outside the app | managed |
133
+ | `tools/sync-runtime.mjs` | `pnpm sync:runtime`: MaaFW / GUI / (Agent) embedded Python | managed |
134
+
135
+ With MXU enabled, the macOS release asset is a signed `.app` inside a `.dmg` (ad-hoc codesign, no
136
+ notarize). Agent projects honor `PI_USER_DATA_DIR` so `config/` and `debug/` go to a writable data
137
+ directory next to a read-only `.app`. Without MXU, macOS still ships only the MFAA `.tar.gz` and the
138
+ bundle steps are skipped.
139
+
118
140
  ### Files written by android
119
141
 
120
142
  `--add android` connects the project to the MaaFwApp shell (Kotlin/Gradle) that CI turns into an APK:
@@ -24,6 +24,8 @@ Git 初始化默认开启:目标不在已有 Git 仓库内时,创建(含 `
24
24
 
25
25
  交互式创建的默认值:项目目录 `maa-project`(项目 ID 由目录名推导,推导不出合法 ID 时才追问)、显示名取目录名、项目类型 `pipeline`、license `AGPL-3.0-or-later`、控制目标 `Adb`、仓库预设「全部」、不添加额外资源包;Git 初始化按上一条规则。`--yes --no-interactive` 使用同一套默认值。
26
26
 
27
+ 项目 ID(`--slug` 或从目录名推导)会成为发布包里的 GUI 可执行文件名,因此不能与包内顶层路径或运行时入口冲突:`mxu`、`python`、`resource`、`maafw`、`agent` 等保留名在**新创建**和显式 `--slug` 时会被拒绝。已有项目不会在 `--add github` 时被重验;资源包 slug 仍只走字符规则。
28
+
27
29
  增量能力:
28
30
 
29
31
  ```bash
@@ -99,6 +101,24 @@ dev-tools 的产物(Prettier formatter、`tools/schema/*`、`pnpm install`)
99
101
  `optimize-images` 追加 `optimize:images`,Agent 项目追加 `format:py`、`lint:py`、`typecheck:py`、
100
102
  `check:py`。
101
103
 
104
+ ### github 写入的文件
105
+
106
+ `--add github` 会写入 7 个文件,全部 `managed`(重跑 `--add github` 即刷新;`--update` 没有 github 目标):
107
+
108
+ | 文件 | 用途 | 刷新方式 |
109
+ | ------------------------------------- | ----------------------------------------------------------------------------------- | -------- |
110
+ | `.github/workflows/check.yml` | push / PR 上跑 format、typecheck、测试 | managed |
111
+ | `.github/workflows/release.yml` | tag 发版:按矩阵打包,macOS MXU 走 `.app` + `.dmg`,其余目标仍是 `.zip` / `.tar.gz` | managed |
112
+ | `.github/workflows/package-smoke.yml` | 与 release 同一目标矩阵,push / PR 先打一遍包;macOS MXU 额外组装、签名、只读 smoke | managed |
113
+ | `tools/build-release.mjs` | 打扁平发布包;macOS MXU 的 GUI 入口从 `mxu.app` 提出 | managed |
114
+ | `tools/macos-app-bundle.mjs` | 把 `dist/package-mxu` 组装成签名 `.app` 并打进 `.dmg` | managed |
115
+ | `tools/ci/smoke-macos-app.sh` | 以只读 bundle + `PI_USER_DATA_DIR` 跑 Agent,确认数据目录落在包外 | managed |
116
+ | `tools/sync-runtime.mjs` | `pnpm sync:runtime`:同步 MaaFW / GUI /(Agent)嵌入 Python | managed |
117
+
118
+ 启用 MXU 后,macOS 发布资产是签名的 `.app` 包进 `.dmg`(ad-hoc codesign,没有 notarize)。Agent
119
+ 项目在 Client 设置 `PI_USER_DATA_DIR` 时把 `config/`、`debug/` 写到可写数据目录,以配合只读
120
+ `.app`。未启用 MXU 时 macOS 仍只出 MFAA 的 `.tar.gz`,bundle 步骤会跳过。
121
+
102
122
  ### android 写入的文件
103
123
 
104
124
  `--add android` 把项目接上 MaaFwApp 外壳(Kotlin/Gradle),由 CI 出 APK:
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-maa-project",
3
- "version": "3.7.4",
3
+ "version": "3.8.0",
4
4
  "description": "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects",
5
5
  "keywords": [
6
6
  "maafw",
@@ -59,7 +59,7 @@
59
59
  "esbuild": "0.28.1",
60
60
  "jsonc-parser": "3.3.1",
61
61
  "postject": "1.0.0-alpha.6",
62
- "prettier": "3.9.10",
62
+ "prettier": "3.10.1",
63
63
  "prettier-plugin-multiline-arrays": "4.1.11",
64
64
  "tsx": "4.20.3",
65
65
  "typescript": "5.8.3",
@@ -5,9 +5,11 @@ settings:
5
5
  excludeLinksFromLockfile: false
6
6
 
7
7
  overrides:
8
+ "@hono/node-server": 2.1.6
8
9
  "@vitest/mocker": 4.1.12
9
10
  body-parser: 2.4.0
10
11
  fast-uri: 3.1.9
12
+ hono: 4.13.16
11
13
  ip-address: 10.7.4
12
14
  qs: 6.16.1
13
15
  source-map-js: 1.2.2
@@ -46,11 +48,11 @@ importers:
46
48
  specifier: 1.0.0-alpha.6
47
49
  version: 1.0.0-alpha.6
48
50
  prettier:
49
- specifier: 3.9.10
50
- version: 3.9.10
51
+ specifier: 3.10.1
52
+ version: 3.10.1
51
53
  prettier-plugin-multiline-arrays:
52
54
  specifier: 4.1.11
53
- version: 4.1.11(prettier@3.9.10)
55
+ version: 4.1.11(prettier@3.10.1)
54
56
  tsx:
55
57
  specifier: 4.20.3
56
58
  version: 4.20.3
@@ -472,12 +474,12 @@ packages:
472
474
  cpu: [x64]
473
475
  os: [win32]
474
476
 
475
- "@hono/node-server@2.1.3":
477
+ "@hono/node-server@2.1.6":
476
478
  resolution:
477
- {integrity: sha512-TA//nWMqPhbfdfneACk6t5a9eqbS9lABEPyKn0/xZTah3H3U2XaVg85rJFl0/Fyit0I552YDHgXGVSf3GwqbUw==}
479
+ {integrity: sha512-p/KH9MnfNcsm3sR6x4lNgm5j+QN4Et8srKredl9DZfXiyZ1UQ3aQ2YVpFLbqktYN5JI+DB+VZFKM2PqE5hLKjQ==}
478
480
  engines: {node: ">=20"}
479
481
  peerDependencies:
480
- hono: ^4
482
+ hono: 4.13.16
481
483
 
482
484
  "@jridgewell/resolve-uri@3.1.2":
483
485
  resolution:
@@ -1067,9 +1069,9 @@ packages:
1067
1069
  {integrity: sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==}
1068
1070
  engines: {node: ">= 0.4"}
1069
1071
 
1070
- hono@4.13.13:
1072
+ hono@4.13.16:
1071
1073
  resolution:
1072
- {integrity: sha512-CQ46U0ZkAGmbT/4UxdzzGJpacP2IeKgY4a5/tOI9AABbpOMfK739wfDXmv1usCk+3RkKj1hQy4/fjhiwa2xlrA==}
1074
+ {integrity: sha512-AOLOEhvrV+iH92xXCnFr/5+3KjPKcI3xP63XJtX5spAnkznPdHijlIsUTpi7/9EhWqrTCekw5c5zh1K+YsVw7A==}
1073
1075
  engines: {node: ">=16.9.0"}
1074
1076
 
1075
1077
  html-escaper@2.0.2:
@@ -1281,9 +1283,9 @@ packages:
1281
1283
  peerDependencies:
1282
1284
  prettier: ">=3.0.0 <4.0.0"
1283
1285
 
1284
- prettier@3.9.10:
1286
+ prettier@3.10.1:
1285
1287
  resolution:
1286
- {integrity: sha512-skGHTH1Yb9QvaTC4hWnRTzEYtCpApF0UMBPz+t/0ZPzP8ihefo/btKd+QA7pUE0fEwA1SbS/NmhyEcstdXOIdA==}
1288
+ {integrity: sha512-70vp3ZUYoPlFbF9uiTdXHUUCGEIp7d4+6p+8DYbkm2jP7x/3i/paXVF6dopSI3zd/CEitrZN1rc4i85xWmmXlg==}
1287
1289
  engines: {node: ">=14"}
1288
1290
  hasBin: true
1289
1291
 
@@ -1796,9 +1798,9 @@ snapshots:
1796
1798
  "@esbuild/win32-x64@0.28.1":
1797
1799
  optional: true
1798
1800
 
1799
- "@hono/node-server@2.1.3(hono@4.13.13)":
1801
+ "@hono/node-server@2.1.6(hono@4.13.16)":
1800
1802
  dependencies:
1801
- hono: 4.13.13
1803
+ hono: 4.13.16
1802
1804
 
1803
1805
  "@jridgewell/resolve-uri@3.1.2": {}
1804
1806
 
@@ -1811,7 +1813,7 @@ snapshots:
1811
1813
 
1812
1814
  "@modelcontextprotocol/sdk@1.32.1(zod@4.6.6)":
1813
1815
  dependencies:
1814
- "@hono/node-server": 2.1.3(hono@4.13.13)
1816
+ "@hono/node-server": 2.1.6(hono@4.13.16)
1815
1817
  ajv: 8.20.0
1816
1818
  ajv-formats: 3.0.1(ajv@8.20.0)
1817
1819
  content-type: 1.0.5
@@ -1821,7 +1823,7 @@ snapshots:
1821
1823
  eventsource-parser: 3.1.1
1822
1824
  express: 5.2.1
1823
1825
  express-rate-limit: 8.7.1(express@5.2.1)
1824
- hono: 4.13.13
1826
+ hono: 4.13.16
1825
1827
  jose: 6.2.12
1826
1828
  json-schema-typed: 8.0.2
1827
1829
  pkce-challenge: 5.0.1
@@ -2287,7 +2289,7 @@ snapshots:
2287
2289
  dependencies:
2288
2290
  function-bind: 1.1.2
2289
2291
 
2290
- hono@4.13.13: {}
2292
+ hono@4.13.16: {}
2291
2293
 
2292
2294
  html-escaper@2.0.2: {}
2293
2295
 
@@ -2412,14 +2414,14 @@ snapshots:
2412
2414
  dependencies:
2413
2415
  commander: 9.5.0
2414
2416
 
2415
- prettier-plugin-multiline-arrays@4.1.11(prettier@3.9.10):
2417
+ prettier-plugin-multiline-arrays@4.1.11(prettier@3.10.1):
2416
2418
  dependencies:
2417
2419
  "@augment-vir/assert": 32.2.4
2418
2420
  "@augment-vir/common": 32.2.4
2419
- prettier: 3.9.10
2421
+ prettier: 3.10.1
2420
2422
  proxy-vir: 2.0.4
2421
2423
 
2422
- prettier@3.9.10: {}
2424
+ prettier@3.10.1: {}
2423
2425
 
2424
2426
  proxy-addr@2.0.8:
2425
2427
  dependencies:
@@ -1,9 +1,11 @@
1
1
  allowBuilds:
2
2
  esbuild: false
3
3
  overrides:
4
+ "@hono/node-server": 2.1.6
4
5
  "@vitest/mocker": 4.1.12
5
6
  body-parser: 2.4.0
6
7
  fast-uri: 3.1.9
8
+ hono: 4.13.16
7
9
  ip-address: 10.7.4
8
10
  qs: 6.16.1
9
11
  source-map-js: 1.2.2
@@ -0,0 +1 @@
1
+ __version__ = "3.8.0"
@@ -0,0 +1,2 @@
1
+ # Filled by the release workflow when publishing the PyPI wrapper.
2
+ RELEASE_MANIFEST_SHA256 = "b26c08c3b6a74c7cc1bce275d82c5ec6ddd2c5789238bc56685b345c99032535"
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "create-maa-project"
3
- version = "3.7.4"
3
+ version = "3.8.0"
4
4
  description = "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects"
5
5
  keywords = ["maafw", "scaffold", "mcp"]
6
6
  readme = "README.md"