什么是Craft Connect
Craft Connect 是一个专为 Craft 文档空间设计的 REST API 工具，允许开发者通过命令行或脚本对 Craft 中的文档、任务、文件夹和集合进行自动化管理。它支持完整的 CRUD 操作，包括创建、读取、更新和删除文档及其内容块，同时还能处理搜索、任务管理和结构化数据集合等高级功能。该工具基于 curl 实现，使用 JSON 格式进行数据传输，并通过嵌入的链接令牌完成身份验证，确保安全访问用户私有空间。 要使用 Craft Connect，用户首先需在 Craft 设置中生成一个连接链接，获取 API 基础 URL 并存储在本地配置文件中（如 TOOLS.md）。所有 API 请求均通过标准的 HTTP 方法发送，读写操作需分别指定 `Content-Type: application/json` 和 `Accept: application/json` 头部。特别需要注意的是，非 ASCII 字符（如中文）必须在查询参数中进行 URL 编码，否则可能导致请求失败。 Craft Connect 的设计目标是让技术用户能够高效集成 Craft 到自动化工作流中，无论是批量生成日报、维护知识库，还是构建个人效率系统，都能通过简洁的命令行接口快速完成任务。其灵活的内容插入方式支持 Markdown 和原生 Blocks JSON 两种模式，满足不同场景下的排版与控制需求。
核心功能特点
- 支持对 Craft 文档、块、文件夹、任务和评论的全套 CRUD 操作
- 提供全文搜索与按日期、位置、文件夹过滤的文档检索能力
- 可通过 Markdown 或 Blocks JSON 两种方式写入内容，兼容多种排版需求
- 支持创建和管理结构化集合（类似 Notion 数据库），具备动态 schema 管理
- 集成任务系统，可在每日笔记、文档或收件箱中创建、完成或删除任务
- 支持文件上传、图片托管、数学公式、代码块、表格及富媒体链接预览
适用场景
Craft Connect 特别适合需要定期生成标准化内容的场景，例如每日自动生成工作日志或项目进展报告。通过在脚本中调用 API，可以在每天固定时间向“今日笔记”追加新条目，自动插入任务列表或总结段落，极大提升信息记录的一致性与可追踪性。对于远程工作者或分布式团队而言，这种自动化机制确保了知识沉淀不受地理位置影响。 另一个典型应用场景是个人知识库的维护与扩展。开发者可以利用 Craft Connect 编写脚本批量导入外部资料、整理归档旧文档、清理回收站，甚至根据关键词自动分类到指定文件夹。结合集合功能，还能将分散的信息聚合成结构化视图，比如任务看板、资源清单或会议纪要数据库，实现从碎片化记录到系统化管理的转变。 此外，Craft Connect 也适用于构建个人自动化工具链的一部分。例如，结合日历应用同步日程至 Craft 任务；或在完成某个 Git 提交后自动在项目中添加一条带标签的记录；亦或是将第三方服务的通知自动转为 Craft 中的待办事项。这些场景都依赖于稳定、可编程的 API 接口，而 Craft Connect 正是为此类集成需求提供了可靠的技术支撑。