@hupan56/wlkj 2.2.3 → 2.2.5

package/templates/qoder/scripts/install_qoderwork.py

@@ -1,367 +1,367 @@
-# -*- coding: utf-8 -*-
-"""
-install_qoderwork.py - 把 .qoder/skills/ 安装到 QoderWork 桌面端可识别的位置
-
-QoderWork 从 %USERPROFILE%\\.qoderwork\\skills\\ 加载技能（每个子目录一个 skill），
-从 %USERPROFILE%\\.qoderwork\\commands\\ 加载斜杠命令。
-本项目源在 <repo>/.qoder/skills/ 和 <repo>/.qoder/commands/，QoderWork 不会读项目
-目录，必须软链/拷过去。
-（注: 旧版本误用 ~/.qoderworkcn/，已废弃，官方路径为 ~/.qoderwork/）
-
-为什么用 junction（mklink /J）而不是 symlink（mklink /D）：
-  - junction 不需要管理员权限，普通用户可建
-  - 本地评估默认启用，跨进程透明
-  - symlink 在未开开发者模式的 Windows 上需要 SeCreateSymbolicLink 特权
-
-用法:
-    python .qoder/scripts/install_qoderwork.py            # 安装/同步（幂等）
-    python .qoder/scripts/install_qoderwork.py --uninstall # 删除所有 junction（不删源）
-    python .qoder/scripts/install_qoderwork.py --check     # 仅检查，不改动
-    python .qoder/scripts/install_qoderwork.py --copy      # 改用拷贝（非 Windows 或不想软链）
-
-幂等：已存在的 junction 会跳过；已存在的非 junction 目录会报错让人工处理。
-"""
-
-import argparse
-import os
-import shutil
-import subprocess
-import sys
-from pathlib import Path
-
-# 确保 UTF-8 输出（Windows 控制台默认 GBK）
-if sys.platform == "win32":
-    try:
-        sys.stdout.reconfigure(encoding="utf-8")
-        sys.stderr.reconfigure(encoding="utf-8")
-    except (AttributeError, IOError):
-        pass
-
-# 路径自检：项目根 = 本文件上三级（scripts/ -> .qoder/ -> repo）
-SCRIPT_DIR = Path(__file__).resolve().parent
-PROJECT_ROOT = SCRIPT_DIR.parent.parent
-SOURCE_SKILLS_DIR = PROJECT_ROOT / ".qoder" / "skills"
-SOURCE_COMMANDS_DIR = PROJECT_ROOT / ".qoder" / "commands"
-
-# QoderWork 目标目录 (官方: ~/.qoderwork/skills/ 和 ~/.qoderwork/commands/)
-# 注意: 之前误用了 ~/.qoderworkcn/ (国内版旧路径), 官方文档明确是 ~/.qoderwork/
-# https://docs.qoder.com/zh/qoderwork/skills
-if sys.platform == "win32":
-    _HOME = Path(os.environ.get("USERPROFILE", str(Path.home())))
-else:
-    _HOME = Path.home()
-QODERWORK_SKILLS_DIR = _HOME / ".qoderwork" / "skills"
-QODERWORK_COMMANDS_DIR = _HOME / ".qoderwork" / "commands"
-
-# 旧的错误路径 (迁移清理用)
-LEGACY_WRONG_DIR = _HOME / ".qoderworkcn" / "skills"
-
-
-def is_junction(path: Path) -> bool:
-    """判断目录是否是 junction/symlink（reparse point）。"""
-    if not path.exists():
-        return False
-    # Windows: 用 dir 命令检测 <JUNCTION> 标记最可靠（无需 ctypes）
-    if sys.platform == "win32":
-        try:
-            # os.lstat: reparse point 的 FILE_ATTRIBUTE_REPARSE_POINT (0x400) 会体现在 st_file_attributes
-            import stat as _stat
-            st = path.lstat()
-            # FILE_ATTRIBUTE_REPARSE_POINT = 0x400
-            return bool(getattr(st, "st_file_attributes", 0) & 0x400)
-        except (OSError, AttributeError):
-            return False
-    else:
-        return path.is_symlink()
-
-
-def find_source_skills() -> list:
-    """扫描 .qoder/skills/*/SKILL.md，返回 [(name, src_dir), ...]。"""
-    if not SOURCE_SKILLS_DIR.is_dir():
-        return []
-    result = []
-    for child in sorted(SOURCE_SKILLS_DIR.iterdir()):
-        if not child.is_dir():
-            continue
-        if (child / "SKILL.md").is_file():
-            result.append((child.name, child))
-    return result
-
-
-def file_equal(a: Path, b: Path) -> bool:
-    """快速判断两文件内容是否相同（先比大小再比内容，避免无谓全读）。"""
-    try:
-        if a.stat().st_size != b.stat().st_size:
-            return False
-        return a.read_bytes() == b.read_bytes()
-    except OSError:
-        return False
-
-
-def create_junction(link: Path, target: Path) -> bool:
-    """用 mklink /J 创建 junction。返回是否成功。"""
-    # 用 errors="replace" 防止 Windows GBK 输出（如"为...创建的联接"）触发 UnicodeDecodeError
-    cmd = ["cmd", "/c", "mklink", "/J", str(link), str(target)]
-    try:
-        r = subprocess.run(
-            cmd,
-            stdout=subprocess.PIPE,
-            stderr=subprocess.PIPE,
-            # 不用 text=True，自己 decode 防编码异常
-        )
-        return r.returncode == 0
-    except (OSError, subprocess.SubprocessError):
-        return False
-
-
-def install_one(name: str, src: Path, mode: str, dry: bool = False) -> str:
-    """
-    安装一个 skill 到 QoderWork 目录。
-    返回状态字符串：'created' / 'ok-existing' / 'copied' / 'error: ...' / 'skip: ...'
-    """
-    link = QODERWORK_SKILLS_DIR / name
-    if link.exists() or link.is_symlink():
-        if is_junction(link):
-            # 悬空 junction 检测: junction 存在但目标已移走/删除
-            # (常见于团队重命名 skill 后, 旧 junction 变成死链)
-            # link.exists() 对悬空 junction 返回 False, 但 link.is_symlink() 可能 True
-            # 用 os.path.exists 解析目标判断
-            try:
-                target_alive = os.path.exists(str(link))
-            except OSError:
-                target_alive = False
-            if target_alive:
-                return "ok-existing"
-            else:
-                # 悬空 junction, 删除后重建
-                if dry:
-                    return "would-recreate (dangling)"
-                try:
-                    if sys.platform == "win32":
-                        subprocess.run(["cmd", "/c", "rmdir", str(link)],
-                                       stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
-                    else:
-                        os.unlink(str(link))
-                except (OSError, subprocess.SubprocessError) as e:
-                    return "error: 悬空 junction 无法删除 (手动 rmdir {}): {}".format(link, e)
-                # 落到下面 recreate 逻辑
-        else:
-            # 非 junction 的真实目录/文件 -> 不覆盖
-            return f"skip: {name} 已存在且不是软链（避免覆盖，请人工确认 {link}）"
-
-    if dry:
-        return "would-create"
-
-    QODERWORK_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
-
-    if mode == "copy":
-        try:
-            shutil.copytree(src, link)
-            return "copied"
-        except (OSError, shutil.Error) as e:
-            return f"error: copy 失败 {e}"
-    else:
-        # junction 模式（默认）
-        if sys.platform != "win32":
-            # 非 Windows 退化为 symlink，失败再退化为 copy
-            try:
-                os.symlink(src, link, target_is_directory=True)
-                return "created(symlink)"
-            except (OSError, NotImplementedError):
-                try:
-                    shutil.copytree(src, link)
-                    return "copied(fallback)"
-                except (OSError, shutil.Error) as e:
-                    return f"error: {e}"
-        if create_junction(link, src):
-            return "created"
-        return "error: mklink /J 失败（可能需要检查路径或权限）"
-
-
-def uninstall_one(name: str) -> str:
-    """删除一个 junction（只删 link，不删源）。"""
-    link = QODERWORK_SKILLS_DIR / name
-    if not link.exists() and not link.is_symlink():
-        return "absent"
-    if not is_junction(link):
-        return f"skip: {name} 不是软链（不动真实目录，请人工删除 {link}）"
-    try:
-        # 删 junction 用 rmdir（不递归到源）
-        if sys.platform == "win32":
-            subprocess.run(["cmd", "/c", "rmdir", str(link)],
-                           stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
-        else:
-            os.unlink(str(link))
-        return "removed"
-    except (OSError, subprocess.SubprocessError) as e:
-        return f"error: {e}"
-
-
-def main():
-    parser = argparse.ArgumentParser(
-        description="把 .qoder/skills/ 安装到 QoderWork 桌面端目录"
-    )
-    parser.add_argument("--uninstall", action="store_true",
-                        help="删除所有 junction（不删源）")
-    parser.add_argument("--check", action="store_true",
-                        help="仅检查状态，不改动")
-    parser.add_argument("--copy", action="store_true",
-                        help="用拷贝代替 junction（非 Windows 或不想软链时用）")
-    parser.add_argument("--force-commands", action="store_true",
-                        help="强制覆盖已存在的 command 文件（升级时用；默认已存在则跳过）")
-    args = parser.parse_args()
-
-    print("=" * 56)
-    print("QoderWork 技能安装器")
-    print(f"  源:   {SOURCE_SKILLS_DIR}")
-    print(f"  目标: {QODERWORK_SKILLS_DIR}")
-    print("=" * 56)
-
-    # 迁移清理: 旧版本错装到了 ~/.qoderworkcn/, 清理掉避免混淆
-    if not args.check and LEGACY_WRONG_DIR.exists():
-        legacy_junctions = []
-        try:
-            for child in LEGACY_WRONG_DIR.iterdir():
-                if is_junction(child):
-                    legacy_junctions.append(child.name)
-        except OSError:
-            pass
-        if legacy_junctions:
-            print(f"\n[迁移] 发现旧版本错装在 {LEGACY_WRONG_DIR} ({len(legacy_junctions)} 个)")
-            print(f"       QoderWork 实际读的是 ~/.qoderwork/, 正在清理旧 junction...")
-            for name in legacy_junctions:
-                try:
-                    subprocess.run(["cmd", "/c", "rmdir", str(LEGACY_WRONG_DIR / name)],
-                                   stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
-                except (OSError, subprocess.SubprocessError):
-                    pass
-            print(f"       已清理 {len(legacy_junctions)} 个旧 junction")
-            # 若旧目录空了, 删掉
-            try:
-                remaining = list(LEGACY_WRONG_DIR.iterdir())
-                if not remaining and LEGACY_WRONG_DIR.parent.exists():
-                    LEGACY_WRONG_DIR.rmdir()
-                    print(f"       已删除空目录 {LEGACY_WRONG_DIR.parent}")
-            except OSError:
-                pass
-
-    sources = find_source_skills()
-    if not sources:
-        print(f"[ERR] 源目录无 skill：{SOURCE_SKILLS_DIR}")
-        print("      检查 .qoder/skills/*/SKILL.md 是否存在")
-        return 1
-
-    mode = "copy" if args.copy else "junction"
-    action = "check" if args.check else ("uninstall" if args.uninstall else "install")
-    print(f"\n模式: {action} / link={mode}，发现 {len(sources)} 个源 skill\n")
-
-    results = {}
-    for name, src in sources:
-        if action == "uninstall":
-            results[name] = uninstall_one(name)
-        elif action == "check":
-            link = QODERWORK_SKILLS_DIR / name
-            if link.exists() or link.is_symlink():
-                results[name] = "ok(junction)" if is_junction(link) else "WARN(非软链)"
-            else:
-                results[name] = "missing"
-        else:  # install
-            results[name] = install_one(name, src, mode, dry=False)
-
-    # 打印结果
-    print("-" * 56)
-    counts = {"ok": 0, "create": 0, "copy": 0, "warn": 0, "err": 0, "missing": 0}
-    for name, status in sorted(results.items()):
-        tag = ""
-        if status.startswith("ok") or status == "copied" or status.startswith("created"):
-            if status.startswith("created") or status == "copied":
-                counts["create"] += 1
-                tag = "[NEW]"
-            else:
-                counts["ok"] += 1
-                tag = "[OK]"
-        elif status.startswith("skip"):
-            counts["warn"] += 1
-            tag = "[WARN]"
-        elif status.startswith("error"):
-            counts["err"] += 1
-            tag = "[ERR]"
-        elif status == "missing":
-            counts["missing"] += 1
-            tag = "[MISS]"
-        elif status == "removed":
-            counts["ok"] += 1
-            tag = "[DEL]"
-        elif status.startswith("WARN"):
-            counts["warn"] += 1
-            tag = "[WARN]"
-        else:
-            counts["ok"] += 1
-            tag = "[OK]"
-        print(f"  {tag:6} {name:22} {status}")
-
-    print("-" * 56)
-    print(f"\n小结: 新建 {counts['create']} / 已存在 {counts['ok']} / "
-          f"缺失 {counts['missing']} / 警告 {counts['warn']} / 错误 {counts['err']}")
-
-    # 同时安装 commands (让 QoderWork 用户级也能看到 /wl-* 命令)
-    if action in ("install", "check") and SOURCE_COMMANDS_DIR.is_dir():
-        print("\n--- Commands (/wl-* 斜杠命令) ---")
-        cmd_count = {"ok": 0, "new": 0, "upd": 0}
-        for cmd_file in sorted(SOURCE_COMMANDS_DIR.glob("wl-*.md")):
-            name = cmd_file.name  # e.g. wl-prd.md
-            target = QODERWORK_COMMANDS_DIR / name
-            if action == "check":
-                if target.exists():
-                    cmd_count["ok"] += 1
-                else:
-                    print(f"  [MISS] {name}")
-            else:  # install
-                need_copy = False
-                if not target.exists():
-                    need_copy = True
-                elif args.force_commands:
-                    # 强制刷新（升级场景）：仅当内容不同才覆盖，避免无谓写
-                    import shutil
-                    if not file_equal(cmd_file, target):
-                        need_copy = True
-                if need_copy:
-                    try:
-                        QODERWORK_COMMANDS_DIR.mkdir(parents=True, exist_ok=True)
-                        import shutil
-                        shutil.copy2(str(cmd_file), str(target))
-                        if target.exists() and args.force_commands:
-                            cmd_count["upd"] += 1
-                        else:
-                            cmd_count["new"] += 1
-                    except OSError as e:
-                        print(f"  [ERR] {name}: {e}")
-                else:
-                    cmd_count["ok"] += 1
-        msg = f"  commands: {cmd_count['new']} 新建 / {cmd_count['ok']} 已存在"
-        if cmd_count["upd"]:
-            msg += f" / {cmd_count['upd']} 刷新"
-        print(msg)
-
-    if action == "install" and counts["err"] == 0:
-        print("\n✓ 安装完成。重启 QoderWork（或新建对话）后技能生效。")
-        print("  在 QoderWork 里直接用自然语言即可，例如：")
-        print('    "写个保险异常筛选的 PRD"  -> prd-generator + prototype-generator')
-        print('    "查一下考勤代码在哪"      -> wl-search')
-    elif action == "install" and counts["err"] > 0:
-        print(f"\n⚠ 有 {counts['err']} 个安装失败，见上方 [ERR] 行。")
-        print("  常见原因: 目标路径被占用为非软链。手动删除该目录后重跑本脚本。")
-        return 1
-    elif action == "uninstall":
-        print("\n✓ 卸载完成（源文件未动）。")
-    elif action == "check":
-        if counts["missing"] > 0 or counts["warn"] > 0:
-            print("\n⚠ 检测到缺失/异常，建议跑: python .qoder/scripts/install_qoderwork.py")
-            return 1
-        else:
-            print("\n✓ 全部 skill 已正确安装到 QoderWork 目录。")
-    return 0
-
-
-if __name__ == "__main__":
-    sys.exit(main())
+# -*- coding: utf-8 -*-
+"""
+install_qoderwork.py - 把 .qoder/skills/ 安装到 QoderWork 桌面端可识别的位置
+
+QoderWork 从 %USERPROFILE%\\.qoderwork\\skills\\ 加载技能（每个子目录一个 skill），
+从 %USERPROFILE%\\.qoderwork\\commands\\ 加载斜杠命令。
+本项目源在 <repo>/.qoder/skills/ 和 <repo>/.qoder/commands/，QoderWork 不会读项目
+目录，必须软链/拷过去。
+（注: 旧版本误用 ~/.qoderworkcn/，已废弃，官方路径为 ~/.qoderwork/）
+
+为什么用 junction（mklink /J）而不是 symlink（mklink /D）：
+  - junction 不需要管理员权限，普通用户可建
+  - 本地评估默认启用，跨进程透明
+  - symlink 在未开开发者模式的 Windows 上需要 SeCreateSymbolicLink 特权
+
+用法:
+    python .qoder/scripts/install_qoderwork.py            # 安装/同步（幂等）
+    python .qoder/scripts/install_qoderwork.py --uninstall # 删除所有 junction（不删源）
+    python .qoder/scripts/install_qoderwork.py --check     # 仅检查，不改动
+    python .qoder/scripts/install_qoderwork.py --copy      # 改用拷贝（非 Windows 或不想软链）
+
+幂等：已存在的 junction 会跳过；已存在的非 junction 目录会报错让人工处理。
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+# 确保 UTF-8 输出（Windows 控制台默认 GBK）
+if sys.platform == "win32":
+    try:
+        sys.stdout.reconfigure(encoding="utf-8")
+        sys.stderr.reconfigure(encoding="utf-8")
+    except (AttributeError, IOError):
+        pass
+
+# 路径自检：项目根 = 本文件上三级（scripts/ -> .qoder/ -> repo）
+SCRIPT_DIR = Path(__file__).resolve().parent
+PROJECT_ROOT = SCRIPT_DIR.parent.parent
+SOURCE_SKILLS_DIR = PROJECT_ROOT / ".qoder" / "skills"
+SOURCE_COMMANDS_DIR = PROJECT_ROOT / ".qoder" / "commands"
+
+# QoderWork 目标目录 (官方: ~/.qoderwork/skills/ 和 ~/.qoderwork/commands/)
+# 注意: 之前误用了 ~/.qoderworkcn/ (国内版旧路径), 官方文档明确是 ~/.qoderwork/
+# https://docs.qoder.com/zh/qoderwork/skills
+if sys.platform == "win32":
+    _HOME = Path(os.environ.get("USERPROFILE", str(Path.home())))
+else:
+    _HOME = Path.home()
+QODERWORK_SKILLS_DIR = _HOME / ".qoderwork" / "skills"
+QODERWORK_COMMANDS_DIR = _HOME / ".qoderwork" / "commands"
+
+# 旧的错误路径 (迁移清理用)
+LEGACY_WRONG_DIR = _HOME / ".qoderworkcn" / "skills"
+
+
+def is_junction(path: Path) -> bool:
+    """判断目录是否是 junction/symlink（reparse point）。"""
+    if not path.exists():
+        return False
+    # Windows: 用 dir 命令检测 <JUNCTION> 标记最可靠（无需 ctypes）
+    if sys.platform == "win32":
+        try:
+            # os.lstat: reparse point 的 FILE_ATTRIBUTE_REPARSE_POINT (0x400) 会体现在 st_file_attributes
+            import stat as _stat
+            st = path.lstat()
+            # FILE_ATTRIBUTE_REPARSE_POINT = 0x400
+            return bool(getattr(st, "st_file_attributes", 0) & 0x400)
+        except (OSError, AttributeError):
+            return False
+    else:
+        return path.is_symlink()
+
+
+def find_source_skills() -> list:
+    """扫描 .qoder/skills/*/SKILL.md，返回 [(name, src_dir), ...]。"""
+    if not SOURCE_SKILLS_DIR.is_dir():
+        return []
+    result = []
+    for child in sorted(SOURCE_SKILLS_DIR.iterdir()):
+        if not child.is_dir():
+            continue
+        if (child / "SKILL.md").is_file():
+            result.append((child.name, child))
+    return result
+
+
+def file_equal(a: Path, b: Path) -> bool:
+    """快速判断两文件内容是否相同（先比大小再比内容，避免无谓全读）。"""
+    try:
+        if a.stat().st_size != b.stat().st_size:
+            return False
+        return a.read_bytes() == b.read_bytes()
+    except OSError:
+        return False
+
+
+def create_junction(link: Path, target: Path) -> bool:
+    """用 mklink /J 创建 junction。返回是否成功。"""
+    # 用 errors="replace" 防止 Windows GBK 输出（如"为...创建的联接"）触发 UnicodeDecodeError
+    cmd = ["cmd", "/c", "mklink", "/J", str(link), str(target)]
+    try:
+        r = subprocess.run(
+            cmd,
+            stdout=subprocess.PIPE,
+            stderr=subprocess.PIPE,
+            # 不用 text=True，自己 decode 防编码异常
+        )
+        return r.returncode == 0
+    except (OSError, subprocess.SubprocessError):
+        return False
+
+
+def install_one(name: str, src: Path, mode: str, dry: bool = False) -> str:
+    """
+    安装一个 skill 到 QoderWork 目录。
+    返回状态字符串：'created' / 'ok-existing' / 'copied' / 'error: ...' / 'skip: ...'
+    """
+    link = QODERWORK_SKILLS_DIR / name
+    if link.exists() or link.is_symlink():
+        if is_junction(link):
+            # 悬空 junction 检测: junction 存在但目标已移走/删除
+            # (常见于团队重命名 skill 后, 旧 junction 变成死链)
+            # link.exists() 对悬空 junction 返回 False, 但 link.is_symlink() 可能 True
+            # 用 os.path.exists 解析目标判断
+            try:
+                target_alive = os.path.exists(str(link))
+            except OSError:
+                target_alive = False
+            if target_alive:
+                return "ok-existing"
+            else:
+                # 悬空 junction, 删除后重建
+                if dry:
+                    return "would-recreate (dangling)"
+                try:
+                    if sys.platform == "win32":
+                        subprocess.run(["cmd", "/c", "rmdir", str(link)],
+                                       stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
+                    else:
+                        os.unlink(str(link))
+                except (OSError, subprocess.SubprocessError) as e:
+                    return "error: 悬空 junction 无法删除 (手动 rmdir {}): {}".format(link, e)
+                # 落到下面 recreate 逻辑
+        else:
+            # 非 junction 的真实目录/文件 -> 不覆盖
+            return f"skip: {name} 已存在且不是软链（避免覆盖，请人工确认 {link}）"
+
+    if dry:
+        return "would-create"
+
+    QODERWORK_SKILLS_DIR.mkdir(parents=True, exist_ok=True)
+
+    if mode == "copy":
+        try:
+            shutil.copytree(src, link)
+            return "copied"
+        except (OSError, shutil.Error) as e:
+            return f"error: copy 失败 {e}"
+    else:
+        # junction 模式（默认）
+        if sys.platform != "win32":
+            # 非 Windows 退化为 symlink，失败再退化为 copy
+            try:
+                os.symlink(src, link, target_is_directory=True)
+                return "created(symlink)"
+            except (OSError, NotImplementedError):
+                try:
+                    shutil.copytree(src, link)
+                    return "copied(fallback)"
+                except (OSError, shutil.Error) as e:
+                    return f"error: {e}"
+        if create_junction(link, src):
+            return "created"
+        return "error: mklink /J 失败（可能需要检查路径或权限）"
+
+
+def uninstall_one(name: str) -> str:
+    """删除一个 junction（只删 link，不删源）。"""
+    link = QODERWORK_SKILLS_DIR / name
+    if not link.exists() and not link.is_symlink():
+        return "absent"
+    if not is_junction(link):
+        return f"skip: {name} 不是软链（不动真实目录，请人工删除 {link}）"
+    try:
+        # 删 junction 用 rmdir（不递归到源）
+        if sys.platform == "win32":
+            subprocess.run(["cmd", "/c", "rmdir", str(link)],
+                           stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
+        else:
+            os.unlink(str(link))
+        return "removed"
+    except (OSError, subprocess.SubprocessError) as e:
+        return f"error: {e}"
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="把 .qoder/skills/ 安装到 QoderWork 桌面端目录"
+    )
+    parser.add_argument("--uninstall", action="store_true",
+                        help="删除所有 junction（不删源）")
+    parser.add_argument("--check", action="store_true",
+                        help="仅检查状态，不改动")
+    parser.add_argument("--copy", action="store_true",
+                        help="用拷贝代替 junction（非 Windows 或不想软链时用）")
+    parser.add_argument("--force-commands", action="store_true",
+                        help="强制覆盖已存在的 command 文件（升级时用；默认已存在则跳过）")
+    args = parser.parse_args()
+
+    print("=" * 56)
+    print("QoderWork 技能安装器")
+    print(f"  源:   {SOURCE_SKILLS_DIR}")
+    print(f"  目标: {QODERWORK_SKILLS_DIR}")
+    print("=" * 56)
+
+    # 迁移清理: 旧版本错装到了 ~/.qoderworkcn/, 清理掉避免混淆
+    if not args.check and LEGACY_WRONG_DIR.exists():
+        legacy_junctions = []
+        try:
+            for child in LEGACY_WRONG_DIR.iterdir():
+                if is_junction(child):
+                    legacy_junctions.append(child.name)
+        except OSError:
+            pass
+        if legacy_junctions:
+            print(f"\n[迁移] 发现旧版本错装在 {LEGACY_WRONG_DIR} ({len(legacy_junctions)} 个)")
+            print(f"       QoderWork 实际读的是 ~/.qoderwork/, 正在清理旧 junction...")
+            for name in legacy_junctions:
+                try:
+                    subprocess.run(["cmd", "/c", "rmdir", str(LEGACY_WRONG_DIR / name)],
+                                   stdout=subprocess.PIPE, stderr=subprocess.PIPE, check=True)
+                except (OSError, subprocess.SubprocessError):
+                    pass
+            print(f"       已清理 {len(legacy_junctions)} 个旧 junction")
+            # 若旧目录空了, 删掉
+            try:
+                remaining = list(LEGACY_WRONG_DIR.iterdir())
+                if not remaining and LEGACY_WRONG_DIR.parent.exists():
+                    LEGACY_WRONG_DIR.rmdir()
+                    print(f"       已删除空目录 {LEGACY_WRONG_DIR.parent}")
+            except OSError:
+                pass
+
+    sources = find_source_skills()
+    if not sources:
+        print(f"[ERR] 源目录无 skill：{SOURCE_SKILLS_DIR}")
+        print("      检查 .qoder/skills/*/SKILL.md 是否存在")
+        return 1
+
+    mode = "copy" if args.copy else "junction"
+    action = "check" if args.check else ("uninstall" if args.uninstall else "install")
+    print(f"\n模式: {action} / link={mode}，发现 {len(sources)} 个源 skill\n")
+
+    results = {}
+    for name, src in sources:
+        if action == "uninstall":
+            results[name] = uninstall_one(name)
+        elif action == "check":
+            link = QODERWORK_SKILLS_DIR / name
+            if link.exists() or link.is_symlink():
+                results[name] = "ok(junction)" if is_junction(link) else "WARN(非软链)"
+            else:
+                results[name] = "missing"
+        else:  # install
+            results[name] = install_one(name, src, mode, dry=False)
+
+    # 打印结果
+    print("-" * 56)
+    counts = {"ok": 0, "create": 0, "copy": 0, "warn": 0, "err": 0, "missing": 0}
+    for name, status in sorted(results.items()):
+        tag = ""
+        if status.startswith("ok") or status == "copied" or status.startswith("created"):
+            if status.startswith("created") or status == "copied":
+                counts["create"] += 1
+                tag = "[NEW]"
+            else:
+                counts["ok"] += 1
+                tag = "[OK]"
+        elif status.startswith("skip"):
+            counts["warn"] += 1
+            tag = "[WARN]"
+        elif status.startswith("error"):
+            counts["err"] += 1
+            tag = "[ERR]"
+        elif status == "missing":
+            counts["missing"] += 1
+            tag = "[MISS]"
+        elif status == "removed":
+            counts["ok"] += 1
+            tag = "[DEL]"
+        elif status.startswith("WARN"):
+            counts["warn"] += 1
+            tag = "[WARN]"
+        else:
+            counts["ok"] += 1
+            tag = "[OK]"
+        print(f"  {tag:6} {name:22} {status}")
+
+    print("-" * 56)
+    print(f"\n小结: 新建 {counts['create']} / 已存在 {counts['ok']} / "
+          f"缺失 {counts['missing']} / 警告 {counts['warn']} / 错误 {counts['err']}")
+
+    # 同时安装 commands (让 QoderWork 用户级也能看到 /wl-* 命令)
+    if action in ("install", "check") and SOURCE_COMMANDS_DIR.is_dir():
+        print("\n--- Commands (/wl-* 斜杠命令) ---")
+        cmd_count = {"ok": 0, "new": 0, "upd": 0}
+        for cmd_file in sorted(SOURCE_COMMANDS_DIR.glob("wl-*.md")):
+            name = cmd_file.name  # e.g. wl-prd.md
+            target = QODERWORK_COMMANDS_DIR / name
+            if action == "check":
+                if target.exists():
+                    cmd_count["ok"] += 1
+                else:
+                    print(f"  [MISS] {name}")
+            else:  # install
+                need_copy = False
+                if not target.exists():
+                    need_copy = True
+                elif args.force_commands:
+                    # 强制刷新（升级场景）：仅当内容不同才覆盖，避免无谓写
+                    import shutil
+                    if not file_equal(cmd_file, target):
+                        need_copy = True
+                if need_copy:
+                    try:
+                        QODERWORK_COMMANDS_DIR.mkdir(parents=True, exist_ok=True)
+                        import shutil
+                        shutil.copy2(str(cmd_file), str(target))
+                        if target.exists() and args.force_commands:
+                            cmd_count["upd"] += 1
+                        else:
+                            cmd_count["new"] += 1
+                    except OSError as e:
+                        print(f"  [ERR] {name}: {e}")
+                else:
+                    cmd_count["ok"] += 1
+        msg = f"  commands: {cmd_count['new']} 新建 / {cmd_count['ok']} 已存在"
+        if cmd_count["upd"]:
+            msg += f" / {cmd_count['upd']} 刷新"
+        print(msg)
+
+    if action == "install" and counts["err"] == 0:
+        print("\n✓ 安装完成。重启 QoderWork（或新建对话）后技能生效。")
+        print("  在 QoderWork 里直接用自然语言即可，例如：")
+        print('    "写个保险异常筛选的 PRD"  -> prd-generator + prototype-generator')
+        print('    "查一下考勤代码在哪"      -> wl-search')
+    elif action == "install" and counts["err"] > 0:
+        print(f"\n⚠ 有 {counts['err']} 个安装失败，见上方 [ERR] 行。")
+        print("  常见原因: 目标路径被占用为非软链。手动删除该目录后重跑本脚本。")
+        return 1
+    elif action == "uninstall":
+        print("\n✓ 卸载完成（源文件未动）。")
+    elif action == "check":
+        if counts["missing"] > 0 or counts["warn"] > 0:
+            print("\n⚠ 检测到缺失/异常，建议跑: python .qoder/scripts/install_qoderwork.py")
+            return 1
+        else:
+            print("\n✓ 全部 skill 已正确安装到 QoderWork 目录。")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())