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.
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/ci.yml +64 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.release/create-maa-project-manifest.json +26 -26
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/CHANGELOG.md +64 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/PKG-INFO +3 -3
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/README.en.md +6 -2
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/README.md +2 -2
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/commands.en.md +22 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/commands.md +20 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/package.json +2 -2
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pnpm-lock.yaml +20 -18
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pnpm-workspace.yaml +2 -0
- create_maa_project-3.8.0/py-wrapper/create_maa_project/__init__.py +1 -0
- create_maa_project-3.8.0/py-wrapper/create_maa_project/release_manifest.py +2 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/pyproject.toml +1 -1
- create_maa_project-3.8.0/scripts/test-python.mjs +128 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/SKILL.md +9 -1
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/references/commands.md +23 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/scaffold.ts +2 -1
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/template-deps.json +2 -2
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/templates.ts +24 -2
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/utils.ts +48 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/package-smoke.yml +88 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/release.yml +61 -15
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/tools/build-release.mjs +16 -2
- create_maa_project-3.8.0/templates/addons/github/tools/ci/smoke-macos-app.sh +107 -0
- create_maa_project-3.8.0/templates/addons/github/tools/macos-app-bundle.mjs +636 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/agent_runtime.py +22 -4
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/action/general.py +1 -1
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/reco/general.py +1 -1
- create_maa_project-3.8.0/templates/agent/agent/main.py +48 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/logger.py +81 -5
- create_maa_project-3.8.0/templates/agent/agent/utils/runtime_paths.py +120 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/pyproject.toml +1 -1
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/requirements.in +1 -1
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface.schema.json +58 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface_config.schema.json +58 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/pipeline.schema.json +38 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/schema-manifest.json +3 -3
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/android-addon.test.ts +1 -1
- create_maa_project-3.8.0/tests/macos-app-bundle.test.ts +292 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/package-smoke-workflow.test.ts +28 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/scaffold.test.ts +25 -6
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/templates.test.ts +155 -0
- create_maa_project-3.8.0/tests/test_agent_logger.py +126 -0
- create_maa_project-3.8.0/tests/test_agent_runtime_paths.py +120 -0
- create_maa_project-3.8.0/tests/utils.test.ts +48 -0
- create_maa_project-3.7.4/py-wrapper/create_maa_project/__init__.py +0 -1
- create_maa_project-3.7.4/py-wrapper/create_maa_project/release_manifest.py +0 -2
- create_maa_project-3.7.4/scripts/test-python.mjs +0 -56
- create_maa_project-3.7.4/templates/agent/agent/main.py +0 -35
- create_maa_project-3.7.4/templates/agent/agent/utils/runtime_paths.py +0 -50
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.editorconfig +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.gitattributes +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/cliff.toml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/deps-audit.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/deps-sync.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/network-assets.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/release.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.github/workflows/schema-sync.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.gitignore +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.prettierignore +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/.prettierrc.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/AGENTS.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/LICENSE +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/RELEASING.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/android-packaging-plan.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/json-report.en.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/json-report.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/mcp.en.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/docs/mcp.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/py-wrapper/create_maa_project/__main__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/build-sea.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/build.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/changelog-notes.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/check-network-assets.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-release-manifest.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-sbom.d.mts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/create-sbom.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/prepare-pypi-release.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/smoke-cli-artifact.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-release-version.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-schema.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/sync-template-deps.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/scripts/update-audit-overrides.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/README.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/agents/openai.yaml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/skills/create-maa-project/references/json-report.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/addons.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/android.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/args.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/assets.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/auto-update.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/command.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/controllers.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/doctor.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/features.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/incremental-addons.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/index.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/lang.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/log.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/maafw-version.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/mcp.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/node-support.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/project-config.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/project.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/prompt.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/report.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/semver.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/sync.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/template-deps.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/types.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/update-targets.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/update.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/src/version.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/.github/workflows/android-build.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/.github/workflows/android.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/README.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/profile.agent.yaml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/Android/profile.pipeline.yaml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/android/tools/android-packaging.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/auto-format/.github/workflows/format.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/CONTRIBUTING.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/PULL_REQUEST_TEMPLATE.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/bug_report.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/feature_request.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/issue_config.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/community/other_issue.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dependabot/.github/dependabot.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/extensions.agent.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/extensions.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/launch.agent.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/settings.agent.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/settings.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/tasks.agent.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/.vscode/tasks.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/package.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/pnpm-workspace.yaml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/dev-tools/tools/validate-schema.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/git-cliff/.github/cliff.toml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/.github/workflows/check.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/github/tools/sync-runtime.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/optimize-images/.github/workflows/optimize-images.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/optimize-images/tools/optimize-images.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/schema-sync/.github/workflows/schema-sync.yml +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/addons/schema-sync/tools/sync-schema.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/README.en.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/README.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/action/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/reco/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/custom/sink/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/maafw_paths.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/__init__.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/maa_types.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/params.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/agent/utils/pienv.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/requirements.txt +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/tools/schema/custom.action.schema.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/tools/schema/custom.recognition.schema.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/agent/uv.lock +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.editorconfig +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.gitattributes +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.gitignore +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.prettierignore +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/.prettierrc.mjs +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/README.en.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/README.md +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/gitignore.tmpl +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/interface.json.tmpl +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/licenses/AGPL-3.0-or-later.txt +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/licenses/MIT.txt +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/maatools.config.mts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/default_pipeline.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/image/empty.png +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/model/ocr/manifest.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/resource/base/pipeline/Tutorial/Tutorial.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tasks/tutorial.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/custom.action.schema.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/custom.recognition.schema.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/templates/base/tools/schema/interface_import.schema.json +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/addons.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/android-packaging.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/args.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/auto-update.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/backup-operations.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/changelog-notes.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/child-env.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/cli-info.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/command.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/doctor-errors.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/enabled-config.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/git-initialization.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/incremental-addons-results.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/lang.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/maafw-version.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/mcp.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/node-support.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/ocr-git-registration.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/project-config.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/project.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/prompt-interactive.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/prompt.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/release-smoke.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/release-workflow.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/report.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/sbom.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/semver.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/template-deps.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/test_py_wrapper.py +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tests/update-audit-overrides.test.ts +0 -0
- {create_maa_project-3.7.4 → create_maa_project-3.8.0}/tsconfig.json +0 -0
- {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
|
{create_maa_project-3.7.4 → create_maa_project-3.8.0}/.release/create-maa-project-manifest.json
RENAMED
|
@@ -1,68 +1,68 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
3
|
"name": "create-maa-project",
|
|
4
|
-
"version": "3.
|
|
5
|
-
"tag": "v3.
|
|
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.
|
|
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.
|
|
14
|
-
"sha256": "
|
|
15
|
-
"size":
|
|
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.
|
|
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.
|
|
24
|
-
"sha256": "
|
|
25
|
-
"size":
|
|
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.
|
|
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.
|
|
34
|
-
"sha256": "
|
|
35
|
-
"size":
|
|
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.
|
|
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.
|
|
44
|
-
"sha256": "
|
|
45
|
-
"size":
|
|
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.
|
|
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.
|
|
54
|
-
"sha256": "
|
|
55
|
-
"size":
|
|
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.
|
|
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.
|
|
64
|
-
"sha256": "
|
|
65
|
-
"size":
|
|
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.
|
|
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
|
|
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
|
|
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
|
|
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.
|
|
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.
|
|
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.
|
|
50
|
-
version: 3.
|
|
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.
|
|
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.
|
|
477
|
+
"@hono/node-server@2.1.6":
|
|
476
478
|
resolution:
|
|
477
|
-
{integrity: sha512-
|
|
479
|
+
{integrity: sha512-p/KH9MnfNcsm3sR6x4lNgm5j+QN4Et8srKredl9DZfXiyZ1UQ3aQ2YVpFLbqktYN5JI+DB+VZFKM2PqE5hLKjQ==}
|
|
478
480
|
engines: {node: ">=20"}
|
|
479
481
|
peerDependencies:
|
|
480
|
-
hono:
|
|
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.
|
|
1072
|
+
hono@4.13.16:
|
|
1071
1073
|
resolution:
|
|
1072
|
-
{integrity: sha512-
|
|
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.
|
|
1286
|
+
prettier@3.10.1:
|
|
1285
1287
|
resolution:
|
|
1286
|
-
{integrity: sha512-
|
|
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.
|
|
1801
|
+
"@hono/node-server@2.1.6(hono@4.13.16)":
|
|
1800
1802
|
dependencies:
|
|
1801
|
-
hono: 4.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.
|
|
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.
|
|
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.
|
|
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.
|
|
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.
|
|
2421
|
+
prettier: 3.10.1
|
|
2420
2422
|
proxy-vir: 2.0.4
|
|
2421
2423
|
|
|
2422
|
-
prettier@3.
|
|
2424
|
+
prettier@3.10.1: {}
|
|
2423
2425
|
|
|
2424
2426
|
proxy-addr@2.0.8:
|
|
2425
2427
|
dependencies:
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
__version__ = "3.8.0"
|