SuperAPI AI 工具集

todos

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:通过 Nomendex REST API 管理项目待办事项,适用于用户要求创建、查看、更新或删除待办、按项目列出任务、检查任务状态或按截止时间筛选的场景。

主要能力:待办具有状态字段,控制其在看板中的列,可选值为 todo(默认,未开始)、in_progress(进行中)、done(已完成)、later(延后或积压)。创建时未指定状态则默认为 todo;更新状态时系统会自动把该待办排到目标列末尾。API 自动处理校验、ID 生成、时间戳与排序。看板界面支持拖拽待办在列间移动以改变状态,也可通过 API 以编程方式更新。

使用方式:先发现服务端口,命令为 PORT=$(cat ~/Library/Application\ Support/com.firstloop.nomendex/serverport.json | grep -o '"port":[0-9]*' | cut -d: -f2)。所有端点均使用 POST 加 JSON 请求体,地址为 http://localhost:$PORT。端点包括:/api/todos/create 创建、/api/todos/list 列出(可带项目过滤)、/api/todos/get 按 ID 获取单个、/api/todos/update 更新、/api/todos/delete 删除、/api/todos/projects 列出项目、/api/todos/tags 列出标签、/api/todos/archive 归档、/api/todos/unarchive 取消归档、/api/todos/archived 列出已归档。创建示例:curl -s -X POST "http://localhost:$PORT/api/todos/create" -H "Content-Type: application/json" -d '{"title": "My todo", "project": "work"}'。更新示例:curl -s -X POST "http://localhost:$PORT/api/todos/update" -H "Content-Type: application/json" -d '{"todoId": "todo-123", "updates": {"status": "done"}}'。

适用场景:需要以编程方式管理项目任务、按项目或状态组织待办、在看板中跟踪进度时。

限制:依赖本地 Nomendex 服务及其端口发现文件;资料未提供认证、并发、错误码、字段完整列表、截止时间筛选的具体参数及平台支持范围等信息。