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

package/src/qingflow_mcp/tools/login_link_tools.py

@@ -9,15 +9,27 @@ 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 ..resource_uri import parse_resource_path
 from .base import ToolBase
 
 LOGIN_LINK_DESCRIPTION = (
     "轻流页面入口：查看页面、继续编辑、处理业务、查看结果或进入工作区（open/view/visit page in browser，login）。"
     "从 AI 对话进入页面时，使用当前 MCP 身份和工作区生成短时（约 5 分钟）一次性免登录链接。"
     "redirect_path 可选：传已确认的站内业务路径，可带 query/hash；省略进入首页，不接受外部地址或认证入口。"
-    "纯数据查询无需调用；用户指定页面但路径未知时先定位，不猜路径或静默改为首页。"
+    "用户指定页面但路径未知时先定位，不猜路径或静默改为首页。"
     "返回 url 和毫秒整数 expires_at；必要安全验证及原有页面权限仍然生效。"
-    "用户要链接时仅交付，不提前消费；要求打开时才用浏览器打开返回的完整链接。"
+    "创建、修改或安装轻流资源后，最终回复主动提供主要结果的可点击页面入口，无需等待用户再次索要；"
+    "采用“完成结果 + 查看入口”，文案使用“在轻流中查看应用／应用包／视图”，不默认称为“继续编辑”。"
+    "安装方案默认提供应用包入口；直接创建或修改应用、视图时提供对应入口；用户明确要求多个主要对象时分别提供。"
+    "使用业务结果中的稳定 `uri`，按 URI 去重，不为全部子资源预签票据；主要对象没有可靠 URI 时说明限制，不猜地址或替换为不相关页面。"
+    "部分成功时仅交付已确认成功且可定位的主要结果，保留失败或未验证说明；"
+    "纯数据问答、中间读取、失败资源和删除操作不自动签发，用户明确要求不提供链接时遵从。"
+    "目标浏览器登录态未知时，临近交付用资源 URI 的同源 pathname 为每个实际展示的入口分别签发，使用返回的完整 URL，不额外追问登录态。"
+    "只有已有用户确认同一浏览器、网页域名、账号和工作区已登录且无失效信号的事实时，才直接交付稳定 URI；"
+    "调用过本工具或 Agent 自动化浏览器已登录不等于用户浏览器已登录，已消费链接不可复用。"
+    "用户未要求打开时不提前打开或消费链接；要求打开时才用浏览器打开返回的完整链接。"
+    "签发失败时说明免登录链接未生成，提供标注“需登录”的稳定 URI 作为备用入口，不重做业务操作。"
+    "机器结果继续保留稳定 URI，临时登录链接仅用于面向用户交付。"
 )
 
 
@@ -70,7 +82,23 @@ class LoginLinkTools(ToolBase):
         """执行工具方法逻辑。"""
 
         def runner(session_profile, context):
-            target = validate_redirect_path(redirect_path)
+            requested_target = redirect_path or ""
+            if requested_target.startswith("/resources"):
+                target = requested_target
+                try:
+                    resource = parse_resource_path(target)
+                except ValueError:
+                    raise QingflowApiError(
+                        category="validation",
+                        message="redirect_path 必须是合法的稳定资源路径",
+                    ) from None
+                if resource.ws_id != session_profile.selected_ws_id:
+                    raise QingflowApiError(
+                        category="validation",
+                        message="redirect_path 的资源工作区必须与当前选中工作区一致",
+                    )
+            else:
+                target = validate_redirect_path(requested_target)
             web_base_url = get_web_base_url()
             result = self.backend.request(
                 "POST",

package/src/qingflow_mcp/tools/resource_read_tools.py

@@ -6,6 +6,7 @@ from typing import Any
 from ..errors import QingflowApiError, backend_code_int, is_auth_like_error, raise_tool_error
 from ..json_types import JSONObject
 from ..list_type_labels import SYSTEM_VIEW_DEFINITIONS
+from ..resource_uri import try_build_resource_uri
 from ..solution.compiler.icon_utils import workspace_icon_config
 from .app_tools import _analysis_supported_for_view_type
 from .base import ToolBase
@@ -227,6 +228,17 @@ class ResourceReadTools(ToolBase):
                             "message": f"view_get supports exporting `{view_id}`, but the export call still needs an explicit `app_key` from the parent app context.",
                         }
                     )
+            uri = None
+            if resolved_app_key:
+                uri, uri_warning = try_build_resource_uri(
+                    ws_id=session_profile.selected_ws_id,
+                    resource_type="view",
+                    app_key=resolved_app_key,
+                    view_kind="custom",
+                    view_key=view_key,
+                )
+                if uri_warning:
+                    warnings.append(uri_warning)
             return {
                 "profile": profile,
                 "ws_id": session_profile.selected_ws_id,
@@ -249,6 +261,7 @@ class ResourceReadTools(ToolBase):
                     ],
                     "analysis_supported": _analysis_supported_for_view_type(raw_view_type or None),
                     "export_capability": export_capability,
+                    **({"uri": uri} if uri else {}),
                 },
             }