web-presentation-cli 0.3.0__tar.gz → 0.3.1__tar.gz

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: web-presentation-cli
-Version: 0.3.0
+Version: 0.3.1
 Summary: Web Presentation CLI - 面向 AI 演示文稿创作平台的命令行与 Agent 工具包
 Project-URL: Homepage, https://github.com/LLMxPM/web-presentation-agent-kit
 Project-URL: Repository, https://github.com/LLMxPM/web-presentation-agent-kit
@@ -116,7 +116,7 @@ wp --raw project list
 
 Skill 与 CLI 一起发布，但使用独立版本。`wp skill status` 会识别缺失、过期、较新、不兼容、用户修改和未受管理等状态；普通升级不会覆盖用户修改，`--force` 会先保留同级备份。CLI 升级不会隐式改写已安装 Skill，需要重新运行 `wp skill install` 完成同步。
 
-当前版本关系：CLI `0.3.0` 内置 `web-presentation` Skill `1.3.1`，Skill 声明的 CLI 兼容范围为 `>=0.3.0,<0.4.0`。构建时会把这组关系与规范化内容 SHA-256 写入 manifest。
+当前版本关系：CLI `0.3.1` 内置 `web-presentation` Skill `1.3.2`，Skill 声明的 CLI 兼容范围为 `>=0.3.0,<0.4.0`。构建时会把这组关系与规范化内容 SHA-256 写入 manifest。
 
 Windsurf 不属于本地目录安装目标。`wp skill export` 生成的标准 ZIP 可用于支持本地上传的产品；CLI 不从 URL 或第三方仓库下载 Skill。
 
@@ -158,6 +158,10 @@ wp job wait <job_id>
 写入命令支持 `--idempotency-key <key>`；网络超时后需要重放同一业务请求时复用原 key，不要把同一个 key 用于不同请求。
 
 
+### 0.3.1 行为变更
+
+`wp component list` 表格新增「引用路径」列，未发布组件显示 `未发布`；`--json` 的组件列表与建议组件投影新增 `import_path` 与 `import_statement` 字段，取自 Backend 返回，供页面源码直接拼接 `@workspace-components/<code>/v/<version_no>` 别名。内置 Skill `1.3.2` 同步补充工作空间组件的版本化引用契约，禁止引用草稿、自增 ID 或本地相对路径。
+
 ### 0.3.0 行为变更
 
 `--json` 现在输出面向 Agent 的稳定字段投影；`--raw` 输出完整 Backend 原始 JSON，二者不能同时使用。Project、Page、Component、Asset、Theme、Style、Validation 和 Preview 命令按场景区分列表、详情、源码和诊断字段；成功响应不再注入 `_client` 元数据。预览地址通过 `wp preview get` 获取，属于短期 Preview Artifact。

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/README.md

@@ -101,7 +101,7 @@ wp --raw project list
 
 Skill 与 CLI 一起发布，但使用独立版本。`wp skill status` 会识别缺失、过期、较新、不兼容、用户修改和未受管理等状态；普通升级不会覆盖用户修改，`--force` 会先保留同级备份。CLI 升级不会隐式改写已安装 Skill，需要重新运行 `wp skill install` 完成同步。
 
-当前版本关系：CLI `0.3.0` 内置 `web-presentation` Skill `1.3.1`，Skill 声明的 CLI 兼容范围为 `>=0.3.0,<0.4.0`。构建时会把这组关系与规范化内容 SHA-256 写入 manifest。
+当前版本关系：CLI `0.3.1` 内置 `web-presentation` Skill `1.3.2`，Skill 声明的 CLI 兼容范围为 `>=0.3.0,<0.4.0`。构建时会把这组关系与规范化内容 SHA-256 写入 manifest。
 
 Windsurf 不属于本地目录安装目标。`wp skill export` 生成的标准 ZIP 可用于支持本地上传的产品；CLI 不从 URL 或第三方仓库下载 Skill。
 
@@ -143,6 +143,10 @@ wp job wait <job_id>
 写入命令支持 `--idempotency-key <key>`；网络超时后需要重放同一业务请求时复用原 key，不要把同一个 key 用于不同请求。
 
 
+### 0.3.1 行为变更
+
+`wp component list` 表格新增「引用路径」列，未发布组件显示 `未发布`；`--json` 的组件列表与建议组件投影新增 `import_path` 与 `import_statement` 字段，取自 Backend 返回，供页面源码直接拼接 `@workspace-components/<code>/v/<version_no>` 别名。内置 Skill `1.3.2` 同步补充工作空间组件的版本化引用契约，禁止引用草稿、自增 ID 或本地相对路径。
+
 ### 0.3.0 行为变更
 
 `--json` 现在输出面向 Agent 的稳定字段投影；`--raw` 输出完整 Backend 原始 JSON，二者不能同时使用。Project、Page、Component、Asset、Theme、Style、Validation 和 Preview 命令按场景区分列表、详情、源码和诊断字段；成功响应不再注入 `_client` 元数据。预览地址通过 `wp preview get` 获取，属于短期 Preview Artifact。

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/_skill_sources/catalog.toml

@@ -2,6 +2,6 @@ schema_version = 1
 
 [[skills]]
 name = "web-presentation"
-version = "1.3.1"
+version = "1.3.2"
 path = "web-presentation"
 requires_cli = ">=0.3.0,<0.4.0"

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/_skill_sources/web-presentation/references/component-standards.md

@@ -28,6 +28,7 @@
 - `props` 字段与 `defineProps` 一致，字段的 `type`、`label`、`default` 和 `options` 必须真实可用；预览值不要放在 Schema 根节点。
 - 支持的 prop 类型以当前平台规范为准，常见为 `string`、`textarea`、`number`、`boolean`、`select`、`json`。
 - `slots` 使用声明式 `text`、`html`、`component` 节点；slot component 只能引用版本化 Runtime Kit 或已发布工作空间组件，不能引用 Runtime 私有路径或动态 import。
+- 引用工作空间组件（作为 slot component 或在组件源码中引用子组件）时，必须使用 `@workspace-components/<component_code>/v/<version_no>`，且被引用组件必须为已发布的正式版本（`current_version_no > 0`），禁止引用草稿或使用自增主键 ID。
 - `mocks` 只保存 JSON/文本级静态值，不放函数、表达式、HTTP 请求或 component-preview 内部能力。
 - `presets` 只写覆盖值；key 稳定、label 清晰，优先提供 2～3 个高质量真实场景。
 - 资源名、默认值和 mock 数据必须来自真实工具结果；没有资源时使用空值或明确占位，不编造名称。

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/_skill_sources/web-presentation/references/source-standards.md

@@ -10,6 +10,18 @@
 - 只能引用平台真实返回的版本化 Runtime Kit 能力、已发布工作空间组件、可见工作空间资源和自身代码。
 - Tailwind class 必须以完整静态字符串出现在模板、脚本常量或顶层枚举映射中；禁止 `text-${tone}`、`from-${color}` 等运行时拼接。Arbitrary value 也要以完整静态类出现在源码中。
 
+## 工作空间组件引用契约
+
+- 页面源码引用工作空间组件时，统一使用已发布组件的版本化别名：
+  ```ts
+  import <ImportName> from '@workspace-components/<component_code>/v/<version_no>'
+  ```
+- 约束说明：
+  - 路径中的编码必须是组件业务编码 `code`（如 `CMP20260503001`），不能使用自增 ID、本地相对路径或 `@/` 别名；
+  - 版本号必须是当前大于 0 的正式发布版本 `current_version_no`，未发布或草稿状态的组件不可在页面中引用；
+  - 导入标识符优先使用组件元数据中的 `import_name`（或展示名 PascalCase）；
+  - 可直接通过 `wp component get <component_id>` 或 `wp component list` 查询已发布的 `import_path` 与 `import_statement`。
+
 ## 画布和布局
 
 - 页面根部优先使用项目建议的已发布页面组件，其次是工作空间已发布页面组件，最后才是版本化 `DefaultContainer`。

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "web-presentation-cli"
-version = "0.3.0"
+version = "0.3.1"
 description = "Web Presentation CLI - 面向 AI 演示文稿创作平台的命令行与 Agent 工具包"
 readme = "README.md"
 license = { text = "Apache-2.0" }

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/src/wp/__init__.py

@@ -1,3 +1,3 @@
 """Web Presentation 官方命令行工具包。"""
 
-__version__ = "0.3.0"
+__version__ = "0.3.1"

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/src/wp/commands/component.py

@@ -47,11 +47,29 @@ def list_components_cmd(ctx: click.Context, page: int, page_size: int, keyword:
         if ctx.obj.get("as_json"):
             output_result(ctx, result, profile="component_list")
             return
+        def _resolve_import_path(item: dict) -> str:
+            if item.get("import_path"):
+                return str(item["import_path"])
+            code = item.get("code")
+            version_no = item.get("current_version_no")
+            if code and isinstance(version_no, int) and version_no > 0:
+                return f"@workspace-components/{code}/v/{version_no}"
+            if isinstance(version_no, int) and version_no <= 0:
+                return "未发布"
+            return "-"
+
         rows = [
-            [item.get("id"), item.get("import_name", "-"), item.get("name", "-"), item.get("component_type", "-"), item.get("status", "-")]
+            [
+                item.get("id"),
+                item.get("import_name", "-"),
+                item.get("name", "-"),
+                item.get("component_type", "-"),
+                item.get("status", "-"),
+                _resolve_import_path(item),
+            ]
             for item in result.get("items", [])
         ]
-        print_table("组件列表", ["ID", "导入标识", "名称", "类型", "状态"], rows)
+        print_table("组件列表", ["ID", "导入标识", "名称", "类型", "状态", "引用路径"], rows)
     except ApiClientError as err:
         handle_api_error("获取组件列表失败", err)
 

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/src/wp/output_fields.py

@@ -80,6 +80,8 @@ COMPONENT_LIST_FIELDS = (
     "status",
     "created_at",
     "updated_at",
+    "import_path",
+    "import_statement",
 )
 SUGGESTED_COMPONENT_FIELDS = (
     "id",
@@ -91,6 +93,8 @@ SUGGESTED_COMPONENT_FIELDS = (
     "current_version_no",
     "available",
     "unavailable_reason",
+    "import_path",
+    "import_statement",
 )
 COMPONENT_DETAIL_FIELDS = COMPONENT_LIST_FIELDS + ("content", "preview_schema", "draft_hash")
 

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/tests/test_cli_commands.py

@@ -44,7 +44,7 @@ def test_cli_version() -> None:
     result = CliRunner().invoke(main, ["--version"])
 
     assert result.exit_code == 0, result.output
-    assert result.output.strip() == "wp, version 0.3.0"
+    assert result.output.strip() == "wp, version 0.3.1"
 
 
 def test_raw_option_is_exposed_and_mutually_exclusive_with_json() -> None:
@@ -344,3 +344,55 @@ def test_command_idempotency_key_is_passed_to_client(monkeypatch, tmp_path) -> N
     assert result.exit_code == 0, result.output
     assert client_class.call_args.kwargs["idempotency_key"] == "replay-key"
     fake_client.post.assert_called_once_with("/projects", json_data={"name": "演示项目", "description": None})
+
+
+def test_component_list_displays_import_path_column(monkeypatch, tmp_path) -> None:
+    """组件列表表格必须包含'引用路径'列并正确展示已发布与未发布组件的路径提示。"""
+
+    monkeypatch.setattr(config_module, "CONFIG_DIR", tmp_path)
+    monkeypatch.setattr(config_module, "CONFIG_FILE", tmp_path / "config.json")
+    save_config(CliConfig(current_profile="default", profiles={"default": ProfileConfig(api_url="http://localhost:8000", pat="test-pat", default_workspace_id=1)}))
+
+    fake_client = MagicMock()
+    fake_client.get.return_value = {
+        "items": [
+            {
+                "id": 1,
+                "code": "CMP001",
+                "import_name": "MetricCard",
+                "name": "指标卡",
+                "component_type": "content",
+                "status": "active",
+                "current_version_no": 2,
+                "import_path": "@workspace-components/CMP001/v/2",
+                "import_statement": "import MetricCard from '@workspace-components/CMP001/v/2'",
+            },
+            {
+                "id": 2,
+                "code": "CMP002",
+                "import_name": "DraftCard",
+                "name": "草稿卡",
+                "component_type": "content",
+                "status": "active",
+                "current_version_no": 0,
+            },
+        ],
+        "total": 2,
+        "page": 1,
+        "page_size": 50,
+    }
+
+    with patch("wp.commands.common.ApiClient", return_value=fake_client):
+        table_result = CliRunner(env={"COLUMNS": "120"}).invoke(main, ["component", "list"])
+        json_result = CliRunner().invoke(main, ["--json", "component", "list"])
+
+    assert table_result.exit_code == 0, table_result.output
+    assert "引用路径" in table_result.output
+    assert "@workspace-components/CMP001/v/2" in table_result.output
+    assert "未发布" in table_result.output
+
+    assert json_result.exit_code == 0, json_result.output
+    data = json.loads(json_result.output)
+    assert data["items"][0]["import_path"] == "@workspace-components/CMP001/v/2"
+    assert data["items"][0]["import_statement"] == "import MetricCard from '@workspace-components/CMP001/v/2'"
+    assert data["items"][1].get("import_path") is None

{web_presentation_cli-0.3.0 → web_presentation_cli-0.3.1}/tests/test_output_profiles.py

@@ -124,3 +124,49 @@ def test_json_and_raw_are_mutually_exclusive() -> None:
 
     assert result.exit_code != 0
     assert "不能同时使用" in result.output
+
+
+def test_component_projection_includes_import_usage() -> None:
+    """组件列表和详情投影中必须保留 import_path 和 import_statement。"""
+
+    component_list = project_response(
+        {
+            "items": [
+                {
+                    "id": 4,
+                    "code": "CMP001",
+                    "name": "卡片",
+                    "import_name": "MyCard",
+                    "current_version_no": 1,
+                    "import_path": "@workspace-components/CMP001/v/1",
+                    "import_statement": "import MyCard from '@workspace-components/CMP001/v/1'",
+                    "content": "<template />",
+                }
+            ],
+            "page": 1,
+            "page_size": 20,
+            "total": 1,
+        },
+        "component_list",
+    )
+    assert component_list["items"][0]["import_path"] == "@workspace-components/CMP001/v/1"
+    assert component_list["items"][0]["import_statement"] == "import MyCard from '@workspace-components/CMP001/v/1'"
+    assert "content" not in component_list["items"][0]
+
+    component_detail = project_response(
+        {
+            "id": 4,
+            "code": "CMP001",
+            "name": "卡片",
+            "import_name": "MyCard",
+            "current_version_no": 1,
+            "import_path": "@workspace-components/CMP001/v/1",
+            "import_statement": "import MyCard from '@workspace-components/CMP001/v/1'",
+            "content": "<template />",
+            "preview_schema": "{}",
+            "draft_hash": "hash123",
+        },
+        "component_detail",
+    )
+    assert component_detail["import_path"] == "@workspace-components/CMP001/v/1"
+    assert component_detail["import_statement"] == "import MyCard from '@workspace-components/CMP001/v/1'"