@hupan56/wlkj 2.2.3 → 2.2.5

package/bin/cli.js

@@ -1,533 +1,533 @@
-#!/usr/bin/env node
-// wlkj - workflow toolkit
-
-const path = require("path");
-const fs = require("fs");
-const { execSync } = require("child_process");
-
-const T = path.join(__dirname, "..", "templates");
-
-// 当前 npm 包版本（从 package.json 读，不硬编码）
-const PKG_VERSION = JSON.parse(
-  fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")
-).version;
-
-// 升级时受保护的用户数据文件（绝不覆盖）
-// 这些文件含团队/机器特定配置，覆盖 = 数据丢失
-const PROTECTED_FILES = new Set([
-  "config.yaml",        // 团队 git 仓库 URL、平台映射
-  "settings.json",      // 本地权限/hook 配置
-]);
-
-// 本地状态文件（升级时也绝不碰，但不算"受保护配置"，不提示合并）
-const LOCAL_STATE_FILES = new Set([
-  ".developer", ".current-task", ".engine-version",
-]);
-
-function py(script, args = []) {
-  const p = path.join(process.cwd(), ".qoder", "scripts", script);
-  if (!fs.existsSync(p)) { console.log("请先运行: npx wlkj init"); process.exit(1); }
-  try {
-    return execSync(`python "${p}" ${args.map(a => `"${a}"`).join(" ")}`, { cwd: process.cwd(), encoding: "utf-8", timeout: 15000 });
-  } catch (e) { return (e.stdout || e.message); }
-}
-
-function cp(src, dest) {
-  const s = path.join(T, src), d = path.join(process.cwd(), dest);
-  if (!fs.existsSync(s)) return;
-  fs.mkdirSync(path.dirname(d), { recursive: true });
-  if (!fs.existsSync(d)) { fs.copyFileSync(s, d); return true; }
-  return false;
-}
-
-function gitOp(op) {
-  const cwd = process.cwd();
-  const cmds = {
-    "提交": 'git add . && git commit -m "update [ai-assisted]" && git push',
-    "推送": "git push",
-    "拉取最新": "git pull",
-    "同步": "git pull",
-    "查看状态": "git status",
-    "提交PRD": 'git add workspace/specs/prd/ && git commit -m "docs(ai): PRD update [ai-generated]" && git push',
-    "提交Spec": 'git add workspace/specs/ && git commit -m "docs(ai): Spec update [ai-generated]" && git push',
-    "提交任务": 'git add workspace/tasks/ && git commit -m "chore: task update [ai-assisted]" && git push',
-  };
-  const cmd = cmds[op];
-  if (!cmd) { console.log("可用: 提交 推送 拉取最新 同步 查看状态 提交PRD 提交Spec 提交任务"); return; }
-  try { console.log(execSync(cmd, { cwd, encoding: "utf-8", timeout: 30000, stdio: "pipe" }) || `${op} done`); }
-  catch (e) { console.log(e.stdout || e.message); }
-}
-
-function doInit(name) {
-  const cwd = process.cwd();
-  const hasExisting = fs.existsSync(path.join(cwd, ".qoder", "scripts", "setup.py"));
-  console.log(`\nwlkj init -> ${cwd}${hasExisting ? " (已存在, 增量更新)" : ""}\n`);
-
-  // === 1. 拷贝完整引擎 (镜像 .qoder/ 结构) ===
-  // 源: templates/qoder/*  目标: .qoder/*
-  // 注意: init 用 "update" 模式的保护逻辑更安全 —— 新装时目标文件不存在,
-  // 保护逻辑不触发; 重跑 init 时 config.yaml/settings.json 不会被覆盖。
-  const qoderSrc = path.join(T, "qoder");
-  let copied = 0;
-  if (fs.existsSync(qoderSrc)) {
-    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
-    copied = r.copied;
-    if (r.protectedN > 0) {
-      console.log(`  [保护] ${r.protectedN} 个配置文件未覆盖（新版存为 .new）`);
-    }
-  }
-  console.log(`  引擎: ${copied} 个文件 (${hasExisting ? "更新" : "新建"})`);
-
-  // === 2. 根文件 (AGENTS.md, 新手指南.md) ===
-  ["root/AGENTS.md", "root/新手指南.md"].forEach(f => {
-    const src = path.join(T, f);
-    if (fs.existsSync(src)) {
-      const dstName = path.basename(f);
-      const dst = path.join(cwd, dstName);
-      if (!fs.existsSync(dst)) {
-        fs.copyFileSync(src, dst);
-      }
-    }
-  });
-
-  // === 3. workspace 目录结构 ===
-  ["workspace/specs/prd", "workspace/tasks", "workspace/constitution",
-   "workspace/members", "data/docs/prd", "data/index", "data/code"].forEach(d => {
-    fs.mkdirSync(path.join(cwd, d), { recursive: true });
-  });
-  console.log(`  workspace 目录就绪`);
-
-  // === 4. git init (若没有) ===
-  if (!fs.existsSync(path.join(cwd, ".git"))) {
-    try { execSync("git init", { cwd, stdio: "pipe" }); console.log(`  git init done`); }
-    catch (_) { /* git 可能没装, 不阻塞 */ }
-  }
-
-  // === 5. .gitignore (若没有) ===
-  const gitignorePath = path.join(cwd, ".gitignore");
-  if (!fs.existsSync(gitignorePath)) {
-    const baseGitignore = [
-      "# Source code repos (cloned by git_sync.py)", "data/code/",
-      "", "# AI pipeline runtime", ".qoder/.developer", ".qoder/.current-task",
-      ".qoder/.engine-version", ".qoder/.runtime/", "",
-      "# Personal learning", ".qoder/learning/feedback.jsonl",
-      "", "# Machine-local", "data/index/.last-sync", "data/index/.prd-collected.json",
-      "data/index/.index-meta.json", "data/index/.sync-lock", "data/index/.file-keys.json",
-      "data/index/.inverted-cache.json", "data/index/*.corrupt",
-      "", "# Identity (secret)", "workspace/members/*/.signing_key", "",
-      "# Python", "__pycache__/", "*.pyc", "*.lock", "",
-    ].join("\n");
-    fs.writeFileSync(gitignorePath, baseGitignore, "utf-8");
-  }
-
-  // === 6. 自动跑 setup.py (名字探测/git/索引/cron/QoderWork) ===
-  console.log(`\n--- 自动初始化 ---`);
-  const setupPath = path.join(cwd, ".qoder", "scripts", "setup.py");
-  if (fs.existsSync(setupPath)) {
-    const setupArgs = [name, "pm", "--skip-cron", "--skip-qoderwork"].filter(Boolean);
-    try {
-      const cmd = `python "${setupPath}" ${setupArgs.map(a => `"${a}"`).join(" ")}`;
-      console.log(`  运行: setup.py ${setupArgs.join(" ")}`);
-      execSync(cmd, { cwd, stdio: "inherit", timeout: 300000 });
-    } catch (e) {
-      console.log(`  setup 部分失败 (不阻塞): ${(e.message || "").slice(0, 100)}`);
-      console.log(`  可手动重跑: python .qoder/scripts/setup.py`);
-    }
-  } else {
-    console.log(`  setup.py 未找到, 跳过自动初始化`);
-  }
-
-  // === 7. 写版本戳 ===
-  writeEngineVersion(cwd);
-
-  console.log(`\n${"=".repeat(50)}`);
-  console.log(`  安装完成!  (v${PKG_VERSION})`);
-  console.log(`${"=".repeat(50)}`);
-  console.log(`\n  现在可以开始了:`);
-  console.log(`    在 Qoder 里说 "写个 XX 的需求"`);
-  console.log(`    或输 / 看命令列表 (/wl-prd /wl-search /wl-task)`);
-  console.log(`\n  看不到命令? 新建对话 / 重启 QoderWork`);
-  console.log(`  环境问题? python .qoder/scripts/init_doctor.py --fix\n`);
-}
-
-// 递归拷贝目录, 返回 {copied, protected, skipped}
-// mode: "init" (新装, 全拷) | "update" (升级, 保护用户数据)
-function copyDirRecursive(src, dst, mode = "init") {
-  let copied = 0, protectedN = 0, skipped = 0;
-  if (!fs.existsSync(src)) return { copied, protectedN, skipped };
-  fs.mkdirSync(dst, { recursive: true });
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    if (entry.name === "__pycache__" || entry.name.endsWith(".pyc")) continue;
-    const s = path.join(src, entry.name);
-    const d = path.join(dst, entry.name);
-    if (entry.isDirectory()) {
-      const r = copyDirRecursive(s, d, mode);
-      copied += r.copied; protectedN += r.protectedN; skipped += r.skipped;
-    } else {
-      const isEngine = entry.name.endsWith(".py") || entry.name.endsWith(".md") ||
-                       entry.name.endsWith(".yaml") || entry.name.endsWith(".yml") ||
-                       entry.name.endsWith(".toml") || entry.name.endsWith(".json") ||
-                       entry.name.endsWith(".html") || entry.name.endsWith(".txt");
-
-      if (mode === "update") {
-        // 升级模式: 受保护文件绝不覆盖
-        if (PROTECTED_FILES.has(entry.name) && fs.existsSync(d)) {
-          // 新版内容存为 .new 让用户手动合并（仅当内容不同）
-          if (!filesEqual(s, d)) {
-            fs.copyFileSync(s, d + ".new");
-            protectedN++;
-          } else {
-            skipped++;
-          }
-          continue;
-        }
-        // 引擎文件: 无条件刷新（纯引擎, 不含用户数据）
-        // 非引擎文件: 已存在跳过, 不存在才建
-        if (isEngine || !fs.existsSync(d)) {
-          fs.copyFileSync(s, d);
-          copied++;
-        } else {
-          skipped++;
-        }
-      } else {
-        // init 模式: 引擎文件全覆盖, 非引擎已存在跳过 (保留用户改动)
-        if (isEngine || !fs.existsSync(d)) {
-          fs.copyFileSync(s, d);
-        }
-        copied++;
-      }
-    }
-  }
-  return { copied, protectedN, skipped };
-}
-
-// 两文件内容是否相同（先比大小再比内容）
-function filesEqual(a, b) {
-  try {
-    const sa = fs.statSync(a), sb = fs.statSync(b);
-    if (sa.size !== sb.size) return false;
-    return fs.readFileSync(a).equals(fs.readFileSync(b));
-  } catch { return false; }
-}
-
-// 版本戳: .qoder/.engine-version 存当前引擎版本
-function writeEngineVersion(cwd) {
-  try {
-    const p = path.join(cwd, ".qoder", ".engine-version");
-    fs.mkdirSync(path.dirname(p), { recursive: true });
-    fs.writeFileSync(p, PKG_VERSION + "\n", "utf-8");
-  } catch { /* 不阻塞 */ }
-}
-
-function readEngineVersion(cwd) {
-  try {
-    const p = path.join(cwd, ".qoder", ".engine-version");
-    if (fs.existsSync(p)) return fs.readFileSync(p, "utf-8").trim();
-  } catch { /* */ }
-  return null;
-}
-
-// 跑 install_qoderwork.py（升级时强制刷新 commands）
-function runQoderWorkInstall(cwd, forceCommands) {
-  const script = path.join(cwd, ".qoder", "scripts", "install_qoderwork.py");
-  if (!fs.existsSync(script)) {
-    console.log("  [跳过] install_qoderwork.py 不存在");
-    return;
-  }
-  const args = ["python", `"${script}"`];
-  if (forceCommands) args.push("--force-commands");
-  try {
-    console.log(`\n--- 刷新 QoderWork ---`);
-    execSync(args.join(" "), { cwd, stdio: "inherit", timeout: 60000 });
-  } catch (e) {
-    console.log(`  QoderWork 刷新失败 (不阻塞): ${(e.message || "").slice(0, 80)}`);
-  }
-}
-
-function doStatus() {
-  console.log("");
-  const dev = path.join(process.cwd(), ".qoder", ".developer");
-  if (fs.existsSync(dev)) {
-    const line = fs.readFileSync(dev, "utf-8").split("\n")[0];
-    console.log("dev: " + line.split("=")[1]?.trim());
-  } else { console.log("dev: - (run: npx wlkj init <name>)"); }
-  
-  process.stdout.write(py("task.py", ["current", "--source"]));
-  
-  const wsSpecs = path.join(process.cwd(), "workspace", "specs", "prd");
-  if (fs.existsSync(wsSpecs)) {
-    const n = fs.readdirSync(wsSpecs).filter(f => f.endsWith(".md")).length;
-    console.log(`PRDs: ${n}`);
-  }
-  const ver = readEngineVersion(process.cwd());
-  console.log(`engine: ${ver || "未知"} (最新: v${PKG_VERSION})${ver === PKG_VERSION ? " [最新]" : ver ? " [可升级: npx @hupan56/wlkj update]" : ""}`);
-  console.log("");
-}
-
-function doUpdate() {
-  const cwd = process.cwd();
-  const oldVer = readEngineVersion(cwd);
-  const qoderSrc = path.join(T, "qoder");
-
-  // 前置检查: 必须已装过
-  if (!fs.existsSync(path.join(cwd, ".qoder", "scripts"))) {
-    console.log("\n  未检测到已安装的引擎。首次安装请用:");
-    console.log("    npx @hupan56/wlkj init [你的名字]\n");
-    return;
-  }
-
-  console.log(`\nwlkj update${oldVer ? " " + oldVer : ""} -> v${PKG_VERSION}\n`);
-
-  // === 1. 刷新引擎文件（保护 config.yaml / settings.json）===
-  let copied = 0, protectedN = 0, skipped = 0;
-  if (fs.existsSync(qoderSrc)) {
-    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
-    copied = r.copied; protectedN = r.protectedN; skipped = r.skipped;
-  }
-  console.log(`  引擎刷新: ${copied} 个文件${skipped ? ` / ${skipped} 无变化` : ""}`);
-
-  // 报告受保护文件
-  if (protectedN > 0) {
-    console.log(`  [保护] ${protectedN} 个配置文件已保留你的本地设置:`);
-    console.log(`         新版模板存为 .new 文件, 如需合并新结构请手动对比:`);
-    // 列出实际生成的 .new 文件
-    try {
-      for (const f of fs.readdirSync(path.join(cwd, ".qoder"))) {
-        if (f.endsWith(".new")) {
-          console.log(`           .qoder/${f}`);
-        }
-      }
-    } catch { /* */ }
-  } else {
-    console.log(`  config.yaml / settings.json: 已保护（未改动）`);
-  }
-
-  // === 2. 根文件（文档类, 安全覆盖）===
-  ["root/AGENTS.md", "root/新手指南.md"].forEach(f => {
-    const src = path.join(T, f);
-    if (fs.existsSync(src)) {
-      fs.copyFileSync(src, path.join(cwd, path.basename(f)));
-    }
-  });
-  console.log(`  根文档: 已更新`);
-
-  // === 3. 刷新 QoderWork commands（强制覆盖已存在的）===
-  runQoderWorkInstall(cwd, true);
-
-  // === 4. 写版本戳 ===
-  writeEngineVersion(cwd);
-
-  console.log(`\n${"=".repeat(50)}`);
-  console.log(`  升级完成!  (v${PKG_VERSION})`);
-  console.log(`${"=".repeat(50)}`);
-  console.log(`\n  生效方式:`);
-  console.log(`    Qoder IDE / Quest: 新建对话即可`);
-  console.log(`    QoderWork: 重启应用或新建对话`);
-  if (protectedN > 0) {
-    console.log(`\n  ⚠ 有配置文件新版有变化, 生成 .new 文件:`);
-    console.log(`    确认无需合并后可直接删除, 或手动合并后删除`);
-  }
-  console.log("");
-}
-
-function doHelp() {
-  console.log("");
-  console.log(`wlkj - AI 产品研发工作流 (v${PKG_VERSION})`);
-  console.log("");
-  console.log("=== 环境安装 (什么都没装时先跑这个) ===");
-  console.log("  npx @hupan56/wlkj install-env       检测+自动装 Node/Python/git");
-  console.log("  npx @hupan56/wlkj install-env --check  只检测不装");
-  console.log("  npx @hupan56/wlkj install-env --location D:\\wldev  指定安装目录");
-  console.log("  npx @hupan56/wlkj add-path D:\\wldev\\nodejs  把目录加到系统 PATH");
-  console.log("");
-  console.log("=== 一键安装 (装好环境后) ===");
-  console.log("  npx @hupan56/wlkj init [你的名字]    安装完整引擎 + 自动初始化");
-  console.log("");
-  console.log("=== 升级 (已装用户, 新版本发布后) ===");
-  console.log("  npx @hupan56/wlkj update              刷新引擎, 保护你的配置");
-  console.log("");
-  console.log("=== 安装后怎么用 ===");
-  console.log("  在 Qoder (IDE/Quest/QoderWork) 里:");
-  console.log("    说中文: '写个 XX 的需求' '查一下 XX 代码' '建个任务'");
-  console.log("    或斜杠: /wl-prd /wl-search /wl-task /wl-status /wl-report");
-  console.log("");
-  console.log("=== 状态 ===");
-  console.log("  npx @hupan56/wlkj status            查看当前状态 + 引擎版本");
-  console.log("");
-  console.log("=== 环境修复 ===");
-  console.log("  python .qoder/scripts/init_doctor.py --fix   自动修复环境");
-  console.log("  python .qoder/scripts/setup.py               重新初始化");
-  console.log("");
-  console.log("=== Git (中文命令) ===");
-  console.log("  npx @hupan56/wlkj 提交PRD           提交 PRD");
-  console.log("  npx @hupan56/wlkj 提交任务           提交任务");
-  console.log("  npx @hupan56/wlkj 提交               全部提交并推送");
-  console.log("  npx @hupan56/wlkj 拉取最新 / 同步    git pull");
-  console.log("");
-}
-
-function doInstallEnv(checkOnly = false, location = null) {
-  const { execSync } = require("child_process");
-  const isWin = process.platform === "win32";
-  const isMac = process.platform === "darwin";
-
-  // 解析 --location（CLI 入口已提取，这里兜底）
-  console.log("\n=== 环境检测 ===\n");
-  if (location) {
-    console.log(`  安装位置: ${location}${isWin ? "" : " (仅 Windows winget 支持指定目录)"}`);
-    // Windows: 预建目录
-    if (isWin) {
-      try { fs.mkdirSync(location, { recursive: true }); } catch { /* */ }
-    }
-  }
-
-  // 检测函数
-  function check(cmd) {
-    try { return execSync(`${cmd} --version`, { encoding: "utf-8", timeout: 5000, stdio: "pipe" }).trim().split("\n")[0]; }
-    catch { return null; }
-  }
-  function has(cmd) {
-    try { execSync(`where ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; }
-    catch { try { execSync(`which ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; } catch { return false; } }
-  }
-  // Windows: 把目录加到用户 PATH（幂等，已存在不重复加）
-  function addToPathWin(dir) {
-    if (!isWin) return false;
-    try {
-      // 用 setx 会截断超长 PATH，改用 PowerShell 读 User PATH 追加
-      const ps = `powershell -NoProfile -Command "$p=[Environment]::GetEnvironmentVariable('Path','User'); if($p -notlike '*{dir}*'){[Environment]::SetEnvironmentVariable('Path',$p.TrimEnd(';')+';{dir}','User')}"`.replace(/{dir}/g, dir.replace(/\\/g, "\\\\"));
-      execSync(ps, { stdio: "pipe", timeout: 15000 });
-      return true;
-    } catch (e) { console.log(`  [WARN] 加 PATH 失败（可手动加）: ${dir}`); return false; }
-  }
-  function install(name, wingetId, brewPkg) {
-    if (checkOnly) return false;
-    try {
-      if (isWin && has("winget")) {
-        console.log(`  用 winget 装 ${name}...`);
-        // winget --location 不一定被安装包尊重，但先传上
-        let cmd = `winget install --id ${wingetId} -e --source winget --accept-source-agreements --accept-package-agreements`;
-        if (location) cmd += ` --location "${location}"`;
-        execSync(cmd, { stdio: "inherit", timeout: 300000 });
-        return true;
-      } else if (isMac && has("brew")) {
-        console.log(`  用 brew 装 ${name}...`);
-        execSync(`brew install ${brewPkg}`, { stdio: "inherit", timeout: 300000 });
-        return true;
-      } else if (!isWin && !isMac) {
-        // Linux: 尝试 apt/dnf/yum
-        for (const [mgr, pkg] of [["apt", brewPkg], ["dnf", brewPkg]]) {
-          if (has(mgr)) {
-            console.log(`  用 ${mgr} 装 ${name}...`);
-            execSync(`sudo ${mgr} install -y ${pkg}`, { stdio: "inherit", timeout: 300000 });
-            return true;
-          }
-        }
-      }
-    } catch (e) { console.log(`  自动安装失败: ${(e.message || "").slice(0, 80)}`); }
-    return false;
-  }
-
-  const nodeVer = check("node");
-  const pyVer = check("python") || check("python3");
-  const gitVer = check("git");
-
-  console.log(`  Node.js: ${nodeVer ? "[OK] " + nodeVer : "[缺失] (npx 命令需要)"}`);
-  console.log(`  Python:  ${pyVer ? "[OK] " + pyVer : "[缺失] (引擎需要)"}`);
-  console.log(`  git:     ${gitVer ? "[OK] " + gitVer : "[缺失] (可选, 核心功能不依赖)"}`);
-
-  if (checkOnly) {
-    console.log("\n仅检测。去掉 --check 自动安装。");
-    return;
-  }
-
-  const need = [];
-  if (!nodeVer) {
-    console.log("");
-    if (nodeVer || install("Node.js", "OpenJS.NodeJS.LTS", "node")) { console.log(`  [OK] Node.js 已装`); }
-    else { need.push("Node.js (手动: https://nodejs.org)"); }
-  }
-  if (!pyVer) {
-    console.log("");
-    if (install("Python", "Python.Python.3.12", "python@3.12")) { console.log(`  [OK] Python 已装`); }
-    else { need.push("Python (手动: https://python.org, 勾 Add to PATH)"); }
-  }
-  if (!gitVer) {
-    console.log("");
-    if (install("git", "Git.Git", "git")) { console.log(`  [OK] git 已装`); }
-    else { need.push("git (手动: https://git-scm.com, 可选)"); }
-  }
-
-  // --location 模式: 提示用户验证安装位置 + 手动加 PATH
-  // （winget 的 --location 对 Node/Python 不一定生效，需用户确认）
-  if (location && isWin) {
-    console.log(`\n--- 安装位置确认 ---`);
-    console.log(`  你指定了: ${location}`);
-    console.log(`  注意: winget 的 --location 对 Node.js/Python 不一定生效`);
-    console.log(`        (取决于安装包是否支持自定义路径)`);
-    console.log(`  请检查实际装到哪了:`);
-    console.log(`    重新打开终端后跑: node --version  python --version  git --version`);
-    console.log(`  如果某软件没进 PATH, 手动把它加进去:`);
-    console.log(`    设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → Path → 新建`);
-    console.log(`    或用命令: npx @hupan56/wlkj add-path "D:\\wldev\\nodejs"`);
-  }
-
-  console.log("\n=== 结果 ===");
-  if (need.length === 0) {
-    console.log("  环境就绪! 下一步: npx @hupan56/wlkj init");
-    console.log("  (新装的可能需要重新打开终端)");
-  } else {
-    console.log("  以下需手动安装:");
-    need.forEach(n => console.log("    - " + n));
-  }
-}
-
-// add-path: 把目录加到 Windows 用户 PATH（幂等）
-function doAddPath(dir) {
-  if (!dir) { console.log("用法: npx @hupan56/wlkj add-path <目录>"); return; }
-  if (process.platform !== "win32") {
-    console.log("add-path 仅支持 Windows。Mac/Linux 请手动加到 ~/.zshrc 或 ~/.bashrc");
-    return;
-  }
-  const abs = path.resolve(dir);
-  if (!fs.existsSync(abs)) {
-    console.log(`[警告] 目录不存在: ${abs}（仍会加到 PATH）`);
-  }
-  try {
-    const ps = `powershell -NoProfile -Command "$p=[Environment]::GetEnvironmentVariable('Path','User'); if($p -notlike '*${abs.replace(/\\/g,"\\\\")}*'){[Environment]::SetEnvironmentVariable('Path',$p.TrimEnd(';')+';${abs.replace(/\\/g,"\\\\")}','User'); Write-Output 'ADDED'} else { Write-Output 'EXISTS' }"`;
-    const out = execSync(ps, { encoding: "utf-8", timeout: 15000 }).trim();
-    console.log(`  ${out === "ADDED" ? "已加入" : "已存在(无需重复加)"}: ${abs}`);
-    console.log(`  ⚠ 需要重新打开终端才生效`);
-  } catch (e) {
-    console.log(`  失败: ${(e.message || "").slice(0, 100)}`);
-    console.log(`  手动加: 设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → Path → 新建 → ${abs}`);
-  }
-}
-
-const [,, cmd, ...rest] = process.argv;
-const mapped = rest.map(a => a === "-p" ? "--priority" : a);
-
-switch (cmd) {
-  case "init": doInit(rest[0]); break;
-  case "update": case "upgrade": doUpdate(); break;
-  case "install-env": {
-    const checkOnly = rest.includes("--check");
-    // 提取 --location <dir> 或 --location=<dir>
-    let loc = null;
-    const li = rest.indexOf("--location");
-    if (li !== -1 && rest[li + 1]) loc = rest[li + 1];
-    const eq = rest.find(a => a.startsWith("--location="));
-    if (eq) loc = eq.slice("--location=".length);
-    doInstallEnv(checkOnly, loc);
-    break;
-  }
-  case "add-path": doAddPath(rest[0]); break;
-  case "task": process.stdout.write(py("task.py", mapped)); break;
-  case "status": doStatus(); break;
-  case "session": process.stdout.write(py("add_session.py", rest)); break;
-  case "help": case "--help": case "-h": doHelp(); break;
-  case "提交": case "推送": case "拉取最新": case "同步":
-  case "查看状态": case "提交PRD": case "提交Spec": case "提交任务":
-    gitOp(cmd); break;
-  default: doHelp();
+#!/usr/bin/env node
+// wlkj - workflow toolkit
+
+const path = require("path");
+const fs = require("fs");
+const { execSync } = require("child_process");
+
+const T = path.join(__dirname, "..", "templates");
+
+// 当前 npm 包版本（从 package.json 读，不硬编码）
+const PKG_VERSION = JSON.parse(
+  fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf-8")
+).version;
+
+// 升级时受保护的用户数据文件（绝不覆盖）
+// 这些文件含团队/机器特定配置，覆盖 = 数据丢失
+const PROTECTED_FILES = new Set([
+  "config.yaml",        // 团队 git 仓库 URL、平台映射
+  "settings.json",      // 本地权限/hook 配置
+]);
+
+// 本地状态文件（升级时也绝不碰，但不算"受保护配置"，不提示合并）
+const LOCAL_STATE_FILES = new Set([
+  ".developer", ".current-task", ".engine-version",
+]);
+
+function py(script, args = []) {
+  const p = path.join(process.cwd(), ".qoder", "scripts", script);
+  if (!fs.existsSync(p)) { console.log("请先运行: npx wlkj init"); process.exit(1); }
+  try {
+    return execSync(`python "${p}" ${args.map(a => `"${a}"`).join(" ")}`, { cwd: process.cwd(), encoding: "utf-8", timeout: 15000 });
+  } catch (e) { return (e.stdout || e.message); }
+}
+
+function cp(src, dest) {
+  const s = path.join(T, src), d = path.join(process.cwd(), dest);
+  if (!fs.existsSync(s)) return;
+  fs.mkdirSync(path.dirname(d), { recursive: true });
+  if (!fs.existsSync(d)) { fs.copyFileSync(s, d); return true; }
+  return false;
+}
+
+function gitOp(op) {
+  const cwd = process.cwd();
+  const cmds = {
+    "提交": 'git add . && git commit -m "update [ai-assisted]" && git push',
+    "推送": "git push",
+    "拉取最新": "git pull",
+    "同步": "git pull",
+    "查看状态": "git status",
+    "提交PRD": 'git add workspace/specs/prd/ && git commit -m "docs(ai): PRD update [ai-generated]" && git push',
+    "提交Spec": 'git add workspace/specs/ && git commit -m "docs(ai): Spec update [ai-generated]" && git push',
+    "提交任务": 'git add workspace/tasks/ && git commit -m "chore: task update [ai-assisted]" && git push',
+  };
+  const cmd = cmds[op];
+  if (!cmd) { console.log("可用: 提交 推送 拉取最新 同步 查看状态 提交PRD 提交Spec 提交任务"); return; }
+  try { console.log(execSync(cmd, { cwd, encoding: "utf-8", timeout: 30000, stdio: "pipe" }) || `${op} done`); }
+  catch (e) { console.log(e.stdout || e.message); }
+}
+
+function doInit(name) {
+  const cwd = process.cwd();
+  const hasExisting = fs.existsSync(path.join(cwd, ".qoder", "scripts", "setup.py"));
+  console.log(`\nwlkj init -> ${cwd}${hasExisting ? " (已存在, 增量更新)" : ""}\n`);
+
+  // === 1. 拷贝完整引擎 (镜像 .qoder/ 结构) ===
+  // 源: templates/qoder/*  目标: .qoder/*
+  // 注意: init 用 "update" 模式的保护逻辑更安全 —— 新装时目标文件不存在,
+  // 保护逻辑不触发; 重跑 init 时 config.yaml/settings.json 不会被覆盖。
+  const qoderSrc = path.join(T, "qoder");
+  let copied = 0;
+  if (fs.existsSync(qoderSrc)) {
+    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
+    copied = r.copied;
+    if (r.protectedN > 0) {
+      console.log(`  [保护] ${r.protectedN} 个配置文件未覆盖（新版存为 .new）`);
+    }
+  }
+  console.log(`  引擎: ${copied} 个文件 (${hasExisting ? "更新" : "新建"})`);
+
+  // === 2. 根文件 (AGENTS.md, 新手指南.md) ===
+  ["root/AGENTS.md", "root/新手指南.md"].forEach(f => {
+    const src = path.join(T, f);
+    if (fs.existsSync(src)) {
+      const dstName = path.basename(f);
+      const dst = path.join(cwd, dstName);
+      if (!fs.existsSync(dst)) {
+        fs.copyFileSync(src, dst);
+      }
+    }
+  });
+
+  // === 3. workspace 目录结构 ===
+  ["workspace/specs/prd", "workspace/tasks", "workspace/constitution",
+   "workspace/members", "data/docs/prd", "data/index", "data/code"].forEach(d => {
+    fs.mkdirSync(path.join(cwd, d), { recursive: true });
+  });
+  console.log(`  workspace 目录就绪`);
+
+  // === 4. git init (若没有) ===
+  if (!fs.existsSync(path.join(cwd, ".git"))) {
+    try { execSync("git init", { cwd, stdio: "pipe" }); console.log(`  git init done`); }
+    catch (_) { /* git 可能没装, 不阻塞 */ }
+  }
+
+  // === 5. .gitignore (若没有) ===
+  const gitignorePath = path.join(cwd, ".gitignore");
+  if (!fs.existsSync(gitignorePath)) {
+    const baseGitignore = [
+      "# Source code repos (cloned by git_sync.py)", "data/code/",
+      "", "# AI pipeline runtime", ".qoder/.developer", ".qoder/.current-task",
+      ".qoder/.engine-version", ".qoder/.runtime/", "",
+      "# Personal learning", ".qoder/learning/feedback.jsonl",
+      "", "# Machine-local", "data/index/.last-sync", "data/index/.prd-collected.json",
+      "data/index/.index-meta.json", "data/index/.sync-lock", "data/index/.file-keys.json",
+      "data/index/.inverted-cache.json", "data/index/*.corrupt",
+      "", "# Identity (secret)", "workspace/members/*/.signing_key", "",
+      "# Python", "__pycache__/", "*.pyc", "*.lock", "",
+    ].join("\n");
+    fs.writeFileSync(gitignorePath, baseGitignore, "utf-8");
+  }
+
+  // === 6. 自动跑 setup.py (名字探测/git/索引/cron/QoderWork) ===
+  console.log(`\n--- 自动初始化 ---`);
+  const setupPath = path.join(cwd, ".qoder", "scripts", "setup.py");
+  if (fs.existsSync(setupPath)) {
+    const setupArgs = [name, "pm", "--skip-cron", "--skip-qoderwork"].filter(Boolean);
+    try {
+      const cmd = `python "${setupPath}" ${setupArgs.map(a => `"${a}"`).join(" ")}`;
+      console.log(`  运行: setup.py ${setupArgs.join(" ")}`);
+      execSync(cmd, { cwd, stdio: "inherit", timeout: 300000 });
+    } catch (e) {
+      console.log(`  setup 部分失败 (不阻塞): ${(e.message || "").slice(0, 100)}`);
+      console.log(`  可手动重跑: python .qoder/scripts/setup.py`);
+    }
+  } else {
+    console.log(`  setup.py 未找到, 跳过自动初始化`);
+  }
+
+  // === 7. 写版本戳 ===
+  writeEngineVersion(cwd);
+
+  console.log(`\n${"=".repeat(50)}`);
+  console.log(`  安装完成!  (v${PKG_VERSION})`);
+  console.log(`${"=".repeat(50)}`);
+  console.log(`\n  现在可以开始了:`);
+  console.log(`    在 Qoder 里说 "写个 XX 的需求"`);
+  console.log(`    或输 / 看命令列表 (/wl-prd /wl-search /wl-task)`);
+  console.log(`\n  看不到命令? 新建对话 / 重启 QoderWork`);
+  console.log(`  环境问题? python .qoder/scripts/init_doctor.py --fix\n`);
+}
+
+// 递归拷贝目录, 返回 {copied, protected, skipped}
+// mode: "init" (新装, 全拷) | "update" (升级, 保护用户数据)
+function copyDirRecursive(src, dst, mode = "init") {
+  let copied = 0, protectedN = 0, skipped = 0;
+  if (!fs.existsSync(src)) return { copied, protectedN, skipped };
+  fs.mkdirSync(dst, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    if (entry.name === "__pycache__" || entry.name.endsWith(".pyc")) continue;
+    const s = path.join(src, entry.name);
+    const d = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      const r = copyDirRecursive(s, d, mode);
+      copied += r.copied; protectedN += r.protectedN; skipped += r.skipped;
+    } else {
+      const isEngine = entry.name.endsWith(".py") || entry.name.endsWith(".md") ||
+                       entry.name.endsWith(".yaml") || entry.name.endsWith(".yml") ||
+                       entry.name.endsWith(".toml") || entry.name.endsWith(".json") ||
+                       entry.name.endsWith(".html") || entry.name.endsWith(".txt");
+
+      if (mode === "update") {
+        // 升级模式: 受保护文件绝不覆盖
+        if (PROTECTED_FILES.has(entry.name) && fs.existsSync(d)) {
+          // 新版内容存为 .new 让用户手动合并（仅当内容不同）
+          if (!filesEqual(s, d)) {
+            fs.copyFileSync(s, d + ".new");
+            protectedN++;
+          } else {
+            skipped++;
+          }
+          continue;
+        }
+        // 引擎文件: 无条件刷新（纯引擎, 不含用户数据）
+        // 非引擎文件: 已存在跳过, 不存在才建
+        if (isEngine || !fs.existsSync(d)) {
+          fs.copyFileSync(s, d);
+          copied++;
+        } else {
+          skipped++;
+        }
+      } else {
+        // init 模式: 引擎文件全覆盖, 非引擎已存在跳过 (保留用户改动)
+        if (isEngine || !fs.existsSync(d)) {
+          fs.copyFileSync(s, d);
+        }
+        copied++;
+      }
+    }
+  }
+  return { copied, protectedN, skipped };
+}
+
+// 两文件内容是否相同（先比大小再比内容）
+function filesEqual(a, b) {
+  try {
+    const sa = fs.statSync(a), sb = fs.statSync(b);
+    if (sa.size !== sb.size) return false;
+    return fs.readFileSync(a).equals(fs.readFileSync(b));
+  } catch { return false; }
+}
+
+// 版本戳: .qoder/.engine-version 存当前引擎版本
+function writeEngineVersion(cwd) {
+  try {
+    const p = path.join(cwd, ".qoder", ".engine-version");
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, PKG_VERSION + "\n", "utf-8");
+  } catch { /* 不阻塞 */ }
+}
+
+function readEngineVersion(cwd) {
+  try {
+    const p = path.join(cwd, ".qoder", ".engine-version");
+    if (fs.existsSync(p)) return fs.readFileSync(p, "utf-8").trim();
+  } catch { /* */ }
+  return null;
+}
+
+// 跑 install_qoderwork.py（升级时强制刷新 commands）
+function runQoderWorkInstall(cwd, forceCommands) {
+  const script = path.join(cwd, ".qoder", "scripts", "install_qoderwork.py");
+  if (!fs.existsSync(script)) {
+    console.log("  [跳过] install_qoderwork.py 不存在");
+    return;
+  }
+  const args = ["python", `"${script}"`];
+  if (forceCommands) args.push("--force-commands");
+  try {
+    console.log(`\n--- 刷新 QoderWork ---`);
+    execSync(args.join(" "), { cwd, stdio: "inherit", timeout: 60000 });
+  } catch (e) {
+    console.log(`  QoderWork 刷新失败 (不阻塞): ${(e.message || "").slice(0, 80)}`);
+  }
+}
+
+function doStatus() {
+  console.log("");
+  const dev = path.join(process.cwd(), ".qoder", ".developer");
+  if (fs.existsSync(dev)) {
+    const line = fs.readFileSync(dev, "utf-8").split("\n")[0];
+    console.log("dev: " + line.split("=")[1]?.trim());
+  } else { console.log("dev: - (run: npx wlkj init <name>)"); }
+  
+  process.stdout.write(py("task.py", ["current", "--source"]));
+  
+  const wsSpecs = path.join(process.cwd(), "workspace", "specs", "prd");
+  if (fs.existsSync(wsSpecs)) {
+    const n = fs.readdirSync(wsSpecs).filter(f => f.endsWith(".md")).length;
+    console.log(`PRDs: ${n}`);
+  }
+  const ver = readEngineVersion(process.cwd());
+  console.log(`engine: ${ver || "未知"} (最新: v${PKG_VERSION})${ver === PKG_VERSION ? " [最新]" : ver ? " [可升级: npx @hupan56/wlkj update]" : ""}`);
+  console.log("");
+}
+
+function doUpdate() {
+  const cwd = process.cwd();
+  const oldVer = readEngineVersion(cwd);
+  const qoderSrc = path.join(T, "qoder");
+
+  // 前置检查: 必须已装过
+  if (!fs.existsSync(path.join(cwd, ".qoder", "scripts"))) {
+    console.log("\n  未检测到已安装的引擎。首次安装请用:");
+    console.log("    npx @hupan56/wlkj init [你的名字]\n");
+    return;
+  }
+
+  console.log(`\nwlkj update${oldVer ? " " + oldVer : ""} -> v${PKG_VERSION}\n`);
+
+  // === 1. 刷新引擎文件（保护 config.yaml / settings.json）===
+  let copied = 0, protectedN = 0, skipped = 0;
+  if (fs.existsSync(qoderSrc)) {
+    const r = copyDirRecursive(qoderSrc, path.join(cwd, ".qoder"), "update");
+    copied = r.copied; protectedN = r.protectedN; skipped = r.skipped;
+  }
+  console.log(`  引擎刷新: ${copied} 个文件${skipped ? ` / ${skipped} 无变化` : ""}`);
+
+  // 报告受保护文件
+  if (protectedN > 0) {
+    console.log(`  [保护] ${protectedN} 个配置文件已保留你的本地设置:`);
+    console.log(`         新版模板存为 .new 文件, 如需合并新结构请手动对比:`);
+    // 列出实际生成的 .new 文件
+    try {
+      for (const f of fs.readdirSync(path.join(cwd, ".qoder"))) {
+        if (f.endsWith(".new")) {
+          console.log(`           .qoder/${f}`);
+        }
+      }
+    } catch { /* */ }
+  } else {
+    console.log(`  config.yaml / settings.json: 已保护（未改动）`);
+  }
+
+  // === 2. 根文件（文档类, 安全覆盖）===
+  ["root/AGENTS.md", "root/新手指南.md"].forEach(f => {
+    const src = path.join(T, f);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, path.join(cwd, path.basename(f)));
+    }
+  });
+  console.log(`  根文档: 已更新`);
+
+  // === 3. 刷新 QoderWork commands（强制覆盖已存在的）===
+  runQoderWorkInstall(cwd, true);
+
+  // === 4. 写版本戳 ===
+  writeEngineVersion(cwd);
+
+  console.log(`\n${"=".repeat(50)}`);
+  console.log(`  升级完成!  (v${PKG_VERSION})`);
+  console.log(`${"=".repeat(50)}`);
+  console.log(`\n  生效方式:`);
+  console.log(`    Qoder IDE / Quest: 新建对话即可`);
+  console.log(`    QoderWork: 重启应用或新建对话`);
+  if (protectedN > 0) {
+    console.log(`\n  ⚠ 有配置文件新版有变化, 生成 .new 文件:`);
+    console.log(`    确认无需合并后可直接删除, 或手动合并后删除`);
+  }
+  console.log("");
+}
+
+function doHelp() {
+  console.log("");
+  console.log(`wlkj - AI 产品研发工作流 (v${PKG_VERSION})`);
+  console.log("");
+  console.log("=== 环境安装 (什么都没装时先跑这个) ===");
+  console.log("  npx @hupan56/wlkj install-env       检测+自动装 Node/Python/git");
+  console.log("  npx @hupan56/wlkj install-env --check  只检测不装");
+  console.log("  npx @hupan56/wlkj install-env --location D:\\wldev  指定安装目录");
+  console.log("  npx @hupan56/wlkj add-path D:\\wldev\\nodejs  把目录加到系统 PATH");
+  console.log("");
+  console.log("=== 一键安装 (装好环境后) ===");
+  console.log("  npx @hupan56/wlkj init [你的名字]    安装完整引擎 + 自动初始化");
+  console.log("");
+  console.log("=== 升级 (已装用户, 新版本发布后) ===");
+  console.log("  npx @hupan56/wlkj update              刷新引擎, 保护你的配置");
+  console.log("");
+  console.log("=== 安装后怎么用 ===");
+  console.log("  在 Qoder (IDE/Quest/QoderWork) 里:");
+  console.log("    说中文: '写个 XX 的需求' '查一下 XX 代码' '建个任务'");
+  console.log("    或斜杠: /wl-prd /wl-search /wl-task /wl-status /wl-report");
+  console.log("");
+  console.log("=== 状态 ===");
+  console.log("  npx @hupan56/wlkj status            查看当前状态 + 引擎版本");
+  console.log("");
+  console.log("=== 环境修复 ===");
+  console.log("  python .qoder/scripts/init_doctor.py --fix   自动修复环境");
+  console.log("  python .qoder/scripts/setup.py               重新初始化");
+  console.log("");
+  console.log("=== Git (中文命令) ===");
+  console.log("  npx @hupan56/wlkj 提交PRD           提交 PRD");
+  console.log("  npx @hupan56/wlkj 提交任务           提交任务");
+  console.log("  npx @hupan56/wlkj 提交               全部提交并推送");
+  console.log("  npx @hupan56/wlkj 拉取最新 / 同步    git pull");
+  console.log("");
+}
+
+function doInstallEnv(checkOnly = false, location = null) {
+  const { execSync } = require("child_process");
+  const isWin = process.platform === "win32";
+  const isMac = process.platform === "darwin";
+
+  // 解析 --location（CLI 入口已提取，这里兜底）
+  console.log("\n=== 环境检测 ===\n");
+  if (location) {
+    console.log(`  安装位置: ${location}${isWin ? "" : " (仅 Windows winget 支持指定目录)"}`);
+    // Windows: 预建目录
+    if (isWin) {
+      try { fs.mkdirSync(location, { recursive: true }); } catch { /* */ }
+    }
+  }
+
+  // 检测函数
+  function check(cmd) {
+    try { return execSync(`${cmd} --version`, { encoding: "utf-8", timeout: 5000, stdio: "pipe" }).trim().split("\n")[0]; }
+    catch { return null; }
+  }
+  function has(cmd) {
+    try { execSync(`where ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; }
+    catch { try { execSync(`which ${cmd}`, { encoding: "utf-8", timeout: 3000, stdio: "pipe" }); return true; } catch { return false; } }
+  }
+  // Windows: 把目录加到用户 PATH（幂等，已存在不重复加）
+  function addToPathWin(dir) {
+    if (!isWin) return false;
+    try {
+      // 用 setx 会截断超长 PATH，改用 PowerShell 读 User PATH 追加
+      const ps = `powershell -NoProfile -Command "$p=[Environment]::GetEnvironmentVariable('Path','User'); if($p -notlike '*{dir}*'){[Environment]::SetEnvironmentVariable('Path',$p.TrimEnd(';')+';{dir}','User')}"`.replace(/{dir}/g, dir.replace(/\\/g, "\\\\"));
+      execSync(ps, { stdio: "pipe", timeout: 15000 });
+      return true;
+    } catch (e) { console.log(`  [WARN] 加 PATH 失败（可手动加）: ${dir}`); return false; }
+  }
+  function install(name, wingetId, brewPkg) {
+    if (checkOnly) return false;
+    try {
+      if (isWin && has("winget")) {
+        console.log(`  用 winget 装 ${name}...`);
+        // winget --location 不一定被安装包尊重，但先传上
+        let cmd = `winget install --id ${wingetId} -e --source winget --accept-source-agreements --accept-package-agreements`;
+        if (location) cmd += ` --location "${location}"`;
+        execSync(cmd, { stdio: "inherit", timeout: 300000 });
+        return true;
+      } else if (isMac && has("brew")) {
+        console.log(`  用 brew 装 ${name}...`);
+        execSync(`brew install ${brewPkg}`, { stdio: "inherit", timeout: 300000 });
+        return true;
+      } else if (!isWin && !isMac) {
+        // Linux: 尝试 apt/dnf/yum
+        for (const [mgr, pkg] of [["apt", brewPkg], ["dnf", brewPkg]]) {
+          if (has(mgr)) {
+            console.log(`  用 ${mgr} 装 ${name}...`);
+            execSync(`sudo ${mgr} install -y ${pkg}`, { stdio: "inherit", timeout: 300000 });
+            return true;
+          }
+        }
+      }
+    } catch (e) { console.log(`  自动安装失败: ${(e.message || "").slice(0, 80)}`); }
+    return false;
+  }
+
+  const nodeVer = check("node");
+  const pyVer = check("python") || check("python3");
+  const gitVer = check("git");
+
+  console.log(`  Node.js: ${nodeVer ? "[OK] " + nodeVer : "[缺失] (npx 命令需要)"}`);
+  console.log(`  Python:  ${pyVer ? "[OK] " + pyVer : "[缺失] (引擎需要)"}`);
+  console.log(`  git:     ${gitVer ? "[OK] " + gitVer : "[缺失] (可选, 核心功能不依赖)"}`);
+
+  if (checkOnly) {
+    console.log("\n仅检测。去掉 --check 自动安装。");
+    return;
+  }
+
+  const need = [];
+  if (!nodeVer) {
+    console.log("");
+    if (nodeVer || install("Node.js", "OpenJS.NodeJS.LTS", "node")) { console.log(`  [OK] Node.js 已装`); }
+    else { need.push("Node.js (手动: https://nodejs.org)"); }
+  }
+  if (!pyVer) {
+    console.log("");
+    if (install("Python", "Python.Python.3.12", "python@3.12")) { console.log(`  [OK] Python 已装`); }
+    else { need.push("Python (手动: https://python.org, 勾 Add to PATH)"); }
+  }
+  if (!gitVer) {
+    console.log("");
+    if (install("git", "Git.Git", "git")) { console.log(`  [OK] git 已装`); }
+    else { need.push("git (手动: https://git-scm.com, 可选)"); }
+  }
+
+  // --location 模式: 提示用户验证安装位置 + 手动加 PATH
+  // （winget 的 --location 对 Node/Python 不一定生效，需用户确认）
+  if (location && isWin) {
+    console.log(`\n--- 安装位置确认 ---`);
+    console.log(`  你指定了: ${location}`);
+    console.log(`  注意: winget 的 --location 对 Node.js/Python 不一定生效`);
+    console.log(`        (取决于安装包是否支持自定义路径)`);
+    console.log(`  请检查实际装到哪了:`);
+    console.log(`    重新打开终端后跑: node --version  python --version  git --version`);
+    console.log(`  如果某软件没进 PATH, 手动把它加进去:`);
+    console.log(`    设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → Path → 新建`);
+    console.log(`    或用命令: npx @hupan56/wlkj add-path "D:\\wldev\\nodejs"`);
+  }
+
+  console.log("\n=== 结果 ===");
+  if (need.length === 0) {
+    console.log("  环境就绪! 下一步: npx @hupan56/wlkj init");
+    console.log("  (新装的可能需要重新打开终端)");
+  } else {
+    console.log("  以下需手动安装:");
+    need.forEach(n => console.log("    - " + n));
+  }
+}
+
+// add-path: 把目录加到 Windows 用户 PATH（幂等）
+function doAddPath(dir) {
+  if (!dir) { console.log("用法: npx @hupan56/wlkj add-path <目录>"); return; }
+  if (process.platform !== "win32") {
+    console.log("add-path 仅支持 Windows。Mac/Linux 请手动加到 ~/.zshrc 或 ~/.bashrc");
+    return;
+  }
+  const abs = path.resolve(dir);
+  if (!fs.existsSync(abs)) {
+    console.log(`[警告] 目录不存在: ${abs}（仍会加到 PATH）`);
+  }
+  try {
+    const ps = `powershell -NoProfile -Command "$p=[Environment]::GetEnvironmentVariable('Path','User'); if($p -notlike '*${abs.replace(/\\/g,"\\\\")}*'){[Environment]::SetEnvironmentVariable('Path',$p.TrimEnd(';')+';${abs.replace(/\\/g,"\\\\")}','User'); Write-Output 'ADDED'} else { Write-Output 'EXISTS' }"`;
+    const out = execSync(ps, { encoding: "utf-8", timeout: 15000 }).trim();
+    console.log(`  ${out === "ADDED" ? "已加入" : "已存在(无需重复加)"}: ${abs}`);
+    console.log(`  ⚠ 需要重新打开终端才生效`);
+  } catch (e) {
+    console.log(`  失败: ${(e.message || "").slice(0, 100)}`);
+    console.log(`  手动加: 设置 → 系统 → 关于 → 高级系统设置 → 环境变量 → Path → 新建 → ${abs}`);
+  }
+}
+
+const [,, cmd, ...rest] = process.argv;
+const mapped = rest.map(a => a === "-p" ? "--priority" : a);
+
+switch (cmd) {
+  case "init": doInit(rest[0]); break;
+  case "update": case "upgrade": doUpdate(); break;
+  case "install-env": {
+    const checkOnly = rest.includes("--check");
+    // 提取 --location <dir> 或 --location=<dir>
+    let loc = null;
+    const li = rest.indexOf("--location");
+    if (li !== -1 && rest[li + 1]) loc = rest[li + 1];
+    const eq = rest.find(a => a.startsWith("--location="));
+    if (eq) loc = eq.slice("--location=".length);
+    doInstallEnv(checkOnly, loc);
+    break;
+  }
+  case "add-path": doAddPath(rest[0]); break;
+  case "task": process.stdout.write(py("task.py", mapped)); break;
+  case "status": doStatus(); break;
+  case "session": process.stdout.write(py("add_session.py", rest)); break;
+  case "help": case "--help": case "-h": doHelp(); break;
+  case "提交": case "推送": case "拉取最新": case "同步":
+  case "查看状态": case "提交PRD": case "提交Spec": case "提交任务":
+    gitOp(cmd); break;
+  default: doHelp();
 }