# IMA 上传格式速查表（日报沉淀专用）

## 文件名 vs 标题 vs 内容对照表

| 项目 | ✅ 正确 | ❌ 错误 |
|------|---------|---------|
| **文件名** | `从Vibe Coding到Harness—— 一套大仓AI工程化实战.md` | `大仓AI工程化实战.md` |
| **add_knowledge title** | `从Vibe Coding到Harness—— 一套大仓AI工程化实战` | `大仓AI工程化实战` / `大仓AI工程化实战.md` |
| **上传方式** | `preflight` → `create_media` → `cos-upload` → `add_knowledge(media_type=7)` | `import_doc` + `add_knowledge(media_type=11)` |
| **正文内容** | pipeline `extracted/` 的 `article.content` 或 `summary-batch.json` 的 `summary` | 自己写的两三句话 |
| **正文长度** | ≥ 500 字 | < 500 字 |

## 文件名常见错误模式

| 原始标题 | ❌ 错误文件名 | ✅ 正确文件名 |
|----------|-------------|-------------|
| `从Vibe Coding到Harness—— 一套大仓AI工程化实战` | `大仓AI工程化实战.md` | `从Vibe Coding到Harness—— 一套大仓AI工程化实战.md` |
| `契约化多端架构：基于领域模型的Harness实践` | `契约化多端架构Harness实践.md` | `契约化多端架构：基于领域模型的Harness实践.md` |
| `Loop Engineering 实战：从日志扫描到预发部署的全自主闭环` | `LoopEngineering实战.md` | `Loop Engineering 实战：从日志扫描到预发部署的全自主闭环.md` |

## 5 Section 格式要求

| Section | 格式 | 说明 |
|---------|------|------|
| **核心结论** | 一段连贯段落（非分点） | 总结文章核心发现或主张 |
| **主要论点** | 一段连贯段落（非分点） | 综合多个论点形成连贯叙述 |
| **关键方法 / 机制** | `- **方法名**：详细说明` 分点 | 每条展开到能理解原理的程度 |
| **重要细节** | `- 每条一个带解释的完整知识点` 分点 | 每条是一个完整知识点，不是关键词 |
| **可复用启发** | `- 每条 actionable 的实践启示` 分点 | 附应用场景说明 |

## 底部额外 section

- `## 关键词` — 标签式关键词列表
- `## 主题` — 主题分类

## 速查口诀

> 文件名 = 完整标题.md
> 内容取 pipeline，不自己写
> 5 个 section，核心结论和主要论点是段落
> media_type = 7，不是 11
> title 不加 .md