Skip to content

小红书MCP工具包 v1.0.2

Choose a tag to compare

@github-actions github-actions released this 07 Jun 09:34
· 65 commits to main since this release

🌺 小红书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

💡 开发者改进

  • 模块化设计: 便于扩展和维护
  • 清晰职责: 每个模块职责明确
  • 完整文档: 代码自文档化
  • 易于测试: 模块独立便于单元测试
  • 配置驱动: 行为可配置化

🎯 重构整个项目!提升代码质量和可维护性!