Daily Agent

多智能体协作系统，提供日常综合服务 Multi-agent collaborative system for comprehensive daily services

Status: Configured & Ready | 已配置完成

• UK Users Optimized | 针对英国用户优化
• Dual Usage Modes | 双模式支持
  • Mode A: Claude Desktop + MCP (Personal Use)
  • Mode B: Claude API + Feishu Bot (Team Use)

See USAGE-MODES.md for complete comparison | 完整对比见文档

---

Quick Start After Clone | 克隆后快速开始

IMPORTANT: After cloning, you MUST run the setup script.

重要：克隆后必须运行设置脚本。

Three Simple Steps | 三个简单步骤

1. Run automated setup | 运行自动化设置

   # Windows
   setup.bat
   
   # Mac/Linux
   ./setup.sh

   This automatically creates .env from .env.template.

   此步骤会自动从 .env.template 创建 .env 文件。

2. Get FREE API key | 获取免费API密钥

   • Sign up at https://www.weatherapi.com/signup.aspx
   • Edit .env file and add your key

3. Configure Claude Desktop | 配置Claude Desktop

   • Copy claude_desktop_config.json to Claude config directory
   • Add your API key to the config
   • Restart Claude Desktop

Complete Guides | 完整指南

• RELEASE-SETUP.md - Downloaded from Releases? Start here! | 从 Releases 下载？从这里开始！
• POST-CLONE-GUIDE.md - Detailed step-by-step instructions | 详细分步说明

Verify setup: node check-setup.js

---

项目简介 | Project Overview

DailyAgent 是一个多智能体协作系统，由三个专业子 Agent 组成，通过主 Agent 协调工作，提供经济学答疑、日程规划、天气预报等日常服务。

DailyAgent is a multi-agent collaborative system consisting of three specialized sub-agents, coordinated by a main Agent to provide daily services including economics Q&A, schedule planning, and weather forecasting.

架构设计 | Architecture

                    ┌─────────────────────┐
                    │    Main Agent       │
                    │  任务分配与协调      │
                    └─────────┬───────────┘
                              │
          ┌───────────────────┼───────────────────┐
          │                   │                   │
          ▼                   ▼                   ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│   经济学家       │ │   日程规划      │  │   天气预报      │
│  Economist      │ │ Schedule Planner│ │ Weather Forecast│
└─────────────────┘ └─────────────────┘ └─────────────────┘

子 Agent 能力 | Sub-Agent Capabilities

Agent	中文能力	English
经济学家	解答经济学题目，支持文字或拍照输入	Answer economics questions via text or photo
日程规划	根据用户提供的日程生成日程表	Generate schedule table from user-provided schedule data
天气预报	根据地区总结今日天气、出行建议、穿衣指南	Summarize today's weather, travel suggestions, clothing guide by region

项目结构 | Project Structure

DailyAgentTest/
├── README.md                     # 项目说明
├── QUICK-START.md                # 3分钟快速开始指南
├── CONFIGURATION-SUMMARY.md      # 配置总结
├── UK-SETUP-GUIDE.md             # UK用户完整设置指南
│
├── agent-design.md               # 总体设计文档 (中英双语)
├── mcp-tools-requirements.md     # MCP 工具需求清单 (中英双语)
├── economist.md                  # 经济学家 Agent 定义 (CORE方法)
├── economist-example.md          # 经济学家解答示例
├── schedule-planner.md           # 日程规划 Agent 定义
├── schedule-planner-engine.md    # 日程规划引擎系统指令
├── weather-forecast.md           # 天气预报 Agent 定义 (UK优化)
├── FEISHU-BOT-SETUP.md           # 飞书机器人接入指南
├── SCHEDULE-WORKFLOW-GUIDE.md    # 日程工作流指南（紧凑模式）
│
├── claude_desktop_config.json    # ️ Claude Desktop MCP 配置文件
├── package.json                  # 项目配置和脚本
├── check-setup.js                # 配置验证脚本
├── .env.template                 # 环境变量模板
├── .gitignore                    # Git忽略文件配置
├── scripts/                      # 工具脚本
│   ├── update-config-paths.js    # 自动修正配置中的项目路径
│   ├── validate-schedule.js      # 日程冲突检测（最小输出）
│   ├── schedule-db.js            # 日程数据库管理
│   ├── schedule-workflow.js      # 日程工作流（增量更新）
│   └── auto-cleanup.js           # 自动清理过期日程
├── setup.bat                     # Windows 设置脚本
├── setup.sh                      # Mac/Linux 设置脚本
│
├── data/                         # 数据存储目录
│   ├── README.md                 # 数据目录说明
│   ├── schedules/                # 日程数据
│   │   ├── db/                   # JSON 数据库
│   │   └── week-2026-03-13-original.txt  # 格式示例
│   ├── economics/                # 经济学数据
│   └── weather-history/          # 天气历史记录
│
└── servers/                      # 服务器实现
    ├── README.md                 # UK Weather Server 技术文档
    ├── package.json              # Node.js 依赖配置
    ├── uk-weather-mcp-server.js  # 英国天气 MCP 服务器
    ├── feishu-bot-server.js      # 飞书机器人服务器
    └── node_modules/             # 已安装的依赖包

= Already Configured | 已配置完成

各 Agent 定义文件均为中英双语，用 --- 分隔。

All Agent definition files are bilingual (Chinese/English), separated by ---.

使用场景 | Use Cases

• 经济学：拍照上传题目或文字描述，获取解答与解析
• 日程：提供待办事项和时间，生成结构化日程表
• 天气：输入地区名称，获取今日天气、出行建议、穿衣指南

文档 | Documentation

Getting Started | 入门指南

• QUICK-START.md - START HERE! 3分钟快速开始
• USAGE-MODES.md - 使用模式对比（个人 vs 团队）
• CONFIGURATION-SUMMARY.md - 配置总结（已完成的内容）
• UK-SETUP-GUIDE.md - UK用户完整设置指南

Design & Architecture | 设计与架构

• agent-design.md - 完整架构与协作流程设计
• mcp-tools-requirements.md - MCP 工具需求与配置指南
• CORE-ECONOMICS-GUIDE.md - 经济学家Agent参考指南（CORE方法）

Technical Documentation | 技术文档

• servers/README.md - UK Weather MCP Server 技术文档
• data/README.md - 数据目录说明
• SCHEDULE-WORKFLOW-GUIDE.md - 日程规划工作流指南（紧凑模式）

Feishu Bot Integration | 飞书机器人接入

• FEISHU-BOT-SETUP.md - 完整飞书机器人配置指南
• servers/feishu-bot-server.js - 飞书机器人服务器实现

For UK Users | 英国用户

This project is specially optimised for UK users! 本项目已针对英国用户进行优化！

Quick Start (3 minutes) | 快速开始

Step 1: Run Setup

Windows:

setup.bat

Mac/Linux:

./setup.sh

Step 2: Verify Configuration

node check-setup.js

Step 3: Follow Instructions

See QUICK-START.md for complete step-by-step guide!

---

What's Already Configured | 已配置内容

• All MCP servers configured
• Node.js dependencies installed (20 packages)
• Data directories created
• Configuration files generated
• ️ Ready to add your API key!

See CONFIGURATION-SUMMARY.md for full details.

UK-Specific Features | 英国特色功能

Weather Agent | 天气预报:

• Full UK postcode support (e.g., SW1A 1AA, M1 1AE, EH1 1YZ)
• Temperature in Celsius, wind in mph (British standard units)
• UK weather alerts (storms, floods, snow warnings)
• British weather-appropriate clothing advice
• All UK regions: England, Scotland, Wales, Northern Ireland

Documentation | 文档

• QUICK-START.md - Get running in 3 minutes!
• UK-SETUP-GUIDE.md - Complete UK user guide
• mcp-tools-requirements.md - All MCP tools explained