@applift/cli 0.0.0-stage → 0.1.1

package/dist/bin.mjs

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { n as program } from "./src-CoYlWjDO.mjs";
+//#region src/bin.ts
+program.parseAsync().catch((e) => {
+	process.stderr.write(`✗ ${e.message}\n`);
+	process.exit(1);
+});
+//#endregion
+export {};

package/dist/index.mjs

@@ -0,0 +1 @@
+export { t as makeContext, n as program } from "./src-CoYlWjDO.mjs";

package/dist/src-CoYlWjDO.mjs

@@ -0,0 +1,917 @@
+import { Command } from "commander";
+import * as p from "@clack/prompts";
+import pc from "picocolors";
+import fs from "node:fs";
+import path from "node:path";
+import { AgcHarmonyChannel, AscChannel, GooglePlayChannel, HonorChannel, HuaweiAndroidChannel, OppoChannel, PgyerChannel, PluginHost, VivoChannel, XiaomiChannel, YybChannel, appendEntry, assertListingFiles, detectBundleIds, detectFramework, findArtifacts, humanizeError, loadCredentials, loadCredentialsLayered, loadGlobalConfig, loadListingFile, loadProjectConfig, loadProjectProfileMap, readArtifactVersion, readEntries, registry, resolveListing, resolvePlugins, resolveProfile, resolveProfileFor, runStage, runSubmit, saveCredentials, setProjectProfile, sha256File } from "@applift/core";
+//#region src/target.ts
+function resolveChannelTarget(id, config, detected) {
+	const store = config.android?.stores?.[id] ?? {};
+	if (id === "agc-harmony") return {
+		...detected.harmonyBundleName ? { bundleName: detected.harmonyBundleName } : {},
+		...config.harmony,
+		...store
+	};
+	if (id === "asc") return {
+		...detected.iosBundleId ? { bundleId: detected.iosBundleId } : {},
+		...config.ios,
+		...store
+	};
+	return {
+		...detected.androidPkgName ? { pkgName: detected.androidPkgName } : {},
+		...config.android?.pkgName ? { pkgName: config.android.pkgName } : {},
+		...store
+	};
+}
+//#endregion
+//#region src/lifecycle.ts
+/**
+* init 向导（PM 视角：发版小白一次配置完成）、use 个人 profile 切换与 status 审核跟踪。
+*/
+/** 各渠道在 init/status 场景需要的凭据键与获取指引 */
+const CREDENTIAL_FIELDS = [
+	{
+		key: "PGYER_API_KEY",
+		label: "蒲公英（内测）",
+		where: "pgyer.com → 账号设置 → API"
+	},
+	{
+		key: "AGC_CLIENT_ID",
+		label: "华为 AGC Client ID",
+		where: "AGC → 项目设置 → 常规 → API Client"
+	},
+	{
+		key: "AGC_CLIENT_SECRET",
+		label: "华为 AGC Secret",
+		where: "同上"
+	},
+	{
+		key: "HW_ANDROID_APP_ID",
+		label: "华为安卓 App ID",
+		where: "AGC 我的应用（安卓）"
+	},
+	{
+		key: "MI_USER_NAME",
+		label: "小米账号",
+		where: "dev.mi.com → 管理中心"
+	},
+	{
+		key: "MI_PASSWORD",
+		label: "小米上传密码",
+		where: "同上"
+	},
+	{
+		key: "MI_CERT_PATH",
+		label: "小米证书路径",
+		where: "dev.api.public.cer 绝对路径"
+	},
+	{
+		key: "OPPO_CLIENT_ID",
+		label: "OPPO Client ID",
+		where: "open.oppomobile.com → API 传包"
+	},
+	{
+		key: "OPPO_CLIENT_SECRET",
+		label: "OPPO Secret",
+		where: "同上"
+	},
+	{
+		key: "VIVO_ACCESS_KEY",
+		label: "vivo Access Key",
+		where: "dev.vivo.com.cn → API 传包"
+	},
+	{
+		key: "VIVO_ACCESS_SECRET",
+		label: "vivo Secret",
+		where: "同上"
+	},
+	{
+		key: "HONOR_CLIENT_ID",
+		label: "荣耀 Client ID",
+		where: "developer.honor.com → 设置 → API"
+	},
+	{
+		key: "HONOR_CLIENT_SECRET",
+		label: "荣耀 Secret",
+		where: "同上"
+	},
+	{
+		key: "HONOR_APP_ID",
+		label: "荣耀 App ID",
+		where: "荣耀开发者后台"
+	},
+	{
+		key: "YYB_USER_ID",
+		label: "应用宝 UserID",
+		where: "app.open.qq.com 管理中心"
+	},
+	{
+		key: "YYB_ACCESS_SECRET",
+		label: "应用宝 AccessSecret",
+		where: "同上"
+	},
+	{
+		key: "YYB_APP_ID",
+		label: "应用宝 App ID",
+		where: "同上"
+	},
+	{
+		key: "ASC_KEY_ID",
+		label: "ASC Key ID",
+		where: "App Store Connect → 集成 → 团队密钥"
+	},
+	{
+		key: "ASC_ISSUER_ID",
+		label: "ASC Issuer ID",
+		where: "同上"
+	}
+];
+function registerLifecycleCommands(program, registryRef) {
+	program.command("init").description("向导：检测项目 → 生成 applift.config.ts → 引导配置凭据").option("--cwd <dir>", "项目目录", process.cwd()).action(async (cmdOpts) => {
+		const cwd = path.resolve(cmdOpts.cwd);
+		p.intro(pc.bgCyan(pc.black(" applift init ")));
+		const framework = detectFramework(cwd);
+		if (framework) p.log.success(`框架识别: ${pc.bold(framework.label)}`);
+		else p.log.warn("未识别框架（可继续，产物路径用 --artifact 指定）");
+		const configPath = path.join(cwd, "applift.config.ts");
+		if (fs.existsSync(configPath)) {
+			const overwrite = await p.confirm({ message: `已存在 ${configPath}，覆盖重生成？` });
+			if (p.isCancel(overwrite) || !overwrite) {
+				p.outro("保留现有配置，跳过生成");
+				return;
+			}
+		}
+		const androidPkg = await p.text({
+			message: "安卓包名（如 com.thclouds.driver，可空跳过安卓渠道）",
+			placeholder: "com.example.app"
+		});
+		const harmonyBundle = await p.text({
+			message: "鸿蒙 bundleName（可空跳过鸿蒙）",
+			placeholder: "com.example.app.hm"
+		});
+		const iosScheme = await p.text({
+			message: "iOS scheme（可空跳过 iOS）",
+			placeholder: "MyApp"
+		});
+		const profileName = await p.text({
+			message: "凭据 profile 名",
+			initialValue: "default"
+		});
+		if (p.isCancel(androidPkg) || p.isCancel(harmonyBundle) || p.isCancel(iosScheme) || p.isCancel(profileName)) {
+			p.cancel("已取消");
+			return;
+		}
+		const stores = androidPkg ? `
+  android: {
+    pkgName: ${JSON.stringify(String(androidPkg))},
+    // 按需启用渠道（appId/证书路径等渠道侧配置）
+    stores: {
+      // huawei: { appId: 'xxx' },
+      // honor: { appId: 'xxx' },
+      // oppo: {}, vivo: {}, yyb: { appId: 'xxx' },
+    },
+  },` : "";
+		const harmony = harmonyBundle ? `
+  harmony: {
+    bundleName: ${JSON.stringify(String(harmonyBundle))},
+    // appId: 'xxx',  // 缺省按 bundleName 自动查询
+  },` : "";
+		const ios = iosScheme ? `
+  ios: {
+    scheme: ${JSON.stringify(String(iosScheme))},
+  },` : "";
+		const content = `import { defineConfig } from '@applift/core';
+
+export default defineConfig({
+  profile: ${JSON.stringify(String(profileName || "default"))},${stores}${harmony}${ios}
+  // plugins: [],  // vite 风格钩子：拦截提审/改文案/自定义渠道，见 README
+});
+`;
+		fs.writeFileSync(configPath, content);
+		p.log.success(`已生成 ${pc.bold("applift.config.ts")}`);
+		const doCreds = await p.confirm({
+			message: "现在配置凭据？（写入 ~/.applift/credentials.toml，0600）",
+			initialValue: false
+		});
+		if (p.isCancel(doCreds)) return;
+		if (doCreds) {
+			const creds = loadCredentialsLayered(cmdOpts.cwd);
+			const profile = String(profileName || "default");
+			creds.profiles[profile] ??= {};
+			const group = await p.multiselect({
+				message: "选择要配置的凭据组（空格选择，回车确认）",
+				options: [
+					{
+						value: "beta",
+						label: "内测（蒲公英）"
+					},
+					{
+						value: "huawei",
+						label: "华为（安卓+鸿蒙）"
+					},
+					{
+						value: "xiaomi",
+						label: "小米"
+					},
+					{
+						value: "oppo",
+						label: "OPPO"
+					},
+					{
+						value: "vivo",
+						label: "vivo"
+					},
+					{
+						value: "honor",
+						label: "荣耀"
+					},
+					{
+						value: "yyb",
+						label: "应用宝"
+					},
+					{
+						value: "asc",
+						label: "iOS App Store Connect"
+					}
+				],
+				required: false
+			});
+			if (!p.isCancel(group)) {
+				const groups = {
+					beta: ["PGYER_API_KEY"],
+					huawei: [
+						"AGC_CLIENT_ID",
+						"AGC_CLIENT_SECRET",
+						"HW_ANDROID_APP_ID"
+					],
+					xiaomi: [
+						"MI_USER_NAME",
+						"MI_PASSWORD",
+						"MI_CERT_PATH"
+					],
+					oppo: ["OPPO_CLIENT_ID", "OPPO_CLIENT_SECRET"],
+					vivo: ["VIVO_ACCESS_KEY", "VIVO_ACCESS_SECRET"],
+					honor: [
+						"HONOR_CLIENT_ID",
+						"HONOR_CLIENT_SECRET",
+						"HONOR_APP_ID"
+					],
+					yyb: [
+						"YYB_USER_ID",
+						"YYB_ACCESS_SECRET",
+						"YYB_APP_ID"
+					],
+					asc: ["ASC_KEY_ID", "ASC_ISSUER_ID"]
+				};
+				for (const g of group) for (const key of groups[String(g)] ?? []) {
+					const meta = CREDENTIAL_FIELDS.find((f) => f.key === key);
+					const v = await p.text({
+						message: `${meta.label}（${pc.dim(meta.where)}）`,
+						defaultValue: ""
+					});
+					if (!p.isCancel(v) && String(v).trim()) creds.profiles[profile][key] = String(v).trim();
+				}
+				saveCredentials(creds);
+				p.log.success(`凭据已写入 ~/.applift/credentials.toml（profile: ${pc.bold(profile)}，0600）`);
+			}
+		}
+		p.outro(`下一步: ${pc.cyan("applift doctor")} 体检 → ${pc.cyan("applift beta android")} 发内测`);
+	});
+	program.command("use").description("查看/切换本项目凭据 profile（个人选择写 ~/.applift/projects.json，不进项目/git；项目配置 profile 是团队默认）").argument("[profile]", "目标 profile 名；缺省=查看当前生效与可用列表").option("--cwd <dir>", "项目目录", process.cwd()).action(async (profile, cmdOpts) => {
+		const cwd = path.resolve(cmdOpts.cwd);
+		const available = Object.keys(loadCredentialsLayered(cmdOpts.cwd).profiles);
+		p.intro(pc.bgCyan(pc.black(" applift use ")));
+		const target = profile?.trim();
+		if (!target) {
+			const { config } = await loadProjectConfig(cwd);
+			const source = loadProjectProfileMap()[cwd] ? "个人选择 ~/.applift/projects.json" : config.profile !== "default" ? `项目默认 applift.config.ts → profile: ${config.profile}` : "全局默认";
+			p.log.message(`当前生效 profile: ${pc.bold(resolveProfileFor(cwd, config.profile))} ${pc.dim(`（来源: ${source}）`)}`);
+			p.log.message(available.length > 0 ? `可用 profiles: ${available.join(", ")}` : "可用 profiles: (无 — 先在 ~/.applift/credentials.toml 配置)");
+			p.outro(`个人切换: ${pc.cyan("applift use <profile>")}（改团队默认 → applift.config.ts 的 profile 字段）`);
+			return;
+		}
+		setProjectProfile(cwd, target);
+		p.log.success(`本项目已切换到 profile ${pc.bold(target)}（写 ~/.applift/projects.json，不进项目/git）`);
+		if (!available.includes(target)) p.log.warn(`~/.applift/credentials.toml 还没有 profile "${target}"（可用: ${available.join(", ") || "无"}），发版前记得补凭据`);
+	});
+	program.command("status").description("查询各渠道审核状态").option("--stores <list>", "渠道列表（逗号分隔），缺省=项目配置全部").option("--cwd <dir>", "项目目录", process.cwd()).option("--json", "结构化输出（stdout 给机器）").action(async (cmdOpts) => {
+		registryRef.setup();
+		const { config } = await loadProjectConfig(cmdOpts.cwd);
+		const profile = loadCredentialsLayered(cmdOpts.cwd).profiles[resolveProfileFor(cmdOpts.cwd, config.profile)] ?? {};
+		const storeIds = (cmdOpts.stores ? cmdOpts.stores.split(",") : Object.keys(config.android?.stores ?? {})).filter(Boolean);
+		if (storeIds.length === 0) throw new Error("未指定渠道（--stores 或项目配置 android.stores）");
+		const detected = detectBundleIds(cmdOpts.cwd);
+		const isJson = Boolean(cmdOpts.json);
+		const results = [];
+		let hasError = false;
+		if (!isJson) p.intro(pc.bgBlue(pc.black(" applift status ")));
+		for (const id of storeIds) {
+			const channel = registryRef.registry.get(id);
+			if (!channel) {
+				results.push({
+					channel: id,
+					state: "unknown",
+					error: "未知渠道"
+				});
+				hasError = true;
+				if (!isJson) p.log.error(`${id}: 未知渠道`);
+				continue;
+			}
+			const target = resolveChannelTarget(id, config, detected);
+			if (!channel.capabilities.status) {
+				results.push({
+					channel: id,
+					state: "unknown",
+					error: "该渠道状态查询暂未接入"
+				});
+				continue;
+			}
+			try {
+				const st = await channel.status({
+					credentials: profile,
+					target
+				});
+				results.push({
+					channel: id,
+					...st
+				});
+				if (!isJson) {
+					const icon = st.state === "approved" ? pc.green("●") : st.state === "rejected" ? pc.red("✗") : st.state === "reviewing" ? pc.yellow("●") : pc.dim("◌");
+					const text = st.state === "approved" ? `审核通过${st.live ? pc.green("（已上架）") : pc.dim("（未上架）")}` : st.state === "rejected" ? `被驳回${st.reason ? ` — ${st.reason}` : ""}` : st.state === "reviewing" ? "审核中" : st.raw ?? "未知";
+					p.log.message(`  ${icon} ${pc.bold(channel.label)} ${text}`);
+				}
+			} catch (e) {
+				results.push({
+					channel: id,
+					state: "unknown",
+					error: e.message
+				});
+				hasError = true;
+				if (!isJson) p.log.error(`${channel.label}: ${e.message}`);
+			}
+		}
+		if (isJson) process.stdout.write(JSON.stringify({ status: results }, null, 2) + "\n");
+		else p.outro("状态查询完成");
+		if (hasError) process.exitCode = 1;
+	});
+	program.command("history").description("发版历史（stage/submit 记录，~/.applift/history.jsonl）").option("--channel <id>", "按渠道过滤").option("--sha256 <hash>", "按产物 sha256 过滤").option("--limit <n>", "最近 n 条（缺省 20）", "20").option("--json", "JSON 输出（AI agent 友好）").action(async (cmdOpts) => {
+		const entries = readEntries({
+			channel: cmdOpts.channel,
+			sha256: cmdOpts.sha256
+		});
+		const limit = Number(cmdOpts.limit);
+		const recent = (Number.isFinite(limit) && limit > 0 ? entries.slice(-limit) : entries).reverse();
+		if (cmdOpts.json) {
+			console.log(JSON.stringify(recent, null, 2));
+			return;
+		}
+		p.intro(pc.bgBlue(pc.black(" applift history ")));
+		if (recent.length === 0) p.log.message(pc.dim("暂无记录（发版执行 release 后自动落一条）"));
+		for (const e of recent) {
+			const time = new Date(e.ts).toLocaleString();
+			const icon = e.ok ? pc.green("✓") : pc.red("✗");
+			p.log.message(`  ${icon} ${pc.dim(time)} ${pc.bold(e.channel.padEnd(10))} ${e.action.padEnd(6)} ${e.artifactVersion ? pc.dim(e.artifactVersion) : ""}${e.ref ? pc.dim(` ref=${e.ref}`) : ""}`);
+		}
+		p.outro(`共 ${recent.length} 条`);
+	});
+}
+//#endregion
+//#region src/listing.ts
+/**
+* listing 命令：更新商店应用信息（简介/描述/图标/截图，按渠道覆盖）。
+* --dry-run 只打印合并后的 per-store 生效字段；--json 结构化输出（AI agent 友好）。
+*/
+function registerListingCommand(program, registryRef) {
+	program.command("listing").description("更新商店应用信息（--dry-run 预览，--json 结构化输出）").requiredOption("--stores <list>", "渠道列表（逗号分隔），如 huawei").option("--file <path>", "listing 配置文件（TS：export default { brief, description, stores }）").option("--brief <text>", "应用简介（直传，覆盖 --file 中的值）").option("--description <text>", "应用描述（直传，覆盖 --file 中的值）").option("--cwd <dir>", "项目目录", process.cwd()).option("--json", "JSON 输出").option("--dry-run", "只预览各渠道生效字段，不调用接口").action(async (opts) => {
+		registryRef.setup();
+		if (!opts.file && opts.brief === void 0 && opts.description === void 0) throw new Error("未提供 listing 内容（--file 或 --brief/--description）");
+		let listing = {};
+		if (opts.file) listing = await loadListingFile(opts.file);
+		if (opts.brief !== void 0) listing.brief = opts.brief;
+		if (opts.description !== void 0) listing.description = opts.description;
+		assertListingFiles(listing);
+		const storeIds = (opts.stores ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+		if (storeIds.length === 0) throw new Error("未指定渠道（--stores huawei[,xiaomi]）");
+		const { config } = await loadProjectConfig(opts.cwd ?? process.cwd());
+		const profile = loadCredentials().profiles[config.profile] ?? {};
+		if (opts.dryRun) {
+			const preview = storeIds.map((id) => ({
+				store: id,
+				...resolveListing(listing, id)
+			}));
+			if (opts.json) console.log(JSON.stringify({
+				dryRun: true,
+				stores: preview
+			}));
+			else {
+				p.intro(pc.bgBlue(pc.black(" applift listing (dry-run) ")));
+				for (const item of preview) {
+					const fields = {
+						brief: item.brief,
+						description: item.description,
+						iconPath: item.iconPath,
+						screenshots: item.screenshots
+					};
+					p.log.message(`  ${pc.bold(item.store)} ${pc.dim(JSON.stringify(fields))}`);
+				}
+				p.outro("预览完成（未调用任何接口）");
+			}
+			return;
+		}
+		const results = [];
+		if (!opts.json) p.intro(pc.bgBlue(pc.black(" applift listing ")));
+		for (const id of storeIds) {
+			const channel = registryRef.registry.get(id);
+			if (!channel) {
+				results.push({
+					ok: false,
+					store: id,
+					updated: [],
+					skipped: [],
+					error: "未知渠道"
+				});
+				if (!opts.json) p.log.error(`${id}: 未知渠道`);
+				continue;
+			}
+			const listingChannel = channel;
+			if (typeof listingChannel.updateListing !== "function") {
+				results.push({
+					ok: false,
+					store: id,
+					updated: [],
+					skipped: [],
+					error: "该渠道暂不支持 listing 更新"
+				});
+				if (!opts.json) p.log.message(`  ${pc.yellow("◌")} ${pc.bold(channel.label)} ${pc.dim("listing 更新暂未接入")}`);
+				continue;
+			}
+			try {
+				const res = await listingChannel.updateListing({
+					credentials: profile,
+					target: config.android?.stores?.[id] ?? {},
+					emit: (e) => {
+						if (!opts.json && e.type === "warn") p.log.warn(e.message);
+					}
+				}, listing);
+				results.push({
+					...res,
+					label: channel.label
+				});
+				if (!opts.json) {
+					const up = res.updated.length ? pc.green(`已更新: ${res.updated.join(", ")}`) : pc.dim("无可写字段");
+					const skip = res.skipped.length ? pc.yellow(` 跳过: ${res.skipped.join(", ")}`) : "";
+					p.log.message(`  ${pc.green("●")} ${pc.bold(channel.label)} ${up}${skip}`);
+				}
+			} catch (e) {
+				results.push({
+					ok: false,
+					store: id,
+					updated: [],
+					skipped: [],
+					error: e.message,
+					label: channel.label
+				});
+				if (!opts.json) p.log.error(`${channel.label}: ${e.message}`);
+			}
+		}
+		if (opts.json) console.log(JSON.stringify({ stores: results }));
+		else p.outro("listing 更新完成");
+	});
+}
+//#endregion
+//#region src/channel-meta.ts
+/**
+* 渠道配置元数据：所需凭据键与获取指引（channels 命令消费，AI agent 自发现的依据）。
+* 与 lifecycle.ts 的 CREDENTIAL_FIELDS 保持单一来源：此处为 channel → keys 映射。
+*/
+const REQUIRED_KEYS_BY_CHANNEL = {
+	pgyer: ["PGYER_API_KEY"],
+	huawei: [
+		"HW_CLIENT_ID",
+		"HW_CLIENT_SECRET",
+		"HW_ANDROID_APP_ID"
+	],
+	"agc-harmony": ["AGC_CLIENT_ID", "AGC_CLIENT_SECRET"],
+	xiaomi: [
+		"MI_USER_NAME",
+		"MI_PASSWORD",
+		"MI_CERT_PATH"
+	],
+	oppo: ["OPPO_CLIENT_ID", "OPPO_CLIENT_SECRET"],
+	vivo: ["VIVO_ACCESS_KEY", "VIVO_ACCESS_SECRET"],
+	honor: [
+		"HONOR_CLIENT_ID",
+		"HONOR_CLIENT_SECRET",
+		"HONOR_APP_ID"
+	],
+	yyb: [
+		"YYB_USER_ID",
+		"YYB_ACCESS_SECRET",
+		"YYB_APP_ID"
+	],
+	asc: ["ASC_KEY_ID", "ASC_ISSUER_ID"],
+	googleplay: ["GOOGLEPLAY_SA_JSON 或 GOOGLEPLAY_SA_KEY"]
+};
+const CHANNEL_HINTS = {
+	pgyer: "pgyer.com → 账号设置 → API（免费，内测分发三端）",
+	huawei: "AGC → 项目设置 → API Client（安卓应用 App ID 独立）",
+	"agc-harmony": "AGC → 项目设置 → API Client（与华为安卓同源凭据，appId 可按 bundleName 自动查询）",
+	xiaomi: "dev.mi.com → 管理中心 → API（需 dev.api.public.cer 证书路径）",
+	oppo: "open.oppomobile.com → 管理中心 → API 传包",
+	vivo: "dev.vivo.com.cn → 应用分发 → API 传包（有沙箱环境可免费真测）",
+	honor: "developer.honor.com → 设置 → API",
+	yyb: "app.open.qq.com 管理中心（UserID + AccessSecret）",
+	asc: "App Store Connect → 用户和访问 → 集成 → 团队密钥；p8 放 ~/.applift/private_keys/",
+	googleplay: "Google Cloud Console → Service Account（JSON 密钥）+ Play Console 关联"
+};
+//#endregion
+//#region src/index.ts
+/**
+* CLI：commander 参数解析 + @clack/prompts 交互 + picocolors 美化。
+* 薄壳——渲染 core 事件流与插件钩子结果，业务全在 core。
+*/
+/** 框架探测（含插件注册的自定义适配器） */
+function detectFrameworkWith(cwd, extra) {
+	return detectFramework(cwd, extra);
+}
+const program = new Command("applift");
+program.name("applift").description("三端 App 发版工具（内测 / 多商店提审 / 插件扩展）").version("0.2.0");
+function makeContext(channel, creds, target, artifactPath, note, extra = {}) {
+	const label = pc.bold(channel.label);
+	const emit = (event) => {
+		if (event.type === "phase") {
+			const phaseText = {
+				auth: pc.blue("鉴权"),
+				upload: pc.blue("上传"),
+				bind: pc.blue("绑定"),
+				wait: pc.yellow("等待"),
+				submit: pc.magenta("提审"),
+				done: pc.green("完成")
+			}[event.phase] ?? event.phase;
+			process.stderr.write(`  ${label} ${phaseText}${event.message ? pc.dim(` — ${event.message}`) : ""}\n`);
+		} else if (event.type === "warn") process.stderr.write(`  ${label} ⚠ ${event.message}\n`);
+	};
+	return {
+		credentials: creds,
+		target,
+		artifactPath,
+		updateDescription: note,
+		releaseTime: extra.releaseTime,
+		remark: extra.remark,
+		installPassword: extra.installPassword,
+		emit
+	};
+}
+/** clack 确认：计划表 → confirm（非 TTY/CI 环境自动拒绝，需 --yes） */
+async function confirmWithClack(plans) {
+	const rows = plans.map((plan) => `  ${pc.cyan(plan.platform.padEnd(7))} ${pc.bold(plan.channel.padEnd(12))} ${plan.action.padEnd(13)} ${plan.afterApproval === "manual" ? pc.green("审核通过后手动发布") : plan.afterApproval === "scheduled" ? pc.yellow("定时上架") : pc.red("审核通过后自动上架")}`);
+	p.log.message(`${pc.bold("┌ 发布计划")} ${pc.dim("────────────────────────────┐")}`);
+	for (const r of rows) p.log.message(r);
+	p.log.message(`${pc.bold("└───────────────────────────────────┘")}`);
+	if (plans.some((x) => x.afterApproval === "auto-publish")) p.log.warn(`${pc.red("⚠")} 提审后审核通过即自动上架，无法撤回（iOS manual 除外）`);
+	const yes = await p.confirm({ message: `确认提交以上 ${plans.length} 项？` });
+	if (p.isCancel(yes)) return false;
+	return Boolean(yes);
+}
+let channelsRegistered = false;
+function setupChannels() {
+	if (channelsRegistered) return;
+	channelsRegistered = true;
+	registry.register(new PgyerChannel());
+	registry.register(new HuaweiAndroidChannel());
+	registry.register(new XiaomiChannel());
+	registry.register(new OppoChannel());
+	registry.register(new VivoChannel());
+	registry.register(new HonorChannel());
+	registry.register(new YybChannel());
+	registry.register(new AgcHarmonyChannel());
+	registry.register(new AscChannel());
+	registry.register(new GooglePlayChannel());
+}
+/** 装载插件宿主与生效配置：c12 只 load 一次；config:resolved 钩子返回值即生效配置（P2-5） */
+async function loadPluginHost(cwd) {
+	const { config, raw } = await loadProjectConfig(cwd);
+	const plugins = resolvePlugins(raw);
+	if (plugins.length === 0) return {
+		config,
+		extraFrameworks: []
+	};
+	const host = new PluginHost(plugins);
+	await host.broadcast("channel:register", { cwd }, registry);
+	const extraFrameworks = [];
+	await host.broadcast("framework:register", { cwd }, extraFrameworks);
+	return {
+		host,
+		config: (await host.apply("config:resolved", config, { cwd })).value,
+		extraFrameworks
+	};
+}
+program.command("beta").description("内测分发（android/ios → 蒲公英扫码即装；harmony 默认 AGC 测试发布，--via pgyer 改走蒲公英）").argument("<platform>", "android | harmony | ios").option("--artifact <path>", "产物路径（缺省自动探测最新构建产物）").option("--note <text>", "更新说明").option("--via <target>", "harmony 分发通道：agc（默认，AGC 指定设备测试发布）| pgyer", "agc").option("--install-password <pwd>", "安装密码（蒲公英密码安装）").option("--cwd <dir>", "项目目录", process.cwd()).action(async (platform, cmdOpts) => {
+	setupChannels();
+	const { extraFrameworks: pluginFrameworks } = await loadPluginHost(cmdOpts.cwd);
+	const { config: projCfg } = await loadProjectConfig(cmdOpts.cwd);
+	const creds = resolveProfile(loadCredentialsLayered(cmdOpts.cwd), resolveProfileFor(cmdOpts.cwd, projCfg.profile), KNOWN_CREDENTIAL_KEYS);
+	const detected = detectBundleIds(cmdOpts.cwd);
+	let artifactPath = cmdOpts.artifact ? path.resolve(cmdOpts.artifact) : void 0;
+	if (!artifactPath) {
+		const framework = detectFrameworkWith(cmdOpts.cwd, pluginFrameworks);
+		const patterns = projCfg.artifacts?.[platform] ?? framework?.artifactPatterns(platform) ?? [];
+		artifactPath = findArtifacts(cmdOpts.cwd, patterns)[0];
+	}
+	if (!artifactPath) throw new Error("未找到构建产物：先构建或用 --artifact 指定");
+	if (!fs.existsSync(artifactPath)) throw new Error(`产物不存在: ${artifactPath}`);
+	const s = p.spinner();
+	if (platform === "harmony" && cmdOpts.via !== "pgyer") {
+		const agc = registry.get("agc-harmony");
+		if (!agc) throw new Error("agc-harmony 渠道未注册");
+		const target = resolveChannelTarget("agc-harmony", projCfg, detected);
+		s.start(`AGC 测试发布 ${path.basename(artifactPath)}`);
+		const ctx = makeContext(agc, creds, {
+			...target,
+			releaseType: "6"
+		}, artifactPath, cmdOpts.note);
+		const r = await agc.stage({
+			...ctx,
+			emit: () => {}
+		});
+		if (r.ok) s.stop(`AGC 测试包已上传 ${pc.green("✓")} 到控制台「我的应用 → 测试」指定测试设备`);
+		else {
+			s.stop(`AGC 测试发布失败: ${r.error}`);
+			process.exitCode = 1;
+		}
+		return;
+	}
+	const pgyer = registry.get("pgyer");
+	if (!pgyer) throw new Error("pgyer 渠道未注册");
+	s.start(`蒲公英上传 ${path.basename(artifactPath)}`);
+	const ctx = makeContext(pgyer, creds, resolveChannelTarget("pgyer", projCfg, detected), artifactPath, cmdOpts.note, { installPassword: cmdOpts.installPassword });
+	const r = await pgyer.stage({
+		...ctx,
+		emit: () => {}
+	});
+	if (r.ok) s.stop(`蒲公英发布成功 ${pc.green("✓")} 扫码即装`);
+	else {
+		s.stop(`蒲公英上传失败: ${r.error}`);
+		process.exitCode = 1;
+	}
+});
+program.command("release").description("正式发版两段式：不带 --submit 只传包到各家草稿（安全）；--submit = 自动完成传包+确认+提审一条龙（审核通过即上架）").argument("<platform>", "android | harmony | ios").option("--stores <list>", "渠道列表（逗号分隔）；缺省进入交互多选").option("--submit", "提审（L3 不可逆：审核通过自动上架）").option("--skip-stage", "与 --submit 同用：复用已 stage 的包直接提审").option("--artifact <path>", "产物路径；缺省自动探测框架最新构建产物").option("--note <text>", "更新说明").option("--release-time <rfc3339>", "定时上架时间（RFC3339，仅 scheduled 渠道生效）").option("--remark <text>", "提审备注（给审核员）").option("--profile <name>", "凭据 profile（最高优先级；缺省走 applift use 个人选择 > 项目配置团队默认）").option("--cwd <dir>", "项目目录", process.cwd()).option("--yes", "CI 无人值守豁免确认").option("--dry-run", "只打印计划").option("--json", "结构化输出（stdout 给机器，渲染抑制）").action(async (platform, raw) => {
+	const opts = raw;
+	const KNOWN_PLATFORMS = [
+		"android",
+		"harmony",
+		"ios",
+		"windows",
+		"macos",
+		"linux"
+	];
+	if (!KNOWN_PLATFORMS.includes(platform)) process.stderr.write(`⚠ 平台 "${platform}" 非内置（${KNOWN_PLATFORMS.join(" | ")}）；若你注册了自定义框架适配器则继续\n`);
+	setupChannels();
+	const { host: plugins, config, extraFrameworks: pluginFrameworks } = await loadPluginHost(opts.cwd);
+	const global = loadGlobalConfig();
+	const creds = opts.dryRun ? {} : resolveProfile(loadCredentials(), opts.profile ?? resolveProfileFor(opts.cwd, config.profile), KNOWN_CREDENTIAL_KEYS);
+	const isJson = Boolean(opts.json);
+	const framework = detectFrameworkWith(opts.cwd, pluginFrameworks);
+	if (!isJson) {
+		if (framework) p.log.info(`框架: ${pc.bold(framework.expoAwareLabel?.(opts.cwd) ?? framework.label)}${pc.dim(` (${framework.id})`)}`);
+		else p.log.warn("未识别框架，产物路径请用 --artifact 指定");
+	}
+	let artifactPath = opts.artifact ? path.resolve(opts.artifact) : void 0;
+	if (!artifactPath) {
+		const patterns = config.artifacts?.[platform] ?? framework?.artifactPatterns(platform) ?? [];
+		artifactPath = findArtifacts(opts.cwd, patterns)[0];
+		if (artifactPath && !isJson) {
+			const via = config.artifacts?.[platform] ? "项目配置 artifacts" : `${framework?.label} 内置 pattern`;
+			p.log.info(`自动探测产物（${via}）: ${pc.bold(path.basename(artifactPath))} ${pc.dim(artifactPath)}`);
+		}
+	}
+	if (!artifactPath && !opts.dryRun) throw new Error("未找到构建产物：先构建或用 --artifact 指定");
+	if (artifactPath && !fs.existsSync(artifactPath) && !opts.dryRun) throw new Error(artifactPath ? `产物不存在: ${artifactPath}` : "未找到构建产物：先构建或用 --artifact 指定");
+	let storeIds;
+	if (opts.stores) {
+		storeIds = opts.stores.split(",").map((s) => s.trim()).filter(Boolean);
+		const known = new Set(registry.all().map((c) => c.id));
+		for (const id of storeIds) if (!known.has(id)) process.stderr.write(`⚠ 未知渠道 ${id}（可用: ${[...known].join(", ")}）\n`);
+	} else {
+		const configured = Object.keys(config.android?.stores ?? {});
+		if (configured.length > 0) storeIds = configured;
+		else if (opts.dryRun || opts.yes || isJson || global.assumeYes) storeIds = registry.all().map((c) => c.id);
+		else {
+			const selected = await p.multiselect({
+				message: "选择提审渠道",
+				options: registry.all().filter((c) => c.id !== "pgyer").map((c) => ({
+					value: c.id,
+					label: c.label
+				})),
+				required: true
+			});
+			if (p.isCancel(selected)) throw new Error("已取消");
+			storeIds = selected;
+		}
+	}
+	const channels = storeIds.map((id) => registry.get(id)).filter((c) => c !== void 0);
+	if (channels.length === 0) throw new Error(`未找到渠道（${storeIds.join(", ")}）。已注册: ${registry.all().map((c) => c.id).join(", ")}`);
+	const detected = detectBundleIds(opts.cwd);
+	const contexts = /* @__PURE__ */ new Map();
+	for (const c of channels) contexts.set(c.id, makeContext(c, creds, resolveChannelTarget(c.id, config, detected), artifactPath ?? "", opts.note, {
+		releaseTime: opts.releaseTime,
+		remark: opts.remark
+	}));
+	if (opts.dryRun) {
+		const plans = [];
+		const errors = {};
+		for (const c of channels) try {
+			const plan = await c.plan(contexts.get(c.id));
+			plans.push(plan);
+			if (!isJson) p.log.message(`${pc.cyan(plan.platform.padEnd(8))} ${pc.bold(plan.channel.padEnd(12))} → ${plan.action} (${plan.afterApproval})`);
+		} catch (e) {
+			errors[c.id] = e.message;
+			if (!isJson) p.log.warn(`${pc.bold(c.label)}: ${e.message}`);
+		}
+		if (isJson) process.stdout.write(JSON.stringify({
+			dryRun: true,
+			plans,
+			errors
+		}, null, 2) + "\n");
+		return;
+	}
+	const confirmFn = opts.yes || global.assumeYes ? async (plans) => {
+		p.log.warn(`[CI 模式] assumeYes，自动确认 ${plans.length} 项提审`);
+		return true;
+	} : confirmWithClack;
+	let cachedSha;
+	const artifactSha256 = () => {
+		if (!artifactPath || !fs.existsSync(artifactPath)) return "";
+		cachedSha ??= sha256File(artifactPath);
+		return cachedSha;
+	};
+	const historySink = (e) => {
+		appendEntry({
+			ts: Date.now(),
+			cwd: opts.cwd,
+			artifactSha256: artifactSha256(),
+			...e
+		});
+	};
+	const pipelineInput = {
+		channels,
+		contexts,
+		concurrency: global.concurrency,
+		cwd: opts.cwd,
+		confirm: confirmFn,
+		plugins,
+		historySink
+	};
+	if (!opts.submit) {
+		if (!isJson) p.intro(pc.bgCyan(pc.black(" applift release · stage ")));
+		const interactive = process.stdout.isTTY && !isJson && !opts.yes && !global.assumeYes;
+		if (interactive) {
+			const list = channels.map((c) => c.label).join("、");
+			const ok = await p.confirm({ message: `将上传到 ${pc.bold(list)} 的草稿区（不提审），继续？` });
+			if (p.isCancel(ok) || !ok) throw new Error("已取消（未做任何变更）");
+		}
+		const summary = await runStage(pipelineInput);
+		if (isJson) process.stdout.write(JSON.stringify({ stage: summary.stage.map((e) => ({
+			channel: e.channel,
+			ok: e.ok,
+			ref: void 0,
+			error: e.stageError
+		})) }, null, 2) + "\n");
+		else renderSummary(summary.stage);
+		if (summary.stage.some((e) => !e.ok)) {
+			process.exitCode = 1;
+			if (!isJson) p.outro("部分渠道传包失败，未提审；修复后重跑");
+			return;
+		}
+		if (interactive) {
+			const goSubmit = await p.confirm({ message: `草稿已就绪。${pc.red("现在提审？")}（审核通过即自动上架，不可撤回）` });
+			if (p.isCancel(goSubmit) || !goSubmit) {
+				p.outro(`已保留草稿。之后提审: ${pc.cyan(`applift release ${platform} --submit --skip-stage`)}`);
+				return;
+			}
+			const submitSummary = await runSubmit(pipelineInput, { skipStage: true });
+			renderSummary(submitSummary.submit);
+			if (submitSummary.submit.some((s) => !s.ok)) process.exitCode = 1;
+			p.outro("完成");
+			return;
+		}
+		if (!isJson) p.outro(`已传包到草稿（${pc.bold("未提审")}）。提审执行: ${pc.cyan(`applift release ${platform} --submit`)}`);
+		return;
+	}
+	if (!isJson) p.intro(pc.bgMagenta(pc.black(" applift release · submit ")));
+	if (!opts.skipStage && artifactPath && fs.existsSync(artifactPath)) {
+		const sha = artifactSha256();
+		const stagedChannels = new Set(readEntries({ sha256: sha }).filter((h) => h.action === "stage" && h.ok).map((h) => h.channel));
+		const reusable = channels.filter((c) => stagedChannels.has(c.id)).map((c) => c.id);
+		if (reusable.length > 0) p.log.warn(`以下渠道已有同包（sha256 ${sha.slice(0, 8)}…）成功 stage 记录：${pc.bold(reusable.join(", "))}。如草稿未被改动，可加 ${pc.cyan("--skip-stage")} 复用免重传`);
+	}
+	if (opts.skipStage && artifactPath && fs.existsSync(artifactPath)) {
+		const sha = artifactSha256();
+		for (const ch of channels) {
+			const last = readEntries({ channel: ch.id }).find((h) => h.action === "stage" && h.ok);
+			if (last && last.artifactSha256 && last.artifactSha256 !== sha) p.log.warn(`${pc.bold(ch.label)} 的最近草稿是另一个包（sha ${last.artifactSha256.slice(0, 8)}… ≠ 当前 ${sha.slice(0, 8)}…）——${pc.red("提审的将是商店后台当前草稿，请确认")}（去掉 --skip-stage 重传当前包）`);
+		}
+	}
+	const summary = await runSubmit(pipelineInput, { skipStage: Boolean(opts.skipStage) });
+	if (isJson) process.stdout.write(JSON.stringify({ submit: summary.submit.map((e) => ({
+		channel: e.channel,
+		ok: e.ok,
+		error: e.submitError ?? e.stageError
+	})) }, null, 2) + "\n");
+	else {
+		renderSummary(summary.submit);
+		p.outro("完成");
+	}
+	if (summary.submit.some((s) => !s.ok)) process.exitCode = 1;
+});
+function renderSummary(entries) {
+	for (const e of entries) {
+		const raw = e.stageError ?? e.submitError;
+		const hints = e.channel ? registry.get(e.channel)?.errorHints : void 0;
+		const err = raw ? humanizeError(hints, raw) : raw;
+		p.log.message(`  ${e.ok ? pc.green("✓") : pc.red("✗")} ${pc.bold(e.label)}${err ? pc.red(` — ${err}`) : ""}`);
+	}
+}
+program.command("doctor").description("体检：框架/凭据/渠道配置").option("--cwd <dir>", "项目目录", process.cwd()).action(async (cmdOpts) => {
+	setupChannels();
+	const framework = detectFramework(cmdOpts.cwd);
+	p.intro(pc.bgBlue(pc.black(" applift doctor ")));
+	if (framework) p.log.success(`框架识别: ${pc.bold(framework.label)}`);
+	else p.log.error("框架识别失败（目录结构不符合任何已知框架）");
+	const ids = detectBundleIds(cmdOpts.cwd);
+	const idParts = [
+		ids.androidPkgName ? `android ${pc.bold(ids.androidPkgName)}` : "",
+		ids.harmonyBundleName ? `harmony ${pc.bold(ids.harmonyBundleName)}` : "",
+		ids.iosBundleId ? `ios ${pc.bold(ids.iosBundleId)}${ids.iosScheme ? pc.dim(`（scheme ${ids.iosScheme}）`) : ""}` : ""
+	].filter(Boolean);
+	if (idParts.length > 0) p.log.success(`自动推导: ${idParts.join(" · ")} ${pc.dim("（配置缺省时兜底）")}`);
+	else p.log.warn("自动推导: 未识别到三端标识（app.json / build.gradle / AppScope/app.json5 / pbxproj 均未命中）");
+	let healthy = true;
+	const creds = loadCredentials();
+	const profileNames = Object.keys(creds.profiles);
+	if (profileNames.length > 0) p.log.success(`凭据 profiles: ${pc.bold(profileNames.join(", "))}`);
+	else p.log.error("无凭据（~/.applift/credentials.toml）");
+	if (profileNames.length === 0) healthy = false;
+	const { config } = await loadProjectConfig(cmdOpts.cwd);
+	const profile = resolveProfileFor(cmdOpts.cwd, config.profile);
+	const stores = Object.keys(config.android?.stores ?? {});
+	if (stores.length > 0) p.log.success(`项目渠道: ${stores.join(", ")}（profile=${profile}）`);
+	else p.log.info("项目未配置渠道（applift.config.ts → android.stores）");
+	const activeProfile = creds.profiles[profile];
+	if (stores.length > 0) {
+		if (!activeProfile) {
+			p.log.error(`凭据 profile "${profile}" 不存在（可用: ${profileNames.join(", ") || "无"}；个人可 applift use 切换）`);
+			healthy = false;
+		} else for (const id of stores) {
+			const need = REQUIRED_KEYS_BY_CHANNEL[id];
+			if (!need) continue;
+			const missing = need.filter((k) => !k.includes(" 或 ") && !activeProfile[k]);
+			if (missing.length > 0) {
+				p.log.error(`${pc.bold(id)}: 缺凭据 ${missing.join(", ")} — ${CHANNEL_HINTS[id] ?? ""}`);
+				healthy = false;
+			} else p.log.success(`${id}: 凭据齐全`);
+		}
+	}
+	if (framework) for (const plat of [
+		"android",
+		"harmony",
+		"ios"
+	]) {
+		const patterns = config.artifacts?.[plat] ?? framework.artifactPatterns(plat);
+		const found = findArtifacts(cmdOpts.cwd, patterns)[0];
+		if (found) {
+			const v = readArtifactVersion(found);
+			p.log.info(`产物 ${plat}: ${pc.bold(path.basename(found))}${v ? `（${v.versionName ?? "?"} build ${v.versionCode ?? "?"}，读自 ${v.source}）` : pc.dim("（版本自动读取不支持该格式）")}`);
+			break;
+		}
+	}
+	p.outro(healthy ? "体检完成：一切就绪" : "体检完成：存在待修复项（见上）");
+	if (!healthy) process.exitCode = 1;
+});
+registerListingCommand(program, {
+	setup: setupChannels,
+	registry
+});
+/** 环境变量兼容的裸键名全集（渠道凭据键展开） */
+const KNOWN_CREDENTIAL_KEYS = [...new Set(Object.values(REQUIRED_KEYS_BY_CHANNEL).flat().flatMap((k) => k.split(" 或 ")))];
+registerLifecycleCommands(program, {
+	setup: setupChannels,
+	registry
+});
+program.command("channels").description("列出全部渠道及所需配置（--json 供 AI agent 消费）").option("--json", "JSON 输出").action(async (cmdOpts) => {
+	setupChannels();
+	const rows = registry.all().map((c) => ({
+		id: c.id,
+		label: c.label,
+		capabilities: c.capabilities,
+		credentials: REQUIRED_KEYS_BY_CHANNEL[c.id] ?? [],
+		hint: CHANNEL_HINTS[c.id] ?? ""
+	}));
+	if (cmdOpts.json) {
+		process.stdout.write(JSON.stringify({ channels: rows }, null, 2) + "\n");
+		return;
+	}
+	for (const r of rows) process.stdout.write(`  ${pc.bold(r.id.padEnd(14))} ${r.label}  ${pc.dim(r.credentials.join("/") || "无需凭据")}\n`);
+});
+//#endregion
+export { program as n, makeContext as t };

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@applift/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.1",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hcg1023/applift.git",
+    "directory": "packages/cli"
+  },
+  "bin": {
+    "applift": "./dist/bin.mjs"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@applift/core": "0.1.1",
+    "@clack/prompts": "^1.8.1",
+    "commander": "^15.0.0",
+    "picocolors": "^1.1.1"
+  },
+  "devDependencies": {
+    "tsdown": "^0.23.1",
+    "tsx": "^4.23.15"
+  },
+  "scripts": {
+    "build": "tsdown src/bin.ts src/index.ts --format esm --clean",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsx src/bin.ts"
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.