设计：Agent 原生接入（第二用户 API / 等 dev 转正后实现）

[wochenlong]

背景

Next Trainer 要把外部 Agent（编码助手等）当作第二用户：与人类共用数据集 / 打标 / 训练计划 / 任务系统，而不是给页面加遥控或只暴露裸 shell。

详细设计与开发任务清单（脱敏草案）：

• docs/design/agent-native.md（分支草稿）

关联：信息架构 #215、Vue3 #209。

方向（简要）

1. HTTP 契约优先（capabilities / Token / 统一 Job）；MCP 为后续薄封装，不是前置条件
2. 长任务统一：打标与训练同一套 create → poll → cancel，任务页区分 human / agent
3. 数据集与打标单轨：不按引擎分叉；plan / start 才出现 engine
4. UI：侧栏底部独立 Agent 接入页（凭证与说明），不改「训练 / 数据集 / 任务 / 设置」主路径

排期

等 dev 转正后再启动实现，当前不急。
本 Issue 只作方向与任务边界存档；未完成 P0 前，对外仅可写「规划中」。

实现时建议拆分

1. 统一 Job 模型与训练/打标适配
2. Token + capabilities + 错误码
3. P0 工具 endpoints（validate / plan / dry-run / start / job / logs / cancel）
4. 数据集目录解析（subsets + N_name repeats）
5. 侧栏 Agent 页 + 任务来源展示
6. 调用说明 + 契约测试
7. （P1）MCP 与沙箱审计

P0 验收标准见设计文档 §6。

备注

曾用 PR #219 尝试只合设计文档；延期设计更适合以 Issue 跟踪，故以本 Issue 为准，对应 PR 将关闭不合并。

[wochenlong]

已关闭不宜合并的设计-only PR：#219