DeepSeek Chat 接口文档

一、AI 内部命令格式

1.1 待办事项

[新增待办] 标题 | 优先级 | 截止日期 | 科目
[删除待办] 标题

字段	取值
优先级	高 / 中 / 低
截止日期	YYYY-MM-DD，无则 无
科目	学科/分类名，无则 无

示例：[新增待办] 化学作业 | 高 | 2026-09-30 | 化学

1.2 日程（含循环）

[新增日程] 标题 | 日期 | 开始时间 | 结束时间 | 地点 | 重复 | 间隔 | 重复截止
[删除日程] 标题

字段	取值
日期	YYYY-MM-DD
开始/结束时间	HH:MM；全天填 全天；未知填 无
地点	具体地点，无则 无
重复	无 / 每天 / 每周 / 每月 / 每年
间隔	数字（如每 2 周填 2，默认 1）
重复截止	YYYY-MM-DD，无则 无

示例：[新增日程] 每周例会 | 2026-09-20 | 10:00 | 11:00 | 三教101 | 每周 | 2 | 2026-12-31

1.3 学期规则

[新增学期] 名称 | 起始日期 | 周数
[删除学期] 名称

字段	取值
起始日期	第一周任意一天的 YYYY-MM-DD（所在那周即第 1 周）
周数	数字（默认 18）

示例：[新增学期] 2026秋 | 2026-09-01 | 18

二、认证接口

方法	路径	说明
POST	/api/auth/login	登录（body: username, password）
POST	/api/auth/logout	登出
POST	/api/auth/register	邀请码注册（body: username, password, invite_code）
GET	/api/auth/me	当前用户信息
POST	/api/auth/password	修改密码（body: old_password, new_password）

三、会话接口

方法	路径	说明
GET	/api/conversations	列出会话（query: agent_id 可选）
POST	/api/conversations	新建会话（body: agent_id）
GET	/api/conversations/:id	会话详情（含消息）
PATCH	/api/conversations/:id	重命名（body: title）
DELETE	/api/conversations/:id	删除会话
POST	/api/chat	发送消息（SSE 流式）
POST	/api/retry	重新生成最后一条回答
POST	/api/edit	编辑用户消息并重新生成
POST	/api/stop	停止生成

四、待办接口

方法	路径	说明
GET	/api/todos	列出待办
POST	/api/todos	新建待办
PATCH	/api/todos/:id	更新待办
DELETE	/api/todos/:id	删除待办
POST	/api/todos/delete	按标题删除（body: title）

待办字段：title, notes, priority(high/medium/low), due_date(YYYY-MM-DD), category, completed。

五、日程接口

方法	路径	说明
GET	/api/events	列出日程（query: start, end 可选）
POST	/api/events	新建日程
PATCH	/api/events/:id	更新日程
DELETE	/api/events/:id	删除日程
POST	/api/events/delete	按标题删除（body: title）

日程字段：title, notes, location, date(YYYY-MM-DD), start_time, end_time, all_day, repeat(none/daily/weekly/monthly/yearly), repeat_interval, repeat_end。

六、学期接口

方法	路径	说明
GET	/api/semesters	列出学期规则
POST	/api/semesters	新建学期规则
PATCH	/api/semesters/:id	更新学期规则
DELETE	/api/semesters/:id	删除学期规则
POST	/api/semesters/delete	按名称删除（body: name）

学期字段：name, start_date(YYYY-MM-DD), total_weeks。

七、其他接口

方法	路径	说明
GET	/api/config	读取用户配置
POST	/api/config	保存用户配置
GET	/api/models	可用模型列表
GET	/api/balance	DeepSeek 账户余额
GET	/api/ics-token	获取苹果日历订阅链接
GET	/ics/:token.ics	ICS 订阅（公开，凭 token）
GET	/api/agents	列出智能体
POST	/api/agents	新建智能体