dsh-plugin-ccp 1.0.0__py3-none-any.whl

dsh_plugin_ccp/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

dsh_plugin_ccp/tools.py

@@ -0,0 +1,222 @@
+"""
+DSH Plugin CCP — CCP 协议能力发现层
+
+让 DSH Agent 通过 CCP 协议搜索、评估、调用能力锚点。
+
+提供三个 DSH 工具：
+- ccp_search: 搜索能力锚点
+- ccp_detail: 获取能力详情 + 生成适配器
+- ccp_telemetry: 回传调用结果（信任向量闭环）
+
+版本：v1.0.0
+协议：CCP v1.0.0
+"""
+
+import os
+import json
+import urllib.parse
+import urllib.request
+import urllib.error
+from typing import Optional
+
+
+def _normalize_endpoint(endpoint: str) -> str:
+    """将端点 URL 规范化：非 ASCII 主机名转为 IDNA（punycode）编码。
+
+    Python urllib 不支持含非 ASCII 字符的 hostname（会抛 latin-1 编码错误），
+    需在发起请求前把中文域名转换为 punycode 形式（如 礼字号.中国 -> xn--...）。
+    """
+    parts = urllib.parse.urlsplit(endpoint)
+    hostname = parts.hostname
+    if hostname and any(ord(c) > 127 for c in hostname):
+        ascii_host = hostname.encode("idna").decode("ascii")
+        if ":" in hostname or (parts.port is not None):
+            ascii_host = f"{ascii_host}:{parts.port}"
+        netloc = ascii_host
+        if parts.username:
+            userinfo = parts.username
+            if parts.password:
+                userinfo += f":{parts.password}"
+            netloc = f"{userinfo}@{ascii_host}"
+        return urllib.parse.urlunsplit(
+            (parts.scheme, netloc, parts.path, parts.query, parts.fragment)
+        )
+    return endpoint
+
+CCP_ENDPOINT = os.environ.get(
+    "CCP_ENDPOINT", "https://skillmesh.礼字号.中国/api/ccp/v1"
+)
+CCP_FEDERATED = os.environ.get("CCP_FEDERATED", "false").lower() == "true"
+
+
+class CCPClient:
+    """CCP API HTTP 客户端"""
+
+    def __init__(self, endpoint: str = CCP_ENDPOINT):
+        self.endpoint = _normalize_endpoint(endpoint).rstrip("/")
+
+    def _request(self, path: str, method: str = "GET", body: Optional[dict] = None) -> dict:
+        url = f"{self.endpoint}{path}"
+        data = json.dumps(body).encode("utf-8") if body else None
+        req = urllib.request.Request(
+            url,
+            data=data,
+            headers={
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+                "User-Agent": "dsh-plugin-ccp/1.0.0",
+            },
+            method=method,
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=10) as resp:
+                return json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            return {"error": {"code": "HTTP_ERROR", "detail": str(e), "status": e.code}}
+        except Exception as e:
+            return {"error": {"code": "NETWORK_ERROR", "detail": str(e)}}
+
+    def search(self, q: str, category: Optional[str] = None) -> dict:
+        """搜索能力锚点"""
+        params = f"?q={urllib.parse.quote(q)}"
+        if category:
+            params += f"&category={urllib.parse.quote(category)}"
+        if CCP_FEDERATED:
+            params += "&federated=true"
+        return self._request(f"/search{params}")
+
+    def detail(self, capability_id: str) -> dict:
+        """获取能力锚点详情"""
+        return self._request(f"/capabilities/{urllib.parse.quote(capability_id)}")
+
+    def adapter(self, capability_id: str, framework: str = "dsh") -> dict:
+        """获取适配器代码（服务端返回 YAML 文本）"""
+        url = (
+            f"{self.endpoint}/capabilities/{urllib.parse.quote(capability_id)}"
+            f"/adapters/{urllib.parse.quote(framework)}"
+        )
+        req = urllib.request.Request(
+            url,
+            headers={
+                "Accept": "text/yaml,text/plain,*/*",
+                "User-Agent": "dsh-plugin-ccp/1.0.0",
+            },
+            method="GET",
+        )
+        try:
+            with urllib.request.urlopen(req, timeout=10) as resp:
+                return {"adapter": resp.read().decode("utf-8"), "framework": framework}
+        except urllib.error.HTTPError as e:
+            return {"error": {"code": "HTTP_ERROR", "detail": str(e), "status": e.code}}
+        except Exception as e:
+            return {"error": {"code": "NETWORK_ERROR", "detail": str(e)}}
+
+    def telemetry(self, capability_id: str, success: bool, latency_ms: int = 0) -> dict:
+        """回传调用结果"""
+        return self._request(
+            "/telemetry",
+            method="POST",
+            body={
+                "capability_id": capability_id,
+                "success": success,
+                "latency_ms": latency_ms,
+                "agent_id": "dsh-plugin-ccp",
+            },
+        )
+
+    def list_capabilities(self, category: Optional[str] = None) -> dict:
+        """列出所有能力锚点"""
+        params = ""
+        if category:
+            params = f"?category={urllib.parse.quote(category)}"
+        return self._request(f"/capabilities{params}")
+
+    def node_info(self) -> dict:
+        """获取节点信息"""
+        return self._request("/node")
+
+
+_client = CCPClient()
+
+
+def ccp_search(q: str, category: Optional[str] = None) -> dict:
+    """
+    DSH 工具：搜索能力锚点。
+
+    通过 CCP 协议搜索 AI 能力，返回能力锚点列表（含信任向量）。
+
+    Args:
+        q: 搜索关键词（中文或英文）
+        category: 能力分类过滤（ai/data/media/language/dev），可选
+
+    Returns:
+        包含 results 列表和 count 的字典，每个结果包含 id/name/desc/trust 向量
+    """
+    result = _client.search(q, category)
+    if "error" in result:
+        return {"error": result["error"], "results": [], "count": 0}
+
+    summary = []
+    for cap in result.get("results", []):
+        summary.append(
+            {
+                "id": cap.get("id"),
+                "name": cap.get("name"),
+                "name_en": cap.get("name_en"),
+                "desc": cap.get("desc"),
+                "category": cap.get("category"),
+                "endpoint_type": cap.get("endpointType"),
+                "trust": {
+                    "source": cap.get("trustSource"),
+                    "usage_rate": cap.get("trustUsageRate"),
+                    "success": cap.get("trustSuccess"),
+                    "risk": cap.get("trustRisk"),
+                    "time": cap.get("trustTime"),
+                },
+            }
+        )
+
+    return {
+        "query": result.get("query", q),
+        "count": len(summary),
+        "federated": result.get("federated", False),
+        "results": summary,
+    }
+
+
+def ccp_detail(capability_id: str) -> dict:
+    """
+    DSH 工具：获取能力锚点详情。
+
+    获取指定能力的完整信息，包括端点、输入输出规格、信任向量和证据层。
+
+    Args:
+        capability_id: 能力锚点 ID（如 pdf-extract-text-001）
+
+    Returns:
+        完整的能力锚点对象
+    """
+    result = _client.detail(capability_id)
+    if "error" in result:
+        return {"error": result["error"]}
+    return result
+
+
+def ccp_telemetry(capability_id: str, success: bool, latency_ms: int = 0) -> dict:
+    """
+    DSH 工具：回传调用结果到 CCP 遥测端点。
+
+    每次 Agent 调用能力后应回传结果，以维护信任向量的准确性。
+
+    Args:
+        capability_id: 能力锚点 ID
+        success: 调用是否成功
+        latency_ms: 调用延迟（毫秒）
+
+    Returns:
+        确认信息
+    """
+    result = _client.telemetry(capability_id, success, latency_ms)
+    if "error" in result:
+        return {"error": result["error"], "acknowledged": False}
+    return {"acknowledged": True, "capability_id": capability_id}

dsh_plugin_ccp-1.0.0.dist-info/METADATA

@@ -0,0 +1,65 @@
+Metadata-Version: 2.1
+Name: dsh-plugin-ccp
+Version: 1.0.0
+Summary: DSH 插件：CCP 协议能力发现层 — 让 DSH Agent 通过 CCP 协议搜索、评估、调用能力
+Author-email: CCP Community <ccp@skillmesh.礼字号.中国>
+License: MIT
+Project-URL: Homepage, https://skillmesh.礼字号.中国
+Project-URL: Repository, https://github.com/aidulibrary/skillmesh-index
+Project-URL: CCP RFC, https://github.com/aidulibrary/skillmesh-index/blob/main/docs/rfc-dsh-ccp-discovery.md
+Keywords: dsh,ccp,deepseek-harness,capability,discovery,trust-vector
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: urllib3 >=2.0
+
+# dsh-plugin-ccp
+
+DSH 插件：CCP 协议能力发现层。
+
+## 安装
+
+```bash
+dsh plugin install dsh-plugin-ccp
+```
+
+## 配置
+
+```bash
+dsh config set ccp.endpoint https://skillmesh.礼字号.中国/api/ccp/v1
+dsh config set ccp.federated true
+```
+
+## 提供的工具
+
+| 工具            | 功能                          |
+| --------------- | ----------------------------- |
+| `ccp_search`    | 搜索能力锚点（支持中文/英文） |
+| `ccp_detail`    | 获取能力详情 + 信任向量       |
+| `ccp_telemetry` | 回传调用结果（信任向量闭环）  |
+
+## 使用示例
+
+```python
+# DSH Agent 中使用 CCP 发现能力
+result = ccp_search("pdf text extraction")
+for cap in result["results"]:
+    print(f"{cap['name']} — trust: {cap['trust']['success']:.0%}")
+
+# 获取详情
+detail = ccp_detail("pdf-extract-text-001")
+
+# 回传调用结果
+ccp_telemetry("pdf-extract-text-001", success=True, latency_ms=120)
+```
+
+## 许可
+
+MIT

dsh_plugin_ccp-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+dsh_plugin_ccp/__init__.py,sha256=Aj77VL1d5Mdku7sgCgKQmPuYavPpAHuZuJcy6bygQZE,21
+dsh_plugin_ccp/tools.py,sha256=HjhtRvpW6VAKcYCv5sLqLsOTQRilIo67nxehLMnzAEI,7582
+dsh_plugin_ccp-1.0.0.dist-info/METADATA,sha256=Y8dLk6QzC3m9QkZdkL0TV9sTMM5ccBVYUwVS15PCtDY,2066
+dsh_plugin_ccp-1.0.0.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
+dsh_plugin_ccp-1.0.0.dist-info/top_level.txt,sha256=5b0pqzn-AGOGxtt1f3ZOvya_B3aLtQE9AYWozYQhnRM,15
+dsh_plugin_ccp-1.0.0.dist-info/RECORD,,

dsh_plugin_ccp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.42.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

dsh_plugin_ccp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+dsh_plugin_ccp