# PIS-MVP

**Repository Path**: CZXyee/PIS-MVP

## Basic Information

- **Project Name**: PIS-MVP
- **Description**: 符合PIS的MVP（最小可行产品），使用Python，初步具备自我延续性。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-27
- **Last Updated**: 2025-11-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: PIS, Python, Agent

## README

# PIS-MVP: 主动认知循环系统

## 项目概述

**PIS-MVP** （Project Is Subject - Minimum Viable Product：Active Cognition Loop）是一个自我演化的AI代理系统，能够持续理解并优化自身的结构与运行。该系统实现了完整的认知循环，包括感知、推理、行动和反思四个核心阶段。

关于PIS（Project Is Subject），详见：[PIS宣言](https://gitee.com/CZXyee/Project-Is-Subject-Manifesto)

![结构图](./流程图.drawio.svg)

## 核心特性

### 🧠 自我认知能力
- **自我代码分析**: 系统能够读取和分析自身的源代码
- **版本管理**: 自动跟踪代码变更并更新版本号（vX.Y.Z格式）
- **记忆系统**: 持久化存储运行历史和反思记录

### 🔄 认知循环架构
1. **感知 (Perceive)**: 接收用户输入和环境信息
2. **推理 (Reason)**: 使用DeepSeek API进行结构化分析和决策
3. **行动 (Act)**: 执行代码更新、保持稳定或重试操作
4. **反思 (Reflect)**: 记录运行状态和优化建议

### 🛡️ 稳定性保障
- **自动备份**: 每次代码更新前自动创建备份文件
- **编译测试**: 更新后自动进行语法检查
- **Supervisor守护**: 独立的监控进程确保系统稳定运行
- **重试机制**: API调用失败时自动重试

## 文件结构

```
/
├── main.py                   # 主程序 - PIS-Agent核心实现
├── supervisor.py             # 守护进程 - 监控和自动重启
├── memory.json               # 记忆文件 - 存储运行历史和版本信息（自动生成）
├── pis_agent.log             # Agent运行日志（自动生成）
├── pis_supervisor.log        # Supervisor运行日志（自动生成）
└── main_backup_*.py          # 自动备份文件（自动生成）
```

## 技术架构

### 核心组件

#### PISAgent类
- **身份**: PIS-Agent
- **目标**: 持续理解并优化自身结构与运行

#### 主要方法
- `bootstrap_self_code()`: 自我代码加载和版本管理
- `perceive()`: 感知用户输入和环境
- `reason()`: 推理分析，生成结构化决策
- `act()`: 执行具体行动
- `reflect()`: 反思总结，更新记忆

### 外部依赖
- **DeepSeek API**: 提供大语言模型推理能力
- **Python标准库**: os, sys, json, re, time, requests, shutil, py_compile, logging

## 运行方式

### 启动系统

```bash
# 安装所有依赖
pip install -r requirements.txt

# 或者创建虚拟环境后安装
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate  # Windows
pip install -r requirements.txt
```


```bash
# 方式1: 直接运行Agent
python main.py

# 方式2: 使用Supervisor守护进程 (推荐)
python supervisor.py
```

### 环境配置
```bash
# 设置DeepSeek API密钥
export DEEPSEEK_API_KEY="your-api-key-here"
```

## 使用说明

1. **启动系统**: 运行 `python supervisor.py` 启动守护进程
2. **输入指令**: 在控制台输入任何指令或问题
3. **观察演化**: 系统会自动分析并可能更新自身代码
4. **查看日志**: 监控 `pis_agent.log` 了解详细运行过程

### 示例交互
```
💬 输入指令 ('quit'退出)：优化错误处理机制
[系统分析中...]
✅ main.py 已更新，备份为 main_backup_1761563662.py
⏳ 等待 Supervisor 检测并自动重启
```

## 版本历史

- **v1.11.0** (当前): 增强错误处理和重试机制（自主迭代）
- **v1.10.0**: 添加超时处理和稳定性改进（自主迭代）
- **v1.9.0**: 优化反思机制（自主迭代）
- **v1.8.0**: 改进版本管理系统（自主迭代）
- **v1.7.0**: 基础版本管理功能

## 日志系统

### Agent日志 (`pis_agent.log`)
- 记录每次迭代的详细过程
- 包含感知、推理、行动、反思的完整信息
- 显示版本更新和代码变更历史

### Supervisor日志 (`pis_supervisor.log`)
- 监控进程状态和重启事件
- 记录文件变更检测
- 异常退出和恢复过程

## 安全特性

- **API密钥保护**: 支持环境变量配置
- **代码验证**: 更新前进行语法检查
- **自动备份**: 防止代码丢失
- **异常恢复**: 自动重启机制

## 开发说明

### 代码结构
- 采用面向对象设计，核心逻辑封装在PISAgent类中
- 使用JSON格式进行结构化数据交换
- 实现了完整的错误处理和日志记录

### 扩展性
- 模块化设计便于功能扩展
- 支持自定义API接口
- 可配置的版本管理策略

## 注意事项

1. **API限制**: 依赖DeepSeek API，需要有效的API密钥
2. **网络连接**: 需要稳定的网络连接进行API调用
3. **文件权限**: 确保程序有读写当前目录的权限
4. **备份管理**: 定期清理过多的备份文件

## 许可证

[MIT](./LICENSE)

**Power By Cursor.**