95 lines
3.4 KiB
Markdown
95 lines
3.4 KiB
Markdown
L1: global_mem_insight.txt (极简索引层 - 严格控制 ≤50 行)
|
||
↓ 导航指向
|
||
L2: global_mem.txt (事实库层 - 现短但会膨胀)
|
||
↓ 详细引用
|
||
L3: ../memory/ (记录库层 - 包含 .md/.py 等各类文件)
|
||
|
||
---
|
||
|
||
## 各层职责与原则
|
||
|
||
### L1：全局内存索引 (global_mem_insight.txt)
|
||
|
||
**职责**：为 L2 和 L3 提供极简导航索引。
|
||
|
||
**特征**：
|
||
- 体积限制：≤ 50 行（硬约束）
|
||
- 内容：CONSTITUTION、STORES、ACCESS、TOPICS、LESSONS_LEARNED
|
||
- 更新：L2 有新增/删除事实时同步；发现通用规律时追加 LESSONS
|
||
|
||
**禁止**：详细说明、过程记录、单次修复日志
|
||
|
||
---
|
||
|
||
### L2：全局事实库 (global_mem.txt)
|
||
|
||
**职责**：存储全局环保性事实（路径、凭证、配置等）。
|
||
|
||
**特征**：
|
||
- 趋势：随环境扩展而膨胀（可接受）
|
||
- 内容：按 `## [SECTION]` 组织的事实条目
|
||
- 同步：变化时更新 L1 的相应 TOPIC 导航行
|
||
|
||
---
|
||
|
||
### L3：详细记录库 (../memory/)
|
||
|
||
**职责**：存储所有 L1/L2 无法容纳的详细信息。
|
||
|
||
**特征**：
|
||
- 文件类型：.md、.py 等各类文件均可
|
||
- 膨胀容限：无限制
|
||
- 组织：按功能分类（mail/、vision/ 等）或文件类型（SOP、工具脚本、日志）
|
||
- 文件命名：*_sop.md（流程）、*_log.md（日志）、.py（工具脚本）
|
||
|
||
**管理**：
|
||
- 工具脚本 + 详细 SOP → L3 对应文件
|
||
- 维护日志、过程记录 → L3 maintenance_log.md
|
||
- 单次修复、实验 → L3 存放或删除，不入 L1 LESSONS
|
||
|
||
**L3 中 SOP 与工具脚本的分工**：
|
||
- SOP（*_sop.md）
|
||
- 主要用途：记录**坑**。
|
||
- 重点写：以后再做同类任务时最容易出问题的环节、前置条件、环境/配置坑，以及当前已验证有效的解决办法和排查思路。
|
||
- 何时记录步骤：
|
||
- 只有在任务是**复杂、多步、长链路**时，才顺带把关键步骤流程写清楚，方便整体复现；
|
||
- 对于简单、直观、模型按常识就能完成的任务，**不需要在 SOP 里记完整步骤**。
|
||
- 工具脚本 / util（*.py 等）
|
||
- 前提：只有当某块逻辑具备**清晰边界和函数独立性**，且**有明显复用价值**时，才封装成工具脚本。
|
||
- 典型用途：
|
||
- 像自定义 Python 包那样，把稳定功能做成可多次调用的函数 / 模块；
|
||
- 当某任务“坑太多、文字 SOP 难以说清”时，把稳定的处理逻辑直接写成代码函数，让上层只需调用，不必每次重新踩坑。
|
||
|
||
---
|
||
|
||
## L1 ↔ L2 同步规则
|
||
|
||
| L2 操作 | L1 同步 |
|
||
|---------|--------|
|
||
| 新增事实 | 在 TOPICS.GLOBAL_MEM 添加导航行 |
|
||
| 删除事实 | 在 TOPICS.GLOBAL_MEM 删除导航行 |
|
||
| 修改值 | 保持导航行不变 |
|
||
|
||
---
|
||
|
||
## 信息分类快速决策树
|
||
|
||
```
|
||
"这条信息该放哪层？"
|
||
|
||
是『全局环保事实』? (IP、路径、凭证、ID、API 密钥等)
|
||
├─ YES → L2 (global_mem.txt)
|
||
│ 然后 → L1 [TOPICS.GLOBAL_MEM] 添加导航行
|
||
│
|
||
└─ NO
|
||
↓
|
||
是『可重复使用的通用规律』? (工具用法、排查方法)
|
||
├─ YES → L1 [LESSONS_LEARNED]
|
||
│ 并可在 L3 写详细解释
|
||
│
|
||
└─ NO → L3 (../memory/)
|
||
- 过程/日志 → maintenance_log.md
|
||
- 工具文档 → *_sop.md
|
||
- 可复用代码函数 → .py 文件
|
||
- 临时实验 → 删除
|
||
``` |