Postplan HTML 发布

适用范围

处理单个 HTML 文件，或根目录包含 index.html 的静态页面。目标平台固定为 https://postplan.dev，使用官方 postplan CLI 发布。Postplan 返回公开 draft URL 和 Raw HTML URL；同一个本地文件再次上传时默认更新对应 draft。

凭据与安全

• CLI 凭据由 npx postplan auth set <api-key> 保存到用户目录的 .postplan/credentials.json，权限应保持为仅用户可读写。
• 也可临时使用环境变量 POSTPLAN_API_KEY；API 地址可用 POSTPLAN_API_URL 覆盖，默认是 https://postplan.dev。
• 绝不把 API key 写入 HTML、项目文件、日志、对话回复或版本库；不要上传 .env、密码、真实用户数据、内网 URL 或私密资源。
• 实际上传属于外部发布。执行 npx postplan upload 前，必须向用户确认将公开发布；仅做本地检查或 dry-run 不需要确认。

发布流程

1. 确认产物是单个 HTML，或目录中存在 index.html。对目录发布时先准备一个构建输出目录，不上传源码项目、依赖目录或敏感文件。
2. 运行 scripts/preflight_static_site.py <文件或目录>，修复入口、绝对本地路径和敏感文件问题。该检查是发布前辅助检查，最终 HTML 规则仍以 Postplan CLI 返回的验证结果为准。
3. 在得到用户明确确认后执行：