对话导入 API

接口地址

POST https://api.omhhub.com/api/memory/import/conversation/

兼容旧路径（不推荐新集成使用）：

POST https://api.omhhub.com/api/memory/import/codex/

认证

Authorization: Bearer omh_xxx
Content-Type: application/json

Token 必须以 omh_ 开头。

请求示例

{
  "tool": "codex",
  "title": "一次开发对话",
  "workspace": "my-project",
  "summary": "本次对话完成了某个功能开发，并记录关键决策。",
  "tags": ["Codex", "memory"],
  "messages": [
    {
      "role": "user",
      "content": "用户提出的需求",
      "content_format": "markdown"
    },
    {
      "role": "assistant",
      "content": "AI 的关键回复或结果",
      "content_format": "markdown"
    }
  ],
  "raw_metadata": {
    "source": "codex",
    "sensitive_data_redacted": true
  }
}

主要字段

字段	必填	说明
tool	建议	工具来源，如 codex、trae
title	是	对话标题
workspace	否	项目空间名称
summary	否	会话摘要
tags	否	标签数组
messages	是	消息列表
raw_metadata	否	会话级扩展信息

消息字段：

字段	必填	说明
role	建议	user / assistant / system / tool
content	是	消息正文
content_format	否	markdown 或 text
sequence	建议	消息顺序，从 1 开始

响应示例

{
  "code": 2000,
  "data": {
    "id": 6,
    "title": "一次开发对话",
    "message_count": 2,
    "tool": "codex"
  },
  "msg": "导入成功"
}

注意事项

• 导入前请脱敏密码、Token、私钥等敏感信息
• 建议传入稳定的 source_conversation_id 便于追踪与去重
• 附件可通过 raw_metadata.attachments 结构化传递