Repository navigation
小红书MCP工具包 v1.0.2
🌺 小红书MCP工具包 v1.0.2
🏗️ 重构版本 - 全面重构为企业级框架结构
🎯 重大重构
- 🏗️ 模块化重构: 按照SOLID原则重构代码结构,提升可维护性和扩展性
- 📁 新目录结构: 采用标准的src/目录结构,模块职责更清晰
- 🔧 统一异常处理: 实现统一的错误处理边界组件
- ⚡ 性能优化: 异步处理、资源管理、内存优化
📂 新架构目录结构
xhs-toolkit/
├── xhs_toolkit.py # 🚀 主入口(统一CLI)
├── src/ # 📁 源代码目录
│ ├── core/ # 🔧 核心功能
│ │ ├── config.py # 配置管理
│ │ ├── browser.py # 浏览器管理
│ │ └── exceptions.py # 异常处理
│ ├── auth/ # 🔐 认证模块
│ │ └── cookie_manager.py # Cookie管理
│ ├── xiaohongshu/ # 🌺 核心功能
│ │ ├── models.py # 数据模型
│ │ └── client.py # 处理网页的客户端
│ ├── server/ # 🖥️ MCP服务器目录
│ │ └── mcp_server.py # MCP服务器
│ └── utils/ # 🛠️ 工具函数
│ ├── logger.py # 日志系统
│ └── text_utils.py # 文本处理
✨ 新增功能
- 🔧 配置管理: 新增配置显示、验证、示例生成功能
- 📊 系统状态: 完整的系统状态检查和诊断
- 🛠️ 工具函数: 统一的文本处理和日志系统
- 🔌 编程接口: 模块化的API,便于二次开发
- 🌐 跨平台兼容: 改进的Windows/macOS/Linux兼容性
🔄 向后兼容
- ✅ CLI命令保持一致: 所有原有命令继续可用
- ✅ 配置文件兼容: 支持旧的配置格式
- ✅ Cookie格式兼容: 支持新旧Cookie格式
- ✅ 功能完全保留: 保持所有原有功能
🚀 快速开始
# 查看帮助
./xhs-toolkit --help
# Cookie管理
./xhs-toolkit cookie save
./xhs-toolkit cookie show
./xhs-toolkit cookie validate
# 配置管理
./xhs-toolkit config show
./xhs-toolkit config validate
# 服务器管理
./xhs-toolkit server start
./xhs-toolkit server stop
# 系统状态
./xhs-toolkit status
# 直接发布
./xhs-toolkit publish "标题" "内容" --tags "标签1,标签2"🔧 技术改进
- SOLID原则: 单一职责、开闭原则、依赖倒置等
- 类型提示: 全面的type hints支持
- 异步处理: async/await异步操作
- 资源管理: 自动清理浏览器资源
- 错误处理: 统一的异常处理系统
- 日志系统: 基于loguru的完整日志
- Unicode兼容: Windows GBK编码处理
📦 下载说明
| 平台 | 文件 | 说明 |
|---|---|---|
| 🐧 Linux | xhs-toolkit-linux-x64.tar.gz |
适用于x64 Linux系统 |
| 🪟 Windows | xhs-toolkit-windows-x64.zip |
适用于x64 Windows系统 |
| 🍎 macOS | xhs-toolkit-macos-x64.tar.gz |
适用于Intel Mac |
💡 开发者改进
- 模块化设计: 便于扩展和维护
- 清晰职责: 每个模块职责明确
- 完整文档: 代码自文档化
- 易于测试: 模块独立便于单元测试
- 配置驱动: 行为可配置化
🎯 重构整个项目!提升代码质量和可维护性!