API 文档

本页仅用于说明企业长期记忆中枢的接口形状与安全边界,不表示所有示例端点已启用;正式字段以当前发行包和后端接口为准。

运行状态

GET /api/lightweight/health
GET /api/lightweight/runtime/status

任务包预览

POST /api/lightweight/chat/preview
Content-Type: application/json

{
  "message": "继续上次项目方案,沿用已确认的安全边界",
  "mode": "memory_safe",
  "target": "external_model"
}

返回示意

{
  "task_understanding": {
    "task_type": "project_plan",
    "task_object": "接口迁移方案",
    "risk_level": "high"
  },
  "outbound_task_package": {
    "send_to_model": ["项目背景摘要", "已确认接口约定", "输出格式要求"]
  },
  "local_control_package": {
    "local_only": ["账号凭据", "内部密钥", "身份隐私"],
    "return_checks": ["不得修改 Provider 路由", "不得执行未授权写入"]
  }
}

调用边界

POST /api/lightweight/chat/preview

预览只展示任务理解、允许外发内容和本地控制规则。任何真实模型调用都必须使用已经批准的模型路由与单独授权。

候选记忆

POST /api/memory-center/candidates/preview
POST /api/memory-center/candidates/preflight

模型结果只能先进入候选流程;核心长期记忆不得绕过冲突检测、人工确认、审计和回滚快照直接写入。

开发工具扩展边界

当前系统与前端开发阶段,开发记忆网关保持关闭,正常开发、验证与打包不得依赖它。未来重新启用需要单独指令、健康与字段检查、补丁门、验证、冻结和回滚证据。

错误码建议

错误码 含义 用户提示
privacy_blocked 隐私检查阻断 当前任务包含只能本地使用的信息,不能外发给模型。
human_review_required 需要人工确认 该任务涉及高风险操作,请先确认草稿。
model_not_available 模型不可用 请检查本地模型或 API Key 配置。
memory_conflict 候选记忆冲突 新规则与已有记忆冲突,请选择覆盖、合并或保留。