# LoveNLP

**Repository Path**: ghostcode/LoveNLP

## Basic Information

- **Project Name**: LoveNLP
- **Description**: AI自然语言集成框架，通过订制脚本开发继承外部程序功能，实现自然语言控制
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 2
- **Created**: 2021-02-26
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LoveNLP

## 项目介绍


LoveNLP源于2016年3月创建的SampleNLP项目，是其现代化的继承者和升级版。SampleNLP作为早期的自然语言处理框架，为LoveNLP奠定了基础架构理念，包括模块化设计和命令解析系统。经过多年的发展和技术迭代，LoveNLP在SampleNLP的基础上，整合了现代AI技术，通过模块化设计和智能调度系统，实现自然语言对各种功能的控制。框架支持通过订制脚本扩展外部程序功能，提供了丰富的内置模块和灵活的扩展机制。

### 核心功能

- **自然语言控制**：通过自然语言指令控制各种功能模块
- **模块化设计**：基于XML配置的模块化系统，支持热插拔扩展
- **AI集成**：整合外部AI模型，提供智能对话能力
- **多角色系统**：支持不同风格的对话角色
- **情绪系统**：内置情绪模型，实现更加人性化的交互
- **实时信息整合**：将实时数据融入对话，提高响应的时效性

## 软件架构

LoveNLP采用XML+PYTHON+SQLITE的技术架构，主要由以下组件组成：

### 核心组件

- **主引擎**：负责命令解析、模块调度和AI交互
- **模块系统**：管理和加载功能模块
- **数据库**：存储模块信息和请求映射
- **AI接口**：与外部AI模型通信
- **用户界面**：提供命令行和后端服务接口

### 数据流

1. 用户输入自然语言指令
2. 系统分析指令，匹配相应模块
3. 加载并执行模块功能
4. 返回执行结果给用户
5. 同时通过外部AI模型生成自然语言响应

## 安装教程

### 环境要求

- Python 3.7+
- pip 20.0+

### 安装步骤

1. 克隆或下载项目到本地
2. 安装依赖库：
   ```bash
   pip install -r requirements.txt
   ```
3. 启动项目：
   ```bash
   python start.py
   ```

## 使用说明

### 启动方式

1. **命令行模式**：执行 `python start.py`
2. **后端服务模式**：执行 `srv.bat`

### 使用示例

在命令行输入自然语言指令，例如：

- 查询天气：`北京天气怎么样`
- 翻译文本：`翻译你好成英文`
- 播放音乐：`播放一首轻音乐`
- 系统信息：`查看系统状态`
- 时间查询：`现在几点了`

系统会自动匹配相应模块并执行功能，同时通过AI模型生成自然语言响应。

## 模块系统

LoveNLP的模块系统是其核心扩展机制，每个模块由以下部分组成：

### 模块结构

每个模块位于 `modules/` 目录下，包含：

- **XML配置文件**：定义模块名称、版本、功能和参数
- **Python实现**：实现具体功能逻辑

### 模块示例

```xml
<module name='天气' version='天气_1_0' description='天气'>
<import>import weather.weather as weather</import>
<class name='天气' function='weather.QueryWeather'>
    <attributes>
        <attribute name='城市'></attribute>
        <attribute name='温度'></attribute>
        <!-- 更多属性 -->
    </attributes>
    <queries>
        <query question='%天气%' answer='[城市][日期]天气[天气]...'></query>
    </queries>
    <tasks>
        <task taskname='天气报告' default='ON' rule='ALWAYS' period='1day' talk='...'></task>
    </tasks>
</class>
</module>
```

### 内置模块

- 天气：查询和报告天气信息
- 翻译：文本翻译功能
- 音乐：音乐生成和处理
- 系统：系统信息和控制
- 机器人：AI聊天和生成功能
- 百科：百科知识查询
- 识别：模式识别功能
- 虚拟世界：虚拟空间和3D功能
- 时间：时间和日期相关功能
- 交通：交通信息查询

## 技术特点

1. **低代码扩展**：通过XML配置文件定义模块功能，降低了扩展难度
2. **动态加载**：根据需要自动加载模块，提高系统灵活性
3. **依赖管理**：自动安装模块所需的Python包，简化部署
4. **多模态集成**：整合了文本、语音、视觉等多种模态的功能
5. **智能调度**：根据自然语言指令智能匹配和调度模块
6. **人性化交互**：通过角色和情绪系统，实现更加自然的人机交互
7. **实时信息整合**：将实时数据融入对话，提高响应的相关性

## 参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

## 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 联系方式

- 作者：幽灵代码
- QQ：29672366
- 邮箱：29672366@qq.com