@hupan56/wlkj 2.7.11 → 3.0.0

package/templates/qoder/scripts/{platform_doctor.py → setup/platform_doctor.py}

@@ -1,259 +1,265 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-platform_doctor.py - 跨平台环境自诊断 (任何 OS 跑, 输出环境真相)
-
-为什么需要它:
-  MAC-VERIFY.md 是人工清单, mac 同事跑完如果失败, 反馈信息往往不够定位。
-  本脚本自动收集所有跨平台关键信息, 一次跑完输出结构化报告,
-  同事直接把输出贴回来即可 —— 无需懂代码。
-
-  它在任何 OS (Windows/macOS/Linux) 上行为一致, 显式报告:
-  - 平台 + 架构
-  - python/python3/node/git 是否可用 + 真实路径
-  - 工作流引擎是否完整 (关键脚本在不在)
-  - MCP 各组件就绪状态
-  - 角色配置
-  - 发现的问题 + 修复建议
-
-Usage:
-    python3 .qoder/scripts/platform_doctor.py
-    # 或 mac 上: python3 platform_doctor.py (从包目录跑也行)
-Exit: 0 = 健康, 1 = 有问题
-"""
-import json
-import os
-import platform
-import shutil
-import subprocess
-import sys
-from pathlib import Path
-
-if sys.platform == 'win32':
-    try:
-        sys.stdout.reconfigure(encoding='utf-8')
-    except (AttributeError, IOError):
-        pass
-
-# 定位仓库根 (和 mcp_launcher 同样的多级回退)
-HERE = Path(__file__).resolve().parent
-BASE = None
-for candidate in [HERE.parent.parent, HERE.parent, HERE]:
-    if (candidate / '.qoder' / 'scripts').is_dir():
-        BASE = candidate
-        break
-if BASE is None:
-    BASE = HERE.parent.parent  # 最佳猜测
-
-report = {'platform': {}, 'tools': {}, 'engine': {}, 'mcp': {},
-          'role': {}, 'issues': [], 'verdict': 'UNKNOWN'}
-
-
-def add_issue(level, msg, fix=None):
-    report['issues'].append({'level': level, 'msg': msg, 'fix': fix or ''})
-
-
-def which(cmd):
-    """找命令路径, 返回字符串或 None。"""
-    return shutil.which(cmd)
-
-
-def run(cmd, timeout=8):
-    """跑命令, 返回 (rc, output)。"""
-    try:
-        r = subprocess.run(cmd, capture_output=True, text=True,
-                           encoding='utf-8', errors='replace', timeout=timeout)
-        return r.returncode, (r.stdout or '').strip()
-    except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
-        return 1, ''
-
-
-# ============================================================
-# 1. 平台信息
-# ============================================================
-report['platform'] = {
-    'sys_platform': sys.platform,
-    'platform_system': platform.system(),
-    'machine': platform.machine(),
-    'python_version': sys.version.split()[0],
-    'python_executable': sys.executable,
-}
-plat_name = platform.system()
-is_mac = sys.platform == 'darwin'
-is_win = sys.platform == 'win32'
-print('【平台】 %s %s (sys.platform=%s)' % (
-    plat_name, platform.machine(), sys.platform))
-print('  Python: %s @ %s' % (sys.version.split()[0], sys.executable))
-
-# ============================================================
-# 2. 工具探测 (python/python3/node/git/brew)
-# ============================================================
-print('\n【工具探测】')
-for tool in ['python', 'python3', 'node', 'npm', 'npx', 'git']:
-    if is_mac and tool == 'python':
-        # mac 上 python 通常不存在, 这是正常的
-        pass
-    p = which(tool)
-    ver = ''
-    if p:
-        if tool in ('python', 'python3'):
-            rc, v = run([tool, '--version'])
-            ver = v or '(版本未知)'
-        elif tool in ('node',):
-            rc, v = run([tool, '--version'])
-            ver = v
-        elif tool == 'git':
-            rc, v = run([tool, '--version'])
-            ver = v
-    report['tools'][tool] = {'path': p, 'version': ver}
-    status = '✓ %s' % ver if p else '✗ 未找到'
-    print('  %-8s %s' % (tool, status))
-
-# 关键: python/python3 关系 (mac 验证核心)
-py = which('python')
-py3 = which('python3')
-if is_mac and not py and py3:
-    print('  [mac 正常] python 不存在, python3 可用 (cli.js detectPyCmd 会选 python3)')
-elif not py and not py3:
-    add_issue('CRITICAL', 'python 和 python3 都没找到',
-              'mac: brew install python@3.12; win: 装 Python 勾 Add to PATH')
-elif not py3 and py:
-    add_issue('WARN', '只有 python 没有 python3 (罕见, 一般不影响)')
-
-if is_mac:
-    brew = which('brew')
-    print('  brew:    %s' % (brew or '✗ (装包用: https://brew.sh)'))
-
-# ============================================================
-# 3. 引擎完整性
-# ============================================================
-print('\n【工作流引擎】')
-scripts_dir = BASE / '.qoder' / 'scripts'
-key_scripts = [
-    'setup.py', 'kg.py', 'context_pack.py', 'search_index.py',
-    'mcp_launcher.py', 'install_qoderwork.py', 'role.py',
-    'common/pip_install.py', 'common/events.py', 'common/platform_guard.py',
-    'check_mcp.py', 'check_carriers.py',
-]
-missing_scripts = []
-for s in key_scripts:
-    exists = (scripts_dir / s).is_file()
-    if not exists:
-        missing_scripts.append(s)
-    report['engine'][s] = exists
-
-if missing_scripts:
-    add_issue('CRITICAL', '引擎脚本缺失: %s' % ', '.join(missing_scripts),
-              '跑: npx @hupan56/wlkj update')
-    print('  ✗ 缺失: %s' % ', '.join(missing_scripts))
-else:
-    print('  ✓ %d 个关键脚本齐全' % len(key_scripts))
-
-# 引擎版本
-ver_file = BASE / '.qoder' / '.engine-version'
-if ver_file.is_file():
-    ver = ver_file.read_text(encoding='utf-8').strip()
-    report['engine']['version'] = ver
-    print('  引擎版本: %s' % ver)
-
-# ============================================================
-# 4. MCP 组件
-# ============================================================
-print('\n【MCP 组件】')
-# 4.1 mcp.json
-HOME = Path(os.environ.get('USERPROFILE') or os.path.expanduser('~'))
-mcp_file = HOME / '.qoderwork' / 'mcp.json'
-if mcp_file.is_file():
-    try:
-        cfg = json.loads(mcp_file.read_text(encoding='utf-8'))
-        servers = list(cfg.get('mcpServers', {}).keys())
-        report['mcp']['servers'] = servers
-        print('  mcp.json: %d 个 server (%s)' % (len(servers), ', '.join(servers)))
-    except (ValueError, OSError):
-        add_issue('WARN', 'mcp.json 解析失败', '重跑 install_qoderwork.py --mcp-only')
-        print('  mcp.json: 解析失败')
-else:
-    add_issue('WARN', 'mcp.json 不存在 (QoderWork 未配 MCP)',
-              '跑: python .qoder/scripts/install_qoderwork.py --mcp-only')
-    print('  mcp.json: 不存在')
-
-# 4.2 .repo-root 锚点
-anchor = HOME / '.qoderwork' / '.repo-root'
-if anchor.is_file():
-    root_val = anchor.read_text(encoding='utf-8').strip()
-    is_correct = (Path(root_val) / '.qoder' / 'scripts').is_dir()
-    report['mcp']['repo_root'] = root_val
-    if is_correct:
-        print('  .repo-root: ✓ 指向 %s' % root_val)
-    else:
-        add_issue('CRITICAL', '.repo-root 指向错误目录: %s' % root_val,
-                  '跑: python install_qoderwork.py --mcp-only (会用 PROJECT_ROOT 修复)')
-        print('  .repo-root: ✗ 指向错误 %s' % root_val)
-else:
-    add_issue('WARN', '.repo-root 锚点不存在',
-              '跑: install_qoderwork.py --mcp-only')
-    print('  .repo-root: 不存在')
-
-# 4.3 duckdb (kg MCP 依赖)
-try:
-    import duckdb
-    print('  duckdb: ✓ 已装 (kg MCP 可用)')
-    report['mcp']['duckdb'] = True
-except ImportError:
-    add_issue('CRITICAL', 'duckdb 未装 (kg MCP 会崩)',
-              'pip install duckdb 或 npx wlkj install-env')
-    print('  duckdb: ✗ 未装')
-
-# ============================================================
-# 5. 角色配置
-# ============================================================
-print('\n【角色配置】')
-dev_file = BASE / '.qoder' / '.developer'
-if dev_file.is_file():
-    lines = dev_file.read_text(encoding='utf-8').split('\n')
-    name_l = next((l for l in lines if l.startswith('name=')), '')
-    role_l = next((l for l in lines if l.startswith('role=')), '')
-    name = name_l.split('=', 1)[1].strip() if name_l else '?'
-    role = role_l.split('=', 1)[1].strip() if role_l else 'pm(默认)'
-    report['role'] = {'name': name, 'role': role}
-    print('  开发者: %s' % name)
-    print('  角色: %s' % role)
-    if not role_l:
-        add_issue('INFO', '角色未显式设置 (默认 pm)',
-                  '重跑 init 选角色: npx wlkj init %s <pm|design|dev|test|admin>' % name)
-else:
-    add_issue('CRITICAL', '.developer 不存在 (未初始化)',
-              '跑: npx @hupan56/wlkj init <名字> <角色>')
-    print('  未初始化!')
-
-# ============================================================
-# 6. 总结
-# ============================================================
-criticals = [i for i in report['issues'] if i['level'] == 'CRITICAL']
-warns = [i for i in report['issues'] if i['level'] == 'WARN']
-
-print('\n' + '=' * 56)
-if criticals:
-    print('发现 %d 个严重问题:' % len(criticals))
-    for i in criticals:
-        print('  🔴 %s' % i['msg'])
-        if i['fix']:
-            print('     修复: %s' % i['fix'])
-    report['verdict'] = 'BROKEN'
-elif warns:
-    print('发现 %d 个警告 (非阻塞, 但建议处理):' % len(warns))
-    for i in warns:
-        print('  🟡 %s' % i['msg'])
-        if i['fix']:
-            print('     建议: %s' % i['fix'])
-    report['verdict'] = 'OK_WITH_WARNINGS'
-else:
-    print('✓ 环境健康, 工作流可用。')
-    report['verdict'] = 'HEALTHY'
-print('=' * 56)
-
-# 机器可读报告 (便于同事贴回来)
-print('\n--- 可粘贴报告 (JSON) ---')
-print(json.dumps(report, ensure_ascii=False, indent=2))
-
-sys.exit(1 if criticals else 0)
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# v3.0 路径自举: 引导到 common/bootstrap, 统一 sys.path 逻辑
+import os as _o, sys as _s
+_cp = _o.path.join(_o.path.dirname(_o.path.dirname(_o.path.abspath(__file__))), 'common')
+if _cp not in _s.path: _s.path.insert(0, _cp)
+from bootstrap import setup; setup()
+
+"""
+platform_doctor.py - 跨平台环境自诊断 (任何 OS 跑, 输出环境真相)
+
+为什么需要它:
+  MAC-VERIFY.md 是人工清单, mac 同事跑完如果失败, 反馈信息往往不够定位。
+  本脚本自动收集所有跨平台关键信息, 一次跑完输出结构化报告,
+  同事直接把输出贴回来即可 —— 无需懂代码。
+
+  它在任何 OS (Windows/macOS/Linux) 上行为一致, 显式报告:
+  - 平台 + 架构
+  - python/python3/node/git 是否可用 + 真实路径
+  - 工作流引擎是否完整 (关键脚本在不在)
+  - MCP 各组件就绪状态
+  - 角色配置
+  - 发现的问题 + 修复建议
+
+Usage:
+    python3 .qoder/scripts/platform_doctor.py
+    # 或 mac 上: python3 platform_doctor.py (从包目录跑也行)
+Exit: 0 = 健康, 1 = 有问题
+"""
+import json
+import os
+import platform
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+if sys.platform == 'win32':
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except (AttributeError, IOError):
+        pass
+
+# 定位仓库根 (和 mcp_launcher 同样的多级回退)
+HERE = Path(__file__).resolve().parent
+BASE = None
+for candidate in [HERE.parent.parent, HERE.parent, HERE]:
+    if (candidate / '.qoder' / 'scripts').is_dir():
+        BASE = candidate
+        break
+if BASE is None:
+    BASE = HERE.parent.parent  # 最佳猜测
+
+report = {'platform': {}, 'tools': {}, 'engine': {}, 'mcp': {},
+          'role': {}, 'issues': [], 'verdict': 'UNKNOWN'}
+
+
+def add_issue(level, msg, fix=None):
+    report['issues'].append({'level': level, 'msg': msg, 'fix': fix or ''})
+
+
+def which(cmd):
+    """找命令路径, 返回字符串或 None。"""
+    return shutil.which(cmd)
+
+
+def run(cmd, timeout=8):
+    """跑命令, 返回 (rc, output)。"""
+    try:
+        r = subprocess.run(cmd, capture_output=True, text=True,
+                           encoding='utf-8', errors='replace', timeout=timeout)
+        return r.returncode, (r.stdout or '').strip()
+    except (subprocess.TimeoutExpired, FileNotFoundError, OSError):
+        return 1, ''
+
+
+# ============================================================
+# 1. 平台信息
+# ============================================================
+report['platform'] = {
+    'sys_platform': sys.platform,
+    'platform_system': platform.system(),
+    'machine': platform.machine(),
+    'python_version': sys.version.split()[0],
+    'python_executable': sys.executable,
+}
+plat_name = platform.system()
+is_mac = sys.platform == 'darwin'
+is_win = sys.platform == 'win32'
+print('【平台】 %s %s (sys.platform=%s)' % (
+    plat_name, platform.machine(), sys.platform))
+print('  Python: %s @ %s' % (sys.version.split()[0], sys.executable))
+
+# ============================================================
+# 2. 工具探测 (python/python3/node/git/brew)
+# ============================================================
+print('\n【工具探测】')
+for tool in ['python', 'python3', 'node', 'npm', 'npx', 'git']:
+    if is_mac and tool == 'python':
+        # mac 上 python 通常不存在, 这是正常的
+        pass
+    p = which(tool)
+    ver = ''
+    if p:
+        if tool in ('python', 'python3'):
+            rc, v = run([tool, '--version'])
+            ver = v or '(版本未知)'
+        elif tool in ('node',):
+            rc, v = run([tool, '--version'])
+            ver = v
+        elif tool == 'git':
+            rc, v = run([tool, '--version'])
+            ver = v
+    report['tools'][tool] = {'path': p, 'version': ver}
+    status = '✓ %s' % ver if p else '✗ 未找到'
+    print('  %-8s %s' % (tool, status))
+
+# 关键: python/python3 关系 (mac 验证核心)
+py = which('python')
+py3 = which('python3')
+if is_mac and not py and py3:
+    print('  [mac 正常] python 不存在, python3 可用 (cli.js detectPyCmd 会选 python3)')
+elif not py and not py3:
+    add_issue('CRITICAL', 'python 和 python3 都没找到',
+              'mac: brew install python@3.12; win: 装 Python 勾 Add to PATH')
+elif not py3 and py:
+    add_issue('WARN', '只有 python 没有 python3 (罕见, 一般不影响)')
+
+if is_mac:
+    brew = which('brew')
+    print('  brew:    %s' % (brew or '✗ (装包用: https://brew.sh)'))
+
+# ============================================================
+# 3. 引擎完整性
+# ============================================================
+print('\n【工作流引擎】')
+scripts_dir = BASE / '.qoder' / 'scripts'
+key_scripts = [
+    'setup.py', 'kg.py', 'context_pack.py', 'search_index.py',
+    'mcp_launcher.py', 'install_qoderwork.py', 'role.py',
+    'common/pip_install.py', 'common/events.py', 'common/platform_guard.py',
+    'check_mcp.py', 'check_carriers.py',
+]
+missing_scripts = []
+for s in key_scripts:
+    exists = (scripts_dir / s).is_file()
+    if not exists:
+        missing_scripts.append(s)
+    report['engine'][s] = exists
+
+if missing_scripts:
+    add_issue('CRITICAL', '引擎脚本缺失: %s' % ', '.join(missing_scripts),
+              '跑: npx @hupan56/wlkj update')
+    print('  ✗ 缺失: %s' % ', '.join(missing_scripts))
+else:
+    print('  ✓ %d 个关键脚本齐全' % len(key_scripts))
+
+# 引擎版本
+ver_file = BASE / '.qoder' / '.engine-version'
+if ver_file.is_file():
+    ver = ver_file.read_text(encoding='utf-8').strip()
+    report['engine']['version'] = ver
+    print('  引擎版本: %s' % ver)
+
+# ============================================================
+# 4. MCP 组件
+# ============================================================
+print('\n【MCP 组件】')
+# 4.1 mcp.json
+HOME = Path(os.environ.get('USERPROFILE') or os.path.expanduser('~'))
+mcp_file = HOME / '.qoderwork' / 'mcp.json'
+if mcp_file.is_file():
+    try:
+        cfg = json.loads(mcp_file.read_text(encoding='utf-8'))
+        servers = list(cfg.get('mcpServers', {}).keys())
+        report['mcp']['servers'] = servers
+        print('  mcp.json: %d 个 server (%s)' % (len(servers), ', '.join(servers)))
+    except (ValueError, OSError):
+        add_issue('WARN', 'mcp.json 解析失败', '重跑 install_qoderwork.py --mcp-only')
+        print('  mcp.json: 解析失败')
+else:
+    add_issue('WARN', 'mcp.json 不存在 (QoderWork 未配 MCP)',
+              '跑: python .qoder/scripts/install_qoderwork.py --mcp-only')
+    print('  mcp.json: 不存在')
+
+# 4.2 .repo-root 锚点
+anchor = HOME / '.qoderwork' / '.repo-root'
+if anchor.is_file():
+    root_val = anchor.read_text(encoding='utf-8').strip()
+    is_correct = (Path(root_val) / '.qoder' / 'scripts').is_dir()
+    report['mcp']['repo_root'] = root_val
+    if is_correct:
+        print('  .repo-root: ✓ 指向 %s' % root_val)
+    else:
+        add_issue('CRITICAL', '.repo-root 指向错误目录: %s' % root_val,
+                  '跑: python install_qoderwork.py --mcp-only (会用 PROJECT_ROOT 修复)')
+        print('  .repo-root: ✗ 指向错误 %s' % root_val)
+else:
+    add_issue('WARN', '.repo-root 锚点不存在',
+              '跑: install_qoderwork.py --mcp-only')
+    print('  .repo-root: 不存在')
+
+# 4.3 duckdb (kg MCP 依赖)
+try:
+    import duckdb
+    print('  duckdb: ✓ 已装 (kg MCP 可用)')
+    report['mcp']['duckdb'] = True
+except ImportError:
+    add_issue('CRITICAL', 'duckdb 未装 (kg MCP 会崩)',
+              'pip install duckdb 或 npx wlkj install-env')
+    print('  duckdb: ✗ 未装')
+
+# ============================================================
+# 5. 角色配置
+# ============================================================
+print('\n【角色配置】')
+dev_file = BASE / '.qoder' / '.developer'
+if dev_file.is_file():
+    lines = dev_file.read_text(encoding='utf-8').split('\n')
+    name_l = next((l for l in lines if l.startswith('name=')), '')
+    role_l = next((l for l in lines if l.startswith('role=')), '')
+    name = name_l.split('=', 1)[1].strip() if name_l else '?'
+    role = role_l.split('=', 1)[1].strip() if role_l else 'pm(默认)'
+    report['role'] = {'name': name, 'role': role}
+    print('  开发者: %s' % name)
+    print('  角色: %s' % role)
+    if not role_l:
+        add_issue('INFO', '角色未显式设置 (默认 pm)',
+                  '重跑 init 选角色: npx wlkj init %s <pm|design|dev|test|admin>' % name)
+else:
+    add_issue('CRITICAL', '.developer 不存在 (未初始化)',
+              '跑: npx @hupan56/wlkj init <名字> <角色>')
+    print('  未初始化!')
+
+# ============================================================
+# 6. 总结
+# ============================================================
+criticals = [i for i in report['issues'] if i['level'] == 'CRITICAL']
+warns = [i for i in report['issues'] if i['level'] == 'WARN']
+
+print('\n' + '=' * 56)
+if criticals:
+    print('发现 %d 个严重问题:' % len(criticals))
+    for i in criticals:
+        print('  🔴 %s' % i['msg'])
+        if i['fix']:
+            print('     修复: %s' % i['fix'])
+    report['verdict'] = 'BROKEN'
+elif warns:
+    print('发现 %d 个警告 (非阻塞, 但建议处理):' % len(warns))
+    for i in warns:
+        print('  🟡 %s' % i['msg'])
+        if i['fix']:
+            print('     建议: %s' % i['fix'])
+    report['verdict'] = 'OK_WITH_WARNINGS'
+else:
+    print('✓ 环境健康, 工作流可用。')
+    report['verdict'] = 'HEALTHY'
+print('=' * 56)
+
+# 机器可读报告 (便于同事贴回来)
+print('\n--- 可粘贴报告 (JSON) ---')
+print(json.dumps(report, ensure_ascii=False, indent=2))
+
+sys.exit(1 if criticals else 0)