# 7-77 mnote-e2e 知识中枢架构 v1

> 状态：`process` · 可执行设计（落地 skill 前的 SSOT）  
> 范围：AI 主体 `mnote-e2e` 工作区 + 多 AI / Admin 共用的**系统·项目知识中枢**  
> 非目标：替换 LightRAG；替换 vault 读密；替代全局 self-improving 记忆循环  
> 前置：Web PAT（笔记 CRUD）与 vault mnv1（读密）已分职；本设计只落**可读 Markdown 真源**

---

## 1. 问题与目标

### 1.1 要解决什么

- 重复查 skill 路径、服务器 URL、运维约定；
- 系统级配置散落在聊天 / 临时文件里；
- 项目上下文与全局基建混杂，难给 **Admin 复核** 与 **多 AI 共用**。

### 1.2 产品定位

**知识中枢 = 系统重要信息 + 项目重要信息的「索引 · 导航 · 积累」层。**  
Admin 与 AI 共用同一套 Markdown 树；LightRAG 是可选增强，不是唯一入口。

### 1.3 边界

| 概念 | 本中枢关系 |
|------|------------|
| self-improving-for-codex | 不替代；行为记忆仍在 agent 侧 |
| LightRAG | 可选索引 `00-system` + 显式项目；排除 inbox/archive/系统点目录 |
| vault / mnv1 | 正文禁止密文；只写 credential 指针 |
| Web PAT | e2e 工作区 CRUD 通道 |
| 全局 skill / AGENTS | 工作区 `AGENTS.md` 强制「先查中枢」 |

### 1.4 成功标准

1. Admin 打开 e2e 工作区根即可浏览系统/项目知识。  
2. AI 默认先读 `INDEX.md` 再动手。  
3. 秘密只在 vault。  
4. Admin 可清 inbox、删冗余、批注待更新。  
5. 结构稳定到可做成 skill。

---

## 2. 真源与放置

### 2.1 工作区

```text
主体：mnote-e2e（ai_service）
根：  /mnt/Data1T/Mnote_data/users/mnote-e2e/workspaces/my-space
鉴权：Web PAT notes.* + tree.*
读密：mnv1（与中枢分离）
```

### 2.2 中枢根 = 工作区根（无额外 00-hub 层）

**决策（2026-07-28）**：不再套 `00-hub/`。e2e 工作区几乎整仓即知识中枢，多一层路径长、心智重复。

```text
my-space/                         # ← 中枢根
  AGENTS.md                       # 工作区纪律（启动入口）
  README.md                       # 中枢是什么、怎么用
  INDEX.md                        # 总索引（启动必读，短）
  00-system/                      # 通用 / 系统级
  10-projects/                    # 分项目
  90-inbox/                       # AI 草稿，Admin 晋升
  99-archive/                     # 过期
  .mnote/  ai-sessions/  …        # 系统目录：不进索引、不进 RAG 默认范围
```

**约定**

| 类别 | 路径 | 是否知识树 |
|------|------|------------|
| 知识正文 | `INDEX.md`、`00-system/**`、`10-projects/**`、`90-inbox/**`、`99-archive/**` | 是 |
| 系统运行时 | `.mnote/**`、`ai-sessions/**`、`.reasonix/**`、`.codegraph/**` | **否** |

> 实测：e2e PAT 已验证 tree 创建/重命名/删除 + `resource/read|write`；用户试探文档已清理。

---

## 3. 信息架构

### 3.1 分层纪律（必守）

| 层 | 放什么 | 不放什么 |
|----|--------|----------|
| **`00-system`** | **主机与基建**：Kubuntu、OrangeVPS、heyun；VPN/frp；全机 skill；系统凭证指针 | MNote 应用账号（mnote-e2e 等）、产品端口 3000/3003、PAT/mnv1 产品细则 |
| **`10-projects/*`** | 产品与项目：身份、业务端口、架构、runbook | 把 heyun/Kubuntu 主机表重复抄一套当「项目」而不链系统层 |

### 3.2 `00-system/`（系统 / 主机）

```text
00-system/
  INDEX.md
  01-hosts/          # Kubuntu / OrangeVPS / heyun（可达性备注）
  02-skills/         # 全机 skill 登记
  03-network/        # 代理 profile、frp 约定
  04-endpoints/      # 系统向入口（代理/面板）；产品入口链到项目
  05-repos/          # 本机仓库与数据路径
  06-agents-runtime/ # 本机 agent 宿主
  07-credentials-map/# 系统凭证指针（无密文）
  08-ops-runbooks/   # 主机/网络运维
  09-governance/     # 中枢治理
```

### 3.3 `10-projects/<slug>/`

```text
10-projects/
  INDEX.md
  mnote-core/        # 含 identity.md、endpoints.md（产品端口）
  ai-runtime/        # 含 credentials.md（PAT/mnv1/AI 密码本指针）
  infra-ops/         # 部署视图；主机真源仍链 00-system/01-hosts
  <slug>/
    README.md  INDEX.md  architecture.md  runbook.md
    decisions.md  glossary.md  open-questions.md  links.md
```

### 3.4 inbox / archive

| 区 | 写 | 默认启动读 |
|----|----|------------|
| `90-inbox/` | AI 草稿 | 否 |
| `99-archive/` | 归档 | 否 |

---

## 4. 安全与索引纪律

1. 禁止 password / apikey / cookie / mnpat1 / mnv1 明文。  
2. 凭证只写：subject、credentialId、用途、字段名。  
3. 启动只读：`AGENTS.md` → `INDEX.md` → 按需子 INDEX。  
4. 清单用表格 + 链接；明细按需打开。

---

## 5. 角色

| 角色 | 读 | 写 | 删 system 核心 |
|------|----|----|----------------|
| Admin | 全部 | 全部 | 可 |
| AI（e2e PAT） | 工作区知识树 | inbox + 受控更新 catalog | 禁止擅自删 |
| 其他用户 | 无 membership 则不可见 | — | — |

---

## 6. 后续接线

- 工作区 `AGENTS.md`：先查中枢、禁密文、inbox 规则。  
- Skill：`$mnote-e2e-knowledge-hub`  
  - 真源：`~/.codex/skills/mnote-e2e-knowledge-hub/`  
  - Grok symlink：`~/.grok/skills/mnote-e2e-knowledge-hub`  
  - 含 worker 模板：`references/worker-prompts.md` · 结构：`references/structure.md`  
- LightRAG：默认可挂 `00-system/**`；项目 opt-in；排除 inbox/archive/点目录。

---

## 7. 落地阶段

| 阶段 | 内容 | 状态 |
|------|------|------|
| A | 以 e2e 根建树 + 占位 INDEX | **done** |
| B | 填 skills/servers/identity 实表（kb2/kb3 充实） | **done**（可持续更新） |
| C | skill + 完善 AGENTS.md | **done**（2026-07-29） |

---

## 8. 反模式

- 密文进 Markdown  
- 每 AI 各建一套 hub  
- 把 `ai-sessions` 当知识  
- 镜像整个 git 仓库  
- AI 静默删 `00-system` 核心页  
- ~~多包一层无必要的 `00-hub/`~~（已否决）

---

## 9. 开放问题

1. skill 登记：半自动扫盘 + Admin 审？  
2. `design/**` 以 pointer 链入（推荐）还是摘要复制？  

---

## 变更记录

| 日期 | 说明 |
|------|------|
| 2026-07-28 | 初稿：含 `00-hub` 层 |
| 2026-07-28 | **改中枢根 = e2e 工作区根**，去掉 `00-hub`；并落地目录骨架 |
| 2026-07-28 | **纠正分层**：系统级 = 主机（Kubuntu/OrangeVPS/heyun）与基建；mnote-e2e 身份/产品端口下沉 `10-projects` |
| 2026-07-29 | 落地 skill `$mnote-e2e-knowledge-hub`（Codex 真源 + Grok 链接）；阶段 B/C 收口 |