LyncoreLyncore
Lyncore

任务与目标 API ​

任务中心（/api/v4/tasks）、目标管理（/api/v4/goal）、通知（/api/v4/notifications）与内容黄金位（/api/v4/content-cards）。均为 V4 子系统（前缀 /api/v4），需 Authorization: Bearer <token>。

版本说明：本页端点两者都提供（个人版与企业版）。任务与目标为个人版近期能力提升批次（TP78~TP81）落地的核心面。

任务中心（/api/v4/tasks） ​

任务台账基于 agent_tasks 表（13 列 DDL），覆盖异步 Agent 任务的查询与控制。已登录账号按 account_id 隔离（未登录/本地 admin 不过滤）。

GET /api/v4/tasks ​

任务列表（分页）。

查询参数： status（状态过滤）、limit（默认 50）、offset（默认 0）。

响应： 分页包裹体（data 为 {items,total,page,page_size}）。任务记录字段：

json
{
  "code": 0,
  "data": {
    "items": [
      {
        "task_id": "task_abc123",
        "conversation_id": "conv_xxx",
        "parent_task_id": "",
        "task_type": "worker",
        "status": "running",
        "model": "lyncore-pro",
        "account_id": "acct_1",
        "title": "整理本周竞品价格",
        "progress_json": "{\"step\":2,\"total\":5}",
        "tokens_in": 1200,
        "tokens_out": 860,
        "cost_points": 12,
        "error": "",
        "created_at": "2026-10-14T08:00:00Z",
        "updated_at": "2026-10-14T08:05:00Z"
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 50
  },
  "message": "ok",
  "request_id": "req_abc123"
}

GET /api/v4/tasks/:taskId ​

任务详情（含 progress_json 进度）。会做归属校验，越权读他人任务返回 403。

GET /api/v4/tasks/:taskId/instructions ​

查看运行中任务已下发的指令记录。

POST /api/v4/tasks/:taskId/cancel ​

取消任务。

POST /api/v4/tasks/:taskId/retry ​

重试失败/已取消的任务。

POST /api/v4/tasks/:taskId/instruct ​

向运行中任务下发追加指令（自然语言）。

请求：

json
{ "instruction": "把第 3 项换成 XX 再汇总" }

目标管理（/api/v4/goal） ​

目标（Goal）是个人版的「当前活跃目标」管理面，与对话上下文联动。同一时刻仅一个活跃目标。

GET /api/v4/goal/active ​

获取当前活跃目标。

响应：

json
{
  "code": 0,
  "data": { "goal": { "id": "goal_1", "objective": "整理本周竞品价格", "status": "active" } },
  "message": "ok",
  "request_id": "req_abc123"
}

POST /api/v4/goal ​

创建新目标（自动将旧活跃目标置为 completed）。

请求：

json
{ "objective": "整理本周竞品价格", "token_budget": 50000 }

PUT /api/v4/goal/:id ​

更新目标状态/计划/备注。所有字段可选，仅更新非空字段。

请求：

json
{ "status": "paused", "plan_text": "先抓 A 站", "note": "等数据" }

status 取值：active / blocked / paused / completed。

通知（/api/v4/notifications） ​

方法路径说明
GET/api/v4/notifications通知列表
GET/api/v4/notifications/unread-count未读数
POST/api/v4/notifications/:id/read标记已读
POST/api/v4/notifications/read-all全部已读
POST/api/v4/notifications/clear-dismissed清除已忽略
DELETE/api/v4/notifications/:id删除通知
POST/api/v4/notifications创建通知

创建请求：

json
{
  "type": "task_done",
  "severity": "info",
  "title": "任务完成",
  "body": "竞品价格已汇总",
  "source_type": "task",
  "source_id": "task_abc123",
  "dedup_key": "task_done_abc123",
  "dedup_window_seconds": 300
}

内容黄金位（/api/v4/content-cards） ​

Hub 云端下发的广告/内容轮播位。

方法路径说明
GET/api/v4/content-cards内容卡片列表
GET/api/v4/content-cards/feed信息流（含黄金位轮播）
POST/api/v4/content-cards/:id/dismiss忽略某卡片

错误码 ​

场景codemessage
任务不存在40400任务不存在
越权访问任务40300无权访问该任务
非法状态过滤40000非法 status
goal 系统未初始化50300goal 系统未初始化