@hupan56/wlkj 3.0.0 → 3.1.2

package/templates/qoder/scripts/{setup → deployment/setup}/init_doctor.py

@@ -2,7 +2,12 @@
 # -*- 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')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
 
@@ -50,12 +55,12 @@ except (AttributeError, TypeError, OSError, IOError):
     except Exception:
         pass
 
-SCRIPTS_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))  # 子包→scripts根
-sys.path.insert(0, SCRIPTS_DIR)
+from foundation.core.paths import get_repo_root, get_developer, get_developer_info
 
-from common.paths import get_repo_root, get_developer, get_developer_info
+SCRIPTS_DIR = str(get_repo_root())
+sys.path.insert(0, SCRIPTS_DIR)
 
-BASE = str(get_repo_root())
+BASE = SCRIPTS_DIR
 CODE_DIR = os.path.join(BASE, 'data', 'code')
 INDEX_DIR = os.path.join(BASE, 'data', 'index')
 TPL_DIR = os.path.join(BASE, '.qoder', 'templates')
@@ -101,7 +106,7 @@ def run_script(script, *args, timeout=1800):
 def load_config():
     """v3.0: 转发到 Config 单例 (带 mtime 缓存)。"""
     try:
-        from common.config import Config
+        from foundation.core.config import Config
         return Config.load().raw
     except Exception:
         cfg = os.path.join(BASE, '.qoder', 'config.yaml')
@@ -185,11 +190,29 @@ def check_dependencies(fix=False):
         req = os.path.join(BASE, 'requirements.txt')
         if os.path.isfile(req):
             # 用镜像兜底安装: 默认源失败 → 自动切清华/阿里/腾讯
-            from common.pip_install import install_with_fallback
+            # 注意: install_with_fallback 在 Anaconda 3.9+ Windows 上, pip 长时间编译
+            # 退出时偶发 GIL 崩溃 (Python 进程死)。这里 try 兜住: 崩了就用 os.system
+            # 跑裸 pip (独立进程, 无 GIL 问题) 兜底, 绝不让 doctor --fix 卡死。
             print('  → 安装: pip install -r requirements.txt (失败自动切国内镜像)')
-            result = install_with_fallback(['-r', req])
+            result = None
+            try:
+                from foundation.utils.pip_install import install_with_fallback
+                result = install_with_fallback(['-r', req])
+            except Exception as _e:
+                print('  [WARN] 镜像安装工具异常 (%s), 改用直装' % str(_e)[:60])
+            # 工具崩了或返回失败 → 用 os.system 直装 (清华镜像, 独立进程无 GIL 风险)
+            if not result or not result.get('ok'):
+                print('  → 直装: pip install -r requirements.txt (清华镜像)')
+                import subprocess as _sp
+                _rc = _sp.call([sys.executable, '-m', 'pip', 'install', '--no-input',
+                                '--progress-bar', 'off', '-i',
+                                'https://pypi.tuna.tsinghua.edu.cn/simple',
+                                '--trusted-host', 'pypi.tuna.tsinghua.edu.cn',
+                                '-r', req])
+                result = {'ok': _rc == 0, 'source': '清华' if _rc == 0 else None,
+                          'missing': [], 'hint': None}
             if result['ok']:
-                src = result['source']
+                src = result.get('source')
                 say(FIX, '依赖安装成功' + ('' if src == 'default' else ' (镜像源: %s)' % src))
                 # 装完后重新验证 (旧版装完不复查, 会把装失败误报为已装)
                 missing_core = []
@@ -200,7 +223,8 @@ def check_dependencies(fix=False):
                         except ImportError:
                             missing_core.append(pkg)
             else:
-                print('  [MISS] ' + result['hint'])
+                print('  [MISS] 依赖仍未装齐, 手动: pip install -r requirements.txt '
+                      '-i https://pypi.tuna.tsinghua.edu.cn/simple')
                 # 重新验证, 看哪些真的还缺
                 missing_core = []
                 for mod, pkg, usage, is_core in PIP_DEPS:
@@ -246,7 +270,7 @@ def check_developer(fix, name=None, role=None):
         return None
     if name and (not current or current != name):
         if fix:
-            from common.developer import init_developer
+            from foundation.identity.developer import init_developer
             if init_developer(name, role):
                 actions.append('注册/切换开发者: ' + name)
                 return name
@@ -430,11 +454,11 @@ def print_degraded_status():
     print('=' * 56)
     print('  以下功能需要源码, 当前不可用:')
     print('    /wl-search      搜代码 (无源码 = 搜不到)')
-    print('    /wl-prd-full    完整 PRD 的字段/API 锚定 (会跳过, 原型可用)')
+    print('    /wl-prd         完整 PRD 的字段/API 锚定 (会跳过, 原型可用)')
     print('    知识图谱 MCP     search_code/api 等工具 (启动但返回空)')
     print()
     print('  以下功能不依赖源码, 当前可用:')
-    print('    /wl-prd-quick   零星需求 (纯文案/小改动)')
+    print('    /wl-prd         零星需求模式 (纯文案/小改动)')
     print('    /wl-task        任务管理')
     print('    /wl-report      日报周报')
     print('    /wl-commit      代码提交 (提交的是工作流本身的改动)')
@@ -730,7 +754,7 @@ def check_lanhu():
     mcp_file = os.path.join(home, '.qoderwork', 'mcp.json')
     if not os.path.isfile(mcp_file):
         say(WARN, '未配置蓝湖 MCP (团队不用蓝湖可忽略)')
-        print('       用的话跑: python .qoder/scripts/setup.py  或  setup_lanhu.py')
+        print('       用的话跑: python .qoder/scripts/deployment/setup/setup_lanhu.py')
         return
 
     try:
@@ -742,7 +766,7 @@ def check_lanhu():
 
     if 'lanhu' not in servers:
         say(WARN, '未配置蓝湖 MCP (团队不用蓝湖可忽略)')
-        print('       用的话跑: python .qoder/scripts/setup.py  或  setup_lanhu.py')
+        print('       用的话跑: python .qoder/scripts/deployment/setup/setup_lanhu.py')
         return
 
     entry = servers['lanhu']
@@ -818,7 +842,7 @@ def main():
         print('=' * 56)
         return 1
     if _has_source_code():
-        print('环境健康, 可以开始工作: /wl-prd-full <需求描述>')
+        print('环境健康, 可以开始工作: /wl-prd <需求描述>')
     else:
         print('工作流核心已就绪 (见上方降级说明补源码)。')
     print('=' * 56)

package/templates/qoder/scripts/{setup → deployment/setup}/install_qoderwork.py

@@ -1,9 +1,15 @@
 # -*- 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')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
 
 """
 install_qoderwork.py - 把 .qoder/skills/ 安装到 QoderWork 桌面端可识别的位置
@@ -46,7 +52,7 @@ if sys.platform == "win32":
 
 # 路径自检：项目根 = 本文件上四级 (v3.0: setup/ -> scripts/ -> .qoder/ -> repo)
 SCRIPT_DIR = Path(__file__).resolve().parent
-PROJECT_ROOT = SCRIPT_DIR.parent.parent.parent  # v3.0: setup子包多一层
+PROJECT_ROOT = get_repo_root()
 SOURCE_SKILLS_DIR = PROJECT_ROOT / ".qoder" / "skills"
 SOURCE_COMMANDS_DIR = PROJECT_ROOT / ".qoder" / "commands"
 
@@ -416,10 +422,12 @@ def rewrite_mcp_json_for_launcher():
     # 绝对路径每次 install 时探测, 换机器重跑 update 自动刷新。
     # 依赖查找: 先找装了 duckdb 的 python (find_python_with_core_deps),
     # 找不到回退 detect_python_command。
-    try:
-        py_cmd = find_python_with_core_deps()
-    except Exception:
-        py_cmd = detect_python_command() or "python"
+    # ⚠ find_python_with_core_deps 返回 None (不抛异常) 时, 旧代码因 try/except
+    #   捕不到 → py_cmd 留 None → mcp.json 写 "command": null → QoderWork 起 MCP
+    #   失败变黄。这里显式 None 判断 + 多级回退, 绝不写 null。
+    py_cmd = find_python_with_core_deps()
+    if not py_cmd:
+        py_cmd = detect_python_command() or sys.executable or "python"
     launcher = str(_HOME / ".qoderwork" / "mcp_launcher.py")
     # MCP 名 → launcher 子命令
     name_map = {
@@ -496,7 +504,7 @@ def main():
         print("MCP 配置刷新 (--mcp-only)")
         print("=" * 56)
         # 1. 复制 launcher
-        launcher_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "mcp" / "mcp_launcher.py"  # v3.0: mcp子包
+        launcher_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "protocol" / "mcp" / "mcp_launcher.py"  # v3.0: protocol/mcp子包
         launcher_dst = _HOME / ".qoderwork" / "mcp_launcher.py"
         try:
             launcher_dst.parent.mkdir(parents=True, exist_ok=True)
@@ -669,7 +677,7 @@ def main():
     # QoderWork 桌面端工作目录是临时会话目录, 不是仓库根, 相对路径失效。
     # repo_root.py 从 mcp.json 反推仓库根, 命令文件靠它定位脚本/模板。
     if action in ("install", "check"):
-        repo_root_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "setup" / "repo_root.py"  # v3.0: setup子包
+        repo_root_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "deployment" / "setup" / "repo_root.py"  # v3.0: deployment/setup子包
         repo_root_dst = _HOME / ".qoderwork" / "repo_root.py"
         if repo_root_src.is_file():
             if action == "check":
@@ -694,7 +702,7 @@ def main():
     # .repo-root 锚点文件让 launcher 能定位仓库根 (不依赖 mcp.json 里的路径)。
     if action in ("install", "check"):
         print(f"\n--- mcp_launcher.py (统一 MCP 启动器) ---")
-        launcher_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "mcp" / "mcp_launcher.py"  # v3.0: mcp子包
+        launcher_src = SOURCE_COMMANDS_DIR.parent / "scripts" / "protocol" / "mcp" / "mcp_launcher.py"  # v3.0: protocol/mcp子包
         launcher_dst = _HOME / ".qoderwork" / "mcp_launcher.py"
         anchor_dst = _HOME / ".qoderwork" / ".repo-root"
         if action == "check":
@@ -765,7 +773,7 @@ def main():
         elif lh_status == "would-add":
             print(f"  [MISS] 未注册蓝湖 MCP, 安装时会写入 {QODERWORK_MCP_FILE}")
         # STDIO 模式由 QoderWork 自动管, 不查端口; 只确认 wrapper + 源码就绪
-        wrapper = PROJECT_ROOT / ".qoder" / "scripts" / "lanhu_stdio_wrapper.py"
+        wrapper = PROJECT_ROOT / ".qoder" / "scripts" / "protocol" / "mcp" / "lanhu_stdio_wrapper.py"
         lanhu_dir = PROJECT_ROOT / "external" / "lanhu-mcp"
         if wrapper.is_file():
             print(f"  wrapper 就绪: {wrapper.name} (按角色读 cookie)")
@@ -777,8 +785,8 @@ def main():
     if action == "install" and counts["err"] == 0:
         print("\n✓ 安装完成。重启 QoderWork（或新建对话）后技能生效。")
         print("  在 QoderWork 里直接用自然语言即可，例如：")
-        print('    "写个保险异常筛选的 PRD"  -> /wl-prd-full（正经需求）')
-        print('    "列表加个导出按钮"       -> /wl-prd-quick（小改动）')
+        print('    "写个保险异常筛选的 PRD"  -> /wl-prd（正经需求, 完整档）')
+        print('    "列表加个导出按钮"       -> /wl-prd（小改动, 自动走快速档）')
         print('    "查一下考勤代码在哪"      -> /wl-search')
     elif action == "install" and counts["err"] > 0:
         print(f"\n⚠ 有 {counts['err']} 个安装失败，见上方 [ERR] 行。")

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

@@ -2,9 +2,15 @@
 # -*- 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')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
 
 """
 platform_doctor.py - 跨平台环境自诊断 (任何 OS 跑, 输出环境真相)
@@ -49,7 +55,7 @@ for candidate in [HERE.parent.parent, HERE.parent, HERE]:
         BASE = candidate
         break
 if BASE is None:
-    BASE = HERE.parent.parent  # 最佳猜测
+    BASE = get_repo_root()
 
 report = {'platform': {}, 'tools': {}, 'engine': {}, 'mcp': {},
           'role': {}, 'issues': [], 'verdict': 'UNKNOWN'}

package/templates/qoder/scripts/{setup → deployment/setup}/repo_root.py

@@ -1,112 +1,113 @@
-# -*- 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()
-
-"""
-repo_root.py — 自适应定位 QODER 流水线仓库根（QoderWork 桌面端专用）。
-
-为什么需要它:
-  QoderWork 桌面端的工作目录是临时会话目录(workspace/xxx), 不是仓库根。
-  命令文件里的相对路径 .qoder/scripts/xxx.py 全部失效。
-  本脚本从 ~/.qoderwork/mcp.json 的 kg_mcp_server.py 绝对路径反推仓库根,
-  自适应(换机器重装 install 后 mcp.json 会更新, 无需硬编码)。
-
-用法(命令文件里):
-  python ~/.qoderwork/repo_root.py            # 打印仓库根绝对路径
-  python ~/.qoderwork/repo_root.py --script kg.py   # 打印仓库内脚本的绝对路径
-  python ~/.qoderwork/repo_root.py --template prd-quick-template.md
-
-  R=$(python ~/.qoderwork/repo_root.py)       # 在 Bash 里捕获仓库根
-  python "$R/.qoder/scripts/kg.py" context 保险 --platform web
-"""
-import json
-import os
-import sys
-
-
-def find_repo_root():
-    """定位 QODER 仓库根。优先级:
-      1. ~/.qoderwork/.repo-root 文件 (install 时写, 主路径)
-      2. 环境变量 QODER_REPO
-      3. 向上找 .qoder/scripts/ (cwd 在仓库内)
-      4. 本脚本所在位置 (开发态)
-    失败返回 None。
-    """
-    home = os.path.expanduser('~')
-
-    # 方法1: .repo-root 锚点文件 (install_qoderwork 写的, 最可靠)
-    anchor = os.path.join(home, '.qoderwork', '.repo-root')
-    if os.path.isfile(anchor):
-        try:
-            line = open(anchor, encoding='utf-8').read().strip()
-            if line and os.path.isdir(os.path.join(line, '.qoder', 'scripts')):
-                return line
-        except OSError:
-            pass
-
-    # 方法2: 环境变量
-    env_repo = os.environ.get('QODER_REPO')
-    if env_repo and os.path.isdir(os.path.join(env_repo, '.qoder', 'scripts')):
-        return env_repo
-
-    # 方法3: 向上找 .qoder 目录(适用于工作目录在仓库内的情况, 如 IDE)
-    here = os.path.abspath(os.getcwd())
-    for _ in range(8):
-        if os.path.isdir(os.path.join(here, '.qoder', 'scripts')):
-            return here
-        parent = os.path.dirname(here)
-        if parent == here:
-            break
-        here = parent
-
-    # 方法4: 本脚本所在位置(若它被放到仓库 .qoder/scripts/ 下)
-    try:
-        s = os.path.abspath(__file__)
-        root = os.path.dirname(os.path.dirname(os.path.dirname(s)))
-        if os.path.isdir(os.path.join(root, '.qoder', 'scripts')):
-            return root
-    except Exception:
-        pass
-
-    return None
-
-
-def main():
-    root = find_repo_root()
-    if not root:
-        print('ERROR: 无法定位 QODER 仓库根。请确认 ~/.qoderwork/mcp.json 存在且指向有效的 kg_mcp_server.py', file=sys.stderr)
-        return 1
-
-    # 子路径模式: --script / --template
-    args = sys.argv[1:]
-    if args and args[0] in ('--script', '--scripts'):
-        # 打印仓库内 .qoder/scripts/<name> 的绝对路径
-        name = args[1] if len(args) > 1 else ''
-        print(os.path.join(root, '.qoder', 'scripts', name))
-    elif args and args[0] in ('--template', '--templates'):
-        name = args[1] if len(args) > 1 else ''
-        print(os.path.join(root, '.qoder', 'templates', name))
-    elif args and args[0] == '--test':
-        # 自检: 验证关键文件存在
-        checks = [
-            ('kg.py', '.qoder/scripts/kg.py'),
-            ('eval_prd.py', '.qoder/scripts/eval_prd.py'),
-            ('quick模板', '.qoder/templates/prd-quick-template.md'),
-            ('full模板', '.qoder/templates/prd-full-template.md'),
-            ('kg.duckdb', 'data/index/kg.duckdb'),
-        ]
-        print('仓库根: %s' % root)
-        for label, rel in checks:
-            ok = os.path.isfile(os.path.join(root, rel))
-            print('  %s %s' % ('✅' if ok else '❌', label))
-    else:
-        # 默认: 只打印仓库根
-        print(root)
-    return 0
-
-
-if __name__ == '__main__':
-    sys.exit(main())
+# -*- coding: utf-8 -*-
+# repo_root.py — 自适应定位 QODER 流水线仓库根（QoderWork 桌面端专用）。
+#
+# ⚠️ 本文件被 install_qoderwork.py 复制到 ~/.qoderwork/repo_root.py, 在那里它
+# 独立运行 (不依赖仓库内的任何模块)。所以这里**零 import 依赖**——
+# 不能 from bootstrap import (那是仓库内的模块, 定位器不能依赖被定位的东西)。
+# bootstrap 的 sys.path 自举作用对其他被复制脚本有效, 对本定位器是死循环。
+
+"""
+repo_root.py — 自适应定位 QODER 流水线仓库根（QoderWork 桌面端专用）。
+
+为什么需要它:
+  QoderWork 桌面端的工作目录是临时会话目录(workspace/xxx), 不是仓库根。
+  命令文件里的相对路径 .qoder/scripts/xxx.py 全部失效。
+  本脚本从 ~/.qoderwork/mcp.json 的 kg_mcp_server.py 绝对路径反推仓库根,
+  自适应(换机器重装 install 后 mcp.json 会更新, 无需硬编码)。
+
+用法(命令文件里):
+  python ~/.qoderwork/repo_root.py            # 打印仓库根绝对路径
+  python ~/.qoderwork/repo_root.py --script kg.py   # 打印仓库内脚本的绝对路径
+  python ~/.qoderwork/repo_root.py --template prd-quick-template.md
+
+  R=$(python ~/.qoderwork/repo_root.py)       # 在 Bash 里捕获仓库根
+  python "$R/.qoder/scripts/kg.py" context 保险 --platform web
+"""
+import json
+import os
+import sys
+
+
+def find_repo_root():
+    """定位 QODER 仓库根。优先级:
+      1. ~/.qoderwork/.repo-root 文件 (install 时写, 主路径)
+      2. 环境变量 QODER_REPO
+      3. 向上找 .qoder/scripts/ (cwd 在仓库内)
+      4. 本脚本所在位置 (开发态)
+    失败返回 None。
+    """
+    home = os.path.expanduser('~')
+
+    # 方法1: .repo-root 锚点文件 (install_qoderwork 写的, 最可靠)
+    anchor = os.path.join(home, '.qoderwork', '.repo-root')
+    if os.path.isfile(anchor):
+        try:
+            line = open(anchor, encoding='utf-8').read().strip()
+            if line and os.path.isdir(os.path.join(line, '.qoder', 'scripts')):
+                return line
+        except OSError:
+            pass
+
+    # 方法2: 环境变量
+    env_repo = os.environ.get('QODER_REPO')
+    if env_repo and os.path.isdir(os.path.join(env_repo, '.qoder', 'scripts')):
+        return env_repo
+
+    # 方法3: 向上找 .qoder 目录(适用于工作目录在仓库内的情况, 如 IDE)
+    here = os.path.abspath(os.getcwd())
+    for _ in range(8):
+        if os.path.isdir(os.path.join(here, '.qoder', 'scripts')):
+            return here
+        parent = os.path.dirname(here)
+        if parent == here:
+            break
+        here = parent
+
+    # 方法4: 本脚本所在位置(若它被放到仓库 .qoder/scripts/ 下)
+    try:
+        s = os.path.abspath(__file__)
+        root = os.path.dirname(os.path.dirname(os.path.dirname(s)))
+        if os.path.isdir(os.path.join(root, '.qoder', 'scripts')):
+            return root
+    except Exception:
+        pass
+
+    return None
+
+
+def main():
+    root = find_repo_root()
+    if not root:
+        print('ERROR: 无法定位 QODER 仓库根。请确认 ~/.qoderwork/mcp.json 存在且指向有效的 kg_mcp_server.py', file=sys.stderr)
+        return 1
+
+    # 子路径模式: --script / --template
+    args = sys.argv[1:]
+    if args and args[0] in ('--script', '--scripts'):
+        # 打印仓库内 .qoder/scripts/<name> 的绝对路径
+        name = args[1] if len(args) > 1 else ''
+        print(os.path.join(root, '.qoder', 'scripts', name))
+    elif args and args[0] in ('--template', '--templates'):
+        name = args[1] if len(args) > 1 else ''
+        print(os.path.join(root, '.qoder', 'templates', name))
+    elif args and args[0] == '--test':
+        # 自检: 验证关键文件存在
+        checks = [
+            ('kg.py', '.qoder/scripts/domain/kg/kg.py'),
+            ('eval_prd.py', '.qoder/scripts/validation/metrics/eval_prd.py'),
+            ('quick模板', '.qoder/templates/prd-quick-template.md'),
+            ('full模板', '.qoder/templates/prd-full-template.md'),
+            ('kg.duckdb', 'data/index/kg.duckdb'),
+        ]
+        print('仓库根: %s' % root)
+        for label, rel in checks:
+            ok = os.path.isfile(os.path.join(root, rel))
+            print('  %s %s' % ('✅' if ok else '❌', label))
+    else:
+        # 默认: 只打印仓库根
+        print(root)
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main())

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

@@ -2,9 +2,15 @@
 # -*- 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')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
 
 """
 setup.py - 一键就绪 (小而美)
@@ -41,7 +47,7 @@ except (AttributeError, TypeError, OSError):
     pass
 
 THIS_DIR = Path(__file__).resolve().parent
-BASE = THIS_DIR.parent.parent  # repo root
+BASE = get_repo_root()
 
 
 # ============================================================
@@ -641,10 +647,12 @@ def offer_cron(skip=False):
         return
 
     if ask('注册周五 18:00 自动更新知识图谱? (团队只需一台机器注册)', 'y'):
+        # cron 脚本在 scripts/ 根 (THIS_DIR = scripts/deployment/setup/, 上两级)
+        cron_dir = THIS_DIR.parent.parent
         if sys.platform == 'win32':
-            r = run(['cmd', '/c', str(THIS_DIR / 'setup_weekly_cron.bat')], cwd=str(BASE))
+            r = run(['cmd', '/c', str(cron_dir / 'setup_weekly_cron.bat')], cwd=str(BASE))
         else:
-            r = run(['bash', str(THIS_DIR / 'setup_weekly_cron.sh')], cwd=str(BASE))
+            r = run(['bash', str(cron_dir / 'setup_weekly_cron.sh')], cwd=str(BASE))
         if r.returncode == 0:
             ok('cron 已注册 (周五 18:00)')
         else:
@@ -764,13 +772,25 @@ def print_ready(name, role):
         if projects:
             ok(f'源码仓库: {len(projects)} 个项目 ({", ".join(projects[:3])})')
 
-    # 索引
-    ki = BASE / 'data' / 'index' / 'code-keyword.json'
-    if ki.is_file():
+    # 知识图谱 (DuckDB 是唯一事实源; 旧 code-keyword.json 已废弃)
+    kg = BASE / 'data' / 'index' / 'kg.duckdb'
+    if kg.is_file():
         try:
-            import json
-            data = json.loads(ki.read_text(encoding='utf-8'))
-            ok(f'知识图谱: {len(data)} keywords')
+            size_kb = kg.stat().st_size // 1024
+            # 尝试读关键词行数作为"有内容"的证据 (读不到只报大小)
+            kw_n = None
+            try:
+                import duckdb as _ddb
+                con = _ddb.connect(str(kg), read_only=True)
+                row = con.execute('SELECT COUNT(*) FROM keywords').fetchone()
+                con.close()
+                kw_n = row[0] if row else None
+            except Exception:
+                pass
+            if kw_n:
+                ok(f'知识图谱: {kw_n} keywords (kg.duckdb {size_kb} KB)')
+            else:
+                ok(f'知识图谱: kg.duckdb {size_kb} KB')
         except Exception:
             pass
 
@@ -793,7 +813,7 @@ def print_ready(name, role):
 
     print()
     print('  现在可以开始了:')
-    print('    /wl-prd-full 写需求      /wl-search 查代码      /wl-task 建任务')
+    print('    /wl-prd 写需求        /wl-search 查代码      /wl-task 建任务')
     print('    /wl-status 看进度   /wl-report 出日报      /wl-commit 提交')
     print()
     print('  或直接用自然语言:')

package/templates/qoder/scripts/{setup → deployment/setup}/setup_lanhu.py

@@ -2,9 +2,15 @@
 # -*- 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')
+_f = _o.path.abspath(__file__)
+for _ in range(10):
+    _f = _o.path.dirname(_f)
+    _cp = _o.path.join(_f, 'foundation')
+    if _o.path.isfile(_o.path.join(_cp, 'bootstrap.py')):
+        break
 if _cp not in _s.path: _s.path.insert(0, _cp)
 from bootstrap import setup; setup()
+from foundation.core.paths import get_repo_root
 
 """
 setup_lanhu.py - 蓝湖 MCP 引导器 (幂等)
@@ -48,7 +54,7 @@ except (AttributeError, TypeError, OSError):
     pass
 
 THIS_DIR = Path(__file__).resolve().parent
-BASE = THIS_DIR.parent.parent.parent  # repo root (M2子目录化: setup/ → scripts/ → .qoder/ → repo)
+BASE = get_repo_root()
 
 LANHU_REPO = 'https://github.com/dsphper/lanhu-mcp.git'
 EXTERNAL_DIR = BASE / 'external'
@@ -71,7 +77,7 @@ def _current_developer():
     """读 .qoder/.developer 确定当前用户。没有返回 None。"""
     try:
         sys.path.insert(0, str(THIS_DIR))
-        from common.paths import get_developer
+        from foundation.core.paths import get_developer
         return get_developer(BASE)
     except Exception:
         return None
@@ -85,14 +91,14 @@ def lanhu_secrets_dir(developer=None):
     dev = developer or _current_developer() or 'default'
     try:
         sys.path.insert(0, str(BASE / '.qoder' / 'scripts'))
-        from common.paths import get_secrets_dir
+        from foundation.core.paths import get_secrets_dir
         return Path(get_secrets_dir(dev))
     except Exception:
         return BASE / 'workspace' / 'members' / dev / '.secrets'
 
 
 def lanhu_env_file(developer=None):
-    """当前用户的蓝湖 cookie 文件: workspace/members/{dev}/.secrets/lanhu.env"""
+    """当前用户的蓝湖 cookie 文件: workspace/members/{dev}/.private/secrets/lanhu.env"""
     return lanhu_secrets_dir(developer) / 'lanhu.env'
 
 
@@ -349,7 +355,7 @@ def ensure_deps(dry=False, _rebuilt=False):
 
 
 # ============================================================
-# Step 3: cookie (按开发者隔离, workspace/members/{dev}/.secrets/lanhu.env)
+# Step 3: cookie (按开发者隔离, workspace/members/{dev}/.private/secrets/lanhu.env)
 # ============================================================
 # 为什么不放 external/lanhu-mcp/.env:
 #   1. cookie 是个人登录凭证, 不该进仓库代码区 (即使 gitignore)
@@ -378,7 +384,7 @@ def _read_env_cookie(developer=None):
 def _write_env_cookie(cookie, developer=None):
     """把 LANHU_COOKIE 写进当前用户的 lanhu.env (保留其他行)。
 
-    文件: workspace/members/{dev}/.secrets/lanhu.env (已 gitignore)
+    文件: workspace/members/{dev}/.private/secrets/lanhu.env (已 gitignore)
     """
     env_file = lanhu_env_file(developer)
     try: