@hupan56/wlkj 2.7.12 → 3.1.2

package/templates/qoder/scripts/foundation/integrations/zentao_client.py

@@ -0,0 +1,220 @@
+# -*- coding: utf-8 -*-
+"""
+zentao_client.py —— 禅道 HTTP 客户端（唯一真相源）。
+
+消除重复: zentao_sync.py (CLI 批量同步) 和 zentao_mcp_server.py (MCP server)
+原本各自实现了一份禅道 HTTP 层（内网探测/登录/token缓存/API/401重登），
+现统一收敛到本类。
+
+设计:
+    - ZentaoClient(url, user, password)   —— 显式构造
+    - ZentaoClient.from_env()             —— 从 ZENTAO_URL/USER/PASSWORD 环境变量 (mcp_launcher 注入)
+    - ZentaoClient.from_config()          —— 从 .qoder/config.yaml 的 zentao 段 (CLI 用)
+    - 凭据不全时工厂返回 None（调用方自行降级/报错）
+
+    client.check_intranet()  -> (ok, msg)   带缓存，避免连续 ping
+    client.api(method, path, data) -> Response   内含 401 自动重登
+
+与 nexus 的关系:
+    禅道 MCP server (zentao_mcp_server.py) 是 nexus L1 层的 MCP 资产。
+    本 client 是其 HTTP 底座；未来 McpCap 实现后，工作流统一走
+    nexus.resolve().mcp.call("list_execution_tasks")，本 client 仍是底层实现。
+"""
+from __future__ import annotations
+
+import os
+import socket
+from typing import Optional
+
+
+class ZentaoClient:
+    """禅道 REST API 客户端（登录/token/401重登/内网探测）。
+
+    Attributes:
+        url:      禅道根地址（构造时已去尾斜杠）。
+        user/password: 账号密码。
+    """
+
+    def __init__(self, url: str, user: str, password: str, intranet_ttl: int = 60):
+        self.url = (url or '').rstrip('/')
+        self.user = (user or '').strip()
+        self.password = password or ''
+        self._token: Optional[str] = None
+        # 内网可达性缓存 [timestamp, ok, msg]，list 原地写避免 global 声明
+        self._intranet_cache: list = []
+        self._intranet_ttl = intranet_ttl
+
+    # ------------------------------------------------------------------
+    # 工厂
+    # ------------------------------------------------------------------
+
+    @classmethod
+    def from_env(cls) -> Optional['ZentaoClient']:
+        """从环境变量构造（mcp_launcher 注入）。凭据不全返回 None。"""
+        url = os.environ.get('ZENTAO_URL', '').strip()
+        user = os.environ.get('ZENTAO_USER', '').strip()
+        pwd = os.environ.get('ZENTAO_PASSWORD', '')
+        if not url or not user or not pwd:
+            return None
+        return cls(url, user, pwd)
+
+    @classmethod
+    def from_config(cls) -> Optional['ZentaoClient']:
+        """从 .qoder/config.yaml 的 zentao 段构造（CLI 用）。凭据不全返回 None。"""
+        try:
+            from foundation.core.config import load_config_section, SECTIONS
+            cfg = load_config_section(SECTIONS.ZENTAO)
+        except Exception:
+            return None
+        url = (cfg.get('url') or '').strip()
+        user = (cfg.get('user') or '').strip()
+        pwd = (cfg.get('password') or '')
+        if not url or not user or not pwd:
+            return None
+        return cls(url, user, pwd)
+
+    # ------------------------------------------------------------------
+    # 校验
+    # ------------------------------------------------------------------
+
+    def credentials_ok(self) -> tuple[bool, str]:
+        """凭据完整性校验。返回 (ok, msg)。"""
+        missing = []
+        if not self.url:
+            missing.append('url')
+        if not self.user:
+            missing.append('user')
+        if not self.password:
+            missing.append('password')
+        if missing:
+            return False, '禅道凭据未配置 (缺 %s)。请在 .qoder/config.yaml 的 zentao: 段填写。' % '/'.join(missing)
+        return True, ''
+
+    # ------------------------------------------------------------------
+    # 内网探测
+    # ------------------------------------------------------------------
+
+    def _ping_target(self) -> tuple[str, int]:
+        """从 url 解析 (host, port)。"""
+        host = self.url.replace('http://', '').replace('https://', '').split('/')[0]
+        try:
+            port = 80
+            if self.url.count(':') >= 2:
+                port = int(self.url.split(':')[2].split('/')[0])
+        except (ValueError, IndexError):
+            port = 80
+        return host, port
+
+    def check_intranet(self) -> tuple[bool, str]:
+        """内网连通性（带 TTL 缓存，失败不缓存）。
+
+        多工具连续调用时只 ping 一次。失败不缓存，便于网络恢复后立即重试。
+        """
+        import time
+        now = time.time()
+        cached = self._intranet_cache
+        if cached and now - cached[0] < self._intranet_ttl and cached[1]:
+            return cached[1], cached[2]
+        host, port = self._ping_target()
+        try:
+            with socket.create_connection((host, port), timeout=3):
+                self._intranet_cache[:] = [now, True, '']
+                return True, ''
+        except Exception as e:
+            return False, '无法连接禅道 (%s): %s。请确认已连内网。' % (self.url, str(e)[:60])
+
+    # ------------------------------------------------------------------
+    # HTTP
+    # ------------------------------------------------------------------
+
+    @staticmethod
+    def _ensure_requests():
+        """延迟导入 requests（未装时报清晰错误，而非启动即崩）。"""
+        try:
+            import requests
+            return requests
+        except ImportError:
+            raise RuntimeError('缺少 requests 库。请运行: pip install requests')
+
+    def login(self) -> str:
+        """登录拿 token（进程内缓存）。"""
+        if self._token:
+            return self._token
+        requests = self._ensure_requests()
+        r = requests.post(self.url + '/api.php/v1/tokens',
+                          json={'account': self.user, 'password': self.password},
+                          timeout=10)
+        if r.status_code in (200, 201):
+            self._token = r.json().get('token')
+            return self._token
+        raise RuntimeError('禅道登录失败: %s %s' % (r.status_code, r.text[:100]))
+
+    def api(self, method: str, path: str, data: dict | None = None):
+        """调禅道 REST API。401 自动重登一次。
+
+        Args:
+            method: GET/POST/PUT/DELETE
+            path:   /api.php/v1 之后的路径（如 /executions/12/tasks）
+            data:   GET 时作 query params，POST/PUT 时作 json body
+        Returns:
+            requests.Response
+        """
+        requests = self._ensure_requests()
+        token = self.login()
+        full = self.url + '/api.php/v1' + path
+        kwargs = dict(
+            headers={'Token': token},
+            json=data if method in ('POST', 'PUT') else None,
+            params=data if method == 'GET' else None,
+            timeout=15,
+        )
+        r = requests.request(method, full, **kwargs)
+        if r.status_code == 401:
+            self._token = None
+            token = self.login()
+            kwargs['headers'] = {'Token': token}
+            r = requests.request(method, full, **kwargs)
+        return r
+
+    def upload_file(self, file_path: str, title: str = '', extra_fields: dict | None = None):
+        """上传文件到禅道 (multipart/form-data, POST /api.php/v1/files)。
+
+        禅道文件接口需 multipart 而非 JSON, api() 不支持, 故单独实现。
+        用于: 上传原型图 HTML / PRD 附件到需求。
+
+        Args:
+            file_path: 本地文件绝对路径
+            title: 文件标题 (可选, 默认取文件名)
+            extra_fields: 额外表单字段 (如 {'objectType':'story','objectID':812} 关联到对象)
+        Returns:
+            requests.Response
+        """
+        import os
+        requests = self._ensure_requests()
+        token = self.login()
+        full = self.url + '/api.php/v1/files'
+        fname = os.path.basename(file_path)
+        title = title or fname
+        fields = {'title': title}
+        if extra_fields:
+            fields.update(extra_fields)
+        with open(file_path, 'rb') as f:
+            files = {'file': (fname, f, 'application/octet-stream')}
+            r = requests.post(full, headers={'Token': token},
+                              data=fields, files=files, timeout=30)
+        if r.status_code == 401:
+            self._token = None
+            token = self.login()
+            with open(file_path, 'rb') as f:
+                files = {'file': (fname, f, 'application/octet-stream')}
+                r = requests.post(full, headers={'Token': token},
+                                  data=fields, files=files, timeout=30)
+        return r
+
+    @staticmethod
+    def err_text(r) -> str:
+        """从 response 提取错误文本（容错）。"""
+        try:
+            return r.json().get('error', r.text[:120])
+        except Exception:
+            return r.text[:120]

package/templates/qoder/scripts/{common → foundation/io}/filelock.py

@@ -6,7 +6,7 @@ filelock.py - 跨平台原子文件锁
 Windows / macOS / Linux 均无需管理员权限。
 
 用法:
-    from common.filelock import FileLock
+    from foundation.io.filelock import FileLock
     with FileLock('.qoder/.runtime/team-sync.lock', timeout=30):
         # 临界区：同一时刻只有一个进程能进入
         do_critical_work()

package/templates/qoder/scripts/{common → foundation/io}/reqid.py

@@ -36,7 +36,7 @@ if _THIS_DIR not in sys.path:
 try:
     from .atomicio import atomic_write_json, safe_read_json
     from .filelock import FileLock, LockTimeoutError
-    from .paths import get_repo_root
+    from foundation.core.paths import get_repo_root
 except ImportError:
     # 被当作脚本直接运行时
     from atomicio import atomic_write_json, safe_read_json

package/templates/qoder/scripts/foundation/protocol/duckdb_conn.py

@@ -0,0 +1,39 @@
+# -*- coding: utf-8 -*-
+"""
+duckdb_conn —— DuckDB 连接基础设施（L0 基础设施层）。
+
+设计模式: Utility（纯连接管理，无领域语义）
+
+职责：打开/关闭 kg.duckdb 连接。不知道表结构，不知道业务逻辑。
+被 L2（nexus）和 L3（kg/learning）共用，避免 L2 反向依赖 L3。
+
+init_schema 等领域 DDL 留在各域（kg_duckdb.py 定义图谱表，
+nexus/adapters/mcp.py 定义自己的 learning_events 表）。
+"""
+import os
+
+from foundation.core.paths import DATA_INDEX_DIR
+
+DB_PATH = str(DATA_INDEX_DIR / 'kg.duckdb')
+
+
+def get_db():
+    """Open DuckDB read-write connection (creates file if not exists)."""
+    os.makedirs(os.path.dirname(DB_PATH), exist_ok=True)
+    import duckdb
+    return duckdb.connect(DB_PATH)
+
+
+def get_db_readonly():
+    """Open read-only DuckDB connection. Returns None if file missing.
+
+    DuckDB 不允许对同一文件混用 read_only 和 read_write 连接,
+    所以只读路径必须全程用 read_only。
+    """
+    import duckdb
+    if not os.path.isfile(DB_PATH):
+        return None
+    try:
+        return duckdb.connect(DB_PATH, read_only=True)
+    except Exception:
+        return None

package/templates/qoder/scripts/foundation/protocol/mcp_base.py

@@ -0,0 +1,268 @@
+# -*- coding: utf-8 -*-
+"""
+mcp_base.py - MCP Server 基类 (Template Method 模式)
+
+治"3个MCP server协议层逐行复制~255行"。三者(kg/mysql/zentao)的:
+  - _send (JSON-RPC写)
+  - main (readline循环 + 每请求新event_loop)
+  - _handle 五分支骨架 (initialize/notifications/initialized/tools·list/tools·call/ping/error)
+  - stdout重定向 (stdout→stderr, 避免污染stdio协议)
+全部逐字一致, 仅差异点:
+  - serverInfo.name/version
+  - initialize 是否调 check_intranet 塞 warning
+  - tools/call 的异常分类 (mysql 多 ValueError→只读拒绝)
+  - error 分支文案
+
+本基类把骨架固化为 final 方法, 子类填钩子:
+  - SERVER_NAME / SERVER_VERSION: 类属性
+  - TOOLS: 工具元数据列表
+  - handle_tool(name, args) -> str: 工具执行 (Strategy 钩子)
+  - on_initialize_hook(info) -> None: 塞 warning 等 (默认空)
+  - on_tool_error(e) -> (text, is_error): 自定义异常分类 (默认通用)
+
+Usage (子类示例):
+    from foundation.protocol.mcp_base import BaseMCPServer
+
+    class ZentaoMCPServer(BaseMCPServer):
+        SERVER_NAME = "qoder-zentao"
+        SERVER_VERSION = "1.0.0"
+        TOOLS = [...]   # 工具元数据
+        def handle_tool(self, name, args):
+            if name == 'list_stories': return self._list_stories(args)
+            return '未知工具: %s' % name
+        def on_initialize_hook(self, info):
+            ok, msg = check_intranet()
+            if not ok: info['warning'] = msg
+
+    if __name__ == '__main__':
+        ZentaoMCPServer().run()
+
+收益: 加第4个MCP server从复制~255行降到写~30行(只填tools+handle_tool)。
+
+v3.0+ 增强: ToolRegistry + @tool 装饰器 (Command Registry 模式)。
+消除子类 _execute_tool 的长 if-elif 链 + TOOLS 元数据两处维护的漂移。
+用法见底部示例。
+"""
+
+import asyncio
+import json
+import os
+import sys
+from typing import Any, Dict, List, Optional, Tuple
+
+__all__ = ["BaseMCPServer", "tool", "ToolRegistry"]
+
+
+# ============================================================
+# ToolRegistry: @tool 装饰器收集工具定义 (Command Registry 模式)
+# ============================================================
+
+def tool(name: str, description: str = "", input_schema: Optional[Dict] = None):
+    """装饰器: 把一个方法注册为 MCP 工具。
+
+    替代旧式的 "TOOLS 列表 + _execute_tool if 链 两处维护"。
+    装饰后, BaseMCPServer.TOOLS 自动收集, handle_tool 自动分发。
+
+    Usage (子类内):
+        @tool("search_code", "搜代码", {"type":"object","properties":{...}})
+        def search_code(self, args):
+            return "结果文本"
+    """
+    def decorator(method):
+        method._tool_meta = {
+            "name": name,
+            "description": description or method.__doc__ or "",
+            "inputSchema": input_schema or {"type": "object", "properties": {}},
+        }
+        return method
+    return decorator
+
+
+class _ToolRegistryMeta(type):
+    """元类: 子类定义完成后, 扫描 @tool 装饰的方法, 自动填充 TOOLS + _tool_map。
+
+    这样子类只需用 @tool 装饰, 不用再手写 TOOLS 列表和 handle_tool if 链。
+    """
+    def __new__(mcs, name, bases, namespace):
+        cls = super().__new__(mcs, name, bases, namespace)
+        # 收集本类 + 父类的 @tool 方法
+        tool_map = {}
+        # 先继承父类的
+        for base in bases:
+            if hasattr(base, "_tool_map"):
+                tool_map.update(base._tool_map)
+        # 再收集本类的
+        for attr_name, attr_val in namespace.items():
+            meta = getattr(attr_val, "_tool_meta", None)
+            if meta:
+                tool_map[meta["name"]] = {
+                    "meta": meta,
+                    "handler": attr_name,  # 方法名, 运行时 getattr 取
+                }
+        cls._tool_map = tool_map
+        # 如果子类没显式定义 TOOLS (用装饰器模式), 自动生成
+        if tool_map and not namespace.get("TOOLS"):
+            cls.TOOLS = [v["meta"] for v in tool_map.values()]
+        return cls
+
+
+class BaseMCPServer(metaclass=_ToolRegistryMeta):
+    """MCP stdio server 基类 (Template Method + ToolRegistry)。
+
+    两种用法 (二选一):
+    A) 装饰器模式 (推荐, 消除 if 链):
+        class MyServer(BaseMCPServer):
+            SERVER_NAME = "my"
+            @tool("foo", "做foo", {...})
+            def foo(self, args): return "结果"
+        # TOOLS 自动收集, handle_tool 自动分发, 无需覆写
+    B) 传统模式 (兼容旧代码):
+        class MyServer(BaseMCPServer):
+            SERVER_NAME = "my"
+            TOOLS = [...]   # 手写
+            def handle_tool(self, name, args): ...  # 手写 if 链
+    """
+
+    # ---- 子类必填类属性 ----
+    SERVER_NAME: str = "qoder-mcp"
+    SERVER_VERSION: str = "0.1.0"
+    TOOLS: List[Dict[str, Any]] = []
+    _tool_map: Dict[str, Dict] = {}  # 由元类自动填充
+
+    # ---- 协议常量 (可覆写) ----
+    PROTOCOL_VERSION: str = "2024-11-05"
+
+    # ============================================================
+    # 内部: stdout 重定向 (MCP 用 stdout 传 JSON-RPC, 不能被 print 污染)
+    # ============================================================
+    _real_stdout = None
+
+    @classmethod
+    def _setup_streams(cls):
+        """把 sys.stdout 存起来, 重定向 sys.stdout→stderr (子进程的 print 进 stderr)。"""
+        if cls._real_stdout is None:
+            cls._real_stdout = sys.stdout
+            sys.stdout = sys.stderr
+
+    # ============================================================
+    # final: 协议发送
+    # ============================================================
+    @classmethod
+    def _send(cls, msg: Dict[str, Any]) -> None:
+        """发送 JSON-RPC 消息到真实 stdout (跨3个server逐字一致)。"""
+        cls._real_stdout.write(json.dumps(msg, ensure_ascii=False) + "\n")
+        cls._real_stdout.flush()
+
+    # ============================================================
+    # 默认 handle_tool: 从 _tool_map 自动分发 (装饰器模式)
+    # ============================================================
+    def handle_tool(self, name: str, args: Dict[str, Any]) -> str:
+        """[默认实现] 从 ToolRegistry 取 handler 执行。
+
+        - 若用了 @tool 装饰器: 自动分发, 子类不覆写
+        - 若传统模式 (子类覆写了 handle_tool): 走子类的 if 链
+        """
+        entry = self._tool_map.get(name)
+        if entry:
+            handler = getattr(self, entry["handler"])
+            return handler(args)
+        return "未知工具: %s" % name
+
+    def on_initialize_hook(self, info: Dict[str, Any]) -> None:
+        """[可选覆写] initialize 时往 serverInfo 塞额外信息 (如 warning)。
+
+        默认空。mysql/zentao 在此调 check_intranet 塞 warning。
+        """
+        pass
+
+    def on_tool_error(self, e: Exception) -> Tuple[str, bool]:
+        """[可选覆写] tools/call 抛异常时的分类。
+
+        Returns:
+            (text, is_error): 返回给客户端的文本 + 是否标记为错误
+        默认: 通用异常 → "[error] xxx" + is_error=True。
+        mysql 覆写此方法把 ValueError(只读拒绝)单独分类。
+        """
+        return ("[error] %s" % str(e)[:200], True)
+
+    # ============================================================
+    # final: 请求处理骨架 (Template Method)
+    # ============================================================
+    async def _handle(self, req: Dict[str, Any]) -> None:
+        """处理一个 JSON-RPC 请求 (五分支骨架, 子类不覆写)。"""
+        method = req.get("method", "")
+        req_id = req.get("id")
+        params = req.get("params", {}) or {}
+
+        if method == "initialize":
+            info = {"name": self.SERVER_NAME, "version": self.SERVER_VERSION}
+            self.on_initialize_hook(info)  # 钩子: 子类塞 warning
+            self._send({
+                "jsonrpc": "2.0", "id": req_id,
+                "result": {
+                    "protocolVersion": self.PROTOCOL_VERSION,
+                    "capabilities": {"tools": {}},
+                    "serverInfo": info,
+                },
+            })
+        elif method == "notifications/initialized":
+            pass
+        elif method == "tools/list":
+            self._send({"jsonrpc": "2.0", "id": req_id, "result": {"tools": self.TOOLS}})
+        elif method == "tools/call":
+            tool_name = params.get("name", "")
+            arguments = params.get("arguments", {}) or {}
+            try:
+                result_text = await asyncio.get_event_loop().run_in_executor(
+                    None, self.handle_tool, tool_name, arguments
+                )
+                self._send({
+                    "jsonrpc": "2.0", "id": req_id,
+                    "result": {
+                        "content": [{"type": "text", "text": result_text}],
+                        "isError": False,
+                    },
+                })
+            except Exception as e:
+                text, is_error = self.on_tool_error(e)
+                self._send({
+                    "jsonrpc": "2.0", "id": req_id,
+                    "result": {
+                        "content": [{"type": "text", "text": text}],
+                        "isError": is_error,
+                    },
+                })
+        elif method == "ping":
+            self._send({"jsonrpc": "2.0", "id": req_id, "result": {}})
+        elif req_id is not None:
+            self._send({
+                "jsonrpc": "2.0", "id": req_id,
+                "error": {"code": -32601, "message": "Method not found: %s" % method},
+            })
+
+    # ============================================================
+    # final: 主循环
+    # ============================================================
+    def run(self) -> None:
+        """启动 stdio 主循环 (readline → 解析 → _handle)。子类不覆写。"""
+        self._setup_streams()
+        tag = "[%s]" % self.SERVER_NAME
+        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(self._handle(req))
+                loop.close()
+            except json.JSONDecodeError:
+                pass
+            except Exception as e:
+                print("%s error: %s" % (tag, str(e)[:80]), file=sys.stderr)

package/templates/qoder/scripts/{common → foundation/utils}/eval_api.py

@@ -26,6 +26,7 @@ eval_prd.py 的 main() 也改为调用本模块。
 
 import os
 import sys
+import re
 
 _THIS_DIR = os.path.dirname(os.path.abspath(__file__))
 _SCRIPTS_DIR = os.path.dirname(_THIS_DIR)
@@ -33,7 +34,7 @@ if _SCRIPTS_DIR not in sys.path:
     sys.path.insert(0, _SCRIPTS_DIR)
 
 # 复用 eval_prd.py 的评分函数 (不重复实现)
-from eval_prd import (
+from validation.metrics.eval_prd import (
     score_reality, score_style, score_template, read_text,
     FULL_SECTIONS, QUICK_SECTIONS,
 )
@@ -75,6 +76,16 @@ def evaluate(prd_path, html_path=None):
         try:
             r2, msg2, miss2 = score_style(read_text(html_path))
             a2 = round(r2 * 30)
+            # v3.1 来源锚定检查: HTML 必须含 @prototype-source 或 x-source-pages 注释
+            # 没有 = AI 没做 Step 2 真实页面锚定, 直接从模板手抄 → 扣 5 分
+            html_text = read_text(html_path)
+            has_source = bool(re.search(r'@prototype-source:|x-source-pages', html_text))
+            if not has_source:
+                a2 = max(0, a2 - 5)
+                msg2 = (msg2 or '') + '; 缺来源锚定(@prototype-source 注释), 扣 5 分'
+                if miss2 is None:
+                    miss2 = []
+                miss2 = list(miss2) + ['缺 @prototype-source 注释']
         except Exception as e:
             r2, msg2, miss2 = 0.0, "评估异常: %s" % e, []
             a2 = 0

package/templates/qoder/scripts/{common → foundation/utils}/pip_install.py

@@ -35,17 +35,34 @@ def _run_pip(args, index_url=None, timeout=MIRROR_TIMEOUT):
     """跑一次 pip, 返回 (returncode, stdout, stderr)。
     index_url 非 None 时加 -i 指定镜像源。
     用 trusted-host 避免某些镜像的 SSL 证书警告阻断。
+
+    ⚠ 不用 subprocess.run / communicate:
+      Anaconda Python 3.9 + Windows 下, subprocess 的 communicate() 内部 join 读子进程
+      输出的线程时, 会触发 "PyEval_SaveThread: GIL released" 致命崩溃
+      (pip 跑 tree-sitter/playwright/ddddocr 这类大包时尤其稳定复现)。
+      50 人不同环境都要跑这步, 必须跨版本稳。
+
+    解法: Popen + wait(), stdout/stderr 全丢 DEVNULL。
+      pip 的啰嗦输出对我们无用 (成功与否以 _verify_packages 的 import 验证为准),
+      丢了反而避免大输出撑爆管道 + 触发 GIL 崩溃。超时用独立的计时线程判, 不走 communicate。
     """
-    cmd = [sys.executable, '-m', 'pip', 'install'] + args
+    cmd = [sys.executable, '-m', 'pip', 'install', '--no-input',
+           '--progress-bar', 'off'] + args
     if index_url:
         cmd += ['-i', index_url,
                 '--trusted-host', _host_of(index_url)]
     try:
-        r = subprocess.run(cmd, capture_output=True, text=True,
-                           encoding='utf-8', errors='replace', timeout=timeout)
-        return r.returncode, r.stdout or '', r.stderr or ''
-    except subprocess.TimeoutExpired:
-        return 1, '', '安装超时 (%ds)' % timeout
+        proc = subprocess.Popen(cmd, stdout=subprocess.DEVNULL,
+                                stderr=subprocess.DEVNULL)
+        try:
+            rc = proc.wait(timeout=timeout)
+            return rc, '', ''
+        except subprocess.TimeoutExpired:
+            try:
+                proc.kill()
+            except Exception:
+                pass
+            return 1, '', '安装超时 (%ds)' % timeout
     except Exception as e:
         return 1, '', str(e)
 

package/templates/qoder/scripts/{common → foundation/utils}/platform_guard.py

@@ -26,7 +26,7 @@ def _platform_explicitly_passed(argv=None):
     return '--platform' in argv
 
 
-def assert_platform_selected(skill='wl-prd-full', argv=None):
+def assert_platform_selected(skill='wl-prd', argv=None):
     """硬墙: 没显式传 --platform 就调用 PRD 链路脚本 = 违规。
 
     1. best-effort 上报 rule_violation 事件 (不阻塞, 失败静默)