@hupan56/wlkj 2.7.5 → 2.7.6

package/package.json

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

package/templates/qoder/scripts/zentao_mcp_server.py

@@ -114,22 +114,80 @@ TOOLS = [
     },
     {
         "name": "create_story",
-        "description": "在禅道创建需求(PRD发布→禅道需求)。例: create_story(product_id=1, title='品质案件催办', spec='需求详情', pri=3)",
+        "description": "在禅道创建需求(PRD发布→禅道需求)。权限不足会返回友好提示不报错。例: create_story(product_id=1, title='品质案件催办', spec='需求详情', pri=3, module=104)",
         "inputSchema": {
             "type": "object",
             "properties": {
                 "product_id": {"type": "integer", "description": "产品ID"},
                 "title": {"type": "string", "description": "需求标题"},
                 "spec": {"type": "string", "description": "需求描述"},
-                "pri": {"type": "integer", "description": "优先级 1-4(1最高)"},
-                "category": {"type": "string", "description": "类别(feature/interface/optimization)"},
+                "pri": {"type": "integer", "description": "优先级 1-4(1最高, 默认3)"},
+                "module": {"type": "integer", "description": "模块ID(可选)"},
+                "category": {"type": "string", "description": "类别(feature/interface/optimization, 默认feature)"},
             },
             "required": ["product_id", "title", "spec"],
         },
     },
+    {
+        "name": "list_plans",
+        "description": "查某产品的计划/迭代列表(让用户选归属)。例: list_plans(product_id=1)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "product_id": {"type": "integer", "description": "产品ID"},
+            },
+            "required": ["product_id"],
+        },
+    },
+    {
+        "name": "list_executions",
+        "description": "查活跃的执行/迭代(按周划分的后端/前端/移动端)。例: list_executions(limit=5)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "limit": {"type": "integer", "description": "返回数量(默认10)"},
+            },
+        },
+    },
+    {
+        "name": "link_story_to_execution",
+        "description": "把需求关联到执行/迭代(让开发能看到)。权限不足返回提示不报错。例: link_story_to_execution(story_id=761, execution_id=73)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "story_id": {"type": "integer", "description": "需求ID"},
+                "execution_id": {"type": "integer", "description": "执行ID"},
+            },
+            "required": ["story_id", "execution_id"],
+        },
+    },
+    {
+        "name": "assign_story",
+        "description": "指派需求给某人(设负责人)。权限不足返回提示不报错。例: assign_story(story_id=761, account='hupan')",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "story_id": {"type": "integer", "description": "需求ID"},
+                "account": {"type": "string", "description": "禅道账号"},
+            },
+            "required": ["story_id", "account"],
+        },
+    },
+    {
+        "name": "change_story_status",
+        "description": "变更需求状态(draft→reviewing→active→closed)。权限不足返回提示不报错。例: change_story_status(story_id=761, status='active')",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "story_id": {"type": "integer", "description": "需求ID"},
+                "status": {"type": "string", "description": "目标状态(draft/reviewing/active/closed)"},
+            },
+            "required": ["story_id", "status"],
+        },
+    },
     {
         "name": "list_execution_tasks",
-        "description": "查某执行的的任务(谁在做什么)。例: list_execution_tasks(execution_id=75)",
+        "description": "查某执行的任务列表(谁在做什么)。例: list_execution_tasks(execution_id=73)",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -141,7 +199,7 @@ TOOLS = [
     },
     {
         "name": "get_story_detail",
-        "description": "查需求详情(完整描述+状态)。例: get_story_detail(story_id=761)",
+        "description": "查需求详情(完整描述+状态+关联)。例: get_story_detail(story_id=761)",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -184,18 +242,89 @@ def _execute_tool(name, args):
 
     if name == 'create_story':
         pid = args.get('product_id', 1)
-        r = _api('POST', '/products/%s/stories' % pid, {
+        payload = {
             'title': args.get('title', ''),
             'spec': args.get('spec', ''),
             'category': args.get('category', 'feature'),
             'pri': args.get('pri', 3),
-        })
+        }
+        if args.get('module'):
+            payload['module'] = args['module']
+        r = _api('POST', '/products/%s/stories' % pid, payload)
         if r.status_code in (200, 201):
             d = r.json()
             sid = d.get('id', '?')
             return '✅ 需求已创建! ID=%s\n禅道地址: %s/story-view-%s.html' % (
                 sid, ZENTAO_URL.rstrip('/'), sid)
-        return '创建失败: %s %s' % (r.status_code, r.text[:150])
+        # 权限不足或字段错误, 友好返回不崩
+        try:
+            err = r.json().get('error', r.text[:100])
+        except Exception:
+            err = r.text[:100]
+        return '⚠️ 需求创建失败: %s\n(可能权限不足或字段缺失, 不影响其它操作)' % err
+
+    if name == 'list_plans':
+        pid = args.get('product_id', 1)
+        r = _api('GET', '/products/%s/plans' % pid)
+        if r.status_code != 200:
+            return '查询计划失败: %s' % r.text[:100]
+        plans = r.json().get('plans', [])
+        if not plans:
+            return '产品 %s 暂无计划。可在禅道里创建计划/迭代。' % pid
+        lines = ['产品 %s 的计划 (%d 个):' % (pid, len(plans))]
+        for p in plans:
+            lines.append('  [%s] %s (%s~%s)' % (
+                p.get('id'), str(p.get('title', ''))[:20], p.get('begin', ''), p.get('end', '')))
+        return '\n'.join(lines)
+
+    if name == 'list_executions':
+        limit = args.get('limit', 10)
+        r = _api('GET', '/executions', {'limit': limit})
+        if r.status_code != 200:
+            return '查询执行失败: %s' % r.text[:100]
+        execs = r.json().get('executions', [])
+        lines = ['活跃执行/迭代 (%d 个):' % len(execs)]
+        for ex in execs[:limit]:
+            lines.append('  [%s] %s (%s~%s project=%s)' % (
+                ex.get('id'), str(ex.get('name', ''))[:15],
+                ex.get('begin', ''), ex.get('end', ''), ex.get('project', '')))
+        return '\n'.join(lines)
+
+    if name == 'link_story_to_execution':
+        sid = args.get('story_id', 0)
+        eid = args.get('execution_id', 0)
+        r = _api('POST', '/executions/%s/stories' % eid, {'stories': [sid]})
+        if r.status_code in (200, 201):
+            return '✅ 需求 #%s 已关联到执行 #%s' % (sid, eid)
+        try:
+            err = r.json().get('error', r.text[:100])
+        except Exception:
+            err = r.text[:100]
+        return '⚠️ 关联失败: %s\n(可能权限不足, 需在禅道手动关联)' % err
+
+    if name == 'assign_story':
+        sid = args.get('story_id', 0)
+        account = args.get('account', '')
+        r = _api('POST', '/stories/%s/assign' % sid, {'assignedTo': account})
+        if r.status_code in (200, 201):
+            return '✅ 需求 #%s 已指派给 %s' % (sid, account)
+        try:
+            err = r.json().get('error', r.text[:100])
+        except Exception:
+            err = r.text[:100]
+        return '⚠️ 指派失败: %s\n(可能权限不足, 需在禅道手动指派)' % err
+
+    if name == 'change_story_status':
+        sid = args.get('story_id', 0)
+        status = args.get('status', '')
+        r = _api('POST', '/stories/%s/change' % sid, {'status': status})
+        if r.status_code in (200, 201):
+            return '✅ 需求 #%s 状态变更为 %s' % (sid, status)
+        try:
+            err = r.json().get('error', r.text[:100])
+        except Exception:
+            err = r.text[:100]
+        return '⚠️ 状态变更失败: %s\n(可能权限不足或状态转换不合法)' % err
 
     if name == 'list_execution_tasks':
         eid = args.get('execution_id', 1)