@josephyan/qingflow-cli 0.2.0-beta.63 → 0.2.0-beta.65

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

@@ -93,6 +93,8 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     schema_apply_apply.add_argument("--package-tag-id", type=int)
     schema_apply_apply.add_argument("--app-name", default="")
     schema_apply_apply.add_argument("--app-title", default="")
+    schema_apply_apply.add_argument("--icon")
+    schema_apply_apply.add_argument("--color")
     schema_apply_apply.add_argument("--create-if-missing", action="store_true")
     schema_apply_apply.add_argument("--publish", action=argparse.BooleanOptionalAction, default=True)
     schema_apply_apply.add_argument("--add-fields-file")
@@ -198,6 +200,8 @@ def _handle_schema_apply(args: argparse.Namespace, context: CliContext) -> dict:
         package_tag_id=args.package_tag_id,
         app_name=args.app_name,
         app_title=args.app_title,
+        icon=args.icon,
+        color=args.color,
         create_if_missing=bool(args.create_if_missing),
         publish=bool(args.publish),
         add_fields=load_list_arg(args.add_fields_file, option_name="--add-fields-file"),

package/src/qingflow_mcp/server_app_builder.py

@@ -280,6 +280,8 @@ def build_builder_server() -> FastMCP:
         package_tag_id: int | None = None,
         app_name: str = "",
         app_title: str = "",
+        icon: str = "",
+        color: str = "",
         create_if_missing: bool = False,
         publish: bool = True,
         add_fields: list[dict] | None = None,
@@ -292,6 +294,8 @@ def build_builder_server() -> FastMCP:
             package_tag_id=package_tag_id,
             app_name=app_name,
             app_title=app_title,
+            icon=icon,
+            color=color,
             create_if_missing=create_if_missing,
             publish=publish,
             add_fields=add_fields or [],

package/src/qingflow_mcp/solution/compiler/icon_utils.py

@@ -4,6 +4,18 @@ import json
 
 
 DEFAULT_ICON_COLOR = "qing-orange"
+DEFAULT_ICON_STYLE_POOL: tuple[tuple[str, str], ...] = (
+    ("briefcase", "qing-orange"),
+    ("calendar", "emerald"),
+    ("folder", "azure"),
+    ("shield-check", "indigo"),
+    ("user-group", "qing-purple"),
+    ("chart-square-bar", "blue"),
+    ("clock", "pink"),
+    ("document-text", "green"),
+    ("home", "orange"),
+    ("globe", "red"),
+)
 SUPPORTED_EX_ICONS = {
     "ex-alert-outlined",
     "ex-clock-outlined",
@@ -78,6 +90,65 @@ def encode_workspace_icon(
     )
 
 
+def choose_default_workspace_icon_style(*, title: str) -> tuple[str, str]:
+    seed_text = (title or "未命名").strip() or "未命名"
+    digest = 0
+    for index, char in enumerate(seed_text):
+        digest = (digest * 131 + ord(char) + index) % 1_000_003
+    return DEFAULT_ICON_STYLE_POOL[digest % len(DEFAULT_ICON_STYLE_POOL)]
+
+
+def parse_workspace_icon(value: str | None) -> tuple[str | None, str | None, str | None]:
+    if not value:
+        return None, None, None
+    stripped = str(value).strip()
+    if not stripped:
+        return None, None, None
+    if _looks_like_icon_json(stripped):
+        try:
+            payload = json.loads(stripped)
+        except Exception:
+            return normalize_workspace_icon_name(stripped), None, None
+        icon_name = normalize_workspace_icon_name(payload.get("iconName"))
+        icon_color = str(payload.get("iconColor") or "").strip() or None
+        icon_text = str(payload.get("iconText") or "").strip() or None
+        return icon_name, icon_color, icon_text
+    return normalize_workspace_icon_name(stripped), None, None
+
+
+def encode_workspace_icon_with_defaults(
+    *,
+    icon: str | None,
+    color: str | None,
+    title: str,
+    fallback_icon_name: str | None = None,
+    existing_icon: str | None = None,
+) -> str:
+    if icon and _looks_like_icon_json(icon):
+        return icon
+    if not icon and not color and existing_icon:
+        existing_payload = str(existing_icon).strip()
+        if existing_payload:
+            return existing_payload
+    existing_icon_name, existing_icon_color, _ = parse_workspace_icon(existing_icon)
+    default_icon, default_color = choose_default_workspace_icon_style(title=title)
+    resolved_icon = icon or existing_icon_name
+    resolved_color = color or existing_icon_color
+    if not resolved_icon:
+        if icon is None and color is None:
+            resolved_icon = default_icon
+        else:
+            resolved_icon = fallback_icon_name or default_icon
+    if not resolved_color:
+        resolved_color = default_color
+    return encode_workspace_icon(
+        icon=resolved_icon,
+        color=resolved_color,
+        title=title,
+        fallback_icon_name=fallback_icon_name,
+    )
+
+
 def normalize_workspace_icon_name(icon: str | None) -> str | None:
     if not icon:
         return None

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -228,6 +228,8 @@ class AiBuilderTools(ToolBase):
             package_tag_id: int | None = None,
             app_name: str = "",
             app_title: str = "",
+            icon: str = "",
+            color: str = "",
             create_if_missing: bool = False,
             publish: bool = True,
             add_fields: list[JSONObject] | None = None,
@@ -240,6 +242,8 @@ class AiBuilderTools(ToolBase):
                 package_tag_id=package_tag_id,
                 app_name=app_name,
                 app_title=app_title,
+                icon=icon,
+                color=color,
                 create_if_missing=create_if_missing,
                 publish=publish,
                 add_fields=add_fields or [],
@@ -713,6 +717,8 @@ class AiBuilderTools(ToolBase):
         app_key: str = "",
         package_tag_id: int | None = None,
         app_name: str = "",
+        icon: str = "",
+        color: str = "",
         create_if_missing: bool = False,
         add_fields: list[JSONObject],
         update_fields: list[JSONObject],
@@ -724,6 +730,8 @@ class AiBuilderTools(ToolBase):
                     "app_key": app_key,
                     "package_tag_id": package_tag_id,
                     "app_name": app_name,
+                    "icon": icon,
+                    "color": color,
                     "create_if_missing": create_if_missing,
                     "add_fields": add_fields,
                     "update_fields": update_fields,
@@ -742,6 +750,8 @@ class AiBuilderTools(ToolBase):
                         "app_key": app_key,
                         "package_tag_id": package_tag_id,
                         "app_name": app_name,
+                        "icon": icon,
+                        "color": color,
                         "create_if_missing": create_if_missing,
                         "add_fields": [{"name": "字段名称", "type": "text"}],
                         "update_fields": [],
@@ -889,6 +899,8 @@ class AiBuilderTools(ToolBase):
         package_tag_id: int | None = None,
         app_name: str = "",
         app_title: str = "",
+        icon: str = "",
+        color: str = "",
         create_if_missing: bool = False,
         publish: bool = True,
         add_fields: list[JSONObject],
@@ -901,6 +913,8 @@ class AiBuilderTools(ToolBase):
             package_tag_id=package_tag_id,
             app_name=app_name,
             app_title=app_title,
+            icon=icon,
+            color=color,
             create_if_missing=create_if_missing,
             publish=publish,
             add_fields=add_fields,
@@ -916,6 +930,8 @@ class AiBuilderTools(ToolBase):
                 package_tag_id=package_tag_id,
                 app_name=app_name,
                 app_title=app_title,
+                icon=icon,
+                color=color,
                 create_if_missing=create_if_missing,
                 publish=publish,
                 add_fields=add_fields,
@@ -932,6 +948,8 @@ class AiBuilderTools(ToolBase):
         package_tag_id: int | None = None,
         app_name: str = "",
         app_title: str = "",
+        icon: str = "",
+        color: str = "",
         create_if_missing: bool = False,
         publish: bool = True,
         add_fields: list[JSONObject],
@@ -945,6 +963,8 @@ class AiBuilderTools(ToolBase):
                 app_key=app_key,
                 package_tag_id=package_tag_id,
                 app_name=effective_app_name,
+                icon=icon,
+                color=color,
                 create_if_missing=create_if_missing,
                 add_fields=add_fields,
                 update_fields=update_fields,
@@ -976,6 +996,8 @@ class AiBuilderTools(ToolBase):
                         "app_key": str(plan_args.get("app_key") or app_key),
                         "package_tag_id": plan_args.get("package_tag_id", package_tag_id),
                         "app_name": str(plan_args.get("app_name") or effective_app_name),
+                        "icon": str(plan_args.get("icon") or icon),
+                        "color": str(plan_args.get("color") or color),
                         "create_if_missing": bool(plan_args.get("create_if_missing", create_if_missing)),
                         "publish": publish,
                         "add_fields": plan_args.get("add_fields") or [{"name": "字段名称", "type": "text", "required": False}],
@@ -988,6 +1010,8 @@ class AiBuilderTools(ToolBase):
             "app_key": str(plan_args.get("app_key") or app_key),
             "package_tag_id": plan_args.get("package_tag_id", package_tag_id),
             "app_name": str(plan_args.get("app_name") or effective_app_name),
+            "icon": str(plan_args.get("icon") or icon or ""),
+            "color": str(plan_args.get("color") or color or ""),
             "create_if_missing": bool(plan_args.get("create_if_missing", create_if_missing)),
             "publish": publish,
             "add_fields": [patch.model_dump(mode="json") for patch in parsed_add],
@@ -1000,6 +1024,8 @@ class AiBuilderTools(ToolBase):
                 app_key=str(plan_args.get("app_key") or app_key),
                 package_tag_id=plan_args.get("package_tag_id", package_tag_id),
                 app_name=str(plan_args.get("app_name") or effective_app_name),
+                icon=str(plan_args.get("icon") or icon or ""),
+                color=str(plan_args.get("color") or color or ""),
                 create_if_missing=bool(plan_args.get("create_if_missing", create_if_missing)),
                 publish=publish,
                 add_fields=parsed_add,
@@ -1744,6 +1770,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "payload.backgroundColor": "payload.background_color",
             "payload.textColor": "payload.text_color",
             "payload.buttonIcon": "payload.button_icon",
+            "payload.iconColor": "payload.icon_color",
             "payload.triggerAction": "payload.trigger_action",
             "payload.triggerLinkUrl": "payload.trigger_link_url",
             "payload.triggerAddDataConfig": "payload.trigger_add_data_config",
@@ -1762,6 +1789,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
                 "background_color": "#FFFFFF",
                 "text_color": "#494F57",
                 "button_icon": "ex-add-outlined",
+                "icon_color": "#494F57",
                 "trigger_action": "link",
                 "trigger_link_url": "https://example.com",
             },
@@ -1775,6 +1803,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "payload.backgroundColor": "payload.background_color",
             "payload.textColor": "payload.text_color",
             "payload.buttonIcon": "payload.button_icon",
+            "payload.iconColor": "payload.icon_color",
             "payload.triggerAction": "payload.trigger_action",
             "payload.triggerLinkUrl": "payload.trigger_link_url",
             "payload.triggerAddDataConfig": "payload.trigger_add_data_config",
@@ -1794,6 +1823,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
                 "background_color": "#FFFFFF",
                 "text_color": "#494F57",
                 "button_icon": "ex-link-outlined",
+                "icon_color": "#494F57",
                 "trigger_action": "link",
                 "trigger_link_url": "https://example.com/detail",
             },
@@ -1810,7 +1840,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
         },
     },
     "app_schema_plan": {
-        "allowed_keys": ["app_key", "package_tag_id", "app_name", "create_if_missing", "add_fields", "update_fields", "remove_fields"],
+        "allowed_keys": ["app_key", "package_tag_id", "app_name", "icon", "color", "create_if_missing", "add_fields", "update_fields", "remove_fields"],
         "aliases": {
             "app_title": "app_name",
             "title": "app_name",
@@ -1835,6 +1865,8 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "profile": "default",
             "app_name": "研发项目管理",
             "package_tag_id": 1001,
+            "icon": "template",
+            "color": "emerald",
             "create_if_missing": True,
             "add_fields": [{"name": "项目名称", "type": "text"}],
             "update_fields": [],
@@ -1858,7 +1890,7 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
         },
     },
     "app_schema_apply": {
-        "allowed_keys": ["app_key", "package_tag_id", "app_name", "create_if_missing", "publish", "add_fields", "update_fields", "remove_fields"],
+        "allowed_keys": ["app_key", "package_tag_id", "app_name", "icon", "color", "create_if_missing", "publish", "add_fields", "update_fields", "remove_fields"],
         "aliases": {
             "app_title": "app_name",
             "title": "app_name",
@@ -1888,6 +1920,8 @@ _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
             "profile": "default",
             "app_name": "研发项目管理",
             "package_tag_id": 1001,
+            "icon": "template",
+            "color": "emerald",
             "create_if_missing": True,
             "publish": True,
             "add_fields": [{"name": "项目名称", "type": "text"}],

package/src/qingflow_mcp/tools/custom_button_tools.py

@@ -147,6 +147,7 @@ class CustomButtonTools(ToolBase):
             "button_id": item.get("buttonId"),
             "button_text": item.get("buttonText"),
             "button_icon": item.get("buttonIcon"),
+            "icon_color": item.get("iconColor"),
             "background_color": item.get("backgroundColor"),
             "text_color": item.get("textColor"),
             "creator_user_info": {
@@ -165,6 +166,7 @@ class CustomButtonTools(ToolBase):
             "button_id": item.get("buttonId"),
             "button_text": item.get("buttonText"),
             "button_icon": item.get("buttonIcon"),
+            "icon_color": item.get("iconColor"),
             "background_color": item.get("backgroundColor"),
             "text_color": item.get("textColor"),
             "trigger_action": item.get("triggerAction"),