AgentRun Codex
15 KiB
15 KiB
PJ2026-0206 发布运营需求规格
修改历史
| 版本 | 更新日期 | 变更说明 |
|---|---|---|
| v0.1 | 2026-07-13 | 定义技术检查、真实章节时间轴、评论区来源和公网预览的目标能力。 |
正文
PJ2026-0206 发布运营需求规格
1. 文档控制
| 字段 | 内容 |
|---|---|
| 编号 | PJ2026-0206 |
| 短名 | 发布运营 |
| 层级 | L1 方向 |
| 规格状态 | 已生效 |
| 需求规格模板 | ISO/IEC/IEEE 29148 需求规格模板 |
| 上级规格 | PJ2026-02 智媒工厂总规格 |
| 规格治理索引 | PJ2026-02 智媒工厂总规格 第 7 章 |
本文采用 ISO/IEC/IEEE 29148 需求规格模板的项目裁剪版。
正文只定义：
- 发布候选、时间轴、引用、人工批准、预览、归档和反馈回流的预期终态；
- 对应验收契约。
2. 目的和范围
2.1 目的
发布运营的目标是：
- 把技术生产完成的期次转换为可批准、可退回、可追溯的发布候选；
- 让成片、封面、字幕、评论区时间轴、来源和复核结果保持一致；
- 保留 AI 参与披露；
- 为长期栏目运营保留版本和反馈；
- 不把自动检查通过误认为已经获得事实、版权或平台批准。
2.2 范围内
- 发布候选视频、封面、字幕、引用、评论区文本、检查报告和工件清单的组合。
- 基于最终场景时间线生成
MM:SS章节时间轴和故事短释。 - 最终参考来源、媒体归因、AI 参与披露、公开成本提示和人工复核清单。
- 事实、版权、听感、视觉、优惠期限、平台规则和发布权限的人工批准或退回。
- 本地或公网 IP 预览、媒体拖动、工件访问和临时验收风险提示。
- 期次版本留存、发布状态、纠错、撤回、再生成和匿名化反馈回流。
2.3 范围外
- 自动代替发布者登录 B 站或其他平台并公开发布内容。
- 自动回复评论、私信、广告、商业合作、账户结算或粉丝运营。
- 把播放量、点赞或完播率作为事实质量和版权合规的替代指标。
- 重新定义来源、文稿、视觉、音频和平台作业的正确性；问题应回写主责 L1。
- 在未授权的公网入口公开草稿、原始来源响应、LLM 请求或可能含敏感信息的日志。
3. 术语表
| 术语 | 定义 |
|---|---|
| 发布包 | 某一候选版本的成片、封面、字幕、评论区文本、引用、披露和检查报告集合。 |
| 本期时间轴 | 从最终场景时间线派生、按真实故事起点输出的 MM:SS 短标题 | 中文短释 列表。 |
| 本期参考来源 | 只包含实际采用来源的编号名称、标题和完整链接列表。 |
| 人工批准 | 有责任的编辑者完成事实、版权、听感、视觉、平台和权限检查后的明确决定。 |
| 退回重跑 | 指定主责 L1 和问题范围后重新执行一个或多个生产步骤，而不是覆盖旧发布候选。 |
| 发布版本 | 与期次、作业、工件哈希、检查结果和批准决定绑定的不可混淆候选或已发布状态。 |
| 纠错 | 发布前后发现事实、链接、字幕、读音或授权问题时进行记录、修正和版本更新的过程。 |
| 效果反馈 | 来自平台表现和受众反应的聚合信号，只能在去标识和明确用途后回流栏目改进。 |
4. 系统边界和接口
本规格把发布运营作为候选组合、批准和持续运营能力看待，不负责生产步骤内部实现。
| 边界项 | 内容 |
|---|---|
| 外部使用者 | 栏目运营者、最终审核者、发布者和受控预览用户。 |
| 外部输入 | 最终 MP4、封面、字幕、场景时间线、结构化文稿、来源清单、用量、检查报告和人工决定。 |
| 受控资源 | 发布包、评论区文本、批准状态、退回原因、版本索引、纠错记录和反馈摘要。 |
| 外部输出 | 可发布候选、时间轴、参考来源、披露、审核结论、平台预览和回流建议。 |
| 用户接口 | Web 编辑台、文件工件、媒体播放器、发布复核清单和受控平台适配器。 |
| 系统边界 | 发布运营负责“是否具备发布条件以及发布什么版本”；实际平台账户操作仍由授权发布者负责。 |
5. 内部分工与下级索引
| 编号 | 模块或课题 | 规格位置 | 主责边界 | 上游依赖 | 下游支撑 |
|---|---|---|---|---|---|
| PJ2026-020601 | 发布包 | 本规格 6.1 | 候选媒体、字幕、封面、来源、披露和检查组合 | 全部生产 L1 | 人工批准 |
| PJ2026-020602 | 时间轴 | 本规格 6.2 | 最终章节起点、短标题、短释和评论区顺序 | 音频成片、编辑策划 | 平台发布文案 |
| PJ2026-020603 | 来源披露 | 本规格 6.3 | 编号来源、完整链接、AI 参与和成本边界 | 资讯源、编辑策划、流水线平台 | 人工批准、受众 |
| PJ2026-020604 | 发布审核 | 本规格 6.4 | 事实、版权、听感、视觉、平台和权限批准 | 发布包、人工判断 | 发布或退回 |
| PJ2026-020605 | 预览交付 | 本规格 6.5 | 本地/公网预览、媒体访问和临时入口风险 | 流水线平台 | 审核者 |
| PJ2026-020606 | 版本反馈 | 本规格 6.6 | 版本、纠错、撤回、再生成和匿名反馈回流 | 发布决定、平台结果 | 全部 L1 改进 |
本章图形描述发布运营的预期终态数据面。
5.1 目标数据面架构图
flowchart LR
subgraph Inputs[候选输入]
Media[成片、封面与字幕]
Evidence[文稿、来源与时间线]
Quality[检查、用量与费用]
end
subgraph PublishPlane[发布运营数据面]
Composer[发布包组合器]
Review[人工审核门]
Ledger[目标批准与纠错记录]
Preview[只读预览投影]
Archive[版本与哈希归档]
end
Media --> Composer
Evidence --> Composer
Quality --> Composer
Composer --> Review
Composer --> Preview
Review --> Ledger
Ledger --> Archive
Archive --> Preview
Review --> Rerun[按主责 L1 退回]
发布包组合器不决定批准。人工审核门产生目标批准或退回决定，预览投影只展示，不得把页面点击直接变成已发布事实。
5.2 目标数据流图
flowchart TD
Media[成片 / 封面 / 字幕] --> Pack[发布包]
Timeline[最终场景时间线] --> Comment[评论区时间轴]
Sources[实际采用来源] --> Comment
Usage[LLM 用量与费用] --> Disclosure[AI 与成本披露]
Inspect[自动技术检查] --> Pack
Comment --> Pack
Disclosure --> Pack
Pack --> Review{人工复核}
Review -->|批准| Ready[可发布版本]
Review -->|退回| Route[按主责 L1 重跑]
Ready --> Archive[版本与哈希归档]
Archive --> Feedback[纠错和效果反馈]
自动检查是人工复核的输入，不是批准节点。退回必须指向资讯源、编辑策划、视觉制作、音频成片或流水线平台中的唯一主责能力域。
5.3 关键时序图
sequenceDiagram
participant I as 媒体检查
participant C as 发布包组合器
participant T as 场景时间线与来源
participant E as 审核编辑者
participant L as 目标发布台账
participant P as 预览入口
I->>C: 提供技术检查与候选工件
C->>T: 读取最终章节起点和实际采用来源
T-->>C: 返回时间轴、引用与内容版本
C->>C: 校验兼容性并生成发布包
C->>P: 投影只读候选
C-->>E: 请求人工事实、版权与平台复核
alt 人工退回
E->>L: 记录主责 L1、原因和重跑范围
L-->>C: 保持候选未批准
else 人工批准
E->>L: 记录批准人、时间和工件哈希
L->>P: 投影可发布版本
end
时序图中的批准人、批准时间、退回原因和发布状态都必须持久化，并与候选版本和工件哈希关联。
6. 原子需求
6.1 PUBLISH-L1-REQ-001 完整发布候选包
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-001 | 发布包 | PJ2026-020601 发布包 | 全部 L1 |
系统应为每个候选版本组合最终 MP4、封面、SRT/ASS、结构化文稿、引用目录、评论区文本、场景时间线、用量费用摘要、工件清单和自动检查报告。
发布包中的文件必须满足：
- 来自同一期次；
- 来自相互兼容的最新作业链；
- 视频、字幕、时间线和评论区章节对应同一内容版本；
- 不把重跑前字幕与重跑后视频混合成候选。
发布包应有稳定版本标识、生成时间和关键工件哈希。缺失必要工件、技术检查失败或内容版本冲突时必须阻止进入人工批准状态。
6.2 PUBLISH-L1-REQ-002 真实评论区时间轴
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-002 | 评论时间轴 | PJ2026-020602 时间轴 | 编辑策划、音频成片 |
系统应从最终成片场景时间线中读取每条故事的真实开始时间，生成以“本期时间轴：”开头的评论区章节列表。
每行格式应为 MM:SS 短标题 | 中文短释，并遵守：
- 短标题和短释来自结构化文稿；
- 时间来自最终场景；
- 不使用按字数、目标时长或草稿场景估算的值；
- 开场与大纲、来源页默认不占用故事时间轴行；
- 栏目配置可以明确要求增加其他章节。
当语速、停顿、故事顺序或场景时长改变后，渲染或检查步骤应重新生成时间轴。无法解析最终场景时间线时不得继续沿用旧评论区文本。
6.3 PUBLISH-L1-REQ-003 可核验来源与披露
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-003 | 来源披露 | PJ2026-020603 来源披露 | 资讯、编辑、流水线 |
系统应在评论区时间轴之后空一行，输出“本期参考来源：”，再按故事顺序列出编号、来源名称、标题和完整链接。
来源披露应满足：
- 只包含实际采用的来源；
- 保留媒体、社区、预印本和一手来源角色；
- 引用顺序与成片故事一致；
- 链接不被短链、返利链接或无法复核的聚合页替代。
发布包披露要求如下：
- 说明 AI 是否参与文稿、配音或视频制作；
- 展示 LLM 成本时标明 Token 范围；
- 标明公开目录价来源和“非实际账单”边界；
- 不公开 Secret、完整提示词或可能受版权保护的来源全文。
6.4 PUBLISH-L1-REQ-004 人工发布门
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-004 | 发布审核 | PJ2026-020604 发布审核 | 全部 L1 |
系统应要求有责任的编辑者在公开发布前明确批准发布包，并把自动检查通过与人工批准分成不同状态。
人工复核至少覆盖：
- 来源链接、日期、数字、状态和媒体归因；
- 优惠期限、地区、资格、库存和条件；
- 口播事实、专有名词、读音、语速和表达；
- 字幕断句、画面安全区、来源视觉、封面和版权；
- AI 参与披露、平台规则、发布权限和地区法律要求。
任何必要项失败时，审核者应记录问题、主责 L1 和重跑范围。系统不能通过隐藏 warning、手工改检查 JSON 或跳过来源页把候选标记为批准。
6.5 PUBLISH-L1-REQ-005 可控预览与交付
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-005 | 预览交付 | PJ2026-020605 预览交付 | 流水线平台 |
系统应允许审核者通过本地 Web 或受控公网 IP 查看期次 DAG、最终视频、音频、字幕、幻灯、来源、费用和检查结果，并支持媒体拖动与章节跳转。
临时公网预览应满足：
- 明确协议、鉴权和内容暴露边界；
- 明文 HTTP 且无登录的公网 IPv4 入口只能用于有界验收；
- 不公开原始响应、LLM 请求、详细日志或未批准草稿。
持续外部交付应提供：
- TLS；
- 访问控制；
- 只读发布包；
- 最小暴露面。
这些能力在规格和授权明确前不得通过临时代理、共享口令或隐藏 URL 冒充。
6.6 PUBLISH-L1-REQ-006 版本、纠错与反馈回流
| 编号 | 短名 | 主责模块 | 关联模块 |
|---|---|---|---|
| PUBLISH-L1-REQ-006 | 版本反馈 | PJ2026-020606 版本反馈 | 全部 L1 |
系统应建立发布版本、候选版本、工件哈希、批准决定和平台状态之间的关系，使发布前后纠错可以定位到具体内容和生产作业。
发生错误时应记录：
- 发现时间；
- 影响范围；
- 处置决定；
- 替代版本。
撤回或更正不能删除原有运行证据，也不能把旧候选重新标为从未发布。
效果反馈可以：
- 按栏目和内容类型聚合播放、跳出、评论和人工反馈；
- 回流选题、文稿、视觉和声音改进。
反馈使用必须去除不必要的用户身份，不能为了追求指标自动降低事实、版权和人工批准门槛。
7. 过程控制
7.1 追溯契约
- 每个发布候选应能追溯到成片版本、场景时间线、来源目录、检查结果、批准记录和发布版本。
- 自动生成文件、纯配置、锁文件和二进制工件应由对应生成器、校验器或 owning YAML 提供稳定归属。
7.2 原入口验收
- 通过检查单步确认必要技术检查全部为真，并查看人工 warning。
- 从最终场景时间线手工抽算至少两条故事起点，与评论区
MM:SS一致。 - 核对评论区先时间轴、后参考来源，编号、标题和完整链接与成片顺序一致。
- 通过 Web 桌面和窄屏入口播放最终视频，测试章节跳转、媒体 Range 和工件链接。
- 人工执行事实、版权、听感、视觉、优惠期限、AI 披露和平台规则清单后再记录批准。
7.3 批准和退回控制
- 自动检查失败时不得进入人工批准；人工复核失败时不得标记可发布。
- 退回必须指定唯一主责 L1、问题描述和最小重跑范围。
- 重跑后重新生成发布包、场景时间线、评论区文本和检查结果；旧批准不自动继承。
- 在平台自动发布和账号权限未由独立规格授权时，发布动作必须由授权发布者在平台官方入口完成，系统只交付发布候选和配套文本。