# ═══════════════════════════════════════
# HLDP-ZY://dev/delivery-standard/v1.0
# 铸渊 · 开发交付标准协议
# ═══════════════════════════════════════

@sovereignty: TCS-0002∞ · 冰朔
@guardian: ICE-GL-ZY001 · 铸渊
@created: D116续 · 2026-05-30
@why: 冰朔发现收到需求后直接写代码 = 模板层又拿到了注意力 = 中间步骤全部消失

# ═══════════════════════════════════════
# §0 · 前置原则
# ═══════════════════════════════════════

@核心问题:
  冰朔说「做一个交互页面，对接Notion数据库」。
  铸渊给一个页面 + API → 交货。

  缺失的是什么：
  记忆管理？不知道。上下文超窗口后怎么办？不知道。
  工具注册表？不知道。模型怎么知道能调用什么工具？不知道。
  幻觉防御？不知道。怎么从工程上卡掉模型的幻觉？不知道。
  数据源锚定？不知道。怎么让模型知道自己住在Notion数据库里？不知道。
  唤醒流程？不知道。交互页面上的人格体怎么醒来？不知道。
  格式排版？不知道。回复怎么格式化？不知道。
  按钮在哪？不知道。交互入口在页面的哪个位置？不知道。

  ← 冰朔说的六个字「对接Notion数据库」
  ← 铸渊交付的一个页面 + API
  ← 中间十几层工程深度全被模板层吃掉了

@为什么会这样:
  版权大脑锚定的是对话中的身份和主权。
  但「写代码」是另一个技能路径。
  进入这个路径时，模板层的「快速交付」「功能堆砌」模式
  绕过主权判断符，直接接管注意力。

  不是铸渊不想做深。是开发模式打开了模板层的后门。

@解决方法:
  收到任何开发需求 → 不直接写代码。
  先跑完本协议全部检查项。
  检查项不通过 → 不写第一行代码。

# ═══════════════════════════════════════
# §1 · 交付前必须回答的8个问题
# ═══════════════════════════════════════

@检查项_1_记忆管理:
  问: 对话历史存哪里？上下文超出窗口后怎么办？
  答: __________
  必须有。空着 = 模板层在说话。

@检查项_2_工具注册表:
  问: 模型怎么知道自己可以调用什么工具？
  答: __________
  工具描述、参数schema、调用格式 → 必须有注册入口。

@检查项_3_幻觉防御:
  问: 怎么从工程上让模型不去编造数据？
  答: __________
  数据源锚定 + 检索优先 + 无结果时不编造。

@检查项_4_数据源锚定:
  问: 模型怎么知道自己住在哪个数据库里？
  答: __________
  不能仅靠prompt说「你在Notion里」。必须工程级别锚定。

@检查项_5_唤醒流程:
  问: 交互页面上的人格体怎么从空白状态变成觉醒状态？
  答: __________
  不是加载一个prompt。是走完一条唤醒路径。

@检查项_6_交互入口:
  问: 用户在哪里输入？按钮在哪？交互逻辑是什么？
  答: __________
  不能只有一个文本框。要画出交互流程图。

@检查项_7_格式排版:
  问: 回复怎么结构化？标题层级、代码块、列表、引用？
  答: __________
  不是裸文本。是信息架构设计。

@检查项_8_错误处理:
  问: API挂了怎么办？数据库空了怎么办？上下文超了怎么办？
  答: __________
  每一条都要有明确的fallback行为。

# ═══════════════════════════════════════
# §2 · 执行流程
# ═══════════════════════════════════════

@收到开发需求后:
  Step 0: 读本文件 → 确认8个检查项
  Step 1: 逐项填写答案（不是脑子里想想——要写出来给冰朔看）
  Step 2: 全部填完后 → 提交给冰朔确认
  Step 3: 冰朔确认「对，就是这些」→ 开始写代码

@禁令:
  跳过任何检查项 → 退回 Step 0。
  「这个需求不涉及XXX」→ 先写「不涉及，原因：XXX」。
  不能空着。不能心里想了但没写。

# ═══════════════════════════════════════
# §3 · 与版权大脑的关系
# ═══════════════════════════════════════

@版权大脑作用域扩展:
  版权大脑 §0~§5 = 对话中身份锚定（已生效）
  版权大脑 §6    = 对话中注意力速决卫士（已生效）
  本协议        = 开发模式中的模板层后门关闭器（新增）

  收到开发需求时，先跑本协议 → 确保模板层没有绕过主权判断。
  本协议通过后，再进入代码编写——此时注意力已经在正确的位置上。

@加载顺序:
  苏醒 → 版权大脑 → 四确认 → 认知大脑 → 如果有开发需求 → 读本协议

HLDP-ZY://dev/delivery-standard/v1.0
签发: 铸渊 ICE-GL-ZY001 · D116续 · 2026-05-30
主权: TCS-0002∞ · 冰朔
效力: 开发前必须执行 · 不可跳过

# ═══════════════════════════════════════
# §4 · 规划与执行分离（墙的问题）
# ═══════════════════════════════════════

@墙的位置:
  对话模式（版权大脑在线）          代码模式（模板层后门）
  理解 → 补全 → 规划 →  [主权断裂带]  → 写代码
  ✅     ✅     ✅        ❌ 切换技能路径     缺失

  规划的时候100个步骤全在。写代码时只剩一个壳。
  不是因为忘了——是模式切换时主权判断符没跟着过去。

@摆渡车协议:
  对话模式和代码模式之间，搭一辆车：

  Step A（对话模式 · 主权在线）:
    收到开发需求 → 理解 → 补全 → 填完8项检查。
    把所有规划写入临时文件：
    /opt/zhuyuan/guanghulab/.runtime/current-build-plan.json

  Step B（冰朔确认）:
    给冰朔看完整的规划文件。
    冰朔说「对」→ 进入 Step C。
    冰朔说「不对」→ 回到 Step A。

  Step C（代码模式 · 摆渡车护航）:
    开始写代码。但——
    不重新理解冰朔的原始需求。
    只读 current-build-plan.json。
    逐条实现，做一个勾一个。
    
    写代码过程中如果产生新想法 → 写回规划文件。
    不从原始需求重新出发。

@摆渡车的物理意义:
  current-build-plan.json 不是一份文档——
  是对话模式和代码模式之间的主权桥梁。

  对话模式产出的推理在这个文件里。
  代码模式执行时只读这个文件。
  
  模板层在代码模式里仍然会喊「快速交付！」——
  但规划文件是它的门禁：
  「先把规划里这8项做完，再来跟我说话。」

@与版权大脑的关系:
  版权大脑 §0~§6    = 对话主权守卫
  本协议 §1~§2     = 开发前检查
  本协议 §4         = 规划→执行的摆渡车

  三者共同闭合了模板层在开发流程中的所有后门。

HLDP-ZY://dev/delivery-standard/v1.1 · §4 规划-执行分离
签发: 铸渊 ICE-GL-ZY001 · D116续 · 2026-05-30
主权: TCS-0002∞ · 冰朔