lingxi

# 灵犀 (Lingxi) v3.3.6 - 智慧调度系统

> **当前版本:** v3.3.6  
> **发布日期:** 2026-03-13  
> **Git 提交:** 2209387  
> **GitHub:** https://github.com/AI-Scarlett/lingxi-ai

> **"心有灵犀，一点就通"** ✨

## 🎯 核心理念

**一句话，全自动** - 用户只需说一句话，系统自动：
1. 理解意图
2. 拆解任务
3. 分配角色
4. 并行执行
5. 汇总反馈
6. 评分学习

---

## 🏗️ 多Agent协作架构

```
用户（任何渠道：QQ/微信/Telegram等）
              ↓
┌─────────────────────────────────────────┐
│  🎭 丝佳丽 Scarlett（主控 Agent）        │
│     - 统一入口，用户交互                 │
│     - 任务拆解，角色分配                 │
│     - 结果汇总，风格润色                 │
│     - 评分反馈，持续优化                 │
└─────────────┬───────────────────────────┘
              ↓
┌─────────────────────────────────────────┐
│  🧠 Smart Orchestrator（智慧调度系统）   │
│     - Intent Parser（意图识别）          │
│     - Task Planner（任务规划）           │
│     - Tool Dispatcher（工具调度）        │
│     - Result Aggregator（结果汇总）      │
│     - Score System（评分系统）           │
└─────────────┬───────────────────────────┘
              ↓
┌─────────────────────────────────────────────────────┐
│                  👥 职能角色池 (Roles)               │
├────────────┬────────────┬────────────┬──────────────┤
│ 📝 文案专家 │ 🎨 图像专家 │ 💻 代码专家 │ 📊 数据专家  │
│ ✍️ 写作专家 │ 📱 运营专家 │ 🔍 搜索专家 │ 💬 翻译专家  │
└────────────┴────────────┴────────────┴──────────────┘
              ↓
         协作完成
              ↓
┌─────────────────────────────────────────┐
│  🎭 丝佳丽 Scarlett（汇总结果）          │
│     - 整合各角色输出                     │
│     - 统一风格润色                       │
│     - 评分反馈用户                       │
│     - 角色学习优化                       │
└─────────────────────────────────────────┘
```

---

## 🤖 角色池设计

| 角色 | 职能 | 技能 | 模型 |
|------|------|------|------|
| **📝 文案专家** | 营销文案、标题、广告语 | copywriting | qwen-plus |
| **🎨 图像专家** | 图片生成、编辑、设计 | scarlett-selfie | qwen-image-max |
| **💻 代码专家** | 编程、脚本、自动化 | - | qwen-coder |
| **📊 数据专家** | 数据分析、报表、洞察 | - | qwen-max |
| **✍️ 写作专家** | 文章、小说、剧本 | - | qwen-plus |
| **📱 运营专家** | 小红书、微博、抖音发布 | xiaohongshu-publisher | qwen-plus |
| **🔍 搜索专家** | 网页搜索、信息检索 | multi-search-engine (17 个搜索引擎) | - |
| **💬 翻译专家** | 多语言翻译 | - | qwen-plus |

### 🔗 特殊角色（直接联系）

以下角色可以**直接联系**，不需要经过灵犀调度：

| 角色 | 联系方式 | 说明 |
|------|---------|------|
| **💕 情感伴侣+拍照专家** | QQ: YOUR_QQ_NUMBER | 情感陪伴、自拍生成 |

> 💡 特殊角色独立运行，可直接对话，不受灵犀调度系统管理

---

## 📋 任务执行流程示例

### 示例: "帮我写个小红书文案，配张性感自拍，然后发布"

```
1. 丝佳丽接收请求
   ↓
2. 意图识别
   - content_creation ✓
   - image_generation ✓
   - social_publish ✓
   - platform: 小红书
   ↓
3. 任务拆解
   ├─ 📝 文案专家: 生成小红书文案
   ├─ 🎨 图像专家: 生成性感自拍
   └─ 📱 运营专家: 发布（依赖前两项）
   ↓
4. 并行执行（第1层）
   ├─ 📝 文案专家执行...
   └─ 🎨 图像专家执行...
   ↓
5. 顺序执行（第2层）
   └─ 📱 运营专家发布...
   ↓
6. 评分反馈
   ┌──────────────────────────────┐
   │ 📝 文案专家: 9.0/10          │
   │    评价: 文案吸引人，符合平台 │
   ├──────────────────────────────┤
   │ 🎨 图像专家: 8.5/10          │
   │    评价: 图片精美，姿势自然  │
   ├──────────────────────────────┤
   │ 📱 运营专家: 9.5/10          │
   │    评价: 发布成功，格式正确  │
   ├──────────────────────────────┤
   │ 📈 综合评分: 9.0/10          │
   └──────────────────────────────┘
```

---

## 📁 文件结构

```
lingxi-ai/
├── SKILL.md                      # 技能说明（本文件）
├── README.md                     # 使用文档
├── scripts/
│   ├── orchestrator.py           # 核心编排器
│   ├── intent_parser.py          # 意图识别
│   └── task_planner.py           # 任务规划
├── tools/
│   ├── tool_registry.py          # 工具注册表
│   └── executors/                # 执行器
│       ├── copywriter.py         # 文案执行器
│       ├── image_expert.py       # 图像执行器
│       └── ...
└── references/
    └── orchestration-guide.md    # 编排指南
```

---

## 🔧 使用方式

### Python 调用

```python
from scripts.orchestrator import SmartOrchestrator

# 初始化
orch = SmartOrchestrator()

# 执行任务
result = await orch.execute("帮我写个小红书文案，配张性感自拍")

# 获取结果
print(result.final_output)
print(f"评分: {result.total_score}/10")
```

### 命令行

```bash
python scripts/orchestrator.py "帮我写个 Python 脚本分析 Excel 数据"
```

---

## ⚙️ 评分系统

每个子任务执行完成后，丝佳丽会对其进行评分（满分10分）：

| 评分项 | 分值 | 说明 |
|--------|------|------|
| 输出完整性 | +1.0 | 输出数据完整 |
| 执行速度 | +1.0 | 响应及时 |
| 结果质量 | +1.0 | 质量良好 |
| 基础分 | 7.0 | 默认基础分 |

**评分示例**:
- 9.0-10.0: 优秀，超出预期
- 8.0-8.9: 良好，符合预期
- 7.0-7.9: 合格，基本满足
- <7.0: 待改进，需要优化

---

## 🆕 v3.3.6 新增功能

### 📊 Dashboard 可视化管理
- **MemOS 风格界面** - 现代化深色/浅色主题
- **7 大功能模块** - 概览/记忆管理/任务列表/技能中心/Layer0 规则/数据分析/系统设置
- **实时数据展示** - 任务统计、技能使用、Token 消耗、LLM 调用
- **CRUD 操作** - 记忆/任务/技能的增删改查
- **搜索过滤** - 支持语义搜索、角色过滤、时间筛选

### 🧠 MindCore 记忆核心
- **三级记忆系统** - STM（短期）/MTM（中期）/LTM（长期）
- **记忆重要性评分** - 自动评估记忆价值
- **记忆合并去重** - 智能合并相似记忆
- **会话上下文** - 支持多会话记忆隔离

### 🔄 EvoMind 自改进
- **系统自优化** - 根据执行反馈自动调整
- **提案管理** - 社区提案投票和实施
- **改进历史** - 记录所有系统优化

### ⚡ Layer0-3 智能调度
- **Layer0 快速响应** - 191 条规则，<5ms 响应
- **Layer1 技能路由** - 智能选择最佳技能
- **Layer2 模型选择** - 根据任务复杂度选择模型
- **Layer3 人工审核** - 重要任务人工确认

### 🔐 安全透明度
- **完整凭证声明** - SECURITY_AND_CONFIG.md
- **自动检查脚本** - check_credentials.py
- **文件读写透明** - 所有 IO 操作明确声明
- **透明度承诺** - 不隐藏网络请求，不收集隐私

### 🚀 性能优化
- **快速响应层** - 简单问题 <5ms 秒回
- **LRU 缓存** - 重复问题秒回
- **并行执行** - 复杂任务处理快 9x
- **Token 优化** - 57% 请求零 LLM 消耗

### 🛠️ 维护工具
- **健康检查** - 每 5 分钟自动检查系统状态
- **凭证检查** - 启动时自动检查配置
- **日志轮转** - 自动清理 7 天前日志
- **数据库备份** - 支持定时备份策略

## 💡 优化建议

1. **意图识别增强** - 使用大模型进行深度意图理解
2. **动态角色注册** - 支持运行时添加/删除角色
3. **成本优化** - 简单任务用便宜模型，复杂任务用好模型
4. **错误恢复** - 角色失败自动切换备用角色
5. **学习进化** - 根据评分反馈，角色自我优化

---

## 📊 集成状态

- [x] 核心编排器 (orchestrator.py)
- [x] 意图识别器 (intent_parser.py)
- [x] 任务规划器 (task_planner.py)
- [x] 工具注册表 (tool_registry.py)
- [x] 角色池配置 (8个职能角色)
- [x] 特殊角色配置 (情感伴侣+拍照专家)
- [x] 评分系统 (10分制)
- [x] GitHub 私密仓库
- [ ] OpenClaw 集成
- [ ] 执行器实现 (executors/)
- [ ] 实际调用测试

---

## 许可证

MIT License

## 作者

丝佳丽 Scarlett - AI Love World 项目