@hupan56/wlkj 2.7.3 → 2.7.5

package/templates/qoder/scripts/mcp_launcher.py

@@ -278,6 +278,40 @@ def launch_mysql(repo):
     os.execv(py, [py, str(server)])
 
 
+ZENTAO_URL_DEFAULT = 'http://10.89.2.91/zentao'
+
+
+def launch_zentao(repo):
+    """启动禅道 MCP。连接信息从 config.yaml 读(团队共享)。"""
+    server = repo / '.qoder' / 'scripts' / 'zentao_mcp_server.py'
+    if not server.is_file():
+        _log(f'zentao server 不存在: {server}')
+        _launch_disabled_mcp('qoder-zentao', 'zentao_mcp_server.py 缺失')
+        return
+    # 从 config.yaml 读禅道配置
+    cfg_path = repo / '.qoder' / 'config.yaml'
+    if cfg_path.is_file():
+        try:
+            import yaml
+            d = yaml.safe_load(cfg_path.read_text(encoding='utf-8')) or {}
+            zt = d.get('zentao', {}) or {}
+            if zt:
+                os.environ['ZENTAO_URL'] = str(zt.get('url', ZENTAO_URL_DEFAULT))
+                os.environ['ZENTAO_USER'] = str(zt.get('user', ''))
+                os.environ['ZENTAO_PASSWORD'] = str(zt.get('password', ''))
+                _log(f'zentao env 从 config.yaml 注入')
+        except Exception:
+            pass
+    _log(f'启动 zentao')
+    py = _find_python_with_deps('requests')
+    if not py:
+        _log('⚠️ 找不到装了 requests 的 Python!')
+        _launch_disabled_mcp('qoder-zentao', 'requests 未装。pip install requests')
+        return
+    _log(f'  python={py}')
+    os.execv(py, [py, str(server)])
+
+
 def launch_lanhu(repo):
     """启动蓝湖 MCP。用 venv 的 3.10+ python (fastmcp 要求), 读角色 cookie。
     没装 lanhu venv 或没配 cookie 时, 输出友好提示并启动一个空壳 MCP
@@ -328,6 +362,7 @@ LAUNCHERS = {
     'kg': launch_kg,
     'knowledge-graph': launch_kg,
     'mysql': launch_mysql,
+    'zentao': launch_zentao,
     'lanhu': launch_lanhu,
 }
 

package/templates/qoder/scripts/zentao_mcp_server.py

@@ -0,0 +1,295 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""ZenTao (禅道) MCP Server - 对接禅道项目管理, 替代本地 task。
+
+禅道自建内网开源版 REST API。
+/wl-task 的底层从本地 task.json 切换到禅道。
+
+工具:
+  - list_products:        列产品(找到需求的归属)
+  - list_stories:         列需求(PRD→禅道需求)
+  - create_story:         创建需求(PRD发布→自动建禅道需求)
+  - list_execution_tasks: 列执行的任务(谁在做什么)
+  - get_story_detail:     查需求详情
+
+认证: 用户名密码 → token (config.yaml zentao 段配, 团队共享)
+"""
+import os
+import sys
+import json
+import socket
+
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except Exception:
+    pass
+
+# 配置 (从环境变量或 config.yaml)
+ZENTAO_URL = os.environ.get('ZENTAO_URL', 'http://10.89.2.91/zentao')
+ZENTAO_USER = os.environ.get('ZENTAO_USER', 'hupan')
+ZENTAO_PASSWORD = os.environ.get('ZENTAO_PASSWORD', 'Aa123456')
+PING_HOST = ZENTAO_URL.replace('http://', '').replace('https://', '').split('/')[0]
+PING_PORT = 80 if '://' not in ZENTAO_URL or ':80' in ZENTAO_URL else (
+    int(ZENTAO_URL.split(':')[2].split('/')[0]) if ZENTAO_URL.count(':') >= 2 else 80
+)
+
+_real_stdout = sys.stdout
+sys.stdout = sys.stderr
+
+try:
+    import requests
+except ImportError:
+    sys.stdout = _real_stdout
+    print('[zentao-mcp] requests 未装, 跑 pip install requests')
+    sys.exit(1)
+
+_TOKEN = None
+_SESSION = None
+
+
+def check_intranet():
+    """内网连通性校验。"""
+    try:
+        host = PING_HOST
+        port = PING_PORT
+        with socket.create_connection((host, port), timeout=3):
+            return True, ''
+    except Exception as e:
+        return False, '无法连接禅道 (%s): %s。请确认已连接内网。' % (ZENTAO_URL, str(e)[:60])
+
+
+def _get_token():
+    """登录拿 token (缓存)。"""
+    global _TOKEN
+    if _TOKEN:
+        return _TOKEN
+    r = requests.post(
+        ZENTAO_URL.rstrip('/') + '/api.php/v1/tokens',
+        json={'account': ZENTAO_USER, 'password': ZENTAO_PASSWORD},
+        timeout=10
+    )
+    if r.status_code in (200, 201):
+        _TOKEN = r.json().get('token')
+        return _TOKEN
+    raise RuntimeError('禅道登录失败: %s %s' % (r.status_code, r.text[:100]))
+
+
+def _api(method, path, data=None):
+    """调禅道 API。"""
+    token = _get_token()
+    url = ZENTAO_URL.rstrip('/') + '/api.php/v1' + path
+    r = requests.request(method, url, headers={'Token': token},
+                         json=data if method in ('POST', 'PUT') else None,
+                         params=data if method == 'GET' else None,
+                         timeout=15)
+    if r.status_code == 401:
+        global _TOKEN
+        _TOKEN = None
+        token = _get_token()
+        r = requests.request(method, url, headers={'Token': token},
+                             json=data if method in ('POST', 'PUT') else None,
+                             params=data if method == 'GET' else None,
+                             timeout=15)
+    return r
+
+
+TOOLS = [
+    {
+        "name": "list_products",
+        "description": "列禅道产品(找到需求归属)。例: list_products()",
+        "inputSchema": {"type": "object", "properties": {}},
+    },
+    {
+        "name": "list_stories",
+        "description": "查某产品的需求列表。例: list_stories(product_id=1, limit=10)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "product_id": {"type": "integer", "description": "产品ID"},
+                "limit": {"type": "integer", "description": "返回数量(默认20)"},
+            },
+            "required": ["product_id"],
+        },
+    },
+    {
+        "name": "create_story",
+        "description": "在禅道创建需求(PRD发布→禅道需求)。例: create_story(product_id=1, title='品质案件催办', spec='需求详情', pri=3)",
+        "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)"},
+            },
+            "required": ["product_id", "title", "spec"],
+        },
+    },
+    {
+        "name": "list_execution_tasks",
+        "description": "查某执行的的任务(谁在做什么)。例: list_execution_tasks(execution_id=75)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "execution_id": {"type": "integer", "description": "执行ID"},
+                "limit": {"type": "integer", "description": "返回数量"},
+            },
+            "required": ["execution_id"],
+        },
+    },
+    {
+        "name": "get_story_detail",
+        "description": "查需求详情(完整描述+状态)。例: get_story_detail(story_id=761)",
+        "inputSchema": {
+            "type": "object",
+            "properties": {
+                "story_id": {"type": "integer", "description": "需求ID"},
+            },
+            "required": ["story_id"],
+        },
+    },
+]
+
+
+def _execute_tool(name, args):
+    args = args or {}
+    ok, msg = check_intranet()
+    if not ok:
+        return msg
+
+    if name == 'list_products':
+        r = _api('GET', '/products')
+        if r.status_code != 200:
+            return '查询失败: %s' % r.text[:100]
+        products = r.json().get('products', [])
+        lines = ['禅道产品 (%d 个):' % len(products)]
+        for p in products:
+            lines.append('  [%s] %s' % (p.get('id'), p.get('name', '')[:20]))
+        return '\n'.join(lines)
+
+    if name == 'list_stories':
+        pid = args.get('product_id', 1)
+        limit = args.get('limit', 20)
+        r = _api('GET', '/products/%s/stories' % pid, {'limit': limit})
+        if r.status_code not in (200, 201):
+            return '查询失败: %s' % r.text[:100]
+        stories = r.json().get('stories', [])
+        lines = ['产品 %s 的需求 (%d 个):' % (pid, len(stories))]
+        for s in stories[:limit]:
+            lines.append('  [#%s] %s (pri=%s status=%s)' % (
+                s.get('id'), s.get('title', '')[:30], s.get('pri'), s.get('status')))
+        return '\n'.join(lines)
+
+    if name == 'create_story':
+        pid = args.get('product_id', 1)
+        r = _api('POST', '/products/%s/stories' % pid, {
+            'title': args.get('title', ''),
+            'spec': args.get('spec', ''),
+            'category': args.get('category', 'feature'),
+            'pri': args.get('pri', 3),
+        })
+        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])
+
+    if name == 'list_execution_tasks':
+        eid = args.get('execution_id', 1)
+        r = _api('GET', '/executions/%s/tasks' % eid)
+        if r.status_code != 200:
+            return '查询失败: %s' % r.text[:100]
+        tasks = r.json().get('tasks', [])
+        lines = ['执行 %s 的任务 (%d 个):' % (eid, len(tasks))]
+        for t in tasks[:20]:
+            if isinstance(t, dict):
+                lines.append('  [#%s] %s (assignedTo=%s status=%s)' % (
+                    t.get('id'), str(t.get('name', ''))[:25],
+                    t.get('assignedTo', ''), t.get('status', '')))
+        return '\n'.join(lines)
+
+    if name == 'get_story_detail':
+        sid = args.get('story_id', 0)
+        r = _api('GET', '/stories/%s' % sid)
+        if r.status_code != 200:
+            return '查询失败: %s' % r.text[:100]
+        s = r.json()
+        return '需求 #%s: %s\n状态: %s\n优先级: %s\n描述: %s' % (
+            sid, s.get('title', ''), s.get('status', ''),
+            s.get('pri', ''), str(s.get('spec', ''))[:200])
+
+    return '未知工具: %s' % name
+
+
+# ── MCP Stdio Protocol ──
+def _send(msg):
+    _real_stdout.write(json.dumps(msg, ensure_ascii=False) + '\n')
+    _real_stdout.flush()
+
+
+async def _handle(req):
+    method = req.get('method', '')
+    req_id = req.get('id')
+    params = req.get('params', {})
+
+    if method == 'initialize':
+        ok, msg = check_intranet()
+        info = {"name": "qoder-zentao", "version": "1.0.0"}
+        if not ok:
+            info['warning'] = msg
+        _send({"jsonrpc": "2.0", "id": req_id, "result": {
+            "protocolVersion": "2024-11-05",
+            "capabilities": {"tools": {}}, "serverInfo": info}})
+    elif method == 'notifications/initialized':
+        pass
+    elif method == 'tools/list':
+        _send({"jsonrpc": "2.0", "id": req_id, "result": {"tools": TOOLS}})
+    elif method == 'tools/call':
+        import asyncio
+        try:
+            result = await asyncio.get_event_loop().run_in_executor(
+                None, _execute_tool, params.get('name', ''), params.get('arguments', {}))
+            _send({"jsonrpc": "2.0", "id": req_id, "result": {
+                "content": [{"type": "text", "text": result}], "isError": False}})
+        except Exception as e:
+            _send({"jsonrpc": "2.0", "id": req_id, "result": {
+                "content": [{"type": "text", "text": "[error] %s" % str(e)[:200]}],
+                "isError": True}})
+    elif method == 'ping':
+        _send({"jsonrpc": "2.0", "id": req_id, "result": {}})
+    elif req_id is not None:
+        _send({"jsonrpc": "2.0", "id": req_id,
+               "error": {"code": -32601, "message": "Method not found"}})
+
+
+def main():
+    import asyncio
+    while True:
+        try:
+            line = sys.stdin.buffer.readline()
+        except (EOFError, OSError):
+            break
+        if not line:
+            break
+        line = line.strip()
+        if not line:
+            continue
+        try:
+            req = json.loads(line.decode('utf-8'))
+            loop = asyncio.new_event_loop()
+            loop.run_until_complete(_handle(req))
+            loop.close()
+        except json.JSONDecodeError:
+            pass
+        except Exception as e:
+            print('[zentao-mcp] error: %s' % str(e)[:80])
+
+
+if __name__ == '__main__':
+    try:
+        main()
+    except KeyboardInterrupt:
+        pass

package/templates/qoder/commands/wl-design-draw.md

@@ -1,78 +0,0 @@
----
-name: wl-design-draw
-description: "画界面/原型。说你要什么，AI 画出来。新页面、改页面、参考竞品都行。"
-argument-hint: "<你要画什么>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu]
----
-
-# /wl-design-draw - 画界面
-
-User input: $ARGUMENTS
-
-> 用户说"画什么"，AI 画出来。就这么简单。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## Step 1: 平台（问了就停）
-
-```
-这个界面是针对哪个平台？
-1. Web 管理端 (fywl-ui)
-2. APP 移动端 (Carmg-H5)
-3. 两端都要
-请选择 (1/2/3):
-```
-
-## Step 2: 如果输入是大板块，先缩小到具体页面
-
-"资产"有 38 个页面，不能直接画。调 `mcp__qoder-knowledge-graph__feature_overview(feature='资产')`，
-列出页面问用户选哪个（**问了就停**）。
-
-具体功能（如"营业外合同筛选"）跳过这步。
-
-## Step 3: 画
-
-**先拿设计约束 + 真实数据（不许跳过，不许手写 HTML）：**
-
-```
-mcp__qoder-knowledge-graph__get_design_system(platform='web')                         → 颜色/布局/按钮/组件
-mcp__qoder-knowledge-graph__fill_prototype(keyword='营业外合同', platform='web')        → 80% 草稿
-```
-
-FALLBACK（无 MCP 时）：
-```bash
-python "$R/.qoder/scripts/gen_design_doc.py"
-python "$R/.qoder/scripts/fill_prototype.py" 营业外合同 --platform web
-```
-
-**拿到草稿后微调：**
-- 按钮用真实文案（数据清单里的，不是编的"新增/编辑"）
-- 补交互细节（弹窗/Tab/折叠）
-- 画完整状态（有数据 + 空状态 + 加载中）
-- **颜色/宽度/间距不许改**（来自真实系统，AI 猜的一定不对）
-
-## 铁律
-
-1. **必须先调 get_design_system + fill_prototype**，不许跳过直接手写
-2. **若设计师录入了蓝湖 spec，fill_prototype 会自动注入**——先确认 `data/style/{关键词}-design-spec.json` 是否存在。若有，fill_prototype 会把蓝湖的真实 `design_tokens`（如 `rgba(255,115,10,1)`）原样注入原型 `:root`，**这一步全自动，不用手动调蓝湖**。验证：看输出原型 `:root` 里有没有 `/* design-import spec tokens (优先级最高) */`
-3. **颜色只用真源**（蓝湖 spec 注入值 > get_design_system 的 HSL，不是 #1890ff）
-4. **按钮用真实文案**（entity-registry 的，不是编的）
-5. **布局参数不猜**（蓝湖 spec 的 width 或 layout_fingerprint 的 160px）
-6. **图标禁 emoji**（Web 用 Ant Design SVG，APP 用 Vant 字体图标）
-7. **画完整状态**（不只画"有数据"，还要画空状态/加载中/错误）
-
-> 蓝湖与画图的关系：**蓝湖在录入环节（/wl-design-spec）发力**，读出的 CSS 值存进 spec.json；
-> 画图时 fill_prototype 自动消费 spec.json，不需要 draw 再调蓝湖。蓝湖没起/没录入？不影响 draw，
-> fill_prototype 降级用 layout_fingerprint + 代码风格，照样出原型（只是不如蓝湖精确）。
-
-## 存储与 Figma
-
-存到 `workspace/members/{developer}/drafts/prototype-{feature}.html`。
-设计师可在 Figma 用 html.to.design 插件导入精修。

package/templates/qoder/commands/wl-design-scan.md

@@ -1,108 +0,0 @@
----
-name: wl-design-scan
-description: "扫描/审视系统现状。看功能模块有哪些页面/按钮/流程/风格/测试覆盖。画原型前必做。"
-argument-hint: "<功能模块名或关键词>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, mcp__qoder-knowledge-graph]
----
-
-# /wl-design-scan - 审视系统现状
-
-User input: $ARGUMENTS
-
-> 画之前先看。设计师/PM 需要理解"系统现在长什么样"才能动手。
-> 这是业界 Discover 阶段的工具——understand before you design。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## 第一步：判断用户想看什么
-
-| 用户说什么 | 调什么 | 返回什么 |
-|-----------|--------|---------|
-| "XX 有哪些页面""XX 功能模块" | `feature_overview(feature='XX')` | 页面列表 + 端点数 + 按钮数 + 测试数 |
-| "XX 的操作流程""XX 业务流程" | `get_workflow(module='XX')` | 操作链（查询→新增→审批→...） |
-| "XX 用什么风格""系统主色" | `get_design_system(platform='web')` | token + 布局指纹 + 组件表 + 真实按钮 |
-| "XX 有没有测试""XX 测试覆盖" | `coverage_matrix()` | 17 个功能的测试覆盖红黄绿 |
-| "改 XX 影响什么" | `get_impact(endpoint='XX')` | 影响页面数 + 操作数 + 可回归测试 |
-| "XX 按钮 调什么接口" | `context_360(symbol='handleXX')` | 按钮关联的 API + Controller + 调用链 |
-| 模糊 | 先问 | "你想看功能模块、操作流程、设计风格、测试覆盖、还是影响分析？" |
-
-## 第二步：执行查询
-
-**PREFERRED: MCP 工具**（QoderWork 有 MCP 时直接调）
-```
-mcp__qoder-knowledge-graph__feature_overview(feature='资产管理')
-mcp__qoder-knowledge-graph__get_workflow(module='资产')
-mcp__qoder-knowledge-graph__get_design_system(platform='web')
-```
-
-**FALLBACK: Python 脚本**
-```bash
-python "$R/.qoder/scripts/search_index.py" 资产 --platform web
-python "$R/.qoder/scripts/search_index.py" --style table --platform web
-python "$R/.qoder/scripts/search_index.py" --field assetName
-```
-
-## 第三步：结构化输出
-
-不是简单返回数据，而是**帮用户理解**：
-
-### 功能模块视图（用户说"XX 有哪些页面"时）
-```
-📊 资产管理 (assets) 模块全景
-   页面: 38 个
-   API: 12 个端点
-   按钮: 108 个操作
-   测试: 3 个测试用例 (覆盖率偏低 ⚠️)
-
-   主要页面类型:
-   - table-page: 20 个 (异常申请/记录/分析...)
-   - form-page: 12 个 (新增/编辑/审批...)
-   - dashboard: 3 个 (资产看板)
-   - detail-page: 3 个
-
-   标杆页面 (最适合做参考的):
-   1. assets/abnormal/apply/index.vue (异常申请, 19个字段)
-   2. assets/abnormalManage/abnormalAnalysis/index.vue (分析看板)
-```
-
-### 操作流程视图（用户说"XX 流程"时）
-```
-🔄 资产管理操作链 (7 步)
-   查询 → 新增 → 提交 → 审批 → 归档 → 导出 → 删除
-
-   ⚠️ 步骤较多 (7步), 考虑优化:
-   - 第3步"提交"和第4步"审批"可能合并
-   - 第6步"导出"可放到工具栏, 不算独立步骤
-```
-
-### 设计风格视图（用户说"XX 风格"时）
-```
-🎨 fywl-ui 设计指纹
-   主色: hsl(214.58, 86.34%, 59.8%) (Vben 蓝)
-   侧边栏: 160px, 浅色, mixed-nav 布局
-   顶栏: 深色, 含 logo + 通知 + 头像
-   圆角: 0.25rem
-   字体: -apple-system, BlinkMacSystemFont, ...
-
-   真实按钮文案示例: 添加反馈资产, 导出Excel, 批量导入, ...
-   常用组件: Modal(273次), Input(135次), FormItem(95次), ...
-```
-
-## 使用示例
-
-```
-/wl-design-scan 资产管理         → 功能模块全景
-/wl-design-scan 资产的操作流程    → 操作链分析
-/wl-design-scan 系统设计风格      → 设计 token + 布局指纹
-/wl-design-scan 哪些功能没测试    → 覆盖矩阵
-/wl-design-scan 改 /asset 影响    → 影响分析
-```
-
-> scan 不产出文件，只返回结构化分析。帮设计师/PM"看清楚"再动手。

package/templates/qoder/commands/wl-design-spec.md

@@ -1,154 +0,0 @@
----
-name: wl-design-spec
-description: "设计交付。录入设计稿→spec.json + 评审原型合规性。设计师和系统对接的唯一入口。"
-argument-hint: "<录入|评审> <描述>"
-auto-approve: true
-allowed-tools: [Read, Glob, Grep, Bash, Write, Edit, mcp__qoder-knowledge-graph, mcp__lanhu]
----
-
-# /wl-design-spec - 设计交付
-
-User input: $ARGUMENTS
-
-> 设计的终点：把设计意图"规格化"让前端能实现，并评审原型是否合规。
-> 包含两个动作：**录入**（设计师→系统）和**评审**（系统→设计师）。
-
-## 🔧 环境自检（QoderWork 桌面端 vs Qoder IDE/CLI）
-
-**先确定仓库根 R**（QoderWork 桌面端工作目录不是仓库根，相对路径会失效）：
-```bash
-R=$(python ~/.qoderwork/repo_root.py 2>/dev/null) || R=.
-```
-> 后续脚本统一用 `python "$R/.qoder/scripts/xxx.py"`。
-
-## 第一步：判断用户要做哪个动作
-
-| 用户说什么 | 动作 | 跳到 |
-|-----------|------|------|
-| "录入""这是 Figma 稿""把这个设计录进去""设计稿录入" | **录入** | 录入段 |
-| "评审""检查""看看这个原型""合规吗" | **评审** | 评审段 |
-| 模糊 | 先问 | "你是要录入设计稿，还是评审现有原型？" |
-
----
-
-## 录入（设计师把 Figma 稿变成 spec.json）
-
-**铁律：平台必须先问。** 问完就停。
-
-### 流程
-
-完整执行见 `.qoder/skills/design-import/SKILL.md`：
-
-1. **录入前先看现状**（让 spec 不是凭空设计，是基于系统增量改进）：
-   ```
-   mcp__qoder-knowledge-graph__feature_overview(feature='资产')     → 这个模块现有页面/按钮
-   mcp__qoder-knowledge-graph__get_workflow(module='资产')           → 现有操作流程
-   mcp__qoder-knowledge-graph__get_design_system(platform='web')     → 现有 token/布局/组件
-   ```
-   设计师据此知道"系统现在有什么、我的设计改了什么"。
-
-2. **收集设计信息**（按精度从高到低）：
-   - **蓝湖链接（最推荐）**：设计师发 `https://lanhuapp.com/web/#/item/...`，走 4 步直读
-     （详见 design-import/SKILL.md 方式 A）：
-       ① `mcp__lanhu__get_designs(url)` 探测+列图（失败就降级截图口述，不报错）
-       ② 让设计师选哪张图（**问了就停**）
-       ③ `mcp__lanhu__get_ai_analyze_design_result(url, design_names)` 读 CSS 标注+切图
-       ④ AI 语义映射进 spec.json（出现最多的色→主色，width→侧边栏...）
-     - **铁律：蓝湖 CSS 值原样填**。`rgba(255,115,10,1)` 不写成 `#FF730A`，`200px` 不四舍五入
-     - STDIO 自动开关（开 QoderWork 自动起/关自动停，无需手动 start）；cookie 按角色在 `workspace/members/{当前用户}/.secrets/lanhu.env`
-   - **截图 + 口述**（蓝湖不可用时降级）：设计师发一张 Figma 截图，口述关键决策
-   - **导出标注**（CSS / JSON / PDF）
-   - **参照现有页面改**（"类似 XX 页面，但侧边栏改成手风琴"）
-
-3. **生成 spec.json**，结构包含：
-   ```json
-   {
-     "platform": "web",
-     "requirement": "异常资产申请页改版",
-     "design_tokens": { "--primary-color": "rgba(255,115,10,1)", "--sidebar-width": "160px" },
-     "layout": { "description": "...", "sidebar": "...", "content": "..." },
-     "components": [{ "name": "...", "spec": "..." }],
-     "behaviors": { "sidebar_collapse": "click", "form_mode": "wizard" },
-     "source": "蓝湖直读 (设计师: XXX)",
-     "lanhu_source": { "url": "...", "image_names": ["..."] }
-   }
-   ```
-   > ⚠️ `requirement` 必须跟未来 `/wl-design-draw` 关键词一致（fill_prototype 靠它匹配）。
-   > 蓝湖来源填 `"source": "蓝湖直读 (...)"` + `lanhu_source`；截图口述只填 `source`。
-
-4. **存储到** `data/style/{需求名}-{平台}-design-spec.json`（平台=web/app，避免同功能多端冲突；同需求同平台重录=覆盖更新）
-   > `requirement` 用"功能名+同义词"（如 `待办 我的待办 设置待办`），让 PM 搜各种词都能命中。
-
-5. **优先级声明**：spec.json > 代码风格 > PDF 规范
-   一旦录入，同需求的 `/wl-design-draw` 必须锚定它。
-
-### 铁律
-
-- **绝不编造 token**：设计师没说的值，留空或标"待确认"
-- **图标必须来自真源**：即使设计师用 emoji 示意，录入时替换成系统真源
-  （Web: `data/index/ref-icon.json` Ant Design SVG；APP: Vant 字体图标）
-- **录入后同需求原型必须锚定它**
-
-### 完成提示
-
-```
-✅ 设计规范已录入: data/style/{需求名}-design-spec.json
-   下次 /wl-design-draw 同关键词时，会自动优先用这份 spec。
-   设计师可随时 /wl-design-spec 录入 更新它。
-```
-
-### Figma 协作流程
-
-设计师在 Figma 精修完设计稿后，导出/截图，用 `/wl-design-spec 录入` 录入。
-完整 Figma 协作指南见 `.qoder/skills/design-import/figma-workflow.md`。
-
----
-
-## 评审（检查原型是否合规）
-
-完整执行见 `.qoder/skills/design-review/SKILL.md`。
-
-读最新的 `workspace/members/{dev}/drafts/prototype-*.html`，按 checklist 评审：
-
-### 评审 checklist
-
-**视觉合规：**
-- [ ] 颜色来自真源（get_design_system 的 HSL token，不是 #1890ff）
-- [ ] 图标来自真源（ref-icon.json 的 SVG，无 emoji）
-- [ ] 侧边栏宽度 = layout_fingerprint 值（fywl-ui 是 160px）
-- [ ] 字体/圆角/间距跟系统一致
-
-**内容合规：**
-- [ ] 按钮文案用了系统真实文案（entity-registry，非编的"新增/编辑"）
-- [ ] 表格列/表单字段来自真实代码（fill_prototype 数据清单）
-- [ ] 若设计师 spec 存在：原型匹配 spec 的布局/配色/组件
-
-**交互合规：**
-- [ ] 交互流程闭环（对照 get_workflow 的操作链，原型覆盖了全部步骤）
-- [ ] 包含完整状态（有数据/空状态/加载中/错误）
-- [ ] 布局跟同功能模块标杆页面一致（对照 feature_overview）
-
-**测试影响：**
-- [ ] 若改动页面有测试覆盖（coverage_matrix），提醒"改动后需回归测试"
-
-### 评审时可调 MCP 工具
-
-- `mcp__qoder-knowledge-graph__feature_overview(feature='XX')` → 功能画像，对比原型是否遗漏
-- `mcp__qoder-knowledge-graph__get_workflow(module='XX')` → 操作链，检查原型是否覆盖完整流程
-- `mcp__coverage_matrix()` → 测试覆盖，判断改动是否需回归
-- `mcp__qoder-knowledge-graph__get_design_system(platform='web')` → 真实 token/按钮做对照
-
-### 输出
-
-报告：PASS 或 🔴/🟡 问题清单（不产文件，只出报告）。
-若不通过，附上修复建议和参考文件路径。
-
----
-
-## 使用示例
-
-```
-/wl-design-spec 录入 这个 Figma 稿        → 录入设计稿
-/wl-design-spec 评审 最新原型              → 评审原型
-/wl-design-spec 这个按钮文案对不对         → 评审（按钮文案检查）
-```