@hupan56/wlkj 3.1.31 → 3.2.0

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

@@ -107,17 +107,23 @@ def _paged_list(client, path, params, list_key, page_size=100, max_pages=20):
 
 
 def _collect_my_tasks(client, my_account, status_filter=None):
-    """扫所有执行, 收集指派给我的任务。返回 (任务列表, None) 或 (None, 错误)。"""
+    """扫所有执行, 收集指派给我的任务。返回 (任务列表, None) 或 (None, 错误)。
+
+    性能: 用线程池并行请求各 execution (61 个执行串行要 ~15s, 并行后 ~2-3s)。
+    ZentaoClient 内部 token 有锁但 HTTP 请求本身是 IO, 线程并行安全。
+    """
+    from concurrent.futures import ThreadPoolExecutor
     execs, _ = _paged_list(client, '/executions', None, 'executions')
     if execs is None:
         return None, '查询执行列表失败, 稍后重试。'
-    all_t = []
-    for e in execs:
+
+    def fetch_one(e):
         eid = e.get('id')
         if eid is None:
-            continue
+            return []
         ename = str(e.get('name', ''))[:20]
         tasks, _ = _paged_list(client, '/executions/%s/tasks' % eid, None, 'tasks')
+        out = []
         for t in tasks:
             if not isinstance(t, dict):
                 continue
@@ -128,49 +134,89 @@ def _collect_my_tasks(client, my_account, status_filter=None):
             t2 = dict(t)
             t2['execution'] = eid
             t2['execution_name'] = ename
-            all_t.append(t2)
+            out.append(t2)
+        return out
+
+    all_t = []
+    with ThreadPoolExecutor(max_workers=10) as pool:
+        for batch in pool.map(fetch_one, execs):
+            all_t.extend(batch)
     return all_t, None
 
 
+def _scan_products(client):
+    """获取要扫描的产品 ID 列表。
+
+    关键修复: 禅道 /products 接口实测会漏产品 (团队踩坑: product=3 "ICS 2.0" 真实存在
+    且含 33 个 Bug, 但 /products 列表不返回它 → 逐产品扫描会漏掉全部这些 Bug)。
+    所以这里采用「列表 + 连续 ID 补扫」双保险:
+      1. 先取 /products 列表 (官方口径);
+      2. 再补扫 1..MAX_PRODUCT_ID 范围里列表没返回但真实存在的 (用 /products/{id} 探活)。
+    """
+    listed, _ = _paged_list(client, '/products', None, 'products')
+    listed_ids = set(p.get('id') for p in listed if isinstance(p, dict) and p.get('id') is not None)
+    # 补扫: 列表没覆盖的连续 ID 段 (团队产品数实测 < 20, 给到 30 留余量)
+    MAX_PID = 30
+    for pid in range(1, MAX_PID + 1):
+        if pid in listed_ids:
+            continue
+        r = client.api('GET', '/products/%s' % pid)
+        if r.status_code == 200 and r.json().get('id'):  # 真实存在
+            listed_ids.add(pid)
+    return sorted(listed_ids)
+
+
 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')
+    """扫所有产品 (含 /products 列表漏掉的), 收集**指派给我**的 Bug (并行)。
+
+    v0.5 修复: 旧版只扫 /products 列表返回的产品, 漏掉了 product=3 (列表不返回但含
+    3 个我的 Bug)。改用 _scan_products 双保险覆盖所有真实产品。
+    """
+    from concurrent.futures import ThreadPoolExecutor
+    pids = _scan_products(client)
+
+    def fetch_one(pid):
         bugs, _ = _paged_list(client, '/products/%s/bugs' % pid, None, 'bugs')
+        out = []
         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)
+            if ZentaoClient.assignee_account(b) != my_account:
+                continue
+            b2 = dict(b)
+            b2['product_id'] = pid
+            out.append(b2)
+        return out
+
+    mine = []
+    with ThreadPoolExecutor(max_workers=10) as pool:
+        for batch in pool.map(fetch_one, pids):
+            mine.extend(batch)
     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')
+    """扫所有产品 (含 /products 列表漏掉的), 收集**指派给我**的需求 (并行)。"""
+    from concurrent.futures import ThreadPoolExecutor
+    pids = _scan_products(client)
+
+    def fetch_one(pid):
         sts, _ = _paged_list(client, '/products/%s/stories' % pid, None, 'stories')
+        out = []
         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)
+            if ZentaoClient.assignee_account(s) != my_account:
+                continue
+            s2 = dict(s)
+            s2['product_id'] = pid
+            out.append(s2)
+        return out
+
+    mine = []
+    with ThreadPoolExecutor(max_workers=10) as pool:
+        for batch in pool.map(fetch_one, pids):
+            mine.extend(batch)
     return mine, None
 
 
@@ -178,6 +224,73 @@ def _collect_my_stories(client, my_account):
 # 归一化: 把禅道原始 dict 裁成面板需要的精简字段 (减体积 + 隐藏内部字段)
 # ============================================================
 
+def _detect_code_committed(item_id, title_keywords):
+    """检测代码是否已提交 (git log 搜任务ID或标题关键词)。"""
+    import subprocess
+    try:
+        # 搜任务ID 或 标题前几个关键词
+        patterns = ['#%s' % item_id] + [k for k in title_keywords if len(k) >= 2][:2]
+        for p in patterns:
+            r = subprocess.run(
+                ['git', 'log', '--oneline', '--all', '-1', '--grep=%s' % p],
+                capture_output=True, text=True, timeout=5,
+                cwd=str(_SCRIPTS.parent) if hasattr(_SCRIPTS, 'parent') else None)
+            if r.returncode == 0 and r.stdout.strip():
+                return True
+    except Exception:
+        pass
+    return False
+
+
+def _detect_progress(client, kind, item_id, raw):
+    """检测工作流进度: PRD / Spec / 代码 三节点。
+
+    返回 {'prd': bool, 'spec': str('none'|'draft'|'confirmed'), 'code': bool}
+    - PRD: task 看关联需求spec非空; bug 看steps非空; story 看自身spec非空
+    - Spec: find_spec 找到文件, 读 status
+    - 代码: git log 搜任务ID/关键词
+    """
+    import re as _re
+    from foundation.core.paths import find_spec
+    progress = {'prd': False, 'spec': 'none', 'code': False}
+
+    # PRD 检测
+    try:
+        if kind == 'task':
+            sid = raw.get('story')
+            if sid:
+                sr = client.api('GET', '/stories/%s' % sid)
+                if sr.status_code == 200:
+                    spec = _clean_html(sr.json().get('spec', ''))
+                    progress['prd'] = bool(spec.strip())
+        elif kind == 'bug':
+            steps = _clean_html(raw.get('steps', ''))
+            progress['prd'] = bool(steps.strip())
+        elif kind == 'story':
+            spec = _clean_html(raw.get('spec', ''))
+            progress['prd'] = bool(spec.strip())
+    except Exception:
+        pass
+
+    # Spec 检测 (find_spec 需要 REQ-ID, 但禅道任务没有 REQ-ID, 用任务ID兜底)
+    try:
+        # 禅道任务没有 REQ-ID, find_spec 找不到 → 先查当前任务目录的 spec.md
+        # (大多数情况 spec 在任务目录, 不在全局 specs/)
+        hits = find_spec()  # 查当前任务目录
+        if hits:
+            progress['spec'] = hits[0].get('status', 'draft')
+    except Exception:
+        pass
+
+    # 代码检测 (git log)
+    title = str(raw.get('name', '') or raw.get('title', ''))
+    keywords = _re.split(r'[^\u4e00-\u9fa5a-zA-Z0-9]+', title)
+    keywords = [k for k in keywords if len(k) >= 2][:3]
+    progress['code'] = _detect_code_committed(item_id, keywords)
+
+    return progress
+
+
 def _norm_task(t):
     return {
         'id': t.get('id'),
@@ -190,6 +303,7 @@ def _norm_task(t):
         'deadline': t.get('deadline'),
         'execution': t.get('execution'),
         'execution_name': t.get('execution_name', ''),
+        'story': t.get('story'),        # 关联需求ID (进度检测用)
     }
 
 
@@ -200,7 +314,6 @@ def _norm_bug(b):
         'status': b.get('status', ''),
         'severity': b.get('severity'),
         'pri': b.get('pri'),
-        'why': b.get('_why', ''),       # 指派给我 / 我提的
     }
 
 
@@ -210,7 +323,6 @@ def _norm_story(s):
         'title': str(s.get('title', '')),
         'status': s.get('status', ''),
         'pri': s.get('pri'),
-        'why': s.get('_why', ''),
     }
 
 
@@ -268,25 +380,80 @@ def fetch_workbench(include_closed=False, kind=None):
     if not my_account:
         return {'ok': False, 'error': err}, 3
 
-    # ④ 收集 (按 kind 决定取哪几域)
+    # ④ 收集 (三域并行, 按 kind 决定取哪几域)
+    from concurrent.futures import ThreadPoolExecutor
     tasks, bugs, stories = [], [], []
-    if kind in (None, 'tasks'):
-        tasks, e = _collect_my_tasks(client, my_account)
+
+    def _gather():
+        jobs = {}
+        if kind in (None, 'tasks'):
+            jobs['tasks'] = lambda: _collect_my_tasks(client, my_account)
+        if kind in (None, 'bugs'):
+            jobs['bugs'] = lambda: _collect_my_bugs(client, my_account)
+        if kind in (None, 'stories'):
+            jobs['stories'] = lambda: _collect_my_stories(client, my_account)
+        results = {}
+        with ThreadPoolExecutor(max_workers=3) as pool:
+            futs = {pool.submit(fn): k for k, fn in jobs.items()}
+            for fut in futs:
+                results[futs[fut]] = fut.result()
+        return results
+
+    res = _gather()
+    if 'tasks' in res:
+        tasks, e = res['tasks']
         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)
+    if 'bugs' in res:
+        bugs, _ = res['bugs']
+    if 'stories' in res:
+        stories, _ = res['stories']
 
-    # ⑤ 过滤 + 归一
+    # ⑤ 过滤 + 归一 + 进度检测
     tasks, bugs, stories = _filter_live(tasks, bugs, stories, include_closed)
+
+    # 进度检测 (并行, 只对前12个检测避免过多请求)
+    from concurrent.futures import ThreadPoolExecutor
+
+    def _add_progress(kind, items, raws):
+        if not items:
+            return
+        # raws 和 items 按顺序对应 (都来自同一批过滤后数据)
+        def detect_one(idx):
+            try:
+                p = _detect_progress(client, kind, items[idx]['id'], raws[idx])
+                items[idx]['progress'] = p
+            except Exception:
+                items[idx]['progress'] = {'prd': False, 'spec': 'none', 'code': False}
+        with ThreadPoolExecutor(max_workers=6) as pool:
+            list(pool.map(detect_one, range(min(len(items), 12))))
+        # 超过12个的不检测, 给默认值
+        for i in range(12, len(items)):
+            items[i]['progress'] = {'prd': False, 'spec': 'none', 'code': False}
+
+    norm_tasks = [_norm_task(t) for t in tasks]
+    norm_bugs = [_norm_bug(b) for b in bugs]
+    norm_stories = [_norm_story(s) for s in stories]
+    _add_progress('task', norm_tasks, tasks)
+    _add_progress('bug', norm_bugs, bugs)
+
+    # 当前任务 (工作流的 .current-task 机制)
+    current_task = None
+    try:
+        from foundation.core.paths import get_current_task
+        ct = get_current_task()
+        if ct:
+            current_task = str(ct)
+    except Exception:
+        pass
+
     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],
+        'current_task': current_task,
+        'tasks': norm_tasks,
+        'bugs': norm_bugs,
+        'stories': norm_stories,
     }
     meta = {
         'fetched_at': datetime.now().isoformat(timespec='seconds'),
@@ -354,7 +521,7 @@ def _do_action(client, my_account, action, item_id, params):
     if guard:
         return {'ok': False, 'error': guard}, 4
 
-    # ② 拼 payload (只取该操作关心的字段, 缺省给合理默认)
+    # ② 拼 payload (只取该操作关心的字段)
     payload = {}
     for pkey, fkey in fields.items():
         v = params.get(fkey)
@@ -363,11 +530,35 @@ def _do_action(client, my_account, action, item_id, params):
                 payload[pkey] = float(v) if fkey in ('left', 'consumed') else v
             except (ValueError, TypeError):
                 payload[pkey] = v
-    # finish 强制 left=0 (完成=没剩余工时); log_effort 的 consumed 必填兜底
-    if action == 'finish_task' and 'left' not in payload:
-        payload['left'] = 0
-    if action == 'resolve_bug' and 'resolution' not in payload:
+
+    # ③ 各操作的必填字段兜底 (实测禅道校验)
+    today = datetime.now().strftime('%Y-%m-%d')
+    if action == 'finish_task':
+        # 实测: finish 必须带 finishedDate ("实际完成"日期), 否则 400
+        payload.setdefault('left', 0)
+        payload.setdefault('finishedDate', today)
+    elif action == 'start_task':
+        # 实测禅道: start 不允许 "总计消耗=0 且 预计剩余=0" (报 400)。
+        # 策略: 用户填了 left 就用; 没填则查任务的 estimate(预计工时) 兜底;
+        # estimate 也没有 → 返回友好错误让用户填, 不传 0 撞 400。
+        if 'left' not in payload or payload.get('left') == 0:
+            # 查任务详情拿 estimate
+            try:
+                td = client.api('GET', '/tasks/%s' % item_id).json()
+                est = td.get('estimate') or 0
+            except Exception:
+                est = 0
+            if est and est > 0:
+                payload['left'] = float(est)
+            elif not payload.get('consumed'):
+                return {'ok': False, 'error': '开始任务需要填剩余工时（禅道不允许剩余=0）。请在弹框里填一个预估工时，如 8。'}, 3
+    elif action == 'log_effort' and 'consumed' not in payload:
+        return {'ok': False, 'error': '记工时必须填消耗工时。'}, 3
+    elif action == 'resolve_bug' and 'resolution' not in payload:
         payload['resolution'] = 'fixed'
+    elif action == 'confirm_bug':
+        # 确认Bug 部分禅道版本要 assignedTo, 确保认领到自己头上
+        payload.setdefault('assignedTo', my_account)
 
     # ③ 调禅道
     r = client.api(method, path, payload)
@@ -400,12 +591,413 @@ def perform_action(action, item_id, params=None):
     return _do_action(client, my_account, action, item_id, params)
 
 
+# ============================================================
+# 提示词增强 (v0.6): 发AI前用知识图谱拉相关代码/API/字段
+# 策略: 调 context_pack.py 拿结构化上下文 → 拼进提示词。
+#       查不到/超时 → 静默降级返回基础提示词 (永远不阻塞「发AI」)。
+# ============================================================
+
+# 停用词: 任务标题里这些词不该拿去查知识图谱 (噪音太大)
+_STOPWORDS = set('的 了 和 与 或 及 及 以 在 为 对 从 给 把 被 让 用 : ： （ ） ( ) - — , ， . 。 / 新增 修改 优化 问题 异常 无法 不能 报错'.split())
+
+
+def _extract_keywords(title):
+    """从任务/Bug 标题提取业务关键词。
+
+    策略: 按 、，。:等分隔符切块 → 去停用词 → 长串按2-4字滑窗拆出业务词。
+    例: "车辆年检、保险延期终止申请关联异常生成优化"
+        → ['车辆年检','年检','保险','延期','终止','申请','关联','异常','生成']
+    """
+    if not title:
+        return []
+    import re
+    # 去掉 #id、数字编号、【】
+    clean = re.sub(r'#\d+|【.*?】|\d{4,}', ' ', title)
+    # 按标点/符号切分成短语块
+    chunks = re.split(r'[^\u4e00-\u9fa5a-zA-Z0-9]+', clean)
+    kws = []
+    for chunk in chunks:
+        chunk = chunk.strip()
+        if not chunk or chunk in _STOPWORDS or chunk.isdigit():
+            continue
+        if len(chunk) <= 4:
+            # 短块直接用 (如 "保险" "年检")
+            kws.append(chunk)
+        elif re.match(r'^[\u4e00-\u9fa5]+$', chunk):
+            # 纯中文长块: 2-4字滑窗拆出所有业务词 (如"保险延期终止"→保险/险延/延期/期终/终止)
+            # 但只保留 2-4 字的常见业务词长度, 去掉无意义组合
+            for size in (2, 3, 4):
+                for i in range(len(chunk) - size + 1):
+                    w = chunk[i:i+size]
+                    if w not in _STOPWORDS:
+                        kws.append(w)
+        else:
+            kws.append(chunk)
+    # 去重保序
+    seen, out = set(), []
+    for k in kws:
+        if k not in seen:
+            seen.add(k)
+            out.append(k)
+    return out[:6]  # 多取一些, 合并查询时去重
+
+
+# 噪音文件: 这些通用文件命中了也不该推荐 (路由表/测试入口/通用配置, 不是业务实现)
+_NOISE_PATTERNS = [
+    '/router/routes/', 'module/mList/', 'module/ips/main.vue',
+    '/common/core/exception/', 'enum', 'constant.java', 'core.ts',
+    'Application.java', 'main.vue', 'List.vue', 'index.vue',
+]
+
+
+def _is_noise(filepath):
+    """判断代码文件是否是噪音 (路由/测试/通用文件, 非业务实现)。"""
+    fp = filepath.lower()
+    return any(p.lower() in fp for p in _NOISE_PATTERNS)
+
+
+def _guess_platform(scene_name):
+    """从执行名/场景名推断 platform。
+    execution 名形如 '20260702后端'/'20260702前端'/'20260702移动端'。
+    返回 'web'/'app' 或 None(后端代码不按端过滤)。
+    """
+    if not scene_name:
+        return None
+    if '前端' in scene_name or 'PC' in scene_name or '管理端' in scene_name:
+        return 'web'
+    if '移动端' in scene_name or 'APP' in scene_name.upper() or 'H5' in scene_name.upper():
+        return 'app'
+    return None  # 后端: 知识图谱不过滤 platform (fywl-ics 后端代码)
+
+
+def _query_kg_context(keyword, platform=None):
+    """调 context_pack.py 拉单个关键词的上下文。带超时, 失败返回空dict。
+    platform: 'web'/'app' 过滤代码库 (前端=fywl-ui, 移动端=Carmg-H5); None=不过滤(含后端)。
+    """
+    import subprocess
+    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'search', 'context_pack.py')
+    if not os.path.isfile(script):
+        return {}
+    cmd = ['python', script, keyword]
+    if platform in ('web', 'app'):
+        cmd += ['--platform', platform]
+    try:
+        r = subprocess.run(
+            cmd, capture_output=True, text=True, timeout=15, encoding='utf-8', errors='replace')
+        return _parse_context_pack(r.stdout, keyword)
+    except subprocess.TimeoutExpired:
+        return {}  # 知识图谱查询超时, 静默降级
+    except Exception:
+        return {}
+
+
+def _parse_context_pack(text, keyword):
+    """从 context_pack 的文本输出里提取代码/API/字段三类信息 (精简版)。"""
+    if not text:
+        return {}
+    import re
+    result = {'code_files': [], 'apis': [], 'fields': []}
+    lines = text.split('\n')
+    section = None
+    for line in lines:
+        # 识别段落标题
+        if '相关代码文件' in line:
+            section = 'code'; continue
+        elif '相关 API' in line:
+            section = 'api'; continue
+        elif '相关字段' in line:
+            section = 'field'; continue
+        elif line.startswith('## '):
+            section = None; continue
+        # 提取条目
+        if not section:
+            continue
+        m = re.match(r'-\s+(?:\[[^\]]*\]\s*)?([^\s(]+)', line)
+        if not m:
+            continue
+        item = m.group(1).strip()
+        if section == 'code' and ('/' in item or '\\' in item):
+            if not _is_noise(item):  # 过滤路由/测试/通用文件噪音
+                result['code_files'].append(item)
+        elif section == 'api' and item.startswith('/'):
+            if not _is_noise(item):
+                result['apis'].append(item)
+        elif section == 'field' and '->' in line:
+            result['fields'].append(line.strip('- ').strip())
+    # 精简: 代码取前8, API取前6, 字段取前6
+    result['code_files'] = result['code_files'][:8]
+    result['apis'] = result['apis'][:6]
+    result['fields'] = result['fields'][:6]
+    return result
+
+
+def _query_kg_prefetch(title, platform=None):
+    """调 kg.py prefetch 一次性多词合并搜索 (知识图谱升级后的能力)。
+
+    比 _query_kg_context(单关键词) 强: prefetch 自动拆词+合并+按多词命中排序。
+    输入完整标题, 一次拿到最全最准的上下文。
+    """
+    import subprocess
+    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'kg.py')
+    if not os.path.isfile(script):
+        return {}
+    cmd = ['python', script, 'prefetch', title]
+    if platform in ('web', 'app'):
+        cmd += ['--platform', platform]
+    try:
+        r = subprocess.run(
+            cmd, capture_output=True, text=True, timeout=20, encoding='utf-8', errors='replace')
+        return _parse_prefetch(r.stdout)
+    except subprocess.TimeoutExpired:
+        return {}
+    except Exception:
+        return {}
+
+
+def _parse_prefetch(text):
+    """从 kg.py prefetch 的输出提取代码/API/字段 (复用 _parse_context_pack 逻辑)。
+
+    prefetch 输出格式和 context_pack 基本一致 (都有"相关代码文件/相关API/相关字段"段),
+    只是 prefetch 带多词命中次数标注 (如 "4词命中")。
+    """
+    return _parse_context_pack(text, 'prefetch')
+
+
+def _clean_html(s):
+    """去 HTML 标签 + 实体, 压缩空白。禅道详情字段是富文本 HTML。"""
+    if not s:
+        return ''
+    import re
+    s = re.sub(r'<br\s*/?>|</p>|</div>', '\n', s, flags=re.I)
+    s = re.sub(r'<[^>]+>', '', s)
+    s = re.sub(r'&nbsp;', ' ', s)
+    s = re.sub(r'&amp;', '&', s)
+    s = re.sub(r'&lt;', '<', s)
+    s = re.sub(r'&gt;', '>', s)
+    s = re.sub(r'[ \t]+', ' ', s)
+    s = re.sub(r'\n{3,}', '\n\n', s)
+    return s.strip()
+
+
+def _fetch_zentao_detail(client, kind, item_id, max_len=600):
+    """从禅道拉任务/Bug/需求的详情 + 关联信息, 用于润色提示词。
+
+    返回 dict:
+      - detail: 自身描述 (任务desc / Bug的steps重现步骤 / 需求spec)
+      - story_title: 关联需求标题 (任务/bug 常挂在 story 下)
+      - story_spec: 关联需求规格 (业务背景, 可能很详细)
+      - scene: 场景名 (所属执行/产品)
+    任何一项查不到就留空, 不报错。
+    """
+    import re
+    out = {'detail': '', 'story_id': 0, 'story_title': '', 'story_spec': '', 'scene': ''}
+
+    # 自身详情
+    path = '/%ss/%s' % (kind, item_id)
+    r = client.api('GET', path)
+    if r.status_code != 200:
+        return out
+    data = r.json()
+
+    # 取详情正文 (不同 kind 字段名不同)
+    if kind == 'bug':
+        raw = data.get('steps', '')
+    elif kind == 'story':
+        raw = data.get('spec', '') or data.get('title', '')
+    else:  # task
+        raw = data.get('desc', '')
+    detail = _clean_html(raw)
+    if detail and len(detail) > max_len:
+        detail = detail[:max_len] + '…'
+    out['detail'] = detail
+
+    # 场景名: execution 名 (任务) / product 名 (bug/story)
+    story_id = data.get('story') or 0
+
+    if kind == 'task':
+        eid = data.get('execution')
+        if eid:
+            er = client.api('GET', '/executions/%s' % eid)
+            if er.status_code == 200:
+                out['scene'] = str(er.json().get('name', ''))
+    else:
+        pid = data.get('product')
+        if pid:
+            pr = client.api('GET', '/products/%s' % pid)
+            if pr.status_code == 200:
+                out['scene'] = str(pr.json().get('name', ''))
+
+    # 关联需求 (业务背景, 最有价值的上下文)
+    if story_id:
+        out['story_id'] = story_id
+        sr = client.api('GET', '/stories/%s' % story_id)
+        if sr.status_code == 200:
+            sd = sr.json()
+            out['story_title'] = str(sd.get('title', ''))
+            spec = _clean_html(sd.get('spec', ''))
+            if spec and len(spec) > max_len:
+                spec = spec[:max_len] + '…'
+            out['story_spec'] = spec
+
+    return out
+
+
+def enrich_prompt(kind, item_id, title, client=None):
+    """构建增强提示词: 禅道详情(最高优先) + 知识图谱(代码定位)。
+
+    上下文优先级 (逐层取, 有就用, 没有就跳过):
+      1. 禅道详情: 任务desc / Bug重现steps / 关联需求spec (最准, 但常为空)
+      2. 场景名: 所属执行/产品
+      3. 知识图谱: 相关代码/API/字段 (代码定位用)
+
+    client 传入则拉禅道详情; 不传(None)则只做知识图谱增强。
+    任何环节失败 → 静默跳过, 不阻塞。
+    """
+    kind_label = kind if kind in ('任务', 'Bug', '需求') else '任务'
+    # 禅道内部 kind (task/bug/story)
+    zt_kind = 'bug' if kind_label == 'Bug' else ('story' if kind_label == '需求' else 'task')
+
+    # 角色化任务描述 (替代原来的"帮我推进禅道任务"废话)
+    if zt_kind == 'bug':
+        role_task = '定位这个 Bug 的根因并给出修复方案'
+    elif zt_kind == 'story':
+        role_task = '拆解这个需求并给出实现方案'
+    else:
+        role_task = '梳理这个任务的实现思路并定位代码'
+
+    # ── ① 先拉禅道详情 (拿 scene 推断 platform) ──
+    detail_added = False
+    scene_name = ''
+    story_block = []  # 关联需求内容 (暂存, 后面拼)
+    detail_block = []  # 重现步骤/desc (暂存)
+    if client:
+        try:
+            d = _fetch_zentao_detail(client, zt_kind, item_id)
+            scene_name = d.get('scene', '')
+            if d['story_title']:
+                story_block.append('## 关联需求 #%s' % d['story_id'])
+                story_block.append(d['story_title'])
+                if d['story_spec']:
+                    story_block.append(d['story_spec'])
+                detail_added = True
+            if d['detail']:
+                lbl = '重现步骤' if zt_kind == 'bug' else ('任务说明' if zt_kind == 'task' else '需求规格')
+                detail_block.append('## %s' % lbl)
+                detail_block.append(d['detail'])
+                detail_added = True
+        except Exception:
+            pass
+
+    # 用 scene 推断 platform (前端/移动端/后端)
+    platform = _guess_platform(scene_name)
+    platform_label = {'web': '前端(Web)', 'app': '移动端(APP)'}.get(platform, '后端/全栈')
+
+    # 构建 lines (此时 scene/platform 都已确定)
+    lines = [
+        '## 任务',
+        '%s「%s」(禅道%s #%s, %s方向)' % (role_task, title or '', kind_label, item_id, platform_label),
+    ]
+    if scene_name:
+        lines.append('- 迭代/场景：%s' % scene_name)
+
+    # 拼入禅道详情
+    if story_block:
+        lines.append('')
+        lines.extend(story_block)
+    if detail_block:
+        lines.append('')
+        lines.extend(detail_block)
+
+    # 输出要求 (替代啰嗦的"请帮我", 给AI明确的结构化产出指令)
+    lines.append('')
+    lines.append('## 请按以下结构输出')
+    if zt_kind == 'bug':
+        lines.append('1. **根因分析**：结合重现步骤/关联需求，判断是数据问题、逻辑分支、还是接口/权限')
+        lines.append('2. **影响范围**：列出受影响的接口、表、页面（用下面的知识图谱代码定位）')
+        lines.append('3. **修复方案**：具体改哪些文件、改什么，给出关键代码片段')
+        lines.append('4. **回归点**：修复后需要验证哪些场景，避免引入新问题')
+    elif zt_kind == 'story':
+        lines.append('1. **需求拆解**：把需求拆成可独立实现的子功能点')
+        lines.append('2. **技术方案**：涉及哪些接口/表/页面，新增还是改造（参考下方代码）')
+        lines.append('3. **实现步骤**：按依赖顺序列出开发步骤')
+        lines.append('4. **风险点**：可能影响现有功能的地方')
+    else:
+        lines.append('1. **实现思路**：这个任务该怎么实现，用到哪些现有代码')
+        lines.append('2. **代码定位**：在下方知识图谱命中的文件里，具体改哪个类/方法')
+        lines.append('3. **实现步骤**：按顺序的开发步骤')
+        lines.append('4. **自检点**：完成后要验证什么')
+
+    # ── ② 知识图谱增强 (代码定位) ──
+    # v0.18: 用 prefetch 替代多次 context_pack —— 一次多词合并查询, 更快更准。
+    kws = _extract_keywords(title)
+    if not kws:
+        return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': detail_added, 'keyword': ''}}
+
+    # prefetch 一次性多词搜索 (知识图谱升级后的能力)
+    ctx = _query_kg_prefetch(title, platform)
+    if not ctx or not (ctx.get('code_files') or ctx.get('apis') or ctx.get('fields')):
+        # prefetch 失败 → 回退到旧的多词 context_pack
+        from concurrent.futures import ThreadPoolExecutor
+        all_code, all_api, all_field = {}, [], []
+        with ThreadPoolExecutor(max_workers=4) as pool:
+            results = list(pool.map(lambda k: (k, _query_kg_context(k, platform)), kws[:4]))
+        for kw, r in results:
+            for f in r.get('code_files', []):
+                all_code[f] = all_code.get(f, 0) + 1
+            all_api.extend(r.get('apis', []))
+            all_field.extend(r.get('fields', []))
+    else:
+        # prefetch 成功: 它已经按多词命中次数排好序了
+        all_code = {f: 1 for f in ctx.get('code_files', [])}
+        all_api = ctx.get('apis', [])
+        all_field = ctx.get('fields', [])
+
+    # 代码文件按命中次数排序 (次数多的排前面), API/字段去重
+    ranked_code = sorted(all_code.items(), key=lambda x: -x[1])[:8]
+    code_list = [f for f, _ in ranked_code]
+    seen = set()
+    api_list = [a for a in all_api if not (a in seen or seen.add(a))][:6]
+    # 字段过滤: 去掉明显跨业务域的假勤/薪资字段 (除非任务本身就是这些)
+    _IRRELEVANT_FIELDS = ('产检假', '年假', '年薪', '病假', '事假', '调休', '婚假', '丧假', '陪产假')
+    field_candidates = [fld for fld in all_field
+                        if not (fld in seen or seen.add(fld))
+                        and not any(ir in fld for ir in _IRRELEVANT_FIELDS)]
+    field_list = field_candidates[:6]
+
+    if not (code_list or api_list or field_list):
+        return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': detail_added, 'keyword': ','.join(kws[:3])}}
+
+    # 拼知识图谱上下文 (标注平台 + 多词命中)
+    lines.append('')
+    lines.append('## 知识图谱参考 (%s方向, 关键词: %s)' % (platform_label, ','.join(kws[:3])))
+    lines.append('> 以下是代码库中与该任务相关的文件/接口/字段，用于快速定位实现位置。')
+    if code_list:
+        lines.append('')
+        lines.append('**相关代码文件**：')
+        for f, cnt in ranked_code:
+            mark = ' ←多词命中' if cnt >= 2 else ''
+            lines.append('- `%s`%s' % (f, mark))
+    if api_list:
+        lines.append('')
+        lines.append('**相关接口**：')
+        for a in api_list:
+            lines.append('- `%s`' % a)
+    if field_list:
+        lines.append('')
+        lines.append('**相关字段**：')
+        for fld in field_list:
+            lines.append('- %s' % fld)
+    lines.append('')
+    lines.append('请先阅读上述代码文件理解现有实现，再给出改动方案，不要脱离现有架构另起炉灶。')
+    used_kws = ','.join(kws[:3])
+    return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': True, 'keyword': used_kws,
+                                 'counts': {'code': len(code_list), 'api': len(api_list), 'field': len(field_list)}}}
+
+
 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 美化缩进 (默认紧凑, 面板解析更快)')
     # 写操作子命令 (v0.3)
     parser.add_argument('--action', choices=['start_task', 'pause_task', 'finish_task',
@@ -416,10 +1008,51 @@ def main():
     parser.add_argument('--consumed', help='消耗工时 (finish/log_effort)')
     parser.add_argument('--resolution', help='Bug 解决方式 (resolve_bug): fixed/bydesign/duplicate/notrepro/postpone')
     parser.add_argument('--comment', help='Bug 解决备注 (resolve_bug)')
+    # 提示词增强 (v0.6)
+    parser.add_argument('--enrich', action='store_true', help='构建带知识图谱上下文的提示词 (发AI用)')
+    parser.add_argument('--title', help='任务/Bug 标题 (enrich 用)')
+    parser.add_argument('--kind-label', default='任务', help='类型标签 (enrich/detail 用): 任务/Bug/需求')
+    # 详情查看 (v0.9)
+    parser.add_argument('--detail', action='store_true', help='拉取任务/Bug/需求的完整详情 (卡片点击用)')
+    parser.add_argument('--kind', choices=['tasks', 'bugs', 'stories', 'task', 'bug', 'story'],
+                        help='只取某一域 (默认三域全取); detail/enrich 用单数 task/bug/story 指定类型')
     args = parser.parse_args()
 
+    # 详情查看分支: 拉禅道详情展示
+    if args.detail:
+        zt_kind = args.kind if args.kind in ('task', 'bug', 'story') else 'task'
+        client = _zentao_creds()
+        d = {}
+        if client:
+            try:
+                ok, _ = client.credentials_ok()
+                if ok and client.check_intranet()[0]:
+                    d = _fetch_zentao_detail(client, zt_kind, args.id or 0, max_len=1500)
+                    # 给 detail_label
+                    d['detail_label'] = {'bug': '重现步骤', 'task': '任务说明', 'story': '需求规格'}.get(zt_kind, '详情')
+                    d['title'] = args.title or d.get('story_title', '')
+            except Exception as e:
+                print(json.dumps({'ok': False, 'error': '拉取详情失败: %s' % e})); sys.exit(3)
+        result = {'ok': True, 'data': d}
+        code = 0
+
+    # 提示词增强分支: 禅道详情 + 知识图谱
+    elif args.enrich:
+        kind_label = args.kind_label if args.kind_label in ('任务', 'Bug', '需求') else '任务'
+        # 尝试用禅道 client 拉详情 (失败不影响, enrich_prompt 内部静默降级)
+        client = _zentao_creds()
+        if client:
+            ok, _ = client.credentials_ok()
+            if ok:
+                ok_inet, _ = client.check_intranet()
+                if not ok_inet:
+                    client = None  # 内网不通就不拉禅道详情, 只做知识图谱
+            else:
+                client = None
+        result = enrich_prompt(kind_label, args.id or 0, args.title or '', client=client)
+        code = 0
     # 写操作分支
-    if args.action:
+    elif args.action:
         if not args.id:
             result = {'ok': False, 'error': '写操作必须提供 --id'}
             code = 3
@@ -428,7 +1061,9 @@ def main():
                       'resolution': args.resolution, 'comment': args.comment}
             result, code = perform_action(args.action, args.id, params)
     else:
-        result, code = fetch_workbench(include_closed=args.include_closed, kind=args.kind)
+        # workbench: kind 期望 tasks/bugs/stories (单数形式转复数)
+        wb_kind = args.kind if args.kind in ('tasks', 'bugs', 'stories') else None
+        result, code = fetch_workbench(include_closed=args.include_closed, kind=wb_kind)
 
     if args.json or not sys.stdout.isatty():
         indent = 2 if args.pretty else None