输出结构

Ideon 每次运行都会写入一个生成目录。每个生成目录包含一个或多个 Markdown 输出、运行定义 job.json、单次运行 analytics 文件、运行级模型交互文件以及共享图像资源。

Ideon 还会在 .ideon/write/（已加入 gitignore）保存本地写作会话产物，用于 resume。

默认路径

Markdown directory: /output
Asset directory: /output/assets
Analytics file: generation.analytics.json inside each generation directory
Model interactions file: model.interactions.json inside each generation directory

以 /output 开头的路径会相对于当前工作目录解析。

生成目录布局

示例：

output/
  20260327-practical-ai-workflows/
    article-1.md
    x-thread-1.md
    x-post-1.md
    linkedin-1.md
    job.json
    generation.analytics.json
    model.interactions.json
    practical-ai-workflows-cover.webp
    practical-ai-workflows-inline-1.webp

Markdown 文件按内容类型前缀编号：

article-1.md
blog-1.md
x-thread-1.md
x-post-1.md
reddit-1.md
linkedin-1.md
newsletter-1.md
landing-1.md

文章 Markdown 内容

生成的 Markdown 包含：

YAML frontmatter：
- title
- subtitle
- slug
- description
- keywords
H1 标题与副标题行
封面图嵌入（若存在）
导语正文
各章节正文（H2 标题）
按章节位置锚定的内嵌图片
结论部分

Slug 行为

文章 slug 会在规划阶段标准化。生成目录名带时间戳，并在每次运行中保持唯一。

资源链接

Markdown 嵌入使用从 Markdown 文件位置到资源文件的相对路径。

Analytics 文件

每次生成都会在生成目录输出 generation.analytics.json。

JSON 包含：

运行摘要：总耗时、总重试次数、总成本（可用时）
阶段指标：各阶段耗时、重试与阶段成本
图像提示调用：每个图像提示扩展的耗时/成本与 token 使用（可用时）
图像渲染调用：每次渲染的耗时/成本与输出字节大小

要在浏览器中查看生成的 Markdown 与图片嵌入，可运行 ideon preview。

模型交互文件

每次生成还会在目录中输出 model.interactions.json。

JSON 包含：

运行封装：runId、runMode、dryRun、startedAt、endedAt
llmCalls：每次 OpenRouter 尝试一条记录，含阶段/操作 ID、请求类型、原始序列化请求体、原始响应体、耗时、尝试/重试与最终状态
t2iCalls：每次图像渲染尝试一条记录，含阶段/操作 ID、原始提示词、解析后的 T2I 输入、耗时、重试与最终状态

该文件用于提示工程与故障分析，因此会有意保留原始 payload。

作业定义文件

每次运行也会在生成目录输出 job.json，记录最终解析后的运行定义：

本次运行使用的 idea 与 prompt
可选 targetAudience 种子（显式提供或继承自作业文件）
解析后的 contentTargets 与 style
完整解析后的 settings 对象（含当前与未来字段）
源作业 payload（若提供，字段为 sourceJob）
运行元数据（generatedAt、dryRun、runMode）

示例结构：

{
  "idea": "How teams can operationalize content systems",
  "prompt": "How teams can operationalize content systems",
  "targetAudience": "Content operators building repeatable publishing systems",
  "settings": {
    "model": "moonshotai/kimi-k2.5",
    "modelSettings": { "temperature": 0.7, "maxTokens": 4000, "topP": 1 },
    "modelRequestTimeoutMs": 90000,
    "t2i": { "modelId": "black-forest-labs/flux-schnell", "inputOverrides": {} },
    "markdownOutputDir": "/output",
    "assetOutputDir": "/output/assets",
    "contentTargets": [{ "contentType": "article", "role": "primary", "count": 1 }],
    "style": "professional"
  },
  "sourceJob": null,
  "generatedAt": "2026-03-27T10:20:00.000Z",
  "dryRun": false,
  "runMode": "fresh"
}

本地会话产物

会话状态文件：.ideon/write/state.json
包含已保存阶段输出（plan、章节草稿、图像元数据、最终产物摘要）
fresh 运行会覆盖之前的 .ideon/write 产物
ideon write resume 依赖该状态在失败或中断后继续
会话状态按目录隔离：Ideon 会在你执行命令的当前目录下读写 .ideon/write/state.json

目录隔离示例：

在 ~/project-a 运行时，会创建并读取 ~/project-a/.ideon/write/state.json
在 ~/project-b 运行时，会使用 ~/project-b/.ideon/write/state.json，无法读取 project-a 的会话状态
若你移动了项目目录，请同时移动 .ideon/；否则在恢复前需要先还原该目录或重新生成会话状态

关键状态字段：

status：running、failed 或 completed
lastCompletedStage：最近一次检查点阶段 ID
failedStage 与 errorMessage：最近失败元数据
plan、text、imagePrompts、imageArtifacts：resume 使用的阶段缓存产物
artifact：最终输出摘要（markdownPaths、generationDir、analyticsPath、interactionsPath 及数量）

默认路径​

生成目录布局​

文章 Markdown 内容​

Slug 行为​

资源链接​

Analytics 文件​

模型交互文件​

作业定义文件​

本地会话产物​