@hupan56/wlkj 3.1.28 → 3.1.30

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

@@ -0,0 +1,331 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+zentao_panel.py - 禅道任务面板数据接口 (供 VS Code 扩展 zentao-panel 调用)
+
+目的: 给侧边栏面板一个稳定的 JSON 数据源, 一次返回"指派给我的【任务+需求+Bug】",
+      跨所有执行/产品全量聚合。逻辑与 my_workbench 工具一致 (只读), 但输出 JSON 而非文本。
+
+为什么不直接调 MCP server:
+  MCP server 的数据收集依赖 import-time 全局变量 (CLIENT / MY_ACCOUNT), 由 mcp_launcher
+  注入环境变量才生效。本脚本走独立进程 (child_process.spawn 启动), 没有 launcher 注入,
+  所以照搬 zentao_sync.py 的稳健模式: 自己 ZentaoClient.from_config() + 自己解析归属。
+  收集循环则与 zentao_mcp_server.py:_collect_my_* 逐字一致 (DRY 同款), 保证数据口径统一。
+
+用法:
+  python .qoder/scripts/domain/task/zentao_panel.py --json              # 三域活动项 JSON
+  python .qoder/scripts/domain/task/zentao_panel.py --json --include-closed  # 含已关闭历史项
+  python .qoder/scripts/domain/task/zentao_panel.py --json --kind tasks   # 只看任务
+
+退出码 (对齐项目规范):
+  0 成功 (含空结果); 3 配置/归属错误; 5 网络不通。
+  --json 模式下错误也输出 JSON ({"ok": false, "error": "..."}), 扩展端统一解析。
+"""
+import os
+import sys
+
+# ── 路径自举 (复用 bootstrap 模式, 与 zentao_sync.py 完全一致) ──
+# 本脚本在 scripts/domain/task/ 下 (scripts 下 2 级), dirname 两次才到 scripts/。
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_SCRIPTS = os.path.dirname(os.path.dirname(_HERE))   # .qoder/scripts (上两级)
+_COMMON = os.path.join(_SCRIPTS, 'foundation')
+for _p in (_SCRIPTS, _COMMON):
+    if _p not in sys.path:
+        sys.path.insert(0, _p)
+try:
+    from bootstrap import setup; setup()
+except Exception:
+    pass
+
+import json
+import argparse
+from datetime import datetime
+
+from foundation.core.paths import get_developer
+from foundation.identity.identity import get_member
+from foundation.integrations.zentao_client import ZentaoClient
+
+
+# ============================================================
+# 配置与归属解析 (照搬 zentao_sync.py, 唯一真相源)
+# ============================================================
+
+def _zentao_creds():
+    """构建禅道客户端。凭据不全返回 None。
+    url 来自 .qoder/config.yaml (团队共享); user/password 来自 secrets/zentao.env (个人)。"""
+    return ZentaoClient.from_config()
+
+
+def _resolve_my_account(developer):
+    """解析当前 developer → 禅道 account。返回 (account, 错误原因)。"""
+    mem = get_member(developer)
+    if not mem:
+        return None, '当前开发者 %s 未注册 (无 member.json)。请先跑 /wl-init。' % developer
+    acc = (mem.get('zentao_account') or '').strip()
+    if not acc:
+        return None, ('%s 的 member.json 未配 zentao_account。\n'
+                      '  编辑 workspace/members/%s/member.json 加 "zentao_account": "你的禅道账号"。'
+                      % (developer, developer))
+    return acc, None
+
+
+# ============================================================
+# 收集循环 (与 zentao_mcp_server.py:_collect_my_* 逐字一致)
+# 单独写成函数, 不依赖 self / 全局 CLIENT, 接收 client 做参数 → 可独立调用。
+# ============================================================
+
+def _paged_list(client, path, params, list_key, page_size=100, max_pages=20):
+    """分页拉全量 (循环 page+limit, 按 id 去重)。照搬 mcp server 同名方法。
+
+    Returns: (合并去重列表, 是否截断[读满 max_pages 仍未到尾])。
+    """
+    seen, all_items = set(), []
+    truncated = False
+    for _page in range(1, max_pages + 1):
+        p = dict(params or {})
+        p.update({'limit': page_size, 'page': _page})
+        r = client.api('GET', path, p)
+        if r.status_code not in (200, 201):
+            break
+        data = r.json()
+        items = data.get(list_key) if isinstance(data, dict) else None
+        if not isinstance(items, list) or not items:
+            break
+        new = 0
+        for it in items:
+            if not isinstance(it, dict):
+                continue
+            key = it.get('id', id(it))
+            if key in seen:
+                continue
+            seen.add(key)
+            all_items.append(it)
+            new += 1
+        if new == 0:
+            break
+    return all_items, truncated
+
+
+def _collect_my_tasks(client, my_account, status_filter=None):
+    """扫所有执行, 收集指派给我的任务。返回 (任务列表, None) 或 (None, 错误)。"""
+    execs, _ = _paged_list(client, '/executions', None, 'executions')
+    if execs is None:
+        return None, '查询执行列表失败, 稍后重试。'
+    all_t = []
+    for e in execs:
+        eid = e.get('id')
+        if eid is None:
+            continue
+        ename = str(e.get('name', ''))[:20]
+        tasks, _ = _paged_list(client, '/executions/%s/tasks' % eid, None, 'tasks')
+        for t in tasks:
+            if not isinstance(t, dict):
+                continue
+            if ZentaoClient.assignee_account(t) != my_account:
+                continue
+            if status_filter and t.get('status') != status_filter:
+                continue
+            t2 = dict(t)
+            t2['execution'] = eid
+            t2['execution_name'] = ename
+            all_t.append(t2)
+    return all_t, None
+
+
+def _collect_my_bugs(client, my_account):
+    """扫活跃产品, 收集我的 Bug (指派给我 OR 我提的)。"""
+    prods, _ = _paged_list(client, '/products', None, 'products')
+    mine = []
+    for p in prods:
+        pid = p.get('id')
+        bugs, _ = _paged_list(client, '/products/%s/bugs' % pid, None, 'bugs')
+        for b in bugs:
+            if not isinstance(b, dict):
+                continue
+            asg = ZentaoClient.assignee_account(b)
+            opn = ZentaoClient.openedby_account(b)
+            why = '指派给我' if asg == my_account else ('我提的' if opn == my_account else None)
+            if why:
+                b2 = dict(b)
+                b2['product_id'] = pid
+                b2['_why'] = why
+                mine.append(b2)
+    return mine, None
+
+
+def _collect_my_stories(client, my_account):
+    """扫活跃产品, 收集我的需求 (指派给我 OR 我提的)。"""
+    prods, _ = _paged_list(client, '/products', None, 'products')
+    mine = []
+    for p in prods:
+        pid = p.get('id')
+        sts, _ = _paged_list(client, '/products/%s/stories' % pid, None, 'stories')
+        for s in sts:
+            if not isinstance(s, dict):
+                continue
+            asg = ZentaoClient.assignee_account(s)
+            opn = ZentaoClient.openedby_account(s)
+            why = '指派给我' if asg == my_account else ('我提的' if opn == my_account else None)
+            if why:
+                s2 = dict(s)
+                s2['product_id'] = pid
+                s2['_why'] = why
+                mine.append(s2)
+    return mine, None
+
+
+# ============================================================
+# 归一化: 把禅道原始 dict 裁成面板需要的精简字段 (减体积 + 隐藏内部字段)
+# ============================================================
+
+def _norm_task(t):
+    return {
+        'id': t.get('id'),
+        'name': str(t.get('name', '')),
+        'status': t.get('status', ''),
+        'pri': t.get('pri'),
+        'left': t.get('left'),          # 剩余工时
+        'estimate': t.get('estimate'),
+        'consumed': t.get('consumed'),
+        'deadline': t.get('deadline'),
+        'execution': t.get('execution'),
+        'execution_name': t.get('execution_name', ''),
+    }
+
+
+def _norm_bug(b):
+    return {
+        'id': b.get('id'),
+        'title': str(b.get('title', '')),
+        'status': b.get('status', ''),
+        'severity': b.get('severity'),
+        'pri': b.get('pri'),
+        'why': b.get('_why', ''),       # 指派给我 / 我提的
+    }
+
+
+def _norm_story(s):
+    return {
+        'id': s.get('id'),
+        'title': str(s.get('title', '')),
+        'status': s.get('status', ''),
+        'pri': s.get('pri'),
+        'why': s.get('_why', ''),
+    }
+
+
+# 活动态白名单 (与 my_workbench 一致 + 修正: changed 也是活动态)。
+# 说明: 禅道 task 有 changed 状态 (需求变更/任务被改动), 旧版 LIVE_TASK 漏掉它
+#       → 用户实测"明明有个进行中的任务却看不到"。changed 不是终态, 应算活动项。
+LIVE_TASK = {'wait', 'doing', 'pause', 'changed'}
+LIVE_BUG = {'active'}
+LIVE_STORY = {'active', 'reviewing', 'changing'}
+
+
+def _filter_live(tasks, bugs, stories, include_closed):
+    """过滤终态 (除非 include_closed)。"""
+    if include_closed:
+        return tasks, bugs, stories
+    return ([t for t in tasks if t.get('status') in LIVE_TASK],
+            [b for b in bugs if b.get('status') in LIVE_BUG],
+            [s for s in stories if s.get('status') in LIVE_STORY])
+
+
+# ============================================================
+# 主流程
+# ============================================================
+
+def fetch_workbench(include_closed=False, kind=None):
+    """收集三域并归一化。返回 (result_dict, exit_code)。
+
+    Args:
+        include_closed: True=含已关闭历史项
+        kind: 'tasks'/'bugs'/'stories' 只取一域; None=全取
+    Returns:
+        ({"ok": True, "data": {...}, "meta": {...}}, 0) 或
+        ({"ok": False, "error": "..."}, 3 或 5)
+    """
+    developer = get_developer()
+
+    # ① 凭据
+    client = _zentao_creds()
+    if client is None:
+        return {'ok': False,
+                'error': '禅道凭据未配置。请检查 .qoder/config.yaml 的 zentao.url, '
+                         '及 workspace/members/<我>/.private/secrets/zentao.env 的账号密码。'}, 3
+
+    ok, msg = client.credentials_ok()
+    if not ok:
+        return {'ok': False, 'error': '禅道凭据不完整: %s' % msg}, 3
+
+    # ② 内网连通
+    ok, msg = client.check_intranet()
+    if not ok:
+        return {'ok': False, 'error': '连不上禅道内网: %s' % msg}, 5
+
+    # ③ 归属
+    my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
+    if not my_account:
+        return {'ok': False, 'error': err}, 3
+
+    # ④ 收集 (按 kind 决定取哪几域)
+    tasks, bugs, stories = [], [], []
+    if kind in (None, 'tasks'):
+        tasks, e = _collect_my_tasks(client, my_account)
+        if e:
+            return {'ok': False, 'error': e}, 5
+    if kind in (None, 'bugs'):
+        bugs, _ = _collect_my_bugs(client, my_account)
+    if kind in (None, 'stories'):
+        stories, _ = _collect_my_stories(client, my_account)
+
+    # ⑤ 过滤 + 归一
+    tasks, bugs, stories = _filter_live(tasks, bugs, stories, include_closed)
+    data = {
+        'account': my_account,
+        'developer': developer,
+        'tasks': [_norm_task(t) for t in tasks],
+        'bugs': [_norm_bug(b) for b in bugs],
+        'stories': [_norm_story(s) for s in stories],
+    }
+    meta = {
+        'fetched_at': datetime.now().isoformat(timespec='seconds'),
+        'counts': {
+            'tasks': len(data['tasks']),
+            'bugs': len(data['bugs']),
+            'stories': len(data['stories']),
+        },
+        'include_closed': include_closed,
+    }
+    return {'ok': True, 'data': data, 'meta': meta}, 0
+
+
+def main():
+    parser = argparse.ArgumentParser(description='禅道任务面板数据接口 (输出 JSON 供 VS Code 扩展消费)')
+    parser.add_argument('--json', action='store_true', help='JSON 输出 (面板默认用这个)')
+    parser.add_argument('--include-closed', action='store_true', help='包含已关闭/取消的历史项 (默认只看活动项)')
+    parser.add_argument('--kind', choices=['tasks', 'bugs', 'stories'],
+                        help='只取某一域 (默认三域全取)')
+    parser.add_argument('--pretty', action='store_true', help='JSON 美化缩进 (默认紧凑, 面板解析更快)')
+    args = parser.parse_args()
+
+    result, code = fetch_workbench(include_closed=args.include_closed, kind=args.kind)
+
+    if args.json or not sys.stdout.isatty():
+        # 面板/管道场景: 一律 JSON (成功/失败统一结构, 扩展端好解析)
+        indent = 2 if args.pretty else None
+        print(json.dumps(result, ensure_ascii=False, default=str, indent=indent))
+    else:
+        # 人类可读 (终端直接跑时, 兜底; 正常都用 --json)
+        if result.get('ok'):
+            d, m = result['data'], result['meta']
+            print('📋 %s 的禅道工作台 — 任务 %d · 需求 %d · Bug %d (更新于 %s)' % (
+                d['account'], m['counts']['tasks'], m['counts']['stories'], m['counts']['bugs'],
+                m['fetched_at']))
+        else:
+            print('❌ %s' % result.get('error', '未知错误'))
+    sys.exit(code)
+
+
+if __name__ == '__main__':
+    main()

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}'}