fraclab-sdk 0.1.1__py3-none-any.whl → 0.1.2__py3-none-any.whl

fraclab_sdk/version.py

@@ -0,0 +1,5 @@
+"""Package version metadata."""
+
+__version__ = "0.1.2"
+
+__all__ = ["__version__"]

fraclab_sdk/workbench/pages/1_Snapshots.py

@@ -12,10 +12,11 @@ from fraclab_sdk.algorithm import AlgorithmLibrary
 from fraclab_sdk.config import SDKConfig
 from fraclab_sdk.errors import SnapshotError
 from fraclab_sdk.snapshot import SnapshotLibrary
+from fraclab_sdk.version import __version__ as SDK_VERSION
 from fraclab_sdk.workbench import ui_styles
 from fraclab_sdk.workbench.utils import get_workspace_dir
 
-st.set_page_config(page_title="Snapshots", page_icon="📦", layout="wide")
+st.set_page_config(page_title="Snapshots", page_icon="📦", layout="wide", initial_sidebar_state="expanded")
 st.title("Snapshots")
 
 ui_styles.apply_global_styles()
@@ -123,6 +124,10 @@ def create_algorithm_scaffold(
             "drsPath": "dist/drs.json",
             "outputContractPath": "dist/output_contract.json",
         },
+        "requires": {"sdk": SDK_VERSION},
+        "repository": None,
+        "homepage": None,
+        "license": None,
     }
 
     (ws_dir / "manifest.json").write_text(json.dumps(manifest, indent=2), encoding="utf-8")
@@ -134,6 +139,10 @@ def create_algorithm_scaffold(
         json.dumps({"type": "object", "title": "Parameters", "properties": {}}, indent=2),
         encoding="utf-8",
     )
+    (dist_dir / "output_contract.json").write_text(
+        json.dumps({"datasets": [], "invariants": [], "relations": []}, indent=2),
+        encoding="utf-8",
+    )
 
     main_stub = '''"""Algorithm entrypoint."""
 
@@ -459,13 +468,29 @@ with st.expander("📤 Import Existing Algorithm", expanded=True):
                     try:
                         with tempfile.TemporaryDirectory() as tmp_dir:
                             tmp_dir_path = Path(tmp_dir)
+
+                            # Copy uploaded main.py
                             algo_path = tmp_dir_path / "main.py"
                             algo_path.write_bytes(uploaded_algorithm.getvalue())
 
-                            (tmp_dir_path / "drs.json").write_text(json.dumps({"datasets": []}, indent=2))
-                            (tmp_dir_path / "params.schema.json").write_text(
-                                json.dumps({"type": "object", "properties": {}}, indent=2)
+                            # Create dist/ with template files
+                            dist_dir = tmp_dir_path / "dist"
+                            dist_dir.mkdir(parents=True, exist_ok=True)
+                            (dist_dir / "drs.json").write_text(json.dumps({"datasets": []}, indent=2))
+                            (dist_dir / "params.schema.json").write_text(
+                                json.dumps({"type": "object", "title": "Parameters", "properties": {}}, indent=2)
                             )
+                            (dist_dir / "output_contract.json").write_text(
+                                json.dumps({"datasets": [], "invariants": [], "relations": []}, indent=2)
+                            )
+
+                            # Create schema/ with base utilities
+                            schema_dir = tmp_dir_path / "schema"
+                            schema_dir.mkdir(parents=True, exist_ok=True)
+                            (schema_dir / "__init__.py").write_text("", encoding="utf-8")
+                            (schema_dir / "base.py").write_text(BASE_SCHEMA_UTILS, encoding="utf-8")
+
+                            # Create manifest
                             algo_id = uploaded_algorithm.name.removesuffix(".py")
                             manifest = {
                                 "manifestVersion": "1",
@@ -475,6 +500,12 @@ with st.expander("📤 Import Existing Algorithm", expanded=True):
                                 "name": algo_id,
                                 "summary": "Imported from single python file",
                                 "authors": [{"name": "unknown"}],
+                                "files": {
+                                    "paramsSchemaPath": "dist/params.schema.json",
+                                    "drsPath": "dist/drs.json",
+                                    "outputContractPath": "dist/output_contract.json",
+                                },
+                                "requires": {"sdk": SDK_VERSION},
                             }
                             (tmp_dir_path / "manifest.json").write_text(json.dumps(manifest, indent=2))
 

fraclab_sdk/workbench/pages/2_Browse.py

@@ -10,7 +10,7 @@ from fraclab_sdk.config import SDKConfig
 from fraclab_sdk.snapshot import SnapshotLibrary
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Browse", page_icon="🔍", layout="wide")
+st.set_page_config(page_title="Browse", page_icon="🔍", layout="wide", initial_sidebar_state="expanded")
 st.title("Browse")
 
 ui_styles.apply_global_styles()

fraclab_sdk/workbench/pages/3_Selection.py

@@ -13,7 +13,7 @@ from fraclab_sdk.selection.model import SelectionModel
 from fraclab_sdk.snapshot import SnapshotLibrary
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Selection", page_icon="✅", layout="wide")
+st.set_page_config(page_title="Selection", page_icon="✅", layout="wide", initial_sidebar_state="expanded")
 st.title("Selection")
 
 ui_styles.apply_global_styles()

fraclab_sdk/workbench/pages/4_Run.py

@@ -11,11 +11,17 @@ from fraclab_sdk.config import SDKConfig
 from fraclab_sdk.run import RunManager, RunStatus
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Run", page_icon="▶️", layout="wide")
+st.set_page_config(page_title="Run", page_icon="▶️", layout="wide", initial_sidebar_state="expanded")
 st.title("Run")
 
 ui_styles.apply_global_styles()
 
+# Guidance: if no params UI shows up, validate InputSpec via the editor page.
+st.info(
+    "看不到参数输入框？请在 Schema Editor 页面点击 Validate 检查 "
+    "`schema/inputspec.py`，确保生成的 schema 可用。",
+    icon="ℹ️",
+)
 # --- Page-Specific CSS ---
 st.markdown("""
 <style>

fraclab_sdk/workbench/pages/5_Results.py

@@ -17,11 +17,17 @@ from fraclab_sdk.results import (
 from fraclab_sdk.run import RunManager, RunStatus
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Results", page_icon="📊", layout="wide")
+st.set_page_config(page_title="Results", page_icon="📊", layout="wide", initial_sidebar_state="expanded")
 st.title("Results")
 
 ui_styles.apply_global_styles()
 
+# Guidance: if artifacts preview looks empty, validate OutputContract via the editor page.
+st.info(
+    "看不到期望的输出？请在 Output Editor 页面点击 Validate 检查 "
+    "`schema/output_contract.py` 的 datasets/items/artifacts 是否正确。",
+    icon="ℹ️",
+)
 
 def get_manager():
     """Get run manager."""

fraclab_sdk/workbench/pages/6_Algorithm_Edit.py

@@ -9,7 +9,7 @@ from fraclab_sdk.algorithm import AlgorithmLibrary
 from fraclab_sdk.config import SDKConfig
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Algorithm Editor", page_icon="✏️", layout="wide")
+st.set_page_config(page_title="Algorithm Editor", page_icon="✏️", layout="wide", initial_sidebar_state="expanded")
 st.title("Algorithm Editor")
 
 ui_styles.apply_global_styles()

fraclab_sdk/workbench/pages/7_Schema_Edit.py

@@ -13,7 +13,7 @@ from fraclab_sdk.devkit.validate import validate_inputspec
 from fraclab_sdk.workbench import ui_styles
 from fraclab_sdk.workbench.utils import run_workspace_script
 
-st.set_page_config(page_title="Schema Editor", page_icon="🧩", layout="wide")
+st.set_page_config(page_title="Schema Editor", page_icon="🧩", layout="wide", initial_sidebar_state="expanded")
 st.title("Schema Editor (InputSpec)")
 
 ui_styles.apply_global_styles()
@@ -137,13 +137,24 @@ with col_valid:
             # Auto-save before validate
             inputspec_path.write_text(edited, encoding="utf-8")
             write_params_schema(algo_dir)
-            
+
             result = validate_inputspec(algo_dir)
             if result.valid:
-                st.success("Validation Passed!", icon="✅")
+                if result.warnings:
+                    st.warning(f"Validation Passed with {len(result.warnings)} warning(s)", icon="⚠️")
+                else:
+                    st.success("Validation Passed!", icon="✅")
             else:
-                st.error("Validation Failed", icon="🚫")
-                for issue in result.issues:
-                    st.warning(f"[{issue.severity}] {issue.code}: {issue.message} ({getattr(issue, 'path', '')})")
+                st.error(f"Validation Failed ({len(result.errors)} error(s))", icon="🚫")
+
+            # Show all issues (errors and warnings)
+            for issue in result.issues:
+                icon = "🔴" if issue.severity.value == "error" else "🟡"
+                path_str = f" at `{issue.path}`" if issue.path else ""
+                details_str = ""
+                if issue.details:
+                    if "suggested" in issue.details:
+                        details_str = f" → Suggested: `{issue.details['suggested']}`"
+                st.markdown(f"{icon} **{issue.code}**{path_str}: {issue.message}{details_str}")
         except Exception as e:
             st.error(f"Validation error: {e}")

fraclab_sdk/workbench/pages/8_Output_Edit.py

@@ -14,7 +14,7 @@ from fraclab_sdk.devkit.validate import validate_output_contract
 from fraclab_sdk.workbench import ui_styles
 from fraclab_sdk.workbench.utils import run_workspace_script
 
-st.set_page_config(page_title="OutputSpec Editor", page_icon="📤", layout="wide")
+st.set_page_config(page_title="OutputSpec Editor", page_icon="📤", layout="wide", initial_sidebar_state="expanded")
 st.title("OutputSpec Editor")
 
 ui_styles.apply_global_styles()
@@ -132,13 +132,24 @@ with col_valid:
             # Auto-save before validate
             output_spec_path.write_text(edited, encoding="utf-8")
             write_dist_from_contract(workspace_dir, selected.algorithm_id, selected.version)
-            
-            result = validate_output_contract(workspace_dir / "dist" / "output_contract.json")
+
+            result = validate_output_contract(workspace_dir)
             if result.valid:
-                st.success("Validation Passed!", icon="✅")
+                if result.warnings:
+                    st.warning(f"Validation Passed with {len(result.warnings)} warning(s)", icon="⚠️")
+                else:
+                    st.success("Validation Passed!", icon="✅")
             else:
-                st.error("Validation Failed", icon="🚫")
-                for issue in result.issues:
-                    st.warning(f"[{issue.severity}] {issue.code}: {issue.message}")
+                st.error(f"Validation Failed ({len(result.errors)} error(s))", icon="🚫")
+
+            # Show all issues (errors and warnings)
+            for issue in result.issues:
+                icon = "🔴" if issue.severity.value == "error" else "🟡"
+                path_str = f" at `{issue.path}`" if issue.path else ""
+                details_str = ""
+                if issue.details:
+                    if "suggested" in issue.details:
+                        details_str = f" → Suggested: `{issue.details['suggested']}`"
+                st.markdown(f"{icon} **{issue.code}**{path_str}: {issue.message}{details_str}")
         except Exception as e:
             st.error(f"Validation error: {e}")

fraclab_sdk/workbench/pages/9_Export_Algorithm.py

@@ -12,10 +12,15 @@ import streamlit as st
 
 from fraclab_sdk.algorithm import AlgorithmLibrary
 from fraclab_sdk.config import SDKConfig
+from fraclab_sdk.devkit import (
+    validate_algorithm_signature,
+    validate_inputspec,
+    validate_output_contract,
+)
 from fraclab_sdk.snapshot import SnapshotLibrary
 from fraclab_sdk.workbench import ui_styles
 
-st.set_page_config(page_title="Export Algorithm", page_icon="📦", layout="wide")
+st.set_page_config(page_title="Export Algorithm", page_icon="📦", layout="wide", initial_sidebar_state="expanded")
 st.title("Export Algorithm")
 
 ui_styles.apply_global_styles()
@@ -32,6 +37,7 @@ st.markdown("""
     }
     .status-ok { background-color: #d1fae5; color: #065f46; }
     .status-missing { background-color: #fee2e2; color: #991b1b; }
+    .status-warning { background-color: #fef3c7; color: #92400e; }
 </style>
 """, unsafe_allow_html=True)
 
@@ -79,67 +85,197 @@ output_contract_path = algo_dir / "dist" / "output_contract.json"
 drs_path = algo_dir / "dist" / "drs.json"
 
 # ==========================================
-# 2. Package Integrity Check & DRS Source
+# 2. Validation Status
 # ==========================================
-st.subheader("2. Package Integrity Check")
-
-def _get_status_html(path: Path, label: str):
-    exists = path.exists()
-    status_cls = "status-ok" if exists else "status-missing"
-    icon = "✅" if exists else "❌"
-    text = "Present" if exists else "Missing"
-    return f"""
-    <div style="display: flex; justify-content: space-between; align-items: center; padding: 8px 0; border-bottom: 1px solid #f0f2f6;">
-        <span style="font-weight: 500;">{label}</span>
-        <span class="status-badge {status_cls}">{icon} {text}</span>
-    </div>
-    """
-
+st.subheader("2. Validation Status")
+
+
+def _get_algo_mtime(algo_dir: Path) -> float:
+    """Get max mtime of source files for cache invalidation."""
+    files = [
+        algo_dir / "main.py",
+        algo_dir / "manifest.json",
+    ]
+    # schema/*.py files
+    schema_dir = algo_dir / "schema"
+    if schema_dir.exists():
+        files.extend(schema_dir.glob("*.py"))
+
+    # dist/*.json (if exists)
+    dist_dir = algo_dir / "dist"
+    if dist_dir.exists():
+        files.extend(dist_dir.glob("*.json"))
+
+    mtimes = [f.stat().st_mtime for f in files if f.exists()]
+    return max(mtimes) if mtimes else 0.0
+
+
+@st.cache_data(ttl=60)
+def _run_all_validations(algo_dir_str: str, _mtime: float) -> dict[str, dict]:
+    """Run all validations. Cached by (path, mtime)."""
+    workspace = Path(algo_dir_str)
+    results: dict[str, dict] = {}
+
+    # InputSpec validation
+    try:
+        inputspec_result = validate_inputspec(workspace)
+        results["inputspec"] = {
+            "valid": inputspec_result.valid,
+            "errors": len(inputspec_result.errors),
+            "warnings": len(inputspec_result.warnings),
+            "issues": [
+                {
+                    "severity": i.severity.value,
+                    "code": i.code,
+                    "message": i.message,
+                    "path": i.path,
+                    "details": i.details,
+                }
+                for i in inputspec_result.issues
+            ],
+        }
+    except Exception as e:
+        results["inputspec"] = {
+            "valid": False,
+            "errors": 1,
+            "warnings": 0,
+            "issues": [{"severity": "error", "code": "VALIDATION_FAILED", "message": str(e), "path": None, "details": {}}],
+        }
+
+    # OutputContract validation
+    try:
+        output_result = validate_output_contract(workspace)
+        results["output_contract"] = {
+            "valid": output_result.valid,
+            "errors": len(output_result.errors),
+            "warnings": len(output_result.warnings),
+            "issues": [
+                {
+                    "severity": i.severity.value,
+                    "code": i.code,
+                    "message": i.message,
+                    "path": i.path,
+                    "details": i.details,
+                }
+                for i in output_result.issues
+            ],
+        }
+    except Exception as e:
+        results["output_contract"] = {
+            "valid": False,
+            "errors": 1,
+            "warnings": 0,
+            "issues": [{"severity": "error", "code": "VALIDATION_FAILED", "message": str(e), "path": None, "details": {}}],
+        }
+
+    # Algorithm signature validation
+    try:
+        algo_result = validate_algorithm_signature(workspace)
+        results["algorithm"] = {
+            "valid": algo_result.valid,
+            "errors": len(algo_result.errors),
+            "warnings": len(algo_result.warnings),
+            "issues": [
+                {
+                    "severity": i.severity.value,
+                    "code": i.code,
+                    "message": i.message,
+                    "path": i.path,
+                    "details": i.details,
+                }
+                for i in algo_result.issues
+            ],
+        }
+    except Exception as e:
+        results["algorithm"] = {
+            "valid": False,
+            "errors": 1,
+            "warnings": 0,
+            "issues": [{"severity": "error", "code": "VALIDATION_FAILED", "message": str(e), "path": None, "details": {}}],
+        }
+
+    return results
+
+
+# Run validations with caching
+mtime = _get_algo_mtime(algo_dir)
+validation_results = _run_all_validations(str(algo_dir), mtime)
+
+# Display validation status badges with revalidate button
 with st.container(border=True):
-    col_health, col_preview = st.columns([1, 2])
-
-    with col_health:
-        st.markdown("#### File Status")
-        st.markdown(_get_status_html(manifest_path, "Manifest"), unsafe_allow_html=True)
-        st.markdown(_get_status_html(params_schema_path, "Input Schema"), unsafe_allow_html=True)
-        st.markdown(_get_status_html(output_contract_path, "Output Contract"), unsafe_allow_html=True)
-
-        # DRS: Show prompt instead of file check
-        st.markdown("""
-        <div style="display: flex; justify-content: space-between; align-items: center; padding: 8px 0; border-bottom: 1px solid #f0f2f6;">
-            <span style="font-weight: 500;">DRS</span>
-            <span style="color: #6b7280; font-size: 0.85rem;">👇 Select below</span>
-        </div>
-        """, unsafe_allow_html=True)
-
-        # Manifest Metadata Preview
-        if manifest_path.exists():
-            st.markdown("---")
-            try:
-                m_data = json.loads(manifest_path.read_text())
-                st.caption("Manifest Metadata")
-                st.text(f"Code Ver: {m_data.get('codeVersion')}")
-                st.text(f"Contract: {m_data.get('contractVersion')}")
-            except:
-                st.error("Invalid Manifest")
-
-    with col_preview:
-        st.markdown("#### File Inspector")
-        tab_man, tab_in, tab_out = st.tabs(["Manifest", "Input Spec", "Output Spec"])
-
-        def _show_json_preview(path: Path):
-            if path.exists():
-                try:
-                    data = json.loads(path.read_text())
-                    st.code(json.dumps(data, indent=2, ensure_ascii=False), language="json", line_numbers=True)
-                except Exception:
-                    st.error("Failed to parse JSON")
+    cols = st.columns([1, 1, 1, 0.5])
+    names = ["InputSpec", "OutputContract", "Algorithm"]
+    keys = ["inputspec", "output_contract", "algorithm"]
+
+    for i, (key, name) in enumerate(zip(keys, names)):
+        result = validation_results.get(key, {})
+        error_count = result.get("errors", 0)
+        warning_count = result.get("warnings", 0)
+
+        with cols[i]:
+            if error_count > 0:
+                st.markdown(
+                    f'<span class="status-badge status-missing">❌ {name}: {error_count} error{"s" if error_count > 1 else ""}</span>',
+                    unsafe_allow_html=True,
+                )
+            elif warning_count > 0:
+                st.markdown(
+                    f'<span class="status-badge status-warning">⚠️ {name}: {warning_count} warning{"s" if warning_count > 1 else ""}</span>',
+                    unsafe_allow_html=True,
+                )
             else:
-                st.info("File not generated yet.")
+                st.markdown(
+                    f'<span class="status-badge status-ok">✅ {name}</span>',
+                    unsafe_allow_html=True,
+                )
+
+    with cols[3]:
+        if st.button("🔄 Revalidate", key="rerun_validation"):
+            _run_all_validations.clear()
+            st.rerun()
+
+# Collect all issues
+all_issues = []
+for key in keys:
+    result = validation_results.get(key, {})
+    for issue in result.get("issues", []):
+        all_issues.append((key, issue))
+
+# Show validation details if there are issues
+if all_issues:
+    with st.expander(f"📋 Validation Details ({len(all_issues)} issue{'s' if len(all_issues) > 1 else ''})", expanded=False):
+        for source, issue in all_issues:
+            icon = {"error": "🔴", "warning": "🟡", "info": "🔵"}.get(issue["severity"], "⚪")
+            path_str = f" at `{issue['path']}`" if issue.get("path") else ""
+            details_str = ""
+            if issue.get("details"):
+                # Show suggested fix for snake_case issues
+                if "suggested" in issue["details"]:
+                    details_str = f" → Suggested: `{issue['details']['suggested']}`"
+                elif "missing" in issue["details"]:
+                    details_str = f" (missing: {issue['details']['missing']})"
+                elif "extra" in issue["details"]:
+                    details_str = f" (extra: {issue['details']['extra']})"
+            st.markdown(f"{icon} **[{source}]** `{issue['code']}`{path_str}: {issue['message']}{details_str}")
+
+# File Inspector
+with st.expander("📂 File Inspector", expanded=True):
+    tab_man, tab_in, tab_out = st.tabs(["Manifest", "Input Spec", "Output Spec"])
+
+    def _show_json_preview(path: Path):
+        if path.exists():
+            try:
+                data = json.loads(path.read_text())
+                st.code(json.dumps(data, indent=2, ensure_ascii=False), language="json", line_numbers=True)
+            except Exception:
+                st.error("Failed to parse JSON")
+        else:
+            st.info("File not generated yet.")
+
+    with tab_man: _show_json_preview(manifest_path)
+    with tab_in: _show_json_preview(params_schema_path)
+    with tab_out: _show_json_preview(output_contract_path)
 
-        with tab_man: _show_json_preview(manifest_path)
-        with tab_in: _show_json_preview(params_schema_path)
-        with tab_out: _show_json_preview(output_contract_path)
 
 # ==========================================
 # 3. DRS Source Selection
@@ -180,59 +316,71 @@ def build_zip() -> bytes:
         # copy installed algorithm content
         shutil.copytree(algo_dir, tmpdir_path / algo_dir.name, dirs_exist_ok=True)
         target_root = tmpdir_path / algo_dir.name
-        
+
         # ensure manifest files paths cover dist outputs if present
         manifest_data = json.loads(manifest_path.read_text())
         files = manifest_data.get("files") or {}
-        
+
         if output_contract_path.exists():
             files["outputContractPath"] = "dist/output_contract.json"
         if params_schema_path.exists():
             files["paramsSchemaPath"] = "dist/params.schema.json"
         if drs_path.exists():
             files["drsPath"] = "dist/drs.json"
-        
+
         if files:
             manifest_data["files"] = files
-        
+
         (target_root / "manifest.json").write_text(json.dumps(manifest_data, indent=2), encoding="utf-8")
-        
+
         # DRS Override Logic
         # Try to find DRS path from manifest, default to dist/drs.json
         drs_rel_path = manifest_data.get("files", {}).get("drsPath", "dist/drs.json")
         target_drs_path = target_root / drs_rel_path
         target_drs_path.parent.mkdir(parents=True, exist_ok=True)
-        
+
         # Read DRS from Snapshot
         snap_drs_path = snapshot_handle.directory / snapshot_handle.manifest.specFiles.drsPath
-        
+
         if snap_drs_path.exists():
             target_drs_path.write_bytes(snap_drs_path.read_bytes())
         else:
             # Fallback if snapshot DRS is missing structure (rare)
-            pass 
+            pass
 
-        # Zip it up
+        # Zip it up (flattened: no top-level version folder)
         zip_buf = io.BytesIO()
-        shutil.make_archive(base_name=tmpdir_path / "algorithm_export", format="zip", root_dir=tmpdir_path, base_dir=algo_dir.name)
+        shutil.make_archive(
+            base_name=tmpdir_path / "algorithm_export",
+            format="zip",
+            root_dir=target_root,
+            base_dir=".",
+        )
         zip_path = tmpdir_path / "algorithm_export.zip"
         zip_buf.write(zip_path.read_bytes())
         zip_buf.seek(0)
         return zip_buf.read()
 
-_, col_btn = st.columns([3, 1])
-with col_btn:
-    if st.button("📦 Build & Export", type="primary", width="stretch"):
-        try:
-            with st.spinner("Packaging..."):
-                zip_bytes = build_zip()
-
-            st.download_button(
-                label="⬇️ Download Zip",
-                data=zip_bytes,
-                file_name=f"{selected_algo.algorithm_id}-{selected_algo.version}.zip",
-                mime="application/zip",
-                width="stretch"
-            )
-        except Exception as e:
-            st.error(f"Export failed: {e}")
+
+# Check if there are validation errors
+has_validation_errors = any(not r.get("valid", True) for r in validation_results.values())
+
+_, col_export_btn = st.columns([3, 1])
+with col_export_btn:
+    if has_validation_errors:
+        st.error("Fix validation errors to export")
+        st.button("📦 Build & Export", type="primary", disabled=True, key="export_disabled")
+    else:
+        if st.button("📦 Build & Export", type="primary", key="export_enabled"):
+            try:
+                with st.spinner("Packaging..."):
+                    zip_bytes = build_zip()
+
+                st.download_button(
+                    label="⬇️ Download Zip",
+                    data=zip_bytes,
+                    file_name=f"{selected_algo.algorithm_id}-{selected_algo.version}.zip",
+                    mime="application/zip",
+                )
+            except Exception as e:
+                st.error(f"Export failed: {e}")

fraclab_sdk/workbench/ui_styles.py

@@ -16,8 +16,20 @@ def apply_global_styles():
             display: none !important;
         }
 
-        /* Hide hamburger menu and Deploy button */
-        [data-testid="stToolbar"], .stDeployButton {
+        /* Hide Deploy button; keep toolbar for sidebar toggle */
+        .stDeployButton {
+            display: none !important;
+        }
+
+        /* Force sidebar visible and disable collapse control */
+        [data-testid="stSidebar"] {
+            transform: none !important;
+            min-width: 260px;
+        }
+        [data-testid="stSidebarNav"] {
+            min-width: 240px;
+        }
+        [data-testid="collapsedControl"] {
             display: none !important;
         }
 

{fraclab_sdk-0.1.1.dist-info → fraclab_sdk-0.1.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fraclab-sdk
-Version: 0.1.1
+Version: 0.1.2
 Summary: SDK for managing snapshots, algorithms, and run execution
 Requires-Python: >=3.11,<4.0
 Classifier: Programming Language :: Python :: 3
@@ -913,6 +913,8 @@ $ fraclab-sdk run tail f9e8d7c6
 $ fraclab-sdk run tail f9e8d7c6 --stderr
 ```
 
+> Workbench 提示：结果页面会展示本次运行的输出目录路径（含 `_logs` 日志），即使运行失败也能点开路径定位调试。
+
 #### 6. 运行目录结构
 
 执行完成后，`~/.fraclab/runs/<run_id>/` 目录结构: