技能介绍

要解决什么问题

大模型经常把网页、报告或 Markdown 写成代码块，用户还得自己找托管、改路径、拼链接。PagePilot 这条技能把「生成内容」和「可访问的公网地址」绑在一起：只要用户要页面、文档、仪表板，或明确说「发布到 PagePilot」「给我访问链接」，Agent 就必须走发布流程，并把服务端返回的 url、detailUrl 或 versionUrl 交给用户，而不是让用户复制 HTML 或自行拼接域名。

技能如何工作

入口优先级：能跑本地命令时优先用 pagep 或 Skill 目录内的 python scripts/pagep.py；目录、ZIP、图片等大资源用 multipart 上传，避免把 base64 塞进上下文；只有无法执行 CLI 时才退到 MCP（如 deploy_site）。Skill、CLI、MCP 共用同一 PagePilot 服务器和用户 Token。

发布形态：单页报告、简历、简单可视化默认生成自包含单 HTML（CSS/JS 内联，中文用系统字体栈）；多页站点、资源较多或用户已有项目目录时，用干净相对路径的目录或 ZIP，由服务端识别 single_html、markdown、zip_site、static_site 等 Bundle 类型。Markdown 可直接作为入口，平台侧支持 GFM、代码高亮、KaTeX、Mermaid 与主题参数。

发布前约束：先区分新建还是更新已有站点；更新时若不知 code，先列出当前身份下的站点。新建需有意义的 --title 与 240 字内 --description；匿名默认 unlisted，公开进创作市场需确认分类（用 market categories 的 slug，不要臆造）。版本默认追加，覆盖未锁定版本仅在用户明确要求时使用。

边界与注意

不要上传 .env、密钥、.git、node_modules 等敏感或巨型目录。加密作品的访问密码不等于源码下载权限；复用市场作品前必须看详情里的 allowDownload、allowReuse 和 policyNote。投屏、屏幕绑定等能力需要注册用户 Token。ZIP 失败时读接口的 stage、errorCode 和 hint，按 ZIP_UNSAFE_PATH、ZIP_AMBIGUOUS_ENTRY 等提示改包，不要盲目重试同一包。