@hupan56/wlkj 2.0.0

package/templates/qoder/scripts/handoff.py

@@ -0,0 +1,22 @@
+# handoff.py - Handoff management
+import os, json
+from datetime import datetime
+BASE = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+def create_handoff(task_id, from_role, to_role, artifacts, checklist):
+    td = os.path.join(BASE, 'workspace', 'tasks', task_id, 'handoff')
+    os.makedirs(td, exist_ok=True)
+    fname = from_role + '-to-' + to_role + '.json'
+    data = {
+        'task_id': task_id,
+        'from_role': from_role,
+        'to_role': to_role,
+        'artifacts': artifacts,
+        'checklist': [{'item': c, 'status': 'pending'} for c in checklist],
+        'status': 'pending',
+        'created_at': datetime.now().isoformat()
+    }
+    with open(os.path.join(td, fname), 'w') as f:
+        json.dump(data, f, indent=2, ensure_ascii=False)
+    print('OK: handoff ' + from_role + ' -> ' + to_role)
+    return data

package/templates/qoder/scripts/init_developer.py

@@ -0,0 +1,76 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Pipeline - 开发者初始化
+
+Usage:
+    python init_developer.py <developer-name>
+
+功能:
+    - 创建 .qoder/.developer 文件 (gitignored, 包含开发者身份信息)
+    - 创建 .qoder/workspace/<name>/ 目录结构
+    - 创建初始日志文件 journal-1.md
+    - 创建工作空间索引 index.md
+
+参考: Trellis 的 init_developer.py 设计
+
+示例:
+    python .qoder/scripts/init_developer.py zhangsan
+    python .qoder/scripts/init_developer.py john
+"""
+
+from __future__ import annotations
+
+import sys
+import os
+
+# 将 scripts 目录加入路径
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from common.paths import (
+    DIR_WORKFLOW,
+    FILE_DEVELOPER,
+    get_developer,
+    get_repo_root,
+)
+from common.developer import init_developer, show_developer_info
+
+
+def main() -> None:
+    """CLI 入口。"""
+    if len(sys.argv) < 2:
+        print(f"Usage: {sys.argv[0]} <developer-name> [role]")
+        print()
+        print("Example:")
+        print(f"  {sys.argv[0]} zhangsan")
+        print(f"  {sys.argv[0]} zhangsan pm")
+        sys.exit(1)
+
+    name = sys.argv[1]
+    role = sys.argv[2] if len(sys.argv) > 2 else None
+
+    # 检查是否已初始化
+    existing = get_developer()
+    if existing == name:
+        print(f"Developer already initialized: {existing}")
+        print()
+        print("Current developer info:")
+        show_developer_info()
+        sys.exit(0)
+    elif existing:
+        print(f"Switching developer: {existing} -> {name}")
+
+    # 初始化 (幂等, 也用于切换开发者)
+    if init_developer(name, role):
+        print()
+        print("Next steps:")
+        print(f"  1. Your workspace is at: workspace/members/{name}/")
+        print(f"  2. Start creating tasks: python .qoder/scripts/task.py create \"My Task\"")
+        print(f"  3. Check status: python .qoder/scripts/task.py list")
+        sys.exit(0)
+    else:
+        sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()

package/templates/qoder/scripts/init_doctor.py

@@ -0,0 +1,527 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+QODER Init Doctor - 幂等的一站式环境体检 + 按需修复
+
+/wl-init 的引擎。设计原则:
+  - 幂等: 跑一百次和跑一次结果一样, 健康项直接跳过
+  - 增量: 永远不重头再来 —— 索引新鲜(7天内)则跳过, 过期则增量更新,
+          只有索引完全缺失才全量构建
+  - 跨平台: Windows / macOS / Linux 纯 Python 实现
+
+Usage:
+  python init_doctor.py                 # 只体检, 报告问题 (不改任何东西)
+  python init_doctor.py --fix           # 体检 + 自动修复 (拉代码/建索引等)
+  python init_doctor.py --fix 小王 pm    # 同时注册/切换开发者
+
+体检项:
+  1. 基础环境 (python / git)
+  2. 开发者身份 (.qoder/.developer)
+  3. 团队仓库同步 (team_sync pull)
+  4. 源码仓库 (data/code/* 按 config.yaml 克隆)
+  5. 知识图谱新鲜度 (7 天内=健康 / 过期=增量 / 缺失=全量)
+  6. 风格约束 (style-index / vben / chart reference)
+  7. PRD 模板 (docx 源 + 蒸馏 md, docx 更新会提示重新蒸馏)
+  8. 周五自动构建 (检测 + 给出当前系统的设置命令)
+  9. QoderWork 桌面端技能 (可选, 检查 ~/.qoderwork/skills/ 的 junction)
+
+Exit: 0 = 全部健康, 1 = 有问题未修复 (--fix 可修的会自动修)
+"""
+
+import os
+import sys
+import subprocess
+from datetime import datetime, timedelta
+
+# 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
+
+SCRIPTS_DIR = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, SCRIPTS_DIR)
+
+from common.paths import get_repo_root, get_developer, get_developer_info
+
+BASE = str(get_repo_root())
+CODE_DIR = os.path.join(BASE, 'data', 'code')
+INDEX_DIR = os.path.join(BASE, 'data', 'index')
+TPL_DIR = os.path.join(BASE, '.qoder', 'templates')
+PRDTPL_DIR = os.path.join(BASE, 'data', 'docs', 'constitution', 'prdtemplate')
+
+FRESH_DAYS = 7          # 索引多少天内算新鲜
+PULL_STALE_HOURS = 24   # 距上次 pull 超过多少小时建议重新拉
+
+OK, WARN, FIX, BAD = '[OK]  ', '[WARN]', '[FIX] ', '[MISS]'
+
+issues = []     # 未解决的问题
+actions = []    # 本次执行的修复动作
+
+
+def say(tag, msg):
+    print('{} {}'.format(tag, msg))
+
+
+def problem(msg, hint=None):
+    issues.append(msg)
+    say(BAD, msg)
+    if hint:
+        print('       -> ' + hint)
+
+
+def run_script(script, *args, timeout=1800):
+    """跑同目录下的另一个脚本, 实时透传输出"""
+    cmd = [sys.executable, os.path.join(SCRIPTS_DIR, script)] + list(args)
+    r = subprocess.run(cmd, cwd=BASE, timeout=timeout)
+    return r.returncode == 0
+
+
+def load_config():
+    cfg = os.path.join(BASE, '.qoder', 'config.yaml')
+    if not os.path.isfile(cfg):
+        return {}
+    try:
+        import yaml
+        with open(cfg, encoding='utf-8') as f:
+            return yaml.safe_load(f) or {}
+    except Exception:
+        return {}
+
+
+# ============================================================
+# 1. 基础环境
+# ============================================================
+
+def check_basics():
+    print('\n--- 1. 基础环境 ---')
+    say(OK, 'Python {}.{} ({})'.format(sys.version_info[0], sys.version_info[1], sys.platform))
+    # git 可选 (无 git 时核心功能仍可用, 仅团队同步禁用)
+    try:
+        r = subprocess.run(['git', '--version'], capture_output=True, text=True,
+                           encoding='utf-8', errors='replace')
+        if r.returncode == 0:
+            say(OK, r.stdout.strip())
+        else:
+            say(WARN, 'git 不可用 — 团队同步/源码克隆将禁用, 本地功能仍可用')
+    except FileNotFoundError:
+        say(WARN, 'git 未安装 — 团队同步/源码克隆将禁用, 本地 PRD/搜索/任务/报告仍可用')
+
+
+# ============================================================
+# 2. 开发者身份
+# ============================================================
+
+def check_developer(fix, name=None, role=None):
+    print('\n--- 2. 开发者身份 ---')
+
+    # 名字自动探测: 显式参数 > git config user.name > 已注册的 .developer
+    if not name:
+        try:
+            r = subprocess.run(['git', 'config', 'user.name'],
+                               capture_output=True, text=True, encoding='utf-8', errors='replace')
+            git_name = r.stdout.strip() if r.returncode == 0 else ''
+            if git_name:
+                name = git_name
+                print('  (从 git config 探测到名字: {})'.format(name))
+        except Exception:
+            pass
+
+    current = get_developer()
+    if not current and not name:
+        say(WARN, '未设置开发者身份, 也探测不到 git user.name')
+        print('       -> 建议: python .qoder/scripts/setup.py <你的名字>')
+        return None
+    if name and (not current or current != name):
+        if fix:
+            from common.developer import init_developer
+            if init_developer(name, role):
+                actions.append('注册/切换开发者: ' + name)
+                return name
+            problem('开发者初始化失败')
+            return None
+        problem('开发者待注册: ' + name, '加 --fix 自动注册')
+        return None
+    if current:
+        info = get_developer_info() or {}
+        say(OK, '开发者: {} ({})'.format(current, info.get('role', '?')))
+        # 个人空间目录
+        member = os.path.join(BASE, 'workspace', 'members', current)
+        missing = [s for s in ('drafts', 'inbox', 'journal')
+                   if not os.path.isdir(os.path.join(member, s))]
+        if missing:
+            if fix:
+                for s in missing:
+                    os.makedirs(os.path.join(member, s), exist_ok=True)
+                actions.append('补建个人空间子目录: ' + ', '.join(missing))
+            else:
+                problem('个人空间缺少子目录: ' + ', '.join(missing), '加 --fix 自动补建')
+        # git author 一致性 (影响 /wl-report 统计 + 零信任 push 门禁)
+        # git 未安装时跳过此项
+        git_name = ''
+        try:
+            r = subprocess.run(['git', 'config', 'user.name'], cwd=BASE,
+                               capture_output=True, text=True, encoding='utf-8', errors='replace')
+            if r.returncode == 0:
+                git_name = r.stdout.strip()
+        except FileNotFoundError:
+            pass  # 无 git, 跳过 author 一致性
+        if git_name and git_name != current:
+            say(WARN, 'git user.name="{}" 与开发者 "{}" 不一致, /wl-report 统计会查不到, 且 push 门禁会拒绝'.format(git_name, current))
+            if fix:
+                try:
+                    subprocess.run(['git', 'config', '--local', 'user.name', current],
+                                   cwd=BASE, capture_output=True)
+                    import json as _json
+                    mj = os.path.join(BASE, 'workspace', 'members', current, 'member.json')
+                    email_set = None
+                    if os.path.isfile(mj):
+                        with open(mj, encoding='utf-8') as f:
+                            mdata = _json.load(f)
+                        ga = mdata.get('git_author', '')
+                        if '<' in ga and '>' in ga:
+                            email_set = ga[ga.find('<')+1:ga.find('>')].strip()
+                            if email_set:
+                                subprocess.run(['git', 'config', '--local', 'user.email', email_set],
+                                               cwd=BASE, capture_output=True)
+                    say(FIX, 'git config user.name="{}"{} (本仓库)'.format(
+                        current, ' user.email="{}"'.format(email_set) if email_set else ''))
+                    actions.append('修正 git user.name -> {} (本仓库)'.format(current))
+                except Exception as e:
+                    problem('自动修正 git user.name 失败: {}'.format(e),
+                            '手动: git config --local user.name {}'.format(current))
+            else:
+                print('       -> 建议: git config --local user.name {}  (或加 --fix 自动修)'.format(current))
+        return current
+    problem('未注册开发者', '运行 /wl-init <名字> <角色>, 或 init_doctor.py --fix <名字> <角色>')
+    return None
+
+
+# ============================================================
+# 3. 团队仓库同步
+# ============================================================
+
+def check_team_sync(fix):
+    print('\n--- 3. 团队仓库同步 ---')
+    marker = os.path.join(BASE, '.qoder', '.runtime', 'last-pull')
+    stale = True
+    if os.path.isfile(marker):
+        age = datetime.now() - datetime.fromtimestamp(os.path.getmtime(marker))
+        stale = age > timedelta(hours=PULL_STALE_HOURS)
+        if not stale:
+            say(OK, '团队仓库 {:.0f} 小时前已同步'.format(age.total_seconds() / 3600))
+    if stale:
+        if fix:
+            if run_script('team_sync.py', 'pull', timeout=120):
+                actions.append('拉取团队最新产出')
+            else:
+                say(WARN, '团队仓库拉取未成功 (离线? 冲突?), 不影响本地工作')
+        else:
+            say(WARN, '超过 {} 小时未同步团队仓库'.format(PULL_STALE_HOURS) + ', 加 --fix 自动拉取')
+
+
+# ============================================================
+# 4. 源码仓库
+# ============================================================
+
+def check_source_repos(fix, config):
+    print('\n--- 4. 源码仓库 (data/code/) ---')
+    projects = (config.get('git_sync', {}) or {}).get('projects', {}) or {}
+    if not projects:
+        say(WARN, 'config.yaml 未配置 git_sync.projects, 跳过')
+        return
+    os.makedirs(CODE_DIR, exist_ok=True)
+    for name, proj in projects.items():
+        pdir = os.path.join(CODE_DIR, name)
+        if os.path.isdir(os.path.join(pdir, '.git')):
+            say(OK, name)
+            continue
+        url = (proj or {}).get('url')
+        branch = (proj or {}).get('branch')
+        if not url:
+            problem('{} 缺失且无克隆地址'.format(name))
+            continue
+        if fix:
+            print('       克隆 {} ({}) ... 大仓库可能需要几分钟'.format(name, branch or 'default'))
+            cmd = ['git', 'clone', '--single-branch']
+            if branch:
+                cmd += ['-b', branch]
+            cmd += [url, pdir]
+            r = subprocess.run(cmd, cwd=BASE)
+            if r.returncode == 0:
+                actions.append('克隆源码仓库: ' + name)
+            else:
+                problem('{} 克隆失败 (网络/权限?)'.format(name))
+        else:
+            problem('{} 源码缺失'.format(name), '加 --fix 自动克隆 ' + url)
+
+
+# ============================================================
+# 5. 知识图谱新鲜度 (增量的核心逻辑)
+# ============================================================
+
+def index_age_days():
+    """索引年龄: 取 .index-meta.json 的 last_sync, 退化用文件 mtime"""
+    meta_path = os.path.join(INDEX_DIR, '.index-meta.json')
+    ki_path = os.path.join(INDEX_DIR, 'keyword-index.json')
+    if not os.path.isfile(ki_path):
+        return None  # 索引不存在
+    ts = None
+    if os.path.isfile(meta_path):
+        try:
+            import json
+            with open(meta_path, encoding='utf-8') as f:
+                meta = json.load(f)
+            ts = datetime.strptime(meta.get('last_sync', ''), '%Y-%m-%d %H:%M')
+        except Exception:
+            ts = None
+    if ts is None:
+        ts = datetime.fromtimestamp(os.path.getmtime(ki_path))
+    return (datetime.now() - ts).total_seconds() / 86400
+
+
+def check_index(fix):
+    print('\n--- 5. 知识图谱 (data/index/) ---')
+    age = index_age_days()
+    if age is None:
+        # 完全缺失 -> 需要全量 (唯一允许"重头再来"的情形)
+        if fix:
+            if os.path.isdir(CODE_DIR) and os.listdir(CODE_DIR):
+                print('       索引缺失, 全量构建 (一次性, 之后都是增量) ...')
+                if run_script('git_sync.py', '--index-only'):
+                    actions.append('全量构建知识图谱')
+                else:
+                    problem('索引构建失败, 查看上方报错')
+            else:
+                problem('索引缺失且无源码', '先解决第 4 项再重跑')
+        else:
+            problem('知识图谱不存在', '加 --fix 全量构建 (仅首次)')
+        return
+    if age <= FRESH_DAYS:
+        say(OK, '知识图谱 {:.1f} 天前更新过, 新鲜 (阈值 {} 天), 跳过'.format(age, FRESH_DAYS))
+        return
+    # 过期 -> 增量更新 (git pull 变更文件 diff, 不重建)
+    if fix:
+        print('       索引 {:.1f} 天未更新, 增量同步 (只处理变更文件) ...'.format(age))
+        if run_script('git_sync.py'):
+            actions.append('增量更新知识图谱')
+        else:
+            say(WARN, '增量同步有报错, 详见上方 (索引仍可用, 只是可能略旧)')
+    else:
+        say(WARN, '知识图谱 {:.1f} 天未更新'.format(age) + ', 加 --fix 增量同步')
+
+
+# ============================================================
+# 6. 风格约束
+# ============================================================
+
+def check_style(fix):
+    print('\n--- 6. 风格约束 ---')
+    required = {
+        'vben-style-reference.json': 'Web 设计 Token (Vben HSL)',
+        'chart-style-reference.json': '看板/大屏风格先例',
+        'icon-reference.json': '真实图标库 (antd SVG + Vant, 原型禁 emoji)',
+        'style-index.json': 'UI 模式索引 (--style/--field 数据源)',
+        'style-meta.json': '风格摘要 (会话注入)',
+    }
+    missing_buildable = False
+    for fname, desc in required.items():
+        if os.path.isfile(os.path.join(INDEX_DIR, fname)):
+            say(OK, '{} - {}'.format(fname, desc))
+        elif fname in ('style-index.json', 'style-meta.json'):
+            missing_buildable = True
+            if not fix:
+                problem(fname + ' 缺失', '加 --fix 自动构建')
+        else:
+            problem(fname + ' 缺失', '该文件提交在 git 中, 先解决第 3 项团队同步')
+    tpls = ['prototype-web.html', 'prototype-app.html']
+    for t in tpls:
+        if os.path.isfile(os.path.join(TPL_DIR, t)):
+            say(OK, '原型模板 ' + t)
+        else:
+            problem('原型模板缺失: ' + t)
+    if missing_buildable and fix:
+        if os.path.isdir(CODE_DIR) and os.listdir(CODE_DIR):
+            print('       构建风格索引 ...')
+            if run_script('build_style_index.py'):
+                actions.append('构建风格索引')
+        else:
+            problem('风格索引缺源码无法构建', '先解决第 4 项')
+
+
+# ============================================================
+# 7. PRD 模板
+# ============================================================
+
+def check_prd_templates():
+    print('\n--- 7. PRD 模板 + Qoder 载体 ---')
+    pairs = [
+        ('PRD通用模板-纯框架版.docx', 'prd-full-template.md'),
+        ('零星需求PRD简易模板.docx', 'prd-quick-template.md'),
+    ]
+    for docx, md in pairs:
+        docx_path = os.path.join(PRDTPL_DIR, docx)
+        md_path = os.path.join(TPL_DIR, md)
+        has_docx = os.path.isfile(docx_path)
+        has_md = os.path.isfile(md_path)
+        if has_md and has_docx:
+            if os.path.getmtime(docx_path) > os.path.getmtime(md_path):
+                say(WARN, '{} 比蒸馏版 {} 新, 让 AI 重新蒸馏一次'.format(docx, md))
+            else:
+                say(OK, '{} (源: {})'.format(md, docx))
+        elif has_md:
+            say(OK, md + ' (docx 源缺失, 蒸馏版仍可用)')
+        else:
+            problem('PRD 模板缺失: ' + md, '需要 AI 从团队章程 docx 重新蒸馏')
+
+    # Qoder 全系列载体: rules 在 IDE/Quest 生效, AGENTS.md 在 CLI 生效
+    rules_file = os.path.join(BASE, '.qoder', 'rules', 'wl-pipeline.md')
+    if os.path.isfile(rules_file):
+        say(OK, '.qoder/rules/wl-pipeline.md (Qoder IDE/Quest 规则载体)')
+    else:
+        problem('.qoder/rules/wl-pipeline.md 缺失', 'Quest 模式将不知道工作流规则, 从 git 同步取回')
+    if os.path.isfile(os.path.join(BASE, 'AGENTS.md')):
+        say(OK, 'AGENTS.md (Qoder CLI / 其他 Agent 工具载体)')
+    else:
+        problem('AGENTS.md 缺失')
+    wiki = os.path.join(BASE, '.qoder', 'repowiki')
+    if os.path.isdir(wiki):
+        say(OK, '.qoder/repowiki 存在 (Repo Wiki 知识源可用)')
+    else:
+        say(WARN, '未生成 Repo Wiki (可选): Qoder IDE 中触发生成后提交, 团队共享模块级文档')
+
+
+# ============================================================
+# 8. 周五自动构建
+# ============================================================
+
+def check_weekly(fix):
+    print('\n--- 8. 周五自动构建 ---')
+    log = os.path.join(BASE, '.qoder', 'logs', 'weekly-update.log')
+    if os.path.isfile(log):
+        age = (datetime.now() - datetime.fromtimestamp(os.path.getmtime(log))).days
+        if age <= FRESH_DAYS:
+            say(OK, '自动构建 {} 天前运行过'.format(age))
+            return
+        say(WARN, '自动构建日志已 {} 天未更新, 计划任务可能失效'.format(age))
+    else:
+        say(WARN, '未发现自动构建日志 (本机可能未设置周五任务)')
+    print('       本机不是更新机也没关系: 团队中只需一台机器跑周五任务,')
+    print('       其他人 /wl-init 时会自动 git pull 拿到最新图谱。')
+    if sys.platform == 'win32':
+        print('       本机设置(Windows): .qoder\\scripts\\setup_weekly_cron.bat')
+    else:
+        print('       本机设置(macOS/Linux): bash .qoder/scripts/setup_weekly_cron.sh')
+
+
+# ============================================================
+# 9. QoderWork 桌面端技能安装（可选，跨产品族打通）
+# ============================================================
+
+def check_qoderwork():
+    """检查 QoderWork 桌面端是否已安装本项目的技能（junction 到 ~/.qoderwork/skills/）。"""
+    print('\n--- 9. QoderWork 桌面端技能 (可选) ---')
+    src_skills = os.path.join(BASE, '.qoder', 'skills')
+    if not os.path.isdir(src_skills):
+        say(WARN, '.qoder/skills/ 不存在, 跳过 QoderWork 检查')
+        return
+
+    # 数源 skill 个数
+    src_count = sum(
+        1 for d in os.listdir(src_skills)
+        if os.path.isfile(os.path.join(src_skills, d, 'SKILL.md'))
+    )
+    if src_count == 0:
+        say(WARN, '.qoder/skills/ 下无有效 SKILL.md')
+        return
+
+    # QoderWork 目标目录
+    home = os.environ.get('USERPROFILE') or os.environ.get('HOME') or os.path.expanduser('~')
+    qw_dir = os.path.join(home, '.qoderwork', 'skills')
+    if not os.path.isdir(qw_dir):
+        say(WARN, 'QoderWork 未安装技能 ({})'.format(qw_dir))
+        print('       若你用 QoderWork 桌面端, 跑: python .qoder/scripts/install_qoderwork.py')
+        print('       (不用 QoderWork 可忽略此项)')
+        return
+
+    # 数目标里属于本项目的 junction
+    installed = 0
+    not_junction = []
+    for d in os.listdir(qw_dir):
+        src_test = os.path.join(src_skills, d, 'SKILL.md')
+        if not os.path.isfile(src_test):
+            continue  # 不是本项目的 skill
+        link = os.path.join(qw_dir, d)
+        # 检测 reparse point（junction 的标志）
+        try:
+            import stat as _stat
+            st = os.lstat(link)
+            is_reparse = bool(getattr(st, 'st_file_attributes', 0) & 0x400)
+        except (OSError, AttributeError):
+            is_reparse = os.path.islink(link)
+        if is_reparse:
+            installed += 1
+        else:
+            not_junction.append(d)
+
+    if installed == src_count and not not_junction:
+        say(OK, 'QoderWork 技能已安装 ({}/{} junction)'.format(installed, src_count))
+    elif installed > 0:
+        say(WARN, 'QoderWork 技能部分安装 ({}/{})'.format(installed, src_count))
+        print('       重跑同步: python .qoder/scripts/install_qoderwork.py')
+        if not_junction:
+            print('       非 junction 的项目 (可能需人工处理): ' + ', '.join(not_junction))
+        issues.append('QoderWork 技能部分安装')
+    else:
+        say(WARN, 'QoderWork 目录存在但无本项目技能')
+        print('       安装: python .qoder/scripts/install_qoderwork.py')
+
+
+# ============================================================
+# Main
+# ============================================================
+
+def main():
+    args = [a for a in sys.argv[1:]]
+    fix = '--fix' in args
+    pos = [a for a in args if not a.startswith('--')]
+    name = pos[0] if pos else None
+    role = pos[1] if len(pos) > 1 else None
+
+    print('=' * 56)
+    print('QODER Init Doctor  ({} 模式)'.format('体检+修复' if fix else '仅体检'))
+    print('项目: ' + BASE)
+    print('=' * 56)
+
+    config = load_config()
+    check_basics()
+    check_developer(fix, name, role)
+    check_team_sync(fix)
+    check_source_repos(fix, config)
+    check_index(fix)
+    check_style(fix)
+    check_prd_templates()
+    check_weekly(fix)
+    check_qoderwork()
+
+    print('\n' + '=' * 56)
+    if actions:
+        print('本次修复: ')
+        for a in actions:
+            print('  + ' + a)
+    if issues:
+        print('未解决问题 ({}):'.format(len(issues)))
+        for i in issues:
+            print('  - ' + i)
+        print('=' * 56)
+        return 1
+    print('环境健康, 可以开始工作: /wl-prd <需求描述>')
+    print('=' * 56)
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())