Craft Notes

核心用法

Craft CLI 是一个非官方的命令行工具，用于与 Craft.do 笔记应用进行交互。主要功能包括：

文档管理：列出文件夹和文档、获取文档内容、搜索文档、创建新文档，以及访问每日笔记（daily notes）。

内容编辑：通过 Markdown 格式向文档添加块（block）、更新或删除现有内容，支持直接追加到每日笔记。

任务系统：管理 Craft 内置任务，包括查看收件箱、活跃任务、即将到期和已完成任务，支持添加、完成和删除任务。

集合浏览：访问 Craft Collections 中的结构化数据。

显著优点

• 高效工作流：开发者无需离开终端即可快速记录想法、管理任务，减少上下文切换
• Markdown 原生支持：符合技术用户的内容编写习惯
• 每日笔记集成：适合日志记录和习惯追踪场景
• 轻量部署：单脚本文件，依赖简单

潜在缺点与局限性

• 非官方工具：依赖 Craft Connect 的私有 API，可能随 Craft 更新而失效
• 功能边界：无法替代 Craft 原生应用的全部功能，如复杂排版、协作特性
• 认证方式：需手动配置 API URL，无 OAuth 等标准认证流程
• 平台限制：仅支持 macOS/iOS 用户（Craft 本身限制）

适合人群

• 习惯终端工作流的开发者、技术写作者
• 需要快速记录、轻量任务管理的 Craft 重度用户
• 希望将笔记系统与脚本、自动化工具链集成的用户

常规风险

• API 稳定性：非官方实现，Craft 官方可能随时更改或限制 API
• 数据安全：API URL 包含访问凭证，需妥善保管环境变量
• 同步冲突：CLI 操作与移动端/桌面端同时编辑可能导致冲突
• 无版本回退：误操作删除块或任务难以恢复

核心用法

Craft CLI 是一个命令行接口文档型 Skill，帮助用户通过终端管理 Craft.do 笔记应用中的文档、任务和日常笔记。

主要功能模块

| 模块 | 命令示例 | 用途 |

|------|---------|------|

| 文档管理 | `craft folders`, `craft docs`, `craft search` | 浏览、搜索、创建文档 |

| 日常笔记 | `craft daily [date]`, `craft add-to-daily` | 查看和写入每日笔记 |

| 块操作 | `craft add-block`, `craft update-block` | 文档内容的增删改 |

| 任务管理 | `craft tasks`, `craft add-task`, `craft complete-task` | 完整的任务工作流 |

| 集合管理 | `craft collections`, `craft collection-items` | 访问 Craft 集合功能 |

配置要求

需设置 CRAFT_API_URL 环境变量，从 Craft 应用设置中获取 Connect 链接。

显著优点

1. 纯文档安全：T-MD 类型 Skill，无可执行代码，零运行时风险
2. 功能覆盖全面：涵盖文档、任务、日常笔记、集合四大核心场景
3. 命令设计直观：Unix 风格 CLI 设计，学习成本低
4. Markdown 原生：内容输入支持 Markdown，与 Craft 的块级架构契合
5. 日期灵活：支持 today/yesterday 语义化日期和 ISO 8601 格式

潜在局限

1. 外部依赖：实际功能依赖未打包的 scripts/craft CLI 工具，需用户自行验证来源
2. T3 来源可信度：个人开发者维护，无企业级 SLA 保障
3. API 密钥管理：需手动配置环境变量，无内置安全存储机制
4. 平台限制：仅支持 macOS/iOS 生态，跨平台用户无法使用

适合人群

• Craft.do 深度用户，追求键盘驱动的工作流
• 开发者/技术从业者，习惯命令行操作
• 需要自动化笔记管理的效率工具爱好者
• 日常依赖每日笔记（Daily Notes）进行时间管理的用户

常规风险

• API 链接泄露：CRAFT_API_URL 包含访问凭证，需妥善保管环境变量
• CLI 工具来源不明：引用的外部脚本未经验证，建议审查后再执行
• API 变更风险：Craft.do 非公开 API 可能随产品更新变动