@minus-ai/create-skill 0.1.0-beta.1 → 0.1.0-beta.11

package/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 import { createInterface } from 'node:readline/promises'
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs'
+import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync } from 'node:fs'
 import { execSync } from 'node:child_process'
 import { createServer } from 'node:net'
 import { join, dirname } from 'node:path'
@@ -15,6 +15,46 @@ const CREDENTIALS_FILE = join(CREDENTIALS_DIR, 'credentials.json')
 
 const DEFAULT_PLATFORM_URL = 'http://47.107.144.22:18990'
 
+// create-skill 内 node 大版本的唯一写死处。模板里的 engines.node / volta.node /
+// @types/node 全部由它派生，不再各自硬编码。与 minus-plugin lib/toolchain.sh 的
+// NODE_TARGET 同义——两仓各自持有同一 major（create-skill 是独立 npm 包，发布时读不到
+// toolchain.sh，故不做运行时跨仓耦合）。升级大版本只改这一个值。
+const NODE_MAJOR_FLOOR = 24
+
+function nodeMajorOf(v) {
+  return parseInt(String(v).split('.')[0], 10) || 0
+}
+
+// 解析「生成项目实际会跑的那个 node」的确切 patch。Volta 不认 major-only/range，
+// volta.node 必须是确切 patch，所以这里返回一个真实存在的 x.y.z。三档：
+//   1. Volta 已装 ≥floor 的最新 node image —— 项目 dev（经 ~/.volta/bin/pnpm）真正会用
+//      且已安装 → 零下载。
+//   2. 没有合格 Volta image，但 create-skill 自身在跑的 node ≥floor —— pin 它（真实存在，
+//      进项目时 Volta 可能下载，但非凭空写死）。
+//   3. 哪里都找不到 ≥floor 的 node → 不编造版本，报错退出。
+function resolveProjectNodeVersion() {
+  const imageDir = join(homedir(), '.volta', 'tools', 'image', 'node')
+  if (existsSync(imageDir)) {
+    const best = readdirSync(imageDir)
+      .filter(name => /^\d+\.\d+\.\d+$/.test(name) && nodeMajorOf(name) >= NODE_MAJOR_FLOOR)
+      .sort((a, b) => {
+        const pa = a.split('.').map(Number)
+        const pb = b.split('.').map(Number)
+        return pb[0] - pa[0] || pb[1] - pa[1] || pb[2] - pa[2]
+      })[0]
+    if (best) return best
+  }
+
+  const running = process.versions.node
+  if (nodeMajorOf(running) >= NODE_MAJOR_FLOOR) return running
+
+  console.error(
+    `\n  ✗ 未找到 Node ${NODE_MAJOR_FLOOR}+。请安装 Node ${NODE_MAJOR_FLOOR}（推荐 https://volta.sh：\n` +
+      `    curl https://get.volta.sh | bash 后 volta install node@${NODE_MAJOR_FLOOR}）后重试。`
+  )
+  process.exit(1)
+}
+
 function findAvailablePort(start = 4001) {
   return new Promise(resolve => {
     const server = createServer()
@@ -28,7 +68,7 @@ function findAvailablePort(start = 4001) {
 // ── Naming helpers ──────────────────────────────────────
 
 function idToFolder(id) {
-  return id.replace(/[-\s]+/g, '_')
+  return id.trim().replace(/[\s/\\]+/g, '-')
 }
 
 function idToClassName(id) {
@@ -476,7 +516,8 @@ async function main() {
   const port = String(await findAvailablePort(4001))
   const apiKey = skillResult.apiKey
 
-  const vars = { skillId: skillResult.id, folder, className, displayName, description, namespace, port }
+  const nodeVersion = resolveProjectNodeVersion()
+  const vars = { skillId: skillResult.id, folder, className, displayName, description, namespace, port, nodeVersion, nodeMajor: String(NODE_MAJOR_FLOOR) }
 
   // Backend files (pipeline.py from input-type subdir)
   writeOut(join(targetDir, 'pipeline.py'), render(readTemplate('pipeline.py.tpl', inputType), vars))
@@ -504,6 +545,10 @@ async function main() {
 - 输入组件：\`AmazonSearchBar\` + \`CountrySelect\`（来自 @minus/platform-widgets）
 - 校验函数：\`validateAsins(value)\` — 校验 ASIN 格式，返回 { asins: string[], error? }
 - 支持单个或多个 ASIN 输入（逗号/换行分隔）
+- 数量限制：\`validateAsins(value, { min, max })\`
+  - 仅允许一个：\`validateAsins(value, { min: 1, max: 1 })\`
+  - 一个或多个：省略第二个参数
+  - 至少两个：\`validateAsins(value, { min: 2 })\`
 - 修改输入验证规则：编辑 frontend/src/main.tsx 中的 handleSubmit 函数
 - 修改 pipeline 步骤：编辑 pipeline.py 中的 step_N 方法`,
     keyword: `## 模板能力（inputType: keyword）
@@ -554,7 +599,7 @@ ${templateDocs[inputType] || templateDocs.custom}
 
 ### 开发手册
 写前端代码前，读以下开发手册：
-- 读 \`${join(__dirname, '../../runtime/frontend-guide')}/*/doc.md\`
+- 读 \`${platformUrl}/runtime/frontend-guide/doc.md\`
 - 手册包含：前后端数据契约（StepOutcome → StepRenderCtx）、Widget 选型与用法（defineWidgetStep、内置 Interactive/Display Widget）、自定义 Widget 开发、多语言接入。
 
 ### 后端 SDK 参考
@@ -564,8 +609,8 @@ ${templateDocs[inputType] || templateDocs.custom}
 
 ### 前端 SDK 参考
 @minus/* 包通过平台 CDN 加载，本地无源码。写前端代码前，读以下文档了解可用 API：
-- Widget 框架：读 \`${join(__dirname, '../../runtime/widget-framework')}/*/docs.md\`
-- 平台组件：读 \`${join(__dirname, '../../runtime/platform-widgets')}/*/docs.md\`
+- Widget 框架：读 \`${platformUrl}/runtime/widget-framework/docs.md\`
+- 平台组件：读 \`${platformUrl}/runtime/platform-widgets/docs.md\`
 
 修改前端代码后，同步更新 \`frontend/src/locales/\` 下的多语言文件。
 
@@ -595,7 +640,6 @@ ${templateDocs[inputType] || templateDocs.custom}
   writeOut(join(targetDir, 'frontend/tsconfig.json'), render(readTemplate('tsconfig.json.tpl'), vars))
   writeOut(join(targetDir, 'frontend/src/main.tsx'), render(readTemplate('main.tsx.tpl', inputType), vars))
   writeOut(join(targetDir, 'frontend/src/locales/zh-CN.json'), render(readTemplate('zh-CN.json.tpl', inputType), vars))
-  writeOut(join(targetDir, 'frontend/src/locales/en-US.json'), render(readTemplate('en-US.json.tpl', inputType), vars))
 
   // 类型声明文件（让 tsc build 能识别 @minus/* 模块）
   writeOut(join(targetDir, 'frontend/src/minus-runtime.d.ts'), `declare module '@minus/*';\n`)

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@minus-ai/create-skill",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.11",
   "type": "module",
   "bin": {
-    "create-skill": "./index.mjs"
+    "create-skill": "index.mjs"
   },
   "files": [
     "index.mjs",

package/templates/.minus/session-counter

@@ -0,0 +1 @@
+2

package/templates/README.md.tpl

@@ -6,7 +6,7 @@ Minus Skill 项目，由 `create-skill` 脚手架生成。
 
 | 依赖 | 最低版本 | 说明 |
 |---|---|---|
-| Node.js | >= 18 | 前端构建和开发服务 |
+| Node.js | >= {{nodeMajor}} | 前端构建和开发服务 |
 | pnpm | >= 9 | 包管理（全局 store 共享，多 skill 不重复下载） |
 | Python | >= 3.12 | 后端 Pipeline 运行时 |
 | uv | >= 0.4 | Python 包管理（全局缓存，秒级安装） |
@@ -72,7 +72,7 @@ pnpm run dev
 ```
 
 这会同时启动：
-- **后端** — `uvicorn` 监听 `http://localhost:{{port}}`，修改 `.py` 文件自动重载
+- **后端** — `uvicorn` 监听 `http://127.0.0.1:{{port}}`，修改 `.py` 文件自动重载
 - **前端** — `vite` 开发服务，修改前端代码自动热更新
 
 单独启动前端：
@@ -107,10 +107,12 @@ pnpm run build
 
 | 命令 | 说明 |
 |---|---|
-| `pnpm run dev` | 启动开发环境（前后端） |
+| `pnpm run dev` | 启动开发环境（mac/Linux，前后端） |
+| `pnpm run dev:backend` | 仅启动后端（mac/Linux） |
+| `pnpm run dev:win` | 启动开发环境（Windows，前后端） |
+| `pnpm run dev:win:backend` | 仅启动后端（Windows） |
 | `pnpm run build` | 构建前端产物 |
 | `cd frontend && pnpm exec vite` | 仅启动前端 |
-| `.venv/bin/uvicorn server:app --port {{port}} --reload --env-file .env.local` | 仅启动后端 |
 
 ## 进入开发模式（Claude Code）
 

package/templates/asin/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@mi
 import { AmazonSearchBar, CountrySelect, SearchSubmitButton, validateAsins, platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 /*
  * 防御性编码提示（适用于所有 step render 函数）：
@@ -71,7 +70,7 @@ function Home({ title, description, useCases, tags, onStart }: { title: string;
 const rootEl = document.getElementById('root');
 if (!rootEl) throw new Error('#root not found');
 
-const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string> });
 
 function SkillRoot() {
   const t = useT();

package/templates/custom/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@mi
 import { platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 /*
  * 防御性编码提示（适用于所有 step render 函数）：
@@ -68,7 +67,7 @@ function Home({ title, description, useCases, tags, onStart }: { title: string;
 const rootEl = document.getElementById('root');
 if (!rootEl) throw new Error('#root not found');
 
-const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string> });
 
 function SkillRoot() {
   const t = useT();

package/templates/default/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@mi
 import { CompletionPanel, platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 /*
  * 防御性编码提示（适用于所有 step render 函数）：
@@ -61,7 +60,7 @@ if (!rootEl) throw new Error('#root not found');
 
 const skillMessages = mergeMessages(
   platformWidgetMessages,
-  { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> },
+  { 'zh-CN': zhCN as Record<string, string> },
 );
 
 function SkillRoot() {

package/templates/file/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@mi
 import { FilePicker, uploadFile, platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 /*
  * 防御性编码提示（适用于所有 step render 函数）：
@@ -79,7 +78,7 @@ function Home({ title, description, useCases, tags, onStart }: { title: string;
 const rootEl = document.getElementById('root');
 if (!rootEl) throw new Error('#root not found');
 
-const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string> });
 
 function SkillRoot() {
   const t = useT();

package/templates/frontend-package.json.tpl

@@ -11,8 +11,8 @@
     "sonner": "^2.0.7"
   },
   "devDependencies": {
-    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.1",
-    "@types/node": "^20.14.0",
+    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.12",
+    "@types/node": "^{{nodeMajor}}.0.0",
     "@types/react": "^18.3.3",
     "@types/react-dom": "^18.3.0",
     "@vitejs/plugin-react": "^4.3.1",

package/templates/keyword/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig } from '@mi
 import { AmazonSearchBar, CountrySelect, SearchSubmitButton, validateKeywords, platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 /*
  * 防御性编码提示（适用于所有 step render 函数）：
@@ -71,7 +70,7 @@ function Home({ title, description, useCases, tags, onStart }: { title: string;
 const rootEl = document.getElementById('root');
 if (!rootEl) throw new Error('#root not found');
 
-const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> });
+const skillMessages = mergeMessages(platformWidgetMessages, { 'zh-CN': zhCN as Record<string, string> });
 
 function SkillRoot() {
   const t = useT();

package/templates/main.tsx.tpl

@@ -4,7 +4,6 @@ import { FlowApp, I18nProvider, mergeMessages, useT, type StepConfig, type StepR
 import { AmazonSearchBar, CompletionPanel, CountrySelect, SearchSubmitButton, validateAsins, validateKeywords, platformWidgetMessages } from '@minus/platform-widgets';
 import { Toaster } from 'sonner';
 import zhCN from './locales/zh-CN.json';
-import enUS from './locales/en-US.json';
 
 type InputType = 'keyword' | 'asin';
 
@@ -146,7 +145,7 @@ if (!rootEl) throw new Error('#root not found');
 
 const skillMessages = mergeMessages(
   platformWidgetMessages,
-  { 'zh-CN': zhCN as Record<string, string>, 'en-US': enUS as Record<string, string> },
+  { 'zh-CN': zhCN as Record<string, string> },
 );
 
 function SkillRoot() {

package/templates/pnpm-workspace.yaml.tpl

@@ -1,2 +1,15 @@
 packages:
   - frontend
+
+# pnpm 11 的 minimumReleaseAge 门槛会拒装"发布太近"的版本，导致内部包刚发布的新版被压回旧版。
+# @minus-ai/* 是平台内部高频迭代包，豁免门槛以保证新建项目总能拿到最新版。
+minimumReleaseAgeExclude:
+  - '@minus-ai/*'
+
+# pnpm 11.4 起用 allowBuilds 审批构建脚本；只写 onlyBuiltDependencies 会被忽略并报 ERR_PNPM_IGNORED_BUILDS（install exit 1）。
+allowBuilds:
+  esbuild: true
+
+# 兼容 pnpm 10.16+ 的旧机制，与 allowBuilds 共存无害。
+onlyBuiltDependencies:
+  - esbuild

package/templates/root-package.json.tpl

@@ -3,16 +3,23 @@
   "description": "{{description}}",
   "private": true,
   "type": "module",
+  "engines": {
+    "node": ">={{nodeMajor}}"
+  },
+  "volta": {
+    "node": "{{nodeVersion}}",
+    "pnpm": "11.4.0"
+  },
   "workspaces": ["frontend"],
   "scripts": {
     "dev": "minus-dev-cleanup && mkdir -p .minus && echo $$ > .minus/dev.pid && concurrently -n skill,fe \".venv/bin/uvicorn server:app --port {{port}} --reload --reload-include '*.py' --reload-include '.env.local' --env-file .env.local\" \"cd frontend && pnpm exec vite\"",
+    "dev:backend": "minus-dev-cleanup && mkdir -p .minus && echo $$ > .minus/backend.pid && .venv/bin/uvicorn server:app --port {{port}} --reload --reload-include '*.py' --reload-include '.env.local' --env-file .env.local",
+    "dev:win": "minus-dev --port {{port}}",
+    "dev:win:backend": "minus-dev --port {{port}} --backend-only",
     "build": "cd frontend && pnpm run build"
   },
   "devDependencies": {
-    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.1",
+    "@minus-ai/dev-vite-plugin": "^0.1.0-beta.12",
     "concurrently": "^9.1.2"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": ["esbuild"]
   }
 }

package/templates/vite.config.ts.tpl

@@ -4,7 +4,7 @@ import path from 'node:path';
 import { minusDev } from '@minus-ai/dev-vite-plugin';
 
 export default defineConfig({
-  plugins: [react(), ...minusDev({ localBackend: 'http://localhost:{{port}}' })],
+  plugins: [react(), ...minusDev({ localBackend: 'http://127.0.0.1:{{port}}' })],
   build: {
     target: 'esnext',
     outDir: path.resolve(__dirname, '../static'),