# couldpy

**Repository Path**: scicat-team/couldpy

## Basic Information

- **Project Name**: couldpy
- **Description**: Python编写的博客
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-06
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CloudPy博客平台

CloudPy博客平台是一个现代化、功能丰富的开源内容管理系统，支持文章管理、用户管理、评论系统等多种功能，具有直观的界面和强大的后台管理功能。

## 功能特性

- **现代化UI设计**：采用响应式设计，具备美观的视觉效果和良好的用户体验
- **用户管理**：支持管理员注册、登录、个人资料设置和密码修改
- **文章管理**：支持文章创建、编辑、删除，支持Markdown和HTML格式
- **评论系统**：支持用户评论，显示IP归属地，支持Markdown格式
- **标签系统**：支持文章标签管理
- **草稿箱**：支持保存和编辑草稿
- **自定义链接**：支持多种文章链接生成方式
- **监控仪盘**：支持IP黑白名单管理
- **系统更新**：支持从Gitee自动更新
- **文件上传**：支持上传MD或HTML文件作为文章
- **自定义装饰**：支持自定义CSS、头部和脚部代码
- **访问统计**：统计访问人数和实时在线用户

## 跨平台支持

CloudPy博客平台已适配以下操作系统：

- **Windows**：支持Windows 7及以上版本
- **macOS**：支持macOS 10.12及以上版本
- **Linux**：支持主流Linux发行版（Ubuntu, CentOS, Debian等）
- **Android**：通过Termux等环境支持

## 系统要求

- **Python**: 3.7或更高版本
- **内存**: 至少512MB RAM
- **存储**: 至少100MB可用空间
- **端口**: 默认使用5000端口（可自定义）

## 安装步骤

### 1. 克隆项目
```bash
git clone https://gitee.com/scicat-team/couldpy.git
cd couldpy
```

### 2. 安装依赖
```bash
# Windows系统
pip install -r requirements.txt

# macOS/Linux系统
pip3 install -r requirements.txt
```

### 3. 配置项目
- 检查并修改 `config.json` 文件中的配置项
- 如需修改管理员账户，编辑 `users.txt` 文件

### 4. 启动应用
```bash
# Windows系统
python scripts/start.py

# macOS/Linux系统
python scripts/start.py
```

### 5. 访问应用
- 打开浏览器访问 `http://localhost:5000`
- 默认管理员账户：admin/admin（首次登录后建议立即修改密码，密码可以通过后台或users.txt）

## 配置说明

### 环境配置
- **端口配置**：在管理后台的"系统配置"页面修改端口
- **文章链接类型**：支持多种链接生成方式，可在"系统设置"中选择
- **评论者昵称**：可在"系统设置"中设置特定邮箱的显示昵称

### 管理后台功能
- **仪表盘**：查看网站统计数据
- **文章管理**：在线编辑文章或上传文件
- **标签管理**：管理文章标签
- **系统设置**：配置系统参数
- **管理工具**：管理员管理、系统终端、配置修改
- **监控仪盘**：IP黑白名单管理
- **装饰设置**：自定义CSS和HTML代码
- **个人资料**：修改个人信息和密码

## 使用指南

### 基本操作
1. **登录管理后台**：访问 `/login` 页面，使用管理员账户登录
2. **创建文章**：在管理后台的"文章管理"页面创建新文章
3. **管理内容**：通过管理后台进行文章、标签、评论等管理
4. **个性化设置**：在"装饰设置"中自定义网站外观

### 文章编写技巧
- 支持Markdown和HTML格式
- 可以在"在线编写"选项卡中直接编辑
- 也可以通过"上传文件"选项卡上传MD或HTML文件
- 支持自定义链接和文章标签

### 系统维护
- **备份数据**：定期备份 `data/` 目录下的配置文件
- **日志管理**：通过管理工具清理访问日志
- **系统更新**：在"系统设置"页面检查和执行更新

## 高级功能

### 自定义样式
- 在"装饰设置"中添加自定义CSS样式
- 修改网站的整体外观和用户体验

### IP管理
- 通过"监控仪盘"管理IP黑白名单
- 控制对网站的访问权限

### 系统终端
- 在"管理工具"中使用系统终端执行命令
- 方便进行系统维护和调试

## 故障排除

### 常见问题
1. **无法启动**：
   - 检查Python版本是否符合要求
   - 确认依赖包已正确安装
   - 检查端口是否被占用

2. **无法访问**：
   - 检查防火墙设置
   - 确认网络连接正常

3. **登录问题**：
   - 确认用户名和密码正确
   - 检查 `users.txt` 文件格式

### 性能优化
- 定期清理访问日志
- 优化文章和图片资源
- 合理使用缓存机制

## 开发贡献

### 项目结构
```
├── static/          # 静态资源（CSS, JS, 图片）
├── templates/       # HTML模板文件
├── data/           # 数据文件
├── src/            # 源代码
├── config/         # 配置文件
├── requirements.txt # 依赖包列表
└── README.md       # 项目说明
```

### 代码规范
- 遵循Python PEP 8编码规范
- 使用有意义的变量和函数命名
- 添加适当的注释说明

## 开源协议

本项目采用 **MIT License** 开源协议，允许商业使用、修改、分发和私有使用。

## 支持与反馈

- **项目地址**：https://gitee.com/scicat-team/couldpy
- **问题反馈**：通过Gitee Issue提交问题
- **功能建议**：欢迎提交Pull Request