添加发布工作流，更新 README 和 pyproject.toml，删除不必要的示例，调整工具调用基准测试路径

Author: jiayuqi7813

.github/workflows/release.yml

@@ -0,0 +1,42 @@
+name: release
+
+on:
+  push:
+    tags:
+      - "v*"
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install build tooling
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build twine
+      - name: Build distributions
+        run: python -m build
+      - name: Validate distributions
+        run: python -m twine check dist/*
+      - uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+    environment:
+      name: pypi
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1

.gitignore

@@ -12,3 +12,5 @@ node_modules/
 .next/
 benchmark_reports/checkpoints/
 benchmark_reports/**/checkpoints/
+dist/
+build/

README.md

@@ -10,9 +10,9 @@ It serves two goals at the same time:
 - remain compatible with MCP-facing integrations through stdio, streamable
   HTTP, and WebSocket surfaces
 
-The public Python package remains:
+The public Python surface remains:
 
-- package name: `zcp`
+- distribution name: `zero-context-protocol-sdk`
 - import path: `import zcp`
 
 The companion protocol and documentation repository lives in

RELEASING.md

@@ -0,0 +1,33 @@
+# Releasing The Python SDK
+
+## Local Validation
+
+```bash
+python -m pip install -e ".[dev,openai,mcp]"
+python -m ruff check src tests examples tools
+PYTEST_DISABLE_PLUGIN_AUTOLOAD=1 python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+## GitHub Release Flow
+
+The repository includes a trusted-publisher release workflow at
+`.github/workflows/release.yml`.
+
+To use it for the `zero-context-protocol-sdk` distribution:
+
+1. configure this GitHub repository as a trusted publisher in PyPI
+2. push a tag like `v0.2.0a0`
+3. let the workflow build and publish the package
+
+## Manual Publishing
+
+If you prefer local publishing:
+
+```bash
+python -m build
+python -m twine upload dist/*
+```
+
+That path requires a configured PyPI token or `.pypirc`.

examples/README.md

@@ -1,7 +1,7 @@
 # Examples
 
-The public examples are grouped by intent so new users can find the right entry
-point quickly.
+This directory intentionally keeps only the public entrypoints that are useful
+to new users.
 
 ## Minimal
 
@@ -12,21 +12,10 @@ point quickly.
 
 - `run_zcp_api_server.py`: ASGI host exposing `/zcp`, `/mcp`, and `/ws`
 - `zcp_server_template.py`: reference service template for a real backend
-- `zcp_mcp_gateway_demo.py`: gateway demo for MCP compatibility layering
-
-## Migration / Comparison
-
-- `mcp_weather_server.py`: official MCP-style baseline
-- `real_sdk_mcp_server.py`: MCP baseline server used in benchmark harnesses
-- `compare_mcp_zcp_profiles.py`: static payload/profile comparison
 
 ## Benchmarks
 
 - `compare_zcp_mcp_tool_call_benchmark.py`: official compact tool-call token benchmark
 - `compare_excel_client_protocol_benchmark.py`: official Excel LLM token benchmark
-- `run_mcp_tool_call_benchmark.py`: MCP-only benchmark entrypoint
-- `run_zcp_tool_call_benchmark.py`: ZCP-only benchmark entrypoint
-
-## Provider-specific diagnostics
 
-- `deepseek_chat_tool_call_example.py`: DeepSeek/OpenAI-compatible adapter trace example
+Internal benchmark baselines and helpers now live under `tools/`.