用途:当智能体写出必须让人看到的 HTML 文件(如可视化协调画布、视觉评审回顾、计划看板等草稿页)时,若宿主没有 Claude Artifact 面板,可用 PostPlan 发布为可访问的页面,或改为在本地打开。它不适合作为通用文件托管,也不应上传密钥、.env 值或私有仓库回顾,除非用户明确要求公开草稿。
交付顺序:Claude Code 且有 Artifact 工具时,直接发布为 Artifact 即可;否则在 postplan whoami 成功时使用 PostPlan;再否则在 macOS 上用 open <绝对路径> 打开,若不够则在该目录用 python3 -m http.server 提供目录服务。需告知用户 URL 或路径,不要声称他们能在 TUI 内看到仓库相对路径。
认证:凭据存放在本机,绝不放入仓库。检查命令为 bunx --bun postplan whoami。若失败,请用户打开 https://postplan.dev/cli/auth 登录,并运行 bunx --bun postplan auth set <api-key> 或 bunx --bun postplan auth login,然后再次运行 whoami。不要自行编造密钥,也不要将密钥写入任何项目文件。匿名上传无法携带内联 JavaScript,而协调画布和多数回顾包含脚本,因此需要已登录的 CLI。
上传:bunx --bun postplan upload ./path/to/draft.html --description "short label",并打印 PostPlan 返回的 URL 交给用户。可用参数:--new 始终新建草稿;--draft <id> 替换已知草稿;--description <text> 设置仪表盘上显示的标签。用 bunx --bun postplan list 列出草稿。
规则:每次上传一个 HTML 文件,页面必须自包含;上传前脱敏密钥,草稿的敏感度等同于其来源;切勿提交 PostPlan 密钥、包含 token 的 whoami 输出或 .postplan 凭据文件。