@hupan56/wlkj 3.2.0 → 3.3.0

package/templates/qoder/scripts/domain/task/{zentao_panel.py → wlkj_panel.py}

@@ -1,7 +1,7 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
-zentao_panel.py - 禅道任务面板数据接口 (供 VS Code 扩展 zentao-panel 调用)
+wlkj_panel.py - 开发工作台数据接口（禅道任务 + 平台 spec/impact；供 VS Code 扩展 zentao-panel 调用）
 
 目的: 给侧边栏面板一个稳定的 JSON 数据源, 一次返回"指派给我的【任务+需求+Bug】",
       跨所有执行/产品全量聚合。逻辑与 my_workbench 工具一致 (只读), 但输出 JSON 而非文本。
@@ -13,9 +13,9 @@ zentao_panel.py - 禅道任务面板数据接口 (供 VS Code 扩展 zentao-pane
   收集循环则与 zentao_mcp_server.py:_collect_my_* 逐字一致 (DRY 同款), 保证数据口径统一。
 
 用法:
-  python .qoder/scripts/domain/task/zentao_panel.py --json              # 三域活动项 JSON
-  python .qoder/scripts/domain/task/zentao_panel.py --json --include-closed  # 含已关闭历史项
-  python .qoder/scripts/domain/task/zentao_panel.py --json --kind tasks   # 只看任务
+  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 网络不通。
@@ -436,6 +436,7 @@ def fetch_workbench(include_closed=False, kind=None):
     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
@@ -490,6 +491,139 @@ def _check_owner(client, my_account, kind, item_id):
     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):
@@ -499,6 +633,20 @@ def _do_action(client, my_account, action, item_id, params):
     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)
@@ -575,6 +723,11 @@ def _do_action(client, my_account, action, item_id, params):
 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
@@ -763,6 +916,65 @@ def _parse_prefetch(text):
     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:
@@ -792,8 +1004,9 @@ def _fetch_zentao_detail(client, kind, item_id, max_len=600):
     import re
     out = {'detail': '', 'story_id': 0, 'story_title': '', 'story_spec': '', 'scene': ''}
 
-    # 自身详情
-    path = '/%ss/%s' % (kind, item_id)
+    # 自身详情 (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
@@ -803,7 +1016,7 @@ def _fetch_zentao_detail(client, kind, item_id, max_len=600):
     if kind == 'bug':
         raw = data.get('steps', '')
     elif kind == 'story':
-        raw = data.get('spec', '') or data.get('title', '')
+        raw = data.get('spec', '')  # 故事详情=spec；spec 空则无详情(title 已在关联需求段，不重复)
     else:  # task
         raw = data.get('desc', '')
     detail = _clean_html(raw)
@@ -812,7 +1025,11 @@ def _fetch_zentao_detail(client, kind, item_id, max_len=600):
     out['detail'] = detail
 
     # 场景名: execution 名 (任务) / product 名 (bug/story)
-    story_id = data.get('story') or 0
+    # 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')
@@ -830,14 +1047,19 @@ def _fetch_zentao_detail(client, kind, item_id, max_len=600):
     # 关联需求 (业务背景, 最有价值的上下文)
     if story_id:
         out['story_id'] = story_id
-        sr = client.api('GET', '/stories/%s' % story_id)
-        if sr.status_code == 200:
-            sd = sr.json()
-            out['story_title'] = str(sd.get('title', ''))
-            spec = _clean_html(sd.get('spec', ''))
-            if spec and len(spec) > max_len:
-                spec = spec[:max_len] + '…'
-            out['story_spec'] = spec
+        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
 
@@ -908,24 +1130,41 @@ def enrich_prompt(kind, item_id, title, client=None):
         lines.append('')
         lines.extend(detail_block)
 
-    # 输出要求 (替代啰嗦的"请帮我", 给AI明确的结构化产出指令)
+    # 平台上下文（按禅道 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('## 请按以下结构输出')
+    lines.append('## 要做的事')
     if zt_kind == 'bug':
-        lines.append('1. **根因分析**：结合重现步骤/关联需求，判断是数据问题、逻辑分支、还是接口/权限')
-        lines.append('2. **影响范围**：列出受影响的接口、表、页面（用下面的知识图谱代码定位）')
-        lines.append('3. **修复方案**：具体改哪些文件、改什么，给出关键代码片段')
-        lines.append('4. **回归点**：修复后需要验证哪些场景，避免引入新问题')
+        lines.append('定位根因（数据/逻辑/接口/权限？）→ 修复方案（改哪个文件改什么）→ 回归点')
     elif zt_kind == 'story':
-        lines.append('1. **需求拆解**：把需求拆成可独立实现的子功能点')
-        lines.append('2. **技术方案**：涉及哪些接口/表/页面，新增还是改造（参考下方代码）')
-        lines.append('3. **实现步骤**：按依赖顺序列出开发步骤')
-        lines.append('4. **风险点**：可能影响现有功能的地方')
+        lines.append('拆子功能 → 技术方案（接口/表/页面，新建还是改造）→ 实现步骤 → 风险点')
     else:
-        lines.append('1. **实现思路**：这个任务该怎么实现，用到哪些现有代码')
-        lines.append('2. **代码定位**：在下方知识图谱命中的文件里，具体改哪个类/方法')
-        lines.append('3. **实现步骤**：按顺序的开发步骤')
-        lines.append('4. **自检点**：完成后要验证什么')
+        lines.append('实现思路（用哪些现有代码）→ 改哪个类/方法 → 开发步骤 → 自检点')
 
     # ── ② 知识图谱增强 (代码定位) ──
     # v0.18: 用 prefetch 替代多次 context_pack —— 一次多词合并查询, 更快更准。
@@ -967,31 +1206,25 @@ def enrich_prompt(kind, item_id, title, client=None):
     if not (code_list or api_list or field_list):
         return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': detail_added, 'keyword': ','.join(kws[:3])}}
 
-    # 拼知识图谱上下文 (标注平台 + 多词命中)
-    lines.append('')
-    lines.append('## 知识图谱参考 (%s方向, 关键词: %s)' % (platform_label, ','.join(kws[:3])))
-    lines.append('> 以下是代码库中与该任务相关的文件/接口/字段，用于快速定位实现位置。')
+    # 代码定位：top-3 文件指针（不 dump API/字段/语义，让 agent 用 rag_search/get_impact/context_360 工具自取深入）
     if code_list:
         lines.append('')
-        lines.append('**相关代码文件**：')
-        for f, cnt in ranked_code:
+        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))
-    if api_list:
-        lines.append('')
-        lines.append('**相关接口**：')
-        for a in api_list:
-            lines.append('- `%s`' % a)
-    if field_list:
-        lines.append('')
-        lines.append('**相关字段**：')
-        for fld in field_list:
-            lines.append('- %s' % fld)
+    # 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('请先阅读上述代码文件理解现有实现，再给出改动方案，不要脱离现有架构另起炉灶。')
+    lines.append('先读上述文件理解现状再动手；细节走工具，别脱离现有架构另起炉灶。')
     used_kws = ','.join(kws[:3])
     return {'ok': True, 'data': {'prompt': '\n'.join(lines), 'enriched': True, 'keyword': used_kws,
-                                 'counts': {'code': len(code_list), 'api': len(api_list), 'field': len(field_list)}}}
+                                 'counts': {'code': min(3, len(ranked_code)) if code_list else 0}}}
 
 
 def main():
@@ -1001,13 +1234,26 @@ def main():
     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'],
-                        help='执行禅道写操作 (面板按钮触发)')
+                        '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 用)')
@@ -1057,9 +1303,25 @@ def main():
             result = {'ok': False, 'error': '写操作必须提供 --id'}
             code = 3
         else:
-            params = {'left': args.left, 'consumed': args.consumed,
-                      'resolution': args.resolution, 'comment': args.comment}
-            result, code = perform_action(args.action, args.id, params)
+            # 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