edgepress 2026.10.1 → 2026.10.13

package/content/assets/edgepress/icons/rocket.svg

@@ -0,0 +1,18 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-rocket"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M12 15v5s3.03-.55 4-2c1.08-1.62 0-5 0-5" />
+  <path d="M4.5 16.5c-1.5 1.26-2 5-2 5s3.74-.5 5-2c.71-.84.7-2.13-.09-2.91a2.18 2.18 0 0 0-2.91-.09" />
+  <path d="M9 12a22 22 0 0 1 2-3.95A12.88 12.88 0 0 1 22 2c0 2.72-.78 7.5-6 11a22.4 22.4 0 0 1-4 2z" />
+  <path d="M9 12H4s.55-3.03 2-4c1.62-1.08 5 .05 5 .05" />
+</svg>

package/content/assets/edgepress/icons/rss.svg

@@ -0,0 +1,17 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-rss"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M4 11a9 9 0 0 1 9 9" />
+  <path d="M4 4a16 16 0 0 1 16 16" />
+  <circle cx="5" cy="19" r="1" />
+</svg>

package/content/assets/edgepress/icons/search.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-search"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="m21 21-4.34-4.34" />
+  <circle cx="11" cy="11" r="8" />
+</svg>

package/content/assets/edgepress/icons/settings.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-settings"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915" />
+  <circle cx="12" cy="12" r="3" />
+</svg>

package/content/assets/edgepress/icons/shield-check.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-shield-check"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z" />
+  <path d="m9 12 2 2 4-4" />
+</svg>

package/content/assets/edgepress/icons/sparkles.svg

@@ -0,0 +1,18 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-sparkles"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z" />
+  <path d="M20 2v4" />
+  <path d="M22 4h-4" />
+  <circle cx="4" cy="20" r="2" />
+</svg>

package/content/assets/edgepress/icons/terminal.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-terminal"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M12 19h8" />
+  <path d="m4 17 6-6-6-6" />
+</svg>

package/content/assets/edgepress/icons/x.svg

@@ -0,0 +1,16 @@
+<!-- @license lucide-static v1.52.0 - ISC -->
+<svg
+  class="lucide lucide-x"
+  xmlns="http://www.w3.org/2000/svg"
+  width="24"
+  height="24"
+  viewBox="0 0 24 24"
+  fill="none"
+  stroke="currentColor"
+  stroke-width="2"
+  stroke-linecap="round"
+  stroke-linejoin="round"
+>
+  <path d="M18 6 6 18" />
+  <path d="m6 6 12 12" />
+</svg>

package/{static → content/assets}/edgepress-markdown-guide.svg

@@ -5,7 +5,7 @@
   <g font-family="system-ui, sans-serif" text-anchor="middle" fill="#24352d">
     <rect x="44" y="86" width="230" height="148" rx="18" fill="#fff" stroke="#b8c6bc" stroke-width="3"/>
     <text x="159" y="139" font-size="23" font-weight="700">Markdown source</text>
-    <text x="159" y="181" font-size="17">content/posts/en.md</text>
+    <text x="159" y="181" font-size="12">content/posts/&lt;post-id&gt;/en.md</text>
     <text x="159" y="209" font-size="17">headings · lists · links</text>
     <path d="M292 160h78m-16-16 16 16-16 16" fill="none" stroke="#426b57" stroke-width="5" stroke-linecap="round" stroke-linejoin="round"/>
     <rect x="382" y="86" width="230" height="148" rx="18" fill="#e3ece5" stroke="#9db4a4" stroke-width="3"/>

package/content/assets/images/previews/provenance.json

@@ -0,0 +1,49 @@
+[
+  {
+    "file": "edgepress-en.webp",
+    "kind": "actual local built website screenshot",
+    "source": "edgepress/dist/",
+    "viewport": {
+      "width": 1200,
+      "height": 820
+    },
+    "date": "2026-10-04"
+  },
+  {
+    "file": "edgepress-zh.webp",
+    "kind": "actual local built website screenshot",
+    "source": "edgepress/dist/zh-CN/",
+    "viewport": {
+      "width": 1200,
+      "height": 820
+    },
+    "date": "2026-10-04"
+  },
+  {
+    "file": "edgepress-revisions-en.png",
+    "kind": "actual before-and-after image comparison from a locally built article",
+    "source": "web/signal.js.gripe/dist/2026/10/signal-vol-1/; current cover supplied by the operator",
+    "viewport": {
+      "width": 1200,
+      "height": 1000
+    },
+    "date": "2026-10-06",
+    "consent": "All optional services rejected before capture"
+  },
+  {
+    "file": "edgepress-workflow-en.90f4650b21013786.gif",
+    "kind": "FFmpeg recording of an isolated WSL2 desktop; real terminal, editor and Chromium; preview startup wait shortened; isolated service fixtures",
+    "source": "web/js.gripe/tools/recordings/capture-project-demos.mjs",
+    "date": "2026-10-07",
+    "duration": 25240,
+    "bytes": 723577
+  },
+  {
+    "file": "edgepress-workflow-zh.41f1e0a685f47267.gif",
+    "kind": "FFmpeg recording of an isolated WSL2 desktop; real terminal, editor and Chromium; preview startup wait shortened; isolated service fixtures",
+    "source": "web/js.gripe/tools/recordings/capture-project-demos.mjs",
+    "date": "2026-10-07",
+    "duration": 23960,
+    "bytes": 717704
+  }
+]

package/content/guides/markdown-media.md

@@ -0,0 +1,38 @@
+---
+title: "Local video and CJK emphasis in Markdown"
+lang: en
+---
+
+Insert a local video with the ordinary image-shaped Markdown syntax:
+
+```md
+![A character walks around the barrier](/media/bypass.mp4 "Motion test")
+```
+
+EdgePress enhances same-origin MP4, WebM, OGV and OGG files with the shared Multimedia viewer player. It provides themed controls, time, seeking, speed, volume and fullscreen. The file starts loading when the visitor presses Play. Scrolling the player out of view pauses playback and retains its position. Returning does not automatically resume it.
+
+The native video element remains the fallback if the enhancement is unavailable. The player engine and styles are bundled locally and fingerprinted with the other site assets. A site with Markdown videos receives these assets even when it has no Pages galleries. In text view, the video and its engine activate only when the visitor requests that media. External embeds retain their own service-consent rules.
+
+Use meaningful alternative text and an optional title for the visible caption. Reference-style links are supported too:
+
+To show a poster and total duration before Play, generate a local preview once (FFmpeg and FFprobe must be on PATH):
+
+```sh
+node node_modules/edgepress/tools/assets/video-preview.mjs content/assets/media/bypass.mp4
+```
+
+An optional second argument selects the frame time in seconds. Commit the generated `bypass.mp4.poster.jpg` and `bypass.mp4.json` beside the video. The sidecar contains measured `duration`, `width`, `height` and the relative `poster` filename. EdgePress reads these local files during every build and adds the preview attributes to matching video elements, including Markdown videos. Cloud builds need no FFmpeg; visitors load the poster, while the video still waits for Play. After playback begins, the player's actual media duration replaces the supplied value. Regenerate the preview when replacing the video.
+
+```md
+![An action comparison][comparison]
+
+[comparison]: /media/comparison.mp4
+```
+
+CJK prose can place bold text ending in brackets or punctuation directly beside the next word:
+
+```md
+本次采用**有限动画（背景复用）**制作短片。
+```
+
+The bracketed phrase renders as bold without adding spaces. Code spans, fenced code, escaped delimiters and link destinations retain their normal Markdown behavior.

package/content/guides/platforms.md

@@ -0,0 +1,15 @@
+# Free hosting comparison
+
+Checked against official documentation on 2026-10-04. This ranking is for static EdgePress output. Function, database and CDN allowances are different meters; they cannot be added together.
+
+| Priority | Platform | Free allowance relevant to this site | Conditions |
+| --- | --- | --- | --- |
+| 1 | Cloudflare Static Assets | Unlimited free static requests; Workers Builds includes 3,000 build minutes/month | A static-only deployment does not consume Worker function calls. See [asset pricing](https://developers.cloudflare.com/workers/platform/pricing/) and [build limits](https://developers.cloudflare.com/workers/ci-cd/builds/limits-and-pricing/). |
+| 2 | Tencent EdgeOne Pages | Currently unlimited website traffic and requests; 500 builds/month, 40 projects, 5 GB project storage | Current generous free-phase limits may change when commercialization starts. See [FAQ](https://pages.edgeone.ai/document/faqs) and [quotas](https://pages.edgeone.ai/document/limits-and-quotas). |
+| 3 | Vercel Hobby | 100 GB Fast Data Transfer, 1 million CDN requests/month | Personal, non-commercial use; quotas reset monthly. See [Hobby](https://vercel.com/docs/plans/hobby). |
+| 4 | Netlify Free, current credit plans | 300 shared credits/month; production deploy costs 15, bandwidth costs 20/GB, requests cost 2/10,000 | 15 GB is a theoretical bandwidth-only upper bound before deploys and requests. Exhaustion pauses the site until reset. Older accounts can have different legacy plans. See [credit plans](https://docs.netlify.com/manage/accounts-and-billing/billing/billing-for-credit-based-plans/credit-based-pricing-plans/). |
+| Verify separately | Alibaba Cloud ESA Pages | Pages traffic uses the selected site's package allowance | The 100,000/day free function allowance is not a static traffic allowance. No universal free Pages bandwidth limit was verified, so ESA is not ranked above documented free plans. See [official billing](https://help.aliyun.com/zh/edge-security-acceleration/esa/user-guide/functions-and-pages-billing). |
+
+Cloudflare and EdgeOne both offer the largest published static allowance. Cloudflare comes first for this project because its static deployment and build-minute allowance are established; EdgeOne can be preferable for the audience's measured network performance. This is a practical recommendation, not a numerical comparison between build minutes and build counts.
+
+All platforms receive the same `dist/`. CSS, JavaScript and their local dependencies have content hashes and one-year immutable caching. HTML and unversioned metadata remain refreshable. ESA requires equivalent cache rules in its console. External services have separate quotas and are called only with current consent and a matching page or visitor action. Homepages have no discussion slot.

package/content/guides/product-demos.md

@@ -0,0 +1,37 @@
+# Product demonstrations
+
+Use a static poster and a local MP4 or WebM for website playback. Visitors start playback manually and can drag the progress bar or use its arrow keys. Touch seeking needs an intentional horizontal drag; scrolling vertically and tapping control spacing keep the playhead. Leaving the viewport pauses playback and returning keeps the same position until Continue is clicked. The final frame remains visible until Replay is chosen.
+
+```yaml
+- type: media-text
+  mediaType: image
+  src: /images/publishing.webp
+  animationSrc: /images/publishing.mp4
+  alt: Publishing a photo and video post
+  title: Publish a story
+  text: Write a caption, attach media and share the result.
+```
+
+Put the MP4 metadata at the start of the file (FFmpeg `-movflags +faststart`) and use a hashed filename for immutable caching. The runtime prepares nearby media, streams the native file and preserves its playhead without Blob URLs. Posters reserve the layout. GIF exports remain useful in GitHub documentation.
+
+Record a real project and hold its visible results. For EdgePress, show `edgepress new post 'An afternoon by the water'`, editing the generated Markdown in a code editor, running `edgepress server`, opening the homepage, and clicking the article to read it. The preview uses the actual local server. Do not overlay unrelated slogans or publish test posts to production.
+
+中文：网站使用静态封面与本地 MP4/WebM；手动播放，可拖动进度条或用方向键定位；离开视野时暂停，再回来保留原位置，点击继续才播放，结束后停留最后一帧。视频采用 faststart 与内容哈希，接近视野时预载，保留 GIF 给 GitHub 文档。示例必须来自独立写文建站项目：创建文章、代码编辑器修改、运行 `edgepress server`，再从网站首页点击进入文章。录制不需要固定字幕条。
+
+## Isolated desktop recordings
+
+Use a disposable VM and its own display. The current Windows workflow imports a dedicated WSL2 Debian VM and starts Xvfb display :99 with Openbox, xterm, Geany and Chromium. FFmpeg x11grab records that entire guest desktop at 25 fps. Playwright controls only the guest browser through its loopback CDP endpoint; xdotool controls only DISPLAY :99. Host mouse, keyboard, clipboard and browser sessions remain separate.
+
+Create `/opt/recording/workspace` inside the guest as a link to the mounted canonical workspace. Pack the local EdgePress release with `npm pack` and install the resulting archive under `/opt/recording`, together with its locked Linux dependencies and Wrangler; verify `/opt/recording/node_modules/.bin/edgepress` before capture. Rebuild esbuild in the guest if lifecycle scripts were disabled. When GitHub downloads are unavailable in the guest, transfer the same pinned media-viewer archive from the host and point only the temporary package’s dependency at that archive. Do not fall back to a Windows global CLI.
+
+The reusable helpers live in tools/recordings/. provision-vm.sh installs open-source desktop tools inside the guest; start-vm-desktop.sh starts its private display. demo-workbench.mjs prepares a real standalone writing site, executes edgepress in the guest terminal, saves the actual Markdown through Geany and opens the actual local preview in Chromium. desktop-recording.mjs invokes FFmpeg capture, trim, concat, H.264 faststart and GIF palette filters. It contains no screenshot capture loop or renderer.
+
+Run start-vm-desktop.sh with `--keep-alive` during a capture session so the desktop stays available between commands. Browser startup waits for the guest CDP endpoint and disables unsolicited translation prompts. Use the physical browser window for page layout and the guest's actual X11 pointer for visible actions. Retain the application's navigation, quota cards and original styles; scroll controls into view before using them. Select both attachments through the native file chooser and show the publication result. The local video fixture adds gentle motion to the existing repository photograph so playback, pause, seeking and speed changes can be seen.
+
+For embeddings, paste !embed[ishare](URL) into the body, save, run edgepress server, open the article from the homepage, grant consent and inspect the attachments. Only the uninformative middle of local-preview startup is omitted; retain the command and ready state. Service fixtures are isolated and never publish production test posts.
+
+Begin writing captures with the terminal already visible. Hold the saved document and server-ready state, then show the homepage link and rendered article. In an embedding capture, verify the copied share URL, play and pause the embedded video, then switch to the picture. Review the exported timeline at several points in every clip and verify MP4/GIF duration, posters and file hashes before synchronizing references.
+
+Keep raw masters, temporary sites and manifests in ignored tools/.recordings/. Publish only verified hashed posters, MP4 clips and documentation GIFs under content/assets/. Run `npm run recordings:capture` from `web/js.gripe`; optional `DEMO` and `DEMO_LOCALE` select a project and language. Inspect the exported clips before running `npm run recordings:sync`. Stop the guest desktop after capture. The operator can also use [OBS Studio display capture](https://obsproject.com/kb/display-capture-sources) inside a VM; this automated pipeline uses [FFmpeg x11grab](https://ffmpeg.org/ffmpeg-devices.html#x11grab) and [Playwright CDP](https://playwright.dev/docs/api/class-browsertype#browser-type-connect-over-cdp).
+
+The builder emits each progressive file's exact Content-Length and Accept-Ranges policy, with immutable caching for content hashes. Generated audit PDFs live only in tools/reports/page-check.pdf and come from edgepress check.

package/content/guides/zh-cn.md

@@ -0,0 +1,62 @@
+# 写文建站
+
+写文建站把 Markdown 文章和 JSON 页面布局构建为静态网站。英文界面使用官方名称 EdgePress。首页、文章、搜索、多语言切换和本地 JavaScript 交互都随静态产物发布。
+
+![网站界面实拍](../assets/images/previews/edgepress-zh.webp)
+
+构建器自动识别并展示文章最近一次内容调整，无需手写修正说明。界面按“修改前／修改后”“新增／移除”展示具体文字及实际图片，支持 Markdown 排版，窄屏自动纵向排列，颜色跟随主题。封面替换、正文换图及同一路径图片内容被更新均计入变动；改动涉及的本地图片从 Git 恢复成哈希快照，旧文件移除后仍可比较。仅生成最近一次变动需要的图片，按内容去重，缓存一年。设置 `showChanges: false` 可关闭单篇文章的面板。
+
+![文章变动卡片的真实组件预览](../assets/images/previews/edgepress-revisions-en.png)
+
+文章正文使用独立一行的 `!embed[ishare](https://ishare.js.gripe/s/0123456789abcdef0123456789abcdef)`；YouTube 示例为 `!embed[youtube](https://www.youtube.com/watch?v=jNQXAC9IVRw)`。Pages 的 text 区块也使用相同语法，普通文字继续转义，不需要在文章属性添加 embeds。服务在 config.yml 注册并逐项披露；构建器保留主题占位区，访客同意后才按可见区域加载。
+
+历史对比需要完整 Git 历史，GitHub Actions 使用 `fetch-depth: 0`。缺少历史时不编造变动；缺少图片历史文件时保留说明，不请求失效地址。不会为重建历史主动访问外部图片地址，也不会发布草稿的图片快照。
+
+## 本地开始
+
+需要 Node.js 22.12 或更新版本。以下命令安装已发布的 npm 版本；最新 GitHub 改动可通过 README 的仓库模板部署，或克隆本仓库后在根目录运行 `npm ci`、`npm run dev`。在新目录中安装 npm 版本：
+
+```sh
+npm install edgepress
+npx edgepress init
+npm install
+npm run dev
+```
+
+运行 `npm run new -- post "我的第一篇文章"`，打开命令输出的文件，在第二个 `---` 后撰写 Markdown。文章放在 `content/posts/<文章目录>/`；页面放在 `content/pages/<页面目录>/`，内容全部写入前置数据的 `blocks`，正文留空。页面先声明栏数，再定义各栏元素。图片放在 `content/assets/`，例如 `content/assets/images/photo.webp` 对应公开地址 `/images/photo.webp`。
+
+发布前在 `config.yml` 填写真实站点 URL、名称、隐私责任人和联系方式；在 `edgepress.config.mjs` 选择主题、路由及语言包。不要编辑生成的 `dist/`。
+
+## 免费额度优先的部署选择
+
+完整数值与官方来源见 [平台比较](platforms.md)，核对日期为 2026-10-04。静态站优先选择 Cloudflare，其次腾讯 EdgeOne Pages；个人非商业网站可选 Vercel，之后是共享积分较少的 Netlify。阿里云 ESA Pages 的静态流量使用站点套餐额度，需先在控制台确认，不能用函数免费请求数代替流量额度。
+
+README 提供五个平台的部署按钮。Cloudflare、Vercel、Netlify 和 EdgeOne 打开仓库模板部署；ESA 按钮打开官方导入页，需要授权 GitHub 并选择仓库。按钮创建新项目，更新已有网站应使用其已连接的仓库。
+
+| 平台 | 仓库内配置 | 部署命令 |
+| --- | --- | --- |
+| Cloudflare | `wrangler.jsonc` | `npm run deploy:cloudflare` |
+| 腾讯 EdgeOne Pages | `edgeone.json` | `npm run deploy:edgeone -- -n my-site` |
+| Vercel | `vercel.json` | `npm run deploy:vercel` |
+| Netlify | `netlify.toml` | `npm run deploy:netlify` |
+| 阿里云 ESA Pages | `esa.jsonc` | `npm run deploy:esa -- --name my-site` |
+
+构建命令统一为 `npm run build`，输出目录统一为 `dist`。平台账号与域名授权仍需由运营者完成。GitHub 手动部署工作流也可选择平台；Netlify 使用仓库 Secret `NETLIFY_AUTH_TOKEN` 和 `NETLIFY_SITE_ID`。
+
+## 可选服务、隐私与缓存
+
+在 `config.yml` 的 `plugins.consent.services` 逐项注册服务，填写服务名、真实 HTTPS 地址、用途、数据类别、接收者、保留期限与隐私链接，覆盖全部启用语言。授权列表直接显示服务名，不使用预设分类或分类标签。访客同意后，服务仍按页面需要或访客操作调用；更换服务地址会使旧授权失效。
+
+评论使用独立的 [我提问](https://github.com/jsw-teams/iask/blob/main/docs/zh-CN.md)，网站只提供通用服务插槽。首页不放评论插槽；需要讨论的页面可增加 `type: service` 和 `integration: github-comments`。文章由构建器生成讨论上下文。服务端密钥只存放在独立服务平台。
+
+接口使用固定 URL 和 HTTP 请求头传递操作与上下文。CSS、JavaScript 及依赖使用内容哈希名称，缓存一年；HTML 和未版本化元数据保持可更新。ESA 需在控制台配置对应缓存规则。布局支持响应式、键盘操作、可见焦点、语义结构和多语言，新增内容仍需填写有意义的图片替代文本。
+
+## 看看生成的网站
+
+![创建海边的下午、编辑正文、运行 edgepress server，从首页点击进入文章](../assets/images/previews/edgepress-workflow-zh.41f1e0a685f47267.gif)
+
+示例展示由写文建站生成的实际页面。网站使用静态封面搭配按需加载 MP4，提供观看、暂停、定位和重播；GIF 用于项目文档，见[演示配置](product-demos.md)。
+
+## 项目演示与图标
+
+演示通过 `edgepress new post '海边的下午'` 新建文章，在代码编辑器修改后运行 `edgepress server`，从首页点击进入文章。录制工作台位于 `tools/recordings/demo-workbench.mjs`，临时录制内容放在忽略的 `tools/.recordings/`。网站演示由访客手动播放，支持拖动进度和键盘操作，保留暂停位置。导航与页面图标使用本地打包的 Lucide 1.52，并保留许可证。

package/content/pages/deployment/en.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "Static deployment and optional services",
+  "lang": "en",
+  "slug": "deployment",
+  "description": "Deploy static output on Cloudflare, Vercel, EdgeOne Pages or ESA Pages and register optional external services through consent.",
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "Deployment",
+            "title": "Publish the same static site on five platforms.",
+            "text": "Build with npm run build. Every platform serves dist/. Page rendering, search and local JavaScript work without a website backend."
+          },
+          {
+            "type": "text",
+            "heading": "Platform configuration",
+            "paragraphs": [
+              "Cloudflare reads wrangler.jsonc and serves static assets without a Worker script. Vercel reads vercel.json. Tencent EdgeOne Pages reads edgeone.json. Alibaba Cloud ESA Pages reads esa.jsonc.",
+              "Vercel and EdgeOne support repository deployment buttons. ESA uses repository import or the native deployment CLI. Authenticate in your chosen platform and run one deployment command locally. GitHub Actions runs dependency security audits only."
+            ]
+          },
+          {
+            "type": "code",
+            "title": "Choose a deployment platform",
+            "language": "sh",
+            "code": "npm run deploy:cloudflare\nnpm run deploy:vercel\nnpm run deploy:netlify\nnpm run deploy:edgeone -- -n my-site\nnpm run deploy:esa -- --name my-site\n"
+          },
+          {
+            "type": "text",
+            "heading": "Optional APIs and widgets",
+            "paragraphs": [
+              "Register external services in config.yml under plugins.consent.services. Use external-api with backendUrl for visitor-triggered API calls, or external-widget with backendUrl and a same-service moduleUrl exporting mount for an isolated interface.",
+              "Each service needs a unique ID, name, purpose, dataCategories, recipient, retention and HTTPS privacyUrl. Localized disclosure maps must cover every enabled site language. Do not put operator secrets in browser configuration.",
+              "Enable the group only after setting real service URLs and the privacy controller. The browser imports no service module and makes no API call before explicit per-service consent. Endpoint changes invalidate previous consent."
+            ]
+          },
+          {
+            "type": "code",
+            "title": "Call a registered API from a theme asset",
+            "language": "js",
+            "code": "import {callService} from '/edgepress/services.js';\n// Run this in response to the visitor's action after consent.\nconst response = await callService('lookup', 'query', {headers: {'X-Service-Context': 'example'}});\n"
+          },
+          {
+            "type": "text",
+            "heading": "Comment service ownership",
+            "text": "iask owns its entire interface, translations, styles, authentication, uploads, storage and API. The website supplies only a generic service slot and published content context. Its deployment and credentials are managed separately."
+          },
+          {
+            "type": "link-list",
+            "title": "iask integration",
+            "items": [
+              {
+                "label": "Independent service setup",
+                "url": "https://github.com/jsw-teams/iask/blob/main/docs/edgepress.md"
+              }
+            ]
+          },
+          {
+            "type": "text",
+            "heading": "Cache policy",
+            "paragraphs": [
+              "CSS and JavaScript names include a content hash, including local module dependencies. Cloudflare, Vercel and EdgeOne cache these immutable URLs for one year. HTML and unversioned metadata revalidate so a rebuild can publish new references immediately.",
+              "ESA serves the same hashed assets. Configure its browser and edge cache rules for CSS and JS to one year, while leaving HTML and unversioned JSON short-lived. esa.jsonc configures the build and asset directory; it has no documented equivalent of Vercel custom headers."
+            ]
+          }
+        ]
+      ]
+    }
+  ]
+}

package/content/pages/deployment/zh-cn.json

@@ -0,0 +1,74 @@
+{
+  "$schema": "../../../schemas/pages.schema.json",
+  "title": "静态部署与可选服务",
+  "lang": "zh-CN",
+  "slug": "deployment",
+  "description": "将同一份静态产物部署到 Cloudflare、Vercel、Netlify、腾讯 EdgeOne Pages 或阿里云 ESA Pages，外部服务由 consent 注册并按需调用。",
+  "blocks": [
+    {
+      "columns": 1,
+      "cells": [
+        [
+          {
+            "type": "hero",
+            "eyebrow": "部署指南",
+            "title": "同一份静态网站，部署到五个平台。",
+            "text": "npm run build 生成 dist/。页面、搜索及本地 JavaScript 动态交互不依赖网站后端。"
+          },
+          {
+            "type": "text",
+            "heading": "平台入口",
+            "paragraphs": [
+              "Cloudflare 使用 wrangler.jsonc 的纯静态资源托管；Vercel 使用 vercel.json；腾讯 EdgeOne Pages 使用 edgeone.json；阿里云 ESA Pages 使用 esa.jsonc。构建命令均为 npm run build，输出目录均为 dist。",
+              "Vercel 和 EdgeOne 支持仓库部署按钮。ESA 使用仓库导入或官方 CLI；配置平台账号后执行一条部署命令。也可配置仓库 Secrets 后运行手动部署工作流。"
+            ]
+          },
+          {
+            "type": "code",
+            "title": "选择部署平台",
+            "language": "sh",
+            "code": "npm run deploy:cloudflare\nnpm run deploy:vercel\nnpm run deploy:netlify\nnpm run deploy:edgeone -- -n my-site\nnpm run deploy:esa -- --name my-site\n"
+          },
+          {
+            "type": "text",
+            "heading": "按访客需求调用外部服务",
+            "paragraphs": [
+              "在 config.yml 的 plugins.consent.services 注册服务。external-api 使用 backendUrl；external-widget 使用 backendUrl 和同服务来源的 moduleUrl，模块导出 mount 函数。",
+              "每项服务填写唯一 ID、名称、用途、数据类别、接收者、保留期限与 HTTPS 隐私链接。多语言说明须覆盖全部已启用语言。先填写真实地址和隐私责任人，再启用服务。",
+              "访客明确选择前不加载外部模块或调用 API。接口在访客操作时调用，单纯给予 consent 不会主动请求 API。地址变更使已保存的 consent 失效。Secret 只放在独立后端的平台设置中。"
+            ]
+          },
+          {
+            "type": "code",
+            "title": "从主题源码调用已注册 API",
+            "language": "js",
+            "code": "import {callService} from '/edgepress/services.js';\nconst response = await callService('lookup', 'query', {headers: {'X-Service-Context': 'example'}});\n"
+          },
+          {
+            "type": "text",
+            "heading": "评论由独立项目负责",
+            "text": "iask 全权负责评论前端、翻译、样式、登录、附件、存储及 API。网站只提供通用服务插槽和已发布内容上下文。"
+          },
+          {
+            "type": "link-list",
+            "title": "独立服务接入",
+            "items": [
+              {
+                "label": "iask 部署与接入",
+                "url": "https://github.com/jsw-teams/iask/blob/main/docs/edgepress.md"
+              }
+            ]
+          },
+          {
+            "type": "text",
+            "heading": "控制缓存成本",
+            "paragraphs": [
+              "CSS、JS 与本地模块依赖使用内容哈希命名，Cloudflare、Vercel、Netlify 和 EdgeOne 缓存一年。HTML 及未带哈希的元数据重新验证，构建更新会发布新的资源地址。",
+              "ESA 继续使用同一份哈希资源，并在控制台配置 CSS、JS 的浏览器及边缘缓存一年，HTML 和未版本化 JSON 短缓存。esa.jsonc 配置构建和静态目录，官方未文档化与 Vercel headers 对应的配置字段。"
+            ]
+          }
+        ]
+      ]
+    }
+  ]
+}