实例状态 / 配置 / 文件 API
实例健康、运行时配置、诊断、遥测与沙箱文件能力。主前缀 /api/v1，部分在 /api/v4。
版本说明：本页端点两者都提供，细节差异在各端点下标注。
状态与健康
| 方法 | 路径 | 鉴权 | 说明 |
|---|---|---|---|
GET | /api/v1/health | 公开 | 健康检查（含工具计数） |
GET | /api/v1/netstatus | Bearer | 网络连通状态（中继/Hub 可达性） |
GET | /api/v1/instance/status | Bearer | 实例状态（授权/版本/运行时） |
GET | /api/v1/queue | Bearer | 异步任务队列状态 |
GET | /api/v1/config | Bearer | 读取运行时配置 |
PUT | /api/v1/config | Bearer | 更新运行时配置 |
诊断与遥测
| 方法 | 路径 | 说明 |
|---|---|---|
POST | /api/v1/diagnostics | 触发诊断采集（需 Bearer 令牌） |
POST | /api/v1/telemetry/crash | 崩溃遥测上报 |
个人设置与主题（个人版）
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/v1/settings/profile | 个人资料 |
PUT | /api/v1/settings/profile | 更新个人资料 |
GET | /api/v1/settings/preferences | 偏好设置 |
POST | /api/v1/theme/apply | 应用主题 |
GET | /api/v4/profile | 资料（V4） |
POST | /api/v4/profile/switch | 切换资料档 |
沙箱与文件
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/v1/sandbox/config | 沙箱配置 |
PUT | /api/v1/sandbox/config | 更新沙箱配置 |
GET | /api/v1/sandbox/tree | 沙箱目录树 |
GET | /api/v1/sandbox/file | 读取沙箱文件 |
DELETE | /api/v1/sandbox/file | 删除沙箱文件 |
POST | /api/v1/sandbox/dir | 创建目录 |
POST | /api/v1/sandbox/upload | 上传到沙箱 |
POST | /api/v1/files/upload | 文件上传 |
GET | /api/v1/files/:id | 文件下载/读取 |
会话产物：
GET /api/v1/chat/conversations/:id/artifacts列出产物，GET .../artifacts/:artifactID/download下载；GET /api/v1/chat/trajectory查询对话轨迹。
配额与授权激活
| 方法 | 路径 | 说明 |
|---|---|---|
GET | /api/v1/billing/summary | 用量与账单汇总（见 计费 API） |
GET | /api/v1/activation/status | 本地授权状态查询（纯读） |
⚠️
POST /api/v1/activation/{activate,register,transfer}已随 v2 历史授权码体系退役（恒定 404）。
错误码
| 场景 | code | message |
|---|---|---|
| 配置项非法 | 42200 | 配置项校验失败 |
| 文件不存在 | 40400 | 文件不存在 |
| 未认证 | 40100 | 缺失或非法 Authorization 头 |