Official Article Ingest

---
name: official-article-ingest
description: "Use when Sam wants to collect, save, translate, or reformat official source articles/blog posts/research/product announcements into the Obsidian vault, especially requests mentioning 官方文章, 官网排版, 原始排版, 美观, 收录, 1:1, 原文1:1, or 英文中文对照1:1. Preserve the source site's information architecture and visual hierarchy rather than forcing a generic Markdown template."
---

# Official Article Ingest

用于把官方来源文章收录到 Sam 的 Obsidian Vault，并尽量保持来源页面的原始结构、视觉层级和阅读美感。默认先读取 `orbit-os` 规则，遵守 Vault 路径、媒体本地化、外部写入后 `touch "<file>"` 等约束。

## 先判定模式

如果用户没有明确说明，先问要哪一种；不要把两种混用。

### 模式 A：原文 1:1

适用表达：`原文1:1`、`只要原文`、`原始英文保存`、`按官网原文排版`。

- 保留来源语言正文，不插入中文翻译。
- 保留源站信息架构：hero、标题、副标题/摘要、日期、作者、Quick links/TOC、正文层级、列表、表格、媒体、图注、labels、acknowledgments、source link。
- 在 Obsidian 中做“近似官网排版”，可以用少量内联 HTML；不新增全局 CSS，除非用户明确要求做模板化复用。
- 如果来源是公开受版权保护文章，避免在最终回复中贴出长段原文；本地落盘前优先确认用户是否已有合法来源/是否已在 Vault 中存有原文。无法确认时，采用结构对齐的摘录与自有整理，并说明边界。

### 模式 B：英文中文对照 1:1

适用表达：`英文中文对照1:1`、`中英对照1:1`、`逐段对照翻译`、`逐段补中文`。

- 保留英文原文顺序，在每个英文段落、列表项、图注、标题或表格块后紧贴中文翻译。
- 中文默认使用普通段落，除非原文自身是引用块、callout、列表、表格或代码块。
- 不把译文集中放到文末，不改写成摘要，不额外添加编辑说明或观点，除非用户要求。
- 标题、日期、作者、摘要、Quick links、媒体说明也要双语化，并尽量保持源站首屏节奏。

## 版式原则

- 以官方页面原始排版为第一参考，而不是套通用 Markdown 模板。
- 先识别来源页面首屏：品牌/栏目、hero 标题、中文/英文标题、封面或主图、日期、作者、dek/摘要、Quick links。
- 正文保持原顺序：不要重排章节，不合并独立段落，不移动图片/视频到文末。
- 对 Google/OpenAI/Anthropic 等官方文章，优先保留“官网阅读感”：大标题、充足留白、媒体靠近对应段落、caption 紧贴媒体。
- Obsidian 近似排版可以使用内联 HTML，但必须在当前笔记内自包含；不要污染全局主题或其他笔记。

## 媒体与链接

- 正文图片、视频、动态图默认本地化到同级 `assets/<slug>/`，正文使用相对路径。
- 保留原文链接；外部 source 放 frontmatter 的 `source`。
- 媒体必须做三数校验：预期正文媒体数 = 下载成功数 = 文内引用数。缺失时不要宣称完成。
- 图注/视频说明按模式处理：原文 1:1 只保留原语言；中英对照 1:1 保留原文 caption + 中文 caption。

## Vault 收尾

- Frontmatter 必须在第一行，`---` 分隔符只用于 frontmatter；正文分隔线用 `***`，避免校验混淆。
- 写入后执行 `test -s "<file>"`。
- 写入后执行 `touch "<file>"`，路径必须加引号。
- 抽查 Obsidian Reading/Preview：首屏 hero、Quick links、正文列表、媒体 caption 是否美观可读；如果标题被挤到逐字断行，降低字号或调整列宽。
- 最终只汇报改动范围、媒体/结构校验、`touch` 结果；不要把整篇文章正文贴到回复里。