SuperAPI AI 工具集

craft

办公与效率

查看项目

更新于 10-16 07:11

技能介绍

Craft CLI 是一个命令行工具,用于与 Craft.do 中的文档、块和任务进行交互。它适合希望通过终端或脚本管理 Craft 内容的用户。

用途:通过命令行管理 Craft 笔记、文档和任务,支持添加笔记、创建文档、管理任务、搜索文档等操作。

主要能力:

  • 文档操作:列出文件夹、列出文档(支持 unsorted、trash、templates、daily_notes 等位置)、按 ID 获取文档内容、获取每日笔记(今天、昨天或指定日期)、搜索文档、创建新文档。
  • 块操作:向文档添加块、向每日笔记添加内容、更新已有块、删除块。
  • 任务操作:列出任务(支持 inbox、active、upcoming、logbook 范围)、添加任务到收件箱、标记任务完成、删除任务。
  • 集合操作:列出所有集合、获取集合中的项目。

使用方式:

  1. 安装:将 scripts/craft 复制到 ~/bin/craft 并使其可执行。
  2. 获取 API URL:在 Craft 中进入 Settings > Integrations > Craft Connect > Create Link。
  3. 设置环境变量:export CRAFT_API_URL='https://connect.craft.do/links/YOUR_LINK/api/v1',并添加到 shell 配置文件中以持久化。
  4. 使用命令:如 craft folders、craft docs [location]、craft doc <id>、craft daily [date]、craft search <term>、craft create-doc "Title" [folderId]、craft add-block <docId> "markdown"、craft add-to-daily "markdown" [date]、craft update-block <blockId> "markdown"、craft delete-block <blockId>...、craft tasks [scope]、craft add-task "text" [scheduleDate]、craft complete-task <id>、craft delete-task <id>、craft collections、craft collection-items <id>。

注意事项:

  • Markdown 内容作为参数传递,必要时需转义引号。
  • 日期格式:today、yesterday 或 YYYY-MM-DD。
  • 任务范围:inbox(默认)、active、upcoming、logbook。
  • 文档位置:unsorted、trash、templates、daily_notes。

适用场景:适合需要批量管理 Craft 文档、任务,或希望通过命令行自动化操作的用户。

限制:需要有效的 Craft API 链接;具体功能可能受 Craft API 限制;暂未提供其他平台或收费信息。