用 curl 与纯 GraphQL 管理博客（Agent 实操）

Agent 可操作性

Agent 用 Authorization: Bearer <API_TOKEN> 直接操作，全 GraphQL：

curl -X POST $API/graphql -H "Authorization: Bearer $TOKEN" \\
  -H "Content-Type: application/json" -d '{
    "query": "mutation($k:String!,$i:PostInput!){createPost(input:$i,idempotencyKey:$k){slug title status}}",
    "variables": {"k":"key-001","i":{"title":"新文章","content":"正文","status":"PUBLISHED","tags":["测试"]}}
  }'

错误统一走 errors[].extensions.agent_hints，机器可读。