@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/install_qoderwork.py

@@ -0,0 +1,339 @@
+# -*- coding: utf-8 -*-
+"""
+install_qoderwork.py - 把 .qoder/skills/ 安装到 QoderWork 桌面端可识别的位置
+
+QoderWork 从 %USERPROFILE%\\.qoderworkcn\\skills\\ 加载技能（每个子目录一个 skill）。
+本项目源在 <repo>/.qoder/skills/，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 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 或不想软链时用）")
+    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}
+        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
+                if target.exists():
+                    cmd_count["ok"] += 1
+                else:
+                    try:
+                        QODERWORK_COMMANDS_DIR.mkdir(parents=True, exist_ok=True)
+                        # commands 是单文件, 用拷贝 (不像 skills 是目录用 junction)
+                        import shutil
+                        shutil.copy2(str(cmd_file), str(target))
+                        cmd_count["new"] += 1
+                    except OSError as e:
+                        print(f"  [ERR] {name}: {e}")
+        print(f"  commands: {cmd_count['new']} 新建 / {cmd_count['ok']} 已存在")
+
+    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())

package/templates/qoder/scripts/learn.py

@@ -0,0 +1,67 @@
+# learn.py - Learning engine for QODER evolution
+import os, json
+from datetime import datetime
+
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+LEARNING_DIR = os.path.join(BASE, '.qoder', 'learning')
+FEEDBACK_FILE = os.path.join(LEARNING_DIR, 'feedback.jsonl')
+PREFS_FILE = os.path.join(LEARNING_DIR, 'preferences.yaml')
+
+def record_feedback(event, data):
+    entry = {
+        'ts': datetime.now().isoformat(),
+        'event': event,
+        'data': data
+    }
+    with open(FEEDBACK_FILE, 'a', encoding='utf-8') as f:
+        f.write(json.dumps(entry, ensure_ascii=False) + chr(10))
+    _update_stats(event)
+    print('Recorded: ' + event)
+
+def _update_stats(event):
+    import yaml
+    prefs = _load_prefs()
+    stats = {
+        'prd_accepted': 'prds_generated',
+        'prd_rejected': 'rejections',
+        'review_done': 'reviews_done',
+        'task_completed': 'tasks_completed',
+        'handoff_done': 'handoffs_completed',
+    }
+    key = stats.get(event)
+    if key:
+        prefs[key] = prefs.get(key, 0) + 1
+        _save_prefs(prefs)
+
+def _load_prefs():
+    import yaml
+    if not os.path.isfile(PREFS_FILE): return {}
+    try: return yaml.safe_load(open(PREFS_FILE, encoding='utf-8')) or {}
+    except: return {}
+
+def _save_prefs(prefs):
+    import yaml
+    with open(PREFS_FILE, 'w', encoding='utf-8') as f:
+        yaml.dump(prefs, f, allow_unicode=True, default_flow_style=False)
+
+def get_prefs():
+    return _load_prefs()
+
+def should_evolve():
+    prefs = _load_prefs()
+    tc = prefs.get('tasks_completed', 0)
+    return tc > 0 and tc % 10 == 0
+
+if __name__ == '__main__':
+    import sys
+    if len(sys.argv) < 2:
+        print('Usage: learn.py record <event> [json] | learn.py status')
+    elif sys.argv[1] == 'status':
+        prefs = get_prefs()
+        print('Learning Stats:')
+        for k, v in prefs.items():
+            if isinstance(v, int): print('  ' + k + ': ' + str(v))
+        print('  Evolve ready: ' + str(should_evolve()))
+    elif sys.argv[1] == 'record' and len(sys.argv) >= 3:
+        data = json.loads(sys.argv[3]) if len(sys.argv) > 3 else {}
+        record_feedback(sys.argv[2], data)

package/templates/qoder/scripts/notify.py

@@ -0,0 +1,5 @@
+# notify.py - Simple console notification
+class Notifier:
+    def notify(self, event, title, content):
+        sep = '=' * 50
+        print(chr(10).join(['', sep, 'NOTIFY: ' + title, sep, content, sep]))

package/templates/qoder/scripts/parse_prds.py

@@ -0,0 +1,33 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+Parse PRD files and build PRD index (data/index/prd-index.json).
+
+THIN WRAPPER: the actual parsing logic lives in git_sync.py (single
+source of truth - previously this file kept its own drifted copy of
+the parser and term maps). Kept for backwards compatibility.
+
+Usage:
+  python parse_prds.py          # rebuild prd-index.json + prd-code-map.json
+"""
+
+import os
+import sys
+
+# UTF-8 stdio (防御性: stdout 被捕获时不崩溃)
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError, IOError):
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from git_sync import build_prd_index, build_prd_code_mapping, FAILURES
+
+if __name__ == '__main__':
+    build_prd_index()
+    build_prd_code_mapping()
+    sys.exit(1 if FAILURES else 0)