@greatjoy/gy 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,92 @@
-# Temporary Holding Version
+# gy
 
-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.
+个人脚手架 CLI：在项目内一键发布 cartech-library 组件库。
+
+```
+gy ktcpub
+```
+
+## 安装
+
+```bash
+# 公共源全局安装（推荐）
+npm install -g gy
+
+# 海尔内网：通过 npm.haier.net 代理同样可安装（nexus 代理公共源）
+npm install -g gy --registry=http://npm.haier.net/
+```
+
+## 用法
+
+### 一键发布组件库
+
+在 cartech-library 仓库内（任意子目录）执行：
+
+```bash
+gy ktcpub
+```
+
+向导流程（按需确认，一问一答）：
+
+1. **发布环境**：正式版（latest） / Beta 版（beta tag）
+2. **依赖安装**：haier 源安装（推荐，自动执行 `nrm use haier`） / 跳过
+3. **组件选择**：空格多选、回车确认（自动扫描全部可发布包并显示当前版本）
+4. **版本级别**：patch / minor / major（实时预览目标版本，Beta 显示 `-beta.N`）
+5. **发布内容**：必填，写入 CHANGELOG（随后作为 git commit message）
+6. **认证**：自动复用 `~/.npmrc` 中 haier 发布源的 token，缺失时才提示输入
+7. **ver 后暂停**：`changeset version` 更新完版本号与 CHANGELOG 后询问是否继续（此时 git 可见中间变更，可先核对/修改再放行；选择暂停会给出手动继续的命令）
+
+执行流水线（复用仓库既有 changeset 链路，不重新发明）：
+
+```
+正式: [nrm use haier → pnpm i] → 生成 changeset → changeset version → turbo build
+     → nrm use haierpub → changeset publish → 回读校验 dist-tag → git add/commit/push
+Beta: [nrm use haier → pnpm i] → 自动 enter beta → 生成 changeset → changeset version
+     → 自动 exit beta → turbo build → nrm use haierpub → changeset publish --tag beta
+     → 校验 beta tag → git add/commit/push
+```
+
+> 依赖安装与发布前会自动执行 `nrm use haier` / `nrm use haierpub` 切换镜像；若未安装 nrm，会提示你手动执行对应命令切换（按回车确认后继续）。
+
+常用选项：
+
+```bash
+gy ktcpub --dry-run          # 只打印将执行的命令，不实际执行
+gy ktcpub --allow-any-branch # 正式发布时跳过 dev 分支校验
+```
+
+### 其他
+
+```bash
+gy --help        # 查看全部子命令
+gy ktcpub --help
+```
+
+## 开发调试
+
+```bash
+cd "D:\aWork\gy CLI"
+npm install
+npm link          # 注册全局 gy 命令（本机调试）
+node bin/gy.js ktcpub --help   # 不 link 直接跑
+```
+
+## 发布 gy 到公共源
+
+```bash
+cd "D:\aWork\gy CLI"
+npm run pub       # npm publish --registry=https://registry.npmjs.org/
+```
+
+- 首次发布前需登录公共源：`npm login --registry=https://registry.npmjs.org/`
+- 发布后海尔内网通过 `npm.haier.net` 代理即可安装（nexus proxy 仓库会回源公共 npm）
+- 包名 `gy` 已确认在公共源未被占用
+
+## 配置
+
+常量集中在 `src/config.js`：仓库目录名、haier 安装源/发布源、发布 scope、排除包、正式分支。
+
+## 扩展新命令
+
+1. 在 `src/commands/` 新建命令文件，导出 `xxxCommand(program)` 注册函数
+2. 在 `src/commands/index.js` 的 `registerCommands` 中引入一行即可

package/bin/gy.js

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { registerCommands } from '../src/commands/index.js';
+
+const program = new Command();
+
+program
+  .name('gy')
+  .description('gy 个人脚手架 CLI')
+  .version('0.1.0');
+
+registerCommands(program);
+
+program.parseAsync(process.argv).catch((err) => {
+  console.error(err?.message || err);
+  process.exit(1);
+});

package/package.json

@@ -1,6 +1,29 @@
-{
+{
   "name": "@greatjoy/gy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "个人脚手架 CLI：一键发布 cartech-library 组件库等",
+  "type": "module",
+  "bin": {
+    "gy": "bin/gy.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "test": "node --test",
+    "pub": "npm publish --registry=https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "inquirer": "^12.4.1"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "ISC"
+}

package/src/commands/index.js

@@ -0,0 +1,6 @@
+import { ktcpubCommand } from './ktcpub.js';
+
+// 命令注册表：新增子命令 = 新增一个命令文件并在此注册
+export function registerCommands(program) {
+  ktcpubCommand(program);
+}

package/src/commands/ktcpub.js

@@ -0,0 +1,333 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import inquirer from 'inquirer';
+import { config } from '../config.js';
+import { log } from '../core/log.js';
+import { run, capture, switchNrm } from '../core/run.js';
+import { currentBranch, dirtyFiles } from '../core/git.js';
+import { locateRepo } from '../core/locate.js';
+import { scanPackages, dependents } from '../core/packages.js';
+import { previewTarget } from '../core/version.js';
+import { createChangeset, isPreMode } from '../core/changeset.js';
+import { readAuthToken, writeAuthToken } from '../core/auth.js';
+
+// 统一交互主题：问题加粗暖橙(#f60)、高亮橙色反色、选中绿色、辅助信息灰色
+const F60 = '38;2;255;102;0';
+const F60_BG = '48;2;255;102;0';
+const HI_FG = '38;2;17;13;10';
+
+const uiTheme = {
+  prefix: '',
+  spinner: { interval: 80, frames: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'] },
+  style: {
+    message: (text) => `\x1b[1;${F60}m${text}\x1b[0m`,
+    answer: (text) => `\x1b[${F60}m${text}\x1b[0m`,
+    highlight: (text) => `\x1b[${F60_BG}m\x1b[${HI_FG}m${text}\x1b[0m`,
+    selected: (text) => `\x1b[32m${text}\x1b[0m`,
+    error: (text) => `\x1b[31m✖ ${text}\x1b[0m`,
+    help: (text) => `\x1b[2m${text}\x1b[0m`,
+    key: (text) => `\x1b[33m${text}\x1b[0m`,
+    muted: (text) => `\x1b[2m${text}\x1b[0m`,
+  },
+};
+
+const themed = (q) => ({ ...q, theme: uiTheme });
+
+// 组件选项：包名暖橙(#f60) + 版本灰色
+const pkgChoice = (p) => ({
+  name: `\x1b[${F60}m${p.name}\x1b[0m  \x1b[2m(${p.version})\x1b[0m`,
+  value: p.name,
+});
+
+export function ktcpubCommand(program) {
+  program
+    .command('ktcpub')
+    .description('一键发布 cartech-library 组件（向导式：环境/组件/版本/发布内容）')
+    .option('--dry-run', '只打印将执行的命令，不实际执行')
+    .option('--allow-any-branch', '正式发布时跳过 dev 分支校验')
+    .action((opts) => runKtcpub(opts));
+}
+
+async function runKtcpub(opts) {
+  const dryRun = !!opts.dryRun;
+
+  // 1. 定位仓库
+  const repoDir = locateRepo(process.cwd());
+  if (!repoDir) {
+    log.error(`未找到 ${config.repoDirName} 仓库，请在项目目录内执行`);
+    process.exit(1);
+  }
+  log.ok(`定位项目：${repoDir}`);
+
+  // 2. 预检
+  const branch = currentBranch(repoDir);
+  log.info(`当前分支：${branch}`);
+  const dirty = dirtyFiles(repoDir);
+  if (dirty.length) log.warn(`工作区有 ${dirty.length} 处未提交改动（发布后将随版本改动一并提交）`);
+
+  // 3. 扫描可发布包
+  const packages = scanPackages(repoDir);
+  if (!packages.length) {
+    log.error('未扫描到可发布包');
+    process.exit(1);
+  }
+
+  // 4. 交互向导
+  const answers = await inquirer.prompt([
+    themed({
+      type: 'list',
+      name: 'env',
+      message: '发布环境：',
+      choices: [
+        { name: '正式版 (stable → latest)', value: 'stable' },
+        { name: 'Beta 版 (beta tag)', value: 'beta' },
+      ],
+    }),
+    themed({
+      type: 'list',
+      name: 'install',
+      message: '依赖安装：',
+      choices: [
+        { name: 'haier 源安装（推荐）', value: 'haier' },
+        { name: '跳过（node_modules 已就绪）', value: 'skip' },
+      ],
+    }),
+    {
+      type: 'checkbox',
+      name: 'selected',
+      message: '选择要发布的组件（空格多选，回车确认）：',
+      pageSize: 20,
+      choices: packages.map(pkgChoice),
+      theme: { ...uiTheme, icon: { checked: '✔', unchecked: '○', cursor: '' } },
+      validate: (v) => (v.length ? true : '至少选择一个组件'),
+    },
+    themed({
+      type: 'rawlist',
+      name: 'level',
+      message: '版本级别：',
+      choices: (answers) =>
+        ['patch', 'minor', 'major'].map((level) => {
+          const sample = packages.find((p) => p.name === answers.selected[0]);
+          const hint = sample
+            ? `${sample.name}: ${sample.version} → ${previewTarget(sample.version, level, answers.env === 'beta')}`
+            : '';
+          return { name: level + (hint ? `  \x1b[2m(${hint})\x1b[0m` : ''), value: level };
+        }),
+    }),
+    themed({
+      type: 'input',
+      name: 'summary',
+      message: '发布内容（必填，写入 CHANGELOG）：',
+      validate: (v) => (v.trim() ? true : '发布内容不能为空'),
+    }),
+  ]);
+
+  const isBeta = answers.env === 'beta';
+
+  // 5. 依赖联动提示
+  const links = dependents(packages, answers.selected);
+  if (links.length) {
+    log.warn('以下未选中包依赖了所选组件，可能需联动发布：');
+    for (const l of links) log.info(`  ${l.name}@${l.version}  ← 依赖 ${l.dependsOn.join(', ')}`);
+    const { addLinked } = await inquirer.prompt([
+      themed({
+        type: 'confirm',
+        name: 'addLinked',
+        message: '是否一并发布这些依赖方？',
+        default: true,
+      }),
+    ]);
+    if (addLinked) answers.selected.push(...links.map((l) => l.name));
+  }
+
+  // 6. 认证检测（复用 ~/.npmrc，缺失才输入）
+  let token = readAuthToken();
+  if (!token) {
+    const { newToken, saveToken } = await inquirer.prompt([
+      themed({
+        type: 'password',
+        name: 'newToken',
+        message: `未检测到 ${config.publishRegistry} 的认证 token，请输入：`,
+      }),
+      themed({
+        type: 'confirm',
+        name: 'saveToken',
+        message: '是否写入 ~/.npmrc（changeset 发布需要）？',
+        default: true,
+      }),
+    ]);
+    if (!newToken.trim()) {
+      log.error('未提供 token，已中止');
+      process.exit(1);
+    }
+    token = newToken.trim();
+    if (saveToken) writeAuthToken(token);
+  }
+  log.ok(`发布源认证就绪：${config.publishRegistry}`);
+
+  // 7. 分支校验（正式发布要求 dev）
+  if (!isBeta && branch !== config.stableBranch && !opts.allowAnyBranch) {
+    log.error(`正式发布必须在 ${config.stableBranch} 分支（当前：${branch}），可用 --allow-any-branch 跳过`);
+    process.exit(1);
+  }
+
+  // 8. 确认清单
+  const targets = answers.selected.map((name) => {
+    const p = packages.find((x) => x.name === name);
+    return `  ${p.name}@${p.version} → ${previewTarget(p.version, answers.level, isBeta)}`;
+  });
+  log.title('发布确认清单');
+  log.info(`环境   ：${isBeta ? 'Beta（dist-tag: beta）' : '正式（dist-tag: latest）'}`);
+  log.info(`分支   ：${branch}`);
+  log.info(`安装   ：${answers.install === 'haier' ? 'haier 源' : '跳过'}`);
+  log.info(`组件   ：\n${targets.join('\n')}`);
+  log.info(`改动日志：将写入各选中包 CHANGELOG —— ${answers.summary}`);
+  log.info(`发布源 ：${config.publishRegistry}`);
+  const { confirm } = await inquirer.prompt([
+    themed({
+      type: 'confirm',
+      name: 'confirm',
+      message: dryRun ? '以上为 dry-run 计划，确认打印命令序列？' : '确认执行发布？',
+      default: true,
+    }),
+  ]);
+  if (!confirm) {
+    log.info('已取消');
+    return;
+  }
+
+  // 9. 执行流水线
+  const runOpts = { cwd: repoDir, dryRun };
+  let step = 0;
+  const next = (title) => log.step(`${++step}. ${title}`);
+
+  // 9.1 安装依赖（haier 源：先 nrm use haier）
+  if (answers.install === 'haier') {
+    next('使用 haier 源安装依赖');
+    if (!switchNrm(config.nrmInstallSource, runOpts)) {
+      log.warn(`未检测到 nrm，请手动执行：nrm use ${config.nrmInstallSource}`);
+      if (!dryRun) {
+        const { manualSwitchedInstall } = await inquirer.prompt([
+          themed({
+            type: 'confirm',
+            name: 'manualSwitchedInstall',
+            message: '已手动切换到 haier 源？',
+            default: true,
+          }),
+        ]);
+        if (!manualSwitchedInstall) log.warn('未切换源，按当前全局 registry 继续安装');
+      }
+    }
+    run('pnpm', ['i'], runOpts);
+  } else {
+    next('跳过依赖安装');
+  }
+
+  // 9.2 beta pre 模式（如需要）与生成 changeset
+  if (isBeta && !isPreMode(repoDir)) {
+    next('进入 beta pre 模式 (changeset pre enter beta)');
+    run('wa', ['changesetDoc', 'enterBeta'], runOpts);
+  } else if (isBeta) {
+    next('已在 beta pre 模式');
+  }
+  next('生成 changeset');
+  if (!dryRun) {
+    const entries = Object.fromEntries(answers.selected.map((name) => [name, answers.level]));
+    const changesetFile = createChangeset(repoDir, entries, answers.summary);
+    log.info(`已生成 changeset：${path.basename(changesetFile)}（内容将作为各包 CHANGELOG 改动日志）`);
+  } else {
+    const names = answers.selected.map((n) => `"${n}": ${answers.level}`).join('\n');
+    log.info(`[dry-run] 将生成 .changeset/<时间戳>-gy-ktcpub.md：\n---\n${names}\n---\n\n${answers.summary.trim()}`);
+  }
+
+  // 9.3 更新版本与改动日志
+  next('更新版本号与改动日志 (changeset version)');
+  run('wa', ['changesetDoc', 'ver'], runOpts);
+
+  // 9.3.1 ver 后暂停：核对版本号与改动日志（此时 git 可见中间变更）
+  if (!dryRun) {
+    const { proceedAfterVer } = await inquirer.prompt([
+      themed({
+        type: 'confirm',
+        name: 'proceedAfterVer',
+        message: '版本号与改动日志已更新（git 可见），是否继续构建/发布？',
+        default: true,
+      }),
+    ]);
+    if (!proceedAfterVer) {
+      log.warn('已暂停，可查看/修改版本号与 CHANGELOG 后手动执行继续：');
+      log.info('  wa changesetDoc tBuild      # 构建全部包');
+      log.info('  wa changesetDoc pub|pubBeta # 发布正式/Beta');
+      if (isBeta) log.info('  （Beta 模式，继续前需先：wa changesetDoc exitBeta）');
+      return;
+    }
+  }
+
+  // 9.4 Beta：ver 生成 beta 版本号后，先退出 beta pre 模式再继续
+  if (isBeta) {
+    next('退出 beta pre 模式 (changeset pre exit)');
+    run('wa', ['changesetDoc', 'exitBeta'], runOpts);
+  }
+
+  // 9.5 构建
+  next('构建全部包 (turbo build)');
+  run('wa', ['changesetDoc', 'tBuild'], runOpts);
+
+  // 9.6 发布（先 nrm use haierpub，认证走 ~/.npmrc 与仓库 .npmrc 已有配置）
+  next('发布到 haier 私有源');
+  if (!switchNrm(config.nrmPublishSource, runOpts)) {
+    log.warn(`未检测到 nrm，请手动执行：nrm use ${config.nrmPublishSource}`);
+    if (!dryRun) {
+      const { manualSwitchedPublish } = await inquirer.prompt([
+        themed({
+          type: 'confirm',
+          name: 'manualSwitchedPublish',
+          message: '已手动切换到 haierpub 源？',
+          default: true,
+        }),
+      ]);
+      if (!manualSwitchedPublish) log.warn('未切换源，按当前配置继续发布');
+    }
+  }
+  run('wa', ['changesetDoc', isBeta ? 'pubBeta' : 'pub'], runOpts);
+
+  // 9.7 回读校验
+  next('回读校验 dist-tag');
+  if (!dryRun) {
+    const tag = isBeta ? 'beta' : 'latest';
+    for (const name of answers.selected) {
+      try {
+        const json = JSON.parse(
+          capture('npm', ['view', name, 'dist-tags', '--json', `--registry=${config.publishRegistry}`], { cwd: repoDir }),
+        );
+        log.ok(`${name} dist-tag ${tag} = ${json[tag] ?? '(未找到)'}`);
+      } catch {
+        log.warn(`${name} 校验未确认，请人工核验 ${config.publishRegistry}`);
+      }
+    }
+  }
+
+  // 9.8 git 提交并推送
+  next('git 提交并推送');
+  if (dryRun) {
+    run('git', ['add', '-A'], runOpts);
+    run('git', ['commit', '-F', '<临时文件: release: 发布内容>'], runOpts);
+    run('git', ['push', 'origin', branch], runOpts);
+  } else {
+    run('git', ['add', '-A'], { cwd: repoDir });
+    const msgFile = path.join(os.tmpdir(), `gy-commit-${Date.now()}.txt`);
+    fs.writeFileSync(msgFile, `release: ${answers.summary.trim()}`, 'utf-8');
+    run('git', ['commit', '-F', msgFile], { cwd: repoDir });
+    fs.rmSync(msgFile, { force: true });
+    run('git', ['push', 'origin', branch], { cwd: repoDir });
+    log.ok(`已推送 origin/${branch}`);
+  }
+
+  // 10. 汇总
+  log.title(isBeta ? 'Beta 发布完成' : '正式发布完成');
+  for (const name of answers.selected) log.info(`  ${name}`);
+  if (isBeta) {
+    log.warn('Beta 已自动退出 pre 模式；如需续发下一个 Beta，下次执行会自动重新进入');
+  }
+}

package/src/config.js

@@ -0,0 +1,18 @@
+// gy CLI 全局配置
+export const config = {
+  // 定位目标：cartech-library 仓库目录名
+  repoDirName: 'cartech-library',
+  // haier 安装源（依赖安装）
+  installRegistry: 'http://nexus.haier.net/repository/dts-npm-group/',
+  // haier 发布源
+  publishRegistry: 'https://nexus.haier.net/repository/dts-npm/',
+  // 发布包 scope（用于认证检测）
+  publishScope: '@catech-front-end-private-npm',
+  // 不参与发布的包目录
+  excludedPackages: ['dumi-docs'],
+  // 正式发布要求的 git 分支
+  stableBranch: 'dev',
+  // nrm 源名：安装依赖 / 发布前
+  nrmInstallSource: 'haier',
+  nrmPublishSource: 'haierpub',
+};

package/src/core/auth.js

@@ -0,0 +1,23 @@
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { config } from '../config.js';
+
+const AUTH_KEY = '//nexus.haier.net/repository/dts-npm/:_authToken=';
+
+// 读取 ~/.npmrc 中发布源已有的 token；无则返回 null
+export function readAuthToken() {
+  const npmrc = path.join(os.homedir(), '.npmrc');
+  if (!fs.existsSync(npmrc)) return null;
+  const content = fs.readFileSync(npmrc, 'utf-8');
+  const line = content.split(/\r?\n/).find((l) => l.trim().startsWith(AUTH_KEY));
+  return line ? line.trim().slice(AUTH_KEY.length) : null;
+}
+
+// 将 token 追加写入 ~/.npmrc（发布认证用）
+export function writeAuthToken(token) {
+  const npmrc = path.join(os.homedir(), '.npmrc');
+  const line = `${AUTH_KEY}${token}`;
+  const existing = fs.existsSync(npmrc) ? fs.readFileSync(npmrc, 'utf-8').replace(/\s+$/, '') : '';
+  fs.writeFileSync(npmrc, `${existing}\n${line}\n`, 'utf-8');
+}

package/src/core/changeset.js

@@ -0,0 +1,20 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+// 是否处于 changeset pre（beta）模式
+export function isPreMode(repoDir) {
+  return fs.existsSync(path.join(repoDir, '.changeset', 'pre.json'));
+}
+
+// 生成 changeset 文件，返回文件路径
+// entries: { "<包名>": "patch" | "minor" | "major" }
+export function createChangeset(repoDir, entries, summary) {
+  const ts = new Date().toISOString().replace(/[-:T]/g, '').slice(0, 14);
+  const file = path.join(repoDir, '.changeset', `${ts}-gy-ktcpub.md`);
+  const frontmatter = Object.entries(entries)
+    .map(([name, level]) => `"${name}": ${level}`)
+    .join('\n');
+  const content = `---\n${frontmatter}\n---\n\n${summary.trim()}\n`;
+  fs.writeFileSync(file, content, 'utf-8');
+  return file;
+}

package/src/core/git.js

@@ -0,0 +1,10 @@
+import { capture } from './run.js';
+
+export function currentBranch(cwd) {
+  return capture('git', ['rev-parse', '--abbrev-ref', 'HEAD'], { cwd });
+}
+
+export function dirtyFiles(cwd) {
+  const out = capture('git', ['status', '--porcelain'], { cwd });
+  return out ? out.split('\n').map((l) => l.trim()).filter(Boolean) : [];
+}

package/src/core/locate.js

@@ -0,0 +1,21 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { config } from '../config.js';
+
+// 从 startDir 向上定位 cartech-library 仓库目录；找不到返回 null
+export function locateRepo(startDir) {
+  let dir = path.resolve(startDir);
+  for (;;) {
+    for (const candidate of [path.join(dir, config.repoDirName), path.join(dir, 'packages', config.repoDirName)]) {
+      if (
+        fs.existsSync(path.join(candidate, 'package.json')) &&
+        fs.existsSync(path.join(candidate, '.changeset'))
+      ) {
+        return candidate;
+      }
+    }
+    const parent = path.dirname(dir);
+    if (parent === dir) return null;
+    dir = parent;
+  }
+}

package/src/core/log.js

@@ -0,0 +1,10 @@
+const paint = (code, msg) => `\x1b[${code}m${msg}\x1b[0m`;
+
+export const log = {
+  step: (msg) => console.log(paint(36, `\n▸ ${msg}`)),
+  info: (msg) => console.log(paint(2, msg)),
+  ok: (msg) => console.log(paint(32, `✔ ${msg}`)),
+  warn: (msg) => console.log(paint(33, `⚠ ${msg}`)),
+  error: (msg) => console.error(paint(31, `✖ ${msg}`)),
+  title: (msg) => console.log(paint(1, `\n=== ${msg} ===`)),
+};

package/src/core/packages.js

@@ -0,0 +1,42 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { config } from '../config.js';
+
+// 扫描 cartech-library/packages 下的可发布包
+// 返回 [{ dir, name, version, dependencies }]
+export function scanPackages(repoDir) {
+  const root = path.join(repoDir, 'packages');
+  if (!fs.existsSync(root)) return [];
+  const result = [];
+  for (const dir of fs.readdirSync(root)) {
+    if (config.excludedPackages.includes(dir)) continue;
+    const pkgPath = path.join(root, dir, 'package.json');
+    if (!fs.existsSync(pkgPath)) continue;
+    let pkg;
+    try {
+      pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    } catch {
+      continue;
+    }
+    if (pkg.private || !pkg.name) continue;
+    result.push({
+      dir,
+      name: pkg.name,
+      version: pkg.version || '0.0.0',
+      dependencies: { ...(pkg.dependencies || {}), ...(pkg.peerDependencies || {}) },
+    });
+  }
+  return result.sort((a, b) => a.name.localeCompare(b.name));
+}
+
+// 找出依赖了选中包的未选中包
+export function dependents(packages, selectedNames) {
+  const selected = new Set(selectedNames);
+  const list = [];
+  for (const pkg of packages) {
+    if (selected.has(pkg.name)) continue;
+    const hits = Object.keys(pkg.dependencies).filter((d) => selected.has(d));
+    if (hits.length) list.push({ name: pkg.name, version: pkg.version, dependsOn: hits });
+  }
+  return list;
+}

package/src/core/run.js

@@ -0,0 +1,53 @@
+import { spawnSync } from 'node:child_process';
+import path from 'node:path';
+
+// 在目标目录执行命令（Windows 兼容 .cmd，通过 shell 解析 PATH）
+export function run(cmd, args = [], opts = {}) {
+  const { cwd = process.cwd(), dryRun = false, env = {} } = opts;
+  const display = [cmd, ...args].join(' ');
+
+  if (dryRun) {
+    console.log(`  [dry-run] ${display}`);
+    return { status: 0 };
+  }
+
+  const mergedEnv = {
+    ...process.env,
+    // 确保仓库本地 .bin（wa.cmd 等）可被解析
+    PATH: `${path.join(cwd, 'node_modules', '.bin')}${path.delimiter}${process.env.PATH || ''}`,
+    ...env,
+  };
+
+  const res = spawnSync(cmd, args, { cwd, stdio: 'inherit', shell: true, env: mergedEnv });
+  if (res.error) throw res.error;
+  if (res.status !== 0) throw new Error(`命令执行失败 (exit ${res.status}): ${display}`);
+  return res;
+}
+
+// 执行并捕获输出（用于版本校验等需要读回结果的场景）
+export function capture(cmd, args = [], opts = {}) {
+  const { cwd = process.cwd(), env = {} } = opts;
+  const mergedEnv = {
+    ...process.env,
+    PATH: `${path.join(cwd, 'node_modules', '.bin')}${path.delimiter}${process.env.PATH || ''}`,
+    ...env,
+  };
+  const res = spawnSync(cmd, args, { cwd, encoding: 'utf-8', shell: true, env: mergedEnv });
+  if (res.error) throw res.error;
+  if (res.status !== 0) throw new Error(`命令执行失败 (exit ${res.status}): ${cmd} ${args.join(' ')}`);
+  return res.stdout.trim();
+}
+
+// nrm 是否已安装
+export function hasNrm() {
+  const res = spawnSync('nrm', ['--version'], { shell: true, stdio: 'pipe' });
+  return !res.error && res.status === 0;
+}
+
+// 切换 nrm 源；nrm 未安装时返回 false（由调用方提示手动切换）
+export function switchNrm(source, opts = {}) {
+  const { cwd = process.cwd(), dryRun = false } = opts;
+  if (!hasNrm()) return false;
+  run('nrm', ['use', source], { cwd, dryRun });
+  return true;
+}

package/src/core/version.js

@@ -0,0 +1,27 @@
+// 解析版本号：x.y.z 或 x.y.z-<tag>.N
+export function parseVersion(v) {
+  const m = /^(\d+)\.(\d+)\.(\d+)(?:-([a-zA-Z]+)\.(\d+))?$/.exec(String(v).trim());
+  if (!m) return null;
+  return { major: +m[1], minor: +m[2], patch: +m[3], tag: m[4] || null, tagNum: m[5] ? +m[5] : null };
+}
+
+// 按级别计算基础版本增量（patch/minor/major）
+export function bumpBase(v, level) {
+  const p = parseVersion(v);
+  if (!p) return null;
+  if (level === 'patch') return `${p.major}.${p.minor}.${p.patch + 1}`;
+  if (level === 'minor') return `${p.major}.${p.minor + 1}.0`;
+  if (level === 'major') return `${p.major + 1}.0.0`;
+  return null;
+}
+
+// 发布目标版本预览：beta 模式递增 pre 编号，正式模式 bump 基础版本
+export function previewTarget(current, level, isBeta) {
+  const p = parseVersion(current);
+  if (!p) return null;
+  if (isBeta) {
+    if (p.tag === 'beta') return `${p.major}.${p.minor}.${p.patch}-beta.${(p.tagNum ?? 0) + 1}`;
+    return `${bumpBase(current, level)}-beta.0`;
+  }
+  return bumpBase(current, level);
+}