Initial commit

2025-11-18 03:36:49 +08:00
commit d17c7efb3c
7078 changed files with 831480 additions and 0 deletions
--- a/文档/NodeActionService.md
+++ b/文档/NodeActionService.md
@@ -0,0 +1,223 @@
+# NodeActionService
+> 节点动作服务
+
+---
+
+## createNodeAction
+> 添加动作
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/createNodeAction`
+- RPC：`rpc createNodeAction(CreateNodeActionRequest) returns (CreateNodeActionResponse);`
+
+**请求对象 (`CreateNodeActionRequest`)**
+
+```json
+{
+  "nodeId": "int64 // 节点ID",
+  "role": "string // 节点角色",
+  "condsJSON": "bytes // 条件设置",
+  "actionJSON": "bytes // 动作设置",
+  "durationJSON": "bytes // 持续时间"
+}
+```
+
+**响应对象 (`CreateNodeActionResponse`)**
+
+```json
+{
+  "nodeActionId": "int64"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/createNodeAction" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## deleteNodeAction
+> 删除动作
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/deleteNodeAction`
+- RPC：`rpc deleteNodeAction(DeleteNodeActionRequest) returns (RPCSuccess);`
+
+**请求对象 (`DeleteNodeActionRequest`)**
+
+```json
+{
+  "nodeActionId": "int64"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/deleteNodeAction" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findAllNodeActions
+> 列出某个节点的所有动作
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/findAllNodeActions`
+- RPC：`rpc findAllNodeActions(FindAllNodeActionsRequest) returns (FindAllNodeActionsResponse);`
+
+**请求对象 (`FindAllNodeActionsRequest`)**
+
+```json
+{
+  "nodeId": "int64 // 节点ID",
+  "role": "string // 节点角色"
+}
+```
+
+**响应对象 (`FindAllNodeActionsResponse`)**
+
+```json
+{
+  "nodeActions": "[]NodeAction // 动作列表"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/findAllNodeActions" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## findNodeAction
+> 查找单个节点动作
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/findNodeAction`
+- RPC：`rpc findNodeAction(FindNodeActionRequest) returns (FindNodeActionResponse);`
+
+**请求对象 (`FindNodeActionRequest`)**
+
+```json
+{
+  "nodeActionId": "int64 // 动作ID"
+}
+```
+
+**响应对象 (`FindNodeActionResponse`)**
+
+```json
+{
+  "nodeAction": "NodeAction"
+}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/findNodeAction" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateNodeAction
+> 修改动作
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/updateNodeAction`
+- RPC：`rpc updateNodeAction(UpdateNodeActionRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateNodeActionRequest`)**
+
+```json
+{
+  "nodeActionId": "int64 // 动作ID",
+  "condsJSON": "bytes",
+  "actionJSON": "bytes",
+  "durationJSON": "bytes // 持续时间",
+  "isOn": "bool // 是否启用"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/updateNodeAction" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---
+
+## updateNodeActionOrders
+> 设置节点动作排序
+
+- 角色：`admin`
+- HTTP：`POST https://backend.dooki.cloud/NodeActionService/updateNodeActionOrders`
+- RPC：`rpc updateNodeActionOrders(UpdateNodeActionOrdersRequest) returns (RPCSuccess);`
+
+**请求对象 (`UpdateNodeActionOrdersRequest`)**
+
+```json
+{
+  "nodeActionIds": "[]int64 // 节点动作ID列表"
+}
+```
+
+**响应对象 (`RPCSuccess`)**
+
+```json
+{}
+```
+
+**调用示例**
+
+```bash
+curl -X POST "https://backend.dooki.cloud/NodeActionService/updateNodeActionOrders" \
+  -H "Content-Type: application/json" \
+  -H "X-Edge-Access-Token: <YOUR_TOKEN>" \
+  -d '{
+    ...
+  }'
+```
+
+---