课搭子 — 你的 AI 课搭子

> ⚠️ 课搭子已升级为「大学生内阁（College Cabinet）」v1.0.0。 新品牌、新功能（通知处理），数据完全兼容。本版本（v1.3.0）仅作为迁移跳板，建议尽快升级。

管课表、记日程、盯 DDL、理账本。一个 skill，三个 JSON。

升级至大学生内阁

大学生内阁是课搭子的品牌升级版，数据格式完全兼容，新增通知原文一键处理功能。迁移零风险。

自动迁移

用户说"迁移到大学生内阁"时，AI 执行：

1. 确认 skills/college-cabinet/data/ 目录存在，不存在则创建
2. 将 skills/course-buddy/data/ 下的 schedule.json、courses.json、ledger.json 复制到新路径
3. 验证复制后的 JSON 格式完整
4. 告知用户：迁移完成。请安装「大学生内阁」skill，之后可卸载本 skill

三个 JSON 无需任何格式转换，复制即用。

操作

这是什么

大学不止上课。课表轮换、实验分组、DDL 追命、通知轰炸、账目乱飞——靠脑袋记早晚崩。

课搭子做的事：课表、日程、账本各一个 JSON。AI 只读不写冗余，不跨文件同步。查课表自动算周次、过假期、理补课；实验轮换自动展开，只显示你那一组。日程分三种类型各不同提醒策略。记账自动更新余额，转账双记防漏。

快速上手

1. 创建 skills/course-buddy/data/ 目录
2. 初始化三个空文件：
• schedule.json → {"version":"3.0","events":[]}
• ledger.json → {"version":"1.0","accounts":[],"transactions":[]}
• courses.json → 见下方课表章节
3. 把课表文本或文件发给 AI，让它解析并写入 courses.json
4. 问一句"今天有什么课"验证

数据文件

三个文件是各自领域的唯一数据源。memory 文件只记对话摘要，不从中提取结构化数据。

一、课表（courses.json）

完整结构

{
  "version": "2.0",
  "semester": "2026年春季学期",
  "first_week_date": "2026-03-09",
  "total_weeks": 16,
  "holidays": [
    {"name": "劳动节", "start": "2026-05-01", "end": "2026-05-05"}
  ],
  "makeup_days": [
    {"date": "2026-05-09", "replace_weekday": 1}
  ],
  "courses": [
    {
      "name": "大学物理实验B",
      "weekday": 2,
      "time_start": "08:00",
      "time_end": "11:30",
      "weeks": [2,3,4,5,6,7,8,9,10,11,12,13],
      "location": "分组实验",
      "teacher": "",
      "parallel": true,
      "group": 1,
      "schedule": {
        "2": {"topic": "基本力学量测量", "location": "201室", "teacher": "高志华"},
        "3": {"topic": "单摆运动", "location": "229室", "teacher": "周亚洲"}
      },
      "overrides": {
        "11": {"status": "cancelled", "note": "临时停课"}
      }
    }
  ]
}

字段说明

每个 course 必填：name、weekday（0=周一~6=周日）、time_start、time_end、weeks（包含该课程的周次数组）、location、teacher。

可选字段：

• parallel：true 表示分组实验，多个平行班同时段上课。未告知用户分组时合并显示为一行
• group：用户所在组号
• schedule：周次 → {topic, location, teacher}。每周内容不同的实验课用。无 schedule 的周次使用默认 location/teacher
• overrides：周次 → {status, note}。status 取值：cancelled（该周停课）、postponed_to（顺延至某周）、room_change（换教室）

查询课表时的优先级

对周次 W，确定具体内容的优先级：

1. overrides[W].status = "cancelled" → 该周不上课，跳过
2. overrides[W].status = "postponed_to" → 该周不上课，内容移入目标周
3. schedule[W] 有值 → 使用 schedule 中的 topic、location、teacher
4. 否则 → 使用 course 默认的 location、teacher

计算当前周次

当前周 = floor((今天 - first_week_date) / 7) + 1

查询某一天的课表

1. 确定星期几（weekday）
2. 计算当前周次
3. 在假期内 → 跳过所有课程
4. 在补课日 → 使用被补的 weekday
5. 筛选：weekday 匹配 且 weeks 包含当前周次
6. 对匹配的课程，按优先级确定具体内容
7. 按 time_start 排序

实验课轮换

当用户提供轮换表、分组名单、或每周具体安排时：

1. 确认用户组号
2. 解析轮换规则（每组每周对应的教师/题目/教室）
3. 为每门实验课生成整学期的 schedule
4. 将 schedule 写入 courses.json
5. 临时变动写入 overrides

同一时段同名课程有多条记录时，标注 parallel: true。查询时合并显示为一行。用户告知分组后只显示对应那组的内容。

学期切换

新课表来了 → 解析生成新的 courses.json 覆盖。旧文件改名为 courses-上赛季名称.json 备份。

二、日程（schedule.json）

日程事件有三种类型，行为各不相同。课程不进入 schedule，课表由 courses.json 独立管理。

结构

{
  "version": "3.0",
  "events": [
    {
      "id": "s-20260517-001",
      "date": "2026-05-17",
      "title": "排练",
      "type": "event",
      "time": "14:00-16:00",
      "location": "化一教室",
      "status": "active",
      "category": "活动",
      "note": ""
    },
    {
      "id": "s-20260520-001",
      "date": "2026-05-20",
      "title": "无机化学作业",
      "type": "ddl",
      "time": "",
      "location": "",
      "status": "active",
      "category": "作业",
      "note": "第六章习题"
    },
    {
      "id": "s-20260517-002",
      "date": "2026-05-17",
      "title": "给张三打电话",
      "type": "moment",
      "time": "10:00",
      "location": "",
      "status": "active",
      "category": "电话",
      "note": "确认实验分组"
    }
  ]
}

字段说明

time 字段

格式自动判断：含 - 为时段，不含为时刻。

• event：时段，必填。如 "14:00-16:00"
• ddl：截止时刻，选填。不填表示全天截止（当天任意时间完成即可）。如 "23:59"
• moment：提醒时刻，必填。如 "10:00"

status 三态

• active → 需要提醒
• cancelled → 已取消，永久不再提醒
• done → 已完成

字段值判断替代文本标记解析。

操作

三、记账（ledger.json）

多账户收支管理。每次交易自动更新余额，转账强制双记防漏。

结构

{
  "version": "1.0",
  "accounts": [
    {"id": "campus_card", "name": "校园卡", "balance": 579.25},
    {"id": "wechat", "name": "微信", "balance": 320.00}
  ],
  "transactions": [
    {
      "id": "txn-001",
      "date": "2026-05-17",
      "time": "12:30",
      "account": "校园卡",
      "amount": -9.50,
      "type": "expense",
      "category": "餐饮",
      "item": "午餐",
      "note": ""
    }
  ]
}

字段说明

accounts

transactions

转账规则

转账（type=transfer）必须双记：一条从源账户出（负数），一条入目标账户（正数）。写入后立即验证两账户余额变动是否匹配，不匹配则回滚。

修正与退款

不修改、不删除原始交易。修正方式：

• 记错金额 → 追加修正记录，note 标注"修正 txn-xxx"
• 退款 → 追加反向记录，note 标注"退款 txn-xxx"

操作

提醒规则

提醒分两层：定时简报（cron 触发，推送摘要）和实时提醒（心跳/定时任务触发，即时推送）。

定时简报

简报档位、时间、模块均可自由设定。默认提供四档，用户可增删。

默认简报：

模块仅限以下预设，不可超出：

事件在简报中的出现策略

三种 type 在简报中出现的方式不同：

• ddl：所有简报中都出现，每次显示剩余天数倒计时。距截止日 ≤ 3 天时语气加重，标注"临近 DDL"。不受假期影响。
• event：在事件所在日期前的最后 N 次简报中开始提醒（默认 N=2）。例如 14:00 的事件，中午和晨间简报各提醒一次；19:00 的事件，午间和晨间各提醒一次。事件结束后对应简报不再出现。
• moment：在事件前的最后 1 次简报中提醒。同时写入心跳/定时任务的"今日待提醒"列表，以便临近时刻做即时推送。时刻过后标 done。

以上 strategy 参数可配置，见下方。

实时提醒

心跳或短周期定时任务（建议每 5-10 分钟）检查：

• moment：当前时间距事件的 time 不足 10 分钟 → 推送提醒。超过 time → 标 done
• event：当前时间超过 time_end → 标 done（维护性检查，不做推送）

可配置参数

schedule.json 顶层可加入 reminder 字段，覆盖默认值。不填则使用默认。

{
  "version": "3.0",
  "reminder": {
    "briefings": [
      { "id": "morning", "time": "06:40", "label": "晨间简报", "modules": ["weather", "courses", "events", "ddl"] },
      { "id": "noon",    "time": "12:40", "label": "午间简报", "modules": ["weather", "courses_pm", "events", "ddl"] },
      { "id": "evening", "time": "19:00", "label": "晚间简报", "modules": ["events", "courses_tomorrow", "ddl"] },
      { "id": "night",   "time": "22:00", "label": "睡前简报", "modules": ["weather_tomorrow", "ddl", "balance", "backup"] }
    ],
    "advance": {
      "event": { "briefings": 2 },
      "moment": { "briefings": 1, "heartbeat": true },
      "ddl": { "briefings": "all", "urgent_days": 3 }
    }
  },
  "events": [...]
}

用户口头调整（"早上改成 7:00 推送"、"晚间只保留 DDL 和课表"、"去掉午间简报"）→ AI 更新 reminder 配置。

时间比较规则：只比较结束时间是否已过。开始时间在未来不等于已过。

安全规则

• 修改任何 JSON 前，先复制到 data/backups/文件名-YYYY-MM-DD.json
• 写入后立即验证 JSON 格式（python3 -c "import json; json.load(open('...'))"）
• 验证失败 → 回滚备份
• 禁止物理删除记录。取消或修正只改 status 或追加修正条目
• 备份最多保留 7 个

升级与兼容

每次大版本变化的迁移路径在此记录。AI 读取数据时自动检测版本并执行迁移，用户无感知。

数据格式版本对照

自动迁移

AI 每次读取 schedule.json 时执行以下检查，按优先级逐一处理：

1. version < "3.0" → 来自 v1.0.0

旧七种 type 映射为新三种：

同时删除每条 event 的 weekday 字段。time 格式不变（旧版均为时段格式）。完成后将 version 写为 "3.0"。

2. 无 reminder 顶层字段 → 来自 v1.1.0

以默认值写入：四档简报、advance 默认参数。

3. reminder.briefings 为对象而非数组 → 旧版格式

转为数组结构，每个 key 作为 id 字段，值保持不变。

迁移完成后立即执行备份与格式验证（遵守安全规则）。迁移失败则回滚并告知用户。

扩展

课搭子的课表、日程、记账功能是自包含的。以下可作为独立 skill 配合使用：

• 大学生内阁（College Cabinet）：课搭子的品牌升级版，新增通知处理。建议升级
• balance-checker：查询 AI API 平台余额
• 天气类 skill：定时提醒中附加天气信息