@hupan56/wlkj 3.1.27 → 3.1.29

package/package.json

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

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

@@ -43,14 +43,21 @@ PY=$(python --version >/dev/null 2>&1 && echo python || echo python3)
 - **建任务**：`create_task` 的 `assignedTo` **默认指派给当前开发者**（从 member.json 的 zentao_account），显式传参才派别人。
 - 隔离红线见 `contracts/isolation.md`「禅道同步」。
 
-### 第 0 步：探测禅道可达性
-调用禅道健康检查（QoderWork: `qw_mcp_call("check_zentao_status", {})` / CLI: `cap.mcp.call("check_zentao_status")`）——内网 + 凭据一道探测：
+### 第 0 步：按操作类型决定要不要探测禅道
+
+禅道工具自带内网/凭据门（不通返回友好提示）。**读类操作直接调，省掉探测往返**：
+
+| 操作类型 | 探测? | 走法 |
+|---------|:----:|------|
+| **读**（看我的活/列任务/看详情/Bug状态） | ❌ 不探测 | 直接 `my_workbench`/`list_my_tasks`/`get_*`，门会兜底 |
+| **写**（create/start/finish/assign/resolve/改/删） | ✅ 探测 | 先 `check_zentao_status`，或写前 `get_*` 确认归属时顺手探，避免写一半断网 |
+| 用户明说"离线/先存本地" | — | 即使可达也走本地模式 |
+
 - **✅ 可达** → 走**禅道模式**（下方各动作的「禅道走法」）
 - **❌ 不可达 / 未配置** → 走**本地模式**（下方各动作的原有 `task.py` 走法，离线兜底，不报错不阻塞）
-- **用户明确说"离线"/"先存本地"** → 即使禅道可达也走本地模式
 
 > 这套判定让禅道有就同步、没内网就静默回退 —— 符合 AGENTS.md「本地数据是唯一事实源、连接器是可选增强、断网不阻塞」原则。
-> 探测本身要 1 次调用。**高频场景（看我的活）可省略探测**：直接 my_workbench，它内部自带内网/凭据门，不通会返回友好提示，不浪费一次往返。
+> ★ 高频的"看我的活"现在是 **1 次调用直达**（旧版 probe + workbench 两次），思考链更短。
 
 ### 列表勾选式交互（禅道模式的统一范式）
 

package/templates/qoder/scripts/capability/smoke_test_report.json

@@ -1,10 +1,10 @@
 {
-  "timestamp": "2026-06-26 21:25:55",
+  "timestamp": "2026-06-29 11:20:28",
   "servers": {
     "qoder-knowledge-graph": {
       "available": true,
       "tools_indexed": 17,
-      "latency_ms": 437.0,
+      "latency_ms": 484.0,
       "sample_tools": [
         "search_code",
         "search_api",
@@ -12,13 +12,13 @@
         "get_impact",
         "context_360"
       ],
-      "spawn_pid": 38616,
+      "spawn_pid": 66880,
       "status": "PASS"
     },
     "qoder-zentao": {
       "available": true,
-      "tools_indexed": 66,
-      "latency_ms": 3657.0,
+      "tools_indexed": 68,
+      "latency_ms": 766.0,
       "sample_tools": [
         "check_zentao_status",
         "get_zentao_url",
@@ -26,13 +26,13 @@
         "get_product",
         "create_product"
       ],
-      "spawn_pid": 11224,
+      "spawn_pid": 48620,
       "status": "PASS"
     },
     "qoder-mysql": {
       "available": true,
       "tools_indexed": 6,
-      "latency_ms": 3484.0,
+      "latency_ms": 609.0,
       "sample_tools": [
         "list_envs",
         "query_schema",
@@ -40,13 +40,13 @@
         "query_distinct",
         "list_databases"
       ],
-      "spawn_pid": 37868,
+      "spawn_pid": 67572,
       "status": "PASS"
     },
     "lanhu": {
       "available": true,
       "tools_indexed": 13,
-      "latency_ms": 3156.0,
+      "latency_ms": 3313.0,
       "sample_tools": [
         "lanhu_resolve_invite_link",
         "lanhu_list_product_documents",
@@ -54,13 +54,13 @@
         "lanhu_get_ai_analyze_page_result",
         "lanhu_get_designs"
       ],
-      "spawn_pid": 36836,
+      "spawn_pid": 32460,
       "status": "PASS"
     }
   },
   "call_tool": {
     "status": "PASS",
-    "latency_ms": 3953.0,
+    "latency_ms": 3547.0,
     "text_preview": "Chinese: 保险 -> English: ins insurance vehlife/insurance\n\n[Carmg-H5] 12 files\n  Carmg-H5/src/.../main/List.vue  ->  data/code/Carmg-H5/src/modules/icsAbnormalCenter/module/main/List.vue\n  Carmg-H5/src/",
     "is_error": false
   },
@@ -89,6 +89,6 @@
     "all_pass": true,
     "active_servers": 4,
     "total_servers": 4,
-    "total_tools": 102
+    "total_tools": 104
   }
 }

package/templates/qoder/scripts/capability/smoke_test_report.json.new

@@ -0,0 +1,94 @@
+{
+  "timestamp": "2026-06-26 21:25:55",
+  "servers": {
+    "qoder-knowledge-graph": {
+      "available": true,
+      "tools_indexed": 17,
+      "latency_ms": 437.0,
+      "sample_tools": [
+        "search_code",
+        "search_api",
+        "search_prd",
+        "get_impact",
+        "context_360"
+      ],
+      "spawn_pid": 38616,
+      "status": "PASS"
+    },
+    "qoder-zentao": {
+      "available": true,
+      "tools_indexed": 66,
+      "latency_ms": 3657.0,
+      "sample_tools": [
+        "check_zentao_status",
+        "get_zentao_url",
+        "list_products",
+        "get_product",
+        "create_product"
+      ],
+      "spawn_pid": 11224,
+      "status": "PASS"
+    },
+    "qoder-mysql": {
+      "available": true,
+      "tools_indexed": 6,
+      "latency_ms": 3484.0,
+      "sample_tools": [
+        "list_envs",
+        "query_schema",
+        "query_data",
+        "query_distinct",
+        "list_databases"
+      ],
+      "spawn_pid": 37868,
+      "status": "PASS"
+    },
+    "lanhu": {
+      "available": true,
+      "tools_indexed": 13,
+      "latency_ms": 3156.0,
+      "sample_tools": [
+        "lanhu_resolve_invite_link",
+        "lanhu_list_product_documents",
+        "lanhu_get_pages",
+        "lanhu_get_ai_analyze_page_result",
+        "lanhu_get_designs"
+      ],
+      "spawn_pid": 36836,
+      "status": "PASS"
+    }
+  },
+  "call_tool": {
+    "status": "PASS",
+    "latency_ms": 3953.0,
+    "text_preview": "Chinese: 保险 -> English: ins insurance vehlife/insurance\n\n[Carmg-H5] 12 files\n  Carmg-H5/src/.../main/List.vue  ->  data/code/Carmg-H5/src/modules/icsAbnormalCenter/module/main/List.vue\n  Carmg-H5/src/",
+    "is_error": false
+  },
+  "memory": {
+    "available": true,
+    "providers": [
+      {
+        "provider": "McpMemoryProvider",
+        "available": true,
+        "hit": true
+      },
+      {
+        "provider": "FileMemoryCap",
+        "available": true,
+        "hit": false
+      },
+      {
+        "provider": "NoOpMemoryCap",
+        "available": false,
+        "hit": false
+      }
+    ],
+    "status": "PASS"
+  },
+  "summary": {
+    "all_pass": true,
+    "active_servers": 4,
+    "total_servers": 4,
+    "total_tools": 102
+  }
+}

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

@@ -485,19 +485,33 @@ def check_index(fix):
     print('\n--- 5. 知识图谱 (data/index/) ---')
     age = index_age_days()
     if age is None:
-        # 完全缺失 -> 需要全量 (唯一允许"重头再来"的情形)
+        # 完全缺失 → 先尝试 team_sync pull 拉管理员建好的 kg.duckdb
+        if fix:
+            print('       索引缺失, 先从团队仓库拉取 (team_sync pull)...')
+            if run_script('team_sync.py', 'pull', timeout=120):
+                # pull 成功, 检查 kg.duckdb 是否拉到了
+                age2 = index_age_days()
+                if age2 is not None:
+                    say(OK, '已从团队仓库拉取知识图谱 ({:.1f} 天前构建)'.format(age2))
+                    actions.append('从团队拉取知识图谱')
+                    return
+                # pull 了但 kg.duckdb 还是没到（管理员还没建过？）
+                print('       team_sync pull 完成, 但 kg.duckdb 未在仓库中')
+            else:
+                say(WARN, 'team_sync pull 失败 (离线? 冲突?)')
+
+        # pull 失败或没拉到 → 降级: 有源码就本地全量构建
         if _has_source_code():
-            # 有源码 → 可以建索引
             if fix:
-                print('       索引缺失, 全量构建 (一次性, 之后都是增量) ...')
+                print('       降级: 本地全量构建 (一次性, 之后都是增量) ...')
                 if run_script('git_sync.py', '--index-only'):
-                    actions.append('全量构建知识图谱')
+                    actions.append('全量构建知识图谱 (本地降级)')
                 else:
                     problem('索引构建失败, 查看上方报错')
             else:
-                problem('知识图谱不存在', '加 --fix 全量构建 (仅首次)')
+                problem('知识图谱不存在', '加 --fix: 先拉团队, 拉不到再本地构建')
         else:
-            # 无源码 → 建不了索引, 醒目告警 (不能只说"先解决第4项", 太含糊)
+            # 无源码 → 建不了索引
             problem('索引缺失且无源码 (data/code/ 为空)',
                     '无法构建知识图谱。看下方"降级状态"说明, 配源码后重跑 init')
         return

package/templates/qoder/scripts/domain/report/report_snapshot.py

@@ -11,6 +11,7 @@ report_snapshot.py — /wl-report 的一次性数据聚合器 (性能优化)
   3. journal/feedback     — 今天的学习/反馈事件
   4. git log --author     — 我的提交 (扫 data/code/ 各项目)
   5. drafts/ + specs/prd  — 我写的 PRD/草稿
+  6. zentao 我的任务      — 禅道真实工时(consumed), 周报"完成任务/工时"用此(可选, 不通降级)
 
 输出: JSON, 缺失的字段标 null 并注明原因。AI 拿到后直接写报告, 不用再探查。
 所有数据严格按 .developer 里的开发者名过滤 (report 的隔离铁律)。
@@ -204,6 +205,83 @@ def _journal_today(repo, author, days):
     return events[:100] if events else []
 
 
+def _f(v):
+    """安全转 float (工时聚合用), 失败返回 0。"""
+    try:
+        return float(v or 0)
+    except (TypeError, ValueError):
+        return 0.0
+
+
+def _zentao_my_tasks(repo, days):
+    """从禅道拉'我的'任务(含真实 consumed 工时), 供周报用。
+
+    周报的"完成任务/工时"应基于禅道真实数据, 而非本地 task.json 缓存
+    (本地缓存常滞后/缺工时)。禅道不通/未配置/未识别身份 → 返回 None,
+    静默降级不阻塞周报 (符合"连接器可选增强、断网不阻塞")。
+    """
+    scripts = os.path.join(repo, ".qoder", "scripts")
+    if scripts not in sys.path:
+        sys.path.insert(0, scripts)
+    try:
+        from foundation.integrations.zentao_client import ZentaoClient
+        from foundation.core.paths import get_developer
+        from foundation.identity.identity import get_member
+    except Exception:
+        return None
+    client = ZentaoClient.from_config()
+    if client is None:
+        return None
+    try:
+        ok, _ = client.check_intranet()
+        if not ok:
+            return None
+        dev = get_developer()
+        my_acc = ""
+        if dev:
+            my_acc = (get_member(dev) or {}).get("zentao_account", "")
+        if not my_acc:
+            return None
+        r = client.api("GET", "/executions", {"limit": 200})
+        if r.status_code not in (200, 201):
+            return None
+        execs = r.json().get("executions") if isinstance(r.json(), dict) else None
+        if not isinstance(execs, list):
+            return None
+        mine = []
+        for e in execs:
+            eid = e.get("id")
+            try:
+                r2 = client.api("GET", "/executions/%s/tasks" % eid, {"limit": 200})
+            except Exception:
+                continue
+            if r2.status_code not in (200, 201):
+                continue
+            tasks = r2.json().get("tasks") if isinstance(r2.json(), dict) else None
+            if not isinstance(tasks, list):
+                continue
+            for t in tasks:
+                if isinstance(t, dict) and ZentaoClient.assignee_account(t) == my_acc:
+                    mine.append({
+                        "id": t.get("id"), "name": str(t.get("name", ""))[:40],
+                        "status": t.get("status"), "consumed": t.get("consumed"),
+                        "estimate": t.get("estimate"), "left": t.get("left"),
+                        "deadline": t.get("deadline"), "execution": e.get("name", ""),
+                    })
+    except Exception:
+        return None
+    done = [x for x in mine if x.get("status") in ("done", "closed")]
+    return {
+        "my_account": my_acc,
+        "total": len(mine),
+        "done_count": len(done),
+        "consumed_hours": round(sum(_f(x.get("consumed")) for x in mine), 1),
+        "estimate_hours": round(sum(_f(x.get("estimate")) for x in mine), 1),
+        "active_items": [x for x in mine if x.get("status") not in ("done", "closed")][:30],
+        "note": "禅道真实工时(非本地缓存); 周报'完成任务/工时'用 consumed_hours",
+    }
+
+
 def snapshot(repo=None, days=None):
     """收集 wl-report 需要的全部数据, 返回 dict。"""
     repo = repo or _repo_root()
@@ -226,12 +304,13 @@ def snapshot(repo=None, days=None):
     # 2-5 四个独立数据源并行采集 (task list 最慢~440ms, 并行后总耗时≈最慢的那个)
     # task list / git log / journal / prds 互不依赖 → 用线程池同时跑, 砍掉串行等待。
     from concurrent.futures import ThreadPoolExecutor
-    with ThreadPoolExecutor(max_workers=4) as pool:
+    with ThreadPoolExecutor(max_workers=5) as pool:
         f_tasks = pool.submit(_run_script, ".qoder/scripts/domain/task/task.py", repo,
                               ["list", "--mine"])
         f_journal = pool.submit(_journal_today, repo, developer, days)
         f_commits = pool.submit(_git_log_for_author, repo, developer, days)
         f_prds = pool.submit(_list_prds_by_author, repo, developer, days)
+        f_zentao = pool.submit(_zentao_my_tasks, repo, days)
 
     task_out, task_ok = f_tasks.result()
     data["my_tasks"] = task_out if task_ok else None
@@ -239,6 +318,7 @@ def snapshot(repo=None, days=None):
     data["journal"] = f_journal.result()
     data["commits"] = f_commits.result()
     data["my_prds"] = f_prds.result()
+    data["zentao_tasks"] = f_zentao.result()  # 禅道真实工时(周报用); None=未连通/未配置
 
     # 6. 报告日期范围 (供 AI 套模板)
     today = datetime.now().strftime("%Y-%m-%d")
@@ -249,11 +329,12 @@ def snapshot(repo=None, days=None):
 
 
 def main():
-    repo = None
-    args = [a for a in sys.argv[1:] if not a.startswith("--")]
-    if args:
-        repo = args[0]
-    data = snapshot(repo)
+    import argparse
+    p = argparse.ArgumentParser(description='wl-report 数据快照 (一次性聚合全部数据源)')
+    p.add_argument('repo', nargs='?', help='仓库根路径 (默认从当前目录向上找 .qoder)')
+    p.add_argument('--days', type=int, default=1, help='回看天数 (默认1=今天/日报; 7=周报)')
+    a = p.parse_args()
+    data = snapshot(a.repo, a.days)
     print(json.dumps(data, ensure_ascii=False, indent=2, default=str))
 
 

package/templates/qoder/scripts/domain/task/team_sync.py

@@ -267,13 +267,45 @@ def _do_pull_locked(quiet, branch):
     """锁内的实际 pull 逻辑。"""
     r = git('pull', '--rebase', '--autostash', 'origin', branch, timeout=90)
     if r.returncode != 0:
+        err = (r.stderr or '') + (r.stdout or '')
         if r.returncode == 124:
             print('Pull 超时 (网络/认证问题): ' + (r.stderr or '').strip()[:150])
             print('检查 git 凭证或团队仓库连通性。继续离线工作, 下次同步自动补推。')
             return 1
-        if 'CONFLICT' in (r.stdout + r.stderr) or rebase_in_progress():
+        if 'CONFLICT' in err or rebase_in_progress():
             return report_conflict(r.stderr or r.stdout)
-        print('Pull failed (network/remote?): ' + (r.stderr or r.stdout).strip()[:200])
+        # ⚠ 常见问题: untracked working tree files would be overwritten
+        # 那台机器上有 init 生成的未跟踪文件 (.gitignore, .qoder/.engine-*),
+        # git pull --rebase 拒绝覆盖。解决: git checkout 先强制覆盖未跟踪文件。
+        if 'untracked working tree files would be overwritten' in err:
+            print('检测到未跟踪文件冲突, 尝试强制覆盖...')
+            # 提取冲突文件名
+            conflict_files = []
+            for line in err.splitlines():
+                line = line.strip()
+                if line and not line.startswith('error:') and not line.startswith('Please'):
+                    conflict_files.append(line)
+            # git checkout -- <files> 强制覆盖
+            if conflict_files:
+                git('checkout', '--', *conflict_files[:50], timeout=30)
+                # 重试 pull
+                r2 = git('pull', '--rebase', '--autostash', 'origin', branch, timeout=90)
+                if r2.returncode == 0:
+                    _auto_resolve_kg_conflict()
+                    touch_pull_marker()
+                    if not quiet:
+                        print('Pulled latest from team (强制覆盖未跟踪文件后成功)。')
+                    return 0
+                print('强制覆盖后仍失败: ' + (r2.stderr or '').strip()[:200])
+            else:
+                # 直接 git checkout -f 强制
+                git('checkout', '-f', 'origin/' + branch, timeout=60)
+                r2 = git('reset', '--hard', 'origin/' + branch, timeout=60)
+                if r2.returncode == 0:
+                    if not quiet:
+                        print('Pulled latest from team (强制重置后成功)。')
+                    return 0
+        print('Pull failed (network/remote?): ' + err.strip()[:200])
         print('继续离线工作, 产出不会丢失, 下次同步会自动补推。')
         return 1
 

package/templates/qoder/scripts/domain/task/zentao_sync.py

@@ -137,7 +137,7 @@ def cmd_pull(args, creds, my_account):
         print('[DRY-RUN] 仅预览, 不写本地。加 --apply 才真写。\n')
 
     r = creds.api('GET', '/executions/%s/tasks' % eid, {'limit': 100})
-    if r.status_code != 200:
+    if r.status_code not in (200, 201):
         print('查询失败: %s %s' % (r.status_code, r.text[:120]))
         return 3
     data = r.json()
@@ -146,9 +146,10 @@ def cmd_pull(args, creds, my_account):
         print('响应格式异常 (无 tasks 列表)。')
         return 3
 
-    # ── 归属硬过滤: 只取 assignedTo == 我 ──
+    # ── 归属硬过滤: 只取 assignedTo == 我 (用 ZentaoClient.assignee_account,
+    #    兼容禅道 assignedTo 返回 dict 的格式; 旧版 str(dict)==account 永远不匹配 → 拉到 0 个) ──
     mine = [t for t in tasks if isinstance(t, dict)
-            and str(t.get('assignedTo', '')) == my_account]
+            and ZentaoClient.assignee_account(t) == my_account]
     skipped = len(tasks) - len(mine)
     print('执行 #%s 共 %d 个任务, 归属我的 %d 个 (跳过队友 %d 个, 不拉)。\n'
           % (eid, len(tasks), len(mine), skipped))
@@ -225,8 +226,8 @@ def cmd_push(args, creds, my_account, developer):
         if zid:
             # 已有 zentao_id → 更新前校验归属一致性
             chk = creds.api('GET', '/tasks/%s' % zid)
-            if chk.status_code == 200:
-                remote_assign = str(chk.json().get('assignedTo', ''))
+            if chk.status_code in (200, 201):
+                remote_assign = ZentaoClient.assignee_account(chk.json())
                 if remote_assign != my_account:
                     print('  🚫 拒绝更新 #%s「%s」: 禅道 assignedTo=%s ≠ 你(%s)'
                           '  (防误改队友任务)' % (zid, title, remote_assign, my_account))

package/templates/qoder/scripts/foundation/integrations/zentao_client.py

@@ -241,3 +241,41 @@ class ZentaoClient:
             return r.json().get('error', r.text[:120])
         except Exception:
             return r.text[:120]
+
+    # ------------------------------------------------------------------
+    # 归属解析 (纯数据提取, sync + mcp 共用 —— 消除 str(dict)==account bug 根因)
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _account_field(item, field: str) -> str:
+        """从 item 提取账号字段 (兼容禅道两种返回格式)。
+
+        禅道 API 的 assignedTo/openedBy 可能是:
+          - dict: {'id':14,'account':'zhengkang','realname':'郑康'} (列表接口常见)
+          - str:  'zhengkang' (详情接口常见)
+          - None/其它: 返回空串
+
+        历史 bug: 旧代码用 ``str(dict)==account`` 比较, dict 被转成
+        ``"{'account':'zhengkang'}"`` 永远 != 'zhengkang' → 归属过滤全失效
+        (sync pull 永远拉 0 个; push 永远误判归属不一致而拒绝更新)。
+        本方法统一取 account 子字段, 是归属判定的唯一真相源。
+        """
+        if not isinstance(item, dict):
+            return ''
+        v = item.get(field)
+        if isinstance(v, dict):
+            return str(v.get('account', ''))
+        if isinstance(v, str):
+            return v
+        return ''
+
+    @staticmethod
+    def assignee_account(item) -> str:
+        """指派人账号 (assignedTo)。task/bug/story 的归属主字段。"""
+        return ZentaoClient._account_field(item, 'assignedTo')
+
+    @staticmethod
+    def openedby_account(item) -> str:
+        """创建人账号 (openedBy)。bug/story 归属的放宽字段
+        (团队习惯提了 bug 不指派, 留在创建人头上)。"""
+        return ZentaoClient._account_field(item, 'openedBy')

package/templates/qoder/scripts/protocol/mcp/mcp_doctor.py

@@ -381,10 +381,22 @@ def find_python_with(mod):
     return None
 
 
+def _find_launcher():
+    """定位 mcp_launcher.py 真实位置。
+
+    launcher 由 QoderWork 安装到用户级 ~/.qoderwork/ (不在仓库内),
+    兼容少数仓库内就近部署的情况。返回 (路径, 是否存在)。
+    """
+    for cand in (QODERWORK_DIR / 'mcp_launcher.py', SCRIPTS_DIR / 'mcp_launcher.py'):
+        if cand.is_file():
+            return cand, True
+    return QODERWORK_DIR / 'mcp_launcher.py', False
+
+
 def test_mcp(name):
     """测试一个 MCP 能否正常响应 initialize."""
-    launcher = SCRIPTS_DIR / 'mcp_launcher.py'
-    if not launcher.is_file():
+    launcher, exists = _find_launcher()
+    if not exists:
         return {'name': name, 'status': 'ERROR',
                 'detail': f'launcher 不存在: {launcher}'}