SuperAPI AI 工具集

pachca-tasks

通用与其它

查看项目

更新于 10-15 21:40

技能介绍

用途:通过命令行管理 Pachca 中的任务与提醒,适用于创建任务/提醒、查看未完成事项、按项目聊天筛选任务、更新状态与执行人、删除任务等场景。

必要用法:先向用户索取 Pachca token(机器人:集成 → 机器人 → API 标签;用户:集成 → API)。命令通过 npx -y @pachca/cli 执行,加 --token 参数,例如 npx -y @pachca/cli <command> --token $PACHCA_TOKEN;也可先 export PACHCA_TOKEN=<token> 后省略 --token。可用 npx -y @pachca/cli --help 与 npx -y @pachca/cli guide 查看帮助和工作流。若已配置并保存 profile,可先运行 npx -y @pachca/cli auth status 检查,成功后可不用 --token。使用成功后可建议全局安装:npm install -g @pachca/cli && pachca auth login --token $PACHCA_TOKEN。

主要能力:创建任务时可指定 --kind(call、meeting、reminder、event、email)、--content、--due-at、--chat-id,以及 custom_properties 补充字段(其 value 始终为字符串,字段可通过 GET /custom_properties?entity_type=Task 获取)。查询用 tasks list,支持 --status=undone 或 done、--all、--author-id、--performer-ids、--chat-ids;使用 --chat-ids 后不再局限于自己的任务,会返回指定聊天的全部任务,不可访问的聊天会被静默忽略,最多 100 个 id。用 tasks get <ID> 查看单条任务,tasks update <ID> 可改状态或字段(如 --status=done、--due-at、--priority、--performer-ids,其中 performer_ids 会替换整个列表,优先级 1 普通、2 重要、3 非常重要)。删除用 tasks delete <ID> --force,不可恢复,仅关闭任务应改为更新状态为 done。批量提醒需自行准备日期列表后逐条创建。

限制:速率限制约 50 请求/秒,遇 429 应等待重试;limit 最大 50,分页基于 cursor(limit + cursor);kind 与 status 取值受上述枚举限制;参数不确定时可运行 pachca <command> --help。