# 项目知识库索引

> 智能电商管理系统（C 端消费者 + B 端管理后台）的完整文档索引。
> **最后更新**: 2026-04-23 · **当前真相源**: 标记为 ✅ 的文档为最新权威版本。

---

## 🎯 快速导航

| 我想… | 看这个 |
|---|---|
| 了解整个系统架构 | [project-overview.md](./project-overview.md) ✅ |
| 接入 Coze Agent | [coze-integration-guide.md](./coze-integration-guide.md) ✅ |
| 接入 Dify Agent | [dify-lovable-integration.md](./dify-lovable-integration.md) ✅ |
| 开发 GenUI 组件 | [genui-api-guide.md](./genui-api-guide.md) ✅ |
| 写管理端 AI 操作 | [admin-ai-operations-guide.md](./admin-ai-operations-guide.md) ✅ |
| 协同 Lovable + Coze | [lovable-coze-collaboration-guide.md](./lovable-coze-collaboration-guide.md) ✅ |

---

## 📚 文档分类

### 🏗 架构 & 总览
- ✅ [project-overview.md](./project-overview.md) — **项目档案**：技术栈、模块、五大 Agent、关键数据流
- ✅ [system-architecture.md](./system-architecture.md) — 系统架构详解
- [coze-lovable-sync-status.md](./coze-lovable-sync-status.md) — Coze ↔ Lovable 同步现状

### 🤖 AI Agent 集成
- ✅ [coze-integration-guide.md](./coze-integration-guide.md) — Coze 接入主指南（B 端）
- [coze-consumer-agent-spec.md](./coze-consumer-agent-spec.md) — C 端 Coze Agent 规范
- [coze-issue-report-2026-02-06.md](./coze-issue-report-2026-02-06.md) — 已知问题报告
- ✅ [dify-lovable-integration.md](./dify-lovable-integration.md) — Dify 接入主指南（C 端）
- [dify-agent-config-guide.md](./dify-agent-config-guide.md) — Dify Agent 配置
- [dify-system-info-guide.md](./dify-system-info-guide.md) — Dify 系统信息接口
- [dify-page-control-guide.md](./dify-page-control-guide.md) — Dify 控制页面
- [dify-dashboard-control-guide.md](./dify-dashboard-control-guide.md) — Dify 控制仪表盘
- [langchain-agent-development-guide.md](./langchain-agent-development-guide.md) — LangChain 风格 Agent 开发

### 🎨 GenUI（动态 UI 生成）
- ✅ [genui-api-guide.md](./genui-api-guide.md) — GenUI API 与组件库
- ✅ [lovable-coze-collaboration-guide.md](./lovable-coze-collaboration-guide.md) — Lovable + Coze 协同协议

### 🛠 管理端能力
- ✅ [admin-ai-operations-guide.md](./admin-ai-operations-guide.md) — AI 自然语言操作（最新）
- [admin-operations-guide.md](./admin-operations-guide.md) — 传统管理操作 API
- [ai-audit-api.md](./ai-audit-api.md) — AI 审计接口

### 🧰 基础设施
- [e2b-sandbox-integration-guide.md](./e2b-sandbox-integration-guide.md) — E2B 沙盒集成

---

## 🧠 与 mem://（项目记忆）的关系

| 来源 | 用途 |
|---|---|
| **mem://** | 简洁规则 + 决策记录，**每次 AI 对话自动应用** |
| **docs/** | 详细技术文档，AI 按需查阅、新人入门 |
| **knowledge_base 表** | 向量化检索源，运行时 RAG 引用 |

**原则**：
- 设计决策、约束、偏好 → 写 `mem://`
- 操作步骤、API 规范、架构图 → 写 `docs/`
- 需要 AI 在运行时检索的内容 → 同步到 `knowledge_base` 表

---

## 📝 维护规则

1. 新增文档时，必须在本索引列出并标记是否为权威版本（✅）
2. 文档过时时，标注 `> ⚠️ DEPRECATED · 见 xxx.md`
3. 重大架构变更需同步更新：本索引 + `mem://index.md` + `system_guide` 表
