（4236期）Craft CLI – Craft 文档的极速命令行管家

Craft 文档的极速命令行管家 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 处理，便于自动化工作流构建 显著优点 Token 效率优化：JSON 原生输出避免 HTML 解析噪声，显著降低 LLM 上下文消耗 多空间隔离：单 CLI 实例管理多个 Craft 工作区，通过 API URL 切换实现数据隔离 错误码体系化：0-3 分级退出码（成功/用户错误/API 错误/配置错误），便于脚本异常捕获 格式灵活：同一命令输出可在机器可读与人工可读间无缝切换 潜在局限 依赖 Craft.do 生态：非通用 Markdown 工具，绑定特定云服务 API 稳定性风险：基于未公开的 /api/v1 端点，未来可能随官方调整而失效 无离线能力：纯在线工具，网络中断即不可用 权限粒度粗：空间级 API Token，无法细化到文档级权限 适合人群 需要将 Craft 文档纳入自动化工作流的知识工作者 频繁在多个 Craft 空间切换的跨团队协作者 构建 RAG 或文档代理系统的开发者 常规风险 Token 泄露：API URL 包含完整访问凭证，误提交至版本控制将导致数据泄露 误操作覆盖：update 命令无版本回滚机制，错误 --file 参数可能永久丢失内容 Rate Limit 中断：高频批量操作可能触发限流，需实现指数退避重试 原始说明 Manage Craft documents via the craft CLI tool, supporting listing, searching, creating, updating, deleting, and exporting in JSON, table, or markdown formats.