@wangzhanpeng996/wzp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,119 @@
+# wzp
+
+`wzp` 是一个个人命令行工具箱。安装后统一使用 `wzp <命令>` 调用不同功能。
+
+当前已有功能：
+
+- `wzp gitee-create`：从一个源仓库克隆项目，删除原 `.git`，自动创建新的 Gitee 仓库，并重新绑定 remote。
+- `wzp create`：`wzp gitee-create` 的兼容别名。
+- `wzp kill`：快速释放本机指定端口，例如 `wzp kill 8080`。
+- `wzp kill-port`：`wzp kill` 的兼容别名。
+
+## 安装
+
+本机开发调试：
+
+```powershell
+npm link
+wzp --help
+```
+
+发布到 npm 后：
+
+```powershell
+npm i -g @wangzhanpeng996/wzp
+```
+
+## gitee-create
+
+先在当前 PowerShell 会话设置 Gitee 访问令牌：
+
+```powershell
+$env:GITEE_TOKEN="你的Gitee访问令牌"
+```
+
+然后在你希望生成项目的目录里执行：
+
+```powershell
+wzp gitee-create https://gitee.com/wzplxt/web1.git my-new-repo
+```
+
+也可以使用具名参数：
+
+```powershell
+wzp gitee-create `
+  --source https://gitee.com/wzplxt/web1.git `
+  --repo my-new-repo `
+  --description "我的新项目" `
+  --private `
+  --no-push
+```
+
+它会做这些事：
+
+1. 检查 `GITEE_TOKEN`，令牌缺失或无效会直接退出。
+2. 在 Gitee 当前 token 对应的个人账号下创建新仓库。
+3. 把源仓库克隆到当前运行目录下的 `my-new-repo` 文件夹。
+4. 删除克隆下来的原 `.git`。
+5. 重新执行 `git init`。
+6. 把 `origin` 指向新 Gitee 仓库，默认优先使用 HTTPS 地址。
+7. 执行 `git add .` 和一次初始化提交。
+8. 默认继续推送到新 Gitee 仓库；如果加了 `--no-push`，只在本地准备好。
+
+如果加了 `--no-push`，最后会提示完整推送命令，例如：
+
+```powershell
+git -C "F:\0.代码\脚手架维护\test\my-new-repo" push -u origin HEAD
+```
+
+## 发布
+
+## kill
+
+释放本机端口：
+
+```powershell
+wzp kill 8080
+```
+
+Windows 下会查找正在监听该 TCP 端口的进程，然后执行：
+
+```powershell
+taskkill /PID <进程ID> /F
+```
+
+如果没有进程监听该端口，会直接提示无需处理。
+
+## 发布
+
+如果这是第一次发布 `wzp` 这个新包名：
+
+```powershell
+npm login
+npm publish --access=public --otp=你的6位验证码
+```
+
+后续更新：
+
+```powershell
+npm version patch
+npm publish --access=public --otp=你的6位验证码
+```
+
+别人更新：
+
+```powershell
+npm i -g @wangzhanpeng996/wzp@latest
+```
+
+## 继续扩展新功能
+
+以后新增功能时，在 `bin/wzp.js` 里增加新的子命令分支即可，例如：
+
+```text
+wzp md-init
+wzp env-check
+wzp config
+```
+
+推荐把 `wzp` 作为总入口，把具体能力都放在子命令里。

package/bin/wzp.js

@@ -0,0 +1,404 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { mkdir, readdir, rm, writeFile } from "node:fs/promises";
+import { basename, dirname, isAbsolute, join, resolve } from "node:path";
+import process from "node:process";
+import readline from "node:readline/promises";
+
+const globalHelp = `
+用法:
+  wzp <命令> [参数]
+
+可用命令:
+  gitee-create    从源仓库克隆项目，断开原 git 历史，创建并绑定新的 Gitee 仓库
+  create          gitee-create 的兼容别名
+  kill            释放指定端口，例如 wzp kill 8080
+  kill-port       kill 的兼容别名
+
+示例:
+  wzp gitee-create https://gitee.com/wzplxt/web1.git my-new-repo
+  wzp gitee-create --source https://gitee.com/wzplxt/web1.git --repo my-new-repo
+  wzp kill 8080
+
+查看子命令帮助:
+  wzp gitee-create --help
+  wzp kill --help
+`;
+
+const giteeCreateHelp = `
+用法:
+  wzp gitee-create <源仓库地址> <新仓库名>
+  wzp gitee-create --source <源仓库地址> --repo <新仓库名>
+
+常用参数:
+  --source <url>          要克隆的原项目地址，也可以作为第 1 个位置参数
+  --repo <name>           新 Gitee 仓库路径名，也会作为当前目录下的新项目文件夹名
+  --description <text>    Gitee 仓库简介
+  --private               创建私有 Gitee 仓库
+  --no-push               初始化提交后不推送到 origin
+  -h, --help              显示帮助
+
+认证方式:
+  启动后会检查环境变量 GITEE_TOKEN。没有令牌或令牌无效会直接退出。
+  不要把 Gitee 密码写进命令或脚本。推送认证交给本机 git 凭据管理器。
+`;
+
+const killHelp = `
+用法:
+  wzp kill <端口号>
+  wzp kill-port <端口号>
+
+示例:
+  wzp kill 8080
+
+说明:
+  Windows 下会查找正在监听该 TCP 端口的进程，并执行 taskkill /F。
+  请只对你确认可以关闭的本地开发服务使用。
+`;
+
+main().catch((error) => {
+  console.error(`\n失败: ${error.message}`);
+  process.exit(1);
+});
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (!command || command === "--help" || command === "-h") {
+    console.log(globalHelp.trim());
+    return;
+  }
+
+  if (command === "gitee-create" || command === "create") {
+    await runGiteeCreate(args.slice(1));
+    return;
+  }
+
+  if (command === "kill" || command === "kill-port") {
+    await runKillPort(args.slice(1));
+    return;
+  }
+
+  throw new Error(`未知命令: ${command}\n\n${globalHelp.trim()}`);
+}
+
+async function runKillPort(args) {
+  if (args.includes("--help") || args.includes("-h")) {
+    console.log(killHelp.trim());
+    return;
+  }
+
+  const port = args.find((arg) => !arg.startsWith("-"));
+  if (!port || !/^\d+$/.test(port)) {
+    throw new Error("缺少端口号，例如: wzp kill 8080");
+  }
+
+  const portNumber = Number(port);
+  if (portNumber < 1 || portNumber > 65535) {
+    throw new Error("端口号必须在 1 到 65535 之间");
+  }
+
+  if (process.platform === "win32") {
+    await killPortOnWindows(portNumber);
+    return;
+  }
+
+  await killPortOnUnix(portNumber);
+}
+
+async function runGiteeCreate(args) {
+  const parsed = parseArgs(args);
+  if (parsed.help) {
+    console.log(giteeCreateHelp.trim());
+    return;
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+
+  try {
+    const source = await requiredValue(rl, parsed, "source", "源仓库地址");
+    const repo = await requiredValue(rl, parsed, "repo", "新仓库名");
+    const authUser = await validateGiteeToken(process.env.GITEE_TOKEN);
+    console.log(`Gitee 令牌有效，当前用户: ${authUser.login || authUser.name || authUser.id}`);
+
+    const target = resolve(process.cwd(), repo);
+    const push = !parsed.options.noPush;
+
+    await ensureTargetAvailable(target);
+
+    const remote = await createGiteeRepo({
+      owner: authUser.login,
+      repo,
+      name: repo,
+      description: parsed.options.description ?? "",
+      isPrivate: Boolean(parsed.options.private),
+      token: process.env.GITEE_TOKEN
+    });
+
+    await run("git", ["clone", source, target]);
+    await detachGitHistory(target);
+    await run("git", ["init"], { cwd: target });
+    await run("git", ["remote", "add", "origin", remote], { cwd: target });
+    await run("git", ["add", "."], { cwd: target });
+    await run("git", ["commit", "-m", "初始化项目"], { cwd: target, allowFailure: true });
+
+    if (push) {
+      await run("git", ["push", "-u", "origin", "HEAD"], { cwd: target });
+    }
+
+    console.log("\n完成");
+    console.log(`本地目录: ${target}`);
+    console.log(`新 remote: ${remote}`);
+    if (!push) {
+      console.log(`尚未推送。确认无误后可执行: git -C "${target}" push -u origin HEAD`);
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+function parseArgs(args) {
+  const result = {
+    help: args.includes("--help") || args.includes("-h"),
+    options: {}
+  };
+
+  const positionals = [];
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      continue;
+    }
+    if (!arg.startsWith("--")) {
+      positionals.push(arg);
+      continue;
+    }
+
+    const [rawKey, inlineValue] = arg.slice(2).split("=", 2);
+    const key = toCamelCase(rawKey);
+    if (["private", "noPush"].includes(key)) {
+      result.options[key] = true;
+      continue;
+    }
+
+    const value = inlineValue ?? args[i + 1];
+    if (!value || value.startsWith("--")) {
+      throw new Error(`参数 --${rawKey} 缺少值`);
+    }
+    result.options[key] = value;
+    if (inlineValue === undefined) {
+      i += 1;
+    }
+  }
+
+  result.options.source ??= positionals[0];
+  result.options.repo ??= positionals[1];
+  return result;
+}
+
+function toCamelCase(value) {
+  return value.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+
+async function requiredValue(rl, parsed, key, label) {
+  const current = parsed.options[key];
+  if (current) {
+    return current;
+  }
+  const answer = await rl.question(`${label}: `);
+  if (!answer.trim()) {
+    throw new Error(`缺少必填参数: ${label}`);
+  }
+  return answer.trim();
+}
+
+async function ensureTargetAvailable(target) {
+  if (!isAbsolute(target)) {
+    throw new Error("本地目标目录必须能解析为绝对路径");
+  }
+  if (!existsSync(dirname(target))) {
+    await mkdir(dirname(target), { recursive: true });
+  }
+  if (!existsSync(target)) {
+    return;
+  }
+  const entries = await readdir(target);
+  if (entries.length > 0) {
+    throw new Error(`目标目录已存在且不是空目录: ${target}`);
+  }
+}
+
+async function detachGitHistory(target) {
+  const gitDir = join(target, ".git");
+  const resolvedGitDir = resolve(gitDir);
+  const resolvedTarget = resolve(target);
+  if (!resolvedGitDir.startsWith(`${resolvedTarget}\\`) && resolvedGitDir !== join(resolvedTarget, ".git")) {
+    throw new Error(`拒绝删除异常路径: ${resolvedGitDir}`);
+  }
+  if (existsSync(gitDir)) {
+    await rm(gitDir, { recursive: true, force: true });
+  }
+}
+
+async function createGiteeRepo({ owner, repo, name, description, isPrivate, token }) {
+  const body = new URLSearchParams({
+    access_token: token,
+    name,
+    path: repo,
+    description,
+    private: String(isPrivate)
+  });
+
+  const response = await fetch("https://gitee.com/api/v5/user/repos", {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/x-www-form-urlencoded"
+    },
+    body
+  });
+
+  const payload = await response.json().catch(() => ({}));
+  if (!response.ok) {
+    const message = payload.message || payload.error || response.statusText;
+    throw new Error(`Gitee 建仓失败: ${message}`);
+  }
+
+  return payload.html_url || payload.ssh_url || `https://gitee.com/${owner}/${repo}.git`;
+}
+
+async function validateGiteeToken(token) {
+  if (!token) {
+    throw new Error("缺少 GITEE_TOKEN。请先在当前 PowerShell 会话执行: $env:GITEE_TOKEN=\"你的Gitee访问令牌\"");
+  }
+
+  const url = new URL("https://gitee.com/api/v5/user");
+  url.searchParams.set("access_token", token);
+  const response = await fetch(url);
+  const payload = await response.json().catch(() => ({}));
+
+  if (!response.ok || !payload.id) {
+    const message = payload.message || payload.error || response.statusText;
+    throw new Error(`GITEE_TOKEN 无效或权限不足: ${message}`);
+  }
+
+  return payload;
+}
+
+function run(command, args, options = {}) {
+  return new Promise((resolvePromise, reject) => {
+    console.log(`> ${command} ${args.join(" ")}`);
+    const child = spawn(command, args, {
+      cwd: options.cwd ?? process.cwd(),
+      stdio: "inherit",
+      shell: false
+    });
+
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0 || options.allowFailure) {
+        resolvePromise();
+        return;
+      }
+      reject(new Error(`命令退出码 ${code}: ${command} ${args.join(" ")}`));
+    });
+  });
+}
+
+async function killPortOnWindows(port) {
+  const output = await capture("netstat", ["-ano", "-p", "TCP"]);
+  const pids = new Set();
+
+  for (const line of output.split(/\r?\n/)) {
+    const trimmed = line.trim();
+    if (!trimmed || !trimmed.includes("LISTENING")) {
+      continue;
+    }
+
+    const parts = trimmed.split(/\s+/);
+    const localAddress = parts[1];
+    const state = parts[3];
+    const pid = parts[4];
+    if (state !== "LISTENING" || !pid) {
+      continue;
+    }
+
+    if (addressUsesPort(localAddress, port)) {
+      pids.add(pid);
+    }
+  }
+
+  if (pids.size === 0) {
+    console.log(`端口 ${port} 没有监听进程。`);
+    return;
+  }
+
+  for (const pid of pids) {
+    console.log(`释放端口 ${port}: 结束 PID ${pid}`);
+    await run("taskkill", ["/PID", pid, "/F"]);
+  }
+
+  console.log(`端口 ${port} 已释放。`);
+}
+
+async function killPortOnUnix(port) {
+  const output = await capture("lsof", ["-ti", `tcp:${port}`, "-sTCP:LISTEN"], { allowFailure: true });
+  const pids = output
+    .split(/\r?\n/)
+    .map((line) => line.trim())
+    .filter(Boolean);
+
+  if (pids.length === 0) {
+    console.log(`端口 ${port} 没有监听进程。`);
+    return;
+  }
+
+  for (const pid of pids) {
+    console.log(`释放端口 ${port}: 结束 PID ${pid}`);
+    await run("kill", ["-9", pid]);
+  }
+
+  console.log(`端口 ${port} 已释放。`);
+}
+
+function addressUsesPort(address, port) {
+  if (!address) {
+    return false;
+  }
+  if (address.startsWith("[") && address.includes("]:")) {
+    return address.endsWith(`]:${port}`);
+  }
+  return address.endsWith(`:${port}`);
+}
+
+function capture(command, args, options = {}) {
+  return new Promise((resolvePromise, reject) => {
+    const child = spawn(command, args, {
+      cwd: options.cwd ?? process.cwd(),
+      stdio: ["ignore", "pipe", "pipe"],
+      shell: false
+    });
+
+    let stdout = "";
+    let stderr = "";
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk.toString();
+    });
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk.toString();
+    });
+    child.on("error", reject);
+    child.on("exit", (code) => {
+      if (code === 0 || options.allowFailure) {
+        resolvePromise(stdout);
+        return;
+      }
+      reject(new Error(`命令退出码 ${code}: ${command} ${args.join(" ")}\n${stderr.trim()}`));
+    });
+  });
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@wangzhanpeng996/wzp",
+  "version": "0.1.0",
+  "description": "Personal CLI toolbox for Gitee project creation and other WZP workflows.",
+  "type": "module",
+  "bin": {
+    "wzp": "bin/wzp.js"
+  },
+  "files": [
+    "bin",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "start": "node ./bin/wzp.js",
+    "check": "node ./bin/wzp.js --help"
+  },
+  "keywords": [
+    "gitee",
+    "git",
+    "clone",
+    "cli",
+    "toolbox"
+  ],
+  "license": "MIT"
+}