From 5431d649149728837b7c8b4725be981c53511fb4 Mon Sep 17 00:00:00 2001 From: AgentRun Codex Date: Mon, 13 Jul 2026 07:15:24 +0000 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=94=B6=E5=8F=A3=20PJ2026-02=20?= =?UTF-8?q?=E7=BB=88=E6=80=81=E8=A7=84=E6=A0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../specs/PJ2026-02-smart-media-factory.md | 89 ++++++++++--------- .../specs/PJ2026-0201-information-sources.md | 16 ++-- .../specs/PJ2026-0202-editorial-planning.md | 16 ++-- .../specs/PJ2026-0203-visual-production.md | 18 ++-- .../PJ2026-0204-audio-video-production.md | 16 ++-- .../specs/PJ2026-0205-pipeline-platform.md | 29 +++--- .../PJ2026-0206-publishing-operations.md | 16 ++-- .../specs/PJ2026-0207-platform-delivery.md | 62 ++++++------- ...c-ieee-29148-requirements-spec-template.md | 28 ++++-- 9 files changed, 146 insertions(+), 144 deletions(-) diff --git a/project-management/PJ2026-02/specs/PJ2026-02-smart-media-factory.md b/project-management/PJ2026-02/specs/PJ2026-02-smart-media-factory.md index 15688863..a5d82bfd 100644 --- a/project-management/PJ2026-02/specs/PJ2026-02-smart-media-factory.md +++ b/project-management/PJ2026-02/specs/PJ2026-02-smart-media-factory.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义智媒工厂预期终态和七个 L1 能力域。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义智媒工厂预期终态和七个 L1 能力域。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 智媒工厂 | | 层级 | L0 总项目 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 规格治理索引 | 本文第 7 章 | @@ -84,7 +83,7 @@ - 七个 L1 必须分别满足原入口验收，才能宣称 L0 终态达成。 - 单机样片、一次成功作业、临时公网入口或部分步骤工件不能替代 L0 终态验收。 - 自动技术检查通过不能替代人工事实、版权、听感、平台规则和发布批准。 -- 当前状态、实现差距和一次性证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 执行态、实现差距和一次性证据只进入阶段报告、任务报告、偏离记录或执行 issue。 ### 2.4 扩展目标 @@ -132,7 +131,7 @@ | 发布包 | 目标能力中与同一期次、内容版本和工件哈希绑定的候选媒体、引用、费用、检查和批准材料集合。 | | 平台交付 | 将应用、内置 Codex、隔离会话和凭据通过受控 Kubernetes 与自动链交付到公网原入口的能力域。 | | owning YAML | 对可调业务事实具有唯一所有权的 YAML 配置；代码只负责校验、调度和渲染。 | -| 实现引用版本 | 后续源码变更用于声明其遵循哪一版规格语义的稳定标识。 | +| 规格版本 | 用于区分规格语义变更的稳定标识。 | ## 4. 系统边界和接口 @@ -152,15 +151,25 @@ L1 按完成标准划分为七个稳定能力域。仓库、框架、模型、命令和运行端口只是实现引用，不构成 L1。 -| 编号 | 内部模块 | 规格文档 | 主责边界 | 上游依赖 | 下游支撑 | -| --- | --- | --- | --- | --- | --- | -| PJ2026-0201 | 资讯源 | [PJ2026-0201 资讯源](PJ2026-0201-information-sources.md) | 来源发现、采集、证据、归一化、分类、排序和版权边界 | 公开来源、编辑者配置 | [编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | -| PJ2026-0202 | 编辑策划 | [PJ2026-0202 编辑策划](PJ2026-0202-editorial-planning.md) | 选题、核验、叙事、口播、来源引用和栏目结构 | [资讯源](PJ2026-0201-information-sources.md) | [视觉制作](PJ2026-0203-visual-production.md)、[音频成片](PJ2026-0204-audio-video-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | -| PJ2026-0203 | 视觉制作 | [PJ2026-0203 视觉制作](PJ2026-0203-visual-production.md) | 来源视觉、场景设计、HTML 动效、演示文稿、进度导航和封面画面 | [资讯源](PJ2026-0201-information-sources.md)、[编辑策划](PJ2026-0202-editorial-planning.md) | [音频成片](PJ2026-0204-audio-video-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | -| PJ2026-0204 | 音频成片 | [PJ2026-0204 音频成片](PJ2026-0204-audio-video-production.md) | 本地配音、时间线、字幕、音视频合成和媒体质量 | [编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md) | [发布运营](PJ2026-0206-publishing-operations.md) | -| PJ2026-0205 | 流水线平台 | [PJ2026-0205 流水线平台](PJ2026-0205-pipeline-platform.md) | YAML 配置、CLI 调度、异步作业、可观测性、工件契约、用量计费和 Web 控制面 | 全部生产能力域的步骤契约 | 全部 L1 的可执行、可调试和可观察运行 | -| PJ2026-0206 | 发布运营 | [PJ2026-0206 发布运营](PJ2026-0206-publishing-operations.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-0207 | 平台交付 | [PJ2026-0207 平台交付](PJ2026-0207-platform-delivery.md) | Web Codex、隔离会话与凭据、K8s、公网 IP、自动交付和运行验收 | [流水线平台](PJ2026-0205-pipeline-platform.md)、[发布运营](PJ2026-0206-publishing-operations.md) | 受控运行面、编辑者和交付自动化 | +| 编号 | 内部模块 | 规格文档 | 主责边界 | +| --- | --- | --- | --- | +| 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 目标架构图 @@ -299,9 +308,9 @@ sequenceDiagram ### 6.1 SMF-L0-REQ-001 可信资讯底座 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-001 | 可信资讯底座 | [PJ2026-0201 资讯源](PJ2026-0201-information-sources.md) | [编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-001 | 可信资讯底座 | [资讯源](PJ2026-0201-information-sources.md) | 智媒工厂应建立可追溯的科技资讯底座，使每条进入节目候选池的事实都有来源身份、时间、角色、信任层级、分类、证据摘要和原始链接。 @@ -317,9 +326,9 @@ sequenceDiagram ### 6.2 SMF-L0-REQ-002 有效编辑叙事 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-002 | 有效编辑叙事 | [PJ2026-0202 编辑策划](PJ2026-0202-editorial-planning.md) | [资讯源](PJ2026-0201-information-sources.md)、[视觉制作](PJ2026-0203-visual-production.md)、[音频成片](PJ2026-0204-audio-video-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-002 | 有效编辑叙事 | [编辑策划](PJ2026-0202-editorial-planning.md) | 智媒工厂应把来源证据转化为栏目文稿，并满足： @@ -339,9 +348,9 @@ sequenceDiagram ### 6.3 SMF-L0-REQ-003 动态视觉表达 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-003 | 动态视觉表达 | [PJ2026-0203 视觉制作](PJ2026-0203-visual-production.md) | [资讯源](PJ2026-0201-information-sources.md)、[编辑策划](PJ2026-0202-editorial-planning.md)、[音频成片](PJ2026-0204-audio-video-production.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-003 | 动态视觉表达 | [视觉制作](PJ2026-0203-visual-production.md) | 智媒工厂应提供可配置、可追溯、适合科技资讯的动态视觉表达，使信息层级、来源画面、章节状态和叙事节奏在视频中一致呈现。 @@ -358,9 +367,9 @@ sequenceDiagram ### 6.4 SMF-L0-REQ-004 自然音频成片 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-004 | 自然音频成片 | [PJ2026-0204 音频成片](PJ2026-0204-audio-video-production.md) | [编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-004 | 自然音频成片 | [音频成片](PJ2026-0204-audio-video-production.md) | 智媒工厂应使用本地开源媒体能力把结构化文稿和场景合成为自然、同步、可重新配置的配音字幕成片。 @@ -374,9 +383,9 @@ sequenceDiagram ### 6.5 SMF-L0-REQ-005 可调试生产平台 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-005 | 可调试生产平台 | [PJ2026-0205 流水线平台](PJ2026-0205-pipeline-platform.md) | [资讯源](PJ2026-0201-information-sources.md)、[编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md)、[音频成片](PJ2026-0204-audio-video-production.md)、[发布运营](PJ2026-0206-publishing-operations.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-005 | 可调试生产平台 | [流水线平台](PJ2026-0205-pipeline-platform.md) | 智媒工厂应提供 YAML-first、CLI-first 的生产平台，使每个正式步骤可独立运行、观察、重试和复现，并由同一实现组合为完整流水线和 Web 可视流程。 @@ -393,9 +402,9 @@ Web 工厂和控制台应采用工业风、紧凑高信息密度、直角或极 ### 6.6 SMF-L0-REQ-006 受控发布闭环 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| SMF-L0-REQ-006 | 受控发布闭环 | [PJ2026-0206 发布运营](PJ2026-0206-publishing-operations.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) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| SMF-L0-REQ-006 | 受控发布闭环 | [发布运营](PJ2026-0206-publishing-operations.md) | 智媒工厂应把技术通过的成片组织为可人工批准、可退回和可追溯的发布候选，并生成与最终视频一致的时间轴、来源、AI 参与披露和复核材料。 @@ -439,15 +448,11 @@ Web 工厂和控制台应采用工业风、紧凑高信息密度、直角或极 - 单次作业、一个缺陷、一次样片、一次部署或一次文档收口不进入 L0/L1 需求正文。 - 新增能力先按完成标准确定唯一主责 L1；跨域关系通过同目录相对链接表达，不复制同一需求。 -### 7.2 实现引用和追溯 +### 7.2 追溯契约 -- 本规格实现引用版本为 `draft-2026-07-13-p0`。 -- 相关源码文件应在可承载注释的文件头标记： - - `SPEC: PJ2026-02 智媒工厂 draft-2026-07-13-p0`； - - 同时标记主责 L1 的编号、短名和实现引用版本。 -- 自动生成文件、第三方文件、纯配置、锁文件和二进制工件可以不加文件头： - - 其生成器、校验器或 owning YAML 入口必须能追溯到本规格； - - 期次工件必须能追溯到作业记录、步骤结果和配置引用摘要。 +- 每项全局能力应能追溯到唯一主责 L1 和必要的关联 L1。 +- 每一期正式工件应能追溯到来源、结构化内容、步骤结果、配置引用摘要和发布版本。 +- 自动生成文件、第三方文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.3 验收和发布控制 @@ -500,4 +505,4 @@ Web 工厂和控制台应采用工业风、紧凑高信息密度、直角或极 - 阻塞和实现细节； - 源码路径、作业编号、日志、截图和长证据。 - 执行态内容进入阶段报告、任务报告、偏离记录或执行 issue。 -- 规格间只使用本目录内的相对链接；不在规格正文保存 GitHub issue 或 PR 链接。 +- 规格间只使用本目录内的相对链接；不在规格正文保存执行 issue 或代码审查链接。 diff --git a/project-management/PJ2026-02/specs/PJ2026-0201-information-sources.md b/project-management/PJ2026-02/specs/PJ2026-0201-information-sources.md index c7014941..ab062795 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0201-information-sources.md +++ b/project-management/PJ2026-02/specs/PJ2026-0201-information-sources.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义公开 Feed、Hacker News、人工来源和期次来源清单的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义公开 Feed、Hacker News、人工来源和期次来源清单的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 资讯源 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -306,13 +305,10 @@ sequenceDiagram ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0201 资讯源 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个候选来源应能追溯到来源目录、采集响应、规范链接、来源角色和期次采用决策。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0202-editorial-planning.md b/project-management/PJ2026-02/specs/PJ2026-0202-editorial-planning.md index 15455fac..c18ba819 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0202-editorial-planning.md +++ b/project-management/PJ2026-02/specs/PJ2026-0202-editorial-planning.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义结构化文稿、质量门、专业对象补充和来源闭环的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义结构化文稿、质量门、专业对象补充和来源闭环的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 编辑策划 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -314,13 +313,10 @@ sequenceDiagram ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0202 编辑策划 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每条结构化内容应能追溯到采用来源、事实锚点、来源角色、编辑决策和下游故事身份。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0203-visual-production.md b/project-management/PJ2026-02/specs/PJ2026-0203-visual-production.md index 6da24f33..ce4e1edc 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0203-visual-production.md +++ b/project-management/PJ2026-02/specs/PJ2026-0203-visual-production.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义来源页面视觉、HTML 动效、阶段导航、PNG 和 PPTX 的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义来源页面视觉、HTML 动效、阶段导航、PNG 和 PPTX 的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 视觉制作 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -313,7 +312,7 @@ LLM 输出应包含： 底部总览颜色应满足： - 过去、当前和未来阶段使用具有足够对比度的实色； -- 当前阶段和已完成阶段在典型视频压缩和普通显示器上仍可清楚区分； +- 活动阶段和结束阶段在典型视频压缩和普通显示器上仍可清楚区分； - 不使用过浅底色。 场景数量和标题来自当期场景模型。HTML 预览和 Web 编辑台可以点击章节跳转，成片中的导航则以高亮和进度提供同一视觉语义。 @@ -363,13 +362,10 @@ LLM 输出应包含： ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0203 视觉制作 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个视觉场景应能追溯到故事身份、来源许可、画面策略、视觉计划和最终时间线。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0204-audio-video-production.md b/project-management/PJ2026-02/specs/PJ2026-0204-audio-video-production.md index 440f890f..4f409d8d 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0204-audio-video-production.md +++ b/project-management/PJ2026-02/specs/PJ2026-0204-audio-video-production.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义本地配音、可调语速、字幕时间线、成片和自动检查的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义本地配音、可调语速、字幕时间线、成片和自动检查的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 音频成片 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -288,13 +287,10 @@ sequenceDiagram ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0204 音频成片 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个音频、字幕和视频工件应能追溯到配音单元、场景时间线、媒体配置和候选版本。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0205-pipeline-platform.md b/project-management/PJ2026-02/specs/PJ2026-0205-pipeline-platform.md index 4eb19378..3f135c6c 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0205-pipeline-platform.md +++ b/project-management/PJ2026-02/specs/PJ2026-0205-pipeline-platform.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义 YAML-first、TypeScript CLI、异步作业、用量计费和 Web 编辑台的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义 YAML-first、TypeScript CLI、异步作业、用量计费和 Web 编辑台的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 流水线平台 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -171,9 +170,16 @@ sequenceDiagram ### 6.1 PLATFORM-L1-REQ-001 YAML-first 配置 -| 编号 | 短名 | 主责模块 | 关联模块 | -| --- | --- | --- | --- | -| PLATFORM-L1-REQ-001 | 配置治理 | PJ2026-020501 配置治理 | [资讯源](PJ2026-0201-information-sources.md)、[编辑策划](PJ2026-0202-editorial-planning.md)、[视觉制作](PJ2026-0203-visual-production.md)、[音频成片](PJ2026-0204-audio-video-production.md) | +| 编号 | 短名 | 主责模块 | +| --- | --- | --- | +| PLATFORM-L1-REQ-001 | 配置治理 | PJ2026-020501 配置治理 | + +关联模块包括： + +- [资讯源](PJ2026-0201-information-sources.md)； +- [编辑策划](PJ2026-0202-editorial-planning.md)； +- [视觉制作](PJ2026-0203-visual-production.md)； +- [音频成片](PJ2026-0204-audio-video-production.md)。 系统应以一个配置入口通过显式 `configRefs` 引用各职责 owning YAML，并在运行前校验版本、类型、必填字段、枚举、数值范围、路径和引用摘要。 @@ -313,13 +319,10 @@ Web 应提供视觉计划审查入口。 ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0205 流水线平台 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个步骤、作业、尝试、用量记录和正式工件应能追溯到期次、配置引用摘要和上游结果。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0206-publishing-operations.md b/project-management/PJ2026-02/specs/PJ2026-0206-publishing-operations.md index b7eb0d43..8a911b0f 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0206-publishing-operations.md +++ b/project-management/PJ2026-02/specs/PJ2026-0206-publishing-operations.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义技术检查、真实章节时间轴、评论区来源和公网预览的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义技术检查、真实章节时间轴、评论区来源和公网预览的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 发布运营 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -295,13 +294,10 @@ sequenceDiagram ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0206 发布运营 draft-2026-07-13-p0`。 -- 自动生成文件、纯配置、锁文件和二进制工件可以不加文件头： - - 对应生成器、校验器或 owning YAML 入口必须能追溯到本规格。 -- 实现状态、源码路径、期次工件和运行证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个发布候选应能追溯到成片版本、场景时间线、来源目录、检查结果、批准记录和发布版本。 +- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。 ### 7.2 原入口验收 diff --git a/project-management/PJ2026-02/specs/PJ2026-0207-platform-delivery.md b/project-management/PJ2026-02/specs/PJ2026-0207-platform-delivery.md index 672160ff..f227673f 100644 --- a/project-management/PJ2026-02/specs/PJ2026-0207-platform-delivery.md +++ b/project-management/PJ2026-02/specs/PJ2026-0207-platform-delivery.md @@ -2,9 +2,9 @@ ## 修改历史 -| 版本 | 对应 commit id | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | 2fdadce8 | 2026-07-13 | 定义 Web 内置 Codex、隔离凭据、受控 K8s 部署、自动交付和运行验收的目标能力。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | 2026-07-13 | 定义 Web 内置 Codex、隔离凭据、受控 K8s 部署、自动交付和运行验收的目标能力。 | ## 正文 @@ -18,7 +18,6 @@ | 短名 | 平台交付 | | 层级 | L1 方向 | | 规格状态 | 已生效 | -| 实现引用版本 | draft-2026-07-13-p0 | | 需求规格模板 | [ISO/IEC/IEEE 29148 需求规格模板](../../templates/iso-iec-ieee-29148-requirements-spec-template.md) | | 上级规格 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) | | 规格治理索引 | [PJ2026-02 智媒工厂总规格](PJ2026-02-smart-media-factory.md) 第 7 章 | @@ -160,7 +159,7 @@ flowchart LR ```mermaid flowchart TD - Commit[GitHub 提交] --> Sync[mirror 同步] + SourceVersion[GitHub 交付源版本] --> Sync[mirror 同步] Sync --> Build[PaC 触发 Tekton] Build --> Test[源码、CLI 与镜像验证] Test --> Digest[不可变镜像摘要] @@ -201,7 +200,7 @@ sequenceDiagram participant K as Kubernetes participant V as 运行验收 G->>M: 推送受审查提交 - M->>T: 触发 commit-pinned PipelineRun + M->>T: 触发交付源版本固定的 PipelineRun T->>T: 校验源码、CLI、镜像和配置 T->>R: 发布不可变镜像摘要 T->>O: 提交摘要固定的目标配置 @@ -285,7 +284,13 @@ sequenceDiagram | --- | --- | --- | --- | | DELIVERY-L1-REQ-002 | Agent 工具 | PJ2026-020702 Agent 工具 | [流水线平台](PJ2026-0205-pipeline-platform.md)、[发布运营](PJ2026-0206-publishing-operations.md) | -后端容器镜像应包含与部署 commit 一致的智媒工厂源码、TypeScript CLI、运行依赖和必要开源媒体工具，使 Codex 能在容器内执行正式单步、查看作业和复核工件。 +后端容器镜像应包含与部署交付源版本一致的智媒工厂源码和工具链： + +- TypeScript CLI； +- 运行依赖； +- 必要开源媒体工具。 + +Codex 应能在容器内执行正式单步、查看作业和复核工件。 Agent 工具面只暴露 owning YAML 允许的： @@ -364,7 +369,7 @@ Kubernetes 工作负载应使用非 root 用户、只读根文件系统或等价 平台应建立以下自动交付链： - GitHub 提交进入受控 mirror； -- Pipeline as Code 触发 commit-pinned Tekton 流水线； +- Pipeline as Code 触发交付源版本固定的 Tekton 流水线； - Tekton 验证源码、CLI、配置和镜像； - 验证通过后发布不可变镜像摘要； - 更新 GitOps 目标； @@ -376,7 +381,16 @@ Kubernetes 工作负载应使用非 root 用户、只读根文件系统或等价 - Tekton 负责构建、检查和产物发布，不直接修改生产 Deployment； - Argo 只消费通过审核和验证的 GitOps 目标 revision。 -任何链路失败都应保留 commit、流水线、镜像摘要、GitOps revision、Argo 协调和运行验收之间的追溯关系。自动重试不能跳过失败门禁或回退到手工复制。 +任何链路失败都应保留以下对象之间的追溯关系： + +- 交付源版本； +- 流水线； +- 镜像摘要； +- GitOps revision； +- Argo 协调； +- 运行验收。 + +自动重试不能跳过失败门禁或回退到手工复制。 ### 6.6 DELIVERY-L1-REQ-006 公网原入口运行验收 @@ -401,40 +415,26 @@ Kubernetes 工作负载应使用非 root 用户、只读根文件系统或等价 - `~/.env/TOKEN` 只报告 `sourceRef`、`targetKey`、presence 和 fingerprint； - 运行时 Codex home 的 pika 配置只报告 `sourceRef`、`targetKey`、presence 和 fingerprint； - 两类凭据值都不出现在日志、规格、API、终端回显或工件； -- 运行 commit、镜像摘要、GitOps revision 和公网验收结果可以关联。 +- 运行交付源版本、镜像摘要、GitOps revision 和公网验收结果可以关联。 ## 7. 过程控制 -### 7.1 实现引用契约 +### 7.1 追溯契约 -- 相关源码文件应标记： - - `SPEC: PJ2026-0207 平台交付 draft-2026-07-13-p0`。 -- 纯 YAML、生成文件、锁文件和二进制镜像可以不加文件头： - - owning YAML、渲染器、容器构建入口和交付流水线必须能追溯到本规格。 -- 实现状态、源码路径、运行面、部署记录和验收证据只进入阶段报告、任务报告、偏离记录或执行 issue。 +- 每个部署版本应能追溯到交付源版本、镜像摘要、GitOps 目标、运行版本和验收结论。 +- 纯 YAML、生成文件、锁文件和二进制镜像应由 owning YAML、渲染器、容器构建入口或交付流水线提供稳定归属。 -### 7.2 实施顺序 - -- 先交付不含 Kubernetes 权限的后端容器、源码、CLI 和只读健康入口。 -- 再交付会话 PVC、Web 内置终端和 Codex 新建/恢复。 -- 随后接入两类 YAML-first 凭据 `sourceRef`： - - 后端 API `~/.env/TOKEN`； - - Codex `~/.codex/*.pika` 源到运行时 Codex home 的配置与认证文件。 -- 两类凭据隔离后，再接入权限负面检查和受限 Skill/API。 -- 完成 YAML-first Kubernetes、公网 IPv4 原入口和运行验收后，才接入自动交付链。 -- 最后用 GitHub、mirror、PaC、Tekton、GitOps 和 Argo 全链替换手工发布路径。 - -### 7.3 安全门禁 +### 7.2 安全门禁 - 发现 ServiceAccount token、kubeconfig、Kubernetes API 可达、hostPath、容器套接字或特权能力时，运行验收必须失败。 - 任一后端或 Codex 凭据值出现在日志、规格、终端、API、工件或镜像层时，必须停止交付并轮换受影响凭据。 - 终端不能直接调用部署控制面；需要部署动作时只能通过受控自动交付入口产生可审查变更。 - 受限 Skill/API 策略变化先更新 owning YAML；扩大集群或主机权限必须先更新本规格并重新评审边界。 -### 7.4 原入口验收 +### 7.3 原入口验收 - 使用公网 IPv4 打开 Web 并创建 Codex 终端。 -- 验证容器内源码 commit、CLI 版本和已部署镜像摘要一致。 +- 验证容器内交付源版本、CLI 版本和已部署镜像摘要一致。 - 通过终端执行配置计划、步骤列表或等价只读命令。 - 重启后端 Pod，验证同一 sessionId 和终端上下文依靠 PVC 中的 Codex sessions 与 supervisor 元数据恢复。 - 检查 `~/.env/TOKEN` 的 `sourceRef`、`targetKey`、presence、文件权限和 fingerprint。 @@ -442,7 +442,7 @@ Kubernetes 工作负载应使用非 root 用户、只读根文件系统或等价 - 不读取、保存或输出任一凭据值。 - 运行权限负面检查和 GitHub 到 Argo 的交付追溯检查。 -### 7.5 回写边界 +### 7.4 回写边界 - 内容步骤、作业、日志或工件契约问题回写 [流水线平台](PJ2026-0205-pipeline-platform.md)。 - 发布包、人工批准和平台发布材料问题回写 [发布运营](PJ2026-0206-publishing-operations.md)。 diff --git a/project-management/templates/iso-iec-ieee-29148-requirements-spec-template.md b/project-management/templates/iso-iec-ieee-29148-requirements-spec-template.md index 19466694..d07ab737 100644 --- a/project-management/templates/iso-iec-ieee-29148-requirements-spec-template.md +++ b/project-management/templates/iso-iec-ieee-29148-requirements-spec-template.md @@ -2,7 +2,12 @@ ## 来源和定位 -本模板用于 UniDesk `project-management/` 下的 L0、L1、L2 需求规格文档。模板基线采用 ISO/IEC/IEEE 29148:2018 的需求工程分层思路，并结合 HWLAB 项目管理约束做轻量裁剪。 +本模板用于 UniDesk `project-management/` 下的 L0、L1、L2 需求规格文档。 + +模板基线包括： + +- ISO/IEC/IEEE 29148:2018 的需求工程分层思路； +- HWLAB 项目管理约束的轻量裁剪。 参考来源： @@ -33,8 +38,17 @@ - 已完成、未完成、当前阻塞或阶段差距； - 源码路径、commit、PR、作业、日志、截图、样片或一次性证据。 - 执行态进入阶段报告、任务报告、偏离记录或 GitHub issue，并从这些载体引用 SPEC。 -- 每条原子需求使用独立小节。信息表使用横向表格且只放短元数据，推荐包含编号、短名、主责模块和关联模块；主责模块填写下一层主责单元，L0 写 L1，L1 写 L2，L2 写 L3，不重复当前规格本级；需求定义、职责划分、意图、范围和边界写在正文中，避免表格厚而正文薄。 -- 不要为了凑全局需求条目自动添加证据收集、硬编码诊断、硬编码建议、任务状态收集、结果包或结果收集类次要需求；除非用户明确授意，这些内容不进入 OA 规格。 +- 每条原子需求使用独立小节： + - 信息表使用横向表格且只放编号、短名和主责模块等短元数据； + - 主责模块填写下一层主责单元，L0 写 L1，L1 写 L2，L2 写 L3； + - 不重复当前规格本级； + - 关联模块、需求定义、职责划分、意图、范围和边界写在正文中。 +- 不要为了凑全局需求条目自动添加次要需求： + - 证据收集； + - 硬编码诊断或建议； + - 任务状态收集； + - 结果包或结果收集。 +- 除非用户明确授意，上述次要内容不进入 OA 规格。 ## 文档骨架 @@ -43,9 +57,9 @@ ## 修改历史 -| 版本 | 对应提交标识 | 更新日期 | 变更说明 | -| --- | --- | --- | --- | -| v0.1 | <提交标识> | <年-月-日> | 创建预期终态需求规格；如来自历史议题，只在这里写迁移来源 <组织>/<仓库>#<编号>。 | +| 版本 | 更新日期 | 变更说明 | +| --- | --- | --- | +| v0.1 | <年-月-日> | 创建预期终态需求规格；如来自历史议题，只在这里写迁移来源 <组织>/<仓库>#<编号>。 | 修改历史只记录规格语义变更，不记录实现进度、阶段基线或一次性证据。 @@ -128,5 +142,5 @@ - 当前状态、阶段验证、内测、灰度和用户反馈进入阶段报告或执行 issue； - 问卷、参与者资料、原始反馈、长证据和执行流水不进入 SPEC； -- 执行载体应引用本 SPEC 编号和实现引用版本。 +- 执行载体应引用本 SPEC 编号和适用的规格版本。 ```