@qingflow-tech/qingflow-cli 1.1.45 → 1.1.47-beta.1

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -852,6 +852,64 @@ class AiBuilderTools(ToolBase):
         """Reconcile one complete declarative AppForm target."""
         return self._app_form.apply(profile=profile, spec=spec)
 
+    def app_form_evaluate_formula(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        formula: str,
+        test_case: dict[int, Any],
+    ) -> JSONObject:
+        """调用后端 POST /ai/coding/formula/validate 对公式求值。
+
+        本地语法校验由 CLI handler 负责；本方法只做后端求值，捕获后端错误为 evaluationError。
+        鉴权/会话错误（未登录/未选工作区）按既有约定向上抛出 QingflowApiError。
+        """
+        _session_profile, _backend_session, context = self._require_context(profile, require_workspace=True)
+        evaluation_result: Any = None
+        evaluation_error: str | None = None
+        try:
+            evaluation_result = self.backend.request(
+                "POST",
+                context,
+                "/ai/coding/formula/validate",
+                json_body={"appKey": app_key, "formula": formula, "testCase": test_case},
+            )
+        except QingflowApiError as exc:
+            evaluation_error = exc.message
+        return {"evaluation": evaluation_result, "evaluationError": evaluation_error}
+
+    def app_form_run_code_block(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        code: str,
+        key_que_values: list[JSONObject],
+    ) -> JSONObject:
+        """调用后端 POST /data/{appKey}/codeBlock/detection 真跑代码块。
+
+        本地静态校验由 CLI handler 负责；本方法只做后端真跑，捕获后端错误为 runError。
+        ``key_que_values`` 需符合后端 OpenMatchQueValue 结构 ``{keyQueId, ordinal?, values}``。
+
+        传入的 ``code`` 是原始 JS（未经前端字段公式加密），必须声明 ``unEncrypted=True``；
+        否则后端 ``DataSvcImpl.codeBlockTest`` 会走 ``FormulaDecoder.extractFormula``
+        对原始 JS 解密并抛 ``QFRuntimeException``，导致后端真跑对所有真实代码必然失败。
+        """
+        _session_profile, _backend_session, context = self._require_context(profile, require_workspace=True)
+        run_result: Any = None
+        run_error: str | None = None
+        try:
+            run_result = self.backend.request(
+                "POST",
+                context,
+                f"/data/{app_key}/codeBlock/detection",
+                json_body={"code": code, "keyQueValues": key_que_values, "unEncrypted": True},
+            )
+        except QingflowApiError as exc:
+            run_error = exc.message
+        return {"runResult": run_result, "runError": run_error}
+
     def app_delete(self, *, profile: str, app_key: str) -> JSONObject:
         """Delete an application explicitly."""
         return self._app_form.delete(profile=profile, app_key=app_key)

package/src/qingflow_mcp/tools/login_link_tools.py

@@ -0,0 +1,114 @@
+from __future__ import annotations
+
+import posixpath
+from typing import Any
+from urllib.parse import parse_qs, unquote, urlencode, urlsplit
+
+from mcp.server.fastmcp import FastMCP
+
+from ..config import DEFAULT_PROFILE, get_web_base_url
+from ..errors import QingflowApiError
+from ..json_types import JSONObject
+from .base import ToolBase
+
+LOGIN_LINK_DESCRIPTION = (
+    "轻流页面入口：查看页面、继续编辑、处理业务、查看结果或进入工作区（open/view/visit page in browser，login）。"
+    "从 AI 对话进入页面时，使用当前 MCP 身份和工作区生成短时（约 5 分钟）一次性免登录链接。"
+    "redirect_path 可选：传已确认的站内业务路径，可带 query/hash；省略进入首页，不接受外部地址或认证入口。"
+    "纯数据查询无需调用；用户指定页面但路径未知时先定位，不猜路径或静默改为首页。"
+    "返回 url 和毫秒整数 expires_at；必要安全验证及原有页面权限仍然生效。"
+    "用户要链接时仅交付，不提前消费；要求打开时才用浏览器打开返回的完整链接。"
+)
+
+
+def validate_redirect_path(value: str) -> str:
+    """只接受业务站内路径；解码仅用于校验，不改写查询参数或片段。"""
+    if not value or not value.strip():
+        return ""
+    auth_paths = (
+        "/mcp-login", "/qingclaw-login", "/passport", "/login-third-party", "/third-party-login",
+        "/third-party", "/oidc-authorize", "/oauth2/authorize", "/authorize", "/sso", "/ldap",
+        "/pcWechatAutoBind", "/code-login", "/work-wechat-error", "/ding-check-ws",
+    )
+    try:
+        path = unquote(urlsplit(value).path, errors="strict")
+        if (
+            not value.startswith("/") or value.startswith("//") or path.startswith("//")
+            or "\\" in value or "\\" in path or any(c in path for c in "%?#")
+            or any(ord(c) < 32 or ord(c) == 127 for c in value + path)
+        ):
+            raise ValueError
+        normalized = posixpath.normpath(path)
+        if any(normalized == p or normalized.startswith(p + "/") for p in auth_paths):
+            raise ValueError
+    except (ValueError, UnicodeError):
+        raise QingflowApiError(category="validation", message="redirect_path 必须是站内业务路径，不能指向认证入口") from None
+    return value
+
+
+class LoginLinkTools(ToolBase):
+    """登录链接工具（中文名：临时免登录链接）。
+
+    类型：会话辅助工具。
+    主要职责：
+    1. 为当前 MCP 用户签发进入当前工作区网页端的临时免登录链接；
+    2. 链接短时（5 分钟）、一次性，不携带 MCP 长期凭证或正式登录 token。
+
+    安全约束：
+    - 用户身份仅来自当前 MCP 会话（业务 token），不接收任何 uid 参数；
+    - 目标工作区固定为当前选中的 MCP 工作区，不开放任意跳转地址。
+    """
+
+    def register(self, mcp: FastMCP) -> None:
+        """注册当前工具到 MCP 服务。"""
+
+        @mcp.tool(description=LOGIN_LINK_DESCRIPTION)
+        def get_login_link(profile: str = DEFAULT_PROFILE, redirect_path: str = "") -> dict[str, Any]:
+            return self.get_login_link(profile=profile, redirect_path=redirect_path)
+
+    def get_login_link(self, *, profile: str, redirect_path: str = "") -> JSONObject:
+        """执行工具方法逻辑。"""
+
+        def runner(session_profile, context):
+            target = validate_redirect_path(redirect_path)
+            web_base_url = get_web_base_url()
+            result = self.backend.request(
+                "POST",
+                context,
+                "/mcp/auth/login-link",
+                json_body={"wsId": session_profile.selected_ws_id},
+            )
+            # 后端仅提供票据，网页地址由 MCP 配置确定，避免工作区域名为空。
+            try:
+                source_url = result.get("url") if isinstance(result, dict) else None
+                if not isinstance(source_url, str):
+                    raise ValueError
+                tickets = parse_qs(urlsplit(source_url).query, keep_blank_values=True).get("ticket", [])
+                if len(tickets) != 1 or not tickets[0].strip():
+                    raise ValueError
+                # 后端可能把毫秒时间戳序列化为字符串，不能截断浮点数或伪造缺失值。
+                expiry = result.get("expiresAt")
+                if type(expiry) is int:
+                    expires_at = expiry
+                elif isinstance(expiry, str) and expiry.isascii() and expiry.isdecimal():
+                    expires_at = int(expiry)
+                else:
+                    raise ValueError
+                if expires_at <= 0:
+                    raise ValueError
+            except ValueError:
+                # 不把原始响应或票据放入错误信息。
+                raise QingflowApiError(
+                    category="backend",
+                    message="INVALID_LOGIN_LINK: 后端免登录链接的票据或有效期无效，请重新获取",
+                ) from None
+            query = {"ticket": tickets[0]}
+            if target:
+                query["redirect_path"] = target
+            return {
+                "url": f"{web_base_url}/mcp-login?{urlencode(query)}",
+                "expires_at": expires_at,
+            }
+
+        # require_workspace=True：目标工作区恒为当前 MCP 会话选中的工作区
+        return self._run(profile, runner, tool_name="获取临时免登录链接")