@josephyan/qingflow-cli 0.2.0-beta.72 → 0.2.0-beta.74

package/src/qingflow_mcp/cli/commands/builder.py

@@ -10,6 +10,34 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     parser = subparsers.add_parser("builder", aliases=["build"], help="稳定 builder 命令")
     builder_subparsers = parser.add_subparsers(dest="builder_command", required=True)
 
+    file_parser = builder_subparsers.add_parser("file", help="builder 侧文件上传")
+    file_subparsers = file_parser.add_subparsers(dest="builder_file_command", required=True)
+    file_upload_local = file_subparsers.add_parser("upload-local", help="上传本地文件并返回附件值")
+    file_upload_local.add_argument("--upload-kind", default="attachment")
+    file_upload_local.add_argument("--file-path", required=True)
+    file_upload_local.add_argument("--upload-mark")
+    file_upload_local.add_argument("--content-type")
+    file_upload_local.add_argument("--bucket-type")
+    file_upload_local.add_argument("--path-id", type=int)
+    file_upload_local.add_argument("--file-related-url")
+    file_upload_local.set_defaults(handler=_handle_file_upload_local, format_hint="generic")
+
+    feedback = builder_subparsers.add_parser("feedback", help="builder 侧反馈提交")
+    feedback_subparsers = feedback.add_subparsers(dest="builder_feedback_command", required=True)
+    feedback_submit = feedback_subparsers.add_parser("submit", help="提交 builder 能力反馈")
+    feedback_submit.add_argument("--category", required=True)
+    feedback_submit.add_argument("--title", required=True)
+    feedback_submit.add_argument("--description", required=True)
+    feedback_submit.add_argument("--expected-behavior")
+    feedback_submit.add_argument("--actual-behavior")
+    feedback_submit.add_argument("--impact-scope")
+    feedback_submit.add_argument("--tool-name")
+    feedback_submit.add_argument("--app-key")
+    feedback_submit.add_argument("--record-id")
+    feedback_submit.add_argument("--workflow-node-id")
+    feedback_submit.add_argument("--note")
+    feedback_submit.set_defaults(handler=_handle_feedback_submit, format_hint="generic")
+
     contract = builder_subparsers.add_parser("contract", help="读取 builder tool 合约")
     contract.add_argument("--tool-name", required=True)
     contract.set_defaults(handler=_handle_contract, format_hint="builder_summary")
@@ -49,6 +77,14 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     package_resolve.add_argument("--package-name", required=True)
     package_resolve.set_defaults(handler=_handle_package_resolve, format_hint="builder_summary")
 
+    solution = builder_subparsers.add_parser("solution", help="解决方案")
+    solution_subparsers = solution.add_subparsers(dest="builder_solution_command", required=True)
+    solution_install = solution_subparsers.add_parser("install", help="安装解决方案")
+    solution_install.add_argument("--solution-key", required=True)
+    solution_install.add_argument("--being-copy-data", action=argparse.BooleanOptionalAction, default=True)
+    solution_install.add_argument("--solution-source", default="solutionDetail")
+    solution_install.set_defaults(handler=_handle_solution_install, format_hint="builder_summary")
+
     package_create = package_subparsers.add_parser("create", help="创建应用包")
     package_create.add_argument("--package-name", required=True)
     package_create.add_argument("--icon")
@@ -86,6 +122,12 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     app_get.add_argument("--app-key", required=True)
     app_get.set_defaults(handler=_handle_app_get, format_hint="builder_summary")
 
+    app_repair_code_blocks = app_subparsers.add_parser("repair-code-blocks", help="扫描或修复现有代码块配置")
+    app_repair_code_blocks.add_argument("--app-key", required=True)
+    app_repair_code_blocks.add_argument("--field")
+    app_repair_code_blocks.add_argument("--apply", action="store_true")
+    app_repair_code_blocks.set_defaults(handler=_handle_app_repair_code_blocks, format_hint="builder_summary")
+
     button = builder_subparsers.add_parser("button", help="自定义按钮")
     button_subparsers = button.add_subparsers(dest="builder_button_command", required=True)
 
@@ -116,7 +158,7 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     portal = builder_subparsers.add_parser("portal", help="门户")
     portal_subparsers = portal.add_subparsers(dest="builder_portal_command", required=True)
-    portal_list = portal_subparsers.add_parser("list", help="列出可访问门户")
+    portal_list = portal_subparsers.add_parser("list", help="列出可配置门户")
     portal_list.set_defaults(handler=_handle_portal_list, format_hint="builder_summary")
 
     portal_get = portal_subparsers.add_parser("get", help="读取门户详情")
@@ -215,6 +257,35 @@ def _handle_package_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_list(profile=args.profile, trial_status=args.trial_status)
 
 
+def _handle_file_upload_local(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.files.file_upload_local(
+        profile=args.profile,
+        upload_kind=args.upload_kind,
+        file_path=args.file_path,
+        upload_mark=args.upload_mark,
+        content_type=args.content_type,
+        bucket_type=args.bucket_type,
+        path_id=args.path_id,
+        file_related_url=args.file_related_url,
+    )
+
+
+def _handle_feedback_submit(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder_feedback.feedback_submit(
+        category=args.category,
+        title=args.title,
+        description=args.description,
+        expected_behavior=args.expected_behavior,
+        actual_behavior=args.actual_behavior,
+        impact_scope=args.impact_scope,
+        tool_name=args.tool_name,
+        app_key=args.app_key,
+        record_id=args.record_id,
+        workflow_node_id=args.workflow_node_id,
+        note=args.note,
+    )
+
+
 def _handle_contract(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.builder_tool_contract(tool_name=args.tool_name)
 
@@ -253,6 +324,15 @@ def _handle_package_resolve(args: argparse.Namespace, context: CliContext) -> di
     return context.builder.package_resolve(profile=args.profile, package_name=args.package_name)
 
 
+def _handle_solution_install(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.solution_install(
+        profile=args.profile,
+        solution_key=args.solution_key,
+        being_copy_data=bool(args.being_copy_data),
+        solution_source=args.solution_source,
+    )
+
+
 def _handle_package_create(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_create(
         profile=args.profile,
@@ -347,6 +427,15 @@ def _handle_app_get(args: argparse.Namespace, context: CliContext) -> dict:
     return handlers[args.builder_app_get_section](profile=args.profile, app_key=args.app_key)
 
 
+def _handle_app_repair_code_blocks(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.app_repair_code_blocks(
+        profile=args.profile,
+        app_key=args.app_key,
+        field=args.field,
+        apply=bool(args.apply),
+    )
+
+
 def _handle_portal_list(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.portal_list(profile=args.profile)
 

package/src/qingflow_mcp/cli/commands/repo.py

@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+import argparse
+
+from ..context import CliContext
+from .common import raise_config_error, require_list_arg, require_object_arg
+
+
+def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) -> None:
+    parser = subparsers.add_parser("repo", help="代码仓库开发工具")
+    repo_subparsers = parser.add_subparsers(dest="repo_command", required=True)
+
+    init_parser = repo_subparsers.add_parser("init", help="从模板初始化仓库")
+    init_parser.add_argument("--group-name", required=True)
+    init_parser.add_argument("--repo-template", required=True)
+    init_parser.set_defaults(handler=_handle_init, format_hint="generic")
+
+    generate_parser = repo_subparsers.add_parser("generate", help="沿用官方 generate 链路生成并提交页面代码")
+    generate_parser.add_argument("--repo-name", required=True)
+    generate_parser.add_argument("--query", required=True)
+    generate_parser.add_argument("--tag-id", type=int)
+    generate_parser.add_argument("--app-keys-file")
+    generate_parser.add_argument("--extra-info-file")
+    generate_parser.add_argument("--file-messages-file")
+    generate_parser.add_argument("--agent-id", type=int)
+    generate_parser.add_argument("--allow-create-table", action="store_true")
+    generate_parser.add_argument("--route-prefix")
+    generate_parser.add_argument("--token-name")
+    generate_parser.add_argument("--session-id")
+    generate_parser.add_argument("--round-version", type=int)
+    generate_parser.add_argument("--disable-trace-log", action="store_true")
+    generate_parser.set_defaults(handler=_handle_generate, format_hint="generic")
+
+    publish_parser = repo_subparsers.add_parser("publish-prod", help="发布 develop 到生产分支")
+    publish_parser.add_argument("--repo-name", required=True)
+    publish_parser.add_argument("--confirm", action="store_true")
+    publish_parser.set_defaults(handler=_handle_publish_prod, format_hint="generic")
+
+
+def _handle_init(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.repo.repository_init(
+        profile=args.profile,
+        group_name=args.group_name,
+        repo_template=args.repo_template,
+    )
+
+
+def _handle_generate(args: argparse.Namespace, context: CliContext) -> dict:
+    app_keys = require_list_arg(args.app_keys_file, option_name="--app-keys-file") if args.app_keys_file else []
+    extra_info = require_object_arg(args.extra_info_file, option_name="--extra-info-file") if args.extra_info_file else None
+    file_messages = require_list_arg(args.file_messages_file, option_name="--file-messages-file") if args.file_messages_file else []
+    return context.repo.repository_generate(
+        profile=args.profile,
+        repo_name=args.repo_name,
+        query=args.query,
+        tag_id=args.tag_id,
+        app_keys=app_keys,
+        extra_info=extra_info,
+        file_messages=file_messages,
+        being_trace_log_enabled=not args.disable_trace_log,
+        agent_id=args.agent_id,
+        allow_create_table=args.allow_create_table,
+        route_prefix=args.route_prefix,
+        token_name=args.token_name,
+        session_id=args.session_id,
+        round_version=args.round_version,
+    )
+
+
+def _handle_publish_prod(args: argparse.Namespace, context: CliContext) -> dict:
+    if args.confirm is not True:
+        raise_config_error(
+            "repository_publish_prod requires explicit confirmation.",
+            fix_hint="Re-run with `--confirm` after verifying the target repo and release intent.",
+        )
+    return context.repo.repository_publish_prod(
+        profile=args.profile,
+        repo_name=args.repo_name,
+        confirm=args.confirm,
+    )

package/src/qingflow_mcp/cli/context.py

@@ -8,8 +8,11 @@ from ..tools.ai_builder_tools import AiBuilderTools
 from ..tools.app_tools import AppTools
 from ..tools.auth_tools import AuthTools
 from ..tools.code_block_tools import CodeBlockTools
+from ..tools.feedback_tools import FeedbackTools
+from ..tools.file_tools import FileTools
 from ..tools.import_tools import ImportTools
 from ..tools.record_tools import RecordTools
+from ..tools.repository_dev_tools import RepositoryDevTools
 from ..tools.resource_read_tools import ResourceReadTools
 from ..tools.task_context_tools import TaskContextTools
 from ..tools.workspace_tools import WorkspaceTools
@@ -27,7 +30,10 @@ class CliContext:
     code_block: CodeBlockTools
     imports: ImportTools
     task: TaskContextTools
+    files: FileTools
+    builder_feedback: FeedbackTools
     builder: AiBuilderTools
+    repo: RepositoryDevTools
 
     def close(self) -> None:
         self.backend.close()
@@ -47,5 +53,8 @@ def build_cli_context() -> CliContext:
         code_block=CodeBlockTools(sessions, backend),
         imports=ImportTools(sessions, backend),
         task=TaskContextTools(sessions, backend),
+        files=FileTools(sessions, backend),
+        builder_feedback=FeedbackTools(backend, mcp_side="App Builder MCP"),
         builder=AiBuilderTools(sessions, backend),
+        repo=RepositoryDevTools(sessions, backend),
     )

package/src/qingflow_mcp/config.py

@@ -14,6 +14,13 @@ ATTACHMENT_QUESTION_TYPE = 13
 DEFAULT_BASE_URL = "https://qingflow.com/api"
 DEFAULT_FEEDBACK_APP_KEY = "e0d017kju002"
 DEFAULT_FEEDBACK_QSOURCE_TOKEN = "mcp-feedback-7755d14748fc"
+DEFAULT_REPOSITORY_GIT_REMOTE_TEMPLATE = "git@hackers.oalite.com:{group}/{repo}.git"
+DEFAULT_REPOSITORY_PREVIEW_ADDRESS_TEMPLATE = "https://%s.preview.oalite.com"
+DEFAULT_REPOSITORY_DEVELOP_BRANCH = "develop"
+DEFAULT_REPOSITORY_PROD_BRANCH = "prod"
+DEFAULT_REPOSITORY_AUTHOR_NAME = "qingflow-mcp"
+DEFAULT_REPOSITORY_AUTHOR_EMAIL = "qingflow-mcp@local.invalid"
+DEFAULT_REPOSITORY_INTERNAL_SHARE_TOKEN_KEY = "tokenKey"
 
 
 def get_mcp_home() -> Path:
@@ -25,6 +32,10 @@ def get_profiles_path() -> Path:
     return get_mcp_home() / "profiles.json"
 
 
+def get_repository_metadata_dir() -> Path:
+    return get_mcp_home() / "repository-metadata"
+
+
 def get_config_file_paths() -> list[Path]:
     """
     获取可能的配置文件路径列表，按优先级排序：
@@ -197,6 +208,142 @@ def get_log_level() -> str:
     )
 
 
+def get_repository_default_group() -> str | None:
+    value = get_config_value(
+        "repository.default_group",
+        env_var="QINGFLOW_MCP_REPOSITORY_DEFAULT_GROUP",
+        default=None,
+    )
+    normalized = str(value or "").strip()
+    return normalized or None
+
+
+def get_repository_git_remote_template() -> str:
+    value = get_config_value(
+        "repository.git_remote_template",
+        env_var="QINGFLOW_MCP_REPOSITORY_GIT_REMOTE_TEMPLATE",
+        default=DEFAULT_REPOSITORY_GIT_REMOTE_TEMPLATE,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_GIT_REMOTE_TEMPLATE
+
+
+def get_repository_preview_address_template() -> str:
+    value = get_config_value(
+        "repository.preview_address_template",
+        env_var="QINGFLOW_MCP_REPOSITORY_PREVIEW_ADDRESS_TEMPLATE",
+        default=DEFAULT_REPOSITORY_PREVIEW_ADDRESS_TEMPLATE,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_PREVIEW_ADDRESS_TEMPLATE
+
+
+def get_repository_develop_branch() -> str:
+    value = get_config_value(
+        "repository.develop_branch",
+        env_var="QINGFLOW_MCP_REPOSITORY_DEVELOP_BRANCH",
+        default=DEFAULT_REPOSITORY_DEVELOP_BRANCH,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_DEVELOP_BRANCH
+
+
+def get_repository_prod_branch() -> str:
+    value = get_config_value(
+        "repository.prod_branch",
+        env_var="QINGFLOW_MCP_REPOSITORY_PROD_BRANCH",
+        default=DEFAULT_REPOSITORY_PROD_BRANCH,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_PROD_BRANCH
+
+
+def get_repository_author_name() -> str:
+    value = get_config_value(
+        "repository.author_name",
+        env_var="QINGFLOW_MCP_REPOSITORY_AUTHOR_NAME",
+        default=DEFAULT_REPOSITORY_AUTHOR_NAME,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_AUTHOR_NAME
+
+
+def get_repository_author_email() -> str:
+    value = get_config_value(
+        "repository.author_email",
+        env_var="QINGFLOW_MCP_REPOSITORY_AUTHOR_EMAIL",
+        default=DEFAULT_REPOSITORY_AUTHOR_EMAIL,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_AUTHOR_EMAIL
+
+
+def get_repository_internal_base_url() -> str | None:
+    value = get_config_value(
+        "repository.internal_base_url",
+        env_var="QINGFLOW_MCP_REPOSITORY_INTERNAL_BASE_URL",
+        default=None,
+    )
+    if value is None:
+        return None
+    normalized = normalize_base_url(str(value).strip())
+    return normalized or None
+
+
+def get_repository_internal_share_token() -> str | None:
+    value = get_config_value(
+        "repository.internal_share_token",
+        env_var="QINGFLOW_MCP_REPOSITORY_INTERNAL_SHARE_TOKEN",
+        default=None,
+    )
+    normalized = str(value or "").strip()
+    return normalized or None
+
+
+def get_repository_internal_share_token_key() -> str:
+    value = get_config_value(
+        "repository.internal_share_token_key",
+        env_var="QINGFLOW_MCP_REPOSITORY_INTERNAL_SHARE_TOKEN_KEY",
+        default=DEFAULT_REPOSITORY_INTERNAL_SHARE_TOKEN_KEY,
+    )
+    normalized = str(value or "").strip()
+    return normalized or DEFAULT_REPOSITORY_INTERNAL_SHARE_TOKEN_KEY
+
+
+def get_repository_generate_default_agent_id() -> int | None:
+    value = get_config_value(
+        "repository.generate.default_agent_id",
+        env_var="QINGFLOW_MCP_REPOSITORY_GENERATE_DEFAULT_AGENT_ID",
+        default=None,
+    )
+    if value is None:
+        return None
+    try:
+        return int(str(value).strip())
+    except (TypeError, ValueError):
+        return None
+
+
+def get_repository_generate_default_route_prefix() -> str | None:
+    value = get_config_value(
+        "repository.generate.default_route_prefix",
+        env_var="QINGFLOW_MCP_REPOSITORY_GENERATE_DEFAULT_ROUTE_PREFIX",
+        default=None,
+    )
+    normalized = str(value or "").strip()
+    return normalized or None
+
+
+def get_repository_generate_default_token_name() -> str | None:
+    value = get_config_value(
+        "repository.generate.default_token_name",
+        env_var="QINGFLOW_MCP_REPOSITORY_GENERATE_DEFAULT_TOKEN_NAME",
+        default=None,
+    )
+    normalized = str(value or "").strip()
+    return normalized or None
+
+
 def normalize_base_url(base_url: str | None) -> str | None:
     """规范化 base URL"""
     if base_url is None:

package/src/qingflow_mcp/repository_store.py

@@ -0,0 +1,71 @@
+from __future__ import annotations
+
+import json
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import Any
+
+from .config import get_repository_metadata_dir
+
+
+def _utc_now() -> str:
+    return datetime.now(timezone.utc).isoformat()
+
+
+def _safe_key(value: str) -> str:
+    keep: list[str] = []
+    for char in value:
+        if char.isalnum() or char in {"-", "_"}:
+            keep.append(char)
+        else:
+            keep.append("_")
+    normalized = "".join(keep).strip("_")
+    return normalized or "repository"
+
+
+@dataclass(slots=True)
+class RepositoryMetadataStore:
+    base_dir: Path | None = None
+    _dir: Path = field(init=False, repr=False)
+
+    def __post_init__(self) -> None:
+        self._dir = self.base_dir or get_repository_metadata_dir()
+        self._dir.mkdir(parents=True, exist_ok=True)
+
+    def put(self, repo_name: str, payload: dict[str, Any]) -> dict[str, Any]:
+        now = _utc_now()
+        existing = self.get(repo_name) or {}
+        data = dict(existing)
+        data.update(payload)
+        data["repo_name"] = repo_name
+        data["created_at"] = existing.get("created_at") or now
+        data["updated_at"] = now
+        self._path(repo_name).write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
+        return data
+
+    def get(self, repo_name: str) -> dict[str, Any] | None:
+        path = self._path(repo_name)
+        if not path.exists():
+            return None
+        try:
+            payload = json.loads(path.read_text(encoding="utf-8"))
+        except (OSError, json.JSONDecodeError):
+            path.unlink(missing_ok=True)
+            return None
+        return payload if isinstance(payload, dict) else None
+
+    def list(self) -> list[dict[str, Any]]:
+        entries: list[dict[str, Any]] = []
+        for path in sorted(self._dir.glob("*.json")):
+            try:
+                payload = json.loads(path.read_text(encoding="utf-8"))
+            except (OSError, json.JSONDecodeError):
+                continue
+            if isinstance(payload, dict):
+                entries.append(payload)
+        entries.sort(key=lambda item: str(item.get("updated_at") or ""), reverse=True)
+        return entries
+
+    def _path(self, repo_name: str) -> Path:
+        return self._dir / f"{_safe_key(repo_name)}.json"

package/src/qingflow_mcp/response_trim.py

@@ -170,6 +170,14 @@ def resolve_cli_tool_name(args: Any) -> str | None:
     if command not in {"builder", "build"}:
         return None
     builder_command = getattr(args, "builder_command", None)
+    if builder_command == "file":
+        return {
+            "upload-local": _tool_key(BUILDER_DOMAIN, "file_upload_local"),
+        }.get(getattr(args, "builder_file_command", None))
+    if builder_command == "feedback":
+        return {
+            "submit": _tool_key(BUILDER_DOMAIN, "feedback_submit"),
+        }.get(getattr(args, "builder_feedback_command", None))
     if builder_command == "contract":
         return _tool_key(BUILDER_DOMAIN, "builder_tool_contract")
     if builder_command == "member":
@@ -202,6 +210,7 @@ def resolve_cli_tool_name(args: Any) -> str | None:
         return {
             "resolve": _tool_key(BUILDER_DOMAIN, "app_resolve"),
             "release-edit-lock-if-mine": _tool_key(BUILDER_DOMAIN, "app_release_edit_lock_if_mine"),
+            "repair-code-blocks": _tool_key(BUILDER_DOMAIN, "app_repair_code_blocks"),
         }.get(app_command)
     if builder_command == "button":
         return {
@@ -316,6 +325,7 @@ BUILDER_SERVER_METHOD_MAP = {
     "app_custom_button_delete": _tool_key(BUILDER_DOMAIN, "app_custom_button_delete"),
     "app_get": _tool_key(BUILDER_DOMAIN, "app_get"),
     "app_get_fields": _tool_key(BUILDER_DOMAIN, "app_get_fields"),
+    "app_repair_code_blocks": _tool_key(BUILDER_DOMAIN, "app_repair_code_blocks"),
     "app_get_layout": _tool_key(BUILDER_DOMAIN, "app_get_layout"),
     "app_get_views": _tool_key(BUILDER_DOMAIN, "app_get_views"),
     "app_get_flow": _tool_key(BUILDER_DOMAIN, "app_get_flow"),
@@ -601,6 +611,7 @@ _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("workspace_list",), _trim_works
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("workspace_select",), _trim_workspace_select)
 _register_policy((USER_DOMAIN,), ("app_list", "app_search"), _trim_app_search_like)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("app_get",), _trim_app_get)
+_register_policy((BUILDER_DOMAIN,), ("app_repair_code_blocks",), _trim_builder_list_like)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("portal_list", "portal_get", "view_get", "chart_get"), _trim_builder_list_like)
 _register_policy((USER_DOMAIN,), ("file_get_upload_info",), _trim_file_upload_info)
 _register_policy((USER_DOMAIN, BUILDER_DOMAIN), ("file_upload_local",), _trim_file_upload_local)
@@ -685,6 +696,7 @@ _register_policy(
         "app_custom_button_update",
         "app_custom_button_delete",
         "app_get_fields",
+        "app_repair_code_blocks",
         "app_get_layout",
         "app_get_views",
         "app_get_flow",

package/src/qingflow_mcp/server_app_builder.py

@@ -34,10 +34,12 @@ def build_builder_server() -> FastMCP:
             "`feedback_submit` is always available as a cross-cutting helper when the current capability is unsupported, awkward, or still cannot satisfy the user's need after reasonable use; it does not require Qingflow login or workspace selection, and it should be called only after explicit user confirmation. "
             "Follow the resource path resolve -> summary read -> apply -> attach -> publish_verify. "
             "Use builder_tool_contract when you need a machine-readable contract, aliases, allowed enums, or a minimal valid example for a public builder tool. "
+            "Use solution_install when the user explicitly wants to install a packaged solution/template by solution_key, optionally copying bundled demo data. "
             "If creating a new package may be appropriate, ask the user to confirm package creation before calling package_create; otherwise use package_resolve/package_list and app_resolve to locate resources, "
-            "app_get/app_get_fields/app_get_layout/app_get_views/app_get_flow/app_get_charts/portal_list/portal_get/view_get/chart_get for configuration reads, "
+            "app_get/app_get_fields/app_repair_code_blocks/app_get_layout/app_get_views/app_get_flow/app_get_charts/portal_list/portal_get/view_get/chart_get for configuration reads, "
             "member_search/role_search/role_create when workflow assignees must come from the directory or role catalog, preferring roles over explicit members unless the user explicitly names members, "
             "then app_schema_apply/app_layout_apply/app_flow_apply/app_views_apply/app_charts_apply/portal_apply to execute normalized patches; these apply tools perform planning, normalization, and dependency checks internally where applicable. Schema/layout/views noop requests skip publish, charts are immediate-live without publish and resolve targets by chart_id first then exact unique chart name, portal updates are replace-only and publish=false only guarantees draft/base-info updates, and flow should use publish=false whenever you only want draft/precheck behavior. "
+            "For code_block fields with output bindings, always use qf_output assignment rather than const/let qf_output, and use app_repair_code_blocks when an existing form hangs because output-bound fields stay loading. "
             "Use package_attach_app to attach apps to packages, and app_publish_verify for explicit final publish verification. "
             "For workflow edits, keep the public builder surface on stable linear flows only: start/approve/fill/copy/webhook/end. Branch and condition nodes are intentionally disabled because the backend workflow route is not front-end stable for those node types. Declare node assignees and editable fields explicitly. "
             "If builder writes are blocked by the current user's own edit lock, use app_release_edit_lock_if_mine with the lock owner details from the failed result. "
@@ -198,6 +200,20 @@ def build_builder_server() -> FastMCP:
     ) -> dict:
         return ai_builder.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
+    @server.tool()
+    def solution_install(
+        profile: str = DEFAULT_PROFILE,
+        solution_key: str = "",
+        being_copy_data: bool = True,
+        solution_source: str = "solutionDetail",
+    ) -> dict:
+        return ai_builder.solution_install(
+            profile=profile,
+            solution_key=solution_key,
+            being_copy_data=being_copy_data,
+            solution_source=solution_source,
+        )
+
     @server.tool()
     def member_search(
         profile: str = DEFAULT_PROFILE,
@@ -318,6 +334,15 @@ def build_builder_server() -> FastMCP:
     def app_get_fields(profile: str = DEFAULT_PROFILE, app_key: str = "") -> dict:
         return ai_builder.app_get_fields(profile=profile, app_key=app_key)
 
+    @server.tool()
+    def app_repair_code_blocks(
+        profile: str = DEFAULT_PROFILE,
+        app_key: str = "",
+        field: str | None = None,
+        apply: bool = False,
+    ) -> dict:
+        return ai_builder.app_repair_code_blocks(profile=profile, app_key=app_key, field=field, apply=apply)
+
     @server.tool()
     def app_get_layout(profile: str = DEFAULT_PROFILE, app_key: str = "") -> dict:
         return ai_builder.app_get_layout(profile=profile, app_key=app_key)