feat: 完成节点协议与 SDK

2026-08-08 21:04:18 +08:00
commit 906553d2d0
9 changed files with 980 additions and 0 deletions
@@ -0,0 +1,21 @@
+# WOV SDK
+
+本仓库是 WOV 平台的节点协议和 SDK，不包含业务逻辑。
+
+## 职责
+
+- 定义 `NodeManifest`：节点的能力、命令、资源、生命周期配置。
+- 定义节点调用协议：`GET /health`、`POST /invoke`。
+- 提供标准节点 HTTP 服务端，让每个节点仓库可以独立运行。
+- 提供工作流 DAG 数据结构，供 `wov-api` 使用。
+
+## 不变量
+
+- SDK 保持零第三方运行时依赖，方便任意节点仓库独立安装。
+- 节点之间只通过产物 URI 交换数据，不直接互相调用。
+- 节点 Manifest 一旦发布，字段语义不得随意改变；新增能力必须向后兼容。
+
+## 环境
+
+- Python 环境统一使用 uv 管理，不直接使用 pip 修改依赖。
+- 测试必须达到 100% 行覆盖率，且只能通过调用真实代码路径覆盖。