预览本地 HTML 报告、Markdown 文档和静态迷你应用，然后从终端或您的编码代理将它们发布到可共享的 Cloudflare Pages URLs。在线应用: https://pagecasthq.pages.dev/ 关于 Pagecast 是一个本地优先的发布工具，用于代理生成的报告和小型静态 Web 项目。它为您提供了一个本地管理用户界面，用于预览文件、管理已发布版本、重命名链接、重新同步更新和撤销旧 URL。适合的用途: HTML 报告、仪表板、覆盖结果、Playwright 或 Lighthouse 报告。Markdown 计划、提案、发布说明、文档和总结。从构建文件夹（如 dist、build、out 或 public）中生成的静态迷你应用。需要在发布完成的工件前询问的编码代理工作流程。不适合: 私人草稿或草记。需要运行后端的服务器渲染应用。除非它们首先导出静态资产的 Python/Ruby/Node 服务。要求 Node.js 20 或更高版本。npx 用于单命令使用。Cloudflare 账户用于公共发布。仅在从 web/ 重新构建 Web UI 时使用 pnpm。根 CLI/server 没有运行时 npm 依赖。React 管理 UI 从 web/ 构建到 public/ 中，并已包含在包中。安装和运行 使用 Pagecast 而无需全局安装: npx pagecast 这将启动本地应用并打开管理 UI。管理 UI: http://127.0.0.1:4173 本地发布页面服务器: http://127.0.0.1:4174 本地数据/config: .pagecast/ 在您的当前工作目录中。使用 4173 上的管理 UI 进行正常工作。4174 服务器是故意分开的：它提供本地发布页面路由，例如 /p/<slug>/，以使 Pagecast 可以预览它部署到 Cloudflare Pages 的相同 URL 形状。它的根路径不是一个应用，并返回 404；仅使用 /healthz 检查它是否在运行。从克隆: git clone https://github.com/Amal-David/pagecast.git cd pagecast npm start 第一次 Cloudflare 设置 运行应用一次: npx pagecast 打开 Cloudflare Pages 面板并点击连接 Cloudflare。Pagecast 使用范围的 Wrangler OAuth ( account:read, user:read, pages:write )，检测您的账户，并在需要时创建 Pages 项目。或者，从终端执行相同的设置: npx pagecast pages setup --project pagecast 如果您更喜欢用于自动化的令牌，请创建一个具有账户 > Cloudflare Pages > 编辑权限的范围 Cloudflare API 令牌，然后运行: CLOUDFLARE_API_TOKEN=... CLOUDFLARE_ACCOUNT_ID=... npx pagecast pages status --json 如果可用多个 Cloudflare 账户，Pagecast 会在管理 UI 中提示您选择一个账户，或者您可以直接传递: npx pagecast pages setup --account 90e4c638bea527f464ec6fa7caebfd4e --project pagecast 从终端发布 发布 HTML 文件: npx pagecast publish