@hupan56/wlkj 3.3.13 → 3.3.14

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

@@ -1,1503 +1,1348 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""
-wlkj_panel.py - 开发工作台数据接口（禅道任务 + 平台 spec/impact；供 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/wlkj_panel.py --json              # 三域活动项 JSON
-  python .qoder/scripts/domain/task/wlkj_panel.py --json --include-closed  # 含已关闭历史项
-  python .qoder/scripts/domain/task/wlkj_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():
-    """构建禅道客户端。返回 (client, preset_account)。
-
-    凭据源优先级：
-      ① 云平台 per-user 凭据（Option A：get_zentao_creds）—— account 已知（preset）
-      ② 本地 .qoder/config.yaml + secrets/zentao.env —— account 走 member.json
-    云凭据优先：demo 机器在内网可达禅道，平台凭据比本地文件更可能是最新配的。
-    凭据全无 → (None, '')。
-    """
-    c = _cloud_zentao_creds()
-    if c and c.get('ok') and c.get('url') and c.get('account') and c.get('password'):
-        try:
-            return ZentaoClient(c['url'], c['account'], c['password']), c['account']
-        except Exception:
-            pass
-    return ZentaoClient.from_config(), ''
-
-
-def _cloud_my_panel():
-    """云优先：调平台 get_my_zentao_panel（凭据走平台 per-user 配置，不出平台）。
-
-    直连云 /mcp JSON-RPC（读 .qoder/mcp_config.json 的 token+url）。
-    Returns: {ok:True, tasks, bugs, stories, account} 或 None（云不可达/工具失败）。
-    云返 {ok:False,error}（未配置/登录失败）→ 返该 dict（调用方据此提示+回退本地）。
-    """
-    import json as _json
-    import urllib.request as _u
-    import urllib.error as _ue
-    # 定位 mcp_config.json（switch_project 写在 .qoder/）
-    cfg_candidates = []
-    try:
-        from foundation.core.paths import get_repo_root
-        cfg_candidates.append(os.path.join(str(get_repo_root()), '.qoder', 'mcp_config.json'))
-    except Exception:
-        pass
-    cfg_candidates.append(os.path.join(_SCRIPTS, '..', 'mcp_config.json'))
-    token, url = '', ''
-    for cp in cfg_candidates:
-        try:
-            with open(cp, encoding='utf-8') as f:
-                cfg = _json.load(f)
-            srv = (cfg.get('mcpServers') or {}).get('wlinkj-knowledge') or {}
-            token = srv.get('token', '')
-            url = (srv.get('url') or '').rstrip('/')
-            if token and url:
-                break
-        except Exception:
-            continue
-    if not token or not url:
-        return None  # 云未绑定（switch_project 没跑）→ 回退本地
-    endpoint = url if url.endswith('/mcp') else url + '/mcp'
-    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
-                        "params": {"name": "get_my_zentao_panel", "arguments": {}}}).encode('utf-8')
-    req = _u.Request(endpoint, data=body, method='POST')
-    req.add_header('Content-Type', 'application/json')
-    req.add_header('X-MCP-Token', token)
-    try:
-        with _u.urlopen(req, timeout=30) as resp:
-            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
-    except Exception:
-        return None  # 网络不通 → 回退本地
-    try:
-        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
-        data = _json.loads(text) if text else {}
-    except Exception:
-        return None
-    return data  # {ok:True/False, ...}
-
-
-def _cloud_zentao_creds():
-    """Option A：从平台取禅道凭据（url/account/password 解密）。
-
-    用途：云到禅道被防火墙挡（my-panel 登录失败）时，本机（demo 机器，内网可达）
-    用平台凭据直连禅道拉真实数据。凭据随绑定 token 取本人配置（同信任级）。
-    Returns: {ok:True, url, account, password} 或 None（云不可达/未配置）。
-    """
-    import json as _json
-    import urllib.request as _u
-    cfg_candidates = []
-    try:
-        from foundation.core.paths import get_repo_root
-        cfg_candidates.append(os.path.join(str(get_repo_root()), '.qoder', 'mcp_config.json'))
-    except Exception:
-        pass
-    cfg_candidates.append(os.path.join(_SCRIPTS, '..', 'mcp_config.json'))
-    token, url = '', ''
-    for cp in cfg_candidates:
-        try:
-            with open(cp, encoding='utf-8') as f:
-                cfg = _json.load(f)
-            srv = (cfg.get('mcpServers') or {}).get('wlinkj-knowledge') or {}
-            token = srv.get('token', '')
-            url = (srv.get('url') or '').rstrip('/')
-            if token and url:
-                break
-        except Exception:
-            continue
-    if not token or not url:
-        return None
-    endpoint = url if url.endswith('/mcp') else url + '/mcp'
-    body = _json.dumps({"jsonrpc": "2.0", "id": 1, "method": "tools/call",
-                        "params": {"name": "get_zentao_creds", "arguments": {}}}).encode('utf-8')
-    req = _u.Request(endpoint, data=body, method='POST')
-    req.add_header('Content-Type', 'application/json')
-    req.add_header('X-MCP-Token', token)
-    try:
-        with _u.urlopen(req, timeout=15) as resp:
-            r = _json.loads(resp.read().decode('utf-8', errors='replace'))
-        text = r.get('result', {}).get('content', [{}])[0].get('text', '')
-        data = _json.loads(text) if text else {}
-        return data if data.get('ok') else None
-    except Exception:
-        return None
-
-
-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, 错误)。
-
-    性能: 用线程池并行请求各 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, '查询执行列表失败, 稍后重试。'
-
-    def fetch_one(e):
-        eid = e.get('id')
-        if eid is None:
-            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
-            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
-            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):
-    """扫所有产品 (含 /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
-            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):
-    """扫所有产品 (含 /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
-            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
-
-
-# ============================================================
-# 归一化: 把禅道原始 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'),
-        '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', ''),
-        'story': t.get('story'),        # 关联需求ID (进度检测用)
-    }
-
-
-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'),
-    }
-
-
-def _norm_story(s):
-    return {
-        'id': s.get('id'),
-        'title': str(s.get('title', '')),
-        'status': s.get('status', ''),
-        'pri': s.get('pri'),
-    }
-
-
-# 活动态白名单 (与 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()
-
-    # ⓪ 云优先：调平台 get_my_zentao_panel（凭据走平台 per-user，不出平台）。
-    # 成功 → 直接用云数据，跳过本地凭据/连通/归属/收集（① ~ ④）。
-    # 未配置/登录失败 → 返回 {ok:False} 提示用户去平台配置，并回退本地（本地配了仍可用）。
-    # 云不可达(返回 None) → 静默回退本地全流程。
-    cloud = _cloud_my_panel()
-    if isinstance(cloud, dict):
-        # 云可达 → 云的判断权威（平台是凭据源）。
-        if cloud.get('ok'):
-            tasks = cloud.get('tasks') or []
-            bugs = cloud.get('bugs') or []
-            stories = cloud.get('stories') or []
-            # 按 kind 裁剪（与本地一致）
-            if kind == 'tasks':
-                bugs, stories = [], []
-            elif kind == 'bugs':
-                tasks, stories = [], []
-            elif kind == 'stories':
-                tasks, bugs = [], []
-            tasks, bugs, stories = _filter_live(tasks, bugs, stories, include_closed)
-            # 云路径：数据已平台聚合，归一化即可（进度检测需本地 client，云模式跳过给默认值）
-            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]
-            for it in norm_tasks + norm_bugs + norm_stories:
-                it['progress'] = {'prd': False, 'spec': 'none', 'code': False}
-            data = {'account': cloud.get('account', ''), 'developer': developer,
-                    'current_task': None, 'tasks': norm_tasks,
-                    'bugs': norm_bugs, 'stories': norm_stories}
-            meta = {'fetched_at': datetime.now().isoformat(timespec='seconds'),
-                    'source': 'cloud',
-                    'counts': {'tasks': len(norm_tasks), 'bugs': len(norm_bugs),
-                               'stories': len(norm_stories)},
-                    'include_closed': include_closed}
-            return {'ok': True, 'data': data, 'meta': meta}, 0
-        # 云可达但失败（未配置/登录失败/防火墙）→ 记下云诊断，回退本地。
-        # 回退价值：云到禅道常被防火墙挡，但本机（demo 机器，内网）可能直连可达。
-        # 本地也失败时，把云诊断一起带出（平台有凭据但云连不上 + 本地无凭据）。
-        cloud_error = cloud.get('error', '禅道不可用')
-    else:
-        cloud_error = None  # 云不可达（switch_project 没跑/平台宕机）→ 静默回退本地
-
-    # ① 凭据（云平台优先 Option A，回退本地文件）
-    client, preset_account = _zentao_creds()
-    if client is None:
-        base_msg = ('禅道凭据未配置。推荐在【平台设置 → 禅道】配置（panel 自动走云取凭据）；'
-                    '或本地 .qoder/config.yaml 的 zentao.url + secrets/zentao.env 账号密码。')
-        if cloud_error:
-            base_msg += '（云 my-panel 失败：%s）' % cloud_error
-        return {'ok': False, 'error': base_msg}, 3
-
-    ok, msg = client.credentials_ok()
-    if not ok:
-        return {'ok': False, 'error': '禅道凭据不完整: %s' % msg}, 3
-
-    # ② 内网连通（本机能否直连禅道——demo 机器在内网可达）
-    ok, msg = client.check_intranet()
-    if not ok:
-        return {'ok': False, 'error': '本机连不上禅道内网: %s' % msg}, 5
-
-    # ③ 归属（云凭据带的 account 优先；否则走 member.json）
-    if preset_account:
-        my_account = preset_account
-    else:
-        my_account, err = _resolve_my_account(developer) if developer else (None, '未识别当前开发者身份。')
-        if not my_account:
-            return {'ok': False, 'error': err}, 3
-
-    # ④ 收集 (三域并行, 按 kind 决定取哪几域)
-    from concurrent.futures import ThreadPoolExecutor
-    tasks, bugs, stories = [], [], []
-
-    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 '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)
-    _add_progress('story', norm_stories, stories)
-
-    # 当前任务 (工作流的 .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,
-        'current_task': current_task,
-        'tasks': norm_tasks,
-        'bugs': norm_bugs,
-        'stories': norm_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
-
-
-# ============================================================
-# 写操作 (v0.3): 面板按钮触发的禅道状态流转
-# 设计对齐 MCP server 的 _assert_owner: 写前校验归属, 防误改队友。
-# 任务: start/pause/finish/log_effort; Bug: confirm/resolve
-# ============================================================
-
-def _check_owner(client, my_account, kind, item_id):
-    """写前归属校验 (对齐 mcp server _assert_owner)。
-    task 只认 assignedTo==我; bug 认 assignedTo==我 OR openedBy==我。
-    返回 None=放行, 字符串=拒绝原因。"""
-    r = client.api('GET', '/%ss/%s' % (kind, item_id))
-    if r.status_code not in (200, 201):
-        return None  # 查询失败不阻塞 (禅道权限兜底)
-    data = r.json()
-    asg = ZentaoClient.assignee_account(data)
-    allow = (asg == my_account)
-    if kind == 'bug' and not allow:
-        allow = (ZentaoClient.openedby_account(data) == my_account)
-    if not allow:
-        return '这条%s指派给 %s, 不是你(%s), 已拒绝改。' % (kind, asg or '空', my_account)
-    return None
-
-
-def _do_confirm_spec(client, my_account, kind, item_id, params):
-    """确认并上传 spec 到平台（禅道面板「确认 spec」按钮触发）。
-
-    流程: 定位 spec.md → 解析 zentao story id → 调 spec_upload 回流平台。
-    spec 挂在 story 上（zentao_id = story 号），与 commit_pipeline 同套关联键。
-    幂等: spec.md 契约头有 platform_spec_id → update_spec；无 → create+confirm+回写。
-
-    Args:
-        client: ZentaoClient 或 None（显式给 zentao_id 时不需禅道连接）。
-        kind: task/bug/story（item_id 的类型，用于反查 story）。
-        item_id: 禅道 task/bug/story id（仅展示用 + 反查 story）。
-        params: spec_path / zentao_id / code_targets（均可选，缺则自动解析）。
-    """
-    # ① 定位 spec.md: 优先 --spec-path；否则 find_spec() 找当前任务目录的 spec
-    spec_path = params.get('spec_path')
-    if not spec_path:
-        try:
-            from foundation.core.paths import find_spec
-            hits = find_spec() or []
-            if hits:
-                spec_path = hits[0].get('path')
-        except Exception:
-            pass
-    if not spec_path:
-        return {'ok': False, 'error': '没找到 spec.md。先用 /wl-spec 生成，或传 --spec-path <路径>。'}, 3
-
-    # ② 解析 zentao story id: 优先 --zentao-id；否则从 item 反查（task/bug 读 story 字段, story 用自身 id）
-    zentao_id = params.get('zentao_id')
-    if not zentao_id and client:
-        try:
-            r = client.api('GET', '/%s/%s' % ({'task': 'tasks', 'bug': 'bugs', 'story': 'stories'}.get(kind, kind + 's'), item_id))
-            if r.status_code == 200:
-                d = r.json()
-                zentao_id = str(d.get('id') if kind == 'story' else (d.get('story') or '') or '')
-        except Exception:
-            pass
-    if not zentao_id:
-        return {'ok': False, 'error': '未能从禅道 %s #%s 解析 story id（spec 挂 story 上）。传 --zentao-id 显式指定。' % (kind, item_id)}, 3
-
-    # ③ 调 spec_upload（复用回流客户端）
-    try:
-        from domain.integration.spec_upload import upload_spec
-    except Exception as e:
-        return {'ok': False, 'error': 'spec_upload 客户端加载失败: %s' % e}, 3
-    ct_raw = params.get('code_targets')
-    code_targets = [c.strip() for c in ct_raw.split(',') if c.strip()] if ct_raw else None
-    r = upload_spec(spec_path, zentao_id_override=zentao_id, code_targets=code_targets)
-    if r.get('ok'):
-        return {'ok': True, 'data': {
-            'action': 'confirm_spec', 'id': item_id, 'spec_id': r['platform_spec_id'],
-            'via': r.get('via'), 'status': r.get('status'), 'version': r.get('version'),
-            'message': '%s：%s（story=%s → platform spec %s, %s）' % (
-                'spec 已上传' if r.get('via') == 'create_spec' else 'spec 已更新',
-                spec_path, zentao_id, r['platform_spec_id'], r.get('status'))}}, 0
-    return {'ok': False, 'error': 'spec 上传失败: %s' % r.get('message')}, 5
-
-
-def _do_link_version(client, my_account, kind, item_id, params):
-    """把 story/bug 关联到 build（禅道「关联版本」按钮触发）。
-
-    Args:
-        kind: story/bug（决定挂到 /builds/{id}/stories 还是 /bugs）
-        item_id: 禅道 story/bug id
-        params: build_id 必填
-    """
-    build_id = params.get('build_id')
-    if not build_id:
-        return {'ok': False, 'error': '关联版本必须指定 --build-id'}, 3
-    obj_key = 'stories' if kind == 'story' else 'bugs'
-    r = client.api('POST', '/builds/%s/%s' % (build_id, obj_key), {obj_key: [item_id]})
-    if r.status_code in (200, 201):
-        return {'ok': True, 'data': {
-            'action': 'link_version', 'id': item_id,
-            'message': '%s #%s 已关联到 build %s' % (kind, item_id, build_id)}}, 0
-    return {'ok': False, 'error': '关联版本失败 (HTTP %s): %s' % (
-        r.status_code, ZentaoClient.err_text(r))}, 5
-
-
-def _do_publish_story(client, my_account, kind, item_id, params):
-    """建禅道 story（禅道「发布需求」按钮触发）。
-
-    新建需求挂产品；可选关联 plan / build。
-    item_id 仅展示用（新建不依赖已有对象）。
-
-    Args:
-        params: product_id 必填；title/spec/pri/category/plan_id/build_id 可选
-    """
-    pid = params.get('product_id')
-    if not pid:
-        return {'ok': False, 'error': '建需求必须指定 --product-id'}, 3
-    try:
-        payload = {
-            'product': int(pid),
-            'title': params.get('title') or '',
-            'spec': params.get('spec', ''),
-            'pri': int(params.get('pri', 3)),
-            'category': params.get('category', 'feature'),
-        }
-    except (ValueError, TypeError):
-        return {'ok': False, 'error': 'product-id/pri 必须是数字。'}, 3
-    if not payload['title']:
-        return {'ok': False, 'error': '建需求必须指定 --title'}, 3
-
-    r = client.api('POST', '/stories', payload)
-    if r.status_code not in (200, 201):
-        return {'ok': False, 'error': '建需求失败 (HTTP %s): %s' % (
-            r.status_code, ZentaoClient.err_text(r))}, 5
-    try:
-        story_id = r.json().get('id')
-    except Exception:
-        story_id = None
-    if not story_id:
-        return {'ok': False, 'error': '建需求响应无 id: %s' % ZentaoClient.err_text(r)}, 5
-
-    # 可选关联 plan
-    plan_id = params.get('plan_id')
-    if plan_id:
-        try:
-            client.api('POST', '/plans/%s/stories' % plan_id, {'stories': [story_id]})
-        except Exception:
-            pass  # 关联失败不阻塞主流程（需求已建好）
-
-    # 可选关联 build
-    build_id = params.get('build_id')
-    if build_id:
-        _do_link_version(client, my_account, 'story', story_id, {'build_id': build_id})
-
-    return {'ok': True, 'data': {
-        'action': 'publish_story', 'story_id': story_id,
-        'message': '需求 #%s 已创建（产品 %s）%s' % (
-            story_id, pid, (' 并关联 build %s' % build_id) if build_id else '')}}, 0
-
-
-# 禅道写操作的 HTTP 调度表: action -> (method, path_tpl, payload_builder, ok_msg)
-# payload_builder(args_dict) -> payload_dict
-def _do_action(client, my_account, action, item_id, params):
-    """执行单个写操作。返回 (result_dict, exit_code)。"""
-    developer = get_developer()
-    my_account = my_account or (_resolve_my_account(developer)[0] if developer else None)
-    if not my_account:
-        return {'ok': False, 'error': '未识别禅道身份, 无法校验归属。请配 member.json 的 zentao_account。'}, 3
-
-    # spec 确认上传（不走禅道 HTTP 写，调 spec_upload 回流平台）
-    if action == 'confirm_spec':
-        _k = params.get('kind') or 'task'
-        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
-        return _do_confirm_spec(client, my_account, _k, item_id, params)
-
-    # story 域写操作（自定义逻辑，独立函数分支，同 confirm_spec）
-    if action == 'publish_story':
-        return _do_publish_story(client, my_account, 'story', item_id, params)
-    if action == 'link_version':
-        _k = params.get('kind') or 'story'
-        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
-        return _do_link_version(client, my_account, _k, item_id, params)
-
-    # action 分派
-    ACTIONS = {
-        # 任务类 (kind=task)
-        'start_task':      ('task', 'POST', '/tasks/%s/start',  {'left': 'left'}),
-        'pause_task':      ('task', 'POST', '/tasks/%s/pause',  {}),
-        'finish_task':     ('task', 'POST', '/tasks/%s/finish', {'left': 'left', 'consumed': 'consumed'}),
-        'log_effort':      ('task', 'POST', '/tasks/%s/estimate', {'consumed': 'consumed', 'left': 'left'}),
-        # Bug 类 (kind=bug)
-        'confirm_bug':     ('bug',  'POST', '/bugs/%s/confirm', {}),
-        'resolve_bug':     ('bug',  'POST', '/bugs/%s/resolve', {'resolution': 'resolution', 'comment': 'comment'}),
-    }
-    if action not in ACTIONS:
-        return {'ok': False, 'error': '未知操作: %s。支持: %s' % (action, ', '.join(ACTIONS.keys()))}, 3
-
-    kind, method, path_tpl, fields = ACTIONS[action]
-    path = path_tpl % item_id
-
-    # ① 归属校验 (防误改队友)
-    guard = _check_owner(client, my_account, kind, item_id)
-    if guard:
-        return {'ok': False, 'error': guard}, 4
-
-    # ② 拼 payload (只取该操作关心的字段)
-    payload = {}
-    for pkey, fkey in fields.items():
-        v = params.get(fkey)
-        if v is not None and v != '':
-            try:
-                payload[pkey] = float(v) if fkey in ('left', 'consumed') else v
-            except (ValueError, TypeError):
-                payload[pkey] = v
-
-    # ③ 各操作的必填字段兜底 (实测禅道校验)
-    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)
-    if r.status_code in (200, 201):
-        label = {
-            'start_task': '已开始', 'pause_task': '已暂停', 'finish_task': '已完成',
-            'log_effort': '已记工时', 'confirm_bug': '已确认', 'resolve_bug': '已解决',
-        }[action]
-        return {'ok': True, 'data': {'action': action, 'id': item_id, 'message': '%s #%s %s' % (kind, item_id, label)}}, 0
-    return {'ok': False, 'error': '操作失败 (HTTP %s): %s。可能权限不足或当前状态不允许。' % (
-        r.status_code, ZentaoClient.err_text(r))}, 5
-
-
-def perform_action(action, item_id, params=None):
-    """写操作入口。返回 (result_dict, exit_code)。"""
-    params = params or {}
-    # confirm_spec: 已显式给 spec_path + zentao_id 时不依赖禅道连接（直接回流平台）
-    if action == 'confirm_spec' and params.get('spec_path') and params.get('zentao_id'):
-        _k = params.get('kind') or 'task'
-        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
-        return _do_confirm_spec(None, None, _k, item_id, params)
-    client = _zentao_creds()
-    if client is None:
-        return {'ok': False, 'error': '禅道凭据未配置。'}, 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
-    developer = get_developer()
-    my_account, err = _resolve_my_account(developer) if developer else (None, '未识别开发者身份')
-    if err and not my_account:
-        return {'ok': False, 'error': err}, 3
-    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 _query_kg_semantic(query, top_k=5):
-    """调 kg.py semantic 语义搜索 (概念检索, 理解业务含义)。
-
-    比 prefetch 的关键词匹配更强: 查"数据权限"能命中 permission/auth 等概念相关代码。
-    用于补充 prefetch 可能漏掉的语义相关文件。带超时, daemon 未启动时冷启动~27s。
-    """
-    import subprocess
-    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'kg.py')
-    if not os.path.isfile(script):
-        return []
-    try:
-        r = subprocess.run(
-            ['python', script, 'semantic', query, '--top', str(top_k)],
-            capture_output=True, text=True, timeout=35, encoding='utf-8', errors='replace')
-        if r.returncode != 0 or '[error]' in r.stdout:
-            return []
-        # 解析输出: "  0.849  数据权限 handlePermission"
-        import re
-        results = []
-        for line in r.stdout.split('\n'):
-            m = re.match(r'\s*([\d.]+)\s+(.+)', line)
-            if m:
-                results.append(m.group(2).strip())
-        return results[:top_k]
-    except Exception:
-        return []
-
-
-def _query_kg_impact(keyword):
-    """调 kg.py impact 影响分析 (改某模块影响哪些端点/Controller)。
-
-    用于 bug 提示词的"影响范围"——告诉 AI 这个改动会波及哪些接口。
-    """
-    import subprocess
-    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'kg.py')
-    if not os.path.isfile(script):
-        return []
-    try:
-        r = subprocess.run(
-            ['python', script, 'impact', keyword],
-            capture_output=True, text=True, timeout=15, encoding='utf-8', errors='replace')
-        if r.returncode != 0 or '未找到' in r.stdout:
-            return []
-        # 解析: 提取 Controller 名和端点
-        import re
-        controllers = set()
-        endpoints = set()
-        for line in r.stdout.split('\n'):
-            m = re.match(r'\s+后端:\s*(\S+)', line)
-            if m:
-                controllers.add(m.group(1))
-            m2 = re.match(r'^###\s+(\S+)', line)
-            if m2 and m2.group(1).startswith('/'):
-                endpoints.add(m2.group(1))
-        return {'controllers': list(controllers)[:6], 'endpoints': list(endpoints)[:6]}
-    except Exception:
-        return {}
-
-
-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': ''}
-
-    # 自身详情 (zentao 路径: task→tasks, bug→bugs, story→stories — story +es 不是 +s)
-    _kind_path = {'task': 'tasks', 'bug': 'bugs', 'story': 'stories'}.get(kind, kind + 's')
-    path = '/%s/%s' % (_kind_path, 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', '')  # 故事详情=spec；spec 空则无详情(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)
-    # kind=story: 故事本身就是需求，story_id 用自身 id（不找父 story，story 的 data.story 是父/None）
-    if kind == 'story':
-        story_id = item_id
-    else:
-        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
-        if kind == 'story':
-            # 故事自身即需求，用已取的 data（不重复 fetch /stories/{自身}）
-            out['story_title'] = str(data.get('title', ''))
-            out['story_spec'] = detail  # 已 _clean_html 过（kind=story 时 raw=spec or title）
-        else:
-            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)
-
-    # 平台上下文（按禅道 story 反查需求→spec + 代码变更史）
-    try:
-        if d.get('story_id'):
-            from domain.integration.spec_upload import _resolve_endpoint, _mcp_call
-            _base, _tok, _pid = _resolve_endpoint()
-            if _tok:
-                _sid = str(d['story_id'])
-                _ps = _mcp_call(_base, _tok, "find_specs_by_zentao",
-                                {"zentao_id": _sid, "project_id": _pid})
-                _cc = _mcp_call(_base, _tok, "code_changes",
-                                {"project_id": _pid, "req_key": "XQ" + _sid, "mode": "summary"})
-                if _ps.get("specs") or _cc.get("commits") or _cc.get("functions"):
-                    lines.append('')
-                    lines.append('## 平台上下文（禅道 #%s → %s）' % (
-                        _sid, _ps.get("requirement_title") or ("XQ" + _sid)))
-                    for _s in (_ps.get("specs") or []):
-                        lines.append('- SPEC [%s] %s v%s：%s' % (
-                            _s.get("status"), _s.get("title"), _s.get("current_version"),
-                            str(_s.get("content_excerpt") or '')[:150].replace("\n", " ")))
-                    if _cc.get("commits") or _cc.get("functions"):
-                        _tf = ', '.join(f.get('fn', '') for f in (_cc.get('top_functions') or [])[:3])
-                        lines.append('- 代码变更史：%s 函数 / %s 提交（top: %s）' % (
-                            _cc.get('functions'), _cc.get('commits'), _tf or '—'))
-    except Exception:
-        pass  # 平台上下文拉不到（无 token/无 story_id）不阻塞 enrich
-
-    # 要做的事（任务化一句，替代通用 4 点 dump）
-    lines.append('')
-    lines.append('## 要做的事')
-    if zt_kind == 'bug':
-        lines.append('定位根因（数据/逻辑/接口/权限？）→ 修复方案（改哪个文件改什么）→ 回归点')
-    elif zt_kind == 'story':
-        lines.append('拆子功能 → 技术方案（接口/表/页面，新建还是改造）→ 实现步骤 → 风险点')
-    else:
-        lines.append('实现思路（用哪些现有代码）→ 改哪个类/方法 → 开发步骤 → 自检点')
-
-    # ── ② 知识图谱增强 (代码定位) ──
-    # 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])}}
-
-    # 代码定位：top-3 文件指针（不 dump API/字段/语义，让 agent 用 rag_search/get_impact/context_360 工具自取深入）
-    if code_list:
-        lines.append('')
-        lines.append('## 代码定位（top %d；细节用 rag_search / get_impact / context_360 工具取）' % min(3, len(ranked_code)))
-        for f, cnt in ranked_code[:3]:
-            mark = ' ←多词命中' if cnt >= 2 else ''
-            lines.append('- `%s`%s' % (f, mark))
-    # bug 影响范围（1 行，不展开）
-    if zt_kind == 'bug' and kws:
-        impact = _query_kg_impact(kws[0])
-        if impact and (impact.get('controllers') or impact.get('endpoints')):
-            hit = (impact.get('controllers') or [])[:3] + (impact.get('endpoints') or [])[:3]
-            lines.append('')
-            lines.append('**影响**：改「%s」波及 %s' % (kws[0], ', '.join(hit)))
-    lines.append('')
-    lines.append('先读上述文件理解现状再动手；细节走工具，别脱离现有架构另起炉灶。')
-    used_kws = ','.join(kws[:3])
-    return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': True, 'keyword': used_kws,
-                                 'counts': {'code': min(3, len(ranked_code)) if code_list else 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('--pretty', action='store_true', help='JSON 美化缩进 (默认紧凑, 面板解析更快)')
-    # 写操作子命令 (v0.3)
-    parser.add_argument('--action', choices=['start_task', 'pause_task', 'finish_task',
-                        'log_effort', 'confirm_bug', 'resolve_bug', 'confirm_spec',
-                        'publish_story', 'link_version'],
-                        help='执行禅道写操作 (面板按钮触发); confirm_spec=确认并上传 spec 到平台; '
-                             'publish_story=建需求; link_version=关联 build')
-    parser.add_argument('--id', type=int, help='写操作的目标 task/bug ID')
-    parser.add_argument('--left', help='剩余工时 (start/finish/log_effort)')
-    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)')
-    # spec 确认上传 (confirm_spec)
-    parser.add_argument('--spec-path', help='本地 spec.md 路径 (confirm_spec; 不传则用当前任务 spec)')
-    parser.add_argument('--code-targets', help='代码目标实体逗号分隔 (confirm_spec, 可选)')
-    parser.add_argument('--zentao-id', help='禅道 story 号 (confirm_spec; 不传则从 --id 反查 story)')
-    # story 域写操作 (publish_story / link_version)
-    parser.add_argument('--product-id', help='产品 ID (publish_story 必填；需求挂产品)')
-    parser.add_argument('--spec', help='需求规格正文 (publish_story)')
-    parser.add_argument('--spec-file', help='需求规格正文文件路径 (publish_story; 优先于 --spec, 规避 shell 长度限制)')
-    parser.add_argument('--pri', type=int, default=3, help='需求优先级 1-4 (publish_story; 默认 3)')
-    parser.add_argument('--plan-id', help='关联计划 ID (publish_story 可选)')
-    parser.add_argument('--build-id', help='关联 build/版本 ID (publish_story 可选; link_version 必填)')
-    # 提示词增强 (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
-    # 写操作分支
-    elif args.action:
-        if not args.id:
-            result = {'ok': False, 'error': '写操作必须提供 --id'}
-            code = 3
-        else:
-            # publish_story 的 spec 正文: --spec-file 优先于 --spec (读文件, 规避 shell 长度限制)
-            spec_text = args.spec or ''
-            if args.spec_file:
-                try:
-                    with open(args.spec_file, encoding='utf-8') as fh:
-                        spec_text = fh.read()
-                except Exception as e:
-                    result = {'ok': False, 'error': '读 --spec-file 失败: %s' % e}
-                    code = 3
-                    spec_text = None
-            if spec_text is not None:
-                params = {'left': args.left, 'consumed': args.consumed,
-                          'resolution': args.resolution, 'comment': args.comment,
-                          'spec_path': args.spec_path, 'code_targets': args.code_targets,
-                          'zentao_id': args.zentao_id, 'kind': args.kind,
-                          'product_id': args.product_id, 'title': args.title,
-                          'spec': spec_text, 'pri': args.pri, 'plan_id': args.plan_id,
-                          'build_id': args.build_id}
-                result, code = perform_action(args.action, args.id, params)
-    else:
-        # 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
-        print(json.dumps(result, ensure_ascii=False, default=str, indent=indent))
-    else:
-        if result.get('ok'):
-            if args.action:
-                print('✅ %s' % result['data'].get('message', '操作成功'))
-            else:
-                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()
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+wlkj_panel.py - 开发工作台数据接口（禅道任务 + 平台 spec/impact；供 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/wlkj_panel.py --json              # 三域活动项 JSON
+  python .qoder/scripts/domain/task/wlkj_panel.py --json --include-closed  # 含已关闭历史项
+  python .qoder/scripts/domain/task/wlkj_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, 错误)。
+
+    性能: 用线程池并行请求各 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, '查询执行列表失败, 稍后重试。'
+
+    def fetch_one(e):
+        eid = e.get('id')
+        if eid is None:
+            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
+            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
+            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):
+    """扫所有产品 (含 /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
+            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):
+    """扫所有产品 (含 /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
+            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
+
+
+# ============================================================
+# 归一化: 把禅道原始 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'),
+        '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', ''),
+        'story': t.get('story'),        # 关联需求ID (进度检测用)
+    }
+
+
+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'),
+    }
+
+
+def _norm_story(s):
+    return {
+        'id': s.get('id'),
+        'title': str(s.get('title', '')),
+        'status': s.get('status', ''),
+        'pri': s.get('pri'),
+    }
+
+
+# 活动态白名单 (与 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 决定取哪几域)
+    from concurrent.futures import ThreadPoolExecutor
+    tasks, bugs, stories = [], [], []
+
+    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 '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)
+    _add_progress('story', norm_stories, stories)
+
+    # 当前任务 (工作流的 .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,
+        'current_task': current_task,
+        'tasks': norm_tasks,
+        'bugs': norm_bugs,
+        'stories': norm_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
+
+
+# ============================================================
+# 写操作 (v0.3): 面板按钮触发的禅道状态流转
+# 设计对齐 MCP server 的 _assert_owner: 写前校验归属, 防误改队友。
+# 任务: start/pause/finish/log_effort; Bug: confirm/resolve
+# ============================================================
+
+def _check_owner(client, my_account, kind, item_id):
+    """写前归属校验 (对齐 mcp server _assert_owner)。
+    task 只认 assignedTo==我; bug 认 assignedTo==我 OR openedBy==我。
+    返回 None=放行, 字符串=拒绝原因。"""
+    r = client.api('GET', '/%ss/%s' % (kind, item_id))
+    if r.status_code not in (200, 201):
+        return None  # 查询失败不阻塞 (禅道权限兜底)
+    data = r.json()
+    asg = ZentaoClient.assignee_account(data)
+    allow = (asg == my_account)
+    if kind == 'bug' and not allow:
+        allow = (ZentaoClient.openedby_account(data) == my_account)
+    if not allow:
+        return '这条%s指派给 %s, 不是你(%s), 已拒绝改。' % (kind, asg or '空', my_account)
+    return None
+
+
+def _do_confirm_spec(client, my_account, kind, item_id, params):
+    """确认并上传 spec 到平台（禅道面板「确认 spec」按钮触发）。
+
+    流程: 定位 spec.md → 解析 zentao story id → 调 spec_upload 回流平台。
+    spec 挂在 story 上（zentao_id = story 号），与 commit_pipeline 同套关联键。
+    幂等: spec.md 契约头有 platform_spec_id → update_spec；无 → create+confirm+回写。
+
+    Args:
+        client: ZentaoClient 或 None（显式给 zentao_id 时不需禅道连接）。
+        kind: task/bug/story（item_id 的类型，用于反查 story）。
+        item_id: 禅道 task/bug/story id（仅展示用 + 反查 story）。
+        params: spec_path / zentao_id / code_targets（均可选，缺则自动解析）。
+    """
+    # ① 定位 spec.md: 优先 --spec-path；否则 find_spec() 找当前任务目录的 spec
+    spec_path = params.get('spec_path')
+    if not spec_path:
+        try:
+            from foundation.core.paths import find_spec
+            hits = find_spec() or []
+            if hits:
+                spec_path = hits[0].get('path')
+        except Exception:
+            pass
+    if not spec_path:
+        return {'ok': False, 'error': '没找到 spec.md。先用 /wl-spec 生成，或传 --spec-path <路径>。'}, 3
+
+    # ② 解析 zentao story id: 优先 --zentao-id；否则从 item 反查（task/bug 读 story 字段, story 用自身 id）
+    zentao_id = params.get('zentao_id')
+    if not zentao_id and client:
+        try:
+            r = client.api('GET', '/%s/%s' % ({'task': 'tasks', 'bug': 'bugs', 'story': 'stories'}.get(kind, kind + 's'), item_id))
+            if r.status_code == 200:
+                d = r.json()
+                zentao_id = str(d.get('id') if kind == 'story' else (d.get('story') or '') or '')
+        except Exception:
+            pass
+    if not zentao_id:
+        return {'ok': False, 'error': '未能从禅道 %s #%s 解析 story id（spec 挂 story 上）。传 --zentao-id 显式指定。' % (kind, item_id)}, 3
+
+    # ③ 调 spec_upload（复用回流客户端）
+    try:
+        from domain.integration.spec_upload import upload_spec
+    except Exception as e:
+        return {'ok': False, 'error': 'spec_upload 客户端加载失败: %s' % e}, 3
+    ct_raw = params.get('code_targets')
+    code_targets = [c.strip() for c in ct_raw.split(',') if c.strip()] if ct_raw else None
+    r = upload_spec(spec_path, zentao_id_override=zentao_id, code_targets=code_targets)
+    if r.get('ok'):
+        return {'ok': True, 'data': {
+            'action': 'confirm_spec', 'id': item_id, 'spec_id': r['platform_spec_id'],
+            'via': r.get('via'), 'status': r.get('status'), 'version': r.get('version'),
+            'message': '%s：%s（story=%s → platform spec %s, %s）' % (
+                'spec 已上传' if r.get('via') == 'create_spec' else 'spec 已更新',
+                spec_path, zentao_id, r['platform_spec_id'], r.get('status'))}}, 0
+    return {'ok': False, 'error': 'spec 上传失败: %s' % r.get('message')}, 5
+
+
+def _do_link_version(client, my_account, kind, item_id, params):
+    """把 story/bug 关联到 build（禅道「关联版本」按钮触发）。
+
+    Args:
+        kind: story/bug（决定挂到 /builds/{id}/stories 还是 /bugs）
+        item_id: 禅道 story/bug id
+        params: build_id 必填
+    """
+    build_id = params.get('build_id')
+    if not build_id:
+        return {'ok': False, 'error': '关联版本必须指定 --build-id'}, 3
+    obj_key = 'stories' if kind == 'story' else 'bugs'
+    r = client.api('POST', '/builds/%s/%s' % (build_id, obj_key), {obj_key: [item_id]})
+    if r.status_code in (200, 201):
+        return {'ok': True, 'data': {
+            'action': 'link_version', 'id': item_id,
+            'message': '%s #%s 已关联到 build %s' % (kind, item_id, build_id)}}, 0
+    return {'ok': False, 'error': '关联版本失败 (HTTP %s): %s' % (
+        r.status_code, ZentaoClient.err_text(r))}, 5
+
+
+def _do_publish_story(client, my_account, kind, item_id, params):
+    """建禅道 story（禅道「发布需求」按钮触发）。
+
+    新建需求挂产品；可选关联 plan / build。
+    item_id 仅展示用（新建不依赖已有对象）。
+
+    Args:
+        params: product_id 必填；title/spec/pri/category/plan_id/build_id 可选
+    """
+    pid = params.get('product_id')
+    if not pid:
+        return {'ok': False, 'error': '建需求必须指定 --product-id'}, 3
+    try:
+        payload = {
+            'product': int(pid),
+            'title': params.get('title') or '',
+            'spec': params.get('spec', ''),
+            'pri': int(params.get('pri', 3)),
+            'category': params.get('category', 'feature'),
+        }
+    except (ValueError, TypeError):
+        return {'ok': False, 'error': 'product-id/pri 必须是数字。'}, 3
+    if not payload['title']:
+        return {'ok': False, 'error': '建需求必须指定 --title'}, 3
+
+    r = client.api('POST', '/stories', payload)
+    if r.status_code not in (200, 201):
+        return {'ok': False, 'error': '建需求失败 (HTTP %s): %s' % (
+            r.status_code, ZentaoClient.err_text(r))}, 5
+    try:
+        story_id = r.json().get('id')
+    except Exception:
+        story_id = None
+    if not story_id:
+        return {'ok': False, 'error': '建需求响应无 id: %s' % ZentaoClient.err_text(r)}, 5
+
+    # 可选关联 plan
+    plan_id = params.get('plan_id')
+    if plan_id:
+        try:
+            client.api('POST', '/plans/%s/stories' % plan_id, {'stories': [story_id]})
+        except Exception:
+            pass  # 关联失败不阻塞主流程（需求已建好）
+
+    # 可选关联 build
+    build_id = params.get('build_id')
+    if build_id:
+        _do_link_version(client, my_account, 'story', story_id, {'build_id': build_id})
+
+    return {'ok': True, 'data': {
+        'action': 'publish_story', 'story_id': story_id,
+        'message': '需求 #%s 已创建（产品 %s）%s' % (
+            story_id, pid, (' 并关联 build %s' % build_id) if build_id else '')}}, 0
+
+
+# 禅道写操作的 HTTP 调度表: action -> (method, path_tpl, payload_builder, ok_msg)
+# payload_builder(args_dict) -> payload_dict
+def _do_action(client, my_account, action, item_id, params):
+    """执行单个写操作。返回 (result_dict, exit_code)。"""
+    developer = get_developer()
+    my_account = my_account or (_resolve_my_account(developer)[0] if developer else None)
+    if not my_account:
+        return {'ok': False, 'error': '未识别禅道身份, 无法校验归属。请配 member.json 的 zentao_account。'}, 3
+
+    # spec 确认上传（不走禅道 HTTP 写，调 spec_upload 回流平台）
+    if action == 'confirm_spec':
+        _k = params.get('kind') or 'task'
+        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
+        return _do_confirm_spec(client, my_account, _k, item_id, params)
+
+    # story 域写操作（自定义逻辑，独立函数分支，同 confirm_spec）
+    if action == 'publish_story':
+        return _do_publish_story(client, my_account, 'story', item_id, params)
+    if action == 'link_version':
+        _k = params.get('kind') or 'story'
+        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
+        return _do_link_version(client, my_account, _k, item_id, params)
+
+    # action 分派
+    ACTIONS = {
+        # 任务类 (kind=task)
+        'start_task':      ('task', 'POST', '/tasks/%s/start',  {'left': 'left'}),
+        'pause_task':      ('task', 'POST', '/tasks/%s/pause',  {}),
+        'finish_task':     ('task', 'POST', '/tasks/%s/finish', {'left': 'left', 'consumed': 'consumed'}),
+        'log_effort':      ('task', 'POST', '/tasks/%s/estimate', {'consumed': 'consumed', 'left': 'left'}),
+        # Bug 类 (kind=bug)
+        'confirm_bug':     ('bug',  'POST', '/bugs/%s/confirm', {}),
+        'resolve_bug':     ('bug',  'POST', '/bugs/%s/resolve', {'resolution': 'resolution', 'comment': 'comment'}),
+    }
+    if action not in ACTIONS:
+        return {'ok': False, 'error': '未知操作: %s。支持: %s' % (action, ', '.join(ACTIONS.keys()))}, 3
+
+    kind, method, path_tpl, fields = ACTIONS[action]
+    path = path_tpl % item_id
+
+    # ① 归属校验 (防误改队友)
+    guard = _check_owner(client, my_account, kind, item_id)
+    if guard:
+        return {'ok': False, 'error': guard}, 4
+
+    # ② 拼 payload (只取该操作关心的字段)
+    payload = {}
+    for pkey, fkey in fields.items():
+        v = params.get(fkey)
+        if v is not None and v != '':
+            try:
+                payload[pkey] = float(v) if fkey in ('left', 'consumed') else v
+            except (ValueError, TypeError):
+                payload[pkey] = v
+
+    # ③ 各操作的必填字段兜底 (实测禅道校验)
+    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)
+    if r.status_code in (200, 201):
+        label = {
+            'start_task': '已开始', 'pause_task': '已暂停', 'finish_task': '已完成',
+            'log_effort': '已记工时', 'confirm_bug': '已确认', 'resolve_bug': '已解决',
+        }[action]
+        return {'ok': True, 'data': {'action': action, 'id': item_id, 'message': '%s #%s %s' % (kind, item_id, label)}}, 0
+    return {'ok': False, 'error': '操作失败 (HTTP %s): %s。可能权限不足或当前状态不允许。' % (
+        r.status_code, ZentaoClient.err_text(r))}, 5
+
+
+def perform_action(action, item_id, params=None):
+    """写操作入口。返回 (result_dict, exit_code)。"""
+    params = params or {}
+    # confirm_spec: 已显式给 spec_path + zentao_id 时不依赖禅道连接（直接回流平台）
+    if action == 'confirm_spec' and params.get('spec_path') and params.get('zentao_id'):
+        _k = params.get('kind') or 'task'
+        _k = {'tasks': 'task', 'bugs': 'bug', 'stories': 'story'}.get(_k, _k)
+        return _do_confirm_spec(None, None, _k, item_id, params)
+    client = _zentao_creds()
+    if client is None:
+        return {'ok': False, 'error': '禅道凭据未配置。'}, 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
+    developer = get_developer()
+    my_account, err = _resolve_my_account(developer) if developer else (None, '未识别开发者身份')
+    if err and not my_account:
+        return {'ok': False, 'error': err}, 3
+    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 _query_kg_semantic(query, top_k=5):
+    """调 kg.py semantic 语义搜索 (概念检索, 理解业务含义)。
+
+    比 prefetch 的关键词匹配更强: 查"数据权限"能命中 permission/auth 等概念相关代码。
+    用于补充 prefetch 可能漏掉的语义相关文件。带超时, daemon 未启动时冷启动~27s。
+    """
+    import subprocess
+    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'kg.py')
+    if not os.path.isfile(script):
+        return []
+    try:
+        r = subprocess.run(
+            ['python', script, 'semantic', query, '--top', str(top_k)],
+            capture_output=True, text=True, timeout=35, encoding='utf-8', errors='replace')
+        if r.returncode != 0 or '[error]' in r.stdout:
+            return []
+        # 解析输出: "  0.849  数据权限 handlePermission"
+        import re
+        results = []
+        for line in r.stdout.split('\n'):
+            m = re.match(r'\s*([\d.]+)\s+(.+)', line)
+            if m:
+                results.append(m.group(2).strip())
+        return results[:top_k]
+    except Exception:
+        return []
+
+
+def _query_kg_impact(keyword):
+    """调 kg.py impact 影响分析 (改某模块影响哪些端点/Controller)。
+
+    用于 bug 提示词的"影响范围"——告诉 AI 这个改动会波及哪些接口。
+    """
+    import subprocess
+    script = os.path.join(_SCRIPTS, 'domain', 'kg', 'kg.py')
+    if not os.path.isfile(script):
+        return []
+    try:
+        r = subprocess.run(
+            ['python', script, 'impact', keyword],
+            capture_output=True, text=True, timeout=15, encoding='utf-8', errors='replace')
+        if r.returncode != 0 or '未找到' in r.stdout:
+            return []
+        # 解析: 提取 Controller 名和端点
+        import re
+        controllers = set()
+        endpoints = set()
+        for line in r.stdout.split('\n'):
+            m = re.match(r'\s+后端:\s*(\S+)', line)
+            if m:
+                controllers.add(m.group(1))
+            m2 = re.match(r'^###\s+(\S+)', line)
+            if m2 and m2.group(1).startswith('/'):
+                endpoints.add(m2.group(1))
+        return {'controllers': list(controllers)[:6], 'endpoints': list(endpoints)[:6]}
+    except Exception:
+        return {}
+
+
+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': ''}
+
+    # 自身详情 (zentao 路径: task→tasks, bug→bugs, story→stories — story +es 不是 +s)
+    _kind_path = {'task': 'tasks', 'bug': 'bugs', 'story': 'stories'}.get(kind, kind + 's')
+    path = '/%s/%s' % (_kind_path, 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', '')  # 故事详情=spec；spec 空则无详情(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)
+    # kind=story: 故事本身就是需求，story_id 用自身 id（不找父 story，story 的 data.story 是父/None）
+    if kind == 'story':
+        story_id = item_id
+    else:
+        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
+        if kind == 'story':
+            # 故事自身即需求，用已取的 data（不重复 fetch /stories/{自身}）
+            out['story_title'] = str(data.get('title', ''))
+            out['story_spec'] = detail  # 已 _clean_html 过（kind=story 时 raw=spec or title）
+        else:
+            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)
+
+    # 平台上下文（按禅道 story 反查需求→spec + 代码变更史）
+    try:
+        if d.get('story_id'):
+            from domain.integration.spec_upload import _resolve_endpoint, _mcp_call
+            _base, _tok, _pid = _resolve_endpoint()
+            if _tok:
+                _sid = str(d['story_id'])
+                _ps = _mcp_call(_base, _tok, "find_specs_by_zentao",
+                                {"zentao_id": _sid, "project_id": _pid})
+                _cc = _mcp_call(_base, _tok, "code_changes",
+                                {"project_id": _pid, "req_key": "XQ" + _sid, "mode": "summary"})
+                if _ps.get("specs") or _cc.get("commits") or _cc.get("functions"):
+                    lines.append('')
+                    lines.append('## 平台上下文（禅道 #%s → %s）' % (
+                        _sid, _ps.get("requirement_title") or ("XQ" + _sid)))
+                    for _s in (_ps.get("specs") or []):
+                        lines.append('- SPEC [%s] %s v%s：%s' % (
+                            _s.get("status"), _s.get("title"), _s.get("current_version"),
+                            str(_s.get("content_excerpt") or '')[:150].replace("\n", " ")))
+                    if _cc.get("commits") or _cc.get("functions"):
+                        _tf = ', '.join(f.get('fn', '') for f in (_cc.get('top_functions') or [])[:3])
+                        lines.append('- 代码变更史：%s 函数 / %s 提交（top: %s）' % (
+                            _cc.get('functions'), _cc.get('commits'), _tf or '—'))
+    except Exception:
+        pass  # 平台上下文拉不到（无 token/无 story_id）不阻塞 enrich
+
+    # 要做的事（任务化一句，替代通用 4 点 dump）
+    lines.append('')
+    lines.append('## 要做的事')
+    if zt_kind == 'bug':
+        lines.append('定位根因（数据/逻辑/接口/权限？）→ 修复方案（改哪个文件改什么）→ 回归点')
+    elif zt_kind == 'story':
+        lines.append('拆子功能 → 技术方案（接口/表/页面，新建还是改造）→ 实现步骤 → 风险点')
+    else:
+        lines.append('实现思路（用哪些现有代码）→ 改哪个类/方法 → 开发步骤 → 自检点')
+
+    # ── ② 知识图谱增强 (代码定位) ──
+    # 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])}}
+
+    # 代码定位：top-3 文件指针（不 dump API/字段/语义，让 agent 用 rag_search/get_impact/context_360 工具自取深入）
+    if code_list:
+        lines.append('')
+        lines.append('## 代码定位（top %d；细节用 rag_search / get_impact / context_360 工具取）' % min(3, len(ranked_code)))
+        for f, cnt in ranked_code[:3]:
+            mark = ' ←多词命中' if cnt >= 2 else ''
+            lines.append('- `%s`%s' % (f, mark))
+    # bug 影响范围（1 行，不展开）
+    if zt_kind == 'bug' and kws:
+        impact = _query_kg_impact(kws[0])
+        if impact and (impact.get('controllers') or impact.get('endpoints')):
+            hit = (impact.get('controllers') or [])[:3] + (impact.get('endpoints') or [])[:3]
+            lines.append('')
+            lines.append('**影响**：改「%s」波及 %s' % (kws[0], ', '.join(hit)))
+    lines.append('')
+    lines.append('先读上述文件理解现状再动手；细节走工具，别脱离现有架构另起炉灶。')
+    used_kws = ','.join(kws[:3])
+    return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': True, 'keyword': used_kws,
+                                 'counts': {'code': min(3, len(ranked_code)) if code_list else 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('--pretty', action='store_true', help='JSON 美化缩进 (默认紧凑, 面板解析更快)')
+    # 写操作子命令 (v0.3)
+    parser.add_argument('--action', choices=['start_task', 'pause_task', 'finish_task',
+                        'log_effort', 'confirm_bug', 'resolve_bug', 'confirm_spec',
+                        'publish_story', 'link_version'],
+                        help='执行禅道写操作 (面板按钮触发); confirm_spec=确认并上传 spec 到平台; '
+                             'publish_story=建需求; link_version=关联 build')
+    parser.add_argument('--id', type=int, help='写操作的目标 task/bug ID')
+    parser.add_argument('--left', help='剩余工时 (start/finish/log_effort)')
+    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)')
+    # spec 确认上传 (confirm_spec)
+    parser.add_argument('--spec-path', help='本地 spec.md 路径 (confirm_spec; 不传则用当前任务 spec)')
+    parser.add_argument('--code-targets', help='代码目标实体逗号分隔 (confirm_spec, 可选)')
+    parser.add_argument('--zentao-id', help='禅道 story 号 (confirm_spec; 不传则从 --id 反查 story)')
+    # story 域写操作 (publish_story / link_version)
+    parser.add_argument('--product-id', help='产品 ID (publish_story 必填；需求挂产品)')
+    parser.add_argument('--spec', help='需求规格正文 (publish_story)')
+    parser.add_argument('--spec-file', help='需求规格正文文件路径 (publish_story; 优先于 --spec, 规避 shell 长度限制)')
+    parser.add_argument('--pri', type=int, default=3, help='需求优先级 1-4 (publish_story; 默认 3)')
+    parser.add_argument('--plan-id', help='关联计划 ID (publish_story 可选)')
+    parser.add_argument('--build-id', help='关联 build/版本 ID (publish_story 可选; link_version 必填)')
+    # 提示词增强 (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
+    # 写操作分支
+    elif args.action:
+        if not args.id:
+            result = {'ok': False, 'error': '写操作必须提供 --id'}
+            code = 3
+        else:
+            # publish_story 的 spec 正文: --spec-file 优先于 --spec (读文件, 规避 shell 长度限制)
+            spec_text = args.spec or ''
+            if args.spec_file:
+                try:
+                    with open(args.spec_file, encoding='utf-8') as fh:
+                        spec_text = fh.read()
+                except Exception as e:
+                    result = {'ok': False, 'error': '读 --spec-file 失败: %s' % e}
+                    code = 3
+                    spec_text = None
+            if spec_text is not None:
+                params = {'left': args.left, 'consumed': args.consumed,
+                          'resolution': args.resolution, 'comment': args.comment,
+                          'spec_path': args.spec_path, 'code_targets': args.code_targets,
+                          'zentao_id': args.zentao_id, 'kind': args.kind,
+                          'product_id': args.product_id, 'title': args.title,
+                          'spec': spec_text, 'pri': args.pri, 'plan_id': args.plan_id,
+                          'build_id': args.build_id}
+                result, code = perform_action(args.action, args.id, params)
+    else:
+        # 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
+        print(json.dumps(result, ensure_ascii=False, default=str, indent=indent))
+    else:
+        if result.get('ok'):
+            if args.action:
+                print('✅ %s' % result['data'].get('message', '操作成功'))
+            else:
+                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()