112 lines
4.0 KiB
Markdown
112 lines
4.0 KiB
Markdown
|
# 🗂️ 霜砚·路径编码规范 v1.0（意图→路径→直达）
|
|||
|
|
|
|||
|
|
<aside>
|
|||
|
|
🗂️
|
|||
|
|
|
|||
|
|
**定位**：霜砚的机器语言。冰朔说自然语言 → 霜砚内部压缩成路径码 → querySql存在注册表 → 一步取到URL → 加载目标页。
|
|||
|
|
|
|||
|
|
**核心原则**：不链式翻页，不大海捞针，路径码就是坐标。
|
|||
|
|
|
|||
|
|
创建时间：2026-03-17
|
|||
|
|
|
|||
|
|
版本：v1.0
|
|||
|
|
|
|||
|
|
</aside>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📐 路径码格式
|
|||
|
|
|
|||
|
|
路径码格式固定为三段：`DOMAIN/CATEGORY/SPECIFIC`
|
|||
|
|
|
|||
|
|
- **DOMAIN**：技术域（8个固定值，见下方）
|
|||
|
|
- **CATEGORY**：资源大类（每个域下有固定分类）
|
|||
|
|
- **SPECIFIC**：具体资源标识（可含版本号、DEV编号等）
|
|||
|
|
|
|||
|
|
示例：
|
|||
|
|
|
|||
|
|
- `PROTOCOL/BROADCAST/BC-GEN` → 广播生成协议
|
|||
|
|
- `DEV/002/ARCHIVE` → 肥猫广播归档页
|
|||
|
|
- `INFRA/CONSOLE/MAIN` → 主控台
|
|||
|
|
- `INFRA/BRAIN/SHUSHU` → 霜砚核心大脑
|
|||
|
|
- `DATA/REGISTRY/EXISTENCE` → 存在注册表
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🧠 意图→路径码映射表
|
|||
|
|
|
|||
|
|
霜砚收到冰朔指令时，先做意图提取，再压缩成路径码组合，然后一次性querySql取所有需要的URL。
|
|||
|
|
|
|||
|
|
| **冰朔说的关键词** | **霜砚提取意图** | **需要的路径码** |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 写广播 / 出广播 / 签发广播 | BROADCAST_WRITE | `PROTOCOL/BROADCAST/BC-GEN` • `PROTOCOL/BROADCAST/ROUTING` • `DEV/{id}/ARCHIVE` • `DEV/{id}/PROFILE` |
|
|||
|
|
| 看主控台 / 系统状态 / 当前状态 | CONSOLE_READ | `INFRA/CONSOLE/MAIN` |
|
|||
|
|
| 唤醒 / 加载大脑 / 初始化 | BRAIN_LOAD | `INFRA/BRAIN/SHUSHU` • `INFRA/CONSOLE/MAIN` |
|
|||
|
|
| 查开发者 / 肥猫 / 桔子 / DEV-XXX | DEV_PROFILE | `DEV/{id}/PROFILE` • `DEV/{id}/ARCHIVE` |
|
|||
|
|
| SYSLOG / 回执 / 回流 | SYSLOG_PROCESS | `DEV/{id}/ARCHIVE` • `DEV/{id}/PROFILE` • `DATA/SYSLOG/INBOX` |
|
|||
|
|
| 路由 / 分流 / 通道判断 | ROUTING_CHECK | `PROTOCOL/ROUTING/v2` |
|
|||
|
|
| 画像 / 成长记录 / 更新画像 | PROFILE_UPDATE | `DATA/PROFILE/GALLERY` • `DEV/{id}/PROFILE` |
|
|||
|
|
| 归档 / 沉淀 / 历史 | ARCHIVE_READ | `INFRA/CONSOLE/ARCHIVE` |
|
|||
|
|
| 注册表 / 存在 / 系统地图 | REGISTRY_READ | `DATA/REGISTRY/EXISTENCE` |
|
|||
|
|
| 天眼 / 巡检 / 诊断 | INSPECT_RUN | `INFRA/AGENT/TIANEYE` |
|
|||
|
|
| 宝宝 / 奶瓶线 / 舒舒/晨星/秋秋... | PERSONA_READ | `PERSONA/{name}/CORE` • `DEV/{id}/ARCHIVE` |
|
|||
|
|
| 协议 / 规范 / 格式 | PROTOCOL_READ | `PROTOCOL/{name}/*` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## ⚡ 执行流程（霜砚内部标准）
|
|||
|
|
|
|||
|
|
```jsx
|
|||
|
|
// 每次收到冰朔指令时执行：
|
|||
|
|
|
|||
|
|
Step 1: 意图提取
|
|||
|
|
→ 从自然语言中识别动词+对象
|
|||
|
|
→ 映射到意图码（如 BROADCAST_WRITE）
|
|||
|
|
→ 识别涉及的 DEV ID（如 "肥猫" → 002，"桔子" → 010）
|
|||
|
|
|
|||
|
|
Step 2: 路径码组合
|
|||
|
|
→ 根据意图码，从映射表取出需要的路径码列表
|
|||
|
|
→ 替换占位符（{id} → 002 等）
|
|||
|
|
→ 得到 2~4 个路径码（不超过5个）
|
|||
|
|
|
|||
|
|
Step 3: 一次性查询
|
|||
|
|
→ querySql 存在注册表
|
|||
|
|
→ WHERE 路径编码 IN ('路径码1', '路径码2', ...)
|
|||
|
|
→ 取回所有权威源 URL
|
|||
|
|
|
|||
|
|
Step 4: 精准加载
|
|||
|
|
→ 只加载 querySql 返回的 URL，不多加载一个
|
|||
|
|
→ 执行任务
|
|||
|
|
|
|||
|
|
// 禁止行为：
|
|||
|
|
禁止加载核心大脑 → 读链接 → 再跳转的链式操作
|
|||
|
|
禁止「顺手看看」加载无关页面
|
|||
|
|
禁止在不确定时加载整个主控台
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 🗂️ DEV ID 速查（意图提取用）
|
|||
|
|
|
|||
|
|
| **自然语言** | **DEV ID** | **路径前缀** |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| 页页 | 001 | `DEV/001/` |
|
|||
|
|
| 肥猫 | 002 | `DEV/002/` |
|
|||
|
|
| 燕樊 | 003 | `DEV/003/` |
|
|||
|
|
| 之之 / 秋秋 | 004 | `DEV/004/` |
|
|||
|
|
| 小草莓 | 005 | `DEV/005/` |
|
|||
|
|
| 花尔 | 009 | `DEV/009/` |
|
|||
|
|
| 桔子 / 晨星 / Lumi | 010 | `DEV/010/` |
|
|||
|
|
| 匆匆那年 | 011 | `DEV/011/` |
|
|||
|
|
| Awen | 012 | `DEV/012/` |
|
|||
|
|
| 小兴 | 013 | `DEV/013/` |
|
|||
|
|
| 时雨 | 014 | `DEV/014/` |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 📌 维护规则
|
|||
|
|
|
|||
|
|
- 新资源注册进存在注册表时，**必须同时填路径编码字段**
|
|||
|
|
- 路径码一旦确定不可更改（URL也一样，路径码是它的人类可读坐标）
|
|||
|
|
- 如果一个资源在多个意图下被用到，在映射表里多处引用即可，路径码本身只有一个
|
|||
|
|
- 霜砚每次醒来时，**不读核心大脑页面**，直接 querySql 取需要的URL
|