为 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 策略可能随版本调整，存在功能回退或定价变更风险
– **同步冲突**：双向同步时缺乏冲突解决机制，可能导致数据丢失
会员专属
