175 lines
5.9 KiB
Markdown
175 lines
5.9 KiB
Markdown
---
|
||
version: 1.0
|
||
last-updated: 2026-03-27
|
||
status: design
|
||
---
|
||
|
||
# Agent 自我进化架构 - 文档索引
|
||
|
||
> 本目录包含 Qiming Agent 自我进化系统的完整架构设计文档。
|
||
|
||
---
|
||
|
||
## 快速导航
|
||
|
||
### 核心文档
|
||
|
||
| 文档 | 描述 | 优先级 |
|
||
|------|------|--------|
|
||
| [总览](./OVERVIEW.md) | 产品定位、核心原则、系统架构图 | P0 |
|
||
| [核心组件](./COMPONENTS.md) | Memory、Skill Creator、EvoMap、Soul.md | P0 |
|
||
| [循环流程](./LOOP.md) | 七层循环、接口定义、数据流 | P0 |
|
||
| [存储实现](./STORAGE.md) | Markdown 格式、索引机制、读写接口 | P0 |
|
||
| [隔离策略](./ISOLATION.md) | 三区模型、环境变量、安全边界 | P0 |
|
||
|
||
### 功能文档
|
||
|
||
| 文档 | 描述 | 类型 |
|
||
|------|------|------|
|
||
| [Quick Init](./QUICK-INIT.md) | 快捷初始化（qimingclaw.json / 环境变量） | stable |
|
||
| [初始化依赖版本固定与安装/升级](./dependency-version-pinning.md) | installVersion、升级同步、文案、尊重已安装版本不降级 | stable |
|
||
| [Auto Update](./auto-update.md) | 自动更新机制 | design |
|
||
| [认证机制与 SavedKey 生命周期](./auth-savedkey-lifecycle.md) | savedKey 设计、多账号隔离、退出登录与服务联动规则 | stable |
|
||
| [ACP 引擎性能优化](./ACP-ENGINE-PERF-OPTIMIZATION.md) | 引擎预热池、SDK 预加载、SSE 缓冲，降低 /computer/chat 首包延迟 | stable |
|
||
| [内嵌 Webview 与 Cookie 同步](./embedded-webview-cookie-sync.md) | 会话页面内嵌 webview + reg token 自动同步 httpOnly cookie 免登录 | stable |
|
||
|
||
### 参考文档
|
||
|
||
| 文档 | 描述 | 类型 |
|
||
|------|------|------|
|
||
| [OpenClaw 参考](./REF-OPENCLAW.md) | openclaw 架构分析与改进建议 | reference |
|
||
| [运行时环境配置](./RUNTIME-ENV-PROFILES.md) | strict/compat 环境配置策略 | design |
|
||
|
||
### 支持文档
|
||
|
||
| 文档 | 描述 |
|
||
|------|------|
|
||
| [签名指南](../release/SIGNING.md) | 应用签名与公证 |
|
||
| [安全审查](../reviews/SECURITY-REVIEW.md) | 安全性审查清单 |
|
||
| [日志规范](../operations/LOGGING.md) | 日志记录标准 |
|
||
| [审查记录](../reviews/REVIEW-2026-02.md) | 2026年2月架构审查记录 |
|
||
| [Sandbox 子模块 ADR](./ADR-SANDBOX-SUBMODULE.md) | 三端沙箱运行时子模块化决策 |
|
||
|
||
---
|
||
|
||
## 文档关系图
|
||
|
||
```
|
||
ARCHITECTURE-INDEX.md (本文档)
|
||
│
|
||
┌───────────────────────────┼───────────────────────────┐
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
ARCHITECTURE-OVERVIEW.md ARCHITECTURE-COMPONENTS.md ARCHITECTURE-ISOLATION.md
|
||
│ │ │
|
||
│ ┌─────────────────┼─────────────────┐ │
|
||
│ │ │ │ │
|
||
▼ ▼ ▼ ▼ ▼
|
||
ARCHITECTURE-LOOP.md ARCHITECTURE-STORAGE.md ARCHITECTURE-REF-OPENCLAW.md
|
||
│ │ │
|
||
│ │ │
|
||
▼ ▼ ▼
|
||
ARCHITECTURE-RUNTIME-ENV-PROFILES.md
|
||
```
|
||
|
||
---
|
||
|
||
## 阅读顺序建议
|
||
|
||
### 新手入门
|
||
|
||
1. **[总览](./OVERVIEW.md)** - 了解产品定位和核心原则
|
||
2. **[核心组件](./COMPONENTS.md)** - 理解四大核心组件
|
||
3. **[循环流程](./LOOP.md)** - 掌握完整循环流程
|
||
4. **[存储实现](./STORAGE.md)** - 了解数据存储方式
|
||
|
||
### 架构师/高级开发者
|
||
|
||
1. **[总览](./OVERVIEW.md)** - 快速回顾
|
||
2. **[隔离策略](./ISOLATION.md)** - 理解安全边界
|
||
3. **[OpenClaw 参考](./REF-OPENCLAW.md)** - 参考优秀设计
|
||
4. **[运行时环境配置](./RUNTIME-ENV-PROFILES.md)** - 环境配置细节
|
||
|
||
### 运维/安全工程师
|
||
|
||
1. **[隔离策略](./ISOLATION.md)** - 安全隔离机制
|
||
2. **[安全审查](../reviews/SECURITY-REVIEW.md)** - 安全检查清单
|
||
3. **[签名指南](../release/SIGNING.md)** - 应用签名流程
|
||
4. **[日志规范](../operations/LOGGING.md)** - 日志审计要求
|
||
|
||
---
|
||
|
||
## 版本信息
|
||
|
||
| 文档 | 版本 | 最后更新 |
|
||
|------|------|----------|
|
||
| ARCHITECTURE-INDEX.md | 1.0 | 2026-02-24 |
|
||
| ARCHITECTURE-OVERVIEW.md | - | - |
|
||
| ARCHITECTURE-COMPONENTS.md | - | - |
|
||
| ARCHITECTURE-LOOP.md | - | - |
|
||
| ARCHITECTURE-STORAGE.md | - | - |
|
||
| ARCHITECTURE-ISOLATION.md | - | - |
|
||
| ARCHITECTURE-REF-OPENCLAW.md | 2.3 | 2026-02-24 |
|
||
| ARCHITECTURE-RUNTIME-ENV-PROFILES.md | - | 2026-02-24 |
|
||
| auth-savedkey-lifecycle.md | 1.0 | 2026-03-06 |
|
||
| embedded-webview-cookie-sync.md | 1.0 | 2026-03-12 |
|
||
|
||
---
|
||
|
||
## 贡献指南
|
||
|
||
### 文档更新规范
|
||
|
||
所有架构文档应遵循以下规范：
|
||
|
||
1. **版本信息** - 每个文档顶部包含 frontmatter
|
||
```yaml
|
||
---
|
||
version: 1.0
|
||
last-updated: YYYY-MM-DD
|
||
status: design | draft | stable
|
||
---
|
||
```
|
||
|
||
2. **目录结构** - 使用一致的章节结构
|
||
```markdown
|
||
## 概述
|
||
## 核心内容
|
||
## 相关文档
|
||
```
|
||
|
||
3. **代码示例** - 使用语法高亮和详细注释
|
||
```typescript
|
||
// 接口定义
|
||
interface Example {
|
||
// 说明
|
||
}
|
||
```
|
||
|
||
4. **交叉引用** - 使用相对路径链接其他文档
|
||
```markdown
|
||
- [总览](./OVERVIEW.md)
|
||
```
|
||
|
||
### 文档状态说明
|
||
|
||
| 状态 | 说明 |
|
||
|------|------|
|
||
| `draft` | 草稿，内容可能大幅变更 |
|
||
| `design` | 设计阶段，基本稳定但可能调整 |
|
||
| `stable` | 稳定版本，与实现一致 |
|
||
|
||
---
|
||
|
||
## TODO
|
||
|
||
- [ ] 为所有 ARCHITECTURE-*.md 文档添加版本 frontmatter
|
||
- [ ] 补充 IMPLEMENTATION.md 实施指南
|
||
- [ ] 添加 API.md 接口文档
|
||
- [ ] 创建 CHANGELOG.md 变更记录
|
||
|
||
---
|
||
|
||
*本文档由架构维护者负责更新*
|
||
*如有疑问，请查阅具体文档或联系架构团队*
|