@hupan56/wlkj 2.5.0 → 2.7.0

package/templates/qoder/scripts/setup.py

@@ -1,453 +1,706 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-setup.py - 一键就绪 (小而美)
-
-跑这一条命令, 把整套工作流配好可用:
-    python .qoder/scripts/setup.py
-    python .qoder/scripts/setup.py 小王          # 指定名字
-    python .qoder/scripts/setup.py 小王 dev      # 指定名字+角色
-    python .qoder/scripts/setup.py --skip-cron   # 跳过 cron 询问
-
-自动完成:
-  1. 环境自检 (Python / git)
-  2. 身份探测 (从 git config user.name, 或交互输入)
-  3. 调 init_doctor --fix (写 .developer / git 对齐 / 拉源码 / 建索引 / QoderWork 检查)
-  4. config.yaml 引导 (源码仓库未配时提示)
-  5. cron 一键注册 (询问式 opt-in)
-  6. QoderWork 技能安装 (检测到桌面端时询问)
-  7. 打印就绪报告
-
-幂等: 可重复跑, 不会重复安装。
-"""
-
-import argparse
-import os
-import subprocess
-import sys
-from pathlib import Path
-
-try:
-    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
-    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
-except (AttributeError, TypeError, OSError):
-    pass
-
-THIS_DIR = Path(__file__).resolve().parent
-BASE = THIS_DIR.parent.parent  # repo root
-
-
-# ============================================================
-# 工具函数
-# ============================================================
-
-def ok(msg):
-    print(f'  [\u2713] {msg}')  # ✓
-
-
-def warn(msg):
-    print(f'  [!] {msg}')
-
-
-def fail(msg):
-    print(f'  [\u2717] {msg}', file=sys.stderr)
-
-
-def ask(prompt, default='y'):
-    """交互式 yes/no, 默认 default。非交互环境 (无 stdin) 返回 default。"""
-    if not sys.stdin.isatty():
-        return default.lower() in ('y', 'yes')
-    try:
-        ans = input(f'{prompt} [{default}] ').strip().lower() or default
-        return ans in ('y', 'yes')
-    except (EOFError, KeyboardInterrupt):
-        return default.lower() in ('y', 'yes')
-
-
-def run(cmd, **kwargs):
-    """跑子进程, 返回 CompletedProcess。encoding 容错。"""
-    kwargs.setdefault('capture_output', True)
-    kwargs.setdefault('text', True)
-    kwargs.setdefault('encoding', 'utf-8')
-    kwargs.setdefault('errors', 'replace')
-    return subprocess.run(cmd, **kwargs)
-
-
-# ============================================================
-# Step 0: 环境自检
-# ============================================================
-
-def check_env():
-    print('\n--- 环境自检 ---')
-    # Python 版本
-    if sys.version_info < (3, 9):
-        fail(f'Python {sys.version.split()[0]} 版本过低, 需要 3.9+')
-        return False
-    ok(f'Python {sys.version.split()[0]}')
-    # git (可选: 无 git 时尝试自动装, 装不上就降级)
-    r = None
-    try:
-        r = run(['git', '--version'])
-    except FileNotFoundError:
-        pass
-    if not r or r.returncode != 0:
-        # 尝试自动安装 git
-        if try_install_git():
-            ok('git 已自动安装')
-        else:
-            warn('git 未安装 — 团队同步/源码克隆将禁用, 本地 PRD/搜索/任务/报告仍可用')
-            print('       (想启用团队协作: 安装 git 后重跑 setup.py)')
-        return True  # 不阻塞, 继续
-    ok('git 可用')
-    return True
-
-
-def try_install_git():
-    """尝试自动安装 git (Windows: winget; macOS: brew; Linux: apt)。
-    成功返回 True, 失败/无法自动装返回 False。"""
-    print('\n  检测到 git 未安装, 尝试自动安装...')
-    if not sys.stdin.isatty():
-        # 非交互环境, 不自动装 (避免意外操作)
-        warn('非交互环境, 跳过自动安装')
-        return False
-
-    platform = sys.platform
-    if platform == 'win32':
-        # Windows: 优先 winget, 回退 choco
-        if ask('用 winget 安装 Git for Windows? (需要网络, 可能要管理员权限)', 'y'):
-            print('  运行: winget install --id Git.Git -e --source winget')
-            r = run(['winget', 'install', '--id', 'Git.Git', '-e', '--source', 'winget',
-                     '--accept-source-agreements', '--accept-package-agreements'])
-            if r.returncode == 0:
-                # 刷新 PATH (winget 装的 git 需要新终端才生效, 这里尝试常见路径)
-                _refresh_git_path()
-                return _git_now_available()
-            else:
-                warn('winget 安装失败: ' + (r.stderr or '').strip()[:150])
-                print('       手动下载: https://git-scm.com/download/win')
-        return False
-    elif platform == 'darwin':
-        # macOS: brew
-        if ask('用 Homebrew 安装 git? (brew install git)', 'y'):
-            r = run(['brew', 'install', 'git'])
-            if r.returncode == 0:
-                return _git_now_available()
-            else:
-                warn('brew 安装失败: ' + (r.stderr or '').strip()[:150])
-                print('       或手动: https://git-scm.com/download/mac')
-        return False
-    else:
-        # Linux: apt (Debian/Ubuntu) / yum (CentOS) / dnf
-        for mgr, cmd in [('apt', ['sudo', 'apt-get', 'install', '-y', 'git']),
-                         ('dnf', ['sudo', 'dnf', 'install', '-y', 'git']),
-                         ('yum', ['sudo', 'yum', 'install', '-y', 'git'])]:
-            # 检测包管理器是否存在
-            check = run(['which', mgr])
-            if check.returncode == 0:
-                if ask(f'用 {mgr} 安装 git?', 'y'):
-                    r = run(cmd)
-                    if r.returncode == 0:
-                        return _git_now_available()
-                    else:
-                        warn(f'{mgr} 安装失败: ' + (r.stderr or '').strip()[:150])
-                return False
-        warn('未检测到 apt/dnf/yum, 请手动安装 git')
-        return False
-
-
-def _refresh_git_path():
-    """winget 装完 git 后, 尝试把常见路径加到 PATH (当前进程)。"""
-    candidates = [
-        r'C:\Program Files\Git\cmd',
-        r'C:\Program Files\Git\bin',
-        r'C:\Program Files (x86)\Git\cmd',
-    ]
-    for c in candidates:
-        if os.path.isdir(c):
-            os.environ['PATH'] = c + os.pathsep + os.environ.get('PATH', '')
-
-
-def _git_now_available():
-    """检查 git 现在是否可用 (装完后立即验证)。"""
-    try:
-        r = run(['git', '--version'])
-        return r.returncode == 0
-    except FileNotFoundError:
-        return False
-
-
-# ============================================================
-# Step 1: 身份探测
-# ============================================================
-
-def detect_name(explicit=None):
-    """身份探测: 显式参数 > git config user.name > 交互输入。"""
-    print('\n--- 身份探测 ---')
-    if explicit:
-        ok(f'使用指定名字: {explicit}')
-        return explicit
-    # 从 git config 探测 (git 可能未安装)
-    git_name = ''
-    try:
-        r = run(['git', 'config', 'user.name'])
-        if r.returncode == 0:
-            git_name = r.stdout.strip()
-    except FileNotFoundError:
-        pass  # git 未装, 跳过
-    if git_name:
-        if ask(f'检测到 git user.name = "{git_name}", 用这个名字?', 'y'):
-            ok(f'使用 git 名字: {git_name}')
-            return git_name
-    # 交互输入
-    if not sys.stdin.isatty():
-        # 非交互环境 (如 AI 调用), 默认用 git 名字或 'me'
-        name = git_name or 'me'
-        warn(f'非交互环境, 默认用: {name}')
-        return name
-    while True:
-        try:
-            name = input('你叫什么名字? ').strip()
-            if name and len(name) <= 32:
-                ok(f'名字: {name}')
-                return name
-            print('  名字需 1-32 字符, 重试。')
-        except (EOFError, KeyboardInterrupt):
-            warn('未输入, 用 git 名字或 "me"')
-            return git_name or 'me'
-
-
-# ============================================================
-# Step 2: 调 init_doctor --fix (主体)
-# ============================================================
-
-def run_doctor(name, role):
-    print('\n--- 初始化 (init_doctor) ---')
-    cmd = [sys.executable, str(THIS_DIR / 'init_doctor.py'), '--fix', name, role]
-    r = subprocess.run(cmd, cwd=str(BASE))
-    # init_doctor 返回 0=健康, 1=有未解决问题
-    if r.returncode == 0:
-        ok('init_doctor 完成, 环境健康')
-        return True
-    elif r.returncode == 1:
-        warn('init_doctor 完成, 但有未解决问题 (见上方 [WARN])')
-        return True  # 不阻塞, 用户可继续
-    else:
-        fail(f'init_doctor 失败 (exit {r.returncode})')
-        return False
-
-
-# ============================================================
-# Step 3: config.yaml 引导
-# ============================================================
-
-def guide_config():
-    """检查 config.yaml 的 git_sync.projects 是否有效配置。"""
-    print('\n--- 源码仓库配置 ---')
-    cfg = BASE / '.qoder' / 'config.yaml'
-    if not cfg.is_file():
-        warn('config.yaml 不存在 (init_doctor 会创建默认)')
-        return
-
-    try:
-        content = cfg.read_text(encoding='utf-8')
-    except Exception:
-        return
-
-    # 检测 git_sync.projects 是否有真实 URL (非占位/注释)
-    has_real_url = False
-    in_projects = False
-    for line in content.splitlines():
-        s = line.strip()
-        if s.startswith('projects:'):
-            in_projects = True
-            continue
-        if in_projects:
-            if s and not s.startswith('#') and not line[0].isspace():
-                in_projects = False  # 离开 projects 段
-                continue
-            if 'url:' in s and 'your-' not in s and 'example.com' not in s and '占位' not in s and not s.startswith('#'):
-                has_real_url = True
-                break
-
-    if has_real_url:
-        ok('源码仓库已配置')
-    else:
-        warn('config.yaml 的 git_sync.projects 未填真实 URL')
-        print('       打开 .qoder/config.yaml, 找到 git_sync.projects 段,')
-        print('       把 url 改成你团队的 git 地址。或手动把代码放到 data/code/。')
-        print('       填完后重跑 setup.py 即可自动克隆+建索引。')
-
-
-# ============================================================
-# Step 4: cron 一键注册
-# ============================================================
-
-def offer_cron(skip=False):
-    if skip:
-        return
-    print('\n--- 周五自动更新 ---')
-    # 检测是否已注册
-    if sys.platform == 'win32':
-        r = run(['schtasks', '/query', '/tn', 'QODER-WeeklyUpdate'])
-        registered = r.returncode == 0
-    else:
-        r = run(['crontab', '-l'])
-        registered = 'QODER-WeeklyUpdate' in (r.stdout or '') or 'run_weekly_update' in (r.stdout or '')
-
-    if registered:
-        ok('周五 cron 已注册')
-        return
-
-    if ask('注册周五 18:00 自动更新知识图谱? (团队只需一台机器注册)', 'y'):
-        if sys.platform == 'win32':
-            r = run(['cmd', '/c', str(THIS_DIR / 'setup_weekly_cron.bat')], cwd=str(BASE))
-        else:
-            r = run(['bash', str(THIS_DIR / 'setup_weekly_cron.sh')], cwd=str(BASE))
-        if r.returncode == 0:
-            ok('cron 已注册 (周五 18:00)')
-        else:
-            warn(f'cron 注册失败: {(r.stderr or "").strip()[:100]}')
-    else:
-        print('       跳过。以后可手动跑: python .qoder/scripts/setup_weekly_cron.bat')
-
-
-# ============================================================
-# Step 5: QoderWork 技能
-# ============================================================
-
-def offer_qoderwork(skip=False):
-    if skip:
-        return
-    print('\n--- QoderWork 桌面端 ---')
-    home = Path(os.environ.get('USERPROFILE') or os.environ.get('HOME') or '~').expanduser()
-    qw_dir = home / '.qoderworkcn'
-    if not qw_dir.exists():
-        print('       未检测到 QoderWork 桌面端, 跳过。')
-        return
-
-    # 检查是否已装
-    skills_dir = qw_dir / 'skills'
-    installed = skills_dir.is_dir() and any(skills_dir.iterdir()) if skills_dir.exists() else False
-    if installed:
-        ok('QoderWork 技能已安装')
-        return
-
-    if ask('检测到 QoderWork, 安装技能 (软链到 ~/.qoderworkcn/skills/)?', 'y'):
-        r = subprocess.run([sys.executable, str(THIS_DIR / 'install_qoderwork.py')], cwd=str(BASE))
-        if r.returncode == 0:
-            ok('QoderWork 技能已安装')
-        else:
-            warn('安装失败, 见上方输出')
-
-
-# ============================================================
-# Step 6: 就绪报告
-# ============================================================
-
-def print_ready(name, role):
-    print('\n' + '=' * 56)
-    print('  一键就绪完成')
-    print('=' * 56)
-
-    # 读关键状态
-    dev_file = BASE / '.qoder' / '.developer'
-    if dev_file.is_file():
-        ok(f'开发者: {name} ({role})')
-
-    # git config (git 可能未装)
-    try:
-        r = run(['git', 'config', 'user.name'], cwd=str(BASE))
-        if r.returncode == 0 and r.stdout.strip():
-            ok(f'Git: user.name={r.stdout.strip()}')
-    except FileNotFoundError:
-        pass  # 无 git, 跳过此项
-
-    # 源码仓库
-    code_dir = BASE / 'data' / 'code'
-    if code_dir.is_dir():
-        projects = [d.name for d in code_dir.iterdir() if d.is_dir() and not d.name.startswith('.')]
-        if projects:
-            ok(f'源码仓库: {len(projects)} 个项目 ({", ".join(projects[:3])})')
-
-    # 索引
-    ki = BASE / 'data' / 'index' / 'keyword-index.json'
-    if ki.is_file():
-        try:
-            import json
-            data = json.loads(ki.read_text(encoding='utf-8'))
-            ok(f'知识图谱: {len(data)} keywords')
-        except Exception:
-            pass
-
-    # cron
-    if sys.platform == 'win32':
-        r = run(['schtasks', '/query', '/tn', 'QODER-WeeklyUpdate'])
-        if r.returncode == 0:
-            ok('周五 cron: 已注册')
-
-    print()
-    print('  现在可以开始了:')
-    print('    /wl-prd 写需求      /wl-search 查代码      /wl-task 建任务')
-    print('    /wl-status 看进度   /wl-report 出日报      /wl-commit 提交')
-    print()
-    print('  或直接用自然语言:')
-    print('    "写个保险异常筛选的 PRD"')
-    print('    "查一下考勤代码在哪"')
-    print('=' * 56)
-
-
-# ============================================================
-# Main
-# ============================================================
-
-def main():
-    parser = argparse.ArgumentParser(
-        description='一键就绪: 配置开发者/git/源码/索引/cron/QoderWork',
-        formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog='''示例:
-  python .qoder/scripts/setup.py              # 自动探测名字
-  python .qoder/scripts/setup.py 小王          # 指定名字
-  python .qoder/scripts/setup.py 小王 dev      # 名字+角色
-  python .qoder/scripts/setup.py --skip-cron   # 跳过 cron 询问
-''')
-    parser.add_argument('name', nargs='?', default=None, help='开发者名字 (不传则从 git 探测)')
-    parser.add_argument('role', nargs='?', default='pm', help='角色 (pm/dev/design/admin)')
-    parser.add_argument('--skip-cron', action='store_true', help='跳过 cron 注册')
-    parser.add_argument('--skip-qoderwork', action='store_true', help='跳过 QoderWork 安装')
-    args = parser.parse_args()
-
-    print('=' * 56)
-    print('  QODER 一键就绪')
-    print('=' * 56)
-
-    # Step 0
-    if not check_env():
-        return 1
-
-    # Step 1
-    name = detect_name(args.name)
-    if not name or not name.strip():
-        fail('未能确定开发者名字')
-        return 1
-
-    # Step 2
-    if not run_doctor(name, args.role):
-        warn('init_doctor 未完全成功, 继续 setup 后续步骤...')
-
-    # Step 3
-    guide_config()
-
-    # Step 4
-    offer_cron(skip=args.skip_cron)
-
-    # Step 5
-    offer_qoderwork(skip=args.skip_qoderwork)
-
-    # Step 6
-    print_ready(name, args.role)
-
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+setup.py - 一键就绪 (小而美)
+
+跑这一条命令, 把整套工作流配好可用:
+    python .qoder/scripts/setup.py
+    python .qoder/scripts/setup.py 小王          # 指定名字
+    python .qoder/scripts/setup.py 小王 dev      # 指定名字+角色
+    python .qoder/scripts/setup.py --skip-cron   # 跳过 cron 询问
+
+自动完成:
+  1. 环境自检 (Python / git)
+  2. 身份探测 (从 git config user.name, 或交互输入)
+  3. 调 init_doctor --fix (写 .developer / git 对齐 / 拉源码 / 建索引 / QoderWork 检查)
+  4. config.yaml 引导 (源码仓库未配时提示)
+  5. cron 一键注册 (询问式 opt-in)
+  6. QoderWork 技能安装 (检测到桌面端时询问)
+  7. 打印就绪报告
+
+幂等: 可重复跑, 不会重复安装。
+"""
+
+import argparse
+import os
+import subprocess
+import sys
+from pathlib import Path
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except (AttributeError, TypeError, OSError):
+    pass
+
+THIS_DIR = Path(__file__).resolve().parent
+BASE = THIS_DIR.parent.parent  # repo root
+
+
+# ============================================================
+# 工具函数
+# ============================================================
+
+def ok(msg):
+    print(f'  [\u2713] {msg}')  # ✓
+
+
+def warn(msg):
+    print(f'  [!] {msg}')
+
+
+def fail(msg):
+    print(f'  [\u2717] {msg}', file=sys.stderr)
+
+
+def ask(prompt, default='y'):
+    """交互式 yes/no, 默认 default。非交互环境 (无 stdin) 返回 default。"""
+    if not sys.stdin.isatty():
+        return default.lower() in ('y', 'yes')
+    try:
+        ans = input(f'{prompt} [{default}] ').strip().lower() or default
+        return ans in ('y', 'yes')
+    except (EOFError, KeyboardInterrupt):
+        return default.lower() in ('y', 'yes')
+
+
+def run(cmd, **kwargs):
+    """跑子进程, 返回 CompletedProcess。encoding 容错。"""
+    kwargs.setdefault('capture_output', True)
+    kwargs.setdefault('text', True)
+    kwargs.setdefault('encoding', 'utf-8')
+    kwargs.setdefault('errors', 'replace')
+    return subprocess.run(cmd, **kwargs)
+
+
+# ============================================================
+# Step 0: 环境自检
+# ============================================================
+
+def check_env():
+    print('\n--- 环境自检 ---')
+    # Python 版本
+    if sys.version_info < (3, 9):
+        fail(f'Python {sys.version.split()[0]} 版本过低, 需要 3.9+')
+        return False
+    ok(f'Python {sys.version.split()[0]}')
+    # git (可选: 无 git 时尝试自动装, 装不上就降级)
+    r = None
+    try:
+        r = run(['git', '--version'])
+    except FileNotFoundError:
+        pass
+    if not r or r.returncode != 0:
+        # 尝试自动安装 git
+        if try_install_git():
+            ok('git 已自动安装')
+        else:
+            warn('git 未安装 — 团队同步/源码克隆将禁用, 本地 PRD/搜索/任务/报告仍可用')
+            print('       (想启用团队协作: 安装 git 后重跑 \'wlkj init\')')
+        return True  # 不阻塞, 继续
+    ok('git 可用')
+    return True
+
+
+def try_install_git():
+    """尝试自动安装 git (Windows: winget; macOS: brew; Linux: apt)。
+    成功返回 True, 失败/无法自动装返回 False。"""
+    print('\n  检测到 git 未安装, 尝试自动安装...')
+    if not sys.stdin.isatty():
+        # 非交互环境, 不自动装 (避免意外操作)
+        warn('非交互环境, 跳过自动安装')
+        return False
+
+    platform = sys.platform
+    if platform == 'win32':
+        # Windows: 优先 winget, 回退 choco
+        if ask('用 winget 安装 Git for Windows? (需要网络, 可能要管理员权限)', 'y'):
+            print('  运行: winget install --id Git.Git -e --source winget')
+            r = run(['winget', 'install', '--id', 'Git.Git', '-e', '--source', 'winget',
+                     '--accept-source-agreements', '--accept-package-agreements'])
+            if r.returncode == 0:
+                # 刷新 PATH (winget 装的 git 需要新终端才生效, 这里尝试常见路径)
+                _refresh_git_path()
+                return _git_now_available()
+            else:
+                warn('winget 安装失败: ' + (r.stderr or '').strip()[:150])
+                print('       手动下载: https://git-scm.com/download/win')
+        return False
+    elif platform == 'darwin':
+        # macOS: brew
+        if ask('用 Homebrew 安装 git? (brew install git)', 'y'):
+            r = run(['brew', 'install', 'git'])
+            if r.returncode == 0:
+                return _git_now_available()
+            else:
+                warn('brew 安装失败: ' + (r.stderr or '').strip()[:150])
+                print('       或手动: https://git-scm.com/download/mac')
+        return False
+    else:
+        # Linux: apt (Debian/Ubuntu) / yum (CentOS) / dnf
+        for mgr, cmd in [('apt', ['sudo', 'apt-get', 'install', '-y', 'git']),
+                         ('dnf', ['sudo', 'dnf', 'install', '-y', 'git']),
+                         ('yum', ['sudo', 'yum', 'install', '-y', 'git'])]:
+            # 检测包管理器是否存在
+            check = run(['which', mgr])
+            if check.returncode == 0:
+                if ask(f'用 {mgr} 安装 git?', 'y'):
+                    r = run(cmd)
+                    if r.returncode == 0:
+                        return _git_now_available()
+                    else:
+                        warn(f'{mgr} 安装失败: ' + (r.stderr or '').strip()[:150])
+                return False
+        warn('未检测到 apt/dnf/yum, 请手动安装 git')
+        return False
+
+
+def _refresh_git_path():
+    """winget 装完 git 后, 尝试把常见路径加到 PATH (当前进程)。"""
+    candidates = [
+        r'C:\Program Files\Git\cmd',
+        r'C:\Program Files\Git\bin',
+        r'C:\Program Files (x86)\Git\cmd',
+    ]
+    for c in candidates:
+        if os.path.isdir(c):
+            os.environ['PATH'] = c + os.pathsep + os.environ.get('PATH', '')
+
+
+def _git_now_available():
+    """检查 git 现在是否可用 (装完后立即验证)。"""
+    try:
+        r = run(['git', '--version'])
+        return r.returncode == 0
+    except FileNotFoundError:
+        return False
+
+
+# ============================================================
+# Step 1: 身份探测
+# ============================================================
+
+def detect_name(explicit=None):
+    """身份探测: 显式参数 > git config user.name > 交互输入。"""
+    print('\n--- 身份探测 ---')
+    if explicit:
+        ok(f'使用指定名字: {explicit}')
+        return explicit
+    # 从 git config 探测 (git 可能未安装)
+    git_name = ''
+    try:
+        r = run(['git', 'config', 'user.name'])
+        if r.returncode == 0:
+            git_name = r.stdout.strip()
+    except FileNotFoundError:
+        pass  # git 未装, 跳过
+    if git_name:
+        if ask(f'检测到 git user.name = "{git_name}", 用这个名字?', 'y'):
+            ok(f'使用 git 名字: {git_name}')
+            return git_name
+    # 交互输入
+    if not sys.stdin.isatty():
+        # 非交互环境 (如 AI 调用), 默认用 git 名字或 'me'
+        name = git_name or 'me'
+        warn(f'非交互环境, 默认用: {name}')
+        return name
+    while True:
+        try:
+            name = input('你叫什么名字? ').strip()
+            if name and len(name) <= 32:
+                ok(f'名字: {name}')
+                return name
+            print('  名字需 1-32 字符, 重试。')
+        except (EOFError, KeyboardInterrupt):
+            warn('未输入, 用 git 名字或 "me"')
+            return git_name or 'me'
+
+
+# ============================================================
+# Step 2: 调 init_doctor --fix (主体)
+# ============================================================
+
+def run_doctor(name, role):
+    print('\n--- 初始化 (init_doctor) ---')
+    cmd = [sys.executable, str(THIS_DIR / 'init_doctor.py'), '--fix', name, role]
+    r = subprocess.run(cmd, cwd=str(BASE))
+    # init_doctor 返回 0=健康, 1=有未解决问题
+    if r.returncode == 0:
+        ok('init_doctor 完成, 环境健康')
+        return True
+    elif r.returncode == 1:
+        warn('init_doctor 完成, 但有未解决问题 (见上方 [WARN])')
+        return True  # 不阻塞, 用户可继续
+    else:
+        fail(f'init_doctor 失败 (exit {r.returncode})')
+        return False
+
+
+# ============================================================
+# Step 3: config.yaml 引导
+# ============================================================
+
+def guide_config():
+    """检查 config.yaml 的 git_sync.projects 是否有效配置。"""
+    print('\n--- 源码仓库配置 ---')
+    cfg = BASE / '.qoder' / 'config.yaml'
+    if not cfg.is_file():
+        warn('config.yaml 不存在 (init_doctor 会创建默认)')
+        return
+
+    try:
+        content = cfg.read_text(encoding='utf-8')
+    except Exception:
+        return
+
+    # 检测 git_sync.projects 是否有真实 URL (非占位/注释)
+    has_real_url = False
+    in_projects = False
+    for line in content.splitlines():
+        s = line.strip()
+        if s.startswith('projects:'):
+            in_projects = True
+            continue
+        if in_projects:
+            if s and not s.startswith('#') and not line[0].isspace():
+                in_projects = False  # 离开 projects 段
+                continue
+            if 'url:' in s and 'your-' not in s and 'example.com' not in s and '占位' not in s and not s.startswith('#'):
+                has_real_url = True
+                break
+
+    if has_real_url:
+        ok('源码仓库已配置')
+    else:
+        warn('config.yaml 的 git_sync.projects 未填真实 URL')
+        print('       打开 .qoder/config.yaml, 找到 git_sync.projects 段,')
+        print('       把 url 改成你团队的 git 地址。或手动把代码放到 data/code/。')
+        print('       填完后重跑 \'wlkj init\' 即可自动克隆+建索引。')
+
+
+# ============================================================
+# Step 2.5: Git 身份配置 (在 init_doctor 之前, 确保下游探测到真账号)
+# ============================================================
+
+def configure_git_identity(name):
+    """配置 git user.name/email。未配或疑似假账号时交互式问用户。
+
+    设计: 绝不自动造假账号。git 没配 → 问用户要真账号; 配了但像假的(@local) → 确认。
+    这样下游 init_developer 探测到的就是真账号, member.json 不会写假 git_author。
+    """
+    print('\n--- Git 身份配置 ---')
+
+    # 1. git 是否可用
+    try:
+        subprocess.run(['git', '--version'], capture_output=True, timeout=5)
+    except (FileNotFoundError, OSError):
+        warn('git 未安装, 跳过 (push/commit 不可用, 但能本地工作)')
+        return False
+
+    # 2. 探测现有 git config (全局 + local 合并视图)
+    existing_name = run(['git', 'config', 'user.name']).stdout.strip()
+    existing_email = run(['git', 'config', 'user.email']).stdout.strip()
+
+    # 3. 判断是否需要配置
+    needs_config = False
+    if not existing_name or not existing_email:
+        needs_config = True
+        warn('git 未配置 user.name/user.email (团队协作必须)')
+    elif '@local' in existing_email:
+        needs_config = True
+        warn(f'检测到疑似假账号: {existing_name} <{existing_email}>')
+        print('       (可能是旧版 init 自动填的, 需要换成你的团队 git 账号)')
+
+    if not needs_config:
+        # 已有真配置, 确认是否用这个
+        if ask(f'用这个 git 账号? {existing_name} <{existing_email}>', 'y'):
+            ok(f'git 账号: {existing_name} <{existing_email}>')
+            return True
+        needs_config = True  # 用户不想用, 重新配
+
+    # 4. 非交互环境: 不能问, 给明确指引后返回 (绝不造假)
+    if not sys.stdin.isatty():
+        warn('非交互环境, 无法询问 git 账号。请手动配置后重跑 \'wlkj init\':')
+        print('       git config --global user.name "你的名字"')
+        print('       git config --global user.email "你的团队邮箱"')
+        return False
+
+    # 5. 交互式收集 git 账号
+    print('\n  配置你的团队 git 账号 (用于提交代码和团队协作):')
+    while True:
+        try:
+            git_name = input(f'  git 用户名 [{existing_name or name}]: ').strip() or existing_name or name
+            git_email = input('  git 邮箱 (团队邮箱): ').strip()
+            if not git_email or '@' not in git_email:
+                print('  邮箱格式不对 (需含 @), 重试。')
+                continue
+            if '@local' in git_email:
+                if not ask('邮箱含 @local, 这通常不是团队邮箱, 确定用这个?', 'n'):
+                    continue
+            break
+        except (EOFError, KeyboardInterrupt):
+            warn('未输入, 跳过 git 配置 (push 会失败, 手动配: git config user.name/user.email)')
+            return False
+
+    # 6. 写入 git config (默认 --global, 用户通常只有一个 git 身份)
+    use_global = ask('设为全局配置 (所有项目通用)? [Y] 还是只本仓库? [n]', 'y')
+    scope = '--global' if use_global else '--local'
+
+    r1 = run(['git', 'config', scope, 'user.name', git_name], cwd=str(BASE))
+    r2 = run(['git', 'config', scope, 'user.email', git_email], cwd=str(BASE))
+    if r1.returncode == 0 and r2.returncode == 0:
+        ok(f'git {scope.replace("--", "")} 配置: {git_name} <{git_email}>')
+        return True
+    warn('git config 设置失败: ' + (r1.stderr or r2.stderr or '').strip()[:100])
+    return False
+
+
+def _read_team_remote_from_config():
+    """从 .qoder/config.yaml 读 team_remote.url (没有返回 None)。"""
+    cfg = BASE / '.qoder' / 'config.yaml'
+    if not cfg.is_file():
+        return None
+    try:
+        content = cfg.read_text(encoding='utf-8')
+    except Exception:
+        return None
+    in_team = False
+    for line in content.splitlines():
+        s = line.strip()
+        if s.startswith('team_remote:'):
+            in_team = True
+            continue
+        if in_team:
+            if s and not s.startswith('#') and not line[0].isspace():
+                break  # 离开 team_remote 段
+            if s.startswith('url:'):
+                url = s.split(':', 1)[1].strip().strip('\'"')
+                if url:
+                    return url
+    return None
+
+
+def _write_team_remote_to_config(url):
+    """把 team_remote.url 写进 config.yaml (best-effort, 不阻塞)。"""
+    cfg = BASE / '.qoder' / 'config.yaml'
+    if not cfg.is_file():
+        return
+    try:
+        content = cfg.read_text(encoding='utf-8')
+        if 'team_remote:' in content:
+            return  # 已有段, 不重复写
+        # 在 git_sync 段之前插入
+        marker = '# ── Git Sync'
+        block = (
+            '# ── 团队协作仓库 (workspace/ 产出 push 到这里) ──\n'
+            '# 团队共享 PRD/任务/原型的仓库, 跟 data/code/ 源码仓库不同。\n'
+            'team_remote:\n'
+            '  url: "%s"  # 团队所有人 init 时自动用这个地址\n'
+            '  branch: master\n\n' % url
+        )
+        if marker in content:
+            content = content.replace(marker, block + marker, 1)
+        else:
+            content = block + content
+        cfg.write_text(content, encoding='utf-8')
+    except Exception:
+        pass
+
+
+def configure_team_remote():
+    """配置团队协作仓库的 git remote (workspace/ 产出往这里 push)。
+
+    当前问题: 完全没人配 remote, 用户不知道往哪 push。
+    检测 origin 是否存在, 不存在则问用户要团队仓库地址。
+    """
+    print('\n--- 团队协作仓库 ---')
+
+    # 1. 是否已是 git 仓库
+    if not (BASE / '.git').is_dir():
+        return  # cli.js doInit 已做 git init, 这里兜底
+
+    # 2. 检测是否已有 origin
+    r = run(['git', 'remote'], cwd=str(BASE))
+    remotes = r.stdout.split() if r.returncode == 0 else []
+    if 'origin' in remotes:
+        url_r = run(['git', 'remote', 'get-url', 'origin'], cwd=str(BASE))
+        url = url_r.stdout.strip() if url_r.returncode == 0 else '?'
+        ok(f'团队仓库已配置: origin -> {url}')
+        return
+
+    # 3. 没有 origin — 从 config.yaml 读 team_remote (如果有)
+    team_url = _read_team_remote_from_config()
+    if team_url:
+        if ask(f'用 config.yaml 里的团队仓库地址? {team_url}', 'y'):
+            r = run(['git', 'remote', 'add', 'origin', team_url], cwd=str(BASE))
+            if r.returncode == 0:
+                ok(f'团队仓库已配置: origin -> {team_url}')
+            else:
+                warn('remote add 失败: ' + (r.stderr or '').strip()[:100])
+            return
+
+    # 4. 交互式问用户要团队仓库地址
+    if not sys.stdin.isatty():
+        warn('未配置团队仓库 origin, push 会失败。手动配: git remote add origin <团队仓库URL>')
+        return
+
+    print('\n  配置团队协作仓库 (你的 PRD/任务/产出 push 到这里, 团队共享):')
+    try:
+        url = input('  团队仓库地址 (留空跳过, 之后可配): ').strip()
+    except (EOFError, KeyboardInterrupt):
+        url = ''
+    if not url:
+        warn('跳过团队仓库配置。之后可手动配: git remote add origin <URL>')
+        return
+    r = run(['git', 'remote', 'add', 'origin', url], cwd=str(BASE))
+    if r.returncode == 0:
+        ok(f'团队仓库已配置: origin -> {url}')
+        _write_team_remote_to_config(url)  # 顺手写 config 供团队复用
+    else:
+        warn('remote add 失败: ' + (r.stderr or '').strip()[:100])
+
+
+# ============================================================
+# Step 4: cron 一键注册
+# ============================================================
+
+def offer_cron(skip=False):
+    if skip:
+        return
+    print('\n--- 周五自动更新 ---')
+    # 检测是否已注册
+    if sys.platform == 'win32':
+        r = run(['schtasks', '/query', '/tn', 'QODER-WeeklyUpdate'])
+        registered = r.returncode == 0
+    else:
+        r = run(['crontab', '-l'])
+        registered = 'QODER-WeeklyUpdate' in (r.stdout or '') or 'run_weekly_update' in (r.stdout or '')
+
+    if registered:
+        ok('周五 cron 已注册')
+        return
+
+    if ask('注册周五 18:00 自动更新知识图谱? (团队只需一台机器注册)', 'y'):
+        if sys.platform == 'win32':
+            r = run(['cmd', '/c', str(THIS_DIR / 'setup_weekly_cron.bat')], cwd=str(BASE))
+        else:
+            r = run(['bash', str(THIS_DIR / 'setup_weekly_cron.sh')], cwd=str(BASE))
+        if r.returncode == 0:
+            ok('cron 已注册 (周五 18:00)')
+        else:
+            warn(f'cron 注册失败: {(r.stderr or "").strip()[:100]}')
+    else:
+        print('       跳过。以后可手动跑: python .qoder/scripts/setup_weekly_cron.bat')
+
+
+# ============================================================
+# Step 4.5: 蓝湖 MCP (设计师直读蓝湖设计稿)
+# ============================================================
+
+def offer_lanhu(name, skip=False):
+    """引导蓝湖 MCP: clone + venv 依赖 + cookie + mcp.json 注册。
+
+    蓝湖 MCP 是第三方 HTTP server (dsphper/lanhu-mcp), 让设计师发蓝湖链接,
+    AI 直读设计稿(颜色/尺寸/字体/切图), 比截图口述精确。opt-in, 不用蓝湖可跳过。
+    """
+    if skip:
+        return
+    print('\n--- 蓝湖 MCP (设计稿直读增强) ---')
+    # 已配好就不问, 直接确认
+    try:
+        sys.path.insert(0, str(THIS_DIR))
+        from setup_lanhu import (_read_env_cookie, register_lanhu_mcp,
+                                 QODERWORK_MCP_FILE, LANHU_DIR, is_lanhu_running)
+        import json as _json
+        already = False
+        if QODERWORK_MCP_FILE.is_file():
+            try:
+                cfg = _json.loads(QODERWORK_MCP_FILE.read_text(encoding='utf-8'))
+                already = 'lanhu' in cfg.get('mcpServers', {})
+            except (ValueError, OSError):
+                pass
+        if already:
+            ok('蓝湖 MCP 已配置')
+            if not is_lanhu_running():
+                print('       (蓝湖服务端未启动, 用时再起)')
+            return
+    except ImportError:
+        warn('setup_lanhu.py 不可用, 跳过蓝湖引导')
+        return
+
+    # 问是否配 (默认 y, 因为团队多数用蓝湖)
+    if not ask('团队用蓝湖做设计协作吗? 配蓝湖 MCP (设计师发链接 AI 直读设计稿)?', 'y'):
+        print('       跳过。之后可手动跑: python .qoder/scripts/setup_lanhu.py')
+        return
+
+    # 调引导主流程 (clone + 依赖 + cookie + mcp.json 注册)
+    r = subprocess.run(
+        [sys.executable, str(THIS_DIR / 'setup_lanhu.py'), '--name', name or 'Developer'],
+        cwd=str(BASE))
+    if r.returncode == 0:
+        ok('蓝湖 MCP 引导完成')
+    else:
+        warn('蓝湖 MCP 引导未完全成功 (见上方输出), 不阻塞主线')
+
+
+# ============================================================
+# Step 5: QoderWork 技能
+# ============================================================
+
+def offer_qoderwork(skip=False):
+    if skip:
+        return
+    print('\n--- QoderWork 桌面端 ---')
+    home = Path(os.environ.get('USERPROFILE') or os.environ.get('HOME') or '~').expanduser()
+    qw_dir = home / '.qoderwork'
+    if not qw_dir.exists():
+        print('       未检测到 QoderWork 桌面端, 跳过。')
+        return
+
+    # 检查是否已装
+    skills_dir = qw_dir / 'skills'
+    installed = skills_dir.is_dir() and any(skills_dir.iterdir()) if skills_dir.exists() else False
+    if installed:
+        ok('QoderWork 技能已安装')
+        return
+
+    if ask('检测到 QoderWork, 安装技能 (软链到 ~/.qoderwork/skills/)?', 'y'):
+        r = subprocess.run([sys.executable, str(THIS_DIR / 'install_qoderwork.py')], cwd=str(BASE))
+        if r.returncode == 0:
+            ok('QoderWork 技能已安装')
+        else:
+            warn('安装失败, 见上方输出')
+
+
+# ============================================================
+# Step 6: 就绪报告
+# ============================================================
+
+def print_ready(name, role):
+    print('\n' + '=' * 56)
+    print('  一键就绪完成')
+    print('=' * 56)
+
+    # 读关键状态
+    dev_file = BASE / '.qoder' / '.developer'
+    if dev_file.is_file():
+        ok(f'开发者: {name} ({role})')
+
+    # git config (git 可能未装)
+    try:
+        r = run(['git', 'config', 'user.name'], cwd=str(BASE))
+        if r.returncode == 0 and r.stdout.strip():
+            ok(f'Git: user.name={r.stdout.strip()}')
+    except FileNotFoundError:
+        pass  # 无 git, 跳过此项
+
+    # 源码仓库
+    code_dir = BASE / 'data' / 'code'
+    if code_dir.is_dir():
+        projects = [d.name for d in code_dir.iterdir() if d.is_dir() and not d.name.startswith('.')]
+        if projects:
+            ok(f'源码仓库: {len(projects)} 个项目 ({", ".join(projects[:3])})')
+
+    # 索引
+    ki = BASE / 'data' / 'index' / 'code-keyword.json'
+    if ki.is_file():
+        try:
+            import json
+            data = json.loads(ki.read_text(encoding='utf-8'))
+            ok(f'知识图谱: {len(data)} keywords')
+        except Exception:
+            pass
+
+    # cron
+    if sys.platform == 'win32':
+        r = run(['schtasks', '/query', '/tn', 'QODER-WeeklyUpdate'])
+        if r.returncode == 0:
+            ok('周五 cron: 已注册')
+
+    # 蓝湖 MCP (可选增强)
+    try:
+        import json as _json
+        mcp_f = Path(os.environ.get('USERPROFILE') or os.environ.get('HOME') or '~').expanduser() / '.qoderwork' / 'mcp.json'
+        if mcp_f.is_file():
+            cfg = _json.loads(mcp_f.read_text(encoding='utf-8'))
+            if 'lanhu' in cfg.get('mcpServers', {}):
+                ok('蓝湖 MCP: 已注册 (设计师可发蓝湖链接)')
+    except (ValueError, OSError, ImportError):
+        pass
+
+    print()
+    print('  现在可以开始了:')
+    print('    /wl-prd-full 写需求      /wl-search 查代码      /wl-task 建任务')
+    print('    /wl-status 看进度   /wl-report 出日报      /wl-commit 提交')
+    print()
+    print('  或直接用自然语言:')
+    print('    "写个保险异常筛选的 PRD"')
+    print('    "查一下考勤代码在哪"')
+    print('=' * 56)
+
+
+# ============================================================
+# Main
+# ============================================================
+
+def main():
+    parser = argparse.ArgumentParser(
+        description='一键就绪: 配置开发者/git/源码/索引/cron/QoderWork',
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog='''示例:
+  python .qoder/scripts/setup.py              # 自动探测名字
+  python .qoder/scripts/setup.py 小王          # 指定名字
+  python .qoder/scripts/setup.py 小王 dev      # 名字+角色
+  python .qoder/scripts/setup.py --skip-cron   # 跳过 cron 询问
+''')
+    parser.add_argument('name', nargs='?', default=None, help='开发者名字 (不传则从 git 探测)')
+    parser.add_argument('role', nargs='?', default='pm', help='角色 (pm/dev/design/admin)')
+    parser.add_argument('--skip-cron', action='store_true', help='跳过 cron 注册')
+    parser.add_argument('--skip-qoderwork', action='store_true', help='跳过 QoderWork 安装')
+    parser.add_argument('--skip-lanhu', action='store_true', help='跳过蓝湖 MCP 引导')
+    args = parser.parse_args()
+
+    print('=' * 56)
+    print('  QODER 一键就绪')
+    print('=' * 56)
+
+    # Step 0
+    if not check_env():
+        return 1
+
+    # Step 1
+    name = detect_name(args.name)
+    if not name or not name.strip():
+        fail('未能确定开发者名字')
+        return 1
+
+    # Step 1.5: Git 身份配置 (在 init_doctor 之前, 确保下游探测到真账号而非假账号)
+    configure_git_identity(name)
+
+    # Step 2
+    if not run_doctor(name, args.role):
+        warn('init_doctor 未完全成功, 继续 setup 后续步骤...')
+
+    # Step 3
+    guide_config()
+
+    # Step 3.5: 团队协作仓库 remote (workspace/ 产出 push 到这里)
+    configure_team_remote()
+
+    # Step 4
+    offer_cron(skip=args.skip_cron)
+
+    # Step 4.5: 蓝湖 MCP (设计师直读蓝湖设计稿)
+    offer_lanhu(name, skip=args.skip_lanhu)
+
+    # Step 5
+    offer_qoderwork(skip=args.skip_qoderwork)
+
+    # Step 6
+    print_ready(name, args.role)
+
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())