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

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

@@ -77,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")
@@ -114,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)
 
@@ -144,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="读取门户详情")
@@ -310,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,
@@ -404,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

@@ -12,6 +12,7 @@ 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
@@ -32,6 +33,7 @@ class CliContext:
     files: FileTools
     builder_feedback: FeedbackTools
     builder: AiBuilderTools
+    repo: RepositoryDevTools
 
     def close(self) -> None:
         self.backend.close()
@@ -54,4 +56,5 @@ def build_cli_context() -> CliContext:
         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

@@ -210,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 {
@@ -324,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"),
@@ -609,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)
@@ -693,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)

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -90,6 +90,20 @@ class AiBuilderTools(ToolBase):
         ) -> JSONObject:
             return self.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
+        @mcp.tool()
+        def solution_install(
+            profile: str = DEFAULT_PROFILE,
+            solution_key: str = "",
+            being_copy_data: bool = True,
+            solution_source: str = "solutionDetail",
+        ) -> JSONObject:
+            return self.solution_install(
+                profile=profile,
+                solution_key=solution_key,
+                being_copy_data=being_copy_data,
+                solution_source=solution_source,
+            )
+
         @mcp.tool()
         def member_search(
             profile: str = DEFAULT_PROFILE,
@@ -216,6 +230,15 @@ class AiBuilderTools(ToolBase):
         def app_get_fields(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
             return self.app_get_fields(profile=profile, app_key=app_key)
 
+        @mcp.tool()
+        def app_repair_code_blocks(
+            profile: str = DEFAULT_PROFILE,
+            app_key: str = "",
+            field: str | None = None,
+            apply: bool = False,
+        ) -> JSONObject:
+            return self.app_repair_code_blocks(profile=profile, app_key=app_key, field=field, apply=apply)
+
         @mcp.tool()
         def app_get_layout(profile: str = DEFAULT_PROFILE, app_key: str = "") -> JSONObject:
             return self.app_get_layout(profile=profile, app_key=app_key)
@@ -519,6 +542,31 @@ class AiBuilderTools(ToolBase):
             },
         )
 
+    def solution_install(
+        self,
+        *,
+        profile: str,
+        solution_key: str,
+        being_copy_data: bool = True,
+        solution_source: str = "solutionDetail",
+    ) -> JSONObject:
+        normalized_args = {
+            "solution_key": solution_key,
+            "being_copy_data": being_copy_data,
+            "solution_source": solution_source,
+        }
+        return _safe_tool_call(
+            lambda: self._facade.solution_install(
+                profile=profile,
+                solution_key=solution_key,
+                being_copy_data=being_copy_data,
+                solution_source=solution_source,
+            ),
+            error_code="SOLUTION_INSTALL_FAILED",
+            normalized_args=normalized_args,
+            suggested_next_call={"tool_name": "solution_install", "arguments": {"profile": profile, **normalized_args}},
+        )
+
     def member_search(
         self,
         *,
@@ -768,6 +816,22 @@ class AiBuilderTools(ToolBase):
             suggested_next_call={"tool_name": "app_get_fields", "arguments": {"profile": profile, "app_key": app_key}},
         )
 
+    def app_repair_code_blocks(
+        self,
+        *,
+        profile: str,
+        app_key: str,
+        field: str | None = None,
+        apply: bool = False,
+    ) -> JSONObject:
+        normalized_args = {"app_key": app_key, "field": field, "apply": apply}
+        return _safe_tool_call(
+            lambda: self._facade.app_repair_code_blocks(profile=profile, app_key=app_key, field=field, apply=apply),
+            error_code="APP_REPAIR_CODE_BLOCKS_FAILED",
+            normalized_args=normalized_args,
+            suggested_next_call={"tool_name": "app_repair_code_blocks", "arguments": {"profile": profile, **normalized_args}},
+        )
+
     def app_read_layout_summary(self, *, profile: str, app_key: str) -> JSONObject:
         normalized_args = {"app_key": app_key}
         return _safe_tool_call(
@@ -1889,6 +1953,7 @@ def _public_error_message(error_code: str, error: QingflowApiError) -> str:
     mapping = {
         "PACKAGE_LIST_FAILED": "package list is unavailable in the current route",
         "PACKAGE_RESOLVE_FAILED": "package resolution is unavailable in the current route",
+        "SOLUTION_INSTALL_FAILED": "solution install could not complete because the app creation route or solution source is unavailable",
         "PACKAGE_ATTACH_FAILED": "package attachment could not be verified in the current route",
         "APP_RESOLVE_FAILED": "app resolution is unavailable in the current route",
         "CUSTOM_BUTTON_LIST_FAILED": "custom button list is unavailable in the current route",
@@ -1994,6 +2059,32 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "color": "azure",
         },
     },
+    "solution_install": {
+        "allowed_keys": ["solution_key", "being_copy_data", "solution_source"],
+        "aliases": {
+            "solutionKey": "solution_key",
+            "beingCopyData": "being_copy_data",
+            "copy_data": "being_copy_data",
+            "copyData": "being_copy_data",
+            "solutionSource": "solution_source",
+            "source": "solution_source",
+        },
+        "allowed_values": {
+            "being_copy_data": [True, False],
+            "solution_source": ["solutionDetail"],
+        },
+        "execution_notes": [
+            "solution_install calls the backend app creation route with a solutionKey payload",
+            "this is a write operation that may create multiple apps at once",
+            "app_keys are verified from the backend response when available",
+        ],
+        "minimal_example": {
+            "profile": "default",
+            "solution_key": "cfqrhth99401",
+            "being_copy_data": True,
+            "solution_source": "solutionDetail",
+        },
+    },
     "member_search": {
         "allowed_keys": ["query", "page_num", "page_size", "contain_disable"],
         "aliases": {},
@@ -2273,6 +2364,8 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "q_linker_binding lets you declare request config, dynamic inputs, alias parsing, and target-field bindings in one step; builder writes remoteLookupConfig plus the existing backend relation-default and questionRelations structures",
             "code_block_binding lets you declare inputs, code, alias parsing, and target-field bindings in one step; builder writes codeBlockConfig plus the existing backend relation-default and questionRelations structures",
             "builder configures code blocks only; it does not execute or trigger code blocks",
+            "code block outputs must be emitted through qf_output assignment; use qf_output = {...} or assign qf_output after building the result object, never const/let qf_output =",
+            "builder automatically normalizes const/let qf_output assignments on write and rejects output-bound code blocks that still do not contain a valid qf_output assignment",
             "code_block_binding and q_linker_binding target fields are limited to text, long_text, number, amount, date, datetime, single_select, multi_select, and boolean",
         ],
         "minimal_example": {
@@ -2858,6 +2951,23 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "expected_package_tag_id": 1001,
         },
     },
+    "app_repair_code_blocks": {
+        "allowed_keys": ["app_key", "field", "apply"],
+        "aliases": {},
+        "allowed_values": {},
+        "execution_notes": [
+            "scan existing code_block fields for qf_output shadowing, missing output assignment, and broken writeback defaults",
+            "apply=false is a dry-run and returns a repair plan without writing builder config",
+            "apply=true rewrites only safe cases: const/let qf_output shadowing and stale relation-default output bindings reconstructed from readable code_block_binding config",
+            "this tool does not invent missing output aliases or guess missing target bindings when only low-level codeBlockConfig is present",
+        ],
+        "minimal_example": {
+            "profile": "default",
+            "app_key": "APP_KEY",
+            "field": "线索价值评估",
+            "apply": False,
+        },
+    },
 }
 
 _PRIVATE_BUILDER_TOOL_CONTRACTS = {