# 行业资讯数据格式参考

> 配套 SKILL.md 的「行业资讯」一节。这里是完整的格式约定与映射表；入口与查询流程看 SKILL.md 本体。

## `/news/md` 索引格式

索引本身也是 markdown，一行一个文件的链接列表：

```markdown
# 行业资讯 · Markdown 数据索引

> 每天一个文件，原文即数据（格式说明见各文件头）。

- [sources.md](/news/md/sources.md) — 信息源配置
- [insights.md](/news/md/insights.md) — 前台洞察栏配置
- [20260610.md](/news/md/20260610.md) — 2026-06-10
- [20260609.md](/news/md/20260609.md) — 2026-06-09
```

提取全部可抓日期：`grep -oE '[0-9]{8}\.md' | sort -u`。

## 每日文件格式（机器可读约定）

每条资讯是一个 `## 块`，标题行下是若干 `- key: value` 元数据行，空行后是摘要正文：

```markdown
## Kimi 发布新一代模型
- id: kimi-xxx-0609
- category: 模型, 产品
- time: 14:30
- source: Kimi (Moonshot AI)
- handle: @Kimi_Moonshot
- url: https://x.com/...
- tags: AI应用, 评测/基准

（摘要正文，可多段）
```

- `time` 是发布时间（HH:MM，24 小时制，北京时间），**可选**——用于当日内排序（新在上），缺失时该条视为当日最新。文件内条目已按此排好序，按原文顺序展示即可。
- `category` 可属多类，逗号分隔；`tags` 是自由短标签，逗号分隔。
- 部分条目还有 `- media: image <url>` / `- media: video <url>` 行（配图 / 视频），转述资讯时通常用不到。

## `category` 类型枚举（受控，共 6 类）

| 类型 | 含义 |
|---|---|
| `资讯` | 公司 / 行业动态 |
| `产品` | 产品发布 / 更新 |
| `模型` | 模型发布 / 更新 |
| `播客` | 播客节目 |
| `论文` | 论文 |
| `博文` | 博客文章 |

## `/api/news/feed` 的 JSON 结构

```jsonc
{
  "categories": ["资讯", "产品", "模型", "播客", "论文", "博文"],
  "count": 123,
  "items": [                        // 按日期倒序
    {
      "id": "kimi-xxx-0609",
      "date": "2026-06-09",         // YYYY-MM-DD
      "time": "14:30" | "",
      "category": ["模型", "产品"],  // 数组，用 index("模型") 判断包含
      "source": "Kimi (Moonshot AI)",
      "handle": "@Kimi_Moonshot" | "",
      "url": "https://x.com/...",
      "title": "Kimi 发布新一代模型",
      "tags": ["AI应用"],
      "media": [ { "type": "image", "url": "https://..." } ],
      "order": 0,                    // 排序辅助字段，忽略即可
      "summary": "..."
    }
  ],
  "insights": { /* 前台「近期热议」洞察栏配置，回答资讯问题用不到，忽略即可 */ }
}
```

## 用户意图 → 类型映射（agent 匹配）

用户通常不会说类型枚举值，而是随口问。先按下表映射到 `category` 再过滤：

| 用户问 | 过滤方式 |
|---|---|
| "最近有什么新模型发布吗？" | `category` 含 `模型`，取最新几个日期 |
| "有什么 AI 新产品 / 新功能上线？" | `category` 含 `产品` |
| "最近 AI 圈有什么新闻 / 大事？" | `category` 含 `资讯`（或不过滤类型，全量做摘要） |
| "有什么值得读的论文 / 博客？有什么播客？" | `论文` / `博文` / `播客` |
| "X 月 X 日到 X 月 X 日发生了什么？" | 按索引挑该范围内的日期文件，不过滤类型 |

## 其他文件

- `sources.md` 是管理员维护的信息源配置（资讯从哪些 X 官号 / 官网 / RSS 抓取），回答资讯问题一般用不到；只有用户明确问"资讯来自哪里"时再抓它。
- `insights.md` 是前台洞察栏（「近期热议」等）的配置原文，agent 同样用不到。