SuperAPI AI 工具集

draft-headless-pages

办公与效率

查看项目

更新于 10-15 22:38

技能介绍

用途:在 CLI v2 运行时中以无头方式创建、修改和发布 Draft 页面域内容,适用于 Linux、Docker、CI 或远程代理等无人值守场景,不依赖已配对的浏览器标签页。

主要能力:启动无头运行时并检查状态;创建、读取、追加、替换、修补页面;为页面添加批注、读取评论;发布页面供人工审阅;通过公开评论接口获取审阅反馈。

必要用法:先显式指定运行时并验证健康状态,再执行页面命令。

draft start-server --runtime v2 draft status --json

仅在 draft status --json 显示 v2 无头会话健康时继续。常用命令包括:

draft page create "Title" --json draft page cat <page_id> draft page append <page_id> "content" --json draft page replace <page_id> --heading "Section" --content "replacement" --json draft page patch <page_id> --json draft page annotate <page_id> --anchor "text" --note "feedback" --json draft page comments <page_id> --json draft page publish <page_id> --json

默认流程:启动运行时、验证状态、创建或定位页面、用 append/replace/patch 修改、按需读回、需要反馈时发布。发布后可用公开评论接口获取审阅意见:

draft public-comments list --url '<published_or_preview_url>' --json draft public-comments list --page-id <page_id> --json draft public-comments get <comment_id> --json

限制:仅限 CLI v2 运行时与页面域内容,不涉及工作区模式或本地文件绑定;不假设有桌面浏览器。若需仓库支持的 Markdown 审阅或持久评论,应改用 draft-review-loop 与工作区命令。守护进程离线时重新启动并检查状态;状态未报告 v2 时停止写入;页面 ID 缺失或查找失败时先重新定位页面;公开评论获取失败时确认使用发布或预览 URL,或改用 --page-id。