# PJ2026-02 智媒工厂总规格

## 修改历史

| 版本 | 更新日期 | 变更说明 |
| --- | --- | --- |
| v0.1 | 2026-07-13 | 定义智媒工厂预期终态和七个 L1 能力域。 |

## 正文

## PJ2026-02 智媒工厂总项目需求规格

## 1. 文档控制

| 字段 | 内容 |
| --- | --- |
| 编号 | PJ2026-02 |
| 短名 | 智媒工厂 |
| 层级 | L0 总项目 |
| 规格状态 | 已生效 |
| 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) |
| 规格治理索引 | 本文第 7 章 |

本文采用 ISO/IEC/IEEE 29148 需求规格模板的项目裁剪版。

正文边界如下：

- 只定义预期终态、目标能力、稳定边界和验收契约；
- 不记录实现进度或阶段基线。

## 2. 目的和范围

### 2.1 项目使命

项目使命包括：

- 面向科技资讯创作者和技术团队；
- 把资讯发现、事实核验、编辑策划、动态图文、配音、字幕、成片和发布材料收敛为本地优先的生产链；
- 以嵌入式与 AI 交叉、纯嵌入式和 AI 为首要内容方向；
- 成为可配置、可单步调试的技术内容生产基础设施；
- 使每一期节目都能从来源证据追溯到口播、画面、成片和评论区引用。

### 2.2 预期终态

智媒工厂终态应同时具备：

- 可追溯资讯底座：
  - 通过 owning YAML 管理 RSS、Atom、公开 API、Hacker News 和人工来源；
  - 保留一手来源、发现来源、信任层级、分类、版权提示和原始响应；
  - 优先处理嵌入式与 AI、纯嵌入式、AI 和实用优惠信息。
- 有效编辑策划：
  - 提供授权 LLM 和完全离线模板两种文稿路径；
  - 生成合并开场与卡片大纲、逐条口播、专业对象补充、参考来源和评论区文案；
  - 最后一条资讯结束后直接进入参考来源，不生成总结场景；
  - 对状态、日期、数字、媒体归因、预印本和专业对象说明实施质量门。
- 可审查动态视觉：
  - 采集实际来源网页、GitHub 页面或论文页面为本地视觉工件；
  - 使用本地 OCR 和可审查的视觉规划选择信息充分的画面；
  - 生成以白色和绿色为主、暖阳圆角、无渐变的 HTML 动效、PNG 预览和 PPTX；
  - 以确定性时间驱动页面滚动、重点放大、章节进度和阶段导航。
- 自然音频成片：
  - 使用本地开源中文 TTS 生成可缓存、可替换音色和可调语速的配音；
  - 由 owning YAML 管理音色、语速、停顿、响度、字幕和编码；
  - 生成 WAV、时间线、SRT、ASS、MP4、封面和自动检查报告。
- 可调试流水线平台：
  - TypeScript CLI 支持单步、区间和完整流水线；
  - 长任务采用异步作业，提供状态、进度、日志、结果、重试和取消；
  - 同源 Web 编辑台展示期次、作业、日志、费用和全部已登记工件；
  - 工件按内容版本兼容性组合为完整发布包。
- 受控发布运营：
  - 生成与最终成片真实章节起点一致的评论区时间轴；
  - 输出参考来源、公开目录价成本估算、技术验收结果和人工复核材料；
  - 持久化批准人、批准时间、退回记录、发布版本和反馈台账；
  - 通过本地或公网 IP 提供候选成片和工件的受控预览。
- 隔离自动交付：
  - 提供 Web 内置 Codex 终端、版本化后端容器、会话 PVC 和重启自动恢复；
  - 通过 YAML-first Kubernetes 投影相互隔离的 Secret，并从公网 IPv4 原入口验收；
  - 建立 GitHub、mirror、PaC、Tekton、GitOps 和 Argo 自动交付链；
  - Web 工厂与生成内容主题解耦，采用工业风和紧凑高信息密度布局。

### 2.3 终态验收边界

- 七个 L1 必须分别满足原入口验收，才能宣称 L0 终态达成。
- 单机样片、一次成功作业、临时公网入口或部分步骤工件不能替代 L0 终态验收。
- 自动技术检查通过不能替代人工事实、版权、听感、平台规则和发布批准。
- 执行态、实现差距和一次性证据只进入阶段报告、任务报告、偏离记录或执行 issue。

### 2.4 扩展目标

- 形成多栏目、多主题、多语言和多平台复用的内容生产模型，同时保持每个栏目独立的来源、策划、视觉、声音和发布策略。
- 让人工编辑能够在任何阶段插入、覆盖、重跑或批准结果，不被端到端自动化锁死。
- 建立来源事实、内容决策、媒体工件和发布版本之间的可追溯关系，支持复核、纠错和再利用。
- 持续扩展本地开源语音、视觉和媒体能力，使表现力提升不依赖外部付费生成服务。
- 将内容效果、受众反馈和纠错结果回流到选题、提示词和栏目规则，但不以平台流量替代事实质量和版权边界。
- 通过 Web 内置 Codex、隔离会话和自动交付链，把单机工具演进为可受控部署和恢复的平台。

### 2.5 范围内

- 科技资讯源的发现、采集、归一化、去重、分类、排序、证据保存和人工补录。
- 从来源证据到结构化口播稿、镜头意图、引用清单和发布文案的编辑过程。
- 来源页面视觉、HTML 动效、演示文稿、配音、字幕、封面和成片的本地生产。
- YAML-first 配置、TypeScript CLI、异步作业、工件契约、日志、费用、检查和 Web 可视控制面。
- 发布候选的技术验收、人工复核入口、时间轴、来源目录、AI 参与披露和版本留存。
- Web 内置 Codex、隔离凭据、会话恢复、YAML-first Kubernetes 和自动交付目标能力。
- 生成内容使用暖色圆角主题，Web 工厂、控制台和内置终端使用工业风、直角或极小倒角主题。

### 2.6 范围外

- 自动绕过登录、付费墙、访问控制、站点条款或版权限制抓取第三方内容。
- 复制既有自媒体的原文、配音、字幕、封面、音乐、品牌视觉或受保护媒体资产。
- 自动替代编辑者完成事实、法律、版权、平台规则和最终发布责任判断。
- 以某个仓库、框架、CLI、模型或服务名称作为长期能力域；实现可以替换，需求边界保持稳定。
- 社交平台账号托管、自动互动、广告投放、商业结算和未经审批的自动公开发布。
- 向 Web 终端或 Codex Agent 提供 Kubernetes、kubeconfig、ServiceAccount 或宿主机控制权限。
- 单次抓取故障、一次渲染、一个作业日志或阶段性样片流水账；这些属于执行证据，不属于 L0 稳定需求。

## 3. 术语表

| 术语 | 定义 |
| --- | --- |
| 智媒工厂 | 从可信科技资讯到可发布媒体候选及配套发布材料的本地优先生产系统。 |
| 期次 | 一次独立内容生产单元，具有稳定标识、标题、期数、报道日期、输入、工件和作业记录。 |
| 来源项 | 经过归一化的资讯记录，保留标题、链接、日期、摘要、来源身份、角色、信任层级和分类。 |
| 一手来源 | 由产品、项目、公司、机构或作者团队直接发布的公告、发布说明、论文或仓库记录。 |
| 发现来源 | 用于发现线索和提供编辑背景的媒体、社区或聚合入口，不替代可获得的一手事实。 |
| 来源闭环 | 口播中的可核验事实能够解析到期次来源项，并在引用与发布材料中保持同一归因。 |
| 内容单元 | 开场与大纲、单条资讯或参考来源等可独立配音并映射场景的结构化文稿单元。 |
| 场景 | 具有独立画面、时间范围、章节标题和动效状态的视频组成单元。 |
| 工件 | 流水线生成并登记的来源、文稿、视觉、音频、字幕、视频、报告或发布文本文件。 |
| 发布候选 | 已通过自动技术检查但仍需人工事实、版权、听感和平台规则复核的成片及配套材料。 |
| 发布包 | 目标能力中与同一期次、内容版本和工件哈希绑定的候选媒体、引用、费用、检查和批准材料集合。 |
| 平台交付 | 将应用、内置 Codex、隔离会话和凭据通过受控 Kubernetes 与自动链交付到公网原入口的能力域。 |
| owning YAML | 对可调业务事实具有唯一所有权的 YAML 配置；代码只负责校验、调度和渲染。 |
| 规格版本 | 用于区分规格语义变更的稳定标识。 |

## 4. 系统边界和接口

本规格把智媒工厂作为完整内容生产系统看待。本章只描述外部输入、输出和责任边界，不把内部项目治理当作产品能力。

| 边界项 | 内容 |
| --- | --- |
| 外部使用者 | 技术内容编辑、栏目运营者、媒体制作者、审核者和受控自动化任务。 |
| 外部输入 | 来源配置、公开 Feed/API/网页、人工来源、期次元数据、栏目规则、授权 LLM 凭据、本地模型、GitHub 提交、部署配置和发布约束。 |
| 受控资源 | 期次工件、作业记录、日志、用量、后端容器、Codex 会话、会话 PVC、GitOps 目标、K8s 工作负载和验收报告。 |
| 外部输出 | MP4、WAV、SRT/ASS、PPTX、HTML/PNG、封面、引用目录、评论区时间轴、成本估算、检查报告和可视化状态。 |
| 用户接口 | TypeScript CLI、同源 HTTP API、Web 编辑台和可直接复核的文件工件。 |
| 网络接口 | 公开 RSS/Atom/API/网页、可选 OpenAI 兼容 LLM 端点、GitHub 交付入口和受控公网 IPv4。 |
| 系统边界 | 系统负责生产、追溯、技术检查与目标应用交付；编辑者负责最终事实、版权、表达、平台合规和发布决定。 |

## 5. 内部模块分工与规格索引

L1 按完成标准划分为七个稳定能力域。仓库、框架、模型、命令和运行端口只是实现引用，不构成 L1。

| 编号 | 内部模块 | 规格文档 | 主责边界 |
| --- | --- | --- | --- |
| PJ2026-0201 | 资讯源 | [资讯源规格](PJ2026-0201-information-sources.md) | 来源、证据、分类和版权边界 |
| PJ2026-0202 | 编辑策划 | [编辑策划规格](PJ2026-0202-editorial-planning.md) | 选题、核验、叙事和引用 |
| PJ2026-0203 | 视觉制作 | [视觉制作规格](PJ2026-0203-visual-production.md) | 来源视觉、场景、动效和封面 |
| PJ2026-0204 | 音频成片 | [音频成片规格](PJ2026-0204-audio-video-production.md) | 配音、字幕、时间线和成片 |
| PJ2026-0205 | 流水线平台 | [流水线平台规格](PJ2026-0205-pipeline-platform.md) | 配置、调度、作业、工件和控制面 |
| PJ2026-0206 | 发布运营 | [发布运营规格](PJ2026-0206-publishing-operations.md) | 发布候选、复核、归档和反馈 |
| PJ2026-0207 | 平台交付 | [平台交付规格](PJ2026-0207-platform-delivery.md) | 隔离运行、自动交付和运行验收 |

上下游关系如下：

- [资讯源](PJ2026-0201-information-sources.md)接收公开来源和编辑者配置，支撑编辑策划、视觉制作和发布运营。
- [编辑策划](PJ2026-0202-editorial-planning.md)依赖资讯源，支撑视觉制作、音频成片和发布运营。
- [视觉制作](PJ2026-0203-visual-production.md)依赖资讯源和编辑策划，支撑音频成片和发布运营。
- [音频成片](PJ2026-0204-audio-video-production.md)依赖编辑策划和视觉制作，支撑发布运营。
- [流水线平台](PJ2026-0205-pipeline-platform.md)承载全部生产能力域的步骤契约和可观察运行。
- [发布运营](PJ2026-0206-publishing-operations.md)汇总全部内容生产结果，面向发布者和后续栏目改进。
- [平台交付](PJ2026-0207-platform-delivery.md)承载流水线平台与发布运营的受控运行面和自动交付。

### 5.1 目标架构图

```mermaid
flowchart LR
  subgraph External[外部输入]
    Feeds[公开 Feed / API / 网页]
    Manual[人工来源与编辑决定]
    Models[授权 LLM 与本地模型]
    Git[GitHub / mirror / GitOps]
  end
  subgraph Factory[智媒工厂]
    Sources[资讯源]
    Editorial[编辑策划]
    Visual[视觉制作]
    Audio[音频成片]
    Platform[流水线平台]
    Publish[发布运营]
    Delivery[平台交付]
  end
  subgraph Outputs[外部输出]
    Media[视频 / 音频 / 字幕 / PPT]
    Release[时间轴 / 来源 / 披露 / 验收]
    Console[CLI / API / Web 编辑台]
    Terminal[公网 IP / 内置 Codex]
  end
  Feeds --> Sources
  Manual --> Sources
  Manual --> Editorial
  Models --> Editorial
  Sources --> Editorial
  Sources --> Visual
  Editorial --> Visual
  Editorial --> Audio
  Visual --> Audio
  Audio --> Publish
  Sources --> Publish
  Editorial --> Publish
  Platform -.调度与观测.-> Sources
  Platform -.调度与观测.-> Editorial
  Platform -.调度与观测.-> Visual
  Platform -.调度与观测.-> Audio
  Platform -.调度与观测.-> Publish
  Audio --> Media
  Publish --> Release
  Platform --> Console
  Git --> Delivery
  Delivery -.承载与验收.-> Platform
  Delivery -.承载与验收.-> Publish
  Delivery --> Terminal
```

目标架构保持职责分离：

- 各生产能力域定义自身结果是否正确；
- 流水线平台负责按同一契约调度、记录和展示；
- 流水线平台不重新定义选题、视觉、音频或发布事实。
- 平台交付负责应用运行面和自动交付，不把 Kubernetes 权限交给内容 Agent。

### 5.2 目标数据流图

```mermaid
flowchart TD
  GitSource[GitHub 提交] --> DeliveryChain[mirror / PaC / Tekton / GitOps / Argo]
  DeliveryChain --> Runtime[Kubernetes 应用运行面]
  Runtime --> Config
  Config[owning YAML 与期次元数据] --> Collect[采集与人工补录]
  Network[公开来源] --> Collect
  Collect --> SourceManifest[来源清单与原始快照]
  SourceManifest --> Select[分类、排序、选题与事实核验]
  Select --> Script[结构化文稿与来源引用]
  Script --> SourceVisuals[来源页面视觉]
  Script --> Voice[分段配音]
  SourceManifest --> SourceVisuals
  SourceVisuals --> Scenes[HTML 场景 / PNG / PPTX]
  Voice --> AudioTimeline[WAV 与句级时间线]
  Script --> AudioTimeline
  AudioTimeline --> Subtitles[SRT / ASS]
  Scenes --> Render[确定性画面渲染]
  Subtitles --> Render
  AudioTimeline --> Render
  Render --> Candidate[MP4 / 封面 / 场景时间线]
  Candidate --> Inspect[自动技术检查]
  SourceManifest --> Inspect
  Script --> Inspect
  Inspect --> PublishPack[目标发布包组合]
  Candidate --> Comment[真实时间轴与评论区来源]
  Comment --> PublishPack
  PublishPack --> PublicEntry[公网 IP 预览与人工复核]
  Runtime --> PublicEntry
```

数据流中的每个正式步骤必须：

- 读取已登记上游工件；
- 输出新工件；
- 在上游缺失或不合法时明确失败；
- 不得使用隐藏默认值、旧期次文件或伪造输入补成成功。

图中的自动交付、发布包和持久化人工复核都属于终态必需能力。

### 5.3 关键时序图

```mermaid
sequenceDiagram
  participant G as GitHub / GitOps
  participant D as 自动交付链
  participant K as Kubernetes 运行面
  participant E as 编辑者
  participant C as CLI / Web
  participant P as 流水线平台
  participant S as 生产步骤
  participant A as 期次工件
  participant R as 发布复核
  G->>D: 提交受审查变更
  D->>K: 构建、协调并执行公网验收
  K-->>D: 返回版本、健康与隔离证据
  E->>C: 从公网 IP 打开 Web、CLI 或内置终端
  E->>C: 创建期次并选择单步或完整流水线
  C->>P: 提交异步作业
  P-->>C: 返回 jobId
  loop 每个选中步骤
    P->>S: 传入期次、配置和取消信号
    S->>A: 读取已登记上游工件
    S->>A: 原子写入结果和清单
    S-->>P: 更新进度、日志和步骤结果
    C->>P: 查询状态、日志或结果
    P-->>C: 返回同一作业事实
  end
  P-->>C: 作业终态与工件索引
  E->>R: 复核事实、版权、听感和平台规则
  R->>A: 目标能力记录批准、退回或重跑决定
  R-->>E: 发布候选或明确阻塞项
```

长任务必须异步执行：

- CLI 和 Web 提交后立即获得作业标识；
- 编辑者通过状态、日志和工件观察进展；
- 重试创建新作业并保留旧证据；
- 重试不能覆盖失败历史。

自动交付、内置终端和批准记录都属于终态关键时序，不得以部分时序成功宣称整期或整个平台达成。

## 6. 全局原子需求

### 6.1 SMF-L0-REQ-001 可信资讯底座

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-001 | 可信资讯底座 | [资讯源](PJ2026-0201-information-sources.md) |

智媒工厂应建立可追溯的科技资讯底座，使每条进入节目候选池的事实都有来源身份、时间、角色、信任层级、分类、证据摘要和原始链接。

职责边界如下：

- 资讯源负责发现、归一化、去重、分类和证据边界；
- 编辑策划决定是否采用以及如何表达；
- 视觉制作只在允许范围内生成来源视觉；
- 发布运营保留最终引用；
- 任何下游模块不得把发现媒体改写为一手发布者。

完成标准是：从任一成片资讯可反向定位到期次来源项和公开链接；一手、媒体、社区、预印本和优惠信息的状态边界不会在下游丢失。

### 6.2 SMF-L0-REQ-002 有效编辑叙事

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-002 | 有效编辑叙事 | [编辑策划](PJ2026-0202-editorial-planning.md) |

智媒工厂应把来源证据转化为栏目文稿，并满足：

- 信息密度高；
- 口语自然；
- 对技术受众有实际价值；
- 保持开场与大纲、逐条故事和参考来源的稳定结构。

编辑策划负责：

- 选题；
- 事实边界；
- 术语补充；
- 媒体归因；
- 状态限定；
- 叙事节奏。

下游模块只能消费结构化内容，不能以画面或配音修饰掩盖证据不足和文稿空泛。

完成标准如下：

- 每条资讯说清“发生了什么、由谁发布、对象有什么功能、对受众有什么价值”；
- 关键事实能够通过来源引用复核；
- 事实边界在相关表述处自然说明；
- 不使用机械的局限、约束或验证建议收尾。

### 6.3 SMF-L0-REQ-003 动态视觉表达

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-003 | 动态视觉表达 | [视觉制作](PJ2026-0203-visual-production.md) |

智媒工厂应提供可配置、可追溯、适合科技资讯的动态视觉表达，使信息层级、来源画面、章节状态和叙事节奏在视频中一致呈现。

本需求只约束生成的 HTML、PPT、PNG、封面和视频画面，不约束 Web 工厂与控制台外观。

视觉制作负责：

- HTML 场景、来源页面滚动、演示文稿、预览图、章节进度和主题系统；
- 提供温暖、阳光、圆润且易读的默认视觉；
- 允许替换主题实现；
- 保持字幕安全区和内容可辨识性，不让装饰牺牲信息表达。

完成标准是：同一场景在指定绝对时间可确定性重现，画面来源可以追溯，九宫格式堆字、未经授权搬运和依赖在线 CDN 的生产场景不被接受。

### 6.4 SMF-L0-REQ-004 自然音频成片

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-004 | 自然音频成片 | [音频成片](PJ2026-0204-audio-video-production.md) |

智媒工厂应使用本地开源媒体能力把结构化文稿和场景合成为自然、同步、可重新配置的配音字幕成片。

音频成片负责：

- 语音规范化、分段推理、缓存、语速、停顿和响度；
- 字幕切分、场景时间线、编码和媒体检查；
- 在改变语速或声音参数时只重跑受影响步骤，不要求重新采集和写稿。

完成标准如下：

- 音频、字幕、场景和视频时间线在允许误差内一致；
- 媒体流、分辨率、响度、峰值和可解码性通过技术检查；
- 人工仍能识别并退回读音或表达问题。

### 6.5 SMF-L0-REQ-005 可调试生产平台

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-005 | 可调试生产平台 | [流水线平台](PJ2026-0205-pipeline-platform.md) |

智媒工厂应提供 YAML-first、CLI-first 的生产平台，使每个正式步骤可独立运行、观察、重试和复现，并由同一实现组合为完整流水线和 Web 可视流程。

流水线平台负责：

- 配置校验、步骤 DAG、异步作业、进度、日志、结果和取消；
- 工件索引、服务接口和可视控制面；
- 统计所有 LLM 尝试的 Token 与公开目录价估算；
- 不泄露 API key、凭据文件内容或敏感请求材料。

Web 工厂和控制台应采用工业风、紧凑高信息密度、直角或极小倒角的视觉语言，不复用生成内容的暖色大圆角主题。

完成标准是：编辑者能通过 CLI 单步定位问题，通过 Web 查看同一作业事实；失败、取消、重试和费用可见；无隐藏默认配置或付费媒体生成服务依赖。

### 6.6 SMF-L0-REQ-006 受控发布闭环

| 编号 | 短名 | 主责模块 |
| --- | --- | --- |
| SMF-L0-REQ-006 | 受控发布闭环 | [发布运营](PJ2026-0206-publishing-operations.md) |

智媒工厂应把技术通过的成片组织为可人工批准、可退回和可追溯的发布候选，并生成与最终视频一致的时间轴、来源、AI 参与披露和复核材料。

发布运营负责：

- 最终工件组合、评论区文本、技术检查结果解释和人工清单；
- 版本归档和预览入口；
- 区分自动检查通过与事实、版权、法律或平台合规批准；
- 阻止未完成必要人工复核的候选被标记为已发布。

完成标准是：发布者无需手工重新计算章节起点或整理来源链接，且可以明确看到批准前仍需承担的检查责任和任何阻塞项。

### 6.7 SMF-L0-REQ-007 隔离自动交付

| 编号 | 短名 | 主责模块 | 关联模块 |
| --- | --- | --- | --- |
| SMF-L0-REQ-007 | 隔离自动交付 | [平台交付](PJ2026-0207-platform-delivery.md) | [流水线](PJ2026-0205-pipeline-platform.md)、[发布](PJ2026-0206-publishing-operations.md) |

智媒工厂应提供可复现、最小权限和可自动验收的平台交付。

编辑者应能通过公网 IP 的 Web 内置 Codex 终端进入以下环境：

- 与后端版本一致的源码；
- CLI；
- 受限 Agent 工具。

平台交付负责：

- 使用 PVC 保存 `~/.codex/sessions` 与 supervisor 恢复元数据，不承诺持久化源码工作区；
- 通过 YAML-first `sourceRef` 分离投影后端 Token 与 Codex 模型配置；
- 确保终端没有 ServiceAccount token、kubeconfig、Kubernetes API 或宿主机权限；
- 以 YAML-first Kubernetes 暴露公网 IPv4 原入口；
- 建立 GitHub、mirror、PaC、Tekton、GitOps、Argo 和运行验收自动链。

完成标准包括：

- 通过公网 IP 验证 Web、API 和内置终端；
- 验证版本一致性、会话重启恢复和权限负面边界；
- 从运行版本追溯到提交、镜像摘要、GitOps revision 和部署后验收结果。

## 7. 过程控制

### 7.1 SPEC-first 和层级规则

- 改变项目使命、L1 能力域、全局数据流或全局验收口径时，先更新本 L0 规格。
- 改变某个能力域的稳定输入、输出、职责或完成标准时，先更新对应 L1 规格。
- 单次作业、一个缺陷、一次样片、一次部署或一次文档收口不进入 L0/L1 需求正文。
- 新增能力先按完成标准确定唯一主责 L1；跨域关系通过同目录相对链接表达，不复制同一需求。

### 7.2 追溯契约

- 每项全局能力应能追溯到唯一主责 L1 和必要的关联 L1。
- 每一期正式工件应能追溯到来源、结构化内容、步骤结果、配置引用摘要和发布版本。
- 自动生成文件、第三方文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。

### 7.3 验收和发布控制

- 能力验收优先使用原入口：
  - CLI 能力用 TypeScript CLI；
  - Web 能力用同源 Web/API；
  - 媒体能力用实际工件、播放器和媒体探测；
  - 发布材料用最终场景时间线和来源清单复核。
  - 平台交付用 YAML 选中的公网 IPv4、Web 内置终端、会话重启恢复和权限负面检查。
- 自动技术检查只决定“是否具备人工发布复核条件”，不决定“是否可以公开发布”。
- 发布前至少复核：
  - 事实、日期、数字和状态；
  - 来源角色和归因；
  - 版权、授权和 AI 参与披露；
  - 读音、字幕、画面和时间轴；
  - 平台规则、地区限制和活动期限。

### 7.4 配置、Secret 和成本控制

- 可调业务事实由 owning YAML 管理，代码不保留第二套静默默认值。
- LLM 凭据只在运行时从用户授权位置读取：
  - 日志、工件、Web 和费用摘要不得输出 API key；
  - 模板模式必须可以在不读取 LLM 凭据时运行。
- 目标运行面的凭据必须分离投影：
  - 后端 API Token 使用 YAML-first `sourceRef` 投影到 `~/.env/TOKEN`；
  - Codex 模型 API key 和配置从受控 `~/.codex/*.pika` 源路径投影到运行时 Codex home；
  - 两类凭据使用不同 `sourceRef` 和 `targetKey`，状态只披露 presence 与 fingerprint。
- 所有 LLM 请求尝试都应记录 Token 用量状态和费用估算状态：
  - 成功、被质量门拒绝和请求失败均不能从统计中静默消失；
  - 公开目录价估算必须标明来源、抓取时间、币种和“非实际账单”边界；
  - 未知模型或缺失用量不得按零费用处理。

### 7.5 偏离判定

以下情况属于偏离风险，应停止扩大实现并回到对应规格重新归类：

- 只增加来源数量，却没有改善证据、分类、选题或发布价值。
- 只追求视觉特效、语音模型或编码参数，却没有可感知的内容完成标准。
- 以 Web 页面、CLI 命令、仓库或模型名称替代能力域定义。
- 绕过单步工件契约，通过临时脚本或旧期次文件拼出成功结果。
- 自动公开发布，但没有人工批准、版权检查、平台规则检查和回退路径。
- 通过手工主机进程、SSH、临时端口或直接 Kubernetes 权限替代目标平台交付链。
- 增加监控或统计，却没有下游编辑、质量或成本决策使用新信号。

### 7.6 规格回写

- 稳定需求、边界或验收变化回写对应 L1；影响多个 L1 时同时更新本 L0 索引和全局数据流。
- 执行态内容不写入稳定规格正文：
  - 实现状态和阶段基线；
  - 阻塞和实现细节；
  - 源码路径、作业编号、日志、截图和长证据。
- 执行态内容进入阶段报告、任务报告、偏离记录或执行 issue。
- 规格间只使用本目录内的相对链接；不在规格正文保存执行 issue 或代码审查链接。
