Appearance
AI 助手与 MCP
PriTime 提供两类 AI 能力：面向普通用户的 AI 助手（DeepSeek），以及面向开发者的 MCP 接口。
AI 助手（DeepSeek）
PriTime 内置了 AI 对话助手（基于 DeepSeek），你可以用自然语言直接创建任务，AI 会自动解析出时间、优先级、清单和标签。
如何打开
在 Web 端右下角点击「🤖 AI 助手」图标即可打开对话面板。
使用方式
直接告诉 AI 你想做的事，例如：
- 「提醒我明天下午 3 点开会，重要」
- 「下周一之前交周报」
- 「每天提醒我喝水」
AI 会结合当前时间、已有的清单与标签，自动把相对时间与优先级换算为结构化字段并创建任务。
配置 API Key
AI 助手需要配置 DeepSeek 的 API Key 才能使用，有两种方式：
- 应用内配置：在 AI 助手面板的「设置」中填写 API Key、模型等，保存后即时生效（配置持久化保存在后端，API Key 对外返回时自动脱敏）。
- 环境变量：后端部署时通过
.env配置DEEPSEEK_API_KEY、DEEPSEEK_BASE_URL、DEEPSEEK_MODEL。
相关配置项：
| 配置 | 默认值 | 说明 |
|---|---|---|
DEEPSEEK_API_KEY | — | DeepSeek API Key |
DEEPSEEK_BASE_URL | https://api.deepseek.com | API 接口地址 |
DEEPSEEK_MODEL | deepseek-v4-flash | 使用的模型（可选 deepseek-v4-pro） |
后端接口
后端通过以下接口支持 AI 能力：
GET /api/ai/settings— 返回脱敏后的配置（含configured、api_key_masked）。PUT /api/ai/settings— 更新配置；api_key传空字符串表示保留原值，传"__CLEAR__"表示清空。POST /api/ai/settings/test— 测试与 DeepSeek 的连通性。POST /api/ai/chat— 对话接口，通过 function calling 自然语言创建任务。入参为{ "messages": [...] }或{ "message": "..." }，出参为{ "reply": "...", "created_tasks": [...] }。
MCP 接口（高级）
后端在 POST /api/mcp 上实现了 MCP（Model Context Protocol） 接口，可被支持 MCP 的客户端（如 Claude Desktop 等 AI 客户端）直接接入，通过 create_task 工具以编程方式创建任务。
客户端配置
客户端配置示例（保存为 mcp.json）：
json
{
"mcpServers": {
"itodo": {
"url": "http://localhost:3000/api/mcp"
}
}
}create_task 工具参数
| 参数 | 类型 | 说明 |
|---|---|---|
title | string（必填） | 任务标题 |
description | string | 描述 |
due_date | string | 截止时间（ISO 8601） |
priority | integer | 0=无，1=低，2=中，3=高 |
list_id | string | 所属清单 id，留空则放入任务箱 |
tag_ids | string[] | 标签 id 数组 |
reminder_type | integer | 0=不提醒，1=准时，2=提前5分钟，3=提前30分钟，4=提前1小时，5=提前1天 |
repeat | integer | 0=不重复，1=每天，2=工作日，3=每周，4=每月，5=每年，6=法定节假日，7=法定工作日，8=自定义每周 |
repeat_weekdays | integer | 自定义每周（repeat=8）时的星期位掩码 |
MCP 接口的交互流程为：先
initialize握手，再tools/list发现工具，最后tools/call调用create_task。