最近断断续续基于QwenPaw开发了很多功能，这里开个坑，基于QwenPaw整理agent的开发逻辑

1、项目结构

展开代码
QwenPaw/
├── src/qwenpaw/                     # Python 后端核心
│   ├── agents/                      # 智能体核心
│   │   ├── react_agent.py           # QwenPawAgent 主类（基于 ReActAgent）
│   │   ├── model_factory.py         # LLM 模型工厂（创建模型+格式化器）
│   │   ├── prompt.py                # 系统提示词构建
│   │   ├── skills_manager.py        # 技能管理器（加载/过滤/注册技能）
│   │   ├── tool_guard_mixin.py      # 工具安全拦截 Mixin
│   │   ├── command_handler.py       # 系统命令处理器（/compact /new 等）
│   │   ├── hooks/                   # 生命周期钩子（Bootstrap 引导等）
│   │   ├── memory/                  # 长期记忆管理
│   │   │   ├── base_memory_manager.py    # 记忆管理器抽象基类
│   │   │   ├── reme_light_memory_manager.py  # ReMeLight 记忆后端实现
│   │   │   ├── prompts.py           # 记忆相关提示词模板
│   │   │   └── proactive/           # 主动服务（记忆进化+主动推送）
│   │   ├── context/                 # 上下文管理
│   │   │   ├── agent_context.py     # AgentContext（扩展 InMemoryMemory）
│   │   │   ├── base_context_manager.py  # 上下文管理器抽象基类
│   │   │   └── light_context_manager.py # 轻量上下文管理器实现
│   │   ├── tools/                   # 内置工具集
│   │   │   ├── shell.py             # Shell 命令执行
│   │   │   ├── file_io.py           # 文件读写编辑
│   │   │   ├── file_search.py       # 文件搜索（grep/glob）
│   │   │   ├── browser_control.py   # 浏览器控制（Playwright）
│   │   │   ├── view_media.py        # 图片/视频查看
│   │   │   ├── agent_management.py  # 多智能体协作工具
│   │   │   └── ...                  # 其他工具
│   │   ├── skills/                  # 内置技能定义
│   │   └── utils/                   # 工具函数
│   ├── app/                         # 应用层
│   │   ├── _app.py                  # FastAPI 应用主体 + 生命周期
│   │   ├── multi_agent_manager.py   # 多智能体管理器
│   │   ├── workspace/               # Workspace（智能体运行时容器）
│   │   │   ├── workspace.py         # Workspace 类（完整运行时封装）
│   │   │   ├── service_manager.py   # 服务管理器（声明式组件注册/启动/停止）
│   │   │   └── service_factories.py # 服务工厂（MCP/Chat/Channel 等创建逻辑）
│   │   ├── runner/                  # 请求执行器
│   │   │   ├── runner.py            # AgentRunner（请求处理核心入口）
│   │   │   ├── session.py           # 会话持久化（JSON 文件）
│   │   │   ├── manager.py           # ChatManager（聊天记录管理）
│   │   │   ├── title_generator.py   # 会话标题自动生成
│   │   │   └── task_tracker.py      # 后台任务追踪器
│   │   ├── channels/                # 多渠道系统
│   │   │   ├── base.py              # BaseChannel 抽象基类
│   │   │   ├── manager.py           # ChannelManager 渠道管理器
│   │   │   ├── registry.py          # 渠道注册表（内置+自定义发现）
│   │   │   ├── renderer.py          # 消息渲染器（Markdown/富文本转换）
│   │   │   └── unified_queue_manager.py  # 统一消息队列管理
│   │   ├── mcp/                     # MCP 客户端管理
│   │   ├── crons/                   # 定时任务
│   │   ├── routers/                 # API 路由
│   │   └── approvals/               # 审批机制
│   ├── providers/                   # 模型提供商
│   │   ├── provider_manager.py      # 提供商管理器
│   │   ├── openai_provider.py       # OpenAI 兼容提供商
│   │   ├── anthropic_provider.py    # Anthropic 提供商
│   │   ├── gemini_provider.py       # Gemini 提供商
│   │   ├── ollama_provider.py       # Ollama 本地模型
│   │   ├── retry_chat_model.py      # 重试+限速包装器
│   │   └── ...                      # 其他提供商
│   ├── config/                      # 配置管理
│   ├── plugins/                     # 插件系统
│   ├── security/                    # 安全模块（工具防护、技能扫描）
│   ├── token_usage/                 # Token 用量统计
│   ├── local_models/                # 本地模型管理（llama.cpp 等）
│   ├── cli/                         # CLI 命令行工具
│   └── utils/                       # 通用工具
├── console/                         # 前端控制台（Vue + Vite）
├── plugins/                         # 插件目录
├── website/                         # 文档网站
└── tests/                           # 测试

2、分层架构

3、重点技能

3.1、Agent开发架构：AgentScope

3.2、SKILL

3.3、MCP

3.4、Memory

3.5、Model Provider 模型管理

3.6、Channels渠道

3.7、Agent Execution Workflow 工作流

3.8、Cron Jobs定时