@qingflow-tech/qingflow-cli 1.1.61-beta.1 → 1.1.61-beta.2

package/src/qingflow_mcp/tool_catalog.py

@@ -0,0 +1,387 @@
+from __future__ import annotations
+
+import re
+from typing import Iterable, Mapping
+
+from . import __version__
+from .public_surface import PUBLIC_TOOL_BY_KEY
+from .tool_catalog_i18n import DEFAULT_LOCALE, SUPPORTED_LOCALES, TOOL_DISPLAY_TEXT
+
+
+CATALOG_VERSION = 2
+POLICY_VERSION = 1
+TOOL_ID_PATTERN = re.compile(r"^[a-z][a-z0-9_]*:[a-z][a-z0-9_]*$")
+
+
+# 基础恢复能力必须逐项登记，禁止按 auth_ / workspace_ 前缀推断。
+EXEMPT_TOOL_IDS = frozenset(
+    {
+        "user:auth_login",
+        "user:auth_use_credential",
+        "user:auth_whoami",
+        "user:auth_logout",
+        "user:get_login_link",
+        "user:workspace_list",
+        "user:workspace_get",
+        "user:workspace_select",
+        "builder:auth_use_credential",
+        "builder:auth_whoami",
+        "builder:auth_logout",
+        "builder:get_login_link",
+        "builder:workspace_list",
+        "builder:workspace_get",
+    }
+)
+
+
+# 历史统一 stdio 独有入口没有 App User/Builder 公共声明，必须逐项冻结；
+# 与 public_surface 声明取并集后才是允许进入目录和闸门绑定的完整登记表。
+LEGACY_STDIO_TOOL_IDS = frozenset(
+    {
+        "user:navigation_create",
+        "user:navigation_delete",
+        "user:navigation_get_detail",
+        "user:navigation_get_status",
+        "user:navigation_list_draft_all",
+        "user:navigation_list_draft_page",
+        "user:navigation_list_published",
+        "user:navigation_publish",
+        "user:navigation_reorder",
+        "user:navigation_set_visible",
+        "user:navigation_update",
+        "user:package_create",
+        "user:package_delete",
+        "user:package_get",
+        "user:package_get_base",
+        "user:package_list",
+        "user:package_update",
+        "user:portal_create",
+        "user:portal_delete",
+        "user:portal_get_base_info",
+        "user:portal_publish",
+        "user:portal_update",
+        "user:portal_update_base_info",
+        "user:qingbi_report_delete",
+        "user:qingbi_report_get_base",
+        "user:qingbi_report_get_config",
+        "user:qingbi_report_get_data",
+        "user:qingbi_report_list",
+        "user:qingbi_report_list_field_options",
+        "user:qingbi_report_list_fields",
+        "user:qingbi_report_reorder",
+        "user:role_create",
+        "user:role_delete",
+        "user:role_search",
+        "user:role_update",
+        "user:solution_build_all",
+        "user:solution_build_analytics_portal",
+        "user:solution_build_app",
+        "user:solution_build_app_flow",
+        "user:solution_build_app_from_requirements",
+        "user:solution_build_flow",
+        "user:solution_build_navigation",
+        "user:solution_build_status",
+        "user:solution_build_views",
+        "user:solution_design_session",
+        "user:solution_schema_example",
+        "user:view_board_get_lane_base_info",
+        "user:view_get_base_info",
+        "user:view_get_config",
+        "user:view_get_future_nodes",
+        "user:view_get_workflow_status",
+        "user:view_list",
+        "user:view_list_associations",
+        "user:view_list_flat",
+        "user:view_list_questions",
+        "user:workflow_get_future_nodes",
+        "user:workflow_get_future_nodes_app",
+        "user:workspace_set_plugin_status",
+    }
+)
+REGISTERED_TOOL_IDS = frozenset(PUBLIC_TOOL_BY_KEY).union(LEGACY_STDIO_TOOL_IDS)
+
+
+# 能力说明只描述实际工具行为；产品分类和分类映射由 Wingent-X 维护。
+TOOL_DESCRIPTIONS: dict[str, str] = {
+    "builder:app_associated_resources_apply": "配置应用关联视图、关联报表及其按视图展示规则。",
+    "builder:app_charts_apply": "创建、更新、删除或重排轻流应用数据源的图表与报表配置。",
+    "builder:app_custom_buttons_apply": "维护独立按钮定义、样式以及跨视图绑定与排序。",
+    "builder:app_delete": "删除应用及其配置，执行前仍受原权限和确认限制。",
+    "builder:app_flow_apply": "替换工作流声明或修改节点；删除旧节点时沿用破坏性确认。",
+    "builder:app_flow_get": "读取当前草稿或指定历史版本的工作流声明。",
+    "builder:app_flow_get_schema": "读取工作流声明的版本化 Schema。",
+    "builder:app_flow_list_versions": "列出可用于恢复的工作流历史版本。",
+    "builder:app_flow_restore_version": "把指定历史工作流版本恢复到草稿，属于写操作。",
+    "builder:app_flow_validate": "校验工作流声明，执行原有维护和合同检查。",
+    "builder:app_form_apply": "根据完整表单声明创建或更新应用、字段、布局及相关配置。",
+    "builder:app_form_get": "读取应用的 canonical 表单声明。",
+    "builder:app_form_schema": "读取表单声明、字段或公式的版本化 Schema。",
+    "builder:app_form_validate": "本地校验表单声明，不访问业务后端。",
+    "builder:app_form_validate_code_block": "静态检查代码块并可在后端试运行代码。",
+    "builder:app_form_validate_formula": "校验公式语法并在后端求值验证。",
+    "builder:app_get": "读取应用配置概览及可继续定位的表单、视图和流程资源。",
+    "builder:app_get_associated_resources": "读取应用关联视图、关联报表及其展示配置。",
+    "builder:app_get_buttons": "读取应用按钮定义和绑定配置。",
+    "builder:app_get_charts": "读取应用图表与报表配置。",
+    "builder:app_get_fields": "读取应用字段及可用于图表配置的字段能力。",
+    "builder:app_get_flow": "读取应用工作流配置概览。",
+    "builder:app_get_layout": "读取应用表单布局配置。",
+    "builder:app_get_views": "读取应用视图配置概览。",
+    "builder:app_publish_verify": "按当前发布状态核验应用，必要时执行发布、结束编辑及发布后的读取核验。",
+    "builder:app_release_edit_lock_if_mine": "仅释放当前用户自己持有的应用编辑锁。",
+    "builder:app_repair_code_blocks": "检查并可修复输出绑定代码块；apply=false/true 共用一个完整工具许可。",
+    "builder:app_resolve": "按名称或引用定位目标应用。",
+    "builder:app_views_apply": "创建或修改视图、过滤与查询面板，并可创建和绑定视图按钮。",
+    "builder:app_views_get": "读取 canonical 视图声明及相关配置。",
+    "builder:app_views_schema": "读取视图声明的版本化 Schema。",
+    "builder:app_views_validate": "校验视图声明。",
+    "builder:auth_logout": "退出当前认证上下文，并可清理保存的凭据。",
+    "builder:auth_use_credential": "使用提供的凭据建立认证上下文，并按参数决定是否保存。",
+    "builder:auth_whoami": "查看当前认证身份。",
+    "builder:builder_tool_contract": "读取配置工具合同，包含表单、视图、流程、图表、应用包和成员相关配置能力。",
+    "builder:button_style_catalog_get": "读取可用按钮样式、颜色和图标。",
+    "builder:chart_get": "读取目标图表的配置。",
+    "builder:feedback_submit": "提交产品反馈，沿用原用户确认要求。",
+    "builder:file_upload_local": "把本地文件上传到轻流。",
+    "builder:get_login_link": "为指定轻流页面生成短时免登录链接。",
+    "builder:member_search": "搜索工作区成员。",
+    "builder:package_apply": "创建或更新应用包元数据、可见性、分组及排序。",
+    "builder:package_get": "读取应用包详情。",
+    "builder:package_list": "列出可访问的应用包。",
+    "builder:portal_apply": "创建或更新门户，并可创建其内嵌图表。",
+    "builder:portal_delete": "删除门户，沿用原破坏性确认要求。",
+    "builder:portal_get": "读取门户配置。",
+    "builder:portal_list": "列出可访问的门户。",
+    "builder:role_create": "创建工作区角色。",
+    "builder:role_search": "搜索工作区角色。",
+    "builder:solution_install": "安装完整方案，可创建应用包、应用、字段、视图、流程、图表、门户和角色，并按参数复制业务数据。",
+    "builder:view_get": "读取目标视图的配置。",
+    "builder:workspace_get": "读取工作区信息。",
+    "builder:workspace_icon_catalog_get": "读取应用配置可用的工作区图标和颜色。",
+    "builder:workspace_list": "列出可访问的工作区。",
+    "user:app_get": "读取应用信息、数据访问范围和可访问视图。",
+    "user:app_list": "列出或按名称搜索可访问的应用。",
+    "user:auth_login": "登录并建立轻流认证上下文。",
+    "user:auth_logout": "退出当前认证上下文，并可清理保存的凭据。",
+    "user:auth_use_credential": "使用提供的凭据建立认证上下文，并按参数决定是否保存。",
+    "user:auth_whoami": "查看当前认证身份。",
+    "user:chart_get": "读取目标图表。",
+    "user:data_delete": "在应用数据面批量删除记录，沿用原数据范围和权限检查。",
+    "user:data_get": "按记录 ID 读取应用数据及可选字段信息。",
+    "user:data_insert": "在应用数据面批量新增记录。",
+    "user:data_query": "按字段 ID 查询应用数据，支持过滤、排序、分页及完整 CSV 导出。",
+    "user:data_update": "在应用数据面批量局部更新记录。",
+    "user:directory_list_all_departments": "读取全部可访问部门。",
+    "user:directory_list_all_internal_users": "读取全部可访问内部成员。",
+    "user:directory_list_external_members": "列出外部成员。",
+    "user:directory_list_internal_departments": "列出内部部门。",
+    "user:directory_list_internal_users": "列出内部成员。",
+    "user:directory_list_sub_departments": "列出指定部门的子部门。",
+    "user:directory_search": "搜索通讯录成员或部门。",
+    "user:feedback_submit": "提交产品反馈，沿用原用户确认要求。",
+    "user:file_get_upload_info": "获取文件上传所需的信息。",
+    "user:file_upload_local": "把本地文件上传到轻流。",
+    "user:get_login_link": "为指定轻流页面生成短时免登录链接。",
+    "user:navigation_create": "创建导航配置。",
+    "user:navigation_delete": "删除导航配置。",
+    "user:navigation_get_detail": "读取导航详情。",
+    "user:navigation_get_status": "读取导航状态。",
+    "user:navigation_list_draft_all": "读取全部导航草稿。",
+    "user:navigation_list_draft_page": "分页读取导航草稿。",
+    "user:navigation_list_published": "读取已发布导航。",
+    "user:navigation_publish": "发布导航配置。",
+    "user:navigation_reorder": "调整导航排序。",
+    "user:navigation_set_visible": "调整导航可见性。",
+    "user:navigation_update": "更新导航配置。",
+    "user:package_create": "创建应用包。",
+    "user:package_delete": "删除应用包，并可按 deleted_all_data 删除业务数据及关联应用配置。",
+    "user:package_get": "读取应用包详情。",
+    "user:package_get_base": "读取应用包基础信息。",
+    "user:package_list": "列出应用包。",
+    "user:package_update": "更新应用包配置。",
+    "user:portal_create": "创建门户。",
+    "user:portal_delete": "删除门户。",
+    "user:portal_get": "读取门户详情。",
+    "user:portal_get_base_info": "读取门户基础信息。",
+    "user:portal_list": "列出门户。",
+    "user:portal_publish": "发布门户。",
+    "user:portal_update": "更新门户内容配置。",
+    "user:portal_update_base_info": "更新门户基础信息。",
+    "user:qingbi_report_delete": "删除轻析报表。",
+    "user:qingbi_report_get_base": "读取轻析报表基础信息。",
+    "user:qingbi_report_get_config": "读取轻析报表配置。",
+    "user:qingbi_report_get_data": "读取轻析报表数据。",
+    "user:qingbi_report_list": "列出轻析报表。",
+    "user:qingbi_report_list_field_options": "读取轻析报表字段的可选配置项。",
+    "user:qingbi_report_list_fields": "读取轻析报表字段。",
+    "user:qingbi_report_reorder": "调整轻析报表排序。",
+    "user:record_access": "解析应用和视图的数据访问入口及原有权限范围。",
+    "user:record_analyze": "分析指定应用或视图的记录数据。",
+    "user:record_browse_schema_get": "读取按视图浏览记录的字段合同。",
+    "user:record_code_block_run": "执行记录数据相关代码块。",
+    "user:record_code_block_schema_get": "读取记录代码块的输入输出合同。",
+    "user:record_delete": "通过原记录接口删除记录。",
+    "user:record_department_candidates": "读取记录字段可选部门。",
+    "user:record_export_direct": "直接导出记录数据。",
+    "user:record_export_get": "获取记录导出结果。",
+    "user:record_export_start": "启动记录导出任务。",
+    "user:record_export_status_get": "查询记录导出任务状态。",
+    "user:record_get": "读取单条记录。",
+    "user:record_import_repair_local": "修复本地记录导入文件。",
+    "user:record_import_schema_get": "读取记录导入字段合同。",
+    "user:record_import_start": "启动记录导入任务。",
+    "user:record_import_status_get": "查询记录导入任务状态。",
+    "user:record_import_template_get": "获取记录导入模板。",
+    "user:record_import_verify": "验证记录导入结果。",
+    "user:record_insert": "通过原记录接口新增记录。",
+    "user:record_insert_schema_get": "读取记录新增字段合同。",
+    "user:record_list": "按视图读取记录列表。",
+    "user:record_logs_get": "读取记录操作日志。",
+    "user:record_member_candidates": "读取记录字段可选成员。",
+    "user:record_schema_get": "读取申请表单字段合同。",
+    "user:record_update": "通过原记录接口更新记录。",
+    "user:record_update_schema_get": "读取记录更新字段合同。",
+    "user:role_create": "创建工作区角色。",
+    "user:role_delete": "删除工作区角色。",
+    "user:role_search": "搜索工作区角色。",
+    "user:role_update": "更新工作区角色。",
+    "user:solution_build_all": "规划、执行或修复完整方案，可创建应用包、角色、应用、字段、流程、视图、图表、门户、导航及初始业务数据。",
+    "user:solution_build_analytics_portal": "规划、执行或修复图表与门户搭建，并可启用相应工作区插件。",
+    "user:solution_build_app": "规划、执行或修复应用搭建，并可创建应用包、角色、字段及初始业务数据。",
+    "user:solution_build_app_flow": "规划、执行或修复应用及流程搭建，并可创建应用包、角色、字段及初始业务数据。",
+    "user:solution_build_app_from_requirements": "根据需求搭建应用，并可创建应用包、角色、字段及初始业务数据。",
+    "user:solution_build_flow": "规划、执行或修复流程搭建，并可为流程角色引用创建工作区角色。",
+    "user:solution_build_navigation": "规划、执行或修复导航搭建，并可启用相应工作区插件。",
+    "user:solution_build_status": "读取方案搭建任务的进度和结果。",
+    "user:solution_build_views": "规划、执行或修复方案中的视图配置。",
+    "user:solution_design_session": "创建、读取或更新本地方案设计会话。",
+    "user:solution_schema_example": "读取方案声明 Schema 和示例。",
+    "user:task_action_execute": "执行待办动作，沿用原审批权限和确认边界。",
+    "user:task_associated_report_detail_get": "读取待办关联报表详情。",
+    "user:task_get": "读取待办详情。",
+    "user:task_list": "列出待办。",
+    "user:task_workbench": "进入交互式待办工作台，可读取待办并执行其现有审批动作。",
+    "user:task_workflow_log_get": "读取待办工作流日志。",
+    "user:view_board_get_lane_base_info": "读取看板视图泳道信息。",
+    "user:view_get": "读取可访问视图的业务信息及导出能力。",
+    "user:view_get_base_info": "读取视图基础信息。",
+    "user:view_get_config": "读取视图配置。",
+    "user:view_get_future_nodes": "读取视图记录后续流程节点。",
+    "user:view_get_workflow_status": "读取视图记录流程状态。",
+    "user:view_list": "列出视图。",
+    "user:view_list_associations": "读取视图关联资源。",
+    "user:view_list_flat": "读取扁平视图列表。",
+    "user:view_list_questions": "读取视图字段。",
+    "user:workflow_get_future_nodes": "读取记录后续流程节点。",
+    "user:workflow_get_future_nodes_app": "读取应用流程的后续节点。",
+    "user:workspace_get": "读取工作区信息。",
+    "user:workspace_list": "列出可访问的工作区。",
+    "user:workspace_select": "切换当前工作区上下文。",
+    "user:workspace_set_plugin_status": "启用或停用工作区业务插件，属于受控业务写操作。",
+}
+
+
+def tool_id(domain: str, name: str) -> str:
+    value = f"{domain}:{name}"
+    if TOOL_ID_PATTERN.fullmatch(value) is None:
+        raise ValueError(f"非法工具 ID: {value}")
+    return value
+
+
+def require_registered_tool_id(stable_id: str) -> None:
+    if TOOL_ID_PATTERN.fullmatch(stable_id) is None:
+        raise ValueError(f"非法工具 ID: {stable_id}")
+    if stable_id not in REGISTERED_TOOL_IDS:
+        raise ValueError(f"工具尚未登记: {stable_id}")
+
+
+def tool_is_exempt(stable_id: str) -> bool:
+    return stable_id in EXEMPT_TOOL_IDS
+
+
+def build_tool_catalog(
+    cli_bindings: Mapping[tuple[str, ...], str],
+    mcp_bindings: Mapping[str, Mapping[str, str]],
+) -> dict[str, object]:
+    entrypoints: dict[str, list[dict[str, object]]] = {}
+    for route, stable_id in sorted(cli_bindings.items()):
+        require_registered_tool_id(stable_id)
+        entrypoints.setdefault(stable_id, []).append({"type": "cli", "route": list(route)})
+    for surface, bindings in sorted(mcp_bindings.items()):
+        for name, stable_id in sorted(bindings.items()):
+            require_registered_tool_id(stable_id)
+            entrypoints.setdefault(stable_id, []).append({"type": "mcp", "surface": surface, "name": name})
+
+    # 完整提供方目录必须覆盖所有登记工具，不能静默导出缺少历史入口的子集。
+    if set(entrypoints) != REGISTERED_TOOL_IDS:
+        missing = sorted(REGISTERED_TOOL_IDS - set(entrypoints))
+        raise ValueError(f"工具目录入口不完整: missing={missing}")
+    if set(TOOL_DESCRIPTIONS) != REGISTERED_TOOL_IDS:
+        raise ValueError("工具能力说明与完整登记表不一致")
+    if set(TOOL_DISPLAY_TEXT) != REGISTERED_TOOL_IDS:
+        raise ValueError("工具多语言文案与完整登记表不一致")
+
+    tools: list[dict[str, object]] = []
+    for stable_id in sorted(entrypoints):
+        description = TOOL_DESCRIPTIONS[stable_id]
+        if not isinstance(description, str) or not description.strip():
+            raise ValueError(f"工具缺少能力说明: {stable_id}")
+        zh_name, en_name, en_description = TOOL_DISPLAY_TEXT[stable_id]
+        if any(not isinstance(value, str) or not value.strip() for value in (zh_name, en_name, en_description)):
+            raise ValueError(f"工具缺少多语言文案: {stable_id}")
+        tools.append({
+            "id": stable_id,
+            "name": stable_id.split(":", 1)[1],
+            "description": description,
+            "displayName": zh_name,
+            "i18n": {
+                "zh-CN": {"displayName": zh_name, "description": description},
+                "en-US": {"displayName": en_name, "description": en_description},
+            },
+            "exempt": tool_is_exempt(stable_id),
+            "entrypoints": entrypoints[stable_id],
+        })
+    return {
+        "catalogVersion": CATALOG_VERSION,
+        "policyVersion": POLICY_VERSION,
+        "provider": {"name": "qingflow-mcp", "version": __version__},
+        "defaultLocale": DEFAULT_LOCALE,
+        "locales": list(SUPPORTED_LOCALES),
+        "tools": tools,
+    }
+
+
+def user_server_bindings(tool_names: Iterable[str]) -> dict[str, str]:
+    return {name: tool_id("user", name) for name in tool_names}
+
+
+def builder_server_bindings(tool_names: Iterable[str]) -> dict[str, str]:
+    return {name: tool_id("builder", name) for name in tool_names}
+
+
+def stdio_server_bindings(
+    legacy_tool_names: Iterable[str],
+    final_tool_names: Iterable[str],
+) -> dict[str, str]:
+    legacy = set(legacy_tool_names)
+    final = set(final_tool_names)
+    return {
+        name: tool_id("user" if name in legacy else "builder", name)
+        for name in final
+    }
+
+
+def combined_server_bindings(
+    user_tool_names: Iterable[str],
+    builder_tool_names: Iterable[str],
+    *,
+    builder_prefix: str,
+) -> dict[str, str]:
+    bindings = user_server_bindings(user_tool_names)
+    bindings.update(
+        {
+            f"{builder_prefix}{name}": tool_id("builder", name)
+            for name in builder_tool_names
+        }
+    )
+    return bindings

package/src/qingflow_mcp/tool_catalog_i18n.py

@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+
+DEFAULT_LOCALE = "zh-CN"
+SUPPORTED_LOCALES = ("zh-CN", "en-US")
+
+# 每项为（中文显示名称、英文显示名称、英文能力说明）；中文能力说明沿用 tool_catalog.py。
+# 这里只维护工具本身的文案，不包含 Wingent-X 的产品分类、排序或分类标签。
+TOOL_DISPLAY_TEXT: dict[str, tuple[str, str, str]] = {
+    "builder:app_associated_resources_apply": ("配置关联资源", "Configure associated resources", "Configure associated views, reports, and their display rules for each view."),
+    "builder:app_charts_apply": ("配置应用图表", "Configure application charts", "Create, update, delete, or reorder charts and reports using Qingflow application data sources."),
+    "builder:app_custom_buttons_apply": ("配置自定义按钮", "Configure custom buttons", "Maintain standalone button definitions, styles, bindings across views, and ordering."),
+    "builder:app_delete": ("删除应用", "Delete application", "Delete an application and its configuration, retaining existing permission and confirmation checks."),
+    "builder:app_flow_apply": ("配置工作流", "Configure workflow", "Replace workflow declarations or modify nodes; deleting existing nodes retains destructive change confirmation."),
+    "builder:app_flow_get": ("读取工作流声明", "Read workflow declaration", "Read the current draft or a specified historical workflow declaration."),
+    "builder:app_flow_get_schema": ("读取工作流结构", "Read workflow schema", "Read the versioned schema for workflow declarations."),
+    "builder:app_flow_list_versions": ("列出工作流版本", "List workflow versions", "List historical workflow versions available for restoration."),
+    "builder:app_flow_restore_version": ("恢复工作流版本", "Restore workflow version", "Restore a specified historical workflow version to the draft; this is a write operation."),
+    "builder:app_flow_validate": ("校验工作流", "Validate workflow", "Validate workflow declarations with existing maintenance and contract checks."),
+    "builder:app_form_apply": ("配置应用表单", "Configure application form", "Create or update applications, fields, layouts, and related configuration from a complete form declaration."),
+    "builder:app_form_get": ("读取表单声明", "Read form declaration", "Read the application's canonical form declaration."),
+    "builder:app_form_schema": ("读取表单结构", "Read form schema", "Read versioned schemas for form declarations, fields, or formulas."),
+    "builder:app_form_validate": ("校验表单声明", "Validate form declaration", "Validate form declarations locally without accessing the business backend."),
+    "builder:app_form_validate_code_block": ("校验表单代码块", "Validate form code block", "Perform static code checks and, when applicable, execute a test run on the backend."),
+    "builder:app_form_validate_formula": ("校验表单公式", "Validate form formula", "Validate formula syntax and evaluate the formula on the backend."),
+    "builder:app_get": ("读取应用配置概览", "Read application configuration overview", "Read the application configuration overview and references to form, view, and workflow resources."),
+    "builder:app_get_associated_resources": ("读取关联资源", "Read associated resources", "Read associated views, reports, and their display configuration."),
+    "builder:app_get_buttons": ("读取应用按钮", "Read application buttons", "Read application button definitions and binding configuration."),
+    "builder:app_get_charts": ("读取应用图表配置", "Read application chart configuration", "Read application chart and report configuration."),
+    "builder:app_get_fields": ("读取应用字段", "Read application fields", "Read application fields and the field capabilities available for chart configuration."),
+    "builder:app_get_flow": ("读取工作流概览", "Read workflow overview", "Read an overview of the application's workflow configuration."),
+    "builder:app_get_layout": ("读取表单布局", "Read form layout", "Read the application's form layout configuration."),
+    "builder:app_get_views": ("读取视图配置概览", "Read view configuration overview", "Read an overview of application view configuration."),
+    "builder:app_publish_verify": ("发布并核验应用", "Publish and verify application", "Verify the application's current publication state; when needed, publish, finish editing, and verify the published result."),
+    "builder:app_release_edit_lock_if_mine": ("释放本人编辑锁", "Release own edit lock", "Release an application edit lock only when it belongs to the current user."),
+    "builder:app_repair_code_blocks": ("检查并修复代码块", "Inspect and repair code blocks", "Inspect and optionally repair code blocks with output bindings; apply=false/true share the same full tool permission."),
+    "builder:app_resolve": ("定位应用", "Resolve application", "Resolve the target application by name or reference."),
+    "builder:app_views_apply": ("配置应用视图", "Configure application views", "Create or modify views, filters, and query panels; may also create and bind view buttons."),
+    "builder:app_views_get": ("读取视图声明", "Read view declaration", "Read canonical view declarations and related configuration."),
+    "builder:app_views_schema": ("读取视图结构", "Read view schema", "Read the versioned schema for view declarations."),
+    "builder:app_views_validate": ("校验视图声明", "Validate view declaration", "Validate view declarations."),
+    "builder:auth_logout": ("退出认证", "Log out", "Leave the current authentication context and optionally clear saved credentials."),
+    "builder:auth_use_credential": ("使用凭据认证", "Authenticate with credential", "Establish an authentication context with the supplied credential and save it when requested."),
+    "builder:auth_whoami": ("查看当前身份", "Read current identity", "Read the current authenticated identity."),
+    "builder:builder_tool_contract": ("读取配置工具合同", "Read builder tool contract", "Read configuration tool contracts covering forms, views, workflows, charts, application packages, and members."),
+    "builder:button_style_catalog_get": ("读取按钮样式目录", "Read button style catalog", "Read available button styles, colors, and icons."),
+    "builder:chart_get": ("读取图表配置", "Read chart configuration", "Read the target chart's configuration."),
+    "builder:feedback_submit": ("提交产品反馈", "Submit product feedback", "Submit product feedback with existing user confirmation requirements."),
+    "builder:file_upload_local": ("上传本地文件", "Upload local file", "Upload a local file to Qingflow."),
+    "builder:get_login_link": ("生成免登录链接", "Generate login link", "Generate a short lived login link for a specified Qingflow page."),
+    "builder:member_search": ("搜索工作区成员", "Search workspace members", "Search workspace members."),
+    "builder:package_apply": ("配置应用包", "Configure application package", "Create or update application package metadata, visibility, groups, and ordering."),
+    "builder:package_get": ("读取应用包详情", "Read application package", "Read application package details."),
+    "builder:package_list": ("列出应用包", "List application packages", "List accessible application packages."),
+    "builder:portal_apply": ("配置门户", "Configure portal", "Create or update a portal and optionally create its embedded charts."),
+    "builder:portal_delete": ("删除门户", "Delete portal", "Delete a portal with existing destructive operation confirmation requirements."),
+    "builder:portal_get": ("读取门户配置", "Read portal configuration", "Read portal configuration."),
+    "builder:portal_list": ("列出门户", "List portals", "List accessible portals."),
+    "builder:role_create": ("创建工作区角色", "Create workspace role", "Create a workspace role."),
+    "builder:role_search": ("搜索工作区角色", "Search workspace roles", "Search workspace roles."),
+    "builder:solution_install": ("安装完整方案", "Install complete solution", "Install a complete solution; may create application packages, applications, fields, views, workflows, charts, portals, and roles, and copy business data when requested."),
+    "builder:view_get": ("读取视图配置", "Read view configuration", "Read the target view's configuration."),
+    "builder:workspace_get": ("读取工作区信息", "Read workspace information", "Read workspace information."),
+    "builder:workspace_icon_catalog_get": ("读取工作区图标目录", "Read workspace icon catalog", "Read workspace icons and colors available for application configuration."),
+    "builder:workspace_list": ("列出工作区", "List workspaces", "List accessible workspaces."),
+    "user:app_get": ("读取应用业务信息", "Read application business information", "Read application information, data access scope, and accessible views."),
+    "user:app_list": ("列出应用", "List applications", "List accessible applications or search them by name."),
+    "user:auth_login": ("登录轻流", "Log in to Qingflow", "Log in and establish a Qingflow authentication context."),
+    "user:auth_logout": ("退出认证", "Log out", "Leave the current authentication context and optionally clear saved credentials."),
+    "user:auth_use_credential": ("使用凭据认证", "Authenticate with credential", "Establish an authentication context with the supplied credential and save it when requested."),
+    "user:auth_whoami": ("查看当前身份", "Read current identity", "Read the current authenticated identity."),
+    "user:chart_get": ("读取图表", "Read chart", "Read the target chart."),
+    "user:data_delete": ("删除应用数据", "Delete application data", "Delete application records in batches with existing data scope and permission checks."),
+    "user:data_get": ("读取应用数据", "Read application data", "Read application data by record ID, with optional field information."),
+    "user:data_insert": ("新增应用数据", "Insert application data", "Insert application records in batches."),
+    "user:data_query": ("查询应用数据", "Query application data", "Query application data by field ID, with filtering, sorting, pagination, and complete CSV export."),
+    "user:data_update": ("更新应用数据", "Update application data", "Update selected fields in application records in batches."),
+    "user:directory_list_all_departments": ("读取全部可访问部门", "Read all accessible departments", "Read all accessible departments."),
+    "user:directory_list_all_internal_users": ("读取全部可访问内部成员", "Read all accessible internal members", "Read all accessible internal members."),
+    "user:directory_list_external_members": ("列出外部成员", "List external members", "List external members."),
+    "user:directory_list_internal_departments": ("列出内部部门", "List internal departments", "List internal departments."),
+    "user:directory_list_internal_users": ("列出内部成员", "List internal members", "List internal members."),
+    "user:directory_list_sub_departments": ("列出子部门", "List subdepartments", "List subdepartments of a specified department."),
+    "user:directory_search": ("搜索通讯录", "Search directory", "Search directory members or departments."),
+    "user:feedback_submit": ("提交产品反馈", "Submit product feedback", "Submit product feedback with existing user confirmation requirements."),
+    "user:file_get_upload_info": ("获取文件上传信息", "Read file upload information", "Read the information required for a file upload."),
+    "user:file_upload_local": ("上传本地文件", "Upload local file", "Upload a local file to Qingflow."),
+    "user:get_login_link": ("生成免登录链接", "Generate login link", "Generate a short lived login link for a specified Qingflow page."),
+    "user:navigation_create": ("创建导航", "Create navigation", "Create navigation configuration."),
+    "user:navigation_delete": ("删除导航", "Delete navigation", "Delete navigation configuration."),
+    "user:navigation_get_detail": ("读取导航详情", "Read navigation details", "Read navigation details."),
+    "user:navigation_get_status": ("读取导航状态", "Read navigation status", "Read navigation status."),
+    "user:navigation_list_draft_all": ("读取全部导航草稿", "Read all navigation drafts", "Read all navigation drafts."),
+    "user:navigation_list_draft_page": ("分页读取导航草稿", "Read navigation draft page", "Read a page of navigation drafts."),
+    "user:navigation_list_published": ("读取已发布导航", "Read published navigation", "Read published navigation."),
+    "user:navigation_publish": ("发布导航", "Publish navigation", "Publish navigation configuration."),
+    "user:navigation_reorder": ("调整导航排序", "Reorder navigation", "Change navigation ordering."),
+    "user:navigation_set_visible": ("调整导航可见性", "Set navigation visibility", "Change navigation visibility."),
+    "user:navigation_update": ("更新导航", "Update navigation", "Update navigation configuration."),
+    "user:package_create": ("创建应用包", "Create application package", "Create an application package."),
+    "user:package_delete": ("删除应用包", "Delete application package", "Delete an application package; deleted_all_data may also delete business data and associated application configuration."),
+    "user:package_get": ("读取应用包详情", "Read application package", "Read application package details."),
+    "user:package_get_base": ("读取应用包基础信息", "Read application package base information", "Read application package base information."),
+    "user:package_list": ("列出应用包", "List application packages", "List application packages."),
+    "user:package_update": ("更新应用包", "Update application package", "Update application package configuration."),
+    "user:portal_create": ("创建门户", "Create portal", "Create a portal."),
+    "user:portal_delete": ("删除门户", "Delete portal", "Delete a portal."),
+    "user:portal_get": ("读取门户详情", "Read portal details", "Read portal details."),
+    "user:portal_get_base_info": ("读取门户基础信息", "Read portal base information", "Read portal base information."),
+    "user:portal_list": ("列出门户", "List portals", "List portals."),
+    "user:portal_publish": ("发布门户", "Publish portal", "Publish a portal."),
+    "user:portal_update": ("更新门户内容", "Update portal content", "Update portal content configuration."),
+    "user:portal_update_base_info": ("更新门户基础信息", "Update portal base information", "Update portal base information."),
+    "user:qingbi_report_delete": ("删除轻析报表", "Delete Qingbi report", "Delete a Qingbi report."),
+    "user:qingbi_report_get_base": ("读取轻析报表基础信息", "Read Qingbi report base information", "Read Qingbi report base information."),
+    "user:qingbi_report_get_config": ("读取轻析报表配置", "Read Qingbi report configuration", "Read Qingbi report configuration."),
+    "user:qingbi_report_get_data": ("读取轻析报表数据", "Read Qingbi report data", "Read Qingbi report data."),
+    "user:qingbi_report_list": ("列出轻析报表", "List Qingbi reports", "List Qingbi reports."),
+    "user:qingbi_report_list_field_options": ("读取报表字段配置项", "Read report field options", "Read available configuration options for Qingbi report fields."),
+    "user:qingbi_report_list_fields": ("读取报表字段", "Read report fields", "Read Qingbi report fields."),
+    "user:qingbi_report_reorder": ("调整轻析报表排序", "Reorder Qingbi reports", "Change Qingbi report ordering."),
+    "user:record_access": ("解析记录访问入口", "Resolve record access", "Resolve application and view data access entrypoints with existing permission scopes."),
+    "user:record_analyze": ("分析记录数据", "Analyze records", "Analyze records in a specified application or view."),
+    "user:record_browse_schema_get": ("读取记录浏览结构", "Read record browsing schema", "Read the field contract for browsing records by view."),
+    "user:record_code_block_run": ("执行记录代码块", "Run record code block", "Execute a code block related to record data."),
+    "user:record_code_block_schema_get": ("读取记录代码块结构", "Read record code block schema", "Read the input and output contract for a record code block."),
+    "user:record_delete": ("删除记录", "Delete record", "Delete records through the existing record API."),
+    "user:record_department_candidates": ("读取字段可选部门", "Read field department candidates", "Read department candidates for record fields."),
+    "user:record_export_direct": ("直接导出记录", "Export records directly", "Export record data directly."),
+    "user:record_export_get": ("获取记录导出结果", "Read record export result", "Read a record export result."),
+    "user:record_export_start": ("启动记录导出", "Start record export", "Start a record export task."),
+    "user:record_export_status_get": ("读取记录导出状态", "Read record export status", "Read the status of a record export task."),
+    "user:record_get": ("读取单条记录", "Read record", "Read a single record."),
+    "user:record_import_repair_local": ("修复本地导入文件", "Repair local import file", "Repair a local record import file."),
+    "user:record_import_schema_get": ("读取记录导入结构", "Read record import schema", "Read the field contract for importing records."),
+    "user:record_import_start": ("启动记录导入", "Start record import", "Start a record import task."),
+    "user:record_import_status_get": ("读取记录导入状态", "Read record import status", "Read the status of a record import task."),
+    "user:record_import_template_get": ("获取记录导入模板", "Read record import template", "Read a record import template."),
+    "user:record_import_verify": ("校验记录导入结果", "Verify record import", "Verify record import results."),
+    "user:record_insert": ("新增记录", "Insert record", "Insert records through the existing record API."),
+    "user:record_insert_schema_get": ("读取记录新增结构", "Read record insertion schema", "Read the field contract for inserting records."),
+    "user:record_list": ("按视图列出记录", "List records by view", "Read records by view."),
+    "user:record_logs_get": ("读取记录操作日志", "Read record operation logs", "Read record operation logs."),
+    "user:record_member_candidates": ("读取字段可选成员", "Read field member candidates", "Read member candidates for record fields."),
+    "user:record_schema_get": ("读取申请表单结构", "Read applicant form schema", "Read the field contract for the applicant form."),
+    "user:record_update": ("更新记录", "Update record", "Update records through the existing record API."),
+    "user:record_update_schema_get": ("读取记录更新结构", "Read record update schema", "Read the field contract for updating records."),
+    "user:role_create": ("创建工作区角色", "Create workspace role", "Create a workspace role."),
+    "user:role_delete": ("删除工作区角色", "Delete workspace role", "Delete a workspace role."),
+    "user:role_search": ("搜索工作区角色", "Search workspace roles", "Search workspace roles."),
+    "user:role_update": ("更新工作区角色", "Update workspace role", "Update a workspace role."),
+    "user:solution_build_all": ("搭建完整方案", "Build complete solution", "Plan, apply, or repair a complete solution; may create application packages, roles, applications, fields, workflows, views, charts, portals, navigation, and initial business data."),
+    "user:solution_build_analytics_portal": ("搭建图表与门户", "Build charts and portals", "Plan, apply, or repair charts and portals; may enable the corresponding workspace plugins."),
+    "user:solution_build_app": ("搭建应用", "Build application", "Plan, apply, or repair an application; may create application packages, roles, fields, and initial business data."),
+    "user:solution_build_app_flow": ("搭建应用与流程", "Build application and workflow", "Plan, apply, or repair applications and workflows; may create application packages, roles, fields, and initial business data."),
+    "user:solution_build_app_from_requirements": ("按需求搭建应用", "Build application from requirements", "Build an application from requirements; may create application packages, roles, fields, and initial business data."),
+    "user:solution_build_flow": ("搭建流程", "Build workflow", "Plan, apply, or repair workflows; may create workspace roles referenced by the workflow."),
+    "user:solution_build_navigation": ("搭建导航", "Build navigation", "Plan, apply, or repair navigation; may enable the corresponding workspace plugins."),
+    "user:solution_build_status": ("读取方案搭建状态", "Read solution build status", "Read the progress and results of a solution build task."),
+    "user:solution_build_views": ("搭建视图", "Build views", "Plan, apply, or repair view configuration in a solution."),
+    "user:solution_design_session": ("管理本地方案设计会话", "Manage local solution design session", "Create, read, or update a local solution design session."),
+    "user:solution_schema_example": ("读取方案结构与示例", "Read solution schema and examples", "Read solution declaration schemas and examples."),
+    "user:task_action_execute": ("执行待办动作", "Execute task action", "Execute a task action with existing approval permissions and confirmation requirements."),
+    "user:task_associated_report_detail_get": ("读取待办关联报表", "Read task associated report", "Read details of a report associated with a task."),
+    "user:task_get": ("读取待办详情", "Read task details", "Read task details."),
+    "user:task_list": ("列出待办", "List tasks", "List tasks."),
+    "user:task_workbench": ("使用交互式待办工作台", "Use interactive task workbench", "Open the interactive task workbench to read tasks and execute their existing approval actions."),
+    "user:task_workflow_log_get": ("读取待办流程日志", "Read task workflow logs", "Read workflow logs for a task."),
+    "user:view_board_get_lane_base_info": ("读取看板泳道信息", "Read board lane information", "Read lane information for a board view."),
+    "user:view_get": ("读取视图业务信息", "Read view business information", "Read an accessible view's business information and export capabilities."),
+    "user:view_get_base_info": ("读取视图基础信息", "Read view base information", "Read view base information."),
+    "user:view_get_config": ("读取视图配置", "Read view configuration", "Read view configuration."),
+    "user:view_get_future_nodes": ("读取视图后续流程节点", "Read future view workflow nodes", "Read future workflow nodes for records in a view."),
+    "user:view_get_workflow_status": ("读取视图记录流程状态", "Read view record workflow status", "Read workflow status for records in a view."),
+    "user:view_list": ("列出视图", "List views", "List views."),
+    "user:view_list_associations": ("读取视图关联资源", "Read view associations", "Read resources associated with a view."),
+    "user:view_list_flat": ("读取扁平视图列表", "Read flat view list", "Read a flat list of views."),
+    "user:view_list_questions": ("读取视图字段", "Read view fields", "Read view fields."),
+    "user:workflow_get_future_nodes": ("读取记录后续流程节点", "Read future record workflow nodes", "Read future workflow nodes for a record."),
+    "user:workflow_get_future_nodes_app": ("读取应用后续流程节点", "Read future application workflow nodes", "Read future nodes in an application's workflow."),
+    "user:workspace_get": ("读取工作区信息", "Read workspace information", "Read workspace information."),
+    "user:workspace_list": ("列出工作区", "List workspaces", "List accessible workspaces."),
+    "user:workspace_select": ("切换工作区", "Select workspace", "Switch the current workspace context."),
+    "user:workspace_set_plugin_status": ("启停工作区插件", "Enable or disable workspace plugins", "Enable or disable workspace business plugins; this is a controlled business write operation."),
+}