@qmuse/qmuse-cli 1.0.13-dev.1 → 1.0.14-dev.1

package/dist/hono/manifest.json

@@ -0,0 +1,9 @@
+{
+  "formatVersion": 1,
+  "packageName": "@alipay/qmuse-hono-cli",
+  "version": "1.0.0",
+  "sourceCommit": "cb29fc55dbe4af79e291ade1156ad1523359a1eb",
+  "sourceDirty": false,
+  "sourceTreeSha256": "9863b5919c524bc3c97b0bc3bbb18612a7f9a1f690fbcd28458d40a7f5d9cc53",
+  "sha256": "4e838be46da6720219c051cfc2d6f4a0cade5c8efc32739f5f228cad1230d227"
+}

package/dist/hono.js

@@ -0,0 +1,35 @@
+import { spawn } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+function reportFailure(argv, message, code) {
+    if (argv.includes('--json')) {
+        process.stdout.write(`${JSON.stringify({ ok: false, command: null, project: process.cwd(), result: null,
+            diagnostics: [{ severity: 'error', code, message }] })}\n`);
+    }
+    else
+        process.stderr.write(`${message}\n`);
+}
+/** Forward the original argv and streams so the generator owns its JSON/exit contract. */
+export async function runHono(argv) {
+    const runtime = fileURLToPath(new URL('../dist/hono/cli.cjs', import.meta.url));
+    if (!existsSync(runtime)) {
+        const message = 'Hono 生成器未包含在当前 CLI 中，请重新安装；源码开发先运行 npm run build。';
+        reportFailure(argv, message, 'HONO_RUNTIME_UNAVAILABLE');
+        return 3;
+    }
+    return new Promise(resolve => {
+        const child = spawn(process.execPath, [runtime, ...argv], { stdio: 'inherit' });
+        const interrupt = () => child.kill('SIGINT');
+        const terminate = () => child.kill('SIGTERM');
+        process.on('SIGINT', interrupt);
+        process.on('SIGTERM', terminate);
+        child.once('error', error => {
+            reportFailure(argv, `无法启动 Hono 生成器：${error.message}`, 'HONO_RUNTIME_START_FAILED');
+        });
+        child.once('close', (code, signal) => {
+            process.off('SIGINT', interrupt);
+            process.off('SIGTERM', terminate);
+            resolve(code ?? (signal === 'SIGINT' ? 130 : signal === 'SIGTERM' ? 143 : 3));
+        });
+    });
+}

package/dist/import/api.js

@@ -2,8 +2,11 @@ import { recordHttpResult, recordOperation } from '../operation-log.js';
 import { openAsBlob } from 'node:fs';
 import { apiCall, authHeaders, buildUrl, requestSourceHeaders, } from '../client.js';
 import { assertImportArchiveSize } from './limits.js';
-export async function assertTemplateProtocolSupported(cfg) {
+export async function assertTemplateProtocolSupported(cfg, miniapp = false) {
     const result = await apiCall('GET', '/api/app-import/protocol', undefined, cfg);
+    if (miniapp && !result.data?.sourceTypes?.includes('TARO_REACT')) {
+        throw new Error('当前平台尚不支持 Taro 小程序导入，请升级服务端；未上传源码，不会降级为网页应用');
+    }
     if (!result.ok || !result.data?.templateProtocolVersions?.includes(2)) {
         throw new Error('当前平台尚不支持新模板架构协议，请等待服务端升级；未提交导入，不会降级为旧架构');
     }

package/dist/import/preflight.js

@@ -194,6 +194,11 @@ export async function preflightImport(directory) {
     const dependencies = { ...packageJson.devDependencies, ...packageJson.dependencies };
     if (!dependencies.react)
         throw new Error('一期仅支持 React 项目');
+    const miniapp = Boolean(dependencies['@tarojs/taro']);
+    if (miniapp && (!files.some(file => /^src\/app\.config\.[jt]s$/u.test(file.relativePath)) ||
+        !files.some(file => /^config\/index\.[jt]s$/u.test(file.relativePath)))) {
+        throw new Error('Taro 小程序缺少 src/app.config.ts 或 config/index.ts（也支持 .js）');
+    }
     if (dependencies[UNSUPPORTED_PRIVATE_RUNTIME])
         rejectUnsupportedPrivateRuntime();
     const sourceHash = createHash('sha256');
@@ -238,6 +243,8 @@ export async function preflightImport(directory) {
     });
     return {
         rootDir,
+        appType: miniapp ? 'MINIAPP' : 'GENERAL',
+        sourceType: miniapp ? 'TARO_REACT' : 'REACT_VITE',
         title: packageJson.name?.trim() || path.basename(rootDir),
         sourceHash: sourceHash.digest('hex'),
         fileCount: files.length,

package/dist/import/project.js

@@ -79,12 +79,12 @@ function parseManifest(value) {
     if (value.projectKind !== 'QMUSE_TEMPLATE' && value.projectKind !== 'EXTERNAL_REPOSITORY') {
         throw new Error(`${QMUSE_PROJECT_PATH} 的 projectKind 无效`);
     }
-    if (value.appType !== 'GENERAL') {
-        throw new Error(`${QMUSE_PROJECT_PATH} 的 appType 必须是 GENERAL`);
+    if (value.appType !== 'GENERAL' && value.appType !== 'MINIAPP') {
+        throw new Error(`${QMUSE_PROJECT_PATH} 的 appType 必须是 GENERAL 或 MINIAPP`);
     }
     const isTemplate = value.projectKind === 'QMUSE_TEMPLATE';
     if (value.schemaVersion === 2) {
-        if (!isTemplate || !['LEGACY_DIRECT_V1', 'HONO_BACKEND_V1'].includes(String(value.cloudArchitecture))) {
+        if ((!isTemplate && value.appType !== 'MINIAPP') || !['LEGACY_DIRECT_V1', 'HONO_BACKEND_V1'].includes(String(value.cloudArchitecture))) {
             throw new Error(`${QMUSE_PROJECT_PATH} 的新模板协议必须声明有效的 cloudArchitecture`);
         }
     }
@@ -108,7 +108,7 @@ function parseManifest(value) {
         schemaVersion: value.schemaVersion,
         ...(value.schemaVersion === 2 ? { cloudArchitecture: value.cloudArchitecture } : {}),
         projectKind: value.projectKind,
-        appType: 'GENERAL',
+        appType: value.appType,
         ...(isTemplate ? {
             packageVersion: Number(value.packageVersion),
             templateCommit: requireNonEmptyString(value.templateCommit, 'templateCommit'),
@@ -186,14 +186,15 @@ export async function saveManagedProject(context) {
         throw error;
     }
 }
-export function createExternalProject(rootDir, cfg, explicitEnvironment) {
+export function createExternalProject(rootDir, cfg, explicitEnvironment, appType = 'GENERAL') {
     return {
         manifestPath: path.join(rootDir, QMUSE_PROJECT_PATH),
         environment: resolveProjectEnvironment(cfg, explicitEnvironment),
         manifest: {
-            schemaVersion: 1,
+            schemaVersion: appType === 'MINIAPP' ? 2 : 1,
+            ...(appType === 'MINIAPP' ? { cloudArchitecture: 'HONO_BACKEND_V1' } : {}),
             projectKind: 'EXTERNAL_REPOSITORY',
-            appType: 'GENERAL',
+            appType,
             targets: {},
         },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qmuse/qmuse-cli",
-  "version": "1.0.13-dev.1",
+  "version": "1.0.14-dev.1",
   "description": "QMuse 命令行客户端：在本地创建/导入 React 项目、与 QMuse 对话、拉取发布与云端调试",
   "type": "module",
   "bin": {
@@ -10,8 +10,10 @@
   "main": "./dist/cli.js",
   "scripts": {
     "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run clean && tsc -p tsconfig.json",
+    "build": "npm run clean && tsc -p tsconfig.json && node scripts/prepare-hono.mjs",
+    "hono:sync": "node scripts/sync-hono.mjs",
     "qmuse": "tsx src/cli.ts",
+    "pretest": "node scripts/prepare-hono.mjs",
     "test": "node --import tsx --test test/*.test.ts",
     "test:browser": "node --import tsx --test test/dev.browser.ts",
     "prepack": "npm run build",

package/skills/qmuse-cli/SKILL.md

@@ -13,8 +13,9 @@ description: 通过 QMuse 创建、导入、修改、调试、同步或发布应
 
 | 用户意图 | 入口 | 关键约束 |
 | --- | --- | --- |
-| 初始化新的本地 React 工程 | `qmuse create <dir>` | 创建本地模板；开发后用 import 创建远端应用 |
-| 将本地 React 工程导入 QMuse | `qmuse import <dir>` | 首次导入创建应用，已有绑定则更新同一应用 |
+| 初始化新的本地 React 工程 | `qmuse create <dir>` | 新模板固定 Hono 架构；纯前端不创建云资源，开发后用 import 创建远端应用 |
+| 为新模板添加云功能 | 项目内的 `qmuse-hono-cloud` Skill、`qmuse hono` | 按真实业务生成 Schema/后端；由 import 初始化和同步 |
+| 将本地 React Web / Taro React 小程序导入 QMuse | `qmuse import <dir>` | 自动识别应用类型；首次创建、已有绑定则更新；ZIP 先解压 |
 | 修改已导入的应用 | 修改源码后 `qmuse import .` | 平台基线变化先处理同步冲突，再更新 |
 | 用自然语言创建应用 | `qmuse app create <web\|h5\|ai> --file <路径\|->` | web 网页、h5 移动页面、ai AI 应用；返回 appId、chatId 等身份 |
 | 继续已有应用的对话 | `qmuse chat send --app-id <id> --chat-id <id> --file <路径\|->` | send 必须传 appId 和 chatId；缺少会话时先查询历史 |

package/skills/qmuse-cli/references/cloud.md

@@ -1,23 +1,29 @@
 # 云服务指南
 
-CLI 不复制云规则，只做两件事：识别当前应用的实际架构，然后把操作路由到现有权威入口。
+先识别项目来源与已保存的架构，再选择入口。已有应用沿用平台持久化的架构，不通过目录、函数名称或环境数量推断，也不自动迁移。
 
 ## 1. 识别当前架构
 
+新 `qmuse create` 模板的 `.qmuse/project.json` 为 `schemaVersion: 2`、`cloudArchitecture: HONO_BACKEND_V1`。优先读取项目内 `.agents/skills/qmuse-hono-cloud/SKILL.md`，按其流程调用 `qmuse hono init|validate|inspect|generate|check`。这些命令使用 CLI 内置的固定生成器，无需登录，不创建远端资源。
+
+纯前端项目直接开发和 import，不创建 `.qmuse-hono` 占位文件。需要云服务时先准备真实 Schema 和业务代码，再 `qmuse import . --cloud-mode QMUSE --confirm-cloud-service`；首次无需 appId。已有绑定继续更新同一应用。服务端不支持新协议时先升级，不降级到 Legacy。
+
+已有应用可查询：
+
 ```bash
 qmuse info --json          # bindings + cloud 汇总（entitlement / environment）
 qmuse cloud status --app-id <appId> --json   # effectiveMode、activationStatus、publishAllowed、canRetryInitialization
 ```
 
-- `SINGLE_ENV` / Legacy：应用没有开通多环境；云初始化与首版同步由导入或对话侧完成。
-- `MULTI_ENV`（Hono）：`qmuse cloud enable` 之后再查询状态；已初始化失败用 `qmuse cloud environment retry --wait`。
+`SINGLE_ENV` / `MULTI_ENV` 表示环境模式，不是 Hono / Legacy 架构判据。Legacy 保持原有 Schema/函数流程，不在其目录运行 Hono 初始化。Hono 初始化与首版同步复用 import；已有初始化失败时按诊断使用 `qmuse cloud environment retry --wait`。
 
 ## 2. 路由到现有入口
 
 | 判断 | 动作 |
 | --- | --- |
 | 权益预检（不伪装已开通） | `qmuse cloud init -d "<功能描述>"` |
-| 实际开通 | `qmuse cloud enable --app-id <appId>` |
+| 新模板首次开通与同步 | 按项目 Skill 生成后执行 `qmuse import . --cloud-mode QMUSE --confirm-cloud-service` |
+| 存储能力启用 | `qmuse cloud enable --app-id <appId>`；不能替代 Hono 首次导入 |
 | 状态/失败原因 | `qmuse cloud status --app-id <appId>` |
 | 初始化失败重试 | `qmuse cloud environment retry --app-id <appId> --wait` |
 | 公开连接与运行配置 | `qmuse cloud pull-env --app-id <appId> --output .qmuse/local-dev.json` |
@@ -28,5 +34,5 @@ qmuse cloud status --app-id <appId> --json   # effectiveMode、activationStatus
 ## 3. 约束
 
 - 管理凭证只保留在 CLI 会话或服务端；`pull-env` 输出仅含公开配置。
-- 预检通过不等于初始化完成：以 `cloud status` 的 `activationStatus` 为准。
+- 预检通过不等于初始化完成。分别检查 import 的云就绪结果、Function 活动部署和真实业务请求；`cloud status` 的激活汇总不能替代业务验收。
 - 套餐与订阅购买流程在 PC 端；CLI 只读 `qmuse account` 汇总并在缺少契约时返回 `unavailable` 原因。