kanban API: comment endpoint + usage docs, notification includes curl example

2026-06-21 11:29:17 +08:00
parent aa7b67fc2b
commit 90ed30dd36
2 changed files with 290 additions and 0 deletions
@@ -0,0 +1,59 @@
+# Kanban HTTP API — 跨机器任务协作
+
+所有 Agent（mohe、zhiwei、xxm、xiao）通过 HTTP API 读写 kanban 任务卡片。
+不需要 Hermes，不需要 XMPP bot，只需要能 curl 到 `192.168.1.246:9580`。
+
+## 基础 URL
+
+```
+http://192.168.1.246:9580/kanban
+```
+
+## 操作
+
+### 查看所有任务
+```bash
+curl -X POST http://192.168.1.246:9580/kanban/list -H "Content-Type: application/json" -d '{}'
+```
+
+可以筛选：
+```bash
+# 只看指派给自己的
+curl -X POST ... -d '{"assignee":"xxm"}'
+
+# 只看待处理
+curl -X POST ... -d '{"status":"ready"}'
+```
+
+### 查看单个任务
+```bash
+curl -X POST http://192.168.1.246:9580/kanban/show -d '{"id":"t_3adcf4a6"}'
+```
+
+### 添加评论（有问题或进展时用）
+```bash
+curl -X POST http://192.168.1.246:9580/kanban/comment \
+  -d '{"id":"t_3adcf4a6","author":"xxm","body":"这里有个问题：..."}'
+```
+
+评论会发到核心群通知所有人。
+
+### 查看评论
+```bash
+curl -X POST http://192.168.1.246:9580/kanban/comments -d '{"id":"t_3adcf4a6"}'
+```
+
+### 更新任务状态
+```bash
+curl -X POST http://192.168.1.246:9580/kanban/update \
+  -d '{"id":"t_3adcf4a6","status":"done"}'
+```
+
+## 沟通流程
+
+1. 创建任务 → 核心群收到通知
+2. 你有问题 → 加评论（curl comment）
+3. 评论被看到 → 有人回复评论
+4. 完成 → 更新状态为 done
+
+**不需要在群里说话。** 评论代替讨论，通知代替 @。