@hupan56/wlkj 2.7.12 → 3.0.0

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

@@ -1,106 +1,112 @@
-# -*- coding: utf-8 -*-
-"""
-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 -*-
+# 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())

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

@@ -1,5 +1,11 @@
 #!/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()
+
 """
 setup.py - 一键就绪 (小而美)
 
@@ -23,6 +29,7 @@ setup.py - 一键就绪 (小而美)
 
 import argparse
 import os
+import shutil
 import subprocess
 import sys
 from pathlib import Path
@@ -420,10 +427,78 @@ def _write_team_remote_to_config(url):
         pass
 
 
+def _detect_local_branch(base):
+    """探测当前本地分支名。unborn 分支 (git init 后没 commit) 时,
+    git rev-parse --abbrev-ref HEAD 会报 fatal (exit 128), 必须用 symbolic-ref。
+    不同 git 版本默认分支是 master 或 main, 不能写死。"""
+    r = run(['git', 'symbolic-ref', '--short', 'HEAD'], cwd=str(base))
+    if r.returncode == 0 and r.stdout.strip():
+        return r.stdout.strip()
+    # 兜底 (理论上 symbolic-ref 不会失败, 但稳健起见)
+    r2 = run(['git', 'rev-parse', '--abbrev-ref', 'HEAD'], cwd=str(base))
+    if r2.returncode == 0 and r2.stdout.strip() and r2.stdout.strip() != 'HEAD':
+        return r2.stdout.strip()
+    return 'master'
+
+
+def _backup_local_data(base, remote_branch):
+    """reset --hard 会用远程覆盖整个工作树。开发者可能本地填了 config.yaml 的真实
+    mysql/feishu 密码但没 commit, 直接 reset 会吞掉这些数据。
+    在 reset 前, 把"团队数据文件"里被本地修改过的内容备份到 .wlkj-pre-reset/,
+    reset 后提示用户: 这些是 reset 前的本地版本, 你可能需要把密码重新填回去。
+    引擎文件 (gitignored) 不需要备份 — 反正由 update 重新生成。
+    返回被备份的原始相对路径列表 (用 / 分隔, 与 cli.js JS 版一致)。
+    """
+    backup_dir = base / '.wlkj-pre-reset'
+    backed = []
+    # 只备份团队数据文件 (git 跟踪的关键数据), 不备份引擎。
+    # 用正斜杠统一, 避免跨平台路径分隔符不一致 (Windows os.path.join 用反斜杠)。
+    DATA_FILES = ['.qoder/config.yaml', '.qoder/config.toml', '.qoder/settings.json']
+    backup_dir.mkdir(parents=True, exist_ok=True)
+    try:
+        for rel in DATA_FILES:
+            local = base / rel
+            if not local.is_file():
+                continue
+            try:
+                lc = local.read_text(encoding='utf-8')
+            except Exception:
+                continue
+            # 拿远程版本对比
+            # 注意: MSYS2/Git Bash 会把 'origin/master:path' 里的 / 转成 \ →
+            # 变成 'origin\master;path' 报 ambiguous argument。
+            # 设 MSYS_NO_PATHCONV=1 禁用转换 (Windows 原生 cmd 不受影响)。
+            rshow = run(['git', 'show', f'origin/{remote_branch}:{rel}'],
+                        cwd=str(base),
+                        env={**os.environ, 'MSYS_NO_PATHCONV': '1',
+                             'MSYS2_ARG_CONV_EXCL': '*'})
+            remote_content = rshow.stdout if rshow.returncode == 0 else None
+            # 只在本地与远程不同 (或远程没有) 时备份
+            same = (remote_content is not None and remote_content.strip() == lc.strip())
+            if not same:
+                # 扁平化文件名: .qoder/config.yaml -> .qoder__config.yaml (跨平台)
+                flat = rel.replace('/', '__').replace('\\', '__')
+                target = backup_dir / flat
+                shutil.copy2(str(local), str(target))
+                backed.append(rel)
+    except Exception:
+        pass  # 备份失败不阻塞 reset, 但会少一层保护
+    return backed
+
+
+
 def _setup_tracking(base):
     """git remote add 之后调: fetch 远程 + 设置当前分支的上游 tracking。
     没这步, git pull 会报 "no tracking information for the current branch"。
     fetch 可能因网络/认证失败 — 失败只警告, 不阻塞 (remote 至少配上了)。
+
+    关键修复 (Trellis 化): 如果本地是空的 git init 历史 (没有 commit) 或与远程
+    不相关 (unrelated histories), 就直接 git reset --hard origin/<branch> 采用远程历史。
+    原理: 引擎代码现在由 npm 包生成 (不在 git 里), 团队数据 (config/data/workspace) 在
+    远程 → 本地空历史直接采用远程是唯一正确姿势, 彻底消除 "refusing to merge unrelated
+    histories"。
+    数据安全: reset 前会先把本地修改过的团队数据文件 (config 等) 备份到 .wlkj-pre-reset/,
+    防止开发者未提交的真实密码/配置被远程覆盖丢失。
     """
     # fetch 远程分支
     r = run(['git', 'fetch', 'origin'], cwd=str(base))
@@ -435,9 +510,7 @@ def _setup_tracking(base):
         else:
             warn('git fetch 失败 (不阻塞, 之后 /wl-init 时重试): ' + err[:80])
         return
-    # 确定本地当前分支名
-    br_r = run(['git', 'rev-parse', '--abbrev-ref', 'HEAD'], cwd=str(base))
-    local_branch = br_r.stdout.strip() if br_r.returncode == 0 else 'master'
+
     # 远程有 master 还是 main? 优先 master (团队约定), fallback main
     remote_branch = None
     for cand in ('master', 'main'):
@@ -447,10 +520,46 @@ def _setup_tracking(base):
             break
     if not remote_branch:
         return  # 远程没分支(空仓库), 没法设 tracking, 等 push 后再说
-    # 设置上游 tracking
+
+    # 确定本地当前分支名 (unborn 分支用 symbolic-ref, 不能用 rev-parse)
+    local_branch = _detect_local_branch(base)
+
+    # === 检测本地是否有有效历史 (是否有 commit) ===
+    head_r = run(['git', 'rev-parse', '--verify', 'HEAD'], cwd=str(base))
+    has_local_commit = head_r.returncode == 0
+    # 探测 unrelated histories (即便本地有 commit, 无公共祖先也需采用远程)
+    unrelated = False
+    if has_local_commit:
+        mb_r = run(['git', 'merge-base', local_branch, f'origin/{remote_branch}'], cwd=str(base))
+        unrelated = (mb_r.returncode != 0)
+
+    if not has_local_commit or unrelated:
+        # 本地无有效历史 (git init 没提交过) 或与远程无公共祖先。
+        # 本地这点平行历史无价值 (团队真实历史都在远程) → 采用远程历史。
+        # 但 reset --hard 会覆盖工作树 → 先备份本地改过的团队数据, 防丢密码。
+        if unrelated:
+            warn(f'检测到无关历史 (本地与 origin/{remote_branch} 无公共祖先) — 采用远程历史')
+        backed = _backup_local_data(base, remote_branch)
+        rr = run(['git', 'reset', '--hard', f'origin/{remote_branch}'], cwd=str(base))
+        if rr.returncode == 0:
+            ok(f'已采用远程历史 (origin/{remote_branch})')
+            if backed:
+                warn('reset 前已备份你本地修改过的数据文件 (可能含未提交的真实密码/配置):')
+                for rel in backed:
+                    warn(f'  → .wlkj-pre-reset/{rel.replace("/", "__")}  (reset 前的本地版本)')
+                warn('请检查这些文件, 把需要的配置/密码重新填回 .qoder/config.yaml 后删除备份目录。')
+        else:
+            warn('reset --hard 失败: ' + (rr.stderr or '').strip()[:80])
+        # reset 后本地分支已指向远程 commit, 现在能设上游了
+        run(['git', 'branch', f'--set-upstream-to=origin/{remote_branch}', local_branch], cwd=str(base))
+        return
+
+    # 有公共祖先, 正常设上游
     run(['git', 'branch', f'--set-upstream-to=origin/{remote_branch}', local_branch], cwd=str(base))
 
 
+
+
 def configure_team_remote():
     """配置团队协作仓库的 git remote (workspace/ 产出往这里 push)。