Craft 文档管理命令行工具，支持列表、搜索、创建、更新、删除文档，原生 JSON 输出适配 LLM 工作流，双空间快捷切换。
说明：
## 核心用法
`craft` CLI 是一款专为 Craft.do 文档生态打造的命令行管理工具，旨在解决 LLM 与结构化文档交互的痛点。其核心设计围绕「机器优先、人类友好」的双模输出：默认 JSON 格式供脚本和 LLM 消费，同时提供 `–format table/markdown` 满足人工阅读需求。
### 主要功能模块
– **空间管理**：通过 `config set-api` 绑定不同 Craft 空间（如 wavedepth 商务空间与个人空间），配合 `craft-helper.sh` 实现秒级切换
– **文档 CRUD**：完整的增删改查能力，`create` 支持从文件、内联 Markdown、父文档嵌套三种方式创建
– **搜索与导出**：全文搜索匹配，支持一键导出为本地 Markdown 文件
– **LLM 集成**：JSON 管道输出天然适配 `jq` 处理，便于自动化工作流构建
### 显著优点
1. **Token 效率优化**：JSON 原生输出避免 HTML 解析噪声，显著降低 LLM 上下文消耗
2. **多空间隔离**：单 CLI 实例管理多个 Craft 工作区，通过 API URL 切换实现数据隔离
3. **错误码体系化**：0-3 分级退出码（成功/用户错误/API 错误/配置错误），便于脚本异常捕获
4. **格式灵活**：同一命令输出可在机器可读与人工可读间无缝切换
### 潜在局限
– **依赖 Craft.do 生态**：非通用 Markdown 工具，绑定特定云服务
– **API 稳定性风险**：基于未公开的 `/api/v1` 端点，未来可能随官方调整而失效
– **无离线能力**：纯在线工具，网络中断即不可用
– **权限粒度粗**：空间级 API Token，无法细化到文档级权限
### 适合人群
– 需要将 Craft 文档纳入自动化工作流的知识工作者
– 频繁在多个 Craft 空间切换的跨团队协作者
– 构建 RAG 或文档代理系统的开发者
### 常规风险
– **Token 泄露**：API URL 包含完整访问凭证，误提交至版本控制将导致数据泄露
– **误操作覆盖**：`update` 命令无版本回滚机制，错误 `–file` 参数可能永久丢失内容
– **Rate Limit 中断**：高频批量操作可能触发限流，需实现指数退避重试
会员专属
