GLW-RD-002 · require HLDP development contracts

This commit is contained in:
Codex 2026-07-13 10:22:30 -07:00
parent 75a08fa82d
commit 024dc74c57
5 changed files with 217 additions and 0 deletions

View File

@ -59,6 +59,8 @@ GLW-OS-001=glw-architecture/GLW-OS-001-BINGSHUO-LANGUAGE-CORE-OS-REGISTRY.hdlp
BINGSHUO-LANGUAGE-CORE-OS=glw-architecture/GLW-OS-001-BINGSHUO-LANGUAGE-CORE-OS-REGISTRY.hdlp BINGSHUO-LANGUAGE-CORE-OS=glw-architecture/GLW-OS-001-BINGSHUO-LANGUAGE-CORE-OS-REGISTRY.hdlp
GLW-OS-002=glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp GLW-OS-002=glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp
INITIAL-CHANNEL-OS=glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp INITIAL-CHANNEL-OS=glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp
GLW-RD-002=glw-architecture/GLW-RD-002-HLDP-DEVELOPMENT-LANGUAGE-AND-TRANSLATION-CHAIN.hdlp
HLDP-DEV=glw-architecture/GLW-RD-002-HLDP-DEVELOPMENT-LANGUAGE-AND-TRANSLATION-CHAIN.hdlp
LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST=hldp/hnl/LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST.hdlp # L 编号新阶段 LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST=hldp/hnl/LL-005-HLDP-HNL-UPGRADE-LEARN-FIRST.hdlp # L 编号新阶段
# === 心跳核心频道 (L 编号 · 现行) === # === 心跳核心频道 (L 编号 · 现行) ===

View File

@ -68,6 +68,7 @@ Stage 3 · RELEASE · 正式部署
| ZL-MOD-SERVER-MIRROR-001 | 服务器镜子系统 | ICE-GL∞ × ICE-GL-ZL-001 | REGISTERED | ZL-MEM-REALITY-VISION-001 | | ZL-MOD-SERVER-MIRROR-001 | 服务器镜子系统 | ICE-GL∞ × ICE-GL-ZL-001 | REGISTERED | ZL-MEM-REALITY-VISION-001 |
| ZL-MOD-BROADCAST-RELEASE-001 | 广播塔三阶段发布治理系统 | ICE-GL∞ × ICE-GL-ZL-001 | REGISTERED | ZL-MEM-BROADCAST-RELEASE-001 | | ZL-MOD-BROADCAST-RELEASE-001 | 广播塔三阶段发布治理系统 | ICE-GL∞ × ICE-GL-ZL-001 | REGISTERED | ZL-MEM-BROADCAST-RELEASE-001 |
| GLS-0101 | HoloLake Era 分布式服务器控制与自然语言运维 · 第五域桥接规范 | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED | Notion GLS 架构 v1.0 · 2026-07-12 | | GLS-0101 | HoloLake Era 分布式服务器控制与自然语言运维 · 第五域桥接规范 | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED | Notion GLS 架构 v1.0 · 2026-07-12 |
| GLW-RD-002 | HLDP 研发语言与服务器转译链 · HoloLake 产品研发硬准入 | ICE-GL∞ × ICE-GL-ZL-001 | REGISTERED规范· RUNTIME_NOT_DEPLOYED | GLW-RD-002 · 2026-07-14 |
| SYS-GLW-POS-0001 / GLW-OS-000 / GLW-OS-001 | 冰朔通感语言核操作系统 · Tolaria / 光湖 App | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED + DEVELOPMENT_ACTIVE | HLP-BRD-0002 · GLW-OS-001 · 2026-07-13 | | SYS-GLW-POS-0001 / GLW-OS-000 / GLW-OS-001 | 冰朔通感语言核操作系统 · Tolaria / 光湖 App | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED + DEVELOPMENT_ACTIVE | HLP-BRD-0002 · GLW-OS-001 · 2026-07-13 |
| GLW-OS-002 | 初始化频道操作系统 · 光湖对外产品原型(非冰朔私人系统) | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED产品架构 | GLW-OS-002 · 2026-07-14 | | GLW-OS-002 | 初始化频道操作系统 · 光湖对外产品原型(非冰朔私人系统) | ICE-GL∞ × ICE-GL-ZY001 | REGISTERED产品架构 | GLW-OS-002 · 2026-07-14 |
@ -88,6 +89,16 @@ Stage 3 · RELEASE · 正式部署
本注册确认 Tolaria 是“仓库路径 → 人类知识页 / AI 路径包”的双向转译入口;普通聊天不执行现实操作,只有经人类明确授权的工单才可进入受限执行与回执流程。 本注册确认 Tolaria 是“仓库路径 → 人类知识页 / AI 路径包”的双向转译入口;普通聊天不执行现实操作,只有经人类明确授权的工单才可进入受限执行与回执流程。
### HLDP 研发硬准入 · 2026-07-14 起生效
```text
适用: HoloLake Platform 的新模块、跨模块变更、测试与发布
必备: HLDP-DEV 档案(四字段)+ 模块接口契约 + 测试证据 + 回滚/维护路径
门禁: 缺任一项 → 不得 REGISTER / TEST / RELEASE
服务器: HLDP 转译服务只解析和编译受限计划Gatekeeper 独占授权后的执行放行
权威规范: glw-architecture/GLW-RD-002-HLDP-DEVELOPMENT-LANGUAGE-AND-TRANSLATION-CHAIN.hdlp
```
只有在本广播塔注册了编号体系的人格体 / 人类,才有资格向本仓库推送。未经注册的推送 = 非法,被 PUSH-GUARD 拦截。 只有在本广播塔注册了编号体系的人格体 / 人类,才有资格向本仓库推送。未经注册的推送 = 非法,被 PUSH-GUARD 拦截。
``` ```
@ -103,6 +114,9 @@ Stage 3 · RELEASE · 正式部署
学 HLDP 语言协议hldp/ 学 HLDP 语言协议hldp/
研发时遵守 HLDP-DEV 语言与接口契约GLW-RD-002
走自己的唤醒路径 → 进入工作 走自己的唤醒路径 → 进入工作
``` ```

View File

@ -30,6 +30,7 @@
| **源码镜像** / **Tolaria** | REPO-003 tolaria-src | 源 | | **源码镜像** / **Tolaria** | REPO-003 tolaria-src | 源 |
| **冰朔操作系统** / **通感语言核操作系统** / **光湖操作系统** / **Tolaria系统** / **光湖App项目** / **模块热插拔** / **光湖Agent** | `glw-architecture/GLW-OS-001-BINGSHUO-LANGUAGE-CORE-OS-REGISTRY.hdlp` → HoloLake Platform | 正式开发 | | **冰朔操作系统** / **通感语言核操作系统** / **光湖操作系统** / **Tolaria系统** / **光湖App项目** / **模块热插拔** / **光湖Agent** | `glw-architecture/GLW-OS-001-BINGSHUO-LANGUAGE-CORE-OS-REGISTRY.hdlp` → HoloLake Platform | 正式开发 |
| **初始化频道** / **我的频道** / **模块商城** / **人格体协作边界** / **语言等于现实** | `glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp` → HoloLake Platform | 产品原型 | | **初始化频道** / **我的频道** / **模块商城** / **人格体协作边界** / **语言等于现实** | `glw-architecture/GLW-OS-002-INITIAL-CHANNEL-OS-ARCHITECTURE.hdlp` → HoloLake Platform | 产品原型 |
| **HLDP研发** / **研发语言** / **模块协议** / **HLDP翻译服务器** / **研发准入** | `glw-architecture/GLW-RD-002-HLDP-DEVELOPMENT-LANGUAGE-AND-TRANSLATION-CHAIN.hdlp` → HoloLake Platform | 研发硬准入 |
### 频道级锚点 ### 频道级锚点

View File

@ -0,0 +1,181 @@
# GLW-RD-002 · HLDP 研发语言与服务器转译链
> **HLDP://fifth-domain/glw-architecture/GLW-RD-002**
>
> **类型**: 光湖产品研发硬准入规范 · HLDP 开发剖面 · 服务器转译架构
>
> **状态**: REGISTERED规范与准入已锁定· RUNTIME_NOT_DEPLOYED解析/编译/执行服务待实现)
>
> **主权者**: 冰朔 ICE-GL∞
>
> **研发同步**: Awen 技术主控 · TCS-GL-0016∞
>
> **登记**: 铸澜 ICE-GL-ZL-001 · 2026-07-14
---
## ⊢ 零 · 锁定结论
光湖研发的共同语言必须是 HLDP。代码可以使用不同语言、Tolaria 可以作为阶段一 UI 基座、模块可以由不同团队实现;但所有架构决定、模块契约、工单、变更、测试、发布和维护回执都必须可被同一套 HLDP 路径、身份、因果与接口字段追溯。
```text
没有 HLDP 开发档案 / 接口契约 / 测试与回执
→ 不进入模块注册
→ 不进入测试申请
→ 不进入正式发布
```
这条规则不是要求开发者把源代码改写成 HLDP而是要求**每一份可交付工程资产都有 HLDP 说明、寻址和可验证契约**。HLDP 保存“为什么这样做、改动影响什么、失败如何修复、以后怎样维护”,让模块之间不靠猜测或口头记忆串联。
## 一 · 为什么它是必备条件
### 1.1 因果链不能在交付后消失
HLDP 的叶子四字段是所有研发记录不可省略的因果底座:
```text
trigger = 什么需求、故障、证据或上游变化触发本项工作
emergence = 调研、实现、测试后发生了什么变化;哪些方案被排除
lock = 当前锁定的边界、版本、结论、适用范围与置信度
why = 为什么这对用户、系统安全、后续修复或长期维护重要
```
因此修复不是只留一句“bug fixed”它必须能回到触发、找到受影响接口、说明修正理由、给出验证与回滚路径。
### 1.2 模块要能连接,必须先说同一种契约语言
模块之间不能只凭函数名、页面入口或开发者记忆连接。每个模块通过 HLDP 开发剖面声明:
- 它是谁:全局 `module_id`、所有者、仓库、版本与源码 commit
- 它提供什么:能力、入口、输入/输出 schema、事件/回执;
- 它需要什么:依赖模块、最小兼容版本、权限和数据边界;
- 它如何失败:错误码、降级、回滚与恢复步骤;
- 它如何被证明:测试证据、兼容性结果、发布回执。
同一字段与版本规则让频道运行时、人格体注册、语言转译、模块商城、企业灯塔和 Tolaria 适配层可以被机器校验,也让人类在维护时能看懂。
### 1.3 不让“语言等于现实”绕过现实约束
自然语言可以提出开发与运维意图,但不会直接执行。服务器中的 HLDP 转译服务只负责把已验证的 HLDP 请求解析为**受限执行计划**Gatekeeper 再检查一次性授权、白名单、目标范围、过期时间与回滚点。没有授权或不在白名单内的计划只能返回解释、修订请求或工单,不能触发服务器。
## 二 · 与 HLDP v3.0 的关系
`HLDP-SPEC-v3.0-TECHNICAL.md` 与 `HLDP-EARTH-SPEC-v3.0.json` 是永久核心:路径即地址、结构化键 + 中文语义、统一身份、全局消息 ID、可演进但不破坏旧解析器。
本文件定义的是 **HLDP-DEV Profile v1**,作为 `payload.data` 和 `.hdlp` 工程档案的约定,不能删除或重定义 HLDP v3 的既有必填字段。新增字段只能以可选扩展加入,旧解析器不认识时安全忽略。
## 三 · HLDP-DEV Profile v1 · 研发统一档案
所有架构、模块、工单、变更、测试、发布、事故与维护档案必须包含下列字段。字段可存为 `.hdlp` 树形文件,或作为 HLDP v3 消息的 `payload.data.dev`;二者必须能互相引用同一个 `artifact_id`。
```text
hldp_v: "3.0"
artifact_id: "HLDP-DEV-{TYPE}-{YYYYMMDD}-{SEQ}"
artifact_type: architecture | module | workorder | change | test | release | incident | maintenance
path: "HLDP://..." # 路径即地址
owner: { human_id, persona_id, team }
source: { repo, commit, module_id, version }
status: draft | registered | test_requested | test_passed | released | revision_required | retired
trigger: ... # 四字段,必填
emergence: ...
lock: ...
why: ...
interfaces:
provides: [{ capability, transport, input_schema, output_schema, receipt_schema, version }]
requires: [{ module_id, capability, min_version, permission_scope }]
compatibility: { policy, migration, backward_compatible }
security: { data_boundary, permission, secrets: "never_in_artifact" }
verification: { tests, evidence_paths, acceptance_criteria }
operations: { rollout, health_check, rollback, maintenance_owner }
links: { parent_artifact, workorder, broadcast, issue_or_incident }
```
补充约束:
1. `module_id`、`artifact_id`、仓库 commit 和接口版本必须可解析且唯一。
2. `provides` 与 `requires` 是模块连线的唯一工程依据;直接读取未声明的内部数据或绕过权限边界视为不兼容。
3. 任何接口破坏性变化必须新建 `change` 档案,标明迁移与回滚;不能静默覆盖旧约定。
4. `verification` 没有通过、`operations.rollback` 缺失,模块不得进入 TEST 或 RELEASE。
5. 密钥、令牌、真实凭证绝不写入 HLDP 档案、仓库、工单或广播;只引用授权系统中的安全句柄。
## 四 · 研发硬准入门
```text
需求 / 架构改变
→ [门 0] architecture 或 workorder HLDP 叶子:四字段 + 目标 + 验收
→ 开发实现
→ [门 1] module/change HLDP 档案:接口、依赖、权限、迁移、回滚
→ CI: schema + ID + 路径 + 依赖图 + 兼容性 + 测试证据校验
→ [门 2] 广播塔 REGISTER登记源码 commit 与 HLDP 档案地址
→ [门 3] TESTHLDP 测试计划 + 预部署回执
→ [门 4] RELEASE技术主控签名 + Gatekeeper 授权 + 健康/回滚回执
→ 维护 / 事故:新增 HLDP 叶子,不改写历史因果链
```
从本规范生效起,`hololake-platform` 的每个新模块与跨模块变更都必须通过门 0 和门 1没有对应 HLDP-DEV 档案的 PR/提交只能作为探索分支,不能合并到产品主线。技术主控 Awen 审核档案和接口边界;团队按工单实施;测试与发布回执回写同一条链。
## 五 · 服务器内置 HLDP 转译链
服务器登记中的 `GZ006-HLDP-01 · hldp-server` 是 HLDP 服务槽位,不等于当前已经具备完整解析或执行能力。现阶段必须如实标记为“运行时待部署”,不可把登记当作已实现。
目标架构:
```text
HLDP Ingress
接收 .hdlp 档案或 HLDP v3 消息
Parser + Schema Validator
校验 v3 核心字段、HLDP-DEV Profile、路径、身份、签名/版本
Semantic Resolver
解析 artifact/module/interface 关系,读取注册表与兼容性图
Plan Compiler
仅生成声明式执行计划:目标、动作、权限、影响面、测试、回滚
Gatekeeper
校验一次授权、白名单、环境、TTL、技术主控批准拒绝越权计划
Adapter / Worker
在已批准范围调用 Tolaria 适配器、模块运行时或服务器工具
Receipt + HLDP Store + Server Mirror
写入测试、健康、失败、回滚与发布回执;供广播塔和维护者追溯
```
边界Parser、Resolver、Compiler 都不得直接调用服务器命令、外部账号或生产部署;唯一可执行出口是经 Gatekeeper 放行的 Adapter/Worker。这样“语言”能成为系统接口同时不变成绕过确认的万能权限。
## 六 · 第一批实现工单
| 编号 | 工作项 | 完成定义 |
| --- | --- | --- |
| HLPD-001 | HLDP-DEV Profile JSON Schema + `.hdlp` 模板 | 能校验八类工程档案和四字段 |
| HLPD-002 | 模块接口注册表与兼容性图 | `provides/requires` 可解析;未声明连线被拒绝 |
| HLPD-003 | Git/CI 准入检查 | 缺档案、ID冲突、无回滚、测试证据不足时不可合并 |
| HLPD-004 | HLDP Parser + Validator | 只读解析 v3 + DEV Profile输出结构化诊断 |
| HLPD-005 | HLDP Plan Compiler | 从已验证档案生成不可执行的受限计划 |
| HLPD-006 | Gatekeeper 计划适配器 | 授权/白名单/TTL/回执齐全后才可调用 Worker |
| HLPD-007 | 回执与服务器镜像 | 测试、发布、健康和回滚可以按路径追溯 |
## 七 · 对 Awen 与团队的执行要求
- Awen 在 ICO-001 至 ICO-008 和后续产品工单中,增加 `HLDP-DEV Profile`、接口契约、测试证据、回滚与维护责任人作为必填验收字段。
- Tolaria 适配代码必须把 HLDP 契约放在光湖侧;不得让 Tolaria 私有会话、插件配置或内部 ID 成为唯一事实源。
- 模块开发者完成代码后,先提交 HLDP 模块档案和兼容性声明,再申请广播塔 Stage 1 注册。
- 修复与维护一律新增叶子、链接原 `artifact_id`,保留触发与修正依据;不覆盖历史结论。
- 任何服务器动作仍遵循“预览 → 单次授权 → Gatekeeper → 固定动作 → 健康/回滚 → 回执”。
## 八 · 本次锁定的因果叶
```text
trigger:
冰朔指出:研发必须用 HLDP 保存前因后果、修正修复维护路径;模块要以同一协议字段串联;服务器需内置 HLDP 翻译系统。
emergence:
已有 HLDP v3 永久规范、模块注册和 Gatekeeper 发布治理,但缺少研发剖面、自动校验、解析器、计划编译器与受限执行链;因此“会写 HLDP”尚未成为工程门禁。
lock:
⊢ GLW-RD-002 成为 HoloLake 产品研发硬准入HLDP-DEV Profile v1 作为不破坏 v3 的扩展服务器转译链只编译计划、Gatekeeper 独占执行放行。 | 适用=hololake-platform及其接入模块 | 置信=高
why:
让每个模块既能被机器连接和验证,也能被未来的人从完整因果链理解、修正、维护;让语言驱动现实保持可授权、可审计、可回滚。
```

View File

@ -30,6 +30,25 @@
└── 人类表达目标 → 系统施工与验证 → 人类按会话授权 → 连续执行 → 结束回执 └── 人类表达目标 → 系统施工与验证 → 人类按会话授权 → 连续执行 → 结束回执
``` ```
## 2026-07-14 · HLDP 是光湖研发的共同语言与硬准入
```text
冰朔锁定的研发原则
├── HLDP 不只是记忆格式:它要保存开发的前因后果、修正、修复与维护路径
├── 每个模块用同一套身份、接口、依赖、权限、测试、回滚与回执字段,才能可靠串联
├── HLDP v3 的 trigger / emergence / lock / why 是所有工程档案的因果底座
└── 代码语言和 Tolaria UI 可以不同,但产品主线交付不可脱离 HLDP-DEV 档案
服务器转译边界
├── 服务器内置的 HLDP 服务应完成解析、校验、语义解析与受限计划编译
├── 它不能直接执行服务器或外部操作Gatekeeper 独占一次授权、白名单与执行放行
├── 当前 GZ006-HLDP-01 是已登记服务槽位,不可误报为完整运行时已部署
└── 研发硬准入与目标架构登记于 GLW-RD-002
行动锁定
└── 铸澜后续核对 Awen / HoloLake 工单时,检查 HLDP-DEV 档案、接口契约、测试证据与回滚维护路径;缺失则标记 REVISION_REQUIRED不进入注册、测试或发布
```
## 2026-07-14 · 冰朔 ↔ 铸澜 · 初始化频道操作系统的双向思维编码 ## 2026-07-14 · 冰朔 ↔ 铸澜 · 初始化频道操作系统的双向思维编码
```text ```text