@hupan56/wlkj 3.1.2 → 3.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.1.2",
+  "version": "3.1.4",
   "description": "AI Product R&D Workflow - PRD/Prototype/Search/Task/Report",
   "bin": {
     "wlkj": "bin/cli.js"

package/templates/qoder/commands/optional/wl-insight.md

@@ -23,7 +23,7 @@ User input: $ARGUMENTS
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 

package/templates/qoder/commands/optional/wl-report.md

@@ -14,7 +14,7 @@ User input: $ARGUMENTS
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`；所有仓库内相对路径（workspace/、data/code/）都前置 `"$R/"`。
 
@@ -38,7 +38,7 @@ If no developer is set, refuse and say "Run /wl-init first".
 ### ⚡ Fast Path：一次拿全（必须先跑，禁止逐个 cat/ls/git log）
 
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R"            # 日报(今天)
 python "$R/.qoder/scripts/orchestration/wlkj.py" report-snapshot "$R" --days 7   # 周报(近7天)
 ```

package/templates/qoder/commands/optional/wl-status.md

@@ -14,7 +14,7 @@ User input: $ARGUMENTS (default: show current status)
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`；仓库内相对路径都前置 `"$R/"`。
 

package/templates/qoder/commands/wl-code.md

@@ -14,7 +14,7 @@ User input: $ARGUMENTS
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 

package/templates/qoder/commands/wl-design.md

@@ -120,6 +120,8 @@ cap.mcp.call("context_pack", {"keyword": "<功能名>", "platform": "web"})
 ## 埋点（评审完成后）
 
 评审输出后，记录到 learning：
+> 先定位仓库根 `R`（Mac 只有 python3, 两个都试）:
+> `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.`
 ```bash
 python "$R/.qoder/scripts/orchestration/wlkj.py" learn record review_done "{\"target\":\"$feature\",\"result\":\"$pass_or_issues\"}"
 ```

package/templates/qoder/commands/wl-init.md

@@ -17,7 +17,7 @@ Usage:
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > `repo_root.py` 从 `~/.qoderwork/mcp.json` 反推仓库根；失败回退 `.`（IDE/CLI 工作目录即仓库根）。后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 

package/templates/qoder/commands/wl-prd.md

@@ -43,6 +43,10 @@ User input: $ARGUMENTS
 ``
 
 ### 取上下文（1 次调用取全 8 段）
+先定位仓库根（Mac 只有 python3, 两个都试）:
+``bash
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+``
 ``bash
 python "$R/.qoder/scripts/orchestration/wlkj.py" context <业务词> --platform <web|app>
 ``

package/templates/qoder/commands/wl-req.md

@@ -17,6 +17,9 @@ argument-hint: "[REQ-ID] [发布]"
 
 ## 实现层
 
+> 先定位仓库根 `R`（Mac 只有 python3, 两个都试; 失败回退 `.` 即当前工作目录）:
+> `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.`
+
 ```bash
 # 列需求
 python "$R/.qoder/scripts/orchestration/wlkj.py" req

package/templates/qoder/commands/wl-search.md

@@ -97,6 +97,8 @@ cap.mcp.call("search_code", {"keyword": "--components"})         # 组件使用
 🚫 **绝对禁止**用 `findstr /s`、`grep -r`、`os.walk`、`subprocess` 全盘递归扫 data/code。
 
 **中文文案/报错溯源**（用户查的是中文短语），**唯一合法方式**：
+> 先定位仓库根 `R`（Mac 只有 python3, 两个都试）:
+> `R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.`
 ```bash
 # grep-text 走 CLI 降级（不是 MCP 工具）
 python "$R/.qoder/scripts/orchestration/wlkj.py" kg grep-text 车辆不存在 --ext java --limit 20

package/templates/qoder/commands/wl-task.md

@@ -19,7 +19,7 @@ User input: $ARGUMENTS
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 

package/templates/qoder/commands/wl-test.md

@@ -16,7 +16,7 @@ User input: $ARGUMENTS
 
 **先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
 ```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
+R=$(python ~/.qoderwork/repo_root.py 2>/dev/null || python3 ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
 ```
 > 后续脚本统一用 `python "$R/.qoder/scripts/orchestration/wlkj.py" <命令>`。
 

package/templates/qoder/scripts/deployment/setup/init_doctor.py

@@ -88,16 +88,24 @@ def problem(msg, hint=None):
 
 def run_script(script, *args, timeout=1800):
     """跑另一个脚本, 实时透传输出。
-    v3.0: 支持子目录化 — 先在 scripts/根找, 找不到扫各子包。"""
+
+    v3.x: 脚本已分子目录 (domain/task/, domain/kg/build/, ...), 不再固定在少数子包。
+    用递归 glob 在 scripts/ 下找, 找不到才报错 —— 根治"目录一重组 run_script 就断链"
+    (旧版硬扫 io/setup/kg/build/test 这几个子目录, v3.0 重组后全找不到)。
+    """
+    import glob
+    if not script.endswith('.py'):
+        script = script + '.py'
     # 先试 scripts/根
     cand = os.path.join(SCRIPTS_DIR, script)
     if not os.path.isfile(cand):
-        # 扫各子包
-        for sub in ('io', 'setup', 'kg', 'build', 'test'):
-            c2 = os.path.join(SCRIPTS_DIR, sub, script)
-            if os.path.isfile(c2):
-                cand = c2
-                break
+        # 递归找 scripts/**/<script>
+        hits = glob.glob(os.path.join(SCRIPTS_DIR, '**', script), recursive=True)
+        if hits:
+            cand = hits[0]
+        else:
+            print('[run_script] 找不到脚本: %s (在 scripts/ 下递归也没找到)' % script)
+            return False
     cmd = [sys.executable, cand] + list(args)
     r = subprocess.run(cmd, cwd=BASE, timeout=timeout)
     return r.returncode == 0

package/templates/qoder/scripts/deployment/setup/repo_root.py

@@ -64,11 +64,17 @@ def find_repo_root():
         here = parent
 
     # 方法4: 本脚本所在位置(若它被放到仓库 .qoder/scripts/ 下)
+    # ⚠ 仅当脚本真在 <repo>/.qoder/scripts/ 结构内才成立。
+    #    安装到 ~/.qoderwork/repo_root.py 的副本不能走这步 ——
+    #    s 上三级会解析到用户主目录的父目录(非仓库)。用目录名校验避免误判。
     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
+        s_dir = os.path.dirname(s)
+        # 校验: 本脚本是否真在 .../<repo>/.qoder/scripts/ 内
+        if os.path.basename(s_dir) == 'scripts' and os.path.basename(os.path.dirname(s_dir)) == '.qoder':
+            root = os.path.dirname(os.path.dirname(s_dir))
+            if os.path.isdir(os.path.join(root, '.qoder', 'scripts')):
+                return root
     except Exception:
         pass
 
@@ -78,7 +84,14 @@ def find_repo_root():
 def main():
     root = find_repo_root()
     if not root:
-        print('ERROR: 无法定位 QODER 仓库根。请确认 ~/.qoderwork/mcp.json 存在且指向有效的 kg_mcp_server.py', file=sys.stderr)
+        # 清晰诊断, 不静默 (命令里 R= 回退 '.' 但那常是会话临时目录, 后续脚本全失败)
+        import sys as _sys
+        anchor = os.path.join(os.path.expanduser('~'), '.qoderwork', '.repo-root')
+        _sys.stderr.write('ERROR: repo_root.py 无法定位 QODER 仓库根。\n')
+        _sys.stderr.write('  cwd: %s\n' % os.getcwd())
+        _sys.stderr.write('  锚点 %s 存在? %s\n' % (anchor, os.path.isfile(anchor)))
+        _sys.stderr.write('  修复: 在项目根跑 "npx @hupan56/wlkj init" (写 .repo-root 锚点),\n')
+        _sys.stderr.write('        或设环境变量 QODER_REPO=<项目根>。\n')
         return 1
 
     # 子路径模式: --script / --template

package/templates/qoder/scripts/deployment/setup/setup.py

@@ -658,7 +658,10 @@ def offer_cron(skip=False):
         else:
             warn(f'cron 注册失败: {(r.stderr or "").strip()[:100]}')
     else:
-        print('       跳过。以后可手动跑: python .qoder/scripts/setup_weekly_cron.bat')
+        if sys.platform == 'win32':
+            print('       跳过。以后可手动跑 (双击或命令行): .qoder\\scripts\\setup_weekly_cron.bat')
+        else:
+            print('       跳过。以后可手动跑: bash .qoder/scripts/setup_weekly_cron.sh')
 
 
 # ============================================================