Run community shares on V2 Pages edge

Author: jinwandalaohu66

.github/workflows/generate-share-pages.yml

@@ -6,11 +6,6 @@ on:
     paths-ignore:
       - "s/**"
       - "og/**"
-  schedule:
-    # Dynamic edge rendering is immediate. This job only refreshes the static
-    # fallback and intentionally shares the Community recovery cadence instead
-    # of waking TableStore every five minutes.
-    - cron: "17 */6 * * *"
   workflow_dispatch:
 
 permissions:

README.md

@@ -1,6 +1,7 @@
 # PythonIDE Link Site
 
-This directory is the static GitHub Pages origin for:
+This directory is the static asset source for the `pythonide-link` Cloudflare
+Pages project:
 
 - `https://link.pythonide.xin/s/{scriptID}` community work shares
 - `https://link.pythonide.xin/community/{postID}` Community V2 post and comment shares
@@ -16,37 +17,46 @@ This directory is the static GitHub Pages origin for:
 ## Repository and deployment
 
 The canonical repository is
-[`Python-IDE/pythonide-link`](https://github.com/Python-IDE/pythonide-link). GitHub
-Pages deploys from the default branch root with the custom domain
-`link.pythonide.xin` and enforced HTTPS.
+[`Python-IDE/pythonide-link`](https://github.com/Python-IDE/pythonide-link).
+Cloudflare Pages serves the custom domain `link.pythonide.xin` with enforced
+HTTPS. The repository is the reviewed source and rollback history; publishing a
+commit alone does not deploy the direct-upload Pages project.
 
 The companion `../link-edge/` renderer server-renders per-script Open Graph
 metadata and creates a 1200×630 PNG card from the restricted public Community
-V2 work-share projection. The GitHub Actions workflow in `.github/workflows/`
-runs this renderer on every source publish and every six hours, committing
-generated `/s/*/` pages and `/og/*` cards to GitHub Pages. Dynamic edge
-rendering remains immediate; the generated files are only a fallback for
-crawlers such as WeChat that do not reliably execute page JavaScript. The six-
-hour cadence avoids waking the Community database every five minutes.
+V2 work-share projection. `_worker.js` enables Cloudflare Pages advanced mode
+and re-exports that canonical renderer from the published `edge/` directory.
+Dynamic rendering is immediate. The GitHub Actions workflow can generate
+reviewable `/s/*/` pages and `/og/*` cards on a source change or a manual run,
+but it has no recurring schedule and therefore does not wake the Community
+database while nobody is using the site.
 
-To publish changes, copy the contents of this `link-site/` directory to that
-repository root and verify the Pages deployment. The DNS record is:
+Publish and deploy in this order:
+
+```bash
+bash scripts/push_link_site.sh "Describe the link-site change"
+bash scripts/deploy_link_pages.sh
+```
+
+The first command updates the public source repository. The second tests and
+deploys that exact repository commit to the `pythonide-link` Cloudflare Pages
+project. The DNS record is:
 
 ```text
 Type: CNAME
 Host: link
-Value: Python-IDE.github.io
-TTL: 10 minutes
+Value: pythonide-link.pages.dev
 ```
 
 Do not change the root `@` or `www` records used by the main website. Do not
 recreate a repository named `pythonide-link` under the previous owner because
 that would break GitHub's repository-transfer redirects.
 
 The publish script copies `../link-edge/` into the link repository as `edge/`
-so the workflow and renderer always use the same tested implementation. Both
-the browser fallback and edge renderer use `community-api.pythonide.xin` V2;
-they must never restore a direct `fcapp.run` or `/v1/scripts` dependency.
+so Pages advanced mode and the generator always use the same tested
+implementation. Both the browser fallback and edge renderer use
+`community-api.pythonide.xin` V2; they must never restore a direct `fcapp.run`
+or `/v1/scripts` dependency.
 
 Before either deployment, run:
 

_worker.js

@@ -0,0 +1 @@
+export { default } from './edge/worker.js';

edge/README.md

@@ -1,11 +1,12 @@
 # Python IDE link edge renderer
 
 This worker adds server-rendered Open Graph metadata and dynamic PNG preview
-cards to the existing `link.pythonide.xin` GitHub Pages site. It only reads the
+cards to the `link.pythonide.xin` Cloudflare Pages site. It only reads the
 restricted Community V2 public projections and intercepts the AASA endpoint, `/s/*`,
 `/community/*`, and `/og/*`.
 
-The same module also supports Cloudflare Pages advanced mode. When the Pages
+Cloudflare Pages advanced mode is the production owner. `link-site/_worker.js`
+re-exports this module from the published `edge/` directory. When the Pages
 `ASSETS` binding is present, it reads the share template from the local Pages
 deployment and forwards all non-edge routes (including the public OAuth
 metadata and callback pages) to the static asset service. This permits the
@@ -29,5 +30,6 @@ before returning the page. That projection never contains a project package
 URL, OSS key, or complete ZIP. Social crawlers such as WeChat therefore receive
 the work title and description without executing JavaScript.
 
-Run `npm test` before deploying. Deploy with Wrangler after authenticating the
-Cloudflare account that owns `pythonide.xin`.
+Run `npm test` before deploying. Use `scripts/deploy_link_pages.sh` after
+authenticating the Cloudflare account that owns the `pythonide-link` Pages
+project. Do not deploy this module as a separate routed Worker.

edge/wrangler.jsonc

@@ -6,6 +6,12 @@ const fs = require('node:fs');
 const path = require('node:path');
 const core = require('../assets/share-page.js');
 
+test('Cloudflare Pages advanced mode reuses the canonical edge renderer', () => {
+  const siteRoot = path.resolve(__dirname, '..');
+  const workerAdapter = fs.readFileSync(path.join(siteRoot, '_worker.js'), 'utf8').trim();
+  assert.equal(workerAdapter, "export { default } from './edge/worker.js';");
+});
+
 test('restores only safe same-origin fallback paths', () => {
   assert.equal(core.safeForwardedPath('/s/scr_123?from=wechat'), '/s/scr_123?from=wechat');
   assert.equal(core.safeForwardedPath('//evil.example/s/123'), '');
@@ -281,8 +287,8 @@ test('share fallback calls only the canonical Community V2 API', () => {
     assert.match(source, /community-api\.pythonide\.xin\/v2\/community/);
   });
   assert.match(controller, /\/works\/\$\{encodeURIComponent\(route\.id\)\}\/share/);
-  assert.match(workflow, /cron:\s*"17 \*\/6 \* \* \*"/);
-  assert.doesNotMatch(workflow, /\*\/5 \* \* \* \*/);
+  assert.doesNotMatch(workflow, /\bschedule\s*:/);
+  assert.doesNotMatch(workflow, /\bcron\s*:/);
 });
 
 test('AASA hands Community V2 shares to the app without claiming reserved short links', () => {