（5735期）Craft API Skill and Obsidian Migration Tool – 自动化你的精美笔记工作流

自动化你的精美笔记工作流 为 Craft.do 笔记应用提供完整 REST API 集成，支持自动化任务管理、文档工作流、文件夹层级构建及内容迁移，适合需要编程操控精美笔记工具的高级用户。 使用说明 核心用法 Craft.do Integration Skill 是一套完整的 REST API 封装方案，允许开发者通过编程方式操控 Craft.do 这款以设计著称的笔记应用。核心能力覆盖四大维度： 1. 任务自动化 在 Inbox、Daily Notes、Logbook 等位置创建、更新任务 支持任务状态切换（active ↔ completed） 可按作用域（active/logbook/upcoming/inbox）批量查询任务 2. 文档工作流 程序化创建文档并指定目标文件夹 通过 /blocks 端点以 Markdown 格式注入内容 读取完整文档内容，支持原生 Markdown 返回 3. 文件夹管理 创建根级或嵌套文件夹（指定 parentFolderId） 在 unsorted、templates 及自定义文件夹间移动文档 4. 数据迁移 提供 Obsidian 完整 Vault 迁移方案，保留 Markdown 格式 支持批量操作与错误处理模式 显著优点 原生 Markdown 支持：双向完整支持标题、列表、任务、链接、代码块等格式，消除格式转换摩擦 精美 UI 的自动化后端：Craft 以视觉设计见长，本 Skill 弥补其缺乏原生自动化的短板 API 设计直观：RESTful 风格，JSON 交互，curl 示例完备，上手门槛极低 任务管理闭环：虽不支持删除，但创建-更新-查询-归档流程完整，适合 GTD 工作流 批量操作支持：数组形式的批量写入，提升效率 潜在缺点与局限性 关键功能缺失：Collections（数据库表格）完全无法通过 API 访问，严重限制结构化数据场景 删除操作受限：无法删除任务或文档，只能移动至特定位置（如 unsorted）间接"清理" 无搜索端点：缺乏正式搜索 API，复杂查询需本地缓存与过滤 单向同步风险：文档建议采用单向同步（Mission Control → Craft），Craft 作为只读视图，否则易产生数据冲突 认证方式单一：仅支持 Bearer Token，无 OAuth 或细粒度权限控制 适合人群 自动化爱好者：希望用脚本替代手动操作 Craft 的进阶用户 系统集成开发者：需要将 Craft 作为展示层、其他系统作为数据源的架构师 Obsidian 迁移用户：寻求保留 Markdown 格式、迁移至更美观笔记工具的用户 任务管理重度用户：依赖 Inbox/Daily Notes 系统、需批量操作任务的生产力实践者 常规风险 API 密钥泄露：文档明确要求环境变量存储，但仍存在误提交代码的风险；泄露后他人可完整访问用户数据 误操作覆盖：批量更新无撤销机制，错误脚本可能导致任务状态或文档内容不可逆变更 数据孤岛：Collections 无法 API 访问，长期可能形成"API 可管理数据"与"仅 UI 可管理数据"的双轨制 服务依赖：Craft 为商业闭源产品，API 策略可能随版本调整，存在功能回退或定价变更风险 同步冲突：双向同步时缺乏冲突解决机制，可能导致数据丢失 原始说明 Integrate with Craft.do to automate tasks, create/manage documents and folders, edit markdown content, and migrate Obsidian vaults using their REST API.