craft-do

Craft.do Integration Skill 是一套针对 Craft.do 精美笔记应用的完整 REST API 集成方案，旨在通过程序化方式解锁笔记应用的自动化潜能。该技能提供了对 Craft.do 全功能的编程访问能力，涵盖任务管理、文档操作、文件夹层级构建以及跨平台数据迁移等核心场景，特别适合追求工作流自动化的效率用户。

核心用法围绕 Craft.do 官方 API v1 展开，支持通过标准 HTTP 请求完成多种操作。在任务管理方面，用户可以创建、更新任务状态（标记完成），并按收件箱、每日笔记、日志本等不同范围查询任务。文档工作流支持创建空白文档、通过 /blocks 端点追加 Markdown 内容、读取完整文档结构，以及在不同文件夹间移动文档。文件夹管理允许构建嵌套层级结构，支持根目录和子文件夹创建。此外，技能特别提供了 Obsidian 仓库完整迁移方案，能够保留内容格式一键迁移至 Craft.do。

显著优点体现在多个维度。首先，它直接对接官方 REST API，数据交互稳定可靠，且原生支持 Markdown 格式，确保内容在程序化操作与人工编辑间无缝衔接。其次，API 设计支持批量操作（如一次性创建多个任务或文档），显著提升自动化效率。与 Obsidian 的集成能力是另一亮点，解决了用户从传统笔记应用向 Craft.do 迁移的痛点。安全性方面，该技能严格遵循最佳实践，所有敏感操作均需用户通过环境变量主动配置 API 密钥，无硬编码凭据风险。

潜在缺点与局限性主要受限于 Craft.do API 当前的覆盖范围。关键限制包括：Collections（数据库表格）功能完全无法通过 API 访问；任务系统仅支持创建和更新，无法删除任务；文档只能移动至回收站，无法永久删除；缺乏搜索端点，难以实现基于内容的全局检索。这些限制意味着复杂的数据库操作或深度清理工作仍需依赖 Craft.do 客户端手动完成。

适合的目标群体包括：日均处理大量结构化笔记的知识工作者、希望将 Craft.do 纳入自动化工作流的技术用户、计划从 Obsidian 迁移至 Craft.do 的存量用户，以及需要跨平台同步任务状态的效率工具爱好者。对于仅使用基础笔记功能的轻度用户，该技能可能显得过于技术化。

使用风险主要集中在配置与操作层面。用户需妥善保管 CRAFT_API_KEY，一旦泄露可能导致笔记数据被未授权访问。虽然清理脚本设有二次确认机制，但批量操作仍可能因参数错误导致文档位置错乱。此外，技能依赖 curl 和 jq 等系统工具，在部分精简环境可能需要额外安装。API 调用受限于网络稳定性，大量批量操作可能触发速率限制，建议在关键操作前进行数据备份。