@hupan56/wlkj 3.1.3 → 3.1.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hupan56/wlkj",
-  "version": "3.1.3",
+  "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/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