745 lines
5.0 KiB
Markdown
745 lines
5.0 KiB
Markdown
# GLS-0002
|
||
|
||
# **Modular Numbered Path Standard**
|
||
|
||
# **光湖模块编号路径标准（Draft v1.0）**
|
||
|
||
**0. 定义**
|
||
|
||
MNPS
|
||
|
||
(Modular Numbered Path Standard)
|
||
|
||
即：
|
||
|
||
**模块编号路径标准。**
|
||
|
||
MNPS 是 Guanghu Language Standard（GLS）的基础工程规范之一。
|
||
|
||
它规定：
|
||
|
||
整个光湖语言系统，
|
||
|
||
如何组织：
|
||
|
||
协议。
|
||
|
||
模块。
|
||
|
||
文档。
|
||
|
||
路径。
|
||
|
||
编号。
|
||
|
||
版本。
|
||
|
||
索引。
|
||
|
||
依赖。
|
||
|
||
任何工程实现，
|
||
|
||
均应遵循 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
|
||
|
||
持续成长、
|
||
|
||
持续演化、
|
||
|
||
持续维护、
|
||
|
||
持续扩展
|
||
|
||
的基础工程能力。 |