create-maa-project 1.2.2__tar.gz → 2.0.0__tar.gz

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/.release/create-maa-project-manifest.json

@@ -1,68 +1,68 @@
 {
     "schemaVersion": 1,
     "name": "create-maa-project",
-    "version": "1.2.2",
-    "tag": "v1.2.2",
+    "version": "2.0.0",
+    "tag": "v2.0.0",
     "assets": [
         {
             "kind": "sea",
             "os": "linux",
             "arch": "aarch64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-linux-aarch64",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-linux-aarch64",
-            "sha256": "302f1b94b68ead54ccfd7da68c5f0631fe2ea354469cc59da9238325cec6cc8f",
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-linux-aarch64",
+            "sha256": "e9f66b8c95f8a06a393216c3c50d8b032fcb4cbe54495c62d49156167e0b650a",
             "size": 123145344
         },
         {
             "kind": "sea",
             "os": "linux",
             "arch": "x86_64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-linux-x86_64",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-linux-x86_64",
-            "sha256": "8ee14bcb3fafea060891cf98b2a131381065c7053019ac4eb1d6dffc4fa36ff6",
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-linux-x86_64",
+            "sha256": "853215e9e7004fb4e90bdba933a3665af7aac01b15497c0ef2f16d85aaea06dd",
             "size": 125045952
         },
         {
             "kind": "sea",
             "os": "macos",
             "arch": "aarch64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-macos-aarch64",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-macos-aarch64",
-            "sha256": "b5cac2f528e7029224283dd7f623f85b6ab6199476ee6d29742d3323352119e4",
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-macos-aarch64",
+            "sha256": "5d88be2d4be7662247fc94ab575dacb102c03e99e1de2c2f252c7d90a917cdd0",
             "size": 121408240
         },
         {
             "kind": "sea",
             "os": "macos",
             "arch": "x86_64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-macos-x86_64",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-macos-x86_64",
-            "sha256": "05bb2f42843ce33bcb76e2dd701050ce224905bb08e5c620a4a6c62d7bb5da85",
-            "size": 124472240
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-macos-x86_64",
+            "sha256": "8c312a395c561982602d392733b5ee15bde172e18315b9181bb4eff2fc56d7dc",
+            "size": 124480496
         },
         {
             "kind": "sea",
             "os": "win",
             "arch": "aarch64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-win-aarch64.exe",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-win-aarch64.exe",
-            "sha256": "a554bdc37a181d7a407b1027effe5913a33833cea59c7707e1ec1fdd01df6342",
-            "size": 82560000
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-win-aarch64.exe",
+            "sha256": "03d7d2b754aa7cd7808d49154de6d13cf2d61bece93e127f2e2e67ad86cebde6",
+            "size": 82569728
         },
         {
             "kind": "sea",
             "os": "win",
             "arch": "x86_64",
-            "version": "1.2.2",
+            "version": "2.0.0",
             "name": "create-maa-project-win-x86_64.exe",
-            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v1.2.2/create-maa-project-win-x86_64.exe",
-            "sha256": "8a70811812de26fe0b9b51eb7908bd411351bfdbfe20da857bae82fb6d86db5c",
-            "size": 94026240
+            "url": "https://github.com/Windsland52/create-maa-project/releases/download/v2.0.0/create-maa-project-win-x86_64.exe",
+            "sha256": "4bc035d226f5c220026cc9b8d4802386524e94c8ddabea5fd8b104ea8fbf81ec",
+            "size": 94035968
         }
     ]
 }

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: create-maa-project
-Version: 1.2.2
+Version: 2.0.0
 Summary: 用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects
 Project-URL: Homepage, https://github.com/Windsland52/create-maa-project
 Project-URL: Source, https://github.com/Windsland52/create-maa-project
@@ -192,7 +192,7 @@ CLI 只在首次创建时写入 `interface.json`、`package.json`、`tasks/`、`
 
 进入 Git 的状态文件：
 
-- `maa-project.json`：用户意图，包括项目元数据、功能/插件选择、资源包、runtime channel、网络模式、license 和 Agent 配置。
+- `maa-project.json`：用户意图，包括项目元数据、功能/插件选择、资源包、runtime channel/version、网络模式、license 和 Agent 配置。`version` 非空时精确版本优先；为空时按 `stable`、`beta`（含 rc）或 `alpha` channel 解析。
 - `maa-project.lock.json`：resolved 状态、pending actions、模板版本和 managed file hash。
 
 本机状态放在 `.create-maa-project/`，生成项目默认忽略该目录：

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/README.md

@@ -181,7 +181,7 @@ CLI 只在首次创建时写入 `interface.json`、`package.json`、`tasks/`、`
 
 进入 Git 的状态文件：
 
-- `maa-project.json`：用户意图，包括项目元数据、功能/插件选择、资源包、runtime channel、网络模式、license 和 Agent 配置。
+- `maa-project.json`：用户意图，包括项目元数据、功能/插件选择、资源包、runtime channel/version、网络模式、license 和 Agent 配置。`version` 非空时精确版本优先；为空时按 `stable`、`beta`（含 rc）或 `alpha` channel 解析。
 - `maa-project.lock.json`：resolved 状态、pending actions、模板版本和 managed file hash。
 
 本机状态放在 `.create-maa-project/`，生成项目默认忽略该目录：

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/package.json

@@ -1,6 +1,6 @@
 {
     "name": "create-maa-project",
-    "version": "1.2.2",
+    "version": "2.0.0",
     "description": "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects",
     "keywords": [
         "maafw",

create_maa_project-2.0.0/py-wrapper/create_maa_project/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.0.0"

create_maa_project-2.0.0/py-wrapper/create_maa_project/release_manifest.py

@@ -0,0 +1,2 @@
+# Filled by the release workflow when publishing the PyPI wrapper.
+RELEASE_MANIFEST_SHA256 = "d0166adee9ea89fd8487c9469bdd50b0a37a67baf6645190e0197c35dd5f642d"

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "create-maa-project"
-version = "1.2.2"
+version = "2.0.0"
 description = "用于创建和维护 MaaFW 应用项目的脚手架 CLI / Scaffold and maintenance CLI for MaaFW application projects"
 keywords = ["maafw", "scaffold", "mcp"]
 readme = "README.md"

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/src/assets.ts

@@ -28,6 +28,7 @@ export type ProductAssetManifest = Omit<AssetManifest, 'assets'> & {
 export type ProductAssetManifestRequest = {
   product: string
   channel?: string
+  version?: string
   platform?: string
 }
 
@@ -167,8 +168,12 @@ export async function resolveProductAssetManifestFromGithubRelease(
   const requestedPlatform = resolveRequestedRuntimePlatform(request.platform)
   if (!requestedPlatform) return undefined
   const selectedPlatform = requestedPlatform === 'all' ? undefined : requestedPlatform
-  const release = await fetchGithubRelease(config, request.channel ?? 'latest', options.fetchJson)
-  return parseGithubReleaseManifest(config, release, request.channel ?? 'latest', selectedPlatform)
+  const channel = normalizeReleaseChannel(request.channel)
+  const version = request.version?.trim()
+  const release = version
+    ? await fetchGithubReleaseByTag(config, version, options.fetchJson)
+    : await fetchGithubReleaseByChannel(config, channel, options.fetchJson)
+  return parseGithubReleaseManifest(config, release, channel, selectedPlatform)
 }
 
 export async function downloadManifestAssets(
@@ -567,15 +572,60 @@ function isIgnoredArchiveEntry(path: string): boolean {
   return lower === '.ds_store' || lower.endsWith('/.ds_store') || lower.startsWith('__macosx/')
 }
 
-async function fetchGithubRelease(
+async function fetchGithubReleaseByTag(
+  config: ProductReleaseConfig,
+  tag: string,
+  fetchJson: GithubReleaseJsonFetcher = defaultGithubReleaseJsonFetch,
+): Promise<unknown> {
+  return fetchJson(
+    `https://api.github.com/repos/${config.owner}/${config.repo}/releases/tags/${encodeURIComponent(tag)}`,
+    {
+      headers: githubRequestHeaders(),
+    },
+  )
+}
+
+async function fetchGithubReleaseByChannel(
   config: ProductReleaseConfig,
   channel: string,
   fetchJson: GithubReleaseJsonFetcher = defaultGithubReleaseJsonFetch,
 ): Promise<unknown> {
-  const releasePath = channel === 'latest' ? 'latest' : `tags/${encodeURIComponent(channel)}`
-  return fetchJson(`https://api.github.com/repos/${config.owner}/${config.repo}/releases/${releasePath}`, {
-    headers: githubRequestHeaders(),
-  })
+  if (channel === 'stable') {
+    return fetchJson(`https://api.github.com/repos/${config.owner}/${config.repo}/releases/latest`, {
+      headers: githubRequestHeaders(),
+    })
+  }
+  if (channel !== 'beta' && channel !== 'alpha') {
+    return fetchGithubReleaseByTag(config, channel, fetchJson)
+  }
+  const releases = await fetchJson(
+    `https://api.github.com/repos/${config.owner}/${config.repo}/releases?per_page=100`,
+    { headers: githubRequestHeaders() },
+  )
+  if (!Array.isArray(releases)) throw new Error(`Invalid GitHub releases payload for ${config.product}.`)
+  const release = releases.find((value) => isReleaseAllowedForChannel(value, channel))
+  if (!release) throw new Error(`No ${config.product} release found for channel ${channel}.`)
+  return release
+}
+
+function normalizeReleaseChannel(channel: string | undefined): string {
+  const value = channel?.trim() || 'stable'
+  return value === 'latest' ? 'stable' : value
+}
+
+function isReleaseAllowedForChannel(value: unknown, channel: 'beta' | 'alpha'): boolean {
+  if (!isRecord(value) || value.draft === true || typeof value.tag_name !== 'string') return false
+  const maturity = releaseMaturity(value.tag_name)
+  const priority = { stable: 2, beta: 1, alpha: 0 }
+  return priority[maturity] >= priority[channel]
+}
+
+function releaseMaturity(tag: string): 'stable' | 'beta' | 'alpha' {
+  const lower = tag.toLowerCase()
+  if (/(?:^|[.-])alpha(?:[.-]|$)/.test(lower)) return 'alpha'
+  if (/(?:^|[.-])beta(?:[.-]|$)/.test(lower)) return 'beta'
+  if (/(?:^|[.-])rc(?:[.-]|$)/.test(lower)) return 'beta'
+  return 'stable'
 }
 
 async function defaultGithubReleaseJsonFetch(

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/src/project.ts

@@ -7,6 +7,7 @@ import type {
   ManagedFileInput,
   ManagedFileState,
   PendingItem,
+  ReleaseChannel,
 } from './types.js'
 import { exists, nowIso, readText, sha256, stableJson, writeText } from './utils.js'
 
@@ -19,7 +20,60 @@ export async function readProjectConfig(root: string): Promise<MaaProjectConfig>
   if (!(await exists(configPath))) {
     throw new Error(`No ${CONFIG_FILE} found. Run this command in a MaaFW project root.`)
   }
-  return JSON.parse(await readText(configPath)) as MaaProjectConfig
+  const config = JSON.parse(await readText(configPath)) as MaaProjectConfig
+  return migrateProjectConfig(config)
+}
+
+function migrateProjectConfig(config: MaaProjectConfig): MaaProjectConfig {
+  if (config.schemaVersion !== 1 && config.schemaVersion !== 2) {
+    throw new Error(`Unsupported maa-project.json schemaVersion: ${String(config.schemaVersion)}`)
+  }
+  if (config.schemaVersion === 1) {
+    migrateReleaseSelector(config.maafw)
+    migrateReleaseSelector(config.runtime.mfa)
+    if (config.runtime.mxu) migrateReleaseSelector(config.runtime.mxu)
+    config.schemaVersion = 2
+  }
+  normalizeReleaseSelector(config.maafw, 'maafw')
+  normalizeReleaseSelector(config.runtime.mfa, 'runtime.mfa')
+  if (config.runtime.mxu) normalizeReleaseSelector(config.runtime.mxu, 'runtime.mxu')
+  return config
+}
+
+function normalizeReleaseSelector(selector: { channel: string; version?: string }, path: string): void {
+  selector.channel = selector.channel.trim()
+  selector.version = selector.version?.trim() ?? ''
+  if (!isReleaseChannel(selector.channel)) {
+    throw new Error(`${path}.channel must be one of: stable, beta, alpha`)
+  }
+}
+
+function migrateReleaseSelector(selector: { channel: string; version?: string }): void {
+  const legacy = selector.channel.trim()
+  if (legacy === 'latest') {
+    selector.channel = 'stable'
+    selector.version = ''
+    return
+  }
+  if (isReleaseChannel(legacy)) {
+    selector.channel = legacy
+    selector.version = ''
+    return
+  }
+  selector.channel = inferReleaseChannel(legacy)
+  selector.version = legacy
+}
+
+function isReleaseChannel(value: string): value is ReleaseChannel {
+  return value === 'stable' || value === 'beta' || value === 'alpha'
+}
+
+function inferReleaseChannel(version: string): ReleaseChannel {
+  const lower = version.toLowerCase()
+  if (/(?:^|[.-])alpha(?:[.-]|$)/.test(lower)) return 'alpha'
+  if (/(?:^|[.-])beta(?:[.-]|$)/.test(lower)) return 'beta'
+  if (/(?:^|[.-])rc(?:[.-]|$)/.test(lower)) return 'beta'
+  return 'stable'
 }
 
 export async function readProjectLock(root: string): Promise<MaaProjectLock> {
@@ -27,12 +81,17 @@ export async function readProjectLock(root: string): Promise<MaaProjectLock> {
   if (!(await exists(lockPath))) {
     return emptyLock('unknown')
   }
-  return JSON.parse(await readText(lockPath)) as MaaProjectLock
+  const lock = JSON.parse(await readText(lockPath)) as MaaProjectLock
+  if (lock.schemaVersion !== 1 && lock.schemaVersion !== 2) {
+    throw new Error(`Unsupported maa-project.lock.json schemaVersion: ${String(lock.schemaVersion)}`)
+  }
+  if (lock.schemaVersion === 1) lock.schemaVersion = 2
+  return lock
 }
 
 export function emptyLock(version: string): MaaProjectLock {
   return {
-    schemaVersion: 1,
+    schemaVersion: 2,
     template: {
       createdBy: 'create-maa-project',
       lastUpdatedBy: 'create-maa-project',
@@ -45,6 +104,9 @@ export function emptyLock(version: string): MaaProjectLock {
 }
 
 export async function writeProjectState(root: string, config: MaaProjectConfig, lock: MaaProjectLock): Promise<void> {
+  if (config.schemaVersion !== lock.schemaVersion) {
+    throw new Error('maa-project.json and maa-project.lock.json schemaVersion must match')
+  }
   const configContent = stableJson(config)
   delete lock.managedFiles[CONFIG_FILE]
   delete lock.managedFiles[LOCK_FILE]

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/src/scaffold.ts

@@ -646,7 +646,7 @@ function createConfig(input: {
   const includeDevTools = input.resolvedAddons.includes('dev-tools')
   const includeGithub = input.resolvedAddons.includes('github')
   const config: MaaProjectConfig = {
-    schemaVersion: 1,
+    schemaVersion: 2,
     project: {
       slug: input.slug,
       displayName: input.displayName,
@@ -665,11 +665,13 @@ function createConfig(input: {
     },
     resources: initialResources(input.options),
     maafw: {
-      channel: 'latest',
+      channel: 'stable',
+      version: '',
     },
     runtime: {
       mfa: {
-        channel: 'latest',
+        channel: 'stable',
+        version: '',
         enabled: includeGithub,
       },
     },

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/src/types.ts

@@ -3,8 +3,9 @@ export type ControllerKind = 'Adb' | 'Win32' | 'MacOS' | 'PlayCover' | 'Gamepad'
 export type LicenseKind = 'AGPL-3.0-or-later' | 'MIT' | 'None'
 export type NetworkMode = 'auto' | 'official'
 export type CliLanguage = 'auto' | 'en' | 'zh-CN'
+export type ReleaseChannel = 'stable' | 'beta' | 'alpha'
 export type MaaProjectConfig = {
-  schemaVersion: 1
+  schemaVersion: 1 | 2
   project: {
     slug: string
     displayName: string
@@ -25,7 +26,8 @@ export type MaaProjectConfig = {
   }
   resources: ResourcePackConfig[]
   maafw: {
-    channel: 'latest' | string
+    channel: ReleaseChannel | string
+    version?: string
   }
   runtime: {
     mfa: RuntimeGuiConfig
@@ -46,7 +48,8 @@ export type MaaProjectConfig = {
 }
 
 export type RuntimeGuiConfig = {
-  channel: 'latest' | string
+  channel: ReleaseChannel | string
+  version?: string
   enabled: boolean
 }
 
@@ -68,7 +71,7 @@ export type ResourcePackConfig = {
 }
 
 export type MaaProjectLock = {
-  schemaVersion: 1
+  schemaVersion: 1 | 2
   template: {
     createdBy: string
     lastUpdatedBy: string

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/src/update.ts

@@ -198,6 +198,7 @@ export async function recordUpdateRequests(
               {
                 product: 'MaaFramework',
                 channel: config.maafw.channel,
+                version: config.maafw.version ?? '',
               },
               environment,
             ),
@@ -219,6 +220,7 @@ export async function recordUpdateRequests(
               {
                 product: 'MFAAvalonia',
                 channel: config.runtime.mfa.channel,
+                version: config.runtime.mfa.version ?? '',
               },
               environment,
             ),
@@ -244,6 +246,7 @@ export async function recordUpdateRequests(
               {
                 product: 'MXU',
                 channel: config.runtime.mxu.channel,
+                version: config.runtime.mxu.version ?? '',
               },
               environment,
             ),

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/templates/addons/dev-tools/tools/check-project.mjs

@@ -6,6 +6,10 @@ const project = JSON.parse(readFileSync("maa-project.json", "utf8"));
 const lock = JSON.parse(readFileSync("maa-project.lock.json", "utf8"));
 const imports = interfaceJson.import ?? [];
 
+if (project.schemaVersion !== lock.schemaVersion) {
+    throw new Error("maa-project.json and maa-project.lock.json schemaVersion must match");
+}
+
 if (interfaceJson.name !== project.project?.slug) {
     console.warn("[INFO] interface.json name differs from maa-project.json project.slug; this is allowed.");
 }

{create_maa_project-1.2.2 → create_maa_project-2.0.0}/templates/addons/github/tools/build-release.mjs

@@ -10,11 +10,13 @@ import {
     statSync,
     writeFileSync,
 } from "node:fs";
+import {createHash} from "node:crypto";
 import {basename, dirname, join} from "node:path";
 
 const dryRun = process.argv.includes("--dry-run");
 const projectSlug = {{projectSlug}};
 const releaseArtifactName = {{releaseArtifactName}};
+const requirementsMarker = ".create-maa-project-requirements.sha256";
 mkdirSync("dist", {recursive: true});
 
 const lock = readJson("maa-project.lock.json");
@@ -278,6 +280,7 @@ function prepareReleasePackage(guiKey, gui, packagePaths, interfaceJson, runtime
     }
     if (packageHasAgent(interfaceJson) && hasEmbeddedPythonRuntime(runtimePlatform)) {
         copyPath(pythonRuntimePath(runtimePlatform), join(pkgDir, "python"));
+        writeEmbeddedRequirementsMarker(pkgDir);
     }
     if (!gui.flatLayout) {
         prepareMxuMaafwRuntime(pkgDir, runtimePlatform);
@@ -364,6 +367,17 @@ function smokeReleasePackage(gui, root, packagePaths, runtimePlatform) {
         if (!existsSync(join(root, "agent", "bootstrap.py"))) {
             throw new Error("release package smoke failed: Agent bootstrap is missing");
         }
+        if (hasEmbeddedPythonRuntime(runtimePlatform)) {
+            const markerPath = join(root, "python", requirementsMarker);
+            if (!existsSync(markerPath)) {
+                throw new Error("release package smoke failed: Python requirements marker is missing");
+            }
+            const expectedDigest = requirementsDigest(join(root, "requirements.txt"));
+            const actualDigest = readFileSync(markerPath, "utf8").trim();
+            if (actualDigest !== expectedDigest) {
+                throw new Error("release package smoke failed: Python requirements marker does not match requirements.txt");
+            }
+        }
     }
     assertUnixExecutablePermissions(root, runtimePlatform);
     for (const path of [
@@ -409,6 +423,15 @@ function copyDirectoryContents(source, target) {
     }
 }
 
+function requirementsDigest(requirementsPath) {
+    return createHash("sha256").update(readFileSync(requirementsPath)).digest("hex");
+}
+
+function writeEmbeddedRequirementsMarker(pkgDir) {
+    const digest = requirementsDigest(join(pkgDir, "requirements.txt"));
+    writeFileSync(join(pkgDir, "python", requirementsMarker), digest + "\n", "utf8");
+}
+
 function shouldCopyAgentPath(source) {
     const name = basename(source).toLowerCase();
     return name !== "__pycache__" && !name.endsWith(".pyc") && !name.endsWith(".pyo");