craft-cli

📝 Craft 文档命令行效率工具

开源 Craft CLI 接口,JSON 优先实现文档管理,支持 LLM 工作流集成,实现 Craft.do 知识库自动化。

收藏
15.8k
安装
3.6k
版本
1.6.2
CLS 安全性认证2026-06-03
点击查看完整报告 >

使用说明

该技能封装了 craft-cli 工具,为用户提供与 Craft.do 知识库交互的标准化接口。核心用法涵盖文档的全生命周期管理:通过 listsearch 实现文档检索,支持 JSON、Markdown、Table 三种输出格式;利用 createupdatedelete 完成文档的增删改,支持从文件读取或内联 Markdown 输入;同时提供 config 命令管理 wavedepth(商业)与个人双空间配置。特别设计了 craft-helper.sh 脚本实现工作区快速切换,适配多场景需求。

显著优点体现在架构设计与使用体验两个维度。其一,JSON 默认输出格式专为 LLM 优化,可直接管道传输至 jq 等工具进行数据处理,极大降低了 AI 工作流的上下文消耗;其二,安装部署简单,仅需下载单二进制文件并配置 API 端点即可使用,无复杂依赖;其三,支持父子文档嵌套创建与多格式导出,满足知识库结构化需求;其四,完善的错误码体系(0-3 级)与清晰的错误提示,便于自动化脚本中的异常处理。

潜在缺点主要源于其架构定位。首先,强依赖第三方 SaaS 服务 Craft.do,需保持网络连通性,且受限于 Craft.do API 的可用性与速率限制;其次,作为 T3 来源的个人项目,长期维护稳定性与功能迭代速度存在不确定性;再者,当前仅支持 Craft.do 生态,无法迁移至其他文档平台;最后,虽然二进制文件版本锁定,但需通过 curl 从 GitHub 下载,在严格安全环境中可能受限于网络策略。

该技能特别适合以下群体:需要将 Craft.do 纳入自动化工作流的知识管理用户;构建基于文档数据的 LLM Agent 的开发者;以及习惯命令行操作、追求效率的商务人士。对于频繁需要在 Craft 文档与代码仓库、CI/CD 流程间同步内容的研发团队尤为适用。

使用风险方面,需关注 API 密钥安全:配置中的 Craft.do API 链接等同于访问令牌,应妥善保管避免泄露;网络传输风险:所有文档内容通过 HTTPS 与 Craft.do 服务器交互,虽加密传输但存在云端托管风险;参数注入:craft-helper.sh 使用 $@ 传递参数,若处理不可信输入可能导致意外行为;最后,预编译二进制文件的完整性验证需用户自行确保,建议校验发布页 SHA256 值。

安全解读

核心用法

Craft CLI Skill 是一个命令行接口工具,用于与 Craft.do 文档服务进行高效交互。主要功能包括:

文档管理craft list 列出所有文档(支持 JSON/table/markdown 三种格式),craft search 按关键词搜索,craft get 获取指定文档内容,craft create/update/delete 完成 CRUD 操作。

多空间切换:支持配置多个 Craft.do 工作空间(如 wavedepth 业务空间和个人空间),通过 craft config set-api 或 helper 脚本快速切换。

LLM 友好设计:默认输出 JSON 格式,便于管道处理和脚本集成;支持 --output 导出文件,方便与 jq 等工具链配合。

显著优点

  • 零依赖架构:无需额外运行时或第三方包,单二进制文件部署
  • 多格式输出:json(默认)、table、markdown 满足不同场景需求
  • 空间隔离:通过 API URL 配置实现工作/个人空间安全隔离
  • 完整 CRUD:覆盖文档生命周期的全部操作
  • 错误码规范:0-3 分级退出码,便于自动化脚本错误处理

潜在缺点与局限性

  • 前置依赖:需预先安装 craft CLI 二进制文件到 /usr/local/bin/craft
  • API 令牌依赖:依赖 Craft.do Connect API 链接,需手动从 Craft.do 获取
  • 无离线功能:纯在线工具,断网状态下无法使用
  • 功能边界:仅为 CLI 使用说明 Skill,不包含实际可执行的二进制文件

适合人群

  • 习惯命令行工作流的 Craft.do 重度用户
  • 需要将文档数据导入自动化工作流的开发者
  • 使用 LLM 处理文档内容的 AI 辅助写作用户
  • 需要在多个 Craft 空间间频繁切换的跨团队协作者

常规风险

  • 配置泄露风险:API URL 包含访问令牌,需妥善保管配置文件
  • 误操作风险delete 操作不可逆,建议配合 --format table 确认后再执行
  • 速率限制:频繁调用可能触发 Craft.do API 限流(错误码 2)
  • 版本兼容性:Craft.do API 升级可能导致 CLI 行为变化

craft-cli 内容

手动下载zip · 3.1 kB
craft-helper.shtext/x-shellscript
请选择文件