AI 助手与协作

---

AI 助手（DeepSeek）

iTodo++ 内置了 AI 对话助手（基于 DeepSeek），你可以用自然语言直接创建任务，AI 会自动解析出时间、优先级、清单和标签。

如何打开

在 Web 端右下角点击「🤖 AI 助手」图标即可打开对话面板。

使用方式

直接告诉 AI 你想做的事，例如：

• 「提醒我明天下午 3 点开会，重要」
• 「下周一之前交周报」
• 「每天提醒我喝水」

AI 会结合当前时间、已有的清单与标签，自动把相对时间与优先级换算为结构化字段并创建任务。

配置 API Key

AI 助手需要配置 DeepSeek 的 API Key 才能使用，有两种方式：

1. 应用内配置：在 AI 助手面板的「设置」中填写 API Key、模型等，保存后即时生效（配置持久化保存在后端，API Key 对外返回时自动脱敏）。
2. 环境变量：后端部署时通过 .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）

---

共享清单（协作）

iTodo++ 支持将清单共享给其他用户，实现多人协作。

• 分享清单：在「我的清单」中右键清单，选择共享，生成邀请。
• 接受邀请：被邀请人会收到共享邀请，接受后即可查看和编辑该清单（侧边栏会显示「共享」标记）。
• 多人协同：共享清单内的任务对所有成员可见，方便团队共同维护一份待办。

---

MCP 接口（高级）

后端在 POST /api/mcp 上实现了 MCP（Model Context Protocol） 接口，可被支持 MCP 的客户端（如 Claude Desktop 等 AI 客户端）直接接入，通过 create_task 工具以编程方式创建任务。

客户端配置示例（保存为 mcp.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。