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

package/README.md

@@ -3,13 +3,13 @@
 Install:
 
 ```bash
-npm install @josephyan/qingflow-cli@0.2.0-beta.65
+npm install @josephyan/qingflow-cli@0.2.0-beta.67
 ```
 
 Run:
 
 ```bash
-npx -y -p @josephyan/qingflow-cli@0.2.0-beta.65 qingflow
+npx -y -p @josephyan/qingflow-cli@0.2.0-beta.67 qingflow
 ```
 
 Environment:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@josephyan/qingflow-cli",
-  "version": "0.2.0-beta.65",
+  "version": "0.2.0-beta.67",
   "description": "Human-friendly Qingflow command line interface for auth, record operations, import, tasks, and stable builder flows.",
   "license": "MIT",
   "type": "module",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qingflow-mcp"
-version = "0.2.0b65"
+version = "0.2.0b67"
 description = "User-authenticated MCP server for Qingflow"
 readme = "README.md"
 license = "MIT"

package/src/qingflow_mcp/builder_facade/service.py

@@ -192,7 +192,11 @@ class AiBuilderFacade:
             )
         items = listing.get("items") if isinstance(listing.get("items"), list) else []
         matches = [
-            {"tag_id": item.get("tagId"), "tag_name": item.get("tagName")}
+            {
+                "tag_id": item.get("tagId"),
+                "tag_name": item.get("tagName"),
+                "tag_icon": str(item.get("tagIcon") or "").strip() or None,
+            }
             for item in items
             if isinstance(item, dict) and item.get("tagName") == requested and _coerce_positive_int(item.get("tagId")) is not None
         ]
@@ -226,12 +230,24 @@ class AiBuilderFacade:
             "verification": {},
             "tag_id": match["tag_id"],
             "tag_name": match["tag_name"],
+            "tag_icon": match.get("tag_icon"),
             "match_mode": "exact",
         }
 
-    def package_create(self, *, profile: str, package_name: str) -> JSONObject:
+    def package_create(
+        self,
+        *,
+        profile: str,
+        package_name: str,
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> JSONObject:
         requested = str(package_name or "").strip()
-        normalized_args = {"package_name": requested}
+        normalized_args = {
+            "package_name": requested,
+            **({"icon": icon} if icon else {}),
+            **({"color": color} if color else {}),
+        }
         if not requested:
             return _failed(
                 "PACKAGE_NAME_REQUIRED",
@@ -239,6 +255,12 @@ class AiBuilderFacade:
                 normalized_args=normalized_args,
                 suggested_next_call=None,
             )
+        desired_tag_icon = encode_workspace_icon_with_defaults(
+            icon=icon,
+            color=color,
+            title=requested,
+            fallback_icon_name="files-folder",
+        )
         existing = self.package_resolve(profile=profile, package_name=requested)
         lookup_permission_blocked = None
         if existing.get("status") == "success":
@@ -257,6 +279,7 @@ class AiBuilderFacade:
                 "verification": {"existing_package_reused": True},
                 "tag_id": existing.get("tag_id"),
                 "tag_name": existing.get("tag_name"),
+                "tag_icon": existing.get("tag_icon"),
             }
         if existing.get("error_code") == "AMBIGUOUS_PACKAGE":
             return existing
@@ -271,7 +294,10 @@ class AiBuilderFacade:
         elif existing.get("error_code") not in {"PACKAGE_NOT_FOUND"}:
             return existing
         try:
-            created = self.packages.package_create(profile=profile, payload={"tagName": requested})
+            created = self.packages.package_create(
+                profile=profile,
+                payload={"tagName": requested, "tagIcon": desired_tag_icon},
+            )
         except (QingflowApiError, RuntimeError) as error:
             api_error = _coerce_api_error(error)
             return _failed_from_api_error(
@@ -282,16 +308,26 @@ class AiBuilderFacade:
                     "package_name": requested,
                     **({"lookup_permission_blocked": lookup_permission_blocked} if lookup_permission_blocked is not None else {}),
                 },
-                suggested_next_call={"tool_name": "package_create", "arguments": {"profile": profile, "package_name": requested}},
+                suggested_next_call={
+                    "tool_name": "package_create",
+                    "arguments": {
+                        "profile": profile,
+                        "package_name": requested,
+                        **({"icon": icon} if icon else {}),
+                        **({"color": color} if color else {}),
+                    },
+                },
             )
         result = created.get("result") if isinstance(created.get("result"), dict) else {}
         tag_id = _coerce_positive_int(result.get("tagId"))
         tag_name = str(result.get("tagName") or requested).strip() or requested
+        tag_icon = str(result.get("tagIcon") or desired_tag_icon or "").strip() or None
         if tag_id is None:
             resolved = self.package_resolve(profile=profile, package_name=requested)
             if resolved.get("status") == "success":
                 tag_id = _coerce_positive_int(resolved.get("tag_id"))
                 tag_name = str(resolved.get("tag_name") or tag_name)
+                tag_icon = str(resolved.get("tag_icon") or tag_icon or "").strip() or None
         verified = tag_id is not None
         return {
             "status": "success" if verified else "partial_success",
@@ -310,6 +346,7 @@ class AiBuilderFacade:
             "verification": {"tag_id_verified": verified},
             "tag_id": tag_id,
             "tag_name": tag_name,
+            "tag_icon": tag_icon,
         }
 
     def package_list(self, *, profile: str, trial_status: str = "all") -> JSONObject:

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

@@ -12,10 +12,20 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
 
     package = builder_subparsers.add_parser("package", help="应用包")
     package_subparsers = package.add_subparsers(dest="builder_package_command", required=True)
+    package_list = package_subparsers.add_parser("list", help="列出应用包")
+    package_list.add_argument("--trial-status", default="all")
+    package_list.set_defaults(handler=_handle_package_list, format_hint="builder_summary")
+
     package_resolve = package_subparsers.add_parser("resolve", help="解析应用包")
     package_resolve.add_argument("--package-name", required=True)
     package_resolve.set_defaults(handler=_handle_package_resolve, 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")
+    package_create.add_argument("--color")
+    package_create.set_defaults(handler=_handle_package_create, format_hint="builder_summary")
+
     app = builder_subparsers.add_parser("app", help="应用")
     app_subparsers = app.add_subparsers(dest="builder_app_command", required=True)
 
@@ -119,10 +129,23 @@ def register(subparsers: argparse._SubParsersAction[argparse.ArgumentParser]) ->
     publish_verify_verify.set_defaults(handler=_handle_publish_verify, format_hint="builder_summary")
 
 
+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_package_resolve(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.package_resolve(profile=args.profile, package_name=args.package_name)
 
 
+def _handle_package_create(args: argparse.Namespace, context: CliContext) -> dict:
+    return context.builder.package_create(
+        profile=args.profile,
+        package_name=args.package_name,
+        icon=args.icon,
+        color=args.color,
+    )
+
+
 def _handle_app_resolve(args: argparse.Namespace, context: CliContext) -> dict:
     return context.builder.app_resolve(
         profile=args.profile,

package/src/qingflow_mcp/server_app_builder.py

@@ -138,8 +138,13 @@ def build_builder_server() -> FastMCP:
         return ai_builder.builder_tool_contract(tool_name=tool_name)
 
     @server.tool()
-    def package_create(profile: str = DEFAULT_PROFILE, package_name: str = "") -> dict:
-        return ai_builder.package_create(profile=profile, package_name=package_name)
+    def package_create(
+        profile: str = DEFAULT_PROFILE,
+        package_name: str = "",
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> dict:
+        return ai_builder.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
     @server.tool()
     def member_search(

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

@@ -1,13 +1,14 @@
 from __future__ import annotations
 
 import json
+import re
 
 
 DEFAULT_ICON_COLOR = "qing-orange"
 DEFAULT_ICON_STYLE_POOL: tuple[tuple[str, str], ...] = (
     ("briefcase", "qing-orange"),
     ("calendar", "emerald"),
-    ("folder", "azure"),
+    ("files-folder", "azure"),
     ("shield-check", "indigo"),
     ("user-group", "qing-purple"),
     ("chart-square-bar", "blue"),
@@ -16,41 +17,41 @@ DEFAULT_ICON_STYLE_POOL: tuple[tuple[str, str], ...] = (
     ("home", "orange"),
     ("globe", "red"),
 )
-SUPPORTED_EX_ICONS = {
-    "ex-alert-outlined",
-    "ex-clock-outlined",
-    "ex-folder-outlined",
-    "ex-form-outlined",
-    "ex-home-outlined",
-    "ex-user-outlined",
+LEGACY_EX_ICON_MAP = {
+    "ex-alert-outlined": "exclamation-circle",
+    "ex-clock-outlined": "clock",
+    "ex-folder-outlined": "folder",
+    "ex-form-outlined": "template",
+    "ex-home-outlined": "home",
+    "ex-user-outlined": "user",
 }
 
 ICON_ALIAS_MAP = {
-    "archive-box": "ex-form-outlined",
-    "beaker": "ex-form-outlined",
-    "briefcase": "ex-folder-outlined",
-    "building-office": "ex-form-outlined",
-    "calendar": "ex-clock-outlined",
-    "chat": "ex-clock-outlined",
-    "chat-bubble-left-right": "ex-clock-outlined",
-    "chart-bar": "ex-form-outlined",
-    "chart-square-bar": "ex-form-outlined",
-    "check-badge": "ex-alert-outlined",
-    "check-circle": "ex-alert-outlined",
-    "clipboard-check": "ex-form-outlined",
-    "clock": "ex-clock-outlined",
-    "cube": "ex-form-outlined",
-    "document-text": "ex-form-outlined",
-    "folder": "ex-folder-outlined",
-    "home": "ex-home-outlined",
-    "office-building": "ex-form-outlined",
-    "shield-check": "ex-alert-outlined",
-    "template": "ex-form-outlined",
-    "user": "ex-user-outlined",
-    "user-group": "ex-user-outlined",
-    "users": "ex-user-outlined",
-    "view-grid": "ex-home-outlined",
-    "warning": "ex-alert-outlined",
+    "archive-box": "template",
+    "beaker": "beaker",
+    "briefcase": "briefcase",
+    "building-office": "office-building",
+    "calendar": "calendar",
+    "chat": "chat",
+    "chat-bubble-left-right": "chat",
+    "chart-bar": "chart-bar",
+    "chart-square-bar": "chart-square-bar",
+    "check-badge": "badge-check",
+    "check-circle": "check-circle",
+    "clipboard-check": "clipboard-check",
+    "clock": "clock",
+    "cube": "cube-transparent",
+    "document-text": "document-text",
+    "folder": "files-folder",
+    "home": "home",
+    "office-building": "office-building",
+    "shield-check": "shield-check",
+    "template": "template",
+    "user": "user",
+    "user-group": "user-group",
+    "users": "user-group",
+    "view-grid": "view-grid",
+    "warning": "exclamation-circle",
 }
 
 
@@ -64,8 +65,6 @@ def encode_workspace_icon(
     if icon and _looks_like_icon_json(icon):
         return icon
     normalized_icon_name = normalize_workspace_icon_name(icon or fallback_icon_name)
-    if normalized_icon_name and normalized_icon_name.startswith("ex-") and not color:
-        return normalized_icon_name
     icon_name = normalized_icon_name
     icon_color = color or DEFAULT_ICON_COLOR
     if icon_name:
@@ -156,27 +155,31 @@ def normalize_workspace_icon_name(icon: str | None) -> str | None:
         try:
             payload = json.loads(icon)
         except Exception:
-            return "ex-form-outlined"
-        return normalize_workspace_icon_name(payload.get("iconName")) or "ex-form-outlined"
-    if icon in SUPPORTED_EX_ICONS:
-        return icon
+            return "template"
+        return normalize_workspace_icon_name(payload.get("iconName")) or "template"
     normalized = icon.strip().lower()
+    if normalized in LEGACY_EX_ICON_MAP:
+        return LEGACY_EX_ICON_MAP[normalized]
     if normalized in ICON_ALIAS_MAP:
         return ICON_ALIAS_MAP[normalized]
     for token in normalized.replace("_", "-").split("-"):
         if token in ICON_ALIAS_MAP:
             return ICON_ALIAS_MAP[token]
     if "folder" in normalized or "package" in normalized:
-        return "ex-folder-outlined"
-    if "home" in normalized or "portal" in normalized or "dashboard" in normalized:
-        return "ex-home-outlined"
+        return "files-folder"
+    if "home" in normalized:
+        return "home"
+    if "portal" in normalized or "dashboard" in normalized:
+        return "view-grid"
     if "user" in normalized or "member" in normalized or "contact" in normalized:
-        return "ex-user-outlined"
+        return "user"
     if "clock" in normalized or "time" in normalized or "schedule" in normalized or "log" in normalized:
-        return "ex-clock-outlined"
+        return "clock"
     if "risk" in normalized or "alert" in normalized or "warn" in normalized or "safety" in normalized:
-        return "ex-alert-outlined"
-    return "ex-form-outlined"
+        return "exclamation-circle"
+    if re.fullmatch(r"[a-z0-9-]+", normalized):
+        return normalized
+    return "template"
 
 
 def _looks_like_icon_json(value: str) -> bool:

package/src/qingflow_mcp/tools/ai_builder_tools.py

@@ -82,8 +82,13 @@ class AiBuilderTools(ToolBase):
             return self.builder_tool_contract(tool_name=tool_name)
 
         @mcp.tool()
-        def package_create(profile: str = DEFAULT_PROFILE, package_name: str = "") -> JSONObject:
-            return self.package_create(profile=profile, package_name=package_name)
+        def package_create(
+            profile: str = DEFAULT_PROFILE,
+            package_name: str = "",
+            icon: str | None = None,
+            color: str | None = None,
+        ) -> JSONObject:
+            return self.package_create(profile=profile, package_name=package_name, icon=icon, color=color)
 
         @mcp.tool()
         def member_search(
@@ -425,13 +430,32 @@ class AiBuilderTools(ToolBase):
             "contract": contract,
         }
 
-    def package_create(self, *, profile: str, package_name: str) -> JSONObject:
-        normalized_args = {"package_name": package_name}
+    def package_create(
+        self,
+        *,
+        profile: str,
+        package_name: str,
+        icon: str | None = None,
+        color: str | None = None,
+    ) -> JSONObject:
+        normalized_args = {
+            "package_name": package_name,
+            **({"icon": icon} if icon else {}),
+            **({"color": color} if color else {}),
+        }
         return _safe_tool_call(
-            lambda: self._facade.package_create(profile=profile, package_name=package_name),
+            lambda: self._facade.package_create(profile=profile, package_name=package_name, icon=icon, color=color),
             error_code="PACKAGE_CREATE_FAILED",
             normalized_args=normalized_args,
-            suggested_next_call={"tool_name": "package_create", "arguments": {"profile": profile, "package_name": package_name}},
+            suggested_next_call={
+                "tool_name": "package_create",
+                "arguments": {
+                    "profile": profile,
+                    "package_name": package_name,
+                    **({"icon": icon} if icon else {}),
+                    **({"color": color} if color else {}),
+                },
+            },
         )
 
     def member_search(
@@ -1708,6 +1732,39 @@ def _public_error_message(error_code: str, error: QingflowApiError) -> str:
 
 
 _BUILDER_TOOL_CONTRACTS: dict[str, JSONObject] = {
+    "package_list": {
+        "allowed_keys": ["trial_status"],
+        "aliases": {"trialStatus": "trial_status"},
+        "allowed_values": {"trial_status": ["all", "trial", "formal"]},
+        "minimal_example": {
+            "profile": "default",
+            "trial_status": "all",
+        },
+    },
+    "package_resolve": {
+        "allowed_keys": ["package_name"],
+        "aliases": {"packageName": "package_name"},
+        "allowed_values": {},
+        "minimal_example": {
+            "profile": "default",
+            "package_name": "PLM（备用，施工中）",
+        },
+    },
+    "package_create": {
+        "allowed_keys": ["package_name", "icon", "color"],
+        "aliases": {
+            "packageName": "package_name",
+            "iconName": "icon",
+            "iconColor": "color",
+        },
+        "allowed_values": {},
+        "minimal_example": {
+            "profile": "default",
+            "package_name": "项目管理",
+            "icon": "files-folder",
+            "color": "azure",
+        },
+    },
     "member_search": {
         "allowed_keys": ["query", "page_num", "page_size", "contain_disable"],
         "aliases": {},

package/src/qingflow_mcp/tools/package_tools.py

@@ -200,6 +200,7 @@ class PackageTools(ToolBase):
         compact = {
             "tagId": result.get("tagId"),
             "tagName": result.get("tagName"),
+            "tagIcon": result.get("tagIcon") if result.get("tagIcon") is not None else permission_source.get("tagIcon"),
             "publishStatus": result.get("publishStatus") if result.get("publishStatus") is not None else permission_source.get("publishStatus"),
             "beingTrial": result.get("beingTrial"),
             "itemCount": len(tag_items),