craft

📝 Craft 笔记命令行管理专家

办公榜 #19

社区开发的 Craft.do CLI 工具技能,通过命令行管理笔记、文档与任务,实现 Craft 内容的自动化操作与高效管理。

收藏
15k
安装
3.8k
版本
v1.0.0
CLS 安全性认证2026-05-05
点击查看完整报告 >

使用说明

该 Skill 为 Craft.do 笔记应用提供了完整的命令行接口封装,使用户能够通过终端与 Craft 文档、任务和集合进行交互。支持文档的创建、搜索、内容获取,块的增删改查,任务的完整生命周期管理(添加、完成、删除),以及每日笔记的自动化操作。所有操作均通过调用外部 craft CLI 工具实现,采用 Markdown 格式进行内容输入,支持通过日期参数(today/yesterday/YYYY-MM-DD)和作用域参数(inbox/active/upcoming/logbook)进行精细控制。

显著优点在于功能覆盖面广,几乎涵盖了 Craft 应用的核心操作场景,从基础的文档管理到复杂的任务追踪均可通过命令行完成。支持每日笔记(Daily Notes)的自动化,适合建立日志工作流。采用 Markdown 作为内容格式,符合开发者和技术写作者的习惯。纯文档型实现,本身不包含可执行代码,安全性高。提供了清晰的参数说明和边界提示(如引号转义、日期格式),降低了使用门槛。

潜在缺点与局限性主要体现在外部依赖:Skill 本身不包含 craft CLI 可执行文件,用户需要自行下载安装并配置 CRAFT_API_URL 环境变量,增加了部署复杂度。来源可信度为 T3 级(个人开发者),缺乏官方背书。功能受限于 Craft Connect API 的能力边界,无法突破官方接口限制。仅适用于已订阅 Craft 的用户,且主要面向 macOS/iOS 生态。此外,所有操作都需要网络连接至 Craft 服务器,离线场景无法使用。

最适合 Craft.do 的重度用户,特别是习惯使用命令行和自动化工作流的开发者、技术写作者。适合需要批量处理笔记内容、建立自动化日志系统(如每日站会记录、日报生成)的团队。对于追求键盘操作效率、希望将 Craft 集成到现有终端工作流(如配合 Alfred、Raycast 或其他 CLI 工具)的高级用户尤为适用。不推荐无 Craft 账号或纯图形界面依赖的用户使用。

使用风险方面,性能上所有操作依赖网络 API 调用,受 Craft 服务器响应速度影响,不适合高频实时操作。安全层面,虽然 Skill 本身安全,但依赖的外部 craft 脚本需要用户自行审查,避免下载恶意代码。API URL 的保管至关重要,泄露可能导致笔记数据被访问。环境配置方面,错误的 API 配置可能导致操作失败或数据写入错误位置。此外,作为社区维护项目,长期支持稳定性和功能更新频率存在不确定性。

安全解读

核心用法

Craft CLI Skill 为 Craft.do 用户提供完整的命令行管理能力,涵盖文档、块内容和任务三大核心模块。

文档管理:支持列出文件夹、浏览各类文档(未分类、回收站、模板、每日笔记)、按 ID 获取内容、搜索全文,以及创建新文档。craft daily 命令可快速访问特定日期的 Daily Note,配合 craft add-to-daily 实现日记流式记录。

块操作:通过 add-blockupdate-blockdelete-block 对文档内容进行精细化编辑,add-to-daily 则专为 Daily Note 场景优化,支持 Markdown 格式输入。

任务系统:完整的 GTD 风格任务管理,包括收件箱、进行中、即将到期、已完成四个视图,支持添加、完成、删除任务及指定调度日期。

集合查询:可列出所有集合并获取集合内项目,便于管理 Craft 的数据库类内容。

显著优点

1. 零配置门槛:纯 Markdown 文档型 Skill,无可执行代码,天然安全
2. 官方 API 支持:直接对接 Craft.do 官方 Connect API,稳定性有保障

3. 完整工作流覆盖:从记录、整理到任务追踪,覆盖个人知识管理全链路

4. 灵活的日期语法:支持 today/yesterday 及标准日期格式,交互友好

5. 环境变量隔离:API 凭证由用户自主配置,Skill 本身不触碰敏感信息

潜在局限

  • macOS/iOS 生态绑定:Craft 本身为 Apple 平台专属,跨平台用户无法使用
  • API URL 管理成本:用户需手动获取并维护 API 链接,存在凭证泄露风险
  • 无离线能力:完全依赖 Craft.do 云服务,网络中断时不可用
  • 功能受限于官方 API:Craft Connect API 的能力边界决定了 Skill 的功能上限

适合人群

  • 已深度使用 Craft.do 的笔记用户
  • 偏好命令行效率、追求键盘驱动工作流的开发者/写作者
  • 需要自动化 Daily Note 记录或任务管理的效率工具爱好者
  • 希望在终端环境中统一操作笔记、代码、任务的技术工作者

常规风险

  • API 凭证安全:CRAFT_API_URL 相当于访问令牌,若泄露他人可读取/修改您的 Craft 内容
  • 脚本来源验证scripts/craft CLI 工具需用户自行下载安装,建议审查代码后再执行
  • 数据归属风险:Craft 为商业 SaaS,存在服务变更或数据迁移可能性
  • 操作不可逆delete-blockdelete-task 等操作无二次确认,误操作可能导致数据丢失

综合评价

Craft CLI 是专为 Craft.do 用户打造的优质效率工具,以纯文档形式提供安全、透明的 CLI 管理能力。S 级安全评分和 T2 可信来源背书,使其成为 Apple 生态知识管理用户的可靠选择。

craft 内容

手动下载zip · 1.4 kB
SKILL.mdtext/markdown
请选择文件