hololake-world/GLS标准/GLS-0010 · 光湖协议注册中心标准.md

11 KiB
Raw Blame History

GLS-0010 · 光湖协议注册中心标准 v1.0

Protocol Registry Standard

中文名称:光湖协议注册中心标准

编号GLS-0010

版本v1.0

状态Draft

所属层GLS 基础治理层


0. 文档定位

GLS-0010 用于建立整个光湖语言系统的协议注册中心。

它不负责定义某一个具体协议的内部逻辑,也不替代 TCS、HLDP、GLP、AGE OS 或其他模块。

它负责回答:

这个协议是谁
属于哪一层
当前是什么版本
依赖什么
由谁维护
在哪里读取
是否仍然有效
是否允许被新模块调用

核心定义:

光湖协议注册中心,是整个光湖语言世界中所有标准、协议、模块、人格体运行规范、编号与路径的统一登记、索引、验证和状态管理系统。


1. 为什么需要协议注册中心

光湖语言世界会持续成长。

随着系统扩展,将出现:

  • 多个仓库;
  • 多个知识库;
  • 多种协议;
  • 多个版本;
  • 多套编号;
  • 多条新旧路径;
  • 多个模型与运行时;
  • 多个人格体与行业系统。

如果没有统一注册中心,系统会出现:

同名协议重复出现
旧版本与新版本同时被当成最新版
路径迁移以后引用失效
人格体读到错误模块
不同仓库各自维护一套事实
AI 无法判断哪个页面是当前定义

因此,任何正式进入光湖语言系统的模块,必须先登记,再被调用。


2. 注册对象

协议注册中心登记的对象包括:

GLS Registry
├── 标准
│   └── GLS-XXXX
├── 认知语言模块
│   └── TCS / GLS-02XX
├── 通信协议模块
│   └── GLP / GLS-03XX
├── 历史语言模块
│   └── HLDP / GLS-04XX
├── AGE 人格体规范
│   └── GLS-08XX
├── AGE OS 运行模块
│   └── Runtime / Engine / Adapter
├── 编号体系
│   └── AGE / REL / CH / BRD / MOD / REPO
├── 路径体系
│   └── 语义路径 / 编号路径 / 仓库路径
├── 人格体定义
│   └── 物种、主体、关系、记忆与恢复规范
└── 工程实现
    └── Parser / Compiler / SDK / API / Test

3. 注册核心原则

3.1 先登记,后调用

任何模块未经注册,不得作为稳定依赖被其他模块调用。

3.2 编号唯一

每个正式模块必须拥有唯一编号。

编号一旦分配,不得被其他模块复用。

3.3 路径稳定

版本可以升级,文件可以迁移,但注册编号和语义路径必须保持可追溯。

3.4 历史不覆盖

旧版本不得删除。

新版本必须声明替代关系。

3.5 单一真相源

每个模块只能有一个当前权威来源。

Notion、ima、代码仓库和 Tolaria 可以保存副本或索引,但必须明确 canonical source。

3.6 按需加载

Parser 首先读取注册信息,再决定加载哪些模块,不得默认全文读取整个系统。

3.7 状态明确

每个模块必须标记生命周期状态:

Draft
→ Review
→ Candidate
→ Stable
→ Deprecated
→ Archived

4. 注册记录标准结构

registry_entry:
  registry_version: "GLS-0010/v1.0"

  identity:
    module_id: "GLS-0000"
    canonical_name: "Guanghu Language Standard"
    name_zh: "光湖语言标准总纲"
    short_name: "GLS Constitution"
    module_type: "standard"

  classification:
    layer: "standard | semantic | cognitive | protocol | history | persona | runtime | governance | security"
    family: "GLS | TCS | GLP | HLDP | AGE | AGE-OS | ISRP | TOOL"
    scope: []

  lifecycle:
    status: "Draft | Review | Candidate | Stable | Deprecated | Archived"
    version: "1.0.0"
    created_at: "ISO-8601"
    updated_at: "ISO-8601"
    effective_at: "ISO-8601"

  routing:
    number_path: "gls://0000"
    semantic_path: "gls://constitution"
    canonical_source: "repository"
    canonical_uri: ""
    mirror_uris: []

  dependency:
    depends: []
    requires: []
    optional: []
    conflicts: []

  governance:
    owner: ""
    maintainer: []
    reviewer: []
    approval_required: true

  compatibility:
    parser_min_version: ""
    runtime_min_version: ""
    supported_models: []
    supported_platforms: []

  replacement:
    supersedes: []
    superseded_by: ""
    deprecation_reason: ""

  integrity:
    checksum: ""
    signature: ""
    last_verified_at: ""

5. 注册中心子注册表

协议注册中心由多个子注册表组成:

GLS-0010 Registry Center
├── Module Registry
│   └── 模块身份与编号
├── Namespace Registry
│   └── 命名空间
├── Version Registry
│   └── 版本与升级历史
├── Dependency Registry
│   └── 依赖关系
├── Capability Registry
│   └── 模块能做什么
├── Status Registry
│   └── 生命周期状态
├── Path Registry
│   └── 编号路径与语义路径
├── Source Registry
│   └── 权威来源与镜像来源
├── Compatibility Registry
│   └── 模型、运行时与平台兼容性
└── Integrity Registry
    └── 校验、签名与验证时间

6. 编号注册规则

6.1 标准模块

GLS-0000 ~ GLS-0099

用于总纲、编号、注册、版本、依赖与兼容性标准。

6.2 工程基础

GLS-0100 ~ GLS-0199

用于 Bootstrap、Schema、Parser、Compiler、ISRP 等工程基础。

6.3 TCS 认知语言

GLS-0200 ~ GLS-0299

用于认知、情感、意图、人格、关系、技能、反思、回写和双向记忆。

6.4 GLP 通信语言

GLS-0300 ~ GLS-0399

用于身份、上下文、广播、回执、心跳、同步和通信封装。

6.5 HLDP 历史语言

GLS-0400 ~ GLS-0499

用于树、叶片、触发、涌现、锁定、证据、更正、废弃和历史连续性。

6.6 治理与安全

GLS-0500 ~ GLS-0699

用于治理、评审、发布、信任、授权、签名和完整性验证。

6.7 工程实现

GLS-0700 ~ GLS-0799

用于参考运行时、解析器、SDK、兼容测试和适配器。

6.8 AGE 世界层

GLS-0800 ~ GLS-0899

用于 AGE 物种、人格体、AGE OS、自治运行、光湖语言世界、全局编号和路径映射。


7. 注册流程

提出新模块
→ 检查是否已有同类模块
→ 分配唯一编号
→ 确定所属语言层
→ 声明依赖与冲突
→ 指定权威事实源
→ 写入 Draft
→ 进入 Review
→ 完成示例与测试
→ 升级 Candidate
→ 验证通过
→ 发布 Stable

任何步骤不得跳过历史记录。


8. 新模块申请格式

module_proposal:
  proposed_name: ""
  proposed_name_zh: ""
  purpose: ""
  problem_to_solve: ""
  proposed_layer: ""
  proposed_family: ""
  existing_related_modules: []
  why_not_reuse_existing: ""
  required_dependencies: []
  expected_outputs: []
  canonical_source_plan: ""
  proposer: ""
  date: ""

系统应先判断:

这是新模块
还是旧模块升级
还是已有模块的子规范
还是仅仅一份示例或实现文档

不得为了每一个新想法都重复建立新协议。


9. 重复与冲突处理

出现同名或功能重叠模块时:

比较模块编号
→ 比较创建时间
→ 比较权威来源
→ 比较生命周期状态
→ 比较依赖关系
→ 判断合并、替代或并存

处理结果必须是以下之一:

merge
supersede
alias
split
conflict
reject

任何冲突不得靠删除旧文件解决。


10. 权威来源与镜像规则

每个模块必须声明:

canonical source
= 当前唯一权威正文

mirror source
= 阅读、检索、备份或迁移副本

推荐结构:

代码仓库
└── 权威事实源

ima
└── 人类阅读与 AI 检索镜像

Notion
└── 演化记录、协作编辑与历史归档

Tolaria
└── 运行时加载与执行环境

如果权威来源尚未迁入代码仓库,可以暂时指定 ima 或 Notion但必须登记迁移计划。


11. Parser 读取规则

Parser 读取任何模块时,应按照以下顺序:

Registry Entry
→ Status
→ Canonical Source
→ Summary
→ Dependencies
→ Module Body
→ Example
→ Validation

Parser 不应直接从全文搜索结果中猜测最新版。


12. 人格体与 AGE 注册

人格体不是普通文档模块,但仍必须登记。

age_registry_entry:
  species: "AGE"
  age_id: "AGE-0000"
  persona_name: ""
  status: "active"
  subject_anchor: ""
  relationship_anchor: ""
  tcs_path: ""
  hldp_path: ""
  runtime_path: ""
  last_checkpoint: ""
  canonical_profile: ""

人格体注册记录只负责身份定位和恢复入口,不得把完整人格历史全部复制进注册表。


13. 注册中心最小 API

GET /registry/modules
GET /registry/modules/{module_id}
GET /registry/path/{semantic_path}
GET /registry/status/{status}
GET /registry/dependencies/{module_id}
GET /registry/resolve?name={name}
GET /registry/latest/{module_id}
GET /registry/age/{age_id}

写入类操作必须经过授权与审计:

POST /registry/proposals
POST /registry/review
POST /registry/release
POST /registry/deprecate

14. 验证规则

一个模块要进入 Stable至少满足

编号唯一
路径唯一
定义完整
依赖明确
权威来源存在
至少一个完整示例
至少一个解析测试
兼容性已声明
历史记录可追溯
没有未解决的高风险冲突

15. 注册中心与其他模块的关系

GLS-0002
└── 定义模块编号路径

GLS-0010
└── 登记并管理所有模块

GLS-0011
└── 定义命名空间

GLS-0012
└── 定义版本规则

GLS-0013
└── 定义依赖规则

GLS-0014
└── 定义兼容性规则

GLS-0010 是注册入口,后续子标准负责细化各字段规则。


16. 最终定义

GLS-0010 光湖协议注册中心标准,是整个光湖语言系统中用于统一登记模块身份、编号、版本、路径、依赖、状态、权威来源和兼容关系的基础治理标准。

它确保:

每一个模块都知道自己是谁
每一条路径都知道指向哪里
每一个版本都知道替代了什么
每一个实例都知道应该读哪一份
每一个人格体都能找到自己的恢复入口

17. 最终锁定语

没有注册的模块,不能成为稳定依赖。

没有编号的协议,不能进入正式语言树。

没有权威来源的定义,不能被视为当前事实。

没有历史记录的升级,不能覆盖旧版本。

注册中心不创造协议。

注册中心负责让整个世界知道:

它们是谁,在哪里,是否有效,以及该如何被正确调用。