Skip to content

AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.

fix: stabilize desktop build and startup

tianma-if3dc6238bede2
diff --git a/.github/workflows/desktop-build.yml b/.github/workflows/desktop-build.yml
index 48a63517..d46ec803 100644
--- a/.github/workflows/desktop-build.yml
+++ b/.github/workflows/desktop-build.yml
@@ -15,7 +15,7 @@ jobs:
steps:
- name: Check out source
- uses: actions/checkout@v4
+ uses: actions/checkout@v5
- name: Set up Bun
uses: oven-sh/setup-bun@v2
@@ -26,13 +26,13 @@ jobs:
uses: dtolnay/rust-toolchain@stable
- name: Cache Bun dependencies
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: ~/.bun/install/cache
key: ${{ runner.os }}-bun-${{ hashFiles('bun.lock') }}
- name: Cache Rust dependencies and sidecar builds
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: |
~/.cargo/registry
@@ -43,7 +43,7 @@ jobs:
${{ runner.os }}-rust-
- name: Cache Electron downloads
- uses: actions/cache@v4
+ uses: actions/cache@v5
with:
path: |
~/Library/Caches/electron
@@ -151,7 +151,7 @@ jobs:
run: bun scripts/verify-desktop-package.mjs
- name: Upload desktop installer and metadata
- uses: actions/upload-artifact@v4
+ uses: actions/upload-artifact@v6
with:
name: edgeever-desktop-macOS-arm64
path: |
diff --git a/README.md b/README.md
index 22161d6c..e4b7f1a4 100644
--- a/README.md
+++ b/README.md
@@ -157,12 +157,16 @@ apps/web Vite + React frontend, PWA, offline drafts, and sync queue
apps/extension Chrome/Edge Manifest V3 web clipper
apps/api Cloudflare Worker + Hono API, OpenAPI, MCP endpoint
apps/mobile Expo + React Native mobile app
+apps/desktop Electron desktop shell, preload bridge, and native packaging
apps/site Astro official website, deployable independently
packages/client Shared API client for web and mobile apps
packages/shared Shared types, Zod schemas, TipTap / Markdown conversion
+crates/desktop-sidecar
+ Rust sidecar for local SQLite, offline data, backups, and resources
scripts Wrangler wrapper, password hash, CLI, MCP stdio bridge, Evernote ENEX import
migrations D1 database migrations
-docs OpenAPI schema, migration guides, and deployment docs
+docs OpenAPI schema, architecture, migration, and deployment docs
+.github/workflows CI for web, mobile, desktop packaging, deployment, and releases
wrangler.toml Cloudflare Workers, Assets, D1, R2 configuration
```
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 487afdc7..aca90b0f 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -159,12 +159,16 @@ apps/web Vite + React 前端、PWA、离线草稿与同步队列
apps/extension Chrome/Edge Manifest V3 网页裁剪插件
apps/api Cloudflare Worker + Hono API、OpenAPI、MCP endpoint
apps/mobile Expo + React Native 移动端 App
+apps/desktop Electron 桌面端壳层、preload bridge 与原生打包配置
apps/site Astro 官方网站,可独立部署
packages/client Web 与移动端共享的 API Client
packages/shared 共享类型、Zod schema、TipTap / Markdown 内容转换
+crates/desktop-sidecar
+ Rust sidecar,负责本地 SQLite、离线数据、备份与资源服务
scripts Wrangler 封装、密码 hash、CLI、MCP stdio bridge、Evernote ENEX 导入
migrations D1 数据库迁移
-docs OpenAPI schema、迁移指南等文档
+docs OpenAPI schema、架构、迁移与部署文档
+.github/workflows Web、移动端、桌面端打包、部署与 Release 的 CI
wrangler.toml Cloudflare Workers、Assets、D1、R2 配置
```
diff --git a/apps/desktop/src/main/index.mjs b/apps/desktop/src/main/index.mjs
index 7a2f5b62..6de29c33 100644
--- a/apps/desktop/src/main/index.mjs
+++ b/apps/desktop/src/main/index.mjs
@@ -11,7 +11,9 @@ import { accountDataDirectory, accountScopeKey } from "./account-scope.mjs";
import { rotateDiagnosticLog } from "./diagnostic-log.mjs";
import { restrictDirectory, restrictFile } from "./file-permissions.mjs";
import { normalizeStagedResourceInput } from "./staged-resource.mjs";
-import { autoUpdater } from "electron-updater";
+import electronUpdater from "electron-updater";
+
+const { autoUpdater } = electronUpdater;
const currentDirectory = fileURLToPath(new URL(".", import.meta.url));
const projectRoot = join(currentDirectory, "../../..");
diff --git a/docs/project-structure.md b/docs/project-structure.md
index d584baa5..bdf57777 100644
--- a/docs/project-structure.md
+++ b/docs/project-structure.md
@@ -3,66 +3,22 @@
```text
edgeever/
├── apps/
-│ ├── web/
-│ │ ├── public/
-│ │ │ ├── manifest.webmanifest
-│ │ │ └── icons/
-│ │ ├── src/
-│ │ │ ├── app/
-│ │ │ │ ├── App.tsx
-│ │ │ │ └── routes.tsx
-│ │ │ ├── components/
-│ │ │ │ ├── editor/
-│ │ │ │ ├── layout/
-│ │ │ │ ├── memo-list/
-│ │ │ │ ├── notebook-tree/
-│ │ │ │ └── ui/
-│ │ │ ├── hooks/
-│ │ │ ├── lib/
-│ │ │ ├── styles/
-│ │ │ └── main.tsx
-│ │ ├── index.html
-│ │ ├── package.json
-│ │ ├── tsconfig.json
-│ │ └── vite.config.ts
-│ ├── api/
-│ │ ├── src/
-│ │ │ ├── index.ts
-│ │ │ ├── env.ts
-│ │ │ ├── db/
-│ │ │ ├── routes/
-│ │ │ │ ├── memos.ts
-│ │ │ │ ├── notebooks.ts
-│ │ │ │ └── resources.ts
-│ │ │ └── services/
-│ │ │ ├── merge-memos.ts
-│ │ │ └── resource-store.ts
-│ │ ├── package.json
-│ │ └── tsconfig.json
-│ └── site/
-│ ├── public/
-│ ├── src/
-│ │ ├── components/
-│ │ ├── content/
-│ │ ├── layouts/
-│ │ ├── pages/
-│ │ └── styles/
-│ ├── astro.config.mjs
-│ ├── package.json
-│ └── tsconfig.json
+│ ├── web/ Vite + React product UI, PWA, offline drafts, sync queue
+│ ├── extension/ Chrome/Edge Manifest V3 web clipper
+│ ├── api/ Cloudflare Worker + Hono API, OpenAPI, MCP endpoint
+│ ├── mobile/ Expo + React Native mobile app
+│ ├── desktop/ Electron shell, preload bridge, and packaging
+│ └── site/ Astro official website
├── packages/
-│ └── shared/
-│ ├── src/
-│ │ ├── content.ts
-│ │ ├── index.ts
-│ │ ├── schemas.ts
-│ │ └── types.ts
-│ ├── package.json
-│ └── tsconfig.json
+│ ├── client/ Shared API client
+│ └── shared/ Shared types, schemas, and content conversion
+├── crates/
+│ └── desktop-sidecar/ Rust sidecar for local SQLite and native data services
├── migrations/
│ └── 0001_initial.sql
-├── docs/
-│ └── project-structure.md
+├── scripts/ Wrangler wrapper, CLI, MCP bridge, and build helpers
+├── docs/ API, architecture, migration, and deployment docs
+├── .github/workflows/ CI, packaging, deployment, and release workflows
├── tailwind.config.ts
├── wrangler.toml
├── bun.lock