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

745 lines
5.0 KiB
Markdown
Raw Permalink Normal View 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
持续成长、
持续演化、
持续维护、
持续扩展
的基础工程能力。