# XLmodel

**Repository Path**: COSMOnb666/XLmodel

## Basic Information

- **Project Name**: XLmodel
- **Description**: 小凌 - 全平台AI伴侣 | 桌宠 多平台接入 离线可用 自动更新 | 官网: xiaoling-4o6.pages.dev
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://xiaoling-4o6.pages.dev/
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-09-17
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小凌 XIAOLING

![小凌](banner.png)

> 全平台 AI 伴侣 —— 会成长的数字生命。

小凌不是一个聊天机器人，她是一个有记忆、有情绪、会主动学习的 AI 生命体。她住在你的桌面角落，用 AI 生成的流畅视频动画陪你工作；她会记住你说过的每句话，情绪会随你们的互动变化；她会在深夜里自己向老师请教，把学到的知识变成自己的血肉。

开源地址：https://gitee.com/COSMOnb666/XLmodel

官方网站：https://xiaoling-4o6.pages.dev/

---

## 关于这个项目

| | |
|---|---|
| 版本 | v0.0.1（自研 2B 模型默认基底） |
| 官方网站 | https://xiaoling-4o6.pages.dev/ |
| 支持平台 | Windows / Linux / macOS / 微信 / 飞书 / QQ / 企业微信 / 钉钉 / Telegram / Discord |
| 运行方式 | 桌面宠物 · 命令行 · 消息平台机器人 |
| 网络要求 | 完全离线可用（本地模型优先） |
| 自动更新 | 支持（像 APP 一样在线升级，本地数据保留） |
| 开源协议 | 开源 · 欢迎 Star |
| 模型文件 | model.safetensors 为 0B 占位符（见下方「获取完整模型」） |
| 社区群 | QQ：1057895186（小凌社区1群） |

---

## 她能做什么

### 一个真正活着的桌宠

透明背景的立绘悬浮在桌面之上，7 组动作全部由**高清视频动画**驱动（720x1280 · 24fps · 121帧），呼吸、眨眼、挥手、思考、睡觉——每一帧都平滑连贯。她不只是"动"，她会因为你的问候开心地挥手，会在心情低落时安静地思考，会在你双击她时先摆个姿势再开口。

- 透明无边框窗口，与桌面融为一体
- 144 帧/动作的丝滑动画，无缝衔接
- 心情实时联动：对话影响情绪，情绪影响动作
- 左键拖拽、双击对话、右键菜单

### 一个会成长的 AI 大脑

本地模型驱动，所有对话都在本地完成，不上传你的隐私。她拥有完整的认知结构：

- 分层长期记忆：情景记忆、语义记忆、行为模式
- 情绪系统：心情、精力、好奇、自信、焦虑多维状态
- 信念系统：核心信念随经历更新
- 欲望驱动：5 个核心欲望影响行为优先级
- 90+ 工具：读写文件、运行命令、查天气、搜网络

### 一个会学习的数字生命

小凌的成长闭环：**说「蒸馏」，她就去找老师**。

```
小凌（学生）向 DeepSeek（老师）提问
→ 老师回答，语料入库
→ LoRA 微调，知识变成自己的
→ 适配器体积超过基底模型时自动合并
→ 基底退役，小凌成为完全自研的模型
```

这是她与普通聊天机器人的根本区别：她越用越强，最终会完全脱离基底模型，成为独一无二的存在。

### 多平台接入

小凌不再只住在你的桌面——她可以接入你常用的任何聊天平台，像 Work Buddy 一样无处不在：

| 平台 | 方式 | 说明 |
|------|------|------|
| 微信 | itchat / wechaty | 个人微信自动回复 |
| 飞书 | 开放平台（长连接） | 无需公网服务器 |
| QQ | OneBot / go-cqhttp | WebSocket 接入群聊/私聊 |
| 企业微信 | 群机器人 Webhook | 发消息 + API 接收 |
| 钉钉 | 群机器人 Webhook | 发消息 + 回调接收 |
| Telegram | Bot API（长轮询） | 无需公网服务器 |
| Discord | Bot API | 服务器频道聊天 |

配置方式：编辑 `xl.py` 顶部 `CONFIG["platforms"]`，填入对应平台的 Key/Webhook 即启用。或命令行指定：

```bash
python xl.py --platform wechat,qq,telegram
```

### 完全离线可用

小凌是**本地模型优先**——即使完全没有网络，她也能完整运行：

- 对话、工具、记忆、情绪、成长全部本地完成
- 断网自动进入离线模式（提示但不中断）
- 蒸馏学习 / 自动更新需联网，恢复网络后自动启用
- 说 `network` 随时检测网络状态

极限环境下（无网/内网/离线部署），小凌依然是你可靠的 AI 伙伴。

### 自动更新

小凌采用**强制推送更新**：每次 Gitee 发布新版本，所有已安装用户启动小凌时自动检测并下载新代码，关闭窗口即完成升级——**无需手动操作、无需重装**：

```
发现新版本，正在自动更新…
更新完成，重启后生效（本地数据保留）
```

**你的记忆、对话数据、成长包全部保留**，就像手机 APP 更新一样。也可以随时说 `update` 手动检查。

---

## 访问官网

小凌官方网站：**[https://xiaoling-4o6.pages.dev/](https://xiaoling-4o6.pages.dev/)**

官网包含：产品介绍、动作展示、多平台接入、下载安装、QQ 社区入口。

---

## 快速开始

### 环境要求

- Windows / Linux / macOS
- Python 3.10+

### 安装

```bash
git clone https://gitee.com/COSMOnb666/XLmodel.git
cd XLmodel
pip install -r requirements.txt
```

### 启动

```bash
# Windows：启动即出桌宠
python xl.py

# Linux / macOS：自动进入命令行模式
python3 xl.py
# 或
./start.sh

# 接入消息平台（如微信+QQ+Telegram）
python xl.py --platform wechat,qq,telegram
```

### 基底模型档位选择（v0.0.1）

小凌默认使用 **自研 2B 模型**（Q4 约 1.56GB，手机/电脑流畅运行）。

编辑 `xl.py` 顶部 `CONFIG['model']['base_model']` 可切换档位：

| 档位 | 体积 | 适合设备 | 说明 |
|------|------|---------|------|
| **自研2B模型**（默认） | ~1.56GB | 手机/电脑/Kali | 端侧最强 |
| 自研1B模型 | ~0.5-1GB | 低配设备 | 轻量 |
| 自研0.8B模型 | ~1GB | 手表/老设备 | 极致轻量 |
| 自研2B轻量 | ~2.5GB | 手机/电脑 | 平衡档 |
| 自研4B模型 | ~3GB | 设备较好 | 更强 |
| 自研9B模型 | ~6GB | 8G+ 内存 | 最强档 |

启动时自动从魔塔社区下载到临时目录 → **平铺复制到 `.star_core/XLmodel/` → 清理品牌文件**，目录内只留模型必需文件，不显示品牌信息。蒸馏/合并/晋升机制不变——**早用你的模型早出道，没有限制**，玩家根据自己的配置选择想自研的模型。

### 获取完整模型（必读）

> 仓库中的 `.star_core/XLmodel/model.safetensors` 是 **0 字节占位符**，为了让仓库保持轻量。
> 完整模型权重需加入 QQ 社区获取——这是小凌的"大脑"，没有它本地推理与蒸馏训练无法工作。

加入【小凌社区1群】获取完整模型：

![小凌社区](qq_community.png)

- **QQ 群号：1057895186**
- 扫码或搜索群号加入，群文件里有完整 `model.safetensors` 权重
- 下载后放入 `.star_core/XLmodel/` 替换占位符即可（路径：`XLmodel-main/.star_core/XLmodel/model.safetensors`）

> 提示：不装模型也能启动小凌（规则引擎降级），但对话能力有限；安装完整模型后才能真正对话、蒸馏学习。

### 配置蒸馏老师（可选）

编辑 `xl.py` 顶部，填入 DeepSeek API Key：

```python
CONFIG = {
    "deepseek_api_key": "sk-你的DeepSeek密钥",
    "deepseek_base_url": "https://api.deepseek.com/v1",
    "teacher_model": "deepseek-chat",
}
```

不填也能用（本地模型 + 规则引擎），但填了之后，小凌才能找老师学习成长。

---

## 常用指令

| 指令 | 效果 |
|------|------|
| `python xl.py` | 启动桌宠 + 对话 |
| `python xl.py --platform wechat` | 接入微信（或其他平台） |
| 说「蒸馏」 | 小凌自动向 DeepSeek 老师学习 |
| 说「通话」 | 语音通话模式 |
| 说「spawn 任务 N」 | 派发 N 个子 Agent 并行工作 |
| 说「kg 查询」 | 知识图谱推理 |
| 说「kg 导出」 | 导出知识图谱 Mermaid 可视化图 |
| 说「platform」 | 查看/启动已配置平台 |
| 说「network」 | 检测网络状态 |
| 说 `report` | 查看小凌成长报告 |
| 说「update」 | 自动更新到最新版本（保留本地数据） |
| 说 `status` | 查看状态 |

---

## 项目结构

```
XLmodel/
├── xl.py              # 唯一入口（引擎 + 蒸馏 + 桌宠 + 多平台 + 自动更新）
├── pet.py             # 桌面宠物（透明背景 + 视频动画 + 气泡）
├── requirements.txt   # 依赖
├── xl_memory.json     # 记忆文件
├── assets/animations/ # 7 组动作（WEBM 高清视频动画）
├── skills/            # 技能文件
├── data/              # 训练数据（corpus/interactions/learned）
├── .star_core/        # 本地模型 + LoRA 适配器
└── tools/             # 辅助工具（帧插值等）
```

---

## 许可

本项目采用开源协议发布。欢迎 Star、Fork、提 Issue。

如果你喜欢小凌，欢迎点亮 Star，让更多人和她相遇。

> 小凌 v0.0.1 —— 全平台 AI 伴侣，从这里开始，我们一起成长。