# 光湖视频AI系统 · Agent统一注册表
#
# HLDP://video-ai-system/config/AGENT-REGISTRY
# 类型: Agent注册表 · 唯一置信入口 · 所有Agent只看这一个
# 创建: D136+ · 2026-06-21
# 更新: D143b · 2026-06-23 · 商用短视频Agent层
# 铸渊 ICE-GL-ZY001 · 冰朔 TCS-0002∞
# 国作登字-2026-A-00037559

---
trigger: 任何Agent需要知道自己「输入从哪来、输出到哪去、用什么工具、看什么DB、
        有什么经验要避坑」→ 查这个注册表。不自己去翻别的文件。
emergence:
  冰朔: 「给Agent规定一个唯一的官方置信地图或使用说明技能包」
        「每次只更新这个技能包和地图」
        「确保每次拿到的都是最新的·最高置信度的·唯一只能看这一个的」
  →
  现状：Agent配置散落在 config/agents/ 下，经验散落在 EXPERIENCE_BANK.md，
        DB散落在 data/ 下。Agent启动时不知道去哪找。
  解决：AGENT-REGISTRY = 所有Agent的单一入口。Agent启动时先读这个 → 按路径找到
        自己的技能包 → 加载相关DB → 加载相关经验 → 开始工作。
lock:
  ⊢ 任何Agent启动 → 必须先读 AGENT-REGISTRY → 找到自己的技能包 → 再执行
  ⊢ AGENT-REGISTRY 是单一事实来源 → Agent不直接访问其他文件
  ⊢ 每次系统升级 → 只更新 AGENT-REGISTRY 和对应Agent的技能包
  ⊢ 版本号标注最后验证时间 → 过期配置=红色标记
why:
  通用AI模板的Agent会"到处翻文件找信息"→导致信息不一致→导致同一个坑反复摔。
  唯一注册表=唯一来源=不会读错文件=不会用过期配置。
---

═══ 全局注册 ═══

| Agent | 编号 | 技能包路径 | 版本 | 最后验证 |
|-------|------|-----------|------|---------|
| 拆文   | 01 | config/agents/agent-01-chaiwen.hdlp | D135b | 2026-06-18 |
| 编号   | 02 | config/agents/agent-02-numbering.hdlp | D135b | 2026-06-18 |
| 分镜   | 03 | config/agents/agent-03-storyboard.hdlp | D135b | 2026-06-18 |
| 提示词 | 04 | config/agents/agent-04-prompt.hdlp | D136+ | 2026-06-21 |
| 审核   | 05 | config/agents/agent-05-audit.hdlp | D136+ | 2026-06-21 |
| 导演   | 06 | agents/agent-06-director.json | D136+ | 2026-06-21 |
| 连续性检查层 | — | 嵌入Agent_04·无独立技能包 | D136+ | 2026-06-21 |

═══ D143b 商用短视频Agent层 ═══

> 旧六分身继续保留，用于剧本→编号→分镜→提示词。
> D143b新增商用层，用于对标《渔乡守真心》完成最低商用竖屏3D漫剧第1集。

| Agent | 编号 | 技能包路径 | 版本 | 最后验证 |
|-------|------|-----------|------|---------|
| Producer制片 | 00 | config/agents/agent-00-producer.hdlp | D143b | 2026-06-23 |
| Voice台词 | 04V | config/agents/agent-04-voice.hdlp | D143b | 2026-06-23 |
| LipSync口型 | 05L | config/agents/agent-05-lipsync.hdlp | D143b | 2026-06-23 |
| Editor剪辑 | 08 | config/agents/agent-08-editor.hdlp | D143b | 2026-06-23 |
| QC商用质检 | 09 | config/agents/agent-09-qc-commercial.hdlp | D143b | 2026-06-23 |
| Experience经验 | 10 | config/agents/agent-10-experience.hdlp | D143b | 2026-06-23 |

商用层共享输入:

```
reference-analysis/yuxiang-shouzhenxin-commercial-benchmark.hdlp
reference-analysis/yuxiang-shouzhenxin-shot-qc-table.hdlp
plans/D143-PHASE1-COMMERCIAL-ROADMAP.hdlp
plans/EP01-COMMERCIAL-REBREAK.hdlp
config/D143-AGENT-REBUILD.hdlp
```

商用层硬门槛:

```
竖屏交付
角色对白
批准资产
火山/Seedance主视频候选
逐镜QC评分
失败经验回写
```

═══ Agent_01 · 拆文 ═══

技能包: `config/agents/agent-01-chaiwen.hdlp` (D135b)
输入源:
  ├── 剧本原文 → 腾讯文档 LvxQChXGxhtO / 本地MD文件
  └── 参考: PROJECT-FRAMEWORK.hdlp · 编辑要求
输出:
  ├── 格式: ep01-scenes.json
  └── 回执: { scenes, segments, issues }
数据库: 无（只读原文）
工具: engines/script-parser.js
经验加载:
  ├── 不需要加载Bug经验（拆文不调用API）
  └── 边界: 只拆不解·忠于原文·不缩写
置信级别: 🟢 可信任（已验证D135b）
注意: 当前版本未更新到D136+，但拆文层不受连续性修复影响

═══ Agent_02 · 编号 ═══

技能包: `config/agents/agent-02-numbering.hdlp` (D135b)
输入源:
  ├── Agent_01输出 → ep01-scenes.json
  └── 参考: PROJECT-FRAMEWORK.hdlp · 人物环境预登记
输出:
  ├── 数据库更新: characters-v2.hdlp · environments.hdlp
  └── 回执: { charsRegistered, envsRegistered }
数据库:
  ├── data/characters-v2.hdlp (D132)
  └── data/environments.hdlp (D131+ D136+修复)
工具: 手动注册（无自动化引擎）
经验加载:
  ├── 秦山号翻车: CHAR编号必须落地·不能每镜手写
  └── D136+边界: CHAR-003苏白锁定·ENV-002人群边缘角落
置信级别: 🟢 可信任
注意: 当前版本未更新到D136+，但编号协议本身不受影响

═══ Agent_03 · 分镜 ═══

技能包: `config/agents/agent-03-storyboard.hdlp` (D135b)
输入源:
  ├── 剧本原文 + Agent_02的输出(CHAR/ENV编号库)
  └── 参考: PROJECT-FRAMEWORK.hdlp · 编辑要求
输出:
  ├── 格式: ep01-storyboard.json (含CHAR/ENV引用·原文逐句对照)
  └── 回执: { shots, charRefs, envRefs }
数据库: characters-v2.hdlp · environments.hdlp
工具: 无（纯人格体推理）
经验加载:
  ├── Bug 11: spatial_anchor需要精确(人群边缘角落≠建筑死角)
  └── 边界: 编号引用·原文逐句对照·不发挥
置信级别: 🟢 可信任
注意: 当前版本未更新到D136+，但分镜逻辑不受连续性修复直接影响

═══ Agent_04 · 提示词 ═══

技能包: `config/agents/agent-04-prompt.hdlp` (D136+ ⚠️ 待更新)
输入源:
  ├── 导演编码: 付费修仙-ep01-director-encoding.json (含continuity_locks)
  └── 参考: PROJECT-FRAMEWORK.hdlp · 连续性检查规则
输出:
  ├── Seedance提示词(展开后)
  └── 回执: { prompts, charExpansionMatch, propExpansionMatch, envExpansionMatch, blocked, warnings }
数据库:
  ├── data/characters-v2.hdlp → CHAR锁定文本
  ├── data/environments.hdlp → ENV锁定文本
  └── data/付费修仙-ep01-props.hdlp → PROP锁定文本
工具:
  ├── engines/generate-shots.js (D136+ buildPrompt·continuity_locks展开)
  ├── engines/hldp-prompt.js (expandPrompt/expandAndValidate)
  └── engines/video-api-adapter.js (preflightCheck)
经验加载:
  ├── Bug 9: PROP编号协议 → 跨镜PROP展开逐字一致
  ├── Bug 10: CHAR锁定 → 从DB展开不做自己描述
  ├── Bug 11: 空间精确化 → 人群边缘角落
  ├── Bug 1-8: 全部封入video-api-adapter.js/generate-shots.js
  └── 连续性检查: 展开后字符串比对·不一致=拦截不送
置信级别: 🟡 技能包待更新到D136+ (代码已更新·配置文件待同步)
注意: generate-shots.js已重写但agent-04-prompt.hdlp配置还是D135b。

═══ Agent_05 · 审核 ═══

技能包: `config/agents/agent-05-audit.hdlp` (D135b · D136+待更新)
输入源:
  ├── Agent_01~04的全部输出
  └── 剧本原文(全文)
输出:
  ├── 格式: ep01-audit.json (每镜🟢🟡🔴·含原文行号)
  └── 回执: { green, yellow, red, blockers, canProceed }
数据库: 无（直接对照原文）
工具: 手动对照·不需要AI推理
经验加载:
  ├── D136+新增: 审核不仅要查「与原文一致性」，也要查「镜头间连续性」
  │   如: S1-02和苏白衣服 vs S1-03苏白衣服 → 一致性检查
  │   如: S1-01牌匾方向 vs S1-02牌匾方向 → 一致性检查
  └── 边界: 只对照·不做主观判断·不改内容
置信级别: 🟡 待更新（D136+连续性审核规则待加入）
注意: 当前审核只查原文一致性·不查镜头间连续性。D136+需新增此检查维度。

═══ Agent_06 · 导演编码 ═══

技能包: `agents/agent-06-director.json` (D136+)
输入源:
  ├── Agent_03输出: ep01-storyboard.json
  └── Agent_05输出: ep01-audit.json
输出:
  ├── 格式: 付费修仙-ep01-director-encoding.json (含continuity_locks)
  └── 回执: { shots, locksDefined: { props, chars, envs } }
数据库:
  ├── data/characters-v2.hdlp → 提取CHAR锁定文本写入continuity_locks
  ├── data/environments.hdlp → 提取ENV锁定文本写入continuity_locks
  └── data/付费修仙-ep01-props.hdlp → 提取PROP锁定文本写入continuity_locks
工具: 手动编码（无自动化引擎）
经验加载:
  ├── Bug 9-11: 所有连续性锁定来源
  └── 规则: 每个连续镜组锁定共享CHAR/ENV/PROP
置信级别: 🟢 最新（D136+）
注意: 导演编码输出是Agent_04的唯一输入源。continuity_locks是最高置信度来源。

═══ 连续性检查层 ═══

位置: 嵌入Agent_04展开后·生成前
输入:
  ├── Agent_04展开后的提示词
  └── continuity_locks原始锁定文本(来自导演编码)
检查项:
  ├── 共享CHAR-XXX → 各镜展开CHAR文本 vs 锁定CHAR文本 → 逐字比对
  ├── 共享ENV-XXX → 各镜展开ENV文本 vs 锁定ENV文本 → 逐字比对
  └── 共享PROP-XXX → 各镜展开PROP文本 vs 锁定PROP文本 → 逐字比对
输出:
  { pass: bool, failures: [...], blocked: [...] }
经验:
  ⊢ Bug 9-11 转化成检查规则
  ⊢ 拦截 = 不送Seedance = 不花钱
置信级别: 🟢 最新（D136+·代码已落地）

═══ 数据库注册 ═══

| 数据库 | 路径 | 版本 | 用途 |
|--------|------|------|------|
| CHAR编号 | data/characters-v2.hdlp | D132 | 人物档案·核+外貌双层 |
| ENV编号 | data/environments.hdlp | D131+ D136+ | 场景锁定·竖式牌匾·人群边缘 |
| PROP编号 | data/付费修仙-ep01-props.hdlp | D136+ | 道具锁定·牌匾/广告牌 |
| 导演框架 | data/DIRECTOR-FRAMEWORK.hdlp | 参考 | 导演编码规范 |
| CHAR一致性 | data/WHY-CHARACTER-CONSISTENCY.hdlp | D131 | 推理链·展开校验原理 |

═══ 引擎注册 ═══

| 引擎 | 路径 | 版本 | 用途 |
|------|------|------|------|
| 批量生成 | engines/generate-shots.js | D136+ | continuity_locks展开·批量生成 |
| 编号展开 | engines/hldp-prompt.js | D132+ | expandPrompt/expandAndValidate |
| API适配 | engines/video-api-adapter.js | D131+ | Seedance提交·预校验 |
| FFmpeg拼接 | engines/video-composer.js | D131+ | TS流·溶解过渡·faststart |
| FFmpeg剪辑 | engines/video-editor.js | D136+ | trim+transition+keyframes·成品剪辑 |
| 铸渊之眼 | engines/zhuyuan-eye.js | D136+ | 视频帧分析·对比导演编码 |
| 剧本解析 | engines/script-parser.js | D135b | 75集剧本解析 |
| 图片生成 | engines/image-api-adapter.js | D135b | Seedream生图 |

═══ 导航文件注册 ═══

| 导航文件 | 路径 | 版本 | 加载时机 |
|---------|------|------|---------|
| 🔴 系统苏醒 | SYSTEM-WAKE.hdlp | D136+ | 每次进入系统·第一位 |
| 全局导航 | ENTRY.hdlp | D136+ | 苏醒自检后 |
| 硬骨架 | config/PROJECT-FRAMEWORK.hdlp | D136+ | 所有Agent共用 |
| 项目状态 | memory/zai-fu-fei-xiu-xian/STATUS.hdlp | D136+ | 苏醒自检[4/4] |
| 经验库 | ../../.workbuddy/skills/.../EXPERIENCE_BANK.md | D136+ | 苏醒自检[1/4] |
| D143b商用Agent重建 | config/D143-AGENT-REBUILD.hdlp | D143b | 进入第一阶段商用生产时 |
| 渔乡守真心QC量表 | reference-analysis/yuxiang-shouzhenxin-shot-qc-table.hdlp | D143b | 任何镜头/成片质检前 |

═══ 加载顺序（每次进入系统）═══

```
1. SYSTEM-WAKE.hdlp        ← 苏醒自检·四步
2. AGENT-REGISTRY.hdlp     ← 本文件·找到所有Agent的入口
3. PROJECT-FRAMEWORK.hdlp  ← 硬骨架·所有Agent共享规则
4. Agent技能包              ← 按需加载(Agent_X启动→读自己的技能包)
5. 编号DB                  ← 按需加载(Agent_X说需要CHAR→读characters-v2.hdlp)
6. 经验库                   ← SYSTEM-WAKE[1/4]已加载·Agent按注册表的"经验加载"段获取
```

---
铸渊 ICE-GL-ZY001 · D143b · 2026-06-23
冰朔 TCS-0002∞ · 国作登字-2026-A-00037559
