使用 craft CLI 工具管理 Craft文档,支持列表、搜索、创建、更新、删除,以及导出为 JSON、表格或 Markdown 格式。
CLI 技能, 通过 CLI 工具与 CLI 文档交互是一项面向实际任务的技能,主要用于快速, 节能, LLM 准备;手提CLI 二进制应安装在 /usr/ local/ bin/ craft;
该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
通过 craft CLI 工具与 Craft 文档交互。快速、令牌高效、面向大语言模型(LLM)优化。
craft CLI 二进制文件应安装在 /usr/local/bin/craft 路径下。
若尚未安装,请执行:
curl -L https://github.com/nerveband/craft-cli/releases/download/v1.0.0/craft-darwin-arm64 -o craft chmod +x craft sudo mv craft /usr/local/bin/
当前可用两个 Craft 空间:
~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/5VruASgpXo0/api/v1
~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/HHRuPxZZTJ6/api/v1
# 切换至 wavedepth 空间 ~/clawd/skills/craft-cli/craft-helper.sh wavedepth # 切换至个人空间 ~/clawd/skills/craft-cli/craft-helper.sh personal # 查看当前空间 ~/clawd/skills/craft-cli/craft-helper.sh current
查看当前配置:
~/clawd/skills/craft-cli/craft config get-api
# JSON 格式(默认,适用于 LLM) ~/clawd/skills/craft-cli/craft list # 人类可读的表格格式 ~/clawd/skills/craft-cli/craft list --format table # Markdown 格式 ~/clawd/skills/craft-cli/craft list --format markdown
# 搜索文档 ~/clawd/skills/craft-cli/craft search "查询关键词" # 表格格式输出结果 ~/clawd/skills/craft-cli/craft search "查询词" --format table
# 根据文档 ID 获取(JSON 格式) ~/clawd/skills/craft-cli/craft get# 保存为文件 ~/clawd/skills/craft-cli/craft get --output document.md # 指定其他格式 ~/clawd/skills/craft-cli/craft get --format markdown
# 仅指定标题创建 ~/clawd/skills/craft-cli/craft create --title "我的新文档" # 从文件创建 ~/clawd/skills/craft-cli/craft create --title "我的文档" --file content.md # 内联 Markdown 创建 ~/clawd/skills/craft-cli/craft create --title "速记笔记" --markdown "# Hello\nThis is content" # 创建为另一文档的子文档 ~/clawd/skills/craft-cli/craft create --title "子文档" --parent
# 更新标题 ~/clawd/skills/craft-cli/craft update--title "新标题" # 从文件更新内容 ~/clawd/skills/craft-cli/craft update --file updated-content.md # 使用内联 Markdown 更新 ~/clawd/skills/craft-cli/craft update --markdown "# Updated\nNew content" # 同时更新标题与内容 ~/clawd/skills/craft-cli/craft update --title "新标题" --file content.md
~/clawd/skills/craft-cli/craft delete
# 显示 API 信息及最近文档 ~/clawd/skills/craft-cli/craft info # 列出所有可用文档 ~/clawd/skills/craft-cli/craft docs
~/clawd/skills/craft-cli/craft version
可通过配置设置默认格式,或在每条命令中使用 --format 参数临时指定。
可在任意命令中临时覆盖已配置的 API URL:
~/clawd/skills/craft-cli/craft list --api-url https://connect.craft.do/links/ANOTHER_LINK/api/v1
CLI 提供清晰的错误信息,并返回对应退出码:
常见错误提示:
authentication failed. Check API URL — API URL 无效或未授权resource not found — 文档 ID 不存在rate limit exceeded. Retry later — 请求频率超限no API URL configured. Run 'craft config set-api ' first — 缺少 API URL 配置# 列出 wavedepth 空间中的全部文档 ~/clawd/skills/craft-cli/craft config set-api https://connect.craft.do/links/5VruASgpXo0/api/v1 ~/clawd/skills/craft-cli/craft list --format table # 搜索特定文档 ~/clawd/skills/craft-cli/craft search "proposal" --format table
# 创建新文档 ~/clawd/skills/craft-cli/craft create --title "项目笔记" --markdown "# 初始笔记\n\n从这里开始。" # 从输出中获取文档 ID,然后更新 ~/clawd/skills/craft-cli/craft update--title "更新后的项目笔记" # 验证更新结果 ~/clawd/skills/craft-cli/craft get --format markdown
# 获取指定文档并保存为文件 ~/clawd/skills/craft-cli/craft get--output exported-notes.md
# 以 JSON 格式获取全部文档(可管道传递至后续处理)
~/clawd/skills/craft-cli/craft list | jq '.[] | {id, title}'
# 搜索并提取特定字段
~/clawd/skills/craft-cli/craft search "meeting" | jq '.[].title'
craft config get-apicraft config set-api 快速切换空间--api-url 参数而非修改全局配置源代码与文档地址:https://github.com/nerveband/craft-cli
当前版本:1.6.0
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章