用途:通过 @innosage/draft-cli 管理 InnoSage Draft 的 JSON Workspace 页面域操作,以及托管的 Secret Share 辅助功能。
主要能力:页面命令包括 draft page ls、search、cat、create、append、replace、patch、annotate、comments、comment、insert-image、update-image、delete-image、publish;工作区元数据命令包括 draft workspace status、path、set-path;Secret Share 命令包括 draft auth set-key、auth status、secret create、secret open。
使用方式:页面命令优先以保存的 JSON Workspace 为默认目标,先运行 draft workspace status --json 与 draft workspace path --json,再用返回的 active_workspace_path 锚定命令,例如 draft --workspace-json <active_workspace_path> page ls --json。过渡期需显式传入 --workspace-json <folder>。若 CLI 较旧、无 workspace 命令,则要求显式文件夹并回退到 draft --workspace-json <folder> ...。读取渲染内容优先用 page cat,需要结构化块数据时加 --json。patch 仅对页面正文 markdown 应用 unified diff,不要基于带 Title、ID 或分隔线的输出生成补丁;出现 PATCH_MISMATCH 需重读正文并重新生成 diff。图片插入返回 local_id,后续更新与删除使用该 ID。公开预览或已发布 URL 的反馈应直接抓取该 URL,解析元数据后依次读取 comments_api_url、task_toggles_api_url,可选 source_snapshot_url,不依赖工作区命令。Secret Share 无需工作区检查,配置密钥用 draft auth set-key,创建用 draft secret create --file ... --expires ... --json,读取用 draft secret open。
适用场景:在 JSON Workspace 中管理 Draft 页面、批注与评论、图片、发布,以及创建和读取受密码保护的 Secret Share。
限制:写操作与分享操作默认不执行,除非用户明确要求具体动作与目标;返回公开链接前需核对输出。公开反馈读取路径不依赖 draft 命令。错误处理包括 PAGE_NOT_FOUND 时先 page ls 再重试,ANCHOR_NOT_FOUND 时先重读页面。缺失事实:具体收费、价格、平台支持范围与效果暂未提供。