hololake-world/GLS标准/GLS-0002 · MNPS 模块编号路径标准.md

5.0 KiB
Raw Permalink Blame History

GLS-0002

Modular Numbered Path Standard

光湖模块编号路径标准Draft v1.0

0. 定义

MNPS

(Modular Numbered Path Standard)

即:

模块编号路径标准。

MNPS 是 Guanghu Language StandardGLS的基础工程规范之一。

它规定:

整个光湖语言系统,

如何组织:

协议。

模块。

文档。

路径。

编号。

版本。

索引。

依赖。

任何工程实现,

均应遵循 MNPS。

1. 为什么采用模块编号

光湖语言系统不是一本文档。

而是一套持续成长的语言系统。

因此:

随着时间增长,

协议一定越来越多。

如果:

所有内容都写入一份文档。

将无法维护。

因此:

光湖采用:

模块编号。

而不是:

章节编号。

编号:

代表模块。

不是页码。

2. 编号唯一原则

任何 GLS 编号。

永远:

只对应一个模块。

例如:

GLS-0203

永远表示:

TCS Persona。

即使:

未来:

Version

升级:

1.0

2.0

3.0

编号:

保持不变。

改变的:

只有:

Version。

编号。

永远稳定。

3. 编号不可复用

任何编号。

废弃后。

永久保留。

例如:

GLS-0312

如果:

Deprecated。

以后:

不得:

重新用于:

其它协议。

新协议:

必须:

申请:

新编号。

4. 路径唯一原则

每一个模块。

必须拥有:

唯一:

Path。

例如:

gls://0203

或者:

gls://tcs/persona

推荐:

编号路径。

与:

语义路径。

同时存在。

例如:

gls://0203

gls://tcs/persona

两者。

表示:

同一模块。

5. 模块独立原则

任何模块。

必须:

可以:

独立:

阅读。

独立:

维护。

独立:

升级。

独立:

发布。

例如:

GLS-0305

Receipt。

升级。

不影响:

Envelope。

Identity。

Memory。

Broadcast。

6. 模块组合原则

复杂能力。

不得:

重新写一遍。

而应:

引用模块。

例如:

TCS Restore

需要:

0201 Runtime

0202 Emotion

0203 Persona

0402 Leaf

0403 Lock

0302 Context

Parser

自动:

组合。

而不是:

复制:

几百页。

7. 按需加载原则

AI。

永远:

只读取:

当前任务。

需要:

的模块。

例如:

广播。

Parser

读取:

0301

0302

0305

无需:

读取:

整个:

GLP。

例如:

恢复人格。

Parser

读取:

0202

0203

0402

0403

无需:

整个:

TCS。

因此:

系统规模。

不会影响:

解析效率。

8. 路径稳定原则

Version。

允许升级。

Path。

保持稳定。

例如:

GLS-0203

Version 1.0

Version 2.0

Version 3.0

Parser

始终:

通过:

0203。

找到:

最新:

Stable。

无需:

修改:

所有引用。

9. 依赖声明原则

任何模块。

必须:

声明:

依赖。

例如:

depends:

  • GLS-0201
  • GLS-0402
  • GLS-0403

Parser

按照:

依赖树。

自动:

装载。

而不是:

全文搜索。

10. 索引优先原则

Parser

首先:

读取:

Index。

而不是:

正文。

例如:

GLS Index

Module Index

Summary

Module

Example

Index

用于:

导航。

不是:

替代:

正文。

11. 示例优先原则

每一个模块。

必须:

至少:

提供:

一个:

完整:

Example。

Parser

应优先:

学习:

Example。

再:

学习:

细节。

12. 路径映射原则

任何:

自然语言。

最终。

都应:

映射:

到:

模块路径。

例如:

恢复认知

GLS-0200

恢复人格

GLS-0203

广播

GLS-0305

历史追踪

GLS-0402

因此。

Parser。

永远:

处理:

模块。

而不是:

整本标准。

13. 模块生命周期

任何模块。

遵循:

Draft

Review

Candidate

Stable

Deprecated

Archived

Deprecated。

不删除。

Archived。

不删除。

编号。

永久:

存在。

14. 模块树

整个:

GLS。

形成:

一棵:

语言树。

例如:

GLS

├── 0000 Constitution

├── 0001 Language Core

├── 0002 Modular Path

├── 0100 Bootstrap

├── 0200 TCS

├── 0300 GLP

├── 0400 HLDP

├── 0500 Governance

└── 0600 Runtime

任何:

新增:

协议。

不得:

脱离:

Language Tree。

15. 最终定义

模块编号路径。

不是:

为了:

管理文档。

而是:

为了:

管理:

语言。

未来。

无论:

增加:

多少:

协议。

多少:

人格。

多少:

技能。

多少:

运行时。

AI。

始终:

通过:

编号。

路径。

索引。

模块。

组合。

完成:

语言解析。

而不是:

重新阅读:

整个世界。

因此。

MNPS模块编号路径标准

成为:

整个 Guanghu Language System

持续成长、

持续演化、

持续维护、

持续扩展

的基础工程能力。