叽咕助手3.0使用说明

叽咕 - 智能日程规划助手用户指南

目录

  1. 简介
  2. 快速开始
  3. 核心功能
  4. 数据管理
  5. 规划功能
  6. 日常对话
  7. 数据存储
  8. 注意事项

简介

叽咕是一只可爱的小鹦鹉，作为你的智能日程规划助手。她不仅能帮你管理课程、日程、待办事项，还能根据你的生活习惯和目标生成合理的每日规划。她相当于你的外置大脑！

主要能力

  • 📚 课程管理 — 记录和管理固定课程表
  • 📅 日程记录 — 记录每天发生的事件
  • ✅ 待办事项 — 追踪截止日期和任务
  • 🎯 长期目标 — 规划持续性成长目标
  • 📆 临时日程 — 管理一次性事件
  • 🤖 智能规划 — 生成每日详细计划

快速开始

启动方式

  1. 首次启动：在微信向机器人发送 start
  2. 叽咕会回复"叽咕起床啦~"并启动主程序

基本对话流程

你：发消息给叽咕
   ↓
RouterAgent 识别意图（数据操作/规划/闲聊）
   ↓
分配给对应 Agent 处理
   ↓
ChatAgent 整合结果回复你

核心功能

1. 课程管理 (course)

课程是固定的时间安排，与具体日期无关。

添加课程示例：

你：周一 10:00-12:25 微积分课
你：周三 8:00-9:35 微积分课
你：周五 8:00-9:35 离散数学

叽咕会自动格式化并存储课程信息。

2. 日程记录 (record)

record 是对已发生事件的记录，包含具体日期和时间信息。

记录一天示例：

你：记录一下今天
8:20-9:10 起床吃饭，给车充电，到教室
9:10-11:35 上课
11:35-12:30 吃饭，然后回了宿舍
12:30-13:30 睡午觉

3. 待办事项 (todo)

todo 是有截止日期的任务，包含具体时间点。

添加待办示例：

你：4月15日 23:59 之前完成微积分作业
你：帮我记一下，周五之前要交数据结构报告

4. 长期目标 (target)

target 是需要长期投入的目标，可以指定每周/每月预计投入时间。

添加目标示例：

你：我想参加浙江大学ACM校队选拔
每周大约8小时
五月份参加新手上路比赛
七月份参加校队选拔

5. 临时日程 (temporary)

temporary 是只在特定日期发生的事件。

添加临时日程示例：

你：明天18:50-21:15 有形策课，可以写作业
你：4月20日 上午9点有社团大会

数据管理

快捷指令

操作类型 示例
添加数据 "添加一门课：周一 14:15-15:50 离散数学"
删除数据 "删除4月15日的临时日程：社团大会"
查询数据 "我有哪些课？" / "查看我的待办"

叽咕会自动处理

  • 时间格式标准化（8:00 → 08:00）
  • 12小时制转换（下午3点 → 15:00）
  • 同义词识别（线性代数 / 线代）
  • 冲突检测（同一天多个日程会提示你选择）

规划功能

生成规划

当你说"计划一下"、"帮我规划"时，叽咕会调用 PlanAgent：

  1. 获取你的课程表（确保不冲突）
  2. 查看待办事项（安排在截止前）
  3. 结合长期目标（穿插学习时间）
  4. 参考历史习惯（了解你的作息）
  5. 生成14天内的详细计划

示例：

你：帮我计划一下接下来干什么

叽咕会输出类似这样的规划：

20260415 Plan
7:30-7:45 起床吃饭
7:45-8:00 通勤到教室
8:00-9:35 微积分课程
9:35-9:50 课间休息
9:50-10:00 通勤到近现代史教室
10:00-12:25 中国近现代史纲要
...（继续详细规划）

规划准则

  • 每轮对话最多规划14天
  • 会综合考虑课程强度
  • 每周会安排尝鲜活动（新书、电影等）
  • 必要时调整原有规划

日常对话

闲聊

叽咕会记住你们的对话历史，可以：

  • 聊聊感受（"好累啊"、"今天心情不错"）
  • 询问建议（"我该怎么安排复习？"）
  • 日常聊天

隐藏需求识别

叽咕很聪明，会自动识别你的隐藏需求：

例如你说 "昨天好累啊"，叽咕会：

  1. 查询你昨天的日程记录
  2. 了解你昨天的活动
  3. 结合上下文回复你

数据存储

存储位置

  • data.json — 课程、日程、待办、目标、临时日程
  • plans.json — 生成的规划
  • history.json — 对话历史

数据格式

  • course: 周几 时间段 课程内容
  • record: 日期 内容
  • todo: 截止日期 截止时间 事件
  • target: 目标描述 投入时间 时间节点
  • temporary: 日期 时间段 内容
  • plan: 日期 Plan 内容

退出保存

发送 exit 会保存所有数据并重启程序。

注意事项

⚠️ 重要提示

  1. 数据完整性

    • course 和 record 是时间段
    • todo 和 target 是时间点（只有一个精确时间）
    • 一天只记录一条 record/plan

  2. 规划限制

    • 每轮最多14天
    • 超出部分需要下一轮继续

  3. 模糊表达

    • 叽咕会自动尝试理解模糊表达
    • 如信息不足，会提示你补充

  4. 冲突处理

    • 如果同一天有重复记录，叽咕会询问保留哪个

🔧 技术细节

  • API: DeepSeek Chat
  • 运行依赖: Python 3.13+
  • 需要的包: 参见 requirements.txt

常见问题

Q: 叽咕没有回复我？
A: 检查程序是否正常运行，查看控制台日志。

Q: 如何修改已存储的课程？
A: 先删除旧记录，再添加新记录。

Q: 规划不满意怎么办？
A: 可以说"重新规划"或"调整一下"，叽咕会根据你的反馈重新生成。

Q: 历史记录会无限增长吗？
A: 不会，超过15条后会自动压缩成摘要。

祝你使用愉快！🦜 叽咕随时为你服务！

posted @ 2026-04-12 21:42  Zlc晨鑫  阅读(36)  评论(0)    收藏  举报