核心用法
Draft CLI 是 InnoSage 官方推出的命令行工具，专注于两大场景：JSON Workspace 页面管理与Secret Share 安全分享。页面管理采用"Workspace-First"模式，通过 draft workspace status 和 draft workspace path 获取当前工作区元数据，再基于 --workspace-json <path> 锚定执行 draft page 子命令（create/append/replace/patch/annotate/publish 等）。Secret Share 则提供端到端加密的内容分享能力，通过 draft secret create 生成限时访问链接，draft secret open 读取受密码保护的内容。
显著优点
1. 结构化工作流：强制 JSON Workspace 作为操作锚点，避免误操作遗留 headless 存储，确保数据一致性。
2. 版本友好：page patch 支持统一差异（unified diff）更新，配合 page cat 可实现可靠的增量编辑。
3. 安全分享：Secret Share 采用本地加密+托管解密，支持过期时间与密码保护，适合敏感文档外发。
4. 公共反馈集成：公开发布页面可通过元数据中的 comments_api_url 和 task_toggles_api_url 直接读取评审反馈，无需 CLI 介入。
潜在缺点与局限性
- CLI 版本碎片化：新旧 CLI 对
draft workspace命令支持不一致，需动态检测并回退到--workspace-json显式路径模式。 - Patch 操作脆弱性：
PATCH_MISMATCH错误要求重新读取页面体重构 diff，对自动化脚本不够友好。 - 功能迁移期：headless 存储逐步淘汰期间，部分命令需显式
--workspace-json参数，增加使用复杂度。
适合人群
- 需要版本化文档管理的研发团队（技术文档、API 文档）
- 有合规要求、需审计日志的内容协作场景
- 需要安全外发敏感材料（合同、设计稿、机密简报）的业务团队
常规风险
- 数据丢失风险：
page replace和page patch为破坏性写入，无内置版本回滚机制，建议配合 Git 管理 workspace 文件夹。 - Secret Share 泄露：分享链接一旦发出即脱离控制，依赖过期时间和密码作为唯一保护手段。
- 权限边界模糊：CLI 本身不管理页面级权限，依赖 Workspace 文件系统权限与发布时的邀请码机制。