AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
feat: add independent demo seed sync command
tianma-ifcd62151b110a
diff --git a/.github/workflows/deploy-demo-on-release.yml b/.github/workflows/deploy-demo.ymlsimilarity index 97%rename from .github/workflows/deploy-demo-on-release.ymlrename to .github/workflows/deploy-demo.ymlindex 6be1e79d..c2d24571 100644--- a/.github/workflows/deploy-demo-on-release.yml+++ b/.github/workflows/deploy-demo.yml@@ -1,4 +1,4 @@-name: Deploy Demo on Release+name: Deploy Demoon:release:@@ -39,7 +39,7 @@ jobs:EDGE_EVER_DEPLOYMENT_METHOD: "github_actions"steps:- - name: Checkout release+ - name: Checkout Demo sourceuses: actions/checkout@v5with:ref: ${{ github.event.release.tag_name || github.ref }}diff --git a/AGENTS.md b/AGENTS.mdindex e7350965..47d95fb9 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -78,6 +78,10 @@ bun run build:android:apk:local- 仅在用户明确指定远程实例并要求连接时,使用 `EDGE_EVER_INSTANCE=<实例名> bun run dev:remote`;私有配置以 `.env.local` 为准,不得硬编码实例名。- 仅在用户明确要求只启动前端时使用 `bun run dev:web`。+## Demo 示例笔记同步++修改 Demo 示例笔记后,使用 `bun run demo:sync` 将已推送的 `main` 部署到公开 Demo,并用最新种子重置示例数据。该命令独立于正式 Release 流程,不创建版本号、标签、Release 或 APK;执行前必须确保工作区干净且 `main` 与 `origin/main` 一致。命令会删除公开 Demo 中的临时内容。+## 组件复用与造轮子约束UI 功能应尽量复用 `shadcn/ui` 等现有 UI 组件。在实现其他功能时,也应优先采用成熟、稳定的开源组件或库,绝对禁止在没有充分必要性的前提下自行从零造轮子。diff --git a/package.json b/package.jsonindex 17a9a808..b28fc92b 100644--- a/package.json+++ b/package.json@@ -49,6 +49,7 @@"deploy:worker": "bun scripts/run-wrangler.mjs deploy","deploy:cloudflare-builds": "bun run deploy:ci","deploy:verify": "bun scripts/verify-deployment.mjs",+ "demo:sync": "bun scripts/sync-demo.mjs","deploy:builds:setup": "bun scripts/cloudflare-workers-builds.mjs setup","deploy:site": "bun run build:site && wrangler pages deploy apps/site/dist --project-name=edgeever-official"},diff --git a/scripts/sync-demo.mjs b/scripts/sync-demo.mjsnew file mode 100644index 00000000..f9343894--- /dev/null+++ b/scripts/sync-demo.mjs@@ -0,0 +1,244 @@+import { spawnSync } from "node:child_process";++const REPOSITORY = "tianma-if/edgeever";+const WORKFLOW = "deploy-demo.yml";+const DEFAULT_DEMO_URL = "https://demo.edgeever.org";+const DEFAULT_DEMO_USERNAME = "ee-demo";+const DEFAULT_DEMO_PASSWORD = "demo#dZ6Q29Zjfor%";+const RUN_DISCOVERY_ATTEMPTS = 30;+const RUN_DISCOVERY_INTERVAL_MS = 2_000;++const usage = `Usage:+ bun run demo:sync+ bun run demo:sync -- --dry-run++Deploys the pushed main commit through the Demo GitHub Actions workflow, resets+the public Demo workspace to that commit's seed data, and verifies the overview+memo. It does not create a tag or Release. The command requires an authenticated+GitHub CLI.++Optional environment overrides:+ EDGE_EVER_DEMO_URL+ EDGE_EVER_DEMO_USERNAME+ EDGE_EVER_DEMO_PASSWORD`;++export const parseSyncDemoArgs = (args) => {+ let dryRun = false;+ let help = false;++ for (const arg of args) {+ if (arg === "--dry-run") {+ dryRun = true;+ continue;+ }+ if (arg === "--help" || arg === "-h") {+ help = true;+ continue;+ }+ throw new Error(`Unknown argument: ${arg}`);+ }++ return { dryRun, help };+};++const run = (executable, args, options = {}) => {+ const result = spawnSync(executable, args, {+ encoding: "utf8",+ env: process.env,+ stdio: options.capture ? "pipe" : "inherit",+ });++ if (result.status !== 0) {+ if (options.capture) {+ if (result.stdout) process.stdout.write(result.stdout);+ if (result.stderr) process.stderr.write(result.stderr);+ }+ throw new Error(`${executable} exited with status ${result.status ?? 1}.`);+ }++ return options.capture ? result.stdout.trim() : "";+};++const runJson = (executable, args) => {+ const output = run(executable, args, { capture: true });+ try {+ return JSON.parse(output);+ } catch {+ throw new Error(`Unable to parse JSON output from ${executable} ${args.join(" ")}.`);+ }+};++const sleep = (durationMs) => new Promise((resolve) => setTimeout(resolve, durationMs));++const assertRepositoryState = () => {+ const branch = run("git", ["branch", "--show-current"], { capture: true });+ if (branch !== "main") {+ throw new Error(`Demo sync must run on main; current branch is ${branch || "(detached)"}.`);+ }++ const status = run("git", ["status", "--porcelain"], { capture: true });+ if (status) {+ throw new Error("Demo sync requires a clean working tree. Commit or stash local changes first.");+ }++ run("git", ["fetch", "origin", "main"]);+ const headSha = run("git", ["rev-parse", "HEAD"], { capture: true });+ const remoteSha = run("git", ["rev-parse", "origin/main"], { capture: true });+ if (headSha !== remoteSha) {+ throw new Error(+ `Local main (${headSha.slice(0, 12)}) does not match origin/main (${remoteSha.slice(0, 12)}). Push or update main first.`,+ );+ }++ run("gh", ["auth", "status"]);+ const repository = runJson("gh", ["repo", "view", REPOSITORY, "--json", "nameWithOwner"]);+ if (repository.nameWithOwner !== REPOSITORY) {+ throw new Error(`GitHub repository is unavailable: ${REPOSITORY}.`);+ }++ return headSha;+};++const listWorkflowRuns = () =>+ runJson("gh", [+ "run",+ "list",+ "--repo",+ REPOSITORY,+ "--workflow",+ WORKFLOW,+ "--event",+ "workflow_dispatch",+ "--branch",+ "main",+ "--limit",+ "20",+ "--json",+ "databaseId,headSha,status,conclusion,url,createdAt",+ ]);++const dispatchDeployment = async (headSha) => {+ const previousRunIds = new Set(listWorkflowRuns().map((workflowRun) => workflowRun.databaseId));++ run("gh", [+ "workflow",+ "run",+ WORKFLOW,+ "--repo",+ REPOSITORY,+ "--ref",+ "main",+ ]);++ for (let attempt = 0; attempt < RUN_DISCOVERY_ATTEMPTS; attempt += 1) {+ const workflowRun = listWorkflowRuns().find(+ (candidate) => candidate.headSha === headSha && !previousRunIds.has(candidate.databaseId),+ );+ if (workflowRun) {+ return workflowRun;+ }+ await sleep(RUN_DISCOVERY_INTERVAL_MS);+ }++ throw new Error("Timed out while waiting for the Demo deployment workflow run to appear.");+};++const requestJson = async (url, options = {}) => {+ const response = await fetch(url, options);+ const body = await response.json().catch(() => null);+ if (!response.ok) {+ const message = body?.error?.message || body?.message || response.statusText;+ throw new Error(`Demo API request failed (${response.status}): ${message}`);+ }+ return body;+};++const resetAndVerifyDemo = async () => {+ const demoUrl = (process.env.EDGE_EVER_DEMO_URL || DEFAULT_DEMO_URL).replace(/\/+$/, "");+ const username = process.env.EDGE_EVER_DEMO_USERNAME || DEFAULT_DEMO_USERNAME;+ const password = process.env.EDGE_EVER_DEMO_PASSWORD || DEFAULT_DEMO_PASSWORD;++ const session = await requestJson(`${demoUrl}/api/v1/auth/login`, {+ method: "POST",+ headers: { "Content-Type": "application/json" },+ body: JSON.stringify({ username, password }),+ });+ if (!session?.sessionToken) {+ throw new Error("Demo login succeeded without returning a session token.");+ }++ const authorization = { Authorization: `Bearer ${session.sessionToken}` };+ await requestJson(`${demoUrl}/api/v1/demo/reset`, {+ method: "POST",+ headers: authorization,+ });++ const response = await requestJson(`${demoUrl}/api/v1/memos/memo_demo_overview`, {+ headers: authorization,+ });+ const memo = response.memo ?? response;+ if (memo.id !== "memo_demo_overview" || !memo.title || !memo.contentMarkdown) {+ throw new Error("Demo overview memo verification returned incomplete data.");+ }++ return {+ demoUrl,+ title: memo.title,+ updatedAt: memo.updatedAt,+ };+};++const main = async () => {+ let options;+ try {+ options = parseSyncDemoArgs(process.argv.slice(2));+ } catch (error) {+ console.error(error instanceof Error ? error.message : String(error));+ console.error(usage);+ process.exit(1);+ }++ if (options.help) {+ console.log(usage);+ return;+ }++ if (options.dryRun) {+ console.log("[dry-run] validate clean, pushed main and GitHub CLI authentication");+ console.log(`[dry-run] dispatch ${WORKFLOW} on ${REPOSITORY}@main and wait for success`);+ console.log("[dry-run] reset the public Demo workspace from the deployed seed");+ console.log("[dry-run] verify memo_demo_overview through the Demo API");+ return;+ }++ console.log("[1/4] Validating repository and GitHub access...");+ const headSha = assertRepositoryState();+ console.log(`[ok] main is clean and pushed at ${headSha.slice(0, 12)}`);++ console.log("[2/4] Dispatching the Demo deployment workflow...");+ const workflowRun = await dispatchDeployment(headSha);+ console.log(`[ok] workflow run: ${workflowRun.url}`);++ console.log("[3/4] Waiting for the Demo deployment...");+ run("gh", [+ "run",+ "watch",+ String(workflowRun.databaseId),+ "--repo",+ REPOSITORY,+ "--exit-status",+ ]);++ console.log("[4/4] Resetting and verifying Demo seed data...");+ const verification = await resetAndVerifyDemo();+ console.log(`[ok] ${verification.title}`);+ console.log(`[ok] updated at ${verification.updatedAt}`);+ console.log(`Demo seed synchronized: ${verification.demoUrl}`);+};++if (import.meta.main) {+ main().catch((error) => {+ console.error(error instanceof Error ? error.message : String(error));+ process.exit(1);+ });+}