@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/setup.py

@@ -0,0 +1,453 @@
+#!/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())

package/templates/qoder/scripts/setup_weekly_cron.bat

@@ -0,0 +1,22 @@
+@echo off
+REM Create Windows Task Scheduler for QODER weekly update
+REM Runs every Friday at 18:00 (configurable via argument, e.g. setup_weekly_cron.bat 09:00)
+REM Recommended: one machine per team runs this; others get updates via team_sync pull.
+
+set ST=%1
+if "%ST%"=="" set ST=18:00
+
+REM Create log dir if missing
+if not exist "%~dp0..\..\..\.qoder\logs" mkdir "%~dp0..\..\..\.qoder\logs"
+
+schtasks /create /tn "QODER-WeeklyUpdate" /tr "%~dp0run_weekly_update.bat" /sc weekly /d FRI /st %ST% /f
+
+if errorlevel 1 (
+    echo [FAIL] Task creation failed. Run as administrator if needed.
+    exit /b 1
+)
+
+echo [OK] Task "QODER-WeeklyUpdate" created (Friday %ST%).
+echo Verify: schtasks /query /tn "QODER-WeeklyUpdate"
+echo Delete: schtasks /delete /tn "QODER-WeeklyUpdate" /f
+echo Log:    .qoder\logs\weekly-update.log

package/templates/qoder/scripts/setup_weekly_cron.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# Set up the Friday 18:00 weekly update on macOS / Linux (cron)
+# Usage: bash .qoder/scripts/setup_weekly_cron.sh
+set -eu
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+RUNNER="$SCRIPT_DIR/run_weekly_update.sh"
+chmod +x "$RUNNER"
+
+CRON_LINE="0 18 * * 5 /bin/bash \"$RUNNER\""
+
+# Install idempotently: remove old entry for this runner, then add
+( crontab -l 2>/dev/null | grep -vF "$RUNNER" ; echo "$CRON_LINE" ) | crontab -
+
+echo "Cron installed: $CRON_LINE"
+echo "Verify: crontab -l"
+echo "Remove: crontab -l | grep -vF \"$RUNNER\" | crontab -"
+echo ""
+echo "Note (macOS): if cron lacks disk access, grant 'Full Disk Access' to"
+echo "/usr/sbin/cron in System Settings, or use launchd instead."